1.x

• Basic implementation of plugin initializer
• docs: improve documentation
• docs: improve API method documentation
• chore: improve composer package definition and readme
• feat(wip): allow private hooks calls
• improve into wp-hook and some additional unfinished things
• feat: moving toward actual implementation
• refactor: hookable driver should belong to separate package
• refactor: HookProvider also belongs to another package
• refactor: remove PluginHeaderData
• feat: add VERY simple command to cache plugin data
• refactor: rename header parser implementation
• refactor: simplify package
• refactor: remove unused tests
• chore: add static analysis
• feat: add initial bindings for wp-builder compatibility
• chore: add editorconfig
• fix: passthrough container definitions argument
• fix: use absolute cache path
• fix: don't use hook and global variable
• refactor: remove method, which can be replaced with get_path
• refactor: reorder definition loading, change config key name
• fix: correct cache path
• feat: add hook driver backward compatible with wp-builder
• fix: throw exception on failed load
• feat: add check for optional package
• chore: add config files
• feat: large rework, needs followup

docs/configuration.md

+# Configuration
+
+`wp-init` relies on declarative configuration, which encapsulates process of attaching hooks to
+WordPress life cycle and provides some additional features, like filling DI container with your
+services definitions.
+
+## `hook_resources_path`
+
+Pass a path to the file/directory with your hook actions. Configuration accepts any valid path
+string, relative or absolute, either `hook_providers` or `__DIR__ . '/hook_providers/plugins_loaded.php'`
+
+Files are mapped to hooks by name, so `woocommerce_init.php` is registered inside `woocommerce_init`
+action. The exception is `index.php` file which is flushed immediately.
+
+Example of a hook resource content:
+
+```php
+<?php
+// plugins_loaded.php
+
+return [
+	MyCoolTitleChanger::class,
+	AnotherHookAction::class,
+	function ( Dependency $dep ) {
+		// You can even use a closure, to execute simple actions.
+		// Arguments are injected by DI container.
+		$dep->one_off_action();
+	},
+	function ( Migarator $migrator ) {
+		$migrator->migrate();
+	}
+];
+```
+
+## `services`
+
+As you add more services with increasing complexity, you will need to provide some kind of
+definitions for a DI container to create objects. Pass a path to a file, which will hold such
+definitions. Refer to [php-di documentation](https://php-di.org/doc/definitions.html) for more
+information on such file content.
+
+> Warning
+> If you are using _shortcut_ functions from `php-di/php-di` (e.g. `DI\autowire`, `DI\create`), you
+> must load them first. Add `require __DIR__ . '/vendor_prefixed/php-di/php-di/src/functions.php';`
+> to your plugin file.
+
+## `cache_path`
+
+Plugin header data and compiled DI container is cached in a directory specified by this
+setting. Defaults to `generated`.
+
+## `requirements`
+
+**This setting only works when `wpdesk/wp-basic-requirements` is installed.**
+
+Enables your plugin to check an environment requirement before instantiation, e.g. PHP version or
+active plugins. Refer to [wp-basic-requirements documentation](https: //gitlab.wpdesk.dev/wpdesk/wp-basic-requirements)
+for more information on setting structure.
+
+## `plugin_class_name`
+
+**This setting only works when `wpdesk/wp-builder` is installed.**
+
+When a plugin is used in [legacy mode](legacy.md), `plugin_class_name` is used to create an instance
+of main plugin class. This setting is required to enable legacy mode. Despite that,
+`WPDesk\Init\Plugin\Plugin` is still accessible to your services.