@rxap/plugin-library 20.2.2-dev.2 → 20.3.0-dev.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [20.3.0-dev.0](https://gitlab.com/rxap/packages/compare/@rxap/plugin-library@20.2.2-dev.3...@rxap/plugin-library@20.3.0-dev.0) (2026-01-12)
+
+### Features
+
+- **schema:** enhance generator schema documentation with descriptions and examples ([0ae4939](https://gitlab.com/rxap/packages/commit/0ae4939d77e3e313ace4a77d8f5dd86c3c918d29))
+
+## [20.2.2-dev.3](https://gitlab.com/rxap/packages/compare/@rxap/plugin-library@20.2.2-dev.2...@rxap/plugin-library@20.2.2-dev.3) (2025-09-18)
+
+**Note:** Version bump only for package @rxap/plugin-library
+
 ## [20.2.2-dev.2](https://gitlab.com/rxap/packages/compare/@rxap/plugin-library@20.2.2-dev.1...@rxap/plugin-library@20.2.2-dev.2) (2025-09-15)
 
 **Note:** Version bump only for package @rxap/plugin-library

package/README.md

@@ -57,14 +57,14 @@ nx g @rxap/plugin-library:init
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
-indexExport | boolean |  | Whether to add the index-export target to the library
-targets | object |  | 
-withInitGenerator | boolean | false | Generate a init generator for the library
+project | string |  | The name of the library project to initialize.
+projects | array |  | The list of library projects to initialize.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
+indexExport | boolean |  | Whether to add the 'index-export' target to the library project configuration.
+targets | object |  | Configuration for specific project targets.
+withInitGenerator | boolean | false | Whether to generate an 'init' generator within the library itself.
 
 ## fix-dependencies
 > Adds missing dependencies and removes redudant dependencies of a project
@@ -75,14 +75,14 @@ nx g @rxap/plugin-library:fix-dependencies
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-projects | array |  | 
-reset | boolean |  | 
-resolve | boolean |  | 
-resetAll | boolean |  | 
-strict | boolean | false | If true, will fail if any dependency is not found
-onlyDependencies | boolean | false | If true, will move all peer dependencies to dependencies
-dependencies | array |  | List of packages that should always be added as dependencies
-peerDependencies | array |  | List of packages that should always be added as peerDependencies
+projects | array |  | The list of projects to fix dependencies for.
+reset | boolean |  | Whether to reset the project's dependencies before fixing them.
+resolve | boolean |  | Whether to resolve dependency versions from the workspace root 'package.json'.
+resetAll | boolean |  | Whether to reset all project dependencies, including peer dependencies.
+strict | boolean | false | Whether to fail if any required dependency cannot be found in the workspace.
+onlyDependencies | boolean | false | Whether to move all peer dependencies to the regular dependencies section.
+dependencies | array |  | A list of package names that should always be added to the 'dependencies' section.
+peerDependencies | array |  | A list of package names that should always be added to the 'peerDependencies' section.
 
 ## index-export
 > Generate index exports for each directory and in the src root
@@ -93,10 +93,10 @@ nx g @rxap/plugin-library:index-export
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-projects | array |  | 
-project | string |  | 
-generateRootExport | boolean | true | Generate index.ts in the source root of the project
-additionalEntryPoints | array |  | 
+projects | array |  | The list of projects to generate index exports for.
+project | string |  | The name of a single project to generate an index export for.
+generateRootExport | boolean | true | Whether to generate an 'index.ts' file in the source root of the project.
+additionalEntryPoints | array |  | A list of additional sub-directory entry points to include in the index export.
 
 ## init-plugin
 > init-plugin generator
@@ -107,11 +107,11 @@ nx g @rxap/plugin-library:init-plugin
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
+project | string |  | The name of the project to initialize as an Nx plugin.
+projects | array |  | The list of projects to initialize as Nx plugins.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
 
 ## init-buildable
 > init-buildable generator
@@ -122,11 +122,11 @@ nx g @rxap/plugin-library:init-buildable
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
+project | string |  | The name of the buildable library project to initialize.
+projects | array |  | The list of buildable library projects to initialize.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
 
 ## init-publishable
 > init-publishable generator
@@ -137,13 +137,13 @@ nx g @rxap/plugin-library:init-publishable
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
-targets | object |  | 
-withInitGenerator | boolean | false | Generate a init generator for the library
+project | string |  | The name of the library project to initialize for publishing.
+projects | array |  | The list of library projects to initialize for publishing.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
+targets | object |  | Configuration for specific project targets.
+withInitGenerator | boolean | false | Whether to generate an 'init' generator within the library itself.
 
 ## expose-as-schematic
 > expose-as-schematic generator
@@ -154,8 +154,8 @@ nx g @rxap/plugin-library:expose-as-schematic
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-projects | array |  | 
-project | string |  | 
+projects | array |  | The list of projects to expose as schematics.
+project | string |  | The name of a single project to expose as a schematic.
 
 ## bundle-json-schema
 > bundle-json-schema generator
@@ -166,7 +166,7 @@ nx g @rxap/plugin-library:bundle-json-schema
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | Name of the project
+project | string |  | The name of the project whose JSON schemas should be bundled.
 
 ## index-json-schema
 > index-json-schema generator
@@ -177,7 +177,7 @@ nx g @rxap/plugin-library:index-json-schema
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | Name of the project
+project | string |  | The name of the project whose JSON schemas should be indexed.
 
 ## init-with-migrations
 > init-with-migrations generator
@@ -188,11 +188,11 @@ nx g @rxap/plugin-library:init-with-migrations
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
+project | string |  | The name of the library project to initialize with migrations support.
+projects | array |  | The list of library projects to initialize with migrations support.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
 
 ## add-migration
 > add-migration generator
@@ -203,12 +203,12 @@ nx g @rxap/plugin-library:add-migration
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | Name of the project
-name | string |  | Name of the migration
-description | string |  | Description of the migration
-packageVersion | string |  | Version to use for the migration.
-packageJsonUpdates | boolean | false | Whether or not to include `package.json` updates.
-increment | string |  | Increment the version of the package.json file
+project | string |  | The name of the project to add the migration to.
+name | string |  | The name of the migration file.
+description | string |  | A brief description of what the migration does.
+packageVersion | string |  | The package version that triggers this migration.
+packageJsonUpdates | boolean | false | Whether to include 'package.json' dependency updates in the migration.
+increment | string |  | The type of version increment for the 'package.json' file.
 
 ## init-preset
 > init-preset generator
@@ -219,11 +219,11 @@ nx g @rxap/plugin-library:init-preset
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
+project | string |  | The name of the library project to initialize with a preset.
+projects | array |  | The list of library projects to initialize with a preset.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
 
 ## init-schematic
 > init-schematic generator
@@ -234,11 +234,11 @@ nx g @rxap/plugin-library:init-schematic
 
 Option | Type | Default | Description
 --- | --- | --- | ---
-project | string |  | 
-projects | array |  | 
-skipFormat | boolean | false | 
-overwrite | boolean | false | Whether to overwrite existing files
-skipProjects | boolean | false | Whether to skip executing project specific initialization
+project | string |  | The name of the project to initialize as a schematic library.
+projects | array |  | The list of projects to initialize as schematic libraries.
+skipFormat | boolean | false | Whether to skip formatting files with Prettier after initialization.
+overwrite | boolean | false | Whether to overwrite existing files during initialization.
+skipProjects | boolean | false | Whether to skip executing project-specific initialization logic.
 # Executors
 
 ## update-dependencies

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "20.2.2-dev.2",
+  "version": "20.3.0-dev.0",
   "name": "@rxap/plugin-library",
   "description": "This package provides generators and executors for managing and maintaining Nx plugin libraries. It includes functionality for generating index exports, fixing dependencies, generating JSON schemas, and more. It helps streamline the development process for Nx plugins by automating common tasks and enforcing best practices.\n",
   "license": "GPL-3.0-or-later",
@@ -7,12 +7,12 @@
     "@apidevtools/json-schema-ref-parser": "^9.0.9",
     "@nx/devkit": "20.5.0",
     "@nx/plugin": "20.5.0",
-    "@rxap/node-utilities": "^1.3.11-dev.1",
-    "@rxap/plugin-utilities": "^20.0.5-dev.1",
-    "@rxap/ts-morph": "^1.6.0-dev.1",
-    "@rxap/utilities": "^16.4.5-dev.1",
-    "@rxap/workspace-ts-morph": "^19.1.13-dev.2",
-    "@rxap/workspace-utilities": "^19.8.1-dev.1",
+    "@rxap/node-utilities": "^1.3.11-dev.2",
+    "@rxap/plugin-utilities": "^20.0.5-dev.2",
+    "@rxap/ts-morph": "^1.6.0-dev.2",
+    "@rxap/utilities": "^16.5.0-dev.0",
+    "@rxap/workspace-ts-morph": "^19.1.13-dev.3",
+    "@rxap/workspace-utilities": "^19.8.1-dev.2",
     "colors": "1.4.0",
     "handlebars": "4.7.8",
     "nx": "20.5.0",
@@ -49,7 +49,7 @@
   },
   "schematics": "./generators.json",
   "type": "commonjs",
-  "gitHead": "e3bb0ca983f56d75192a8e5eff1d3ecab00a3c63",
+  "gitHead": "f6923aa9d989b25018f2fcac470963fb1e68049a",
   "exports": {
     "./package.json": "./package.json",
     ".": {

package/src/generators/add-migration/schema.json

@@ -6,35 +6,40 @@
   "properties": {
     "project": {
       "type": "string",
-      "description": "Name of the project",
-      "x-prompt": "For which project should the migration be created?"
+      "description": "The name of the project to add the migration to.",
+      "x-prompt": "For which project should the migration be created?",
+      "examples": ["my-lib"]
     },
     "name": {
       "type": "string",
-      "description": "Name of the migration",
-      "x-prompt": "What name would you like to use?"
+      "description": "The name of the migration file.",
+      "x-prompt": "What name would you like to use?",
+      "examples": ["fix-styles"]
     },
     "description": {
       "type": "string",
-      "description": "Description of the migration",
-      "x-prompt": "What description would you like to use?"
+      "description": "A brief description of what the migration does.",
+      "x-prompt": "What description would you like to use?",
+      "examples": ["Fixes broken styles in the component library."]
     },
     "packageVersion": {
       "type": "string",
-      "description": "Version to use for the migration.",
+      "description": "The package version that triggers this migration.",
       "x-prompt": "What version would you like to use for the migration?",
-      "x-priority": "important"
+      "x-priority": "important",
+      "examples": ["1.2.3"]
     },
     "packageJsonUpdates": {
       "type": "boolean",
-      "description": "Whether or not to include `package.json` updates.",
+      "description": "Whether to include 'package.json' dependency updates in the migration.",
       "default": false
     },
     "increment": {
       "type": "string",
       "enum": ["major", "minor", "patch"],
-      "description": "Increment the version of the package.json file",
-      "x-priority": "important"
+      "description": "The type of version increment for the 'package.json' file.",
+      "x-priority": "important",
+      "examples": ["patch"]
     }
   },
   "required": [

package/src/generators/bundle-json-schema/schema.json

@@ -6,7 +6,8 @@
   "properties": {
     "project": {
       "type": "string",
-      "description": "Name of the project"
+      "description": "The name of the project whose JSON schemas should be bundled.",
+      "examples": ["my-lib"]
     }
   },
   "required": ["project"]

package/src/generators/expose-as-schematic/schema.json

@@ -8,10 +8,14 @@
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of projects to expose as schematics.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of a single project to expose as a schematic.",
+      "examples": ["my-lib"]
     }
   },
   "required": []

package/src/generators/fix-dependencies/schema.json

@@ -9,41 +9,48 @@
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of projects to fix dependencies for.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "reset": {
-      "type": "boolean"
+      "type": "boolean",
+      "description": "Whether to reset the project's dependencies before fixing them."
     },
     "resolve": {
-      "type": "boolean"
+      "type": "boolean",
+      "description": "Whether to resolve dependency versions from the workspace root 'package.json'."
     },
     "resetAll": {
       "alias": "resetAll",
-      "type": "boolean"
+      "type": "boolean",
+      "description": "Whether to reset all project dependencies, including peer dependencies."
     },
     "strict": {
       "type": "boolean",
       "default": false,
-      "description": "If true, will fail if any dependency is not found"
+      "description": "Whether to fail if any required dependency cannot be found in the workspace."
     },
     "onlyDependencies": {
       "type": "boolean",
       "default": false,
-      "description": "If true, will move all peer dependencies to dependencies"
+      "description": "Whether to move all peer dependencies to the regular dependencies section."
     },
     "dependencies": {
       "type": "array",
       "items": {
         "type": "string"
       },
-      "description": "List of packages that should always be added as dependencies"
+      "description": "A list of package names that should always be added to the 'dependencies' section.",
+      "examples": [["lodash", "axios"]]
     },
     "peerDependencies": {
       "type": "array",
       "items": {
         "type": "string"
       },
-      "description": "List of packages that should always be added as peerDependencies"
+      "description": "A list of package names that should always be added to the 'peerDependencies' section.",
+      "examples": [["react", "react-dom"]]
     }
   },
   "required": []

package/src/generators/index-export/schema.json

@@ -9,21 +9,27 @@
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of projects to generate index exports for.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of a single project to generate an index export for.",
+      "examples": ["my-lib"]
     },
     "generateRootExport": {
       "type": "boolean",
       "default": true,
-      "description": "Generate index.ts in the source root of the project"
+      "description": "Whether to generate an 'index.ts' file in the source root of the project."
     },
     "additionalEntryPoints": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "A list of additional sub-directory entry points to include in the index export.",
+      "examples": [["src/lib/components", "src/lib/services"]]
     }
   },
   "required": []

package/src/generators/index-json-schema/schema.json

@@ -6,7 +6,8 @@
   "properties": {
     "project": {
       "type": "string",
-      "description": "Name of the project"
+      "description": "The name of the project whose JSON schemas should be indexed.",
+      "examples": ["my-lib"]
     }
   },
   "required": ["project"]

package/src/generators/init/schema.json

@@ -5,48 +5,54 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the library project to initialize.",
+      "examples": ["my-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of library projects to initialize.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     },
     "indexExport": {
       "type": "boolean",
-      "description": "Whether to add the index-export target to the library"
+      "description": "Whether to add the 'index-export' target to the library project configuration."
     },
     "targets": {
       "type": "object",
+      "description": "Configuration for specific project targets.",
       "properties": {
         "fixDependencies": {
           "type": "boolean",
-          "description": "If set to false the target fix-dependencies will not be added to the project"
+          "description": "Whether to add the 'fix-dependencies' target to the project."
         },
         "indexExport": {
           "type": "boolean",
-          "description": "If set to false the target index-export will not be added to the project"
+          "description": "Whether to add the 'index-export' target to the project."
         }
       }
     },
     "withInitGenerator": {
       "type": "boolean",
-      "description": "Generate a init generator for the library",
+      "description": "Whether to generate an 'init' generator within the library itself.",
       "default": false
     }
   },

package/src/generators/init-buildable/schema.json

@@ -5,27 +5,32 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the buildable library project to initialize.",
+      "examples": ["my-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of buildable library projects to initialize.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     }
   },
   "required": []

package/src/generators/init-plugin/schema.json

@@ -5,27 +5,32 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the project to initialize as an Nx plugin.",
+      "examples": ["my-plugin"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of projects to initialize as Nx plugins.",
+      "examples": [["my-plugin", "another-plugin"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     }
   },
   "required": []

package/src/generators/init-preset/schema.json

@@ -5,27 +5,32 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the library project to initialize with a preset.",
+      "examples": ["my-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of library projects to initialize with a preset.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     }
   },
   "required": []

package/src/generators/init-publishable/schema.json

@@ -5,41 +5,47 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the library project to initialize for publishing.",
+      "examples": ["my-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of library projects to initialize for publishing.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     },
     "targets": {
       "type": "object",
+      "description": "Configuration for specific project targets.",
       "properties": {
         "fixDependencies": {
           "type": "boolean",
           "default": true,
-          "description": "If set to false the target fix-dependencies will not be added to the project"
+          "description": "Whether to add the 'fix-dependencies' target to the project."
         }
       }
     },
     "withInitGenerator": {
       "type": "boolean",
-      "description": "Generate a init generator for the library",
+      "description": "Whether to generate an 'init' generator within the library itself.",
       "default": false
     }
   },

package/src/generators/init-schematic/schema.json

@@ -5,27 +5,32 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the project to initialize as a schematic library.",
+      "examples": ["my-schematic-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of projects to initialize as schematic libraries.",
+      "examples": [["my-schematic-lib", "another-schematic-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     }
   },
   "required": []

package/src/generators/init-with-migrations/schema.json

@@ -5,27 +5,32 @@
   "type": "object",
   "properties": {
     "project": {
-      "type": "string"
+      "type": "string",
+      "description": "The name of the library project to initialize with migrations support.",
+      "examples": ["my-lib"]
     },
     "projects": {
       "type": "array",
       "items": {
         "type": "string"
-      }
+      },
+      "description": "The list of library projects to initialize with migrations support.",
+      "examples": [["my-lib", "another-lib"]]
     },
     "skipFormat": {
       "type": "boolean",
-      "default": false
+      "default": false,
+      "description": "Whether to skip formatting files with Prettier after initialization."
     },
     "overwrite": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to overwrite existing files"
+      "description": "Whether to overwrite existing files during initialization."
     },
     "skipProjects": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to skip executing project specific initialization"
+      "description": "Whether to skip executing project-specific initialization logic."
     }
   },
   "required": []