@mxpicture/gcp-functions-generator 1.1.2 → 1.1.4

package/dist/4testing/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/4testing/utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,QAA8B,CAAC;AAClD,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D,eAAO,MAAM,mBAAmB,uBACiB,CAAC;AAElD,eAAO,MAAM,mBAAmB,GAAU,GAAG,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,IAAI,CAKxE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,gBAAgB,MAAM,YACD,CAAC;AAEtD,eAAO,MAAM,qBAAqB,yBAGL,CAAC;AAE9B,eAAO,MAAM,uBAAuB,QAAa,OAAO,CAAC,IAAI,CAK5D,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/4testing/utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM,QAA8B,CAAC;AAClD,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D,eAAO,MAAM,mBAAmB,uBACiB,CAAC;AAElD,eAAO,MAAM,mBAAmB,GAAU,GAAG,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,IAAI,CAKxE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,gBAAgB,MAAM,YACD,CAAC;AAEtD,eAAO,MAAM,qBAAqB,yBAGL,CAAC;AAE9B,eAAO,MAAM,uBAAuB,QAAa,OAAO,CAAC,IAAI,CAK5D,CAAC"}

package/dist/4testing/utils.js

@@ -1,5 +1,6 @@
 import { readdir, rm } from "node:fs/promises";
 import { join, resolve } from "node:path";
+const __dirname = import.meta.dirname;
 export const wsRoot = resolve(__dirname, "../..");
 export const templatesDir = resolve(__dirname, "./templates");
 export const createTestWorkspace = async () => join(__dirname, `generator-test-${Date.now()}`);

package/dist/4testing/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/4testing/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,IAAI,EAAE,CAC5C,IAAI,CAAC,SAAS,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,CAAgB,EAAiB,EAAE;IAC3E,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,cAAsB,EAAE,EAAE,CACxD,8BAA8B,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,IAAI,EAAE,CAC9C,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;KAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,IAAmB,EAAE;IAC/D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC/C,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CACzE,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/4testing/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,IAAI,EAAE,CAC5C,IAAI,CAAC,SAAS,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,CAAgB,EAAiB,EAAE;IAC3E,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,cAAsB,EAAE,EAAE,CACxD,8BAA8B,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,IAAI,EAAE,CAC9C,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;KAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,IAAmB,EAAE;IAC/D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC/C,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CACzE,CAAC;AACJ,CAAC,CAAC"}

package/dist/common/Barrel.d.ts

@@ -1,24 +1,74 @@
 import { DecoTargetType } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Represents the result of creating a barrel (index) file for a directory.
+ */
 export interface BarrelResult {
+    /** Absolute path to the directory containing the barrel file. */
     dirPath: string;
+    /** Absolute path to the generated barrel file. */
     barrelFilePath: string;
+    /** Array of export statements to write into the barrel file. */
     exportsCode: string[];
 }
+/**
+ * Groups files in the same directory that share a common barrel file.
+ */
 export interface BarrelFileGroup {
+    /** Absolute path to the directory. */
     dirPath: string;
+    /** Name of the barrel file (typically `index.ts`). */
     barrelFilename: string;
+    /** File names within the directory to re-export. */
     filenames: string[];
 }
+/**
+ * Manages generation of barrel (index) files that re-export modules from a directory.
+ *
+ * @remarks
+ * Uses a singleton-per-target-type pattern via {@link Barrel.instance}.
+ * All created instances are tracked in {@link Barrel.instances}.
+ */
 export declare class Barrel {
     readonly targetType: DecoTargetType;
+    /** When `true`, skips updating `package.json` exports during barrel generation. */
     static ignorePackageJson: boolean;
+    /** All barrel instances created so far, one per {@link DecoTargetType}. */
     static instances: Barrel[];
     protected filePaths: string[];
+    /**
+     * Retrieves or creates the singleton barrel instance for a given target type.
+     *
+     * @param targetType - The decorator target type to get the barrel for.
+     * @returns The existing or newly created {@link Barrel} instance.
+     */
     static instance(targetType: DecoTargetType): Barrel;
     protected constructor(targetType: DecoTargetType);
+    /**
+     * Registers file paths to be included in the barrel output.
+     *
+     * @param filePaths - One or more absolute file paths to add.
+     */
     add(...filePaths: string[]): void;
+    /**
+     * Creates barrel results by grouping registered file paths by directory.
+     *
+     * @returns An array of {@link BarrelResult} objects, one per directory.
+     */
     create(): BarrelResult[];
+    /**
+     * Writes barrel files to disk, formatting the code before writing.
+     *
+     * @param results - The barrel results to write.
+     */
     write(results: BarrelResult[]): Promise<void>;
+    /**
+     * Updates the target `package.json` exports map to include the generated barrel paths.
+     *
+     * @remarks
+     * Skipped when {@link Barrel.ignorePackageJson} is `true`.
+     *
+     * @param results - The barrel results whose paths should be added to `package.json`.
+     */
     ensurePackageBarrels(results: BarrelResult[]): Promise<void>;
     protected groupPaths(filePaths: string[]): BarrelFileGroup[];
 }

package/dist/common/Barrel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Barrel.d.ts","sourceRoot":"","sources":["../../src/common/Barrel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAG3E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,MAAM;aAgBqB,UAAU,EAAE,cAAc;IAfhE,OAAc,iBAAiB,EAAE,OAAO,CAAS;IACjD,OAAc,SAAS,EAAE,MAAM,EAAE,CAAM;IACvC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;WAErB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAW1D,SAAS,aAA6B,UAAU,EAAE,cAAc;IAEzD,GAAG,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAIjC,MAAM,IAAI,YAAY,EAAE;IAUlB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE;CAsB7D"}
+{"version":3,"file":"Barrel.d.ts","sourceRoot":"","sources":["../../src/common/Barrel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;aAwBqB,UAAU,EAAE,cAAc;IAvBhE,mFAAmF;IACnF,OAAc,iBAAiB,EAAE,OAAO,CAAS;IACjD,2EAA2E;IAC3E,OAAc,SAAS,EAAE,MAAM,EAAE,CAAM;IACvC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;IAEnC;;;;;OAKG;WACW,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAW1D,SAAS,aAA6B,UAAU,EAAE,cAAc;IAEhE;;;;OAIG;IACI,GAAG,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC;;;;OAIG;IACI,MAAM,IAAI,YAAY,EAAE;IAU/B;;;;OAIG;IACU,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1D;;;;;;;OAOG;IACU,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE;CAsB7D"}

package/dist/common/Barrel.js

@@ -2,11 +2,26 @@ import { basename, dirname, join } from "node:path";
 import { mkdir, writeFile, readFile } from "node:fs/promises";
 import { directories } from "./Directories.js";
 import { formatCode } from "@mxpicture/build-api/code";
+/**
+ * Manages generation of barrel (index) files that re-export modules from a directory.
+ *
+ * @remarks
+ * Uses a singleton-per-target-type pattern via {@link Barrel.instance}.
+ * All created instances are tracked in {@link Barrel.instances}.
+ */
 export class Barrel {
     targetType;
+    /** When `true`, skips updating `package.json` exports during barrel generation. */
     static ignorePackageJson = false;
+    /** All barrel instances created so far, one per {@link DecoTargetType}. */
     static instances = [];
     filePaths = [];
+    /**
+     * Retrieves or creates the singleton barrel instance for a given target type.
+     *
+     * @param targetType - The decorator target type to get the barrel for.
+     * @returns The existing or newly created {@link Barrel} instance.
+     */
     static instance(targetType) {
         let found = this.instances.find((barrel) => barrel.targetType === targetType);
         if (!found) {
@@ -18,9 +33,19 @@ export class Barrel {
     constructor(targetType) {
         this.targetType = targetType;
     }
+    /**
+     * Registers file paths to be included in the barrel output.
+     *
+     * @param filePaths - One or more absolute file paths to add.
+     */
     add(...filePaths) {
         this.filePaths.push(...filePaths);
     }
+    /**
+     * Creates barrel results by grouping registered file paths by directory.
+     *
+     * @returns An array of {@link BarrelResult} objects, one per directory.
+     */
     create() {
         return this.groupPaths(this.filePaths).map((group) => ({
             dirPath: group.dirPath,
@@ -28,6 +53,11 @@ export class Barrel {
             exportsCode: group.filenames.map((fielname) => `export * from "./${fielname}";`),
         }));
     }
+    /**
+     * Writes barrel files to disk, formatting the code before writing.
+     *
+     * @param results - The barrel results to write.
+     */
     async write(results) {
         const promises = [];
         for (const result of results) {
@@ -39,6 +69,14 @@ export class Barrel {
         }
         await Promise.all(promises);
     }
+    /**
+     * Updates the target `package.json` exports map to include the generated barrel paths.
+     *
+     * @remarks
+     * Skipped when {@link Barrel.ignorePackageJson} is `true`.
+     *
+     * @param results - The barrel results whose paths should be added to `package.json`.
+     */
     async ensurePackageBarrels(results) {
         if (Barrel.ignorePackageJson) {
             console.log("ensurePackageBarrels ignored");

package/dist/common/Barrel.js.map

@@ -1 +1 @@
-{"version":3,"file":"Barrel.js","sourceRoot":"","sources":["../../src/common/Barrel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAcvD,MAAM,OAAO,MAAM;IAgBqB;IAf/B,MAAM,CAAC,iBAAiB,GAAY,KAAK,CAAC;IAC1C,MAAM,CAAC,SAAS,GAAa,EAAE,CAAC;IAC7B,SAAS,GAAa,EAAE,CAAC;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAA0B;QAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,CAC7C,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAsC,UAA0B;QAA1B,eAAU,GAAV,UAAU,CAAgB;IAAG,CAAC;IAE7D,GAAG,CAAC,GAAG,SAAmB;QAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACpC,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC;YACzD,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAC9B,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,QAAQ,IAAI,CAC/C;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,OAAuB;QACxC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CACX,CAAC,KAAK,IAAI,EAAE;gBACV,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7D,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjD,OAAO,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC,CAAC,EAAE,CACL,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAAC,OAAuB;QACvD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC/B,MAAM,SAAS,GAAG,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;YACnC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAES,UAAU,CAAC,SAAmB;QACtC,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEpC,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG;oBACN,OAAO;oBACP,SAAS,EAAE,EAAE;oBACb,cAAc,EAAE,UAAU;iBAC3B,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"Barrel.js","sourceRoot":"","sources":["../../src/common/Barrel.ts"],"names":[],"mappings":"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"}

package/dist/common/Collector.d.ts

@@ -1,22 +1,70 @@
 import { DecoNames, DecoTargetType } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Identifies a collected item by its base name and target type.
+ */
 export interface CollectorKey {
     basename: string;
     targetType: DecoTargetType;
 }
+/**
+ * Data associated with a collected decorator, primarily its resolved names.
+ */
 export interface CollectorData {
     names: DecoNames;
 }
+/**
+ * A single entry in the collector, pairing a key with its data.
+ */
 export interface CollectorItem {
     key: CollectorKey;
     data: CollectorData;
 }
+/**
+ * Collects and indexes decorator metadata by base name and target type.
+ *
+ * @remarks
+ * Acts as a shared registry across generators so that later generators
+ * (e.g. Zod) can reference names resolved by earlier generators (e.g. Doc).
+ * Use {@link Collector.instance} for the global singleton.
+ */
 export declare class Collector {
     protected items: CollectorItem[];
+    /**
+     * Returns the global singleton instance of the collector.
+     *
+     * @returns The shared {@link Collector} instance.
+     */
     static instance(): Collector;
     constructor();
+    /**
+     * Adds a decorator entry if one with the same base name and target type does not already exist.
+     *
+     * @param basename - The base name of the decorator.
+     * @param targetType - The target type (e.g. common, backend, frontend).
+     * @param data - The decorator metadata to store.
+     */
     add(basename: string, targetType: DecoTargetType, data: CollectorData): void;
+    /**
+     * Finds a collector item by exact base name and target type.
+     *
+     * @param basename - The base name to search for.
+     * @param targetType - The target type to match.
+     * @returns The matching item, or `null` if not found.
+     */
     find(basename: string, targetType: DecoTargetType): CollectorItem | null;
+    /**
+     * Searches for collector items where the name matches the base name or any named property.
+     *
+     * @param name - The name to search across all decorator name properties.
+     * @returns An array of matching {@link CollectorItem} entries.
+     */
     findGeneric(name: string): CollectorItem[];
+    /**
+     * Returns the first matching collector item for the given name.
+     *
+     * @param name - The name to search for.
+     * @returns The first matching item, or `null` if none found.
+     */
     findFirst(name: string): CollectorItem | null;
 }
 //# sourceMappingURL=Collector.d.ts.map

package/dist/common/Collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../src/common/Collector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAET,cAAc,EACf,MAAM,2CAA2C,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACrB;AAID,qBAAa,SAAS;IACpB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,CAAM;WAExB,QAAQ,IAAI,SAAS;;IAO5B,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,aAAa,GAClB,IAAI;IAKA,IAAI,CACT,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,GACzB,aAAa,GAAG,IAAI;IAShB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAc1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CAIrD"}
+{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../src/common/Collector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAET,cAAc,EACf,MAAM,2CAA2C,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACrB;AAID;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,CAAM;IAEtC;;;;OAIG;WACW,QAAQ,IAAI,SAAS;;IAOnC;;;;;;OAMG;IACI,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,aAAa,GAClB,IAAI;IAKP;;;;;;OAMG;IACI,IAAI,CACT,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,GACzB,aAAa,GAAG,IAAI;IASvB;;;;;OAKG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAcjD;;;;;OAKG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CAIrD"}

package/dist/common/Collector.js

@@ -1,21 +1,54 @@
 import { decoNamesProperties, } from "@mxpicture/gcp-functions-common/decorator";
 let __instance = null;
+/**
+ * Collects and indexes decorator metadata by base name and target type.
+ *
+ * @remarks
+ * Acts as a shared registry across generators so that later generators
+ * (e.g. Zod) can reference names resolved by earlier generators (e.g. Doc).
+ * Use {@link Collector.instance} for the global singleton.
+ */
 export class Collector {
     items = [];
+    /**
+     * Returns the global singleton instance of the collector.
+     *
+     * @returns The shared {@link Collector} instance.
+     */
     static instance() {
         if (!__instance)
             __instance = new Collector();
         return __instance;
     }
     constructor() { }
+    /**
+     * Adds a decorator entry if one with the same base name and target type does not already exist.
+     *
+     * @param basename - The base name of the decorator.
+     * @param targetType - The target type (e.g. common, backend, frontend).
+     * @param data - The decorator metadata to store.
+     */
     add(basename, targetType, data) {
         if (this.find(basename, targetType))
             return;
         this.items.push({ key: { basename, targetType }, data: { ...data } });
     }
+    /**
+     * Finds a collector item by exact base name and target type.
+     *
+     * @param basename - The base name to search for.
+     * @param targetType - The target type to match.
+     * @returns The matching item, or `null` if not found.
+     */
     find(basename, targetType) {
         return (this.items.find((item) => item.key.basename === basename && item.key.targetType === targetType) ?? null);
     }
+    /**
+     * Searches for collector items where the name matches the base name or any named property.
+     *
+     * @param name - The name to search across all decorator name properties.
+     * @returns An array of matching {@link CollectorItem} entries.
+     */
     findGeneric(name) {
         const results = [];
         for (const item of this.items) {
@@ -30,6 +63,12 @@ export class Collector {
         }
         return results;
     }
+    /**
+     * Returns the first matching collector item for the given name.
+     *
+     * @param name - The name to search for.
+     * @returns The first matching item, or `null` if none found.
+     */
     findFirst(name) {
         const results = this.findGeneric(name);
         return results.length > 0 ? results[0] : null;

package/dist/common/Collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"Collector.js","sourceRoot":"","sources":["../../src/common/Collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GAEpB,MAAM,2CAA2C,CAAC;AAgBnD,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC,MAAM,OAAO,SAAS;IACV,KAAK,GAAoB,EAAE,CAAC;IAE/B,MAAM,CAAC,QAAQ;QACpB,IAAI,CAAC,UAAU;YAAE,UAAU,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,gBAAsB,CAAC;IAEhB,GAAG,CACR,QAAgB,EAChB,UAA0B,EAC1B,IAAmB;QAEnB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAEM,IAAI,CACT,QAAgB,EAChB,UAA0B;QAE1B,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,IAAI,CACb,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU,CACvE,IAAI,IAAI,CACV,CAAC;IACJ,CAAC;IAEM,WAAW,CAAC,IAAY;QAC7B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;gBACvC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,SAAS,CAAC,IAAY;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;CACF"}
+{"version":3,"file":"Collector.js","sourceRoot":"","sources":["../../src/common/Collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GAEpB,MAAM,2CAA2C,CAAC;AAyBnD,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACV,KAAK,GAAoB,EAAE,CAAC;IAEtC;;;;OAIG;IACI,MAAM,CAAC,QAAQ;QACpB,IAAI,CAAC,UAAU;YAAE,UAAU,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,gBAAsB,CAAC;IAEvB;;;;;;OAMG;IACI,GAAG,CACR,QAAgB,EAChB,UAA0B,EAC1B,IAAmB;QAEnB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACI,IAAI,CACT,QAAgB,EAChB,UAA0B;QAE1B,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,IAAI,CACb,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU,CACvE,IAAI,IAAI,CACV,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,IAAY;QAC7B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;gBACvC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,SAAS,CAAC,IAAY;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;CACF"}

package/dist/common/Directories.d.ts

@@ -1,14 +1,31 @@
 import { DecoFileType, DecoTargetType } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Parameters used by {@link DirectoriesResolver} to identify a target/file type pair.
+ */
 export interface DirectoriesResolverParams {
     targetType: DecoTargetType;
     fileType: DecoFileType;
 }
+/**
+ * Resolves an import path between two target/file type pairs.
+ *
+ * @param imp - The import target parameters (e.g. `common/doc`).
+ * @param current - The current file's parameters used as the resolution base.
+ * @returns The resolved import path string.
+ */
 export type DirectoriesResolver = (imp: DirectoriesResolverParams, // e.g ${TargetType}/${DecoFileType} --> common/doc,
 current: DirectoriesResolverParams) => string;
+/**
+ * Configuration parameters for the directories manager.
+ */
 export interface DirectoriesParams {
+    /** Current working directory used as the base for resolving paths. */
     cwd: string;
+    /** Relative path from `cwd` to the templates directory. */
     templatesDir: string;
+    /** Relative path from `cwd` to the code generation target directory. */
     targetDir: string;
+    /** Callback that resolves import paths between target/file type pairs. */
     importResolver: DirectoriesResolver;
 }
 declare class Directories {
@@ -32,6 +49,12 @@ declare class Directories {
     concatResolverPath(params: DirectoriesResolverParams): string;
     protected get params(): DirectoriesParams;
 }
+/**
+ * Singleton instance of the directories manager.
+ *
+ * @remarks
+ * Must be configured via `directories.setup(params)` before use.
+ */
 export declare const directories: Directories;
 export {};
 //# sourceMappingURL=Directories.d.ts.map

package/dist/common/Directories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Directories.d.ts","sourceRoot":"","sources":["../../src/common/Directories.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,cAAc,EAGf,MAAM,2CAA2C,CAAC;AAGnD,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,yBAAyB,EAAE,oDAAoD;AACpF,OAAO,EAAE,yBAAyB,KAC/B,MAAM,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,mBAAmB,CAAC;CACrC;AAQD,cAAM,WAAW;IACf,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAQ;;IAI5C,KAAK,CAAC,MAAM,EAAE,iBAAiB;IAStC,IAAW,YAAY,IAAI,MAAM,CAEhC;IAEM,SAAS,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAI7C,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAIlD,YAAY,CACjB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc;IAKrB,iBAAiB,CAAC,UAAU,EAAE,cAAc;IAItC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5C,aAAa,CAClB,GAAG,EAAE;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,MAAM,EACpE,WAAW,EACP;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,GACtD,MAAM,GACT,MAAM;IASF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB;IAkB1D,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;IAIpE,SAAS,KAAK,MAAM,IAAI,iBAAiB,CAGxC;CACF;AAED,eAAO,MAAM,WAAW,aAAa,CAAC"}
+{"version":3,"file":"Directories.d.ts","sourceRoot":"","sources":["../../src/common/Directories.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,cAAc,EAGf,MAAM,2CAA2C,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,yBAAyB,EAAE,oDAAoD;AACpF,OAAO,EAAE,yBAAyB,KAC/B,MAAM,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,cAAc,EAAE,mBAAmB,CAAC;CACrC;AAQD,cAAM,WAAW;IACf,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAQ;;IAI5C,KAAK,CAAC,MAAM,EAAE,iBAAiB;IAStC,IAAW,YAAY,IAAI,MAAM,CAEhC;IAEM,SAAS,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAI7C,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAIlD,YAAY,CACjB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc;IAKrB,iBAAiB,CAAC,UAAU,EAAE,cAAc;IAItC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5C,aAAa,CAClB,GAAG,EAAE;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,MAAM,EACpE,WAAW,EACP;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,GACtD,MAAM,GACT,MAAM;IASF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB;IAkB1D,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;IAIpE,SAAS,KAAK,MAAM,IAAI,iBAAiB,CAGxC;CACF;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC"}

package/dist/common/Directories.js

@@ -66,5 +66,11 @@ class Directories {
         return this._params;
     }
 }
+/**
+ * Singleton instance of the directories manager.
+ *
+ * @remarks
+ * Must be configured via `directories.setup(params)` before use.
+ */
 export const directories = instance();
 //# sourceMappingURL=Directories.js.map

package/dist/common/Directories.js.map

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

package/dist/common/Extractor.d.ts

@@ -1,10 +1,36 @@
 import { DecoFile } from "@mxpicture/gcp-functions-common/types";
+/**
+ * Creates {@link Extractor} instances for the given template file paths.
+ *
+ * @param filePaths - Absolute paths to template files.
+ * @returns A promise resolving to an array of extractors.
+ */
 export declare const createExtractors: (filePaths: string[]) => Promise<Extractor[]>;
+/**
+ * Creates extractors for the given file paths and runs them all.
+ *
+ * @param filePaths - Absolute paths to template files.
+ * @returns A promise resolving to the extracted decorator files.
+ */
 export declare const runExtractors: (filePaths: string[]) => Promise<DecoFile[]>;
+/**
+ * Dynamically imports a template file and extracts its {@link Decorator} instances.
+ */
 export declare class Extractor {
     readonly filePath: string;
     readonly rootDir: string;
+    /**
+     * Creates a new extractor.
+     *
+     * @param filePath - Absolute path to the template file.
+     * @param rootDir - Workspace root directory used to compute relative paths.
+     */
     constructor(filePath: string, rootDir: string);
+    /**
+     * Imports the template file and extracts all {@link Decorator} exports.
+     *
+     * @returns A {@link DecoFile} containing the template path and its decorators.
+     */
     run(): Promise<DecoFile>;
 }
 //# sourceMappingURL=Extractor.d.ts.map

package/dist/common/Extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Extractor.d.ts","sourceRoot":"","sources":["../../src/common/Extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAQjE,eAAO,MAAM,gBAAgB,GAC3B,WAAW,MAAM,EAAE,KAClB,OAAO,CAAC,SAAS,EAAE,CAGrB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EAAE,KAClB,OAAO,CAAC,QAAQ,EAAE,CAGpB,CAAC;AAEF,qBAAa,SAAS;aAEF,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;gBADf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAGpB,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;CAUtC"}
+{"version":3,"file":"Extractor.d.ts","sourceRoot":"","sources":["../../src/common/Extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAKjE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,WAAW,MAAM,EAAE,KAClB,OAAO,CAAC,SAAS,EAAE,CAGrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EAAE,KAClB,OAAO,CAAC,QAAQ,EAAE,CAGpB,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;aAQF,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;IARjC;;;;;OAKG;gBAEe,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAGjC;;;;OAIG;IACU,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;CAUtC"}

package/dist/common/Extractor.js

@@ -1,23 +1,47 @@
-import { dirname, relative } from "node:path";
+import { relative } from "node:path";
 import { findWorkspaceRoot } from "@mxpicture/build-api/workspace";
-import { fileURLToPath } from "node:url";
 import { Decorator } from "@mxpicture/gcp-functions-common/decorator";
-const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Creates {@link Extractor} instances for the given template file paths.
+ *
+ * @param filePaths - Absolute paths to template files.
+ * @returns A promise resolving to an array of extractors.
+ */
 export const createExtractors = async (filePaths) => {
-    const rootDir = (await findWorkspaceRoot(__dirname)).dirPath;
+    const rootDir = (await findWorkspaceRoot(import.meta.dirname)).dirPath;
     return filePaths.map((filePath) => new Extractor(filePath, rootDir));
 };
+/**
+ * Creates extractors for the given file paths and runs them all.
+ *
+ * @param filePaths - Absolute paths to template files.
+ * @returns A promise resolving to the extracted decorator files.
+ */
 export const runExtractors = async (filePaths) => {
     const exs = await createExtractors(filePaths);
     return Promise.all(exs.map((ex) => ex.run()));
 };
+/**
+ * Dynamically imports a template file and extracts its {@link Decorator} instances.
+ */
 export class Extractor {
     filePath;
     rootDir;
+    /**
+     * Creates a new extractor.
+     *
+     * @param filePath - Absolute path to the template file.
+     * @param rootDir - Workspace root directory used to compute relative paths.
+     */
     constructor(filePath, rootDir) {
         this.filePath = filePath;
         this.rootDir = rootDir;
     }
+    /**
+     * Imports the template file and extracts all {@link Decorator} exports.
+     *
+     * @returns A {@link DecoFile} containing the template path and its decorators.
+     */
     async run() {
         const imported = await import(this.filePath);
         return {

package/dist/common/Extractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"Extractor.js","sourceRoot":"","sources":["../../src/common/Extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAEtE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,SAAmB,EACG,EAAE;IACxB,MAAM,OAAO,GAAG,CAAC,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAmB,EACE,EAAE;IACvB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,OAAO,SAAS;IAEF;IACA;IAFlB,YACkB,QAAgB,EAChB,OAAe;QADf,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC9B,CAAC;IAEG,KAAK,CAAC,GAAG;QACd,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,QAAQ;YAC/B,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC;YAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CACxC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,YAAY,SAAS,CAC9C;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"Extractor.js","sourceRoot":"","sources":["../../src/common/Extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,SAAmB,EACG,EAAE;IACxB,MAAM,OAAO,GAAG,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAmB,EACE,EAAE;IACvB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,SAAS;IAQF;IACA;IARlB;;;;;OAKG;IACH,YACkB,QAAgB,EAChB,OAAe;QADf,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC9B,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,GAAG;QACd,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,QAAQ;YAC/B,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC;YAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CACxC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,YAAY,SAAS,CAC9C;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/common/file.common.d.ts

@@ -1,10 +1,56 @@
 import { DecoFileExtension, DecoFileType } from "@mxpicture/gcp-functions-common/decorator";
 import { ExtractFileParts } from "./types.common.js";
+/**
+ * Checks whether a filename matches the template file naming convention.
+ *
+ * @param filename - The filename to check.
+ * @returns `true` if the file is a TypeScript template file.
+ */
 export declare const isTemplateFile: (filename: string) => boolean;
+/**
+ * Checks whether a filename is a TypeScript file of the given decorator file type.
+ *
+ * @param filename - The filename to check.
+ * @param type - The expected decorator file type.
+ * @returns `true` if the file matches the type and has a `.ts` extension.
+ */
 export declare const isTsFile: (filename: string, type: DecoFileType) => boolean;
+/**
+ * Checks whether a filename matches an optional type and extension.
+ *
+ * @param filename - The filename to check.
+ * @param type - Optional decorator file type filter.
+ * @param ext - Optional file extension filter.
+ * @returns `true` if the file matches the given filters (or no filter is provided).
+ */
 export declare const isAnyFile: (filename: string, type?: DecoFileType, ext?: DecoFileExtension) => boolean;
+/**
+ * Parses a dot-separated filename into its constituent parts.
+ *
+ * @remarks
+ * Filenames must have at least three dot-separated segments: `{type}.{middle}.{ext}`.
+ *
+ * @param filename - The filename to parse.
+ * @returns The parsed {@link ExtractFileParts}.
+ * @throws Error if the filename has fewer than three dot-separated parts or contains invalid type/extension.
+ */
 export declare const extractFileParts: (filename: string) => ExtractFileParts;
+/**
+ * Concatenates file parts back into a dot-separated filename string.
+ *
+ * @remarks
+ * If `parts.generated` is `true`, a `.gen` segment is inserted before the extension.
+ *
+ * @param parts - The file parts to concatenate.
+ * @returns The reconstructed filename.
+ */
 export declare const concatFileParts: (parts: ExtractFileParts) => string;
+/**
+ * Builds a target filename by replacing the type and optionally the extension of an existing filename.
+ *
+ * @param p - Parameters containing the original filename, desired type, and optional overrides.
+ * @returns The transformed filename string.
+ */
 export declare const toFilename: (p: {
     filename: string;
     type: DecoFileType;

package/dist/common/file.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.common.d.ts","sourceRoot":"","sources":["../../src/common/file.common.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EAGb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,OACP,CAAC;AAE5C,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,MAAM,YAAY,KAAG,OACf,CAAC;AAElD,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,OAAO,YAAY,EACnB,MAAM,iBAAiB,KACtB,OASF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,gBAiBnD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,gBAAgB,KAAG,MAG5C,CAAC;AAEf,eAAO,MAAM,UAAU,GAAI,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB,KAAG,MAMA,CAAC"}
+{"version":3,"file":"file.common.d.ts","sourceRoot":"","sources":["../../src/common/file.common.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EAGb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,OACP,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,MAAM,YAAY,KAAG,OACf,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,OAAO,YAAY,EACnB,MAAM,iBAAiB,KACtB,OASF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,gBAiBnD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,gBAAgB,KAAG,MAG5C,CAAC;AAEf;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB,KAAG,MAMA,CAAC"}