@odg/command 1.12.0 → 1.14.0

package/dist/Generators/MakeFile.js

@@ -4,9 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const chemical_x_1 = require("@odg/chemical-x");
+const register_1 = require("../Registrations/register");
 const StubCreator_1 = __importDefault(require("./StubCreator"));
 class MakeFile {
     logger;
+    stubCreator = new StubCreator_1.default();
     constructor(logger) {
         this.logger = logger;
     }
@@ -14,98 +16,138 @@ class MakeFile {
      * Use this function to create Page Crawler class
      *
      * @param {string} pageName Selector file name
-     * @param {MakePageInterface} options Options command
+     * @param {MakePageOptions} options Options command
      * @returns {Promise<void>}
      */
     async makePage(pageName, options) {
-        const stubCreator = new StubCreator_1.default();
         const pageUcFirst = new chemical_x_1.Str(pageName).ucFirst().toString();
-        const filePath = await stubCreator.create("page", `${pageUcFirst}Page`, options.path, {
+        const filePath = await this.stubCreator.create("page", `${pageUcFirst}Page`, options.path, {
             "PageName:UCFirst": pageUcFirst,
             "PageName:LCFirst": pageName.charAt(0).toLowerCase() + pageName.slice(1),
         });
-        if (options.selectors && options.selectorPath) {
-            await this.makeSelectors(pageName, { path: options.selectorPath });
-        }
-        if (options.event && options.eventPath) {
-            await this.makeEvent(pageName, { path: options.eventPath });
-        }
-        if (options.handlerPath && (options.handlerFrom ?? options.handlerTo)) {
-            await this.makeHandler(pageName, {
-                path: options.handlerPath,
-                handlerFrom: options.handlerFrom,
-                handlerTo: options.handlerTo,
-            });
-        }
+        const targets = this.buildRegistrationTargets(options);
+        await this.scaffoldPageAddOns(pageName, options);
+        await (0, register_1.registerArtifact)({
+            kind: "page",
+            name: pageName,
+            pageClassName: `${pageUcFirst}Page`,
+            containerEnumMember: `${pageUcFirst}Page`,
+            filePath,
+        }, targets);
         await this.logger.info(`Page created successfully in : ${filePath}`);
     }
-    /**
-     * Use this function to create selector class
-     *
-     * @param {string} selectorName Page Selector file name
-     * @param {MakeSelectorInterface} options Options command
-     * @returns {Promise<void>}
-     */
     async makeSelectors(selectorName, options) {
-        const stubCreator = new StubCreator_1.default();
         const pageUcFirst = new chemical_x_1.Str(selectorName).ucFirst().toString();
-        const filePath = await stubCreator.create("selector", `${pageUcFirst}Selector`, options.path, {
+        const filePath = await this.stubCreator.create("selector", `${pageUcFirst}Selector`, options.path, {
             "SelectorName:UCFirst": pageUcFirst,
             "SelectorName:LCFirst": selectorName.charAt(0).toLowerCase() + selectorName.slice(1),
         });
+        await (0, register_1.registerArtifact)({
+            kind: "selector",
+            name: selectorName,
+            selectorClassName: `${pageUcFirst}Selector`,
+            filePath,
+        }, this.buildRegistrationTargets(options));
         await this.logger.info(`Selector created successfully in : ${filePath}`);
     }
-    /**
-     * Use this function to create handler file
-     *
-     * @param {string} handlerName Handler name to make
-     * @param {MakeHandlerInterface} options Options command
-     * @returns {Promise<void>}
-     */
     async makeHandler(handlerName, options) {
-        const stubCreator = new StubCreator_1.default();
         const isTransition = options.handlerFrom !== undefined || options.handlerTo !== undefined;
         const handlerClassName = isTransition
             ? `${new chemical_x_1.Str(options.handlerFrom ?? handlerName).ucFirst().toString()}To${new chemical_x_1.Str(options.handlerTo ?? handlerName).ucFirst().toString()}Handler`
             : `${new chemical_x_1.Str(handlerName).ucFirst().toString()}Handler`;
-        const filePath = await stubCreator.create("handler", handlerClassName, options.path, {
+        const handlerPageLcFirst = handlerName.charAt(0).toLowerCase() + handlerName.slice(1);
+        const handlerPageSelectorBundle = `${handlerPageLcFirst}Selector`;
+        const filePath = await this.stubCreator.create("handler", handlerClassName, options.path, {
             "HandlerClassName": handlerClassName,
+            "HandlerPageSelectorBundle": handlerPageSelectorBundle,
         });
+        await (0, register_1.registerArtifact)({
+            kind: "handler",
+            name: handlerName,
+            handlerClassName,
+            containerEnumMember: handlerClassName,
+            filePath,
+        }, this.buildRegistrationTargets(options));
         await this.logger.info(`Handler created successfully in : ${filePath}`);
     }
-    /**
-     * Use this function to create handler file
-     *
-     * @param {string} eventName Event name to make
-     * @param {MakeEventInterface} options Options command
-     * @returns {Promise<void>}
-     */
     async makeEvent(eventName, options) {
-        const stubCreator = new StubCreator_1.default();
         const pageUcFirst = new chemical_x_1.Str(eventName).ucFirst().toString();
-        const filePath = await stubCreator.create("event", `${pageUcFirst}EventListener`, options.path, {
+        const listenerClassName = `${pageUcFirst}EventListener`;
+        const eventEnumMember = `${pageUcFirst}Event`;
+        const containerEnumMember = `${pageUcFirst}EventListener`;
+        const filePath = await this.stubCreator.create("event", listenerClassName, options.path, {
             "EventName:UCFirst": pageUcFirst,
             "EventName:LCFirst": eventName.charAt(0).toLowerCase() + eventName.slice(1),
         });
+        await (0, register_1.registerArtifact)({
+            kind: "event",
+            name: eventName,
+            listenerClassName,
+            eventEnumMember,
+            containerEnumMember,
+            filePath,
+        }, this.buildRegistrationTargets(options));
         await this.logger.info(`Event created successfully in : ${filePath}`);
     }
-    /**
-     * Use this function to create exception file
-     *
-     * @param {string} exceptionName Exception name to make
-     * @param {MakeExceptionInterface} options Options command
-     * @returns {Promise<void>}
-     */
+    async makeConfig(configName, options) {
+        const validator = options.validator ?? "zod.string()";
+        await (0, register_1.registerArtifact)({
+            kind: "config",
+            name: configName,
+            configEnumMembers: [configName],
+            envExampleLines: [`\n# ${configName}`, `${configName}=""`],
+            configValidatorType: validator,
+        }, this.buildRegistrationTargets(options));
+        await this.logger.info(`Config "${configName}" registered successfully`);
+    }
     async makeException(exceptionName, options) {
-        const stubCreator = new StubCreator_1.default();
         const exceptionUcFirst = new chemical_x_1.Str(exceptionName).ucFirst().toString();
         const exceptionType = options.isUnknown ? "UnknownException" : "Exception";
-        const filePath = await stubCreator.create("exception", `${exceptionUcFirst}${exceptionType}`, options.path, {
+        const filePath = await this.stubCreator.create("exception", `${exceptionUcFirst}${exceptionType}`, options.path, {
             "ExceptionType": exceptionType,
             "ExceptionName": exceptionUcFirst,
         });
         await this.logger.info(`Exception created successfully in : ${filePath}`);
     }
+    buildRegistrationTargets(options) {
+        const { register = false, registrationTargets, typeImport, typeImports, ...targets } = options;
+        return {
+            enabled: register,
+            ...registrationTargets,
+            ...targets,
+            typeImports: typeImports ?? typeImport ?? registrationTargets?.typeImports,
+        };
+    }
+    /**
+     * Runs optional selector, event, and handler file generation from make:page, forwarding `register` and
+     * `registrationTargets` so enums and barrels stay in sync with the parent command.
+     *
+     * @param {string} pageName Base page name (same as make:page first argument)
+     * @param {MakePageOptions} options Full make:page options including paths and registration targets
+     * @returns {Promise<void>}
+     */
+    async scaffoldPageAddOns(pageName, options) {
+        if (options.selectors && options.selectorPath) {
+            await this.makeSelectors(pageName, {
+                ...options,
+                path: options.selectorPath,
+            });
+        }
+        if (options.event && options.eventPath) {
+            await this.makeEvent(pageName, {
+                ...options,
+                path: options.eventPath,
+            });
+        }
+        if (options.handlerPath && (options.handlerFrom ?? options.handlerTo)) {
+            await this.makeHandler(pageName, {
+                ...options,
+                path: options.handlerPath,
+                handlerFrom: options.handlerFrom,
+                handlerTo: options.handlerTo,
+            });
+        }
+    }
 }
 exports.default = MakeFile;
 //# sourceMappingURL=MakeFile.js.map

package/dist/Generators/MakeFile.js.map

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

package/dist/Generators/StubCreator.d.ts

@@ -1,5 +1,4 @@
 export default class StubCreator {
-    private readonly filesystem;
     create(stub: string, name: string, pathDestination: string, variables: Record<string, number | string>): Promise<string>;
     /**
      * Return stub file content.
@@ -24,4 +23,5 @@ export default class StubCreator {
      * @returns {Promise<string>}
      */
     getStubPath(name: string): Promise<string>;
+    private appendToIndexIfExists;
 }

package/dist/Generators/StubCreator.js

@@ -1,60 +1,23 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const Filesystem = __importStar(require("node:fs"));
+const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
-const node_util_1 = require("node:util");
 const chemical_x_1 = require("@odg/chemical-x");
 const exception_1 = require("@odg/exception");
 class StubCreator {
-    filesystem = Filesystem;
     async create(stub, name, pathDestination, variables) {
         const destination = await this.getPath(name, pathDestination);
         if (await new chemical_x_1.File(destination).exists()) {
             throw new exception_1.InvalidArgumentException(`The ${name} already exists.`);
         }
         const content = await this.getStub(stub, variables);
-        await (0, node_util_1.promisify)(this.filesystem.mkdir)(pathDestination, { recursive: true });
-        await (0, node_util_1.promisify)(this.filesystem.writeFile)(destination, content, {});
+        await (0, promises_1.mkdir)(pathDestination, { recursive: true });
+        await (0, promises_1.writeFile)(destination, content);
         const indexFile = `${pathDestination}/index.ts`;
-        if (await new chemical_x_1.File(indexFile).exists()) {
-            await (0, node_util_1.promisify)(this.filesystem.appendFile)(indexFile, `\nexport * from "./${name}";\n`, {});
-        }
+        await this.appendToIndexIfExists(indexFile, name);
         return destination;
     }
     /**
@@ -66,7 +29,7 @@ class StubCreator {
      */
     async getStub(name, variables) {
         const pathStub = await this.getStubPath(name);
-        const file = await (0, node_util_1.promisify)(this.filesystem.readFile)(`${pathStub}/${name}.stub`);
+        const file = await (0, promises_1.readFile)(`${pathStub}/${name}.stub`);
         return new chemical_x_1.Str(file.toString())
             .formatUnicorn(variables)
             .toString();
@@ -93,6 +56,18 @@ class StubCreator {
         }
         return node_path_1.default.join(process.cwd(), "node_modules/@odg/command/stubs");
     }
+    async appendToIndexIfExists(indexFile, name) {
+        if (!await new chemical_x_1.File(indexFile).exists()) {
+            return;
+        }
+        const exportLine = `export * from "./${name}";`;
+        const existing = await (0, promises_1.readFile)(indexFile, { encoding: "utf8" });
+        if (existing.includes(exportLine)) {
+            return;
+        }
+        const insert = existing.endsWith("\n") || existing.length === 0 ? "" : "\n";
+        await (0, promises_1.appendFile)(indexFile, `${insert}${exportLine}\n`);
+    }
 }
 exports.default = StubCreator;
 //# sourceMappingURL=StubCreator.js.map

package/dist/Generators/StubCreator.js.map

@@ -1 +1 @@
-{"version":3,"file":"StubCreator.js","sourceRoot":"","sources":["../../src/Generators/StubCreator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAsC;AACtC,0DAAiC;AACjC,yCAAsC;AAEtC,gDAA4C;AAC5C,8CAA0D;AAE1D,MAAqB,WAAW;IAEX,UAAU,GAAsB,UAAU,CAAC;IAErD,KAAK,CAAC,MAAM,CACf,IAAY,EACZ,IAAY,EACZ,eAAuB,EACvB,SAA0C;QAE1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAE9D,IAAI,MAAM,IAAI,iBAAI,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,oCAAwB,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEpD,MAAM,IAAA,qBAAS,EAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAA,qBAAS,EAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAErE,MAAM,SAAS,GAAG,GAAG,eAAe,WAAW,CAAC;QAEhD,IAAI,MAAM,IAAI,iBAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,MAAM,IAAA,qBAAS,EAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,SAAS,EAAE,sBAAsB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,WAAW,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,SAA0C;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAS,EAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,IAAI,IAAI,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,gBAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;aAC1B,aAAa,CAAC,SAAS,CAAC;aACxB,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAY;QAC3C,OAAO,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACjC,IAAI,MAAM,IAAI,iBAAI,CAAC,GAAG,mBAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACzE,OAAO,mBAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,mBAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;IAC3E,CAAC;CAEJ;AAvED,8BAuEC"}
+{"version":3,"file":"StubCreator.js","sourceRoot":"","sources":["../../src/Generators/StubCreator.ts"],"names":[],"mappings":";;;;;AAAA,+CAK0B;AAC1B,0DAAiC;AAEjC,gDAA4C;AAC5C,8CAA0D;AAE1D,MAAqB,WAAW;IAErB,KAAK,CAAC,MAAM,CACf,IAAY,EACZ,IAAY,EACZ,eAAuB,EACvB,SAA0C;QAE1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAE9D,IAAI,MAAM,IAAI,iBAAI,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,oCAAwB,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEpD,MAAM,IAAA,gBAAK,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,GAAG,eAAe,WAAW,CAAC;QAEhD,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAElD,OAAO,WAAW,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,SAA0C;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,QAAQ,IAAI,IAAI,OAAO,CAAC,CAAC;QAExD,OAAO,IAAI,gBAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;aAC1B,aAAa,CAAC,SAAS,CAAC;aACxB,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAY;QAC3C,OAAO,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAC,IAAY;QACjC,IAAI,MAAM,IAAI,iBAAI,CAAC,GAAG,mBAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACzE,OAAO,mBAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,mBAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;IAC3E,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAC,SAAiB,EAAE,IAAY;QAC/D,IAAI,CAAC,MAAM,IAAI,iBAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,OAAO;QACX,CAAC;QAED,MAAM,UAAU,GAAG,oBAAoB,IAAI,IAAI,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE5E,MAAM,IAAA,qBAAU,EAAC,SAAS,EAAE,GAAG,MAAM,GAAG,UAAU,IAAI,CAAC,CAAC;IAC5D,CAAC;CAEJ;AApFD,8BAoFC"}

package/dist/Registrations/pascal-to-dot-lower.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a PascalCase identifier to dot-separated lowercase segments.
+ *
+ * @param {string} identifier PascalCase class or symbol name (e.g. ExampleEventListener)
+ * @returns {string} Dot-separated lowercase (e.g. example.event.listener)
+ */
+export declare function pascalCaseToDotLower(identifier: string): string;
+/**
+ * Resolves the ContainerName string value for any registration.
+ *
+ * @param {string | undefined} override Explicit value from registration targets, if any
+ * @param {string} containerEnumMember Class name used as the ContainerName member
+ * @returns {string} Value for the ContainerName enum entry
+ */
+export declare function resolveContainerEnumMemberValue(override: string | undefined, containerEnumMember: string): string;

package/dist/Registrations/pascal-to-dot-lower.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pascalCaseToDotLower = pascalCaseToDotLower;
+exports.resolveContainerEnumMemberValue = resolveContainerEnumMemberValue;
+/**
+ * Converts a PascalCase identifier to dot-separated lowercase segments.
+ *
+ * @param {string} identifier PascalCase class or symbol name (e.g. ExampleEventListener)
+ * @returns {string} Dot-separated lowercase (e.g. example.event.listener)
+ */
+function pascalCaseToDotLower(identifier) {
+    return identifier
+        .split(/(?=[A-Z])/)
+        .filter((segment) => segment.length > 0)
+        .map((segment) => segment.toLowerCase())
+        .join(".");
+}
+/**
+ * Resolves the ContainerName string value for any registration.
+ *
+ * @param {string | undefined} override Explicit value from registration targets, if any
+ * @param {string} containerEnumMember Class name used as the ContainerName member
+ * @returns {string} Value for the ContainerName enum entry
+ */
+function resolveContainerEnumMemberValue(override, containerEnumMember) {
+    if (override !== undefined) {
+        return override;
+    }
+    return pascalCaseToDotLower(containerEnumMember);
+}
+//# sourceMappingURL=pascal-to-dot-lower.js.map

package/dist/Registrations/pascal-to-dot-lower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascal-to-dot-lower.js","sourceRoot":"","sources":["../../src/Registrations/pascal-to-dot-lower.ts"],"names":[],"mappings":";;AAMA,oDAMC;AASD,0EASC;AA9BD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,UAAkB;IACnD,OAAO,UAAU;SACZ,KAAK,CAAC,WAAW,CAAC;SAClB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;SACvC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,+BAA+B,CAC3C,QAA4B,EAC5B,mBAA2B;IAE3B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;AACrD,CAAC"}

package/dist/Registrations/register.d.ts

@@ -0,0 +1,2 @@
+import type { ArtifactDescriptor, RegistrationTargets } from "./types";
+export declare function registerArtifact(descriptor: ArtifactDescriptor, targets: RegistrationTargets): Promise<void>;

package/dist/Registrations/register.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerArtifact = registerArtifact;
+const node_path_1 = require("node:path");
+const exception_1 = require("@odg/exception");
+const pascal_to_dot_lower_1 = require("./pascal-to-dot-lower");
+const ts_mutators_1 = require("./ts-mutators");
+/** TypeScript path alias for the listeners barrel (see tsconfig paths). */
+const listenersTypeModuleSpecifier = "@listeners";
+/** TypeScript path alias for the pages barrel (see tsconfig paths). */
+const pagesTypeModuleSpecifier = "@pages";
+/** TypeScript path alias for the handlers barrel (see tsconfig paths). */
+const handlersTypeModuleSpecifier = "@handlers";
+function resolveRelativeExportPath(filePath, barrelPath, fallbackExportName) {
+    if (!filePath) {
+        return `./${fallbackExportName}`;
+    }
+    const barrelDirectory = (0, node_path_1.dirname)(barrelPath);
+    const filePathWithoutExtension = filePath.replace(/\.ts$/, "");
+    const relativePath = (0, node_path_1.relative)(barrelDirectory, filePathWithoutExtension);
+    return `./${relativePath}`;
+}
+async function registerContainerEnumMember(containerEnumPath, memberName, memberValue) {
+    await (0, ts_mutators_1.ensureEnumMember)({
+        filePath: containerEnumPath,
+        enumName: "ContainerName",
+        memberName,
+        memberValue,
+    });
+}
+async function registerContainerInterfaceBinding(containerInterfacePath, enumMember, className, moduleSpecifier) {
+    await (0, ts_mutators_1.ensureValueNamedImport)({
+        filePath: containerInterfacePath,
+        moduleSpecifier,
+        name: className,
+    });
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: containerInterfacePath,
+        interfaceName: "ContainerInterface",
+        propertyName: `[ContainerName.${enumMember}]`,
+        propertyType: className,
+    });
+}
+async function registerBarrelExport(barrelPath, filePath, fallbackExportName) {
+    const relativeExportPath = resolveRelativeExportPath(filePath, barrelPath, fallbackExportName);
+    await (0, ts_mutators_1.ensureBarrelExport)({
+        barrelPath,
+        relativeExportPath,
+    });
+}
+async function registerConfigEnumMembers(descriptor, targets) {
+    if (!descriptor.configEnumMembers?.length || !targets.configEnumPath) {
+        return;
+    }
+    for (const key of descriptor.configEnumMembers) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.configEnumPath,
+            enumName: "ConfigName",
+            memberName: key,
+            memberValue: key,
+        });
+    }
+}
+async function registerEnvironmentExampleLines(descriptor, targets) {
+    if (!descriptor.envExampleLines?.length || !targets.envExamplePath) {
+        return;
+    }
+    await (0, ts_mutators_1.ensureEnvironmentExampleLines)({
+        filePath: targets.envExamplePath,
+        lines: descriptor.envExampleLines,
+    });
+}
+async function registerImports(targets) {
+    const imports = targets.typeImports ?? [];
+    if (imports.length === 0)
+        return;
+    const importTargets = new Set([
+        targets.containerEnumPath,
+        targets.eventEnumPath,
+        targets.configEnumPath,
+        targets.containerInterfacePath,
+        targets.eventsInterfacePath,
+        targets.pagesIndexPath,
+        targets.selectorsIndexPath,
+        targets.handlersIndexPath,
+        targets.listenersIndexPath,
+    ].filter(Boolean));
+    await Promise.all([...importTargets].map(async (filePath) => (0, ts_mutators_1.ensureTopLevelStatements)({
+        filePath,
+        statements: imports,
+    })));
+}
+async function registerPage(descriptor, targets) {
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await registerContainerEnumMember(targets.containerEnumPath, descriptor.containerEnumMember, (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(undefined, descriptor.containerEnumMember));
+    }
+    if (descriptor.pageClassName && targets.pagesIndexPath) {
+        await registerBarrelExport(targets.pagesIndexPath, descriptor.filePath, descriptor.pageClassName);
+    }
+    if (descriptor.containerEnumMember && descriptor.pageClassName && targets.containerInterfacePath) {
+        await registerContainerInterfaceBinding(targets.containerInterfacePath, descriptor.containerEnumMember, descriptor.pageClassName, pagesTypeModuleSpecifier);
+    }
+    await registerConfigEnumMembers(descriptor, targets);
+    await registerEnvironmentExampleLines(descriptor, targets);
+}
+async function registerSelector(descriptor, targets) {
+    if (!descriptor.selectorClassName || !targets.selectorsIndexPath)
+        return;
+    await registerBarrelExport(targets.selectorsIndexPath, descriptor.filePath, descriptor.selectorClassName);
+}
+async function registerHandler(descriptor, targets) {
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await registerContainerEnumMember(targets.containerEnumPath, descriptor.containerEnumMember, (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(undefined, descriptor.containerEnumMember));
+    }
+    if (descriptor.handlerClassName && targets.handlersIndexPath) {
+        await registerBarrelExport(targets.handlersIndexPath, descriptor.filePath, descriptor.handlerClassName);
+    }
+    if (descriptor.containerEnumMember && descriptor.handlerClassName && targets.containerInterfacePath) {
+        await registerContainerInterfaceBinding(targets.containerInterfacePath, descriptor.containerEnumMember, descriptor.handlerClassName, handlersTypeModuleSpecifier);
+    }
+}
+async function registerEventsInterface(descriptor, targets) {
+    const payloadType = targets.eventPayloadType;
+    if (!payloadType || !descriptor.eventEnumMember || !targets.eventsInterfacePath) {
+        throw new exception_1.InvalidArgumentException("Missing explicit event payload type: pass --eventPayloadType to register EventsInterface safely.");
+    }
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: targets.eventsInterfacePath,
+        interfaceName: "EventBaseInterface",
+        propertyName: `[EventName.${descriptor.eventEnumMember}]`,
+        propertyType: payloadType,
+    });
+}
+async function registerEventContainerInterface(descriptor, targets) {
+    if (!descriptor.listenerClassName
+        || !descriptor.containerEnumMember
+        || !descriptor.eventEnumMember
+        || !targets.containerInterfacePath) {
+        return;
+    }
+    await (0, ts_mutators_1.ensureTypeNamedImport)({
+        filePath: targets.containerInterfacePath,
+        moduleSpecifier: listenersTypeModuleSpecifier,
+        name: descriptor.listenerClassName,
+    });
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: targets.containerInterfacePath,
+        interfaceName: "ContainerInterface",
+        propertyName: `[ContainerName.${descriptor.containerEnumMember}]`,
+        propertyType: descriptor.listenerClassName,
+    });
+}
+async function registerEvent(descriptor, targets) {
+    if (descriptor.eventEnumMember && targets.eventEnumPath) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.eventEnumPath,
+            enumName: "EventName",
+            memberName: descriptor.eventEnumMember,
+            memberValue: descriptor.eventEnumMember,
+        });
+    }
+    if (descriptor.listenerClassName && targets.listenersIndexPath) {
+        await registerBarrelExport(targets.listenersIndexPath, descriptor.filePath, descriptor.listenerClassName);
+    }
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.containerEnumPath,
+            enumName: "ContainerName",
+            memberName: descriptor.containerEnumMember,
+            memberValue: (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(targets.containerEnumMemberValue, descriptor.containerEnumMember),
+        });
+    }
+    await registerEventContainerInterface(descriptor, targets);
+    if (descriptor.eventEnumMember && targets.eventsInterfacePath) {
+        await registerEventsInterface(descriptor, targets);
+    }
+}
+async function registerConfig(descriptor, targets) {
+    await registerConfigEnumMembers(descriptor, targets);
+    await registerEnvironmentExampleLines(descriptor, targets);
+    if (!descriptor.configEnumMembers?.length || !targets.configValidatorPath) {
+        return;
+    }
+    for (const key of descriptor.configEnumMembers) {
+        await (0, ts_mutators_1.ensureZodObjectEntry)({
+            filePath: targets.configValidatorPath,
+            constName: "configValidator",
+            propertyName: `[ConfigName.${key}]`,
+            propertyValue: descriptor.configValidatorType ?? "zod.string()",
+        });
+    }
+}
+async function registerArtifact(descriptor, targets) {
+    if (!targets.enabled)
+        return;
+    await registerImports(targets);
+    switch (descriptor.kind) {
+        case "page":
+            await registerPage(descriptor, targets);
+            break;
+        case "selector":
+            await registerSelector(descriptor, targets);
+            break;
+        case "handler":
+            await registerHandler(descriptor, targets);
+            break;
+        case "event":
+            await registerEvent(descriptor, targets);
+            break;
+        case "config":
+            await registerConfig(descriptor, targets);
+            break;
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/Registrations/register.js.map

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