@quadnix/octo-build 0.0.8 → 0.0.9

package/dist/commands/create-model/generator-octo-model-template/generators/app/index.js

@@ -0,0 +1,68 @@
+import { readdir, stat } from 'fs/promises';
+import { join, resolve } from 'path';
+import Generator, {} from 'yeoman-generator';
+import { StringUtility } from '../../../../../utilities/string/string.utility.js';
+export default class extends Generator {
+    constructor(args, opts) {
+        super(args, opts);
+        this.moduleName = args[0];
+        this.modelType = args[1];
+        this.packageName = args[2];
+        this.cdkRootDir = args[3];
+    }
+    async initializing() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName, 'models', this.modelType));
+        // Check if directory already exists and is not empty.
+        let targetPathStat;
+        try {
+            targetPathStat = await stat(targetPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        if (targetPathStat?.isDirectory()) {
+            const files = await readdir(targetPath);
+            if (files.length > 0) {
+                throw new Error(`Directory '${targetPath}' already exists and is not empty!`);
+            }
+        }
+        // Set the destination root to the model directory.
+        this.destinationRoot(targetPath);
+    }
+    async writing() {
+        // Create the model file.
+        this.fs.copyTpl(this.templatePath('models/model/model.ts.ejs'), this.destinationPath(`${this.moduleName}.model.ts`), {
+            modelType: this.modelType,
+            modelTypePascal: StringUtility.toPascalCase(this.modelType),
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            packageName: this.packageName,
+        });
+        // Create schema file.
+        this.fs.copyTpl(this.templatePath('models/model/schema.ts.ejs'), this.destinationPath(`${this.moduleName}.schema.ts`), {
+            modelTypePascal: StringUtility.toPascalCase(this.modelType),
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+        });
+        // Create index.ts
+        this.fs.copyTpl(this.templatePath('models/model/index.ts.ejs'), this.destinationPath('index.ts'), {
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+        });
+        // Create actions directory and action file
+        this.fs.copyTpl(this.templatePath('models/model/actions/add.model.action.ts.ejs'), this.destinationPath('actions', `add-${this.moduleName}.model.action.ts`), {
+            modelType: this.modelType,
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+        });
+    }
+    end() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName, 'models', this.modelType));
+        this.log('✅ Your model has been generated successfully!');
+        this.log(`📁 Model created at: ${targetPath}`);
+        this.log('📦 Next steps:');
+        this.log(`   Address all "Fix me" in generated files`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/create-model/generator-octo-model-template/generators/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/commands/create-model/generator-octo-model-template/generators/app/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-model/generator-octo-model-template/generators/app/templates/models/model/actions/add.model.action.ts.ejs

@@ -0,0 +1,50 @@
+import {
+  Action,
+  type ActionOutputs,
+  type Diff,
+  DiffAction,
+  type EnhancedModuleSchema,
+  Factory,
+  type IModelAction,
+  hasNodeName,
+} from '@quadnix/octo';
+import type { <%= moduleNamePascal %>Module } from '../../../<%= moduleName %>.module.js';
+import { <%= moduleNamePascal %> } from '../<%= moduleName %>.model.js';
+
+@Action(<%= moduleNamePascal %>)
+export class Add<%= moduleNamePascal %>ModelAction implements IModelAction<<%= moduleNamePascal %>Module> {
+  filter(diff: Diff): boolean {
+    // Fix me: Update "diff.field" to assert correct model id.
+    return (
+      diff.action === DiffAction.ADD &&
+      diff.node instanceof <%= moduleNamePascal %> &&
+      hasNodeName(diff.node, '<%= modelType %>') &&
+      diff.field === 'my-model-id'
+    );
+  }
+
+  async handle(
+    diff: Diff<<%= moduleNamePascal %>>,
+    actionInputs: EnhancedModuleSchema<<%= moduleNamePascal %>Module>,
+    actionOutputs: ActionOutputs,
+  ): Promise<ActionOutputs> {
+    const <%= modelType %> = diff.node;
+
+    // Fix me: Implement the action logic.
+    // This is where you would create the actual resources for your module.
+
+    return actionOutputs;
+  }
+}
+
+@Factory<Add<%= moduleNamePascal %>ModelAction>(Add<%= moduleNamePascal %>ModelAction)
+export class Add<%= moduleNamePascal %>ModelActionFactory {
+  private static instance: Add<%= moduleNamePascal %>ModelAction;
+
+  static async create(): Promise<Add<%= moduleNamePascal %>ModelAction> {
+    if (!this.instance) {
+      this.instance = new Add<%= moduleNamePascal %>ModelAction();
+    }
+    return this.instance;
+  }
+}

package/dist/commands/create-model/generator-octo-model-template/generators/app/templates/models/model/index.ts.ejs

@@ -0,0 +1,3 @@
+import './actions/add-<%= moduleName %>.model.action.js';
+
+export { <%= moduleNamePascal %> } from './<%= moduleName %>.model.js';

package/dist/commands/create-model/generator-octo-model-template/generators/app/templates/models/model/model.ts.ejs

@@ -0,0 +1,29 @@
+import { Model, <%= modelTypePascal %> } from '@quadnix/octo';
+import { <%= moduleNamePascal %>Schema } from './<%= moduleName %>.schema.js';
+
+@Model<<%= moduleNamePascal %>>('<%= packageName %>', '<%= modelType %>', <%= moduleNamePascal %>Schema)
+export class <%= moduleNamePascal %> extends <%= modelTypePascal %> {
+  // Fix me: Add properties specific to your module.
+  private readonly customProperty: string;
+
+  // Fix me: Update constructor to take properties as inputs.
+  constructor(customProperty: string) {
+    // Fix me: Initialize model with correct ID.
+    super(customProperty);
+
+    // Fix me: Initialize module-specific properties.
+    this.customProperty = customProperty;
+  }
+
+  override synth(): <%= moduleNamePascal %>Schema {
+    // Fix me: Return serialized schema.
+    return {
+      customProperty: this.customProperty,
+    };
+  }
+
+  static override async unSynth(<%= modelType %>: <%= moduleNamePascal %>Schema): Promise<<%= moduleNamePascal %>> {
+    // Fix me: Return unserialized instance of <%= moduleNamePascal %>.
+    return new <%= moduleNamePascal %>(<%= modelType %>.customProperty);
+  }
+}

package/dist/commands/create-model/generator-octo-model-template/generators/app/templates/models/model/schema.ts.ejs

@@ -0,0 +1,8 @@
+import { <%= modelTypePascal %>Schema, Schema, Validate } from '@quadnix/octo';
+
+export class <%= moduleNamePascal %>Schema extends <%= modelTypePascal %>Schema {
+  // Fix me: Add schema properties specific to your module
+  // Example:
+  @Validate({ options: { minLength: 1 } })
+  customProperty = Schema<string>();
+}

package/dist/commands/create-model/index.d.ts

@@ -0,0 +1 @@
+export { createModelCommand } from './create-model.command.js';

package/dist/commands/create-model/index.js

@@ -0,0 +1,2 @@
+export { createModelCommand } from './create-model.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/create-model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/create-model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/commands/create-module/create-module.command.d.ts

@@ -0,0 +1,12 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+export declare const createModuleCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<{
+        name: string;
+        package: string;
+        path: string;
+        type: string;
+    }>) => Promise<void>;
+};

package/dist/commands/create-module/create-module.command.js

@@ -0,0 +1,62 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import { createEnv } from 'yeoman-environment';
+import { StringUtility } from '../../utilities/string/string.utility.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const createModuleCommand = {
+    builder: (yargs) => {
+        return yargs
+            .option('name', {
+            alias: 'n',
+            demandOption: true,
+            description: 'Name of the module to create. Should be in kebab-case (e.g., my-awesome-region).',
+            type: 'string',
+        })
+            .option('type', {
+            alias: 't',
+            choices: StringUtility.AVAILABLE_MODEL_TYPES,
+            demandOption: true,
+            description: 'Type of model this module is for.',
+            type: 'string',
+        })
+            .option('package', {
+            demandOption: true,
+            description: 'Package name for the module.',
+            type: 'string',
+        })
+            .option('path', {
+            alias: 'p',
+            default: '.',
+            description: 'Root directory path of the CDK.',
+            type: 'string',
+        });
+    },
+    command: 'create-module',
+    describe: 'Create a new Octo module.',
+    handler: async (argv) => {
+        const { name, package: packageName, path, type } = argv;
+        // Validate module name format (should be kebab-case)
+        if (!StringUtility.isKebabCase(name)) {
+            console.error(chalk.red('Module name must be in kebab-case format (e.g., my-awesome-region)'));
+            process.exit(1);
+        }
+        console.log(chalk.blue(`Creating module "${name}" of type "${type}"...`));
+        const env = createEnv();
+        env.register(resolve(__dirname, 'generator-octo-module-template/generators/app/index.js'), {
+            namespace: 'generator-octo-module-template:app',
+        });
+        try {
+            await env.run(['generator-octo-module-template:app', name, type, packageName, path], {
+                skipCache: true,
+                skipInstall: true,
+            });
+            console.log(chalk.green(`Successfully created module!`));
+        }
+        catch (error) {
+            console.error(chalk.red(`Failed to create module! ${error.message}`));
+            process.exit(1);
+        }
+    },
+};
+//# sourceMappingURL=create-module.command.js.map

package/dist/commands/create-module/create-module.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-module.command.js","sourceRoot":"","sources":["../../../src/commands/create-module/create-module.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK;aACT,MAAM,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,kFAAkF;YAC/F,IAAI,EAAE,QAAQ;SACf,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,aAAa,CAAC,qBAAqB;YAC5C,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,mCAAmC;YAChD,IAAI,EAAE,QAAQ;SACf,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,8BAA8B;YAC3C,IAAI,EAAE,QAAQ;SACf,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,iCAAiC;YAC9C,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,2BAA2B;IACrC,OAAO,EAAE,KAAK,EACZ,IAAuF,EACxE,EAAE;QACjB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAExD,qDAAqD;QACrD,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;YAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC;QAE1E,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,wDAAwD,CAAC,EAAE;YACzF,SAAS,EAAE,oCAAoC;SAChD,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,oCAAoC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;gBACnF,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/commands/create-module/generator-octo-module-template/generators/app/index.d.ts

@@ -0,0 +1,11 @@
+import Generator, { type BaseOptions } from 'yeoman-generator';
+export default class extends Generator {
+    private readonly cdkRootDir;
+    private readonly modelType;
+    private readonly moduleName;
+    private readonly packageName;
+    constructor(args: string[], opts: BaseOptions);
+    initializing(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+}

package/dist/commands/create-module/generator-octo-module-template/generators/app/index.js

@@ -0,0 +1,60 @@
+import { readdir, stat } from 'fs/promises';
+import { join, resolve } from 'path';
+import Generator, {} from 'yeoman-generator';
+import { StringUtility } from '../../../../../utilities/string/string.utility.js';
+export default class extends Generator {
+    constructor(args, opts) {
+        super(args, opts);
+        this.moduleName = args[0];
+        this.modelType = args[1];
+        this.packageName = args[2];
+        this.cdkRootDir = args[3];
+    }
+    async initializing() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName));
+        // Check if directory already exists and is not empty.
+        let targetPathStat;
+        try {
+            targetPathStat = await stat(targetPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        if (targetPathStat?.isDirectory()) {
+            const files = await readdir(targetPath, { withFileTypes: true });
+            if (files.filter((f) => f.isFile()).length > 0) {
+                throw new Error(`Directory '${targetPath}' already exists and is not empty!`);
+            }
+        }
+        // Set the destination root to the module directory.
+        this.destinationRoot(targetPath);
+    }
+    async writing() {
+        // Create the module file
+        this.fs.copyTpl(this.templatePath('module.ts.ejs'), this.destinationPath(`${this.moduleName}.module.ts`), {
+            modelTypePascal: StringUtility.toPascalCase(this.modelType),
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            packageName: this.packageName,
+        });
+        // Create index.schema.ts
+        this.fs.copyTpl(this.templatePath('index.schema.ts.ejs'), this.destinationPath('index.schema.ts'), {
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+        });
+        // Create index.ts
+        this.fs.copyTpl(this.templatePath('index.ts.ejs'), this.destinationPath('index.ts'), {
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+        });
+    }
+    end() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName));
+        this.log('✅ Your module has been generated successfully!');
+        this.log(`📁 Module created at: ${targetPath}`);
+        this.log('📦 Next steps:');
+        this.log(`   Update index.schema.ts`);
+        this.log(`   Implement the logic in ${this.moduleName}.module.ts`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/create-module/generator-octo-module-template/generators/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/commands/create-module/generator-octo-module-template/generators/app/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-module/generator-octo-module-template/generators/app/templates/index.schema.ts.ejs

@@ -0,0 +1,3 @@
+export class <%= moduleNamePascal %>ModuleSchema {
+  // Fix me: Add schema properties as needed for your module.
+}

package/dist/commands/create-module/generator-octo-module-template/generators/app/templates/index.ts.ejs

@@ -0,0 +1 @@
+export { <%= moduleNamePascal %>Module } from './<%= moduleName %>.module.js';

package/dist/commands/create-module/generator-octo-module-template/generators/app/templates/module.ts.ejs

@@ -0,0 +1,9 @@
+import { AModule, Module, type <%= modelTypePascal %> } from '@quadnix/octo';
+import { <%= moduleNamePascal %>ModuleSchema } from './index.schema.js';
+
+@Module<<%= moduleNamePascal %>Module>('<%= packageName %>', <%= moduleNamePascal %>ModuleSchema)
+export class <%= moduleNamePascal %>Module extends AModule<<%= moduleNamePascal %>ModuleSchema, <%= modelTypePascal %>> {
+  async onInit(inputs: <%= moduleNamePascal %>ModuleSchema): Promise<<%= modelTypePascal %>> {
+    // Fix me: Create and return a new instance of <%= modelTypePascal %>.
+  }
+}

package/dist/commands/create-module/index.d.ts

@@ -0,0 +1 @@
+export { createModuleCommand } from './create-module.command.js';

package/dist/commands/create-module/index.js

@@ -0,0 +1,2 @@
+export { createModuleCommand } from './create-module.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/create-module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/create-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/commands/create-overlay/create-overlay.command.d.ts

@@ -0,0 +1,13 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+export declare const createOverlayCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<{
+        name: string;
+        overlay: string;
+        package: string;
+        path: string;
+        type: string;
+    }>) => Promise<void>;
+};

package/dist/commands/create-overlay/create-overlay.command.js

@@ -0,0 +1,67 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import { createEnv } from 'yeoman-environment';
+import { StringUtility } from '../../utilities/string/string.utility.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const createOverlayCommand = {
+    builder: (yargs) => {
+        return yargs
+            .option('name', {
+            alias: 'n',
+            demandOption: true,
+            description: 'Name of the module where the overlay is created. Should be in kebab-case (e.g., my-awesome-region).',
+            type: 'string',
+        })
+            .option('type', {
+            alias: 't',
+            choices: StringUtility.AVAILABLE_MODEL_TYPES,
+            demandOption: true,
+            description: 'Type of model this overlay is for.',
+            type: 'string',
+        })
+            .option('package', {
+            demandOption: true,
+            description: 'Package name for the overlay.',
+            type: 'string',
+        })
+            .option('overlay', {
+            demandOption: true,
+            description: 'Overlay name for the module.',
+            type: 'string',
+        })
+            .option('path', {
+            alias: 'p',
+            default: '.',
+            description: 'Root directory path of the CDK.',
+            type: 'string',
+        });
+    },
+    command: 'create-overlay',
+    describe: 'Create a new Octo overlay.',
+    handler: async (argv) => {
+        const { name, overlay, package: packageName, path, type } = argv;
+        // Validate module and overlay name format (should be kebab-case)
+        if (!StringUtility.isKebabCase(name) || !StringUtility.isKebabCase(overlay)) {
+            console.error(chalk.red('Module/Overlay name must be in kebab-case format (e.g., my-awesome-region)'));
+            process.exit(1);
+        }
+        console.log(chalk.blue(`Creating overlay for module "${name}" of type "${type}"...`));
+        const env = createEnv();
+        env.register(resolve(__dirname, 'generator-octo-overlay-template/generators/app/index.js'), {
+            namespace: 'generator-octo-overlay-template:app',
+        });
+        try {
+            await env.run(['generator-octo-overlay-template:app', name, type, packageName, overlay, path], {
+                skipCache: true,
+                skipInstall: true,
+            });
+            console.log(chalk.green(`Successfully created overlay!`));
+        }
+        catch (error) {
+            console.error(chalk.red(`Failed to create overlay! ${error.message}`));
+            process.exit(1);
+        }
+    },
+};
+//# sourceMappingURL=create-overlay.command.js.map

package/dist/commands/create-overlay/create-overlay.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-overlay.command.js","sourceRoot":"","sources":["../../../src/commands/create-overlay/create-overlay.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/index.d.ts

@@ -0,0 +1,12 @@
+import Generator, { type BaseOptions } from 'yeoman-generator';
+export default class extends Generator {
+    private readonly cdkRootDir;
+    private readonly modelType;
+    private readonly moduleName;
+    private readonly overlayName;
+    private readonly packageName;
+    constructor(args: string[], opts: BaseOptions);
+    initializing(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+}

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/index.js

@@ -0,0 +1,72 @@
+import { readdir, stat } from 'fs/promises';
+import { join, resolve } from 'path';
+import Generator, {} from 'yeoman-generator';
+import { StringUtility } from '../../../../../utilities/string/string.utility.js';
+export default class extends Generator {
+    constructor(args, opts) {
+        super(args, opts);
+        this.moduleName = args[0];
+        this.modelType = args[1];
+        this.packageName = args[2];
+        this.overlayName = args[3];
+        this.cdkRootDir = args[4];
+    }
+    async initializing() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName, 'overlays', `${this.moduleName}-${this.overlayName}`));
+        // Check if directory already exists and is not empty.
+        let targetPathStat;
+        try {
+            targetPathStat = await stat(targetPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        if (targetPathStat?.isDirectory()) {
+            const files = await readdir(targetPath);
+            if (files.length > 0) {
+                throw new Error(`Directory '${targetPath}' already exists and is not empty!`);
+            }
+        }
+        // Set the destination root to the overlay directory.
+        this.destinationRoot(targetPath);
+    }
+    async writing() {
+        // Create the overlay file.
+        this.fs.copyTpl(this.templatePath('overlays/overlay/overlay.ts.ejs'), this.destinationPath(`${this.moduleName}-${this.overlayName}.overlay.ts`), {
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            overlayName: this.overlayName,
+            overlayNamePascal: StringUtility.toPascalCase(this.overlayName),
+            packageName: this.packageName,
+        });
+        // Create schema file.
+        this.fs.copyTpl(this.templatePath('overlays/overlay/overlay.schema.ts.ejs'), this.destinationPath(`${this.moduleName}-${this.overlayName}.schema.ts`), {
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            overlayNamePascal: StringUtility.toPascalCase(this.overlayName),
+        });
+        // Create index.ts
+        this.fs.copyTpl(this.templatePath('overlays/overlay/index.ts.ejs'), this.destinationPath('index.ts'), {
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            overlayName: this.overlayName,
+            overlayNamePascal: StringUtility.toPascalCase(this.overlayName),
+        });
+        // Create actions directory and action file
+        this.fs.copyTpl(this.templatePath('overlays/overlay/actions/add.overlay.action.ts.ejs'), this.destinationPath('actions', `add-${this.moduleName}-${this.overlayName}.overlay.action.ts`), {
+            moduleName: this.moduleName,
+            moduleNamePascal: StringUtility.toPascalCase(this.moduleName),
+            overlayName: this.overlayName,
+            overlayNamePascal: StringUtility.toPascalCase(this.overlayName),
+        });
+    }
+    end() {
+        const targetPath = resolve(join(this.cdkRootDir, 'src', 'modules', this.modelType, this.moduleName, 'overlays', `${this.moduleName}-${this.overlayName}`));
+        this.log('✅ Your overlay has been generated successfully!');
+        this.log(`📁 Overlay created at: ${targetPath}`);
+        this.log('📦 Next steps:');
+        this.log(`   Address all "Fix me" in generated files`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/commands/create-overlay/generator-octo-overlay-template/generators/app/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/templates/overlays/overlay/actions/add.overlay.action.ts.ejs

@@ -0,0 +1,50 @@
+import {
+  Action,
+  type ActionOutputs,
+  type Diff,
+  DiffAction,
+  type EnhancedModuleSchema,
+  Factory,
+  type IModelAction,
+  hasNodeName,
+} from '@quadnix/octo';
+import type { <%= moduleNamePascal %>Module } from '../../../<%= moduleName %>.module.js';
+import { <%= moduleNamePascal %><%= overlayNamePascal %>Overlay } from '../<%= moduleName %>-<%= overlayName %>.overlay.js';
+
+@Action(<%= moduleNamePascal %><%= overlayNamePascal %>Overlay)
+export class Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction implements IModelAction<<%= moduleNamePascal %>Module> {
+  filter(diff: Diff): boolean {
+    return (
+      diff.action === DiffAction.ADD &&
+      diff.node instanceof <%= moduleNamePascal %><%= overlayNamePascal %>Overlay &&
+      hasNodeName(diff.node, '<%= moduleName %>-<%= overlayName %>-overlay') &&
+      diff.field === 'overlayId'
+    );
+  }
+
+  async handle(
+    diff: Diff<<%= moduleNamePascal %><%= overlayNamePascal %>Overlay>,
+    actionInputs: EnhancedModuleSchema<<%= moduleNamePascal %>Module>,
+    actionOutputs: ActionOutputs,
+  ): Promise<ActionOutputs> {
+    const overlay = diff.node;
+    const properties = overlay.properties;
+
+    // Fix me: Implement the action logic.
+    // This is where you would create the actual resources for your module.
+
+    return actionOutputs;
+  }
+}
+
+@Factory<Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction>(Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction)
+export class Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayActionFactory {
+  private static instance: Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction;
+
+  static async create(): Promise<Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction> {
+    if (!this.instance) {
+      this.instance = new Add<%= moduleNamePascal %><%= overlayNamePascal %>OverlayAction();
+    }
+    return this.instance;
+  }
+}

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/templates/overlays/overlay/index.ts.ejs

@@ -0,0 +1,3 @@
+import './actions/add-<%= moduleName %>-<%= overlayName %>.overlay.action.js';
+
+export { <%= moduleNamePascal %><%= overlayNamePascal %>Overlay } from './<%= moduleName %>-<%= overlayName %>.overlay.js';

package/dist/commands/create-overlay/generator-octo-overlay-template/generators/app/templates/overlays/overlay/overlay.schema.ts.ejs

@@ -0,0 +1,13 @@
+import { BaseOverlaySchema, Schema, Validate } from '@quadnix/octo';
+
+export class <%= moduleNamePascal %><%= overlayNamePascal %>OverlaySchema extends BaseOverlaySchema {
+  @Validate({
+    destruct: (value: <%= moduleNamePascal %><%= overlayNamePascal %>OverlaySchema['properties']): string[] => [
+      // Fix me: Add properties for validation.
+    ],
+    options: { minLength: 1 },
+  })
+  override properties = Schema<{
+    // Fix me: Add overlay properties.
+  }>();
+}