feat(config): rename YAML keys to default_profile/profiles; prepare release 1.2.0

Prefer AuditKit-style profile keys while keeping legacy default_config/configs
via normalization and container parameter aliases.

Author: HecFranco

.symfony/recipe/nowo-tech/ckeditor5-editor-bundle/1.0/config/packages/nowo_ckeditor5_editor.yaml

@@ -1,6 +1,6 @@
 nowo_ckeditor5_editor:
-    default_config: default
-    configs:
+    default_profile: default
+    profiles:
         default:
             preset: standard
             toolbar: true

README.md

@@ -36,8 +36,8 @@ php bin/console assets:install public
 ```yaml
 # config/packages/nowo_ckeditor5_editor.yaml
 nowo_ckeditor5_editor:
-    default_config: simple
-    configs:
+    default_profile: simple
+    profiles:
         simple:
             preset: simple
             toolbar: true

demo/symfony8/config/packages/nowo_ckeditor5_editor.yaml

@@ -5,8 +5,8 @@
 # min_height: CSS value; use %demo.ckeditor.height.*% or %env(DEMO_CKEDITOR_FOLIO_MIN_HEIGHT)% (see .env)
 
 nowo_ckeditor5_editor:
-    default_config: simple
-    configs:
+    default_profile: simple
+    profiles:
         full:
             preset: standard
             toolbar: true

demo/symfony8/config/reference.php

@@ -749,8 +749,8 @@
  *     excluded_ajax_paths?: scalar|Param|null, // Default: "^/((index|app(_[\\w]+)?)\\.php/)?_wdt"
  * }
  * @psalm-type NowoCkeditor5EditorConfig = array{
- *     default_config?: scalar|Param|null, // Profile name used when the form field omits the "config" option. // Default: "default"
- *     configs?: array<string, array{ // Default: []
+ *     default_profile?: scalar|Param|null, // Profile name used when the form field omits the "config" option. // Default: "default"
+ *     profiles?: array<string, array{ // Default: []
  *         toolbar?: bool|Param, // When true, CKEditor shows its toolbar (preset still controls which buttons are available). // Default: true
  *         min_height?: scalar|Param|null, // Default CSS min-height for the editable region wrapper (e.g. 240px, 12rem). // Default: "240px"
  *         form_theme?: scalar|Param|null, // Base Symfony form layout (must match twig.form_themes in your app). // Default: "form_div_layout.html.twig"

docs/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-07-18
+
+### Changed
+
+- Configuration: renamed YAML keys **`default_config`** / **`configs`** to **`default_profile`** / **`profiles`** (AuditKit-style). Legacy keys still accepted via normalization; container parameters keep legacy aliases. Form option `config` unchanged. See [`UPGRADING.md`](UPGRADING.md) and [`CONFIGURATION.md`](CONFIGURATION.md).
+- Documentation, Flex recipe, demo, and fixtures updated to the new key names.
+
 ## [1.1.4] - 2026-07-16
 
 ### Added
@@ -102,7 +109,8 @@ First semver release (documented stable line, CI and Packagist aligned with tag
 - PHPUnit: integration suite + unit test for `upload_url` CSRF branch (**100%** PHP Clover on `src/`).
 - PHP-CS-Fixer finder excludes generated integration fixture cache and `tests/Fixtures/app/config/reference.php`.
 
-[Unreleased]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.1.4...HEAD
+[Unreleased]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.1.4...v1.2.0
 [1.1.4]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.1.3...v1.1.4
 [1.1.3]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.1.2...v1.1.3
 [1.1.2]: https://github.com/nowo-tech/Ckeditor5EditorBundle/compare/v1.1.1...v1.1.2

docs/CONFIGURATION.md

@@ -4,12 +4,12 @@ Root key: `nowo_ckeditor5_editor`
 
 ## Top-level
 
-| Option           | Type   | Default   | Description |
-| ---------------- | ------ | --------- | ----------- |
-| `default_config` | string | `default` | Profile name when a form field omits the `config` option. **Must** exist under `configs`. |
-| `configs`        | map    | —         | Named profiles. At least one profile is required (or use [legacy flat](#legacy-flat-yaml) input). |
+| Option            | Type   | Default   | Description |
+| ----------------- | ------ | --------- | ----------- |
+| `default_profile` | string | `default` | Profile name when a form field omits the `config` option. **Must** exist under `profiles`. |
+| `profiles`        | map    | —         | Named profiles. At least one profile is required (or use [legacy keys and flat YAML](#legacy-keys-and-flat-yaml) input). |
 
-## Per profile (`configs.<name>`)
+## Per profile (`profiles.<name>`)
 
 | Option        | Type   | Default                     | Description |
 | ------------- | ------ | --------------------------- | ----------- |
@@ -21,17 +21,18 @@ Root key: `nowo_ckeditor5_editor`
 | `theme`       | string | `light`                     | Chrome palette: `light`, `dark`, or `auto`. |
 | `upload_url`  | string | `null`                      | Optional URL for Simple Upload Adapter (demo/apps provide POST endpoints). |
 
-## Legacy flat YAML
+## Legacy keys and flat YAML
 
-If the root has no `configs` key, the extension maps flat keys into a single profile under `configs` using `default_config` (default `default`):
+- **Renamed keys:** `default_config` / `configs` were renamed to `default_profile` / `profiles`. Legacy keys are still accepted via normalization (mapped when the new keys are absent).
+- **Flat layout:** If the root has no `profiles` (nor legacy `configs`) key, the extension maps flat keys into a single profile under `profiles` using `default_profile` (default `default`):
 
 - `toolbar`, `min_height`, `form_theme`, `debug`, `preset`, `theme`, `upload_url`
 
 ## Form type `Ckeditor5EditorType` options
 
 | Option          | Type | Description |
 | --------------- | ---- | ----------- |
-| `config`        | `string\|null` | Profile name under `nowo_ckeditor5_editor.configs`. `null`/empty uses `default_config`. |
+| `config`        | `string\|null` | Profile name under `nowo_ckeditor5_editor.profiles`. `null`/empty uses `default_profile`. (Form option key remains `config` for BC.) |
 | `editor_config` | `array` | Keys merged over the YAML profile: `toolbar`, `min_height`, `form_theme`, `debug`, `preset`, `theme`, `upload_url`. |
 | `toolbar`       | bool | Field-level override. |
 | `min_height`    | string | Field-level override. |
@@ -59,4 +60,4 @@ Translations use the domain **`NowoCkeditor5EditorBundle`** (`src/Resources/tran
 
 ## Parameters exposed to the container
 
-The DI extension sets parameters from configuration (including backward-compatible scalars for the **default** profile). Prefer resolving behaviour through `Ckeditor5EditorType` and YAML profiles.
+The DI extension sets `nowo_ckeditor5_editor.default_profile` and `nowo_ckeditor5_editor.profiles`, plus legacy aliases `nowo_ckeditor5_editor.default_config` / `nowo_ckeditor5_editor.configs` (same values), and backward-compatible scalars for the **default** profile. Prefer resolving behaviour through `Ckeditor5EditorType` and YAML profiles.

docs/INSTALLATION.md

@@ -28,8 +28,8 @@ Create configuration (recommended — named profiles):
 ```yaml
 # config/packages/nowo_ckeditor5_editor.yaml
 nowo_ckeditor5_editor:
-    default_config: simple
-    configs:
+    default_profile: simple
+    profiles:
         simple:
             preset: simple
             toolbar: true
@@ -39,7 +39,7 @@ nowo_ckeditor5_editor:
             theme: light
 ```
 
-You may use **legacy flat** keys at the root (without `configs`): they are normalized into `configs.default`. Prefer explicit `configs` for multiple profiles.
+You may use **legacy flat** keys at the root (without `profiles`): they are normalized into `profiles.default`. Prefer explicit `profiles` for multiple profiles. Legacy YAML keys `default_config` / `configs` are still accepted and mapped to `default_profile` / `profiles`.
 
 See [CONFIGURATION.md](CONFIGURATION.md) for the full reference.
 

docs/UPGRADING.md

@@ -96,12 +96,43 @@ Patch release: repository tooling (CodeRabbit, Spec Kit, Cursor rules), CI **`gi
 
 See [`CHANGELOG.md`](CHANGELOG.md) (section **1.1.4**).
 
+## To 1.2.0 from 1.1.4
+
+Minor release: YAML keys **`default_config`** / **`configs`** renamed to **`default_profile`** / **`profiles`** (AuditKit-style). Prefer the new names in app config.
+
+**Before (≤ 1.1.4):**
+
+```yaml
+nowo_ckeditor5_editor:
+    default_config: simple
+    configs:
+        simple:
+            preset: simple
+```
+
+**After (1.2.0+):**
+
+```yaml
+nowo_ckeditor5_editor:
+    default_profile: simple
+    profiles:
+        simple:
+            preset: simple
+```
+
+- Legacy keys are still accepted via `beforeNormalization` when the new keys are absent.
+- Container parameters `nowo_ckeditor5_editor.default_config` / `nowo_ckeditor5_editor.configs` remain as aliases of the new parameters.
+- Form option key **`config`** is unchanged.
+- **Composer**: `composer update nowo-tech/ckeditor5-editor-bundle` (with `^1.0` or `^1.2`); then `php bin/console cache:clear`.
+
+See [`CHANGELOG.md`](CHANGELOG.md) (section **1.2.0**) and [`CONFIGURATION.md`](CONFIGURATION.md).
+
 ## To 1.x (first documented stable line)
 
 When upgrading from snapshots without semver tags in your project:
 
 - **Composer**: `composer require nowo-tech/ckeditor5-editor-bundle:^1.0`
-- **Configuration**: prefer explicit **`configs`** + **`default_config`** (see [`CONFIGURATION.md`](CONFIGURATION.md)). Legacy flat YAML under `nowo_ckeditor5_editor` is still accepted and normalized.
+- **Configuration**: prefer explicit **`profiles`** + **`default_profile`** (see [`CONFIGURATION.md`](CONFIGURATION.md)). Legacy keys `default_config` / `configs` and flat YAML under `nowo_ckeditor5_editor` are still accepted and normalized.
 - **Bootstrap**: ensure your layout loads the bundle script once per page:
 
   ```twig

src/DependencyInjection/Configuration.php

@@ -16,6 +16,9 @@
 /**
  * Named profiles (toolbar, min_height, form_theme, debug, preset, theme) plus default profile key.
  *
+ * Legacy YAML keys `default_config` / `configs` are accepted and mapped to `default_profile` / `profiles`.
+ * Flat options under the root are normalized into `profiles.default`.
+ *
  * @author Héctor Franco Aceituno <hectorfranco@nowo.tech>
  */
 final class Configuration implements ConfigurationInterface
@@ -33,32 +36,42 @@ public function getConfigTreeBuilder(): TreeBuilder
                 if (!is_array($v)) {
                     return $v;
                 }
-                if (isset($v['configs'])) {
+
+                if (!isset($v['profiles']) && isset($v['configs'])) {
+                    $v['profiles'] = $v['configs'];
+                    unset($v['configs']);
+                }
+                if (!isset($v['default_profile']) && isset($v['default_config'])) {
+                    $v['default_profile'] = $v['default_config'];
+                    unset($v['default_config']);
+                }
+
+                if (isset($v['profiles'])) {
                     return $v;
                 }
 
-                $defaultConfig = $v['default_config'] ?? 'default';
-                $profile       = [];
+                $defaultProfile = $v['default_profile'] ?? 'default';
+                $profile        = [];
                 foreach (['toolbar', 'min_height', 'form_theme', 'debug', 'preset', 'theme', 'upload_url'] as $key) {
                     if (array_key_exists($key, $v)) {
                         $profile[$key] = $v[$key];
                     }
                 }
 
                 return [
-                    'default_config' => $defaultConfig,
-                    'configs'        => [
+                    'default_profile' => $defaultProfile,
+                    'profiles'        => [
                         'default' => $profile,
                     ],
                 ];
             })
             ->end()
             ->children()
-                ->scalarNode('default_config')
+                ->scalarNode('default_profile')
                     ->defaultValue('default')
-                    ->info('Profile name used when the form field omits the "config" option.')
+                    ->info('Profile name used when the form field omits the "config" option (form option key remains "config" for BC).')
                 ->end()
-                ->arrayNode('configs')
+                ->arrayNode('profiles')
                     ->info('Named profiles; each field may reference one via the "config" form option.')
                     ->useAttributeAsKey('name')
                     ->requiresAtLeastOneElement()
@@ -106,8 +119,8 @@ public function getConfigTreeBuilder(): TreeBuilder
             ->end()
             ->validate()
             ->always(static function (array $v): array {
-                if (!isset($v['configs'][$v['default_config']])) {
-                    throw new InvalidConfigurationException(sprintf('nowo_ckeditor5_editor.default_config ("%s") must exist in nowo_ckeditor5_editor.configs (keys: %s).', $v['default_config'], implode(', ', array_keys($v['configs']))));
+                if (!isset($v['profiles'][$v['default_profile']])) {
+                    throw new InvalidConfigurationException(sprintf('nowo_ckeditor5_editor.default_profile ("%s") must exist in nowo_ckeditor5_editor.profiles (keys: %s).', $v['default_profile'], implode(', ', array_keys($v['profiles']))));
                 }
 
                 return $v;

src/DependencyInjection/NowoCkeditor5EditorExtension.php

@@ -38,11 +38,14 @@ public function load(array $configs, ContainerBuilder $container): void
         $loader->load('services.yaml');
 
         $config         = $this->processConfiguration(new Configuration(), $configs);
-        $defaultName    = $config['default_config'];
-        $defaultProfile = $config['configs'][$defaultName];
+        $defaultName    = $config['default_profile'];
+        $defaultProfile = $config['profiles'][$defaultName];
 
+        $container->setParameter(Configuration::ALIAS . '.default_profile', $defaultName);
+        $container->setParameter(Configuration::ALIAS . '.profiles', $config['profiles']);
+        // Legacy parameter names (same values) for BC.
         $container->setParameter(Configuration::ALIAS . '.default_config', $defaultName);
-        $container->setParameter(Configuration::ALIAS . '.configs', $config['configs']);
+        $container->setParameter(Configuration::ALIAS . '.configs', $config['profiles']);
 
         $container->setParameter(Configuration::ALIAS . '.toolbar', $defaultProfile['toolbar']);
         $container->setParameter(Configuration::ALIAS . '.min_height', $defaultProfile['min_height']);
@@ -71,7 +74,7 @@ public function prepend(ContainerBuilder $container): void
         }
 
         $configs = $container->getExtensionConfig(Configuration::ALIAS);
-        /** @var array{default_config: string, configs: array<string, array<string, mixed>>} $config */
+        /** @var array{default_profile: string, profiles: array<string, array<string, mixed>>} $config */
         $config = $this->processConfiguration(new Configuration(), $configs);
 
         $themePaths = $this->orderedFormThemePaths($config);
@@ -81,19 +84,19 @@ public function prepend(ContainerBuilder $container): void
     }
 
     /**
-     * @param array{default_config: string, configs: array<string, array<string, mixed>>} $processedConfig
+     * @param array{default_profile: string, profiles: array<string, array<string, mixed>>} $processedConfig
      *
      * @return list<string>
      */
     private function orderedFormThemePaths(array $processedConfig): array
     {
-        $configs      = $processedConfig['configs'];
-        $defaultName  = $processedConfig['default_config'];
-        $defaultTheme = $configs[$defaultName]['form_theme'] ?? 'form_div_layout.html.twig';
+        $profiles     = $processedConfig['profiles'];
+        $defaultName  = $processedConfig['default_profile'];
+        $defaultTheme = $profiles[$defaultName]['form_theme'] ?? 'form_div_layout.html.twig';
         $defaultPath  = self::FORM_THEME_MAP[$defaultTheme] ?? self::FORM_THEME_MAP['form_div_layout.html.twig'];
 
         $unique = [];
-        foreach ($configs as $profile) {
+        foreach ($profiles as $profile) {
             $ft         = $profile['form_theme'] ?? 'form_div_layout.html.twig';
             $p          = self::FORM_THEME_MAP[$ft] ?? self::FORM_THEME_MAP['form_div_layout.html.twig'];
             $unique[$p] = true;