@mxpicture/gcp-functions-generator 1.1.3 → 1.1.4

package/dist/decorator/deco.names.js.map

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

package/dist/generator/Generator.d.ts

@@ -2,13 +2,22 @@ import { DecoFile, DecoImport } from "@mxpicture/gcp-functions-common/types";
 import { DecoFileType, DecoFileExtension, DecoTargetType, DecoNames, Decorator } from "@mxpicture/gcp-functions-common/decorator";
 import { Collector } from "../common/Collector.js";
 import { GeneratorEnv } from "../common/types.common.js";
+/**
+ * Base structure shared by all generator outputs, containing imports and code lines.
+ */
 export interface GeneratorBase {
     imports: DecoImport[];
     code: string[];
 }
+/**
+ * Generator output for a single decorator header, including a name identifier.
+ */
 export interface GeneratorCode extends GeneratorBase {
     name: string;
 }
+/**
+ * Full result file produced by a generator, ready to be written to disk.
+ */
 export interface GeneratorResultFile extends GeneratorBase {
     type: DecoFileType;
     ext: DecoFileExtension;
@@ -17,25 +26,98 @@ export interface GeneratorResultFile extends GeneratorBase {
     targetType: DecoTargetType;
     importsCode: string[];
 }
+/**
+ * Pairs a decorator with its resolved names for processing by a generator.
+ */
 export interface GeneratorRunItem {
     decorator: Decorator;
     names: DecoNames;
 }
+/**
+ * A record of run items keyed by decorator name, providing lookup for cross-references.
+ */
 export type GeneratorRunItems = Record<string, GeneratorRunItem>;
+/**
+ * Converts an array of {@link DecoImport} entries into TypeScript import statement strings.
+ *
+ * @param imports - The imports to convert.
+ * @returns An array of import statement strings (empty imports are filtered out).
+ */
 export declare const importsToCode: (imports: DecoImport[]) => string[];
+/**
+ * Async variant of {@link importsToCode}.
+ *
+ * @param imports - The imports to convert.
+ * @returns A promise resolving to an array of import statement strings.
+ */
 export declare const importsToCodeAsync: (imports: DecoImport[]) => Promise<string[]>;
+/**
+ * Abstract base class for all code generators.
+ *
+ * @remarks
+ * Subclasses implement {@link Generator.runHeader} to produce code for each
+ * decorator header. The base class handles file assembly, import merging,
+ * formatting, and writing to disk.
+ */
 export declare abstract class Generator {
     readonly type: DecoFileType;
     readonly ext: DecoFileExtension;
     readonly targetType: DecoTargetType;
     readonly collector: Collector;
     readonly useAdditionalImports: boolean;
+    /**
+     * Creates a new generator.
+     *
+     * @param type - The decorator file type this generator produces.
+     * @param ext - The output file extension.
+     * @param targetType - The target package (common, backend, frontend).
+     * @param collector - The shared collector for cross-generator lookups.
+     * @param useAdditionalImports - Whether to include additional imports from the decorator.
+     */
     constructor(type: DecoFileType, ext: DecoFileExtension, targetType: DecoTargetType, collector: Collector, useAdditionalImports?: boolean);
+    /**
+     * Processes a decorator file by running all its headers through the generator.
+     *
+     * @param file - The extracted decorator file containing one or more decorators.
+     * @param env - Environment variables for generation context.
+     * @returns A promise resolving to the assembled result file.
+     * @throws Error if no headers are produced for the file.
+     */
     run(file: DecoFile, env: GeneratorEnv): Promise<GeneratorResultFile>;
+    /**
+     * Formats and writes one or more generator result files to disk.
+     *
+     * @param files - The result files to write.
+     */
     static write(...files: GeneratorResultFile[]): Promise<void>;
+    /**
+     * Resolves an import path from the current generator's context to a target type and file type.
+     *
+     * @param targetType - The target type of the import destination.
+     * @param fileType - The file type of the import destination.
+     * @returns The resolved import path string.
+     */
     resolveImport(targetType: DecoTargetType, fileType: DecoFileType): string;
+    /**
+     * Resolves an import path to the common target for the given file type.
+     *
+     * @param fileType - The file type to import from common.
+     * @returns The resolved import path.
+     */
     importCommon(fileType: DecoFileType): string;
+    /**
+     * Resolves an import path to the frontend target for the given file type.
+     *
+     * @param fileType - The file type to import from frontend.
+     * @returns The resolved import path.
+     */
     importFrontend(fileType: DecoFileType): string;
+    /**
+     * Resolves an import path to the backend target for the given file type.
+     *
+     * @param fileType - The file type to import from backend.
+     * @returns The resolved import path.
+     */
     importBackend(fileType: DecoFileType): string;
     protected addCode(res: GeneratorResultFile, code: string[]): void;
     protected addImport(res: GeneratorResultFile, imp: DecoImport): void;

package/dist/generator/Generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Generator.d.ts","sourceRoot":"","sources":["../../src/generator/Generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,SAAS,EACV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,iBAAiB,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAYjE,eAAO,MAAM,aAAa,GAAI,SAAS,UAAU,EAAE,KAAG,MAAM,EACH,CAAC;AAE1D,eAAO,MAAM,kBAAkB,GAC7B,SAAS,UAAU,EAAE,KACpB,OAAO,CAAC,MAAM,EAAE,CAGhB,CAAC;AAEJ,8BAAsB,SAAS;aAEX,IAAI,EAAE,YAAY;aAClB,GAAG,EAAE,iBAAiB;aACtB,UAAU,EAAE,cAAc;aAC1B,SAAS,EAAE,SAAS;aACpB,oBAAoB,EAAE,OAAO;gBAJ7B,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,iBAAiB,EACtB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,SAAS,EACpB,oBAAoB,GAAE,OAAe;IAG1C,GAAG,CACd,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,mBAAmB,CAAC;WAmEX,KAAK,CAAC,GAAG,KAAK,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlE,aAAa,CAClB,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,YAAY,GACrB,MAAM;IAOF,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAI5C,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAG9C,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAIpD,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE;IAK1D,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,UAAU;IAgB7D,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,EAAE;cAIpD,aAAa,CAC3B,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,CAAC,aAAa,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAwB9D,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CACjC"}
+{"version":3,"file":"Generator.d.ts","sourceRoot":"","sources":["../../src/generator/Generator.ts"],"names":[],"mappings":"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"}

package/dist/generator/Generator.js

@@ -9,14 +9,43 @@ const importToCode = (imp) => imp.props.length > 0
     ? `import ${imp.isType ? "type " : ""}{ ${[...imp.props].join(", ")} } from "${imp.path}"`
     : null;
 const importToCodeAsync = async (imp) => Promise.resolve().then(() => importToCode(imp));
+/**
+ * Converts an array of {@link DecoImport} entries into TypeScript import statement strings.
+ *
+ * @param imports - The imports to convert.
+ * @returns An array of import statement strings (empty imports are filtered out).
+ */
 export const importsToCode = (imports) => imports.map(importToCode).filter((imp) => imp !== null);
+/**
+ * Async variant of {@link importsToCode}.
+ *
+ * @param imports - The imports to convert.
+ * @returns A promise resolving to an array of import statement strings.
+ */
 export const importsToCodeAsync = async (imports) => (await Promise.all(imports.map(importToCodeAsync))).filter((imp) => imp !== null);
+/**
+ * Abstract base class for all code generators.
+ *
+ * @remarks
+ * Subclasses implement {@link Generator.runHeader} to produce code for each
+ * decorator header. The base class handles file assembly, import merging,
+ * formatting, and writing to disk.
+ */
 export class Generator {
     type;
     ext;
     targetType;
     collector;
     useAdditionalImports;
+    /**
+     * Creates a new generator.
+     *
+     * @param type - The decorator file type this generator produces.
+     * @param ext - The output file extension.
+     * @param targetType - The target package (common, backend, frontend).
+     * @param collector - The shared collector for cross-generator lookups.
+     * @param useAdditionalImports - Whether to include additional imports from the decorator.
+     */
     constructor(type, ext, targetType, collector, useAdditionalImports = false) {
         this.type = type;
         this.ext = ext;
@@ -24,6 +53,14 @@ export class Generator {
         this.collector = collector;
         this.useAdditionalImports = useAdditionalImports;
     }
+    /**
+     * Processes a decorator file by running all its headers through the generator.
+     *
+     * @param file - The extracted decorator file containing one or more decorators.
+     * @param env - Environment variables for generation context.
+     * @returns A promise resolving to the assembled result file.
+     * @throws Error if no headers are produced for the file.
+     */
     async run(file, env) {
         let result = null;
         const runHeaders = {};
@@ -69,6 +106,11 @@ export class Generator {
         result.importsCode = await importsToCodeAsync(result.imports);
         return result;
     }
+    /**
+     * Formats and writes one or more generator result files to disk.
+     *
+     * @param files - The result files to write.
+     */
     static async write(...files) {
         const promises = [];
         for (const file of files) {
@@ -87,15 +129,40 @@ export class Generator {
         }
         await Promise.all(promises);
     }
+    /**
+     * Resolves an import path from the current generator's context to a target type and file type.
+     *
+     * @param targetType - The target type of the import destination.
+     * @param fileType - The file type of the import destination.
+     * @returns The resolved import path string.
+     */
     resolveImport(targetType, fileType) {
         return directories.resolveImport({ targetType, fileType }, { targetType: this.targetType, fileType: this.type });
     }
+    /**
+     * Resolves an import path to the common target for the given file type.
+     *
+     * @param fileType - The file type to import from common.
+     * @returns The resolved import path.
+     */
     importCommon(fileType) {
         return this.resolveImport(DecoTargetType.common, fileType);
     }
+    /**
+     * Resolves an import path to the frontend target for the given file type.
+     *
+     * @param fileType - The file type to import from frontend.
+     * @returns The resolved import path.
+     */
     importFrontend(fileType) {
         return this.resolveImport(DecoTargetType.frontend, fileType);
     }
+    /**
+     * Resolves an import path to the backend target for the given file type.
+     *
+     * @param fileType - The file type to import from backend.
+     * @returns The resolved import path.
+     */
     importBackend(fileType) {
         return this.resolveImport(DecoTargetType.backend, fileType);
     }

package/dist/generator/Generator.js.map

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

package/dist/generator/GeneratorAnnotations.d.ts

@@ -1,4 +1,11 @@
 import { Generator, GeneratorCode, GeneratorRunItem } from "./Generator.js";
+/**
+ * Generator that produces annotation metadata and initial-value factory functions.
+ *
+ * @remarks
+ * Outputs TypeScript code referencing `AnnotationsHeader` and replaces
+ * JSON enum/type string literals with their actual enum references.
+ */
 export declare class GeneratorAnnotations extends Generator {
     constructor();
     protected runHeader(current: GeneratorRunItem): Promise<GeneratorCode | null>;

package/dist/generator/GeneratorAnnotations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorAnnotations.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorAnnotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAgB5E,qBAAa,oBAAqB,SAAQ,SAAS;;cAUxB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAgHjC;;AAED,wBAA0C"}
+{"version":3,"file":"GeneratorAnnotations.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorAnnotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAgB5E;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;;cAUxB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAgHjC;;AAED,wBAA0C"}

package/dist/generator/GeneratorAnnotations.js

@@ -7,6 +7,13 @@ const itemTypeRegex = /\"itemType\": \"(DecoPropertyType\.|)([a-zA-Z][a-zA-Z0-9]
 const propertyRefRegex = /\"propertyRef\": \"([a-zA-Z][a-zA-Z0-9]*)\"/;
 const subHeaderNameRegex = /\"subHeaderName\": \"([a-zA-Z][a-zA-Z0-9]*)\"/;
 const dateFormatRegex = /\"dateFormat\": \"([a-zA-Z][a-zA-Z0-9]*)\"/;
+/**
+ * Generator that produces annotation metadata and initial-value factory functions.
+ *
+ * @remarks
+ * Outputs TypeScript code referencing `AnnotationsHeader` and replaces
+ * JSON enum/type string literals with their actual enum references.
+ */
 export class GeneratorAnnotations extends Generator {
     constructor() {
         super(DecoFileType.annotations, DecoFileExtension.ts, DecoTargetType.common, Collector.instance());

package/dist/generator/GeneratorAnnotations.js.map

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

package/dist/generator/GeneratorBackend.d.ts

@@ -2,6 +2,13 @@ import { DecoNames } from "@mxpicture/gcp-functions-common/decorator";
 import { Generator, GeneratorCode, GeneratorRunItem, GeneratorRunItems } from "./Generator.js";
 import { GeneratorEnv } from "../common/types.common.js";
 import { DecoRoutes } from "@mxpicture/gcp-functions-common/types";
+/**
+ * Generator that produces backend-specific code including API classes, stores, functions, and factory helpers.
+ *
+ * @remarks
+ * Targets the `backend` package and generates classes extending `BackendApi`,
+ * `IBackendFunction`, `Store`, and a `create*Function` factory.
+ */
 export declare class GeneratorBackend extends Generator {
     constructor();
     protected runHeader(current: GeneratorRunItem, all: GeneratorRunItems, env: GeneratorEnv): Promise<GeneratorCode | null>;

package/dist/generator/GeneratorBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBackend.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,SAAS,EACV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGnE,qBAAa,gBAAiB,SAAQ,SAAS;;cAUpB,SAAS,CAChC,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAwFhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IA6BlE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAexE,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAQnE,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,MAAM,EAAE;CAiBZ;;AAED,wBAAsC"}
+{"version":3,"file":"GeneratorBackend.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,SAAS,EACV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGnE;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;;cAUpB,SAAS,CAChC,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAwFhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IA6BlE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAexE,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAQnE,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,MAAM,EAAE;CAiBZ;;AAED,wBAAsC"}

package/dist/generator/GeneratorBackend.js

@@ -2,6 +2,13 @@ import { hasCrudRoute, isCrudRoute, DecoFileExtension, DecoFileType, DecoPropert
 import { Generator, } from "./Generator.js";
 import { Collector } from "../common/Collector.js";
 import { extractAnnotationsPaths } from "@mxpicture/gcp-functions-common/annotation";
+/**
+ * Generator that produces backend-specific code including API classes, stores, functions, and factory helpers.
+ *
+ * @remarks
+ * Targets the `backend` package and generates classes extending `BackendApi`,
+ * `IBackendFunction`, `Store`, and a `create*Function` factory.
+ */
 export class GeneratorBackend extends Generator {
     constructor() {
         super(DecoFileType.backend, DecoFileExtension.ts, DecoTargetType.backend, Collector.instance());

package/dist/generator/GeneratorBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBackend.js","sourceRoot":"","sources":["../../src/generator/GeneratorBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GAEf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,SAAS,GAIV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C;QACE,KAAK,CACH,YAAY,CAAC,OAAO,EACpB,iBAAiB,CAAC,EAAE,EACpB,cAAc,CAAC,OAAO,EACtB,SAAS,CAAC,QAAQ,EAAE,CACrB,CAAC;IACJ,CAAC;IAEkB,KAAK,CAAC,SAAS,CAChC,OAAyB,EACzB,GAAsB,EACtB,GAAiB;QAEjB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,uBAAuB,CACvC,MAAM,CAAC,UAAU,EACjB,gBAAgB,CAAC,IAAI,CACtB,CAAC;QAEF,OAAO;YACL,IAAI,EAAE;gBACJ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;gBACvC,EAAE;gBACF,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;gBACnC,EAAE;gBACF,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC;gBACpC,EAAE;gBACF,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC;aAC3D;YACD,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,uCAAuC;oBAC7C,KAAK,EAAE;wBACL,eAAe;wBACf,iBAAiB;wBACjB,kBAAkB;wBAClB,cAAc;qBACf;oBACD,MAAM,EAAE,IAAI;iBACb;gBACD;oBACE,IAAI,EAAE,wCAAwC;oBAC9C,KAAK,EAAE,CAAC,OAAO,CAAC;oBAChB,MAAM,EAAE,KAAK;iBACd;gBACD;oBACE,IAAI,EAAE,6CAA6C;oBACnD,KAAK,EAAE,CAAC,YAAY,CAAC;oBACrB,MAAM,EAAE,KAAK;iBACd;gBACD;oBACE,IAAI,EAAE,sCAAsC;oBAC5C,KAAK,EAAE,CAAC,YAAY,CAAC;oBACrB,MAAM,EAAE,KAAK;iBACd;gBACD;oBACE,IAAI,EAAE,0BAA0B;oBAChC,KAAK,EAAE,CAAC,wBAAwB,CAAC;oBACjC,MAAM,EAAE,IAAI;iBACb;gBACD;oBACE,IAAI,EAAE,6BAA6B;oBACnC,KAAK,EAAE,CAAC,kBAAkB,CAAC;oBAC3B,MAAM,EAAE,IAAI;iBACb;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC;oBAC5C,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;oBACrB,MAAM,EAAE,IAAI;iBACb;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC;oBACzC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;oBAClB,MAAM,EAAE,IAAI;iBACb;gBACD;oBACE,IAAI,EAAE,2CAA2C;oBACjD,KAAK,EAAE,CAAC,kBAAkB,CAAC;oBAC3B,MAAM,EAAE,KAAK;iBACd;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC;oBAC5C,KAAK,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;oBACzB,MAAM,EAAE,KAAK;iBACd;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC;oBAC1C,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;oBACpB,MAAM,EAAE,KAAK;iBACd;aACF;YACD,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;IACJ,CAAC;IAES,QAAQ,CAAC,MAAkB,EAAE,KAAgB;QACrD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtD,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,aAAa,CAAC;QAElB,IAAI,CAAC,IAAI,CACP,0BAA0B,KAAK,CAAC,GAAG,YAAY,cAAc,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,gBAAgB,KAAK,CAAC,GAAG,IAAI,EACvH,4BAA4B,KAAK,CAAC,MAAM,GAAG,EAC3C,GAAG,EACH,mCAAmC,KAAK,CAAC,aAAa,OAAO,EAC7D,EAAE,CACH,CAAC;QAEF,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,IAAI,WAAW,CAAC,SAAS,CAAC;gBAAE,SAAS,CAAC,0CAA0C;YAEhF,IAAI,UAAU,GAAG,SAAS,CAAC;YAC3B,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM;gBACjE,UAAU,IAAI,aAAa,KAAK,CAAC,MAAM,KAAK,SAAS,gBAAgB,CAAC;;gBACnE,UAAU,IAAI,IAAI,CAAC;YACxB,UAAU,IAAI,aAAa,KAAK,CAAC,MAAM,KAAK,SAAS,iBAAiB,CAAC;YAEvE,IAAI,CAAC,IAAI,CAAC,qBAAqB,UAAU,GAAG,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAES,aAAa,CAAC,KAAgB,EAAE,SAAmB;QAC3D,OAAO;YACL,SAAS,KAAK,CAAC,aAAa,yBAAyB;YACrD,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,QAAQ,IAAI,CAAC;YAChD,IAAI;YACJ,EAAE;YACF,gBAAgB,KAAK,CAAC,IAAI,6BAA6B,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,KAAK;YACpF,uEAAuE,KAAK,CAAC,GAAG,cAAc,KAAK,CAAC,YAAY,8BAA8B,KAAK,CAAC,aAAa,8BAA8B,KAAK,CAAC,UAAU,iCAAiC;YAChP,EAAE;YACF,0CAA0C;YAC1C,kKAAkK;YAClK,GAAG;SACJ,CAAC;IACJ,CAAC;IAES,UAAU,CAAC,KAAgB,EAAE,SAAiB;QACtD,OAAO;YACL,gBAAgB,KAAK,CAAC,KAAK,kBAAkB,KAAK,CAAC,GAAG,KAAK;YAC3D,2DAA2D,KAAK,CAAC,GAAG,eAAe,KAAK,CAAC,aAAa,OAAO,SAAS,kBAAkB;YACxI,GAAG;SACJ,CAAC;IACJ,CAAC;IAES,WAAW,CACnB,KAAgB,EAChB,MAAc,EACd,cAAsB;QAEtB,OAAO;YACL,sBAAsB,KAAK,CAAC,QAAQ,qBAAqB,KAAK,CAAC,GAAG,+FAA+F;YACjK,uBAAuB,KAAK,CAAC,KAAK,KAAK;YACvC,EAAE;YACF,gCAAgC,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,aAAa,KAAK;YACvE,kBAAkB,KAAK,CAAC,KAAK,IAAI;YACjC,EAAE;YACF,sBAAsB,KAAK,CAAC,IAAI,KAAK,MAAM,OAAO,cAAc,UAAU;YAC1E,EAAE;YACF,wBAAwB;YACxB,2BAA2B;YAC3B,EAAE;YACF,gCAAgC;YAChC,IAAI;SACL,CAAC;IACJ,CAAC;CACF;AAED,eAAe,IAAI,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"GeneratorBackend.js","sourceRoot":"","sources":["../../src/generator/GeneratorBackend.ts"],"names":[],"mappings":"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"}

package/dist/generator/GeneratorDoc.d.ts

@@ -1,4 +1,10 @@
 import { Generator, GeneratorCode, GeneratorRunItem } from "./Generator.js";
+/**
+ * Generator that produces TypeScript document interfaces from decorator property definitions.
+ *
+ * @remarks
+ * Targets the `common` package and outputs an `interface *Doc` for each decorator header.
+ */
 export declare class GeneratorDoc extends Generator {
     constructor();
     protected runHeader(current: GeneratorRunItem): Promise<GeneratorCode | null>;

package/dist/generator/GeneratorDoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorDoc.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorDoc.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmB5E,qBAAa,YAAa,SAAQ,SAAS;;cAUhB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAoBjC;;AAED,wBAAkC"}
+{"version":3,"file":"GeneratorDoc.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorDoc.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmB5E;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,SAAS;;cAUhB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAoBjC;;AAED,wBAAkC"}

package/dist/generator/GeneratorDoc.js

@@ -15,6 +15,12 @@ const decoTypeToTs = (data) => {
             return data.type;
     }
 };
+/**
+ * Generator that produces TypeScript document interfaces from decorator property definitions.
+ *
+ * @remarks
+ * Targets the `common` package and outputs an `interface *Doc` for each decorator header.
+ */
 export class GeneratorDoc extends Generator {
     constructor() {
         super(DecoFileType.doc, DecoFileExtension.ts, DecoTargetType.common, Collector.instance());

package/dist/generator/GeneratorDoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorDoc.js","sourceRoot":"","sources":["../../src/generator/GeneratorDoc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAmC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAU,EAAE;IACtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,gBAAgB,CAAC,IAAI;YACxB,OAAO,MAAM,CAAC;QAChB,KAAK,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI;gBAC7D,OAAO,GAAI,IAAyB,CAAC,IAAI,KAAK,CAAC;YACjD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD;YACE,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC;QACE,KAAK,CACH,YAAY,CAAC,GAAG,EAChB,iBAAiB,CAAC,EAAE,EACpB,cAAc,CAAC,MAAM,EACrB,SAAS,CAAC,QAAQ,EAAE,CACrB,CAAC;IACJ,CAAC;IAEkB,KAAK,CAAC,SAAS,CAChC,OAAyB;QAEzB,MAAM,GAAG,GAAkB;YACzB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;SAC7B,CAAC;QAEF,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAE3C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,CACX,KAAK,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,eAAe,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"GeneratorDoc.js","sourceRoot":"","sources":["../../src/generator/GeneratorDoc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAmC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAU,EAAE;IACtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,gBAAgB,CAAC,IAAI;YACxB,OAAO,MAAM,CAAC;QAChB,KAAK,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI;gBAC7D,OAAO,GAAI,IAAyB,CAAC,IAAI,KAAK,CAAC;YACjD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD;YACE,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC;QACE,KAAK,CACH,YAAY,CAAC,GAAG,EAChB,iBAAiB,CAAC,EAAE,EACpB,cAAc,CAAC,MAAM,EACrB,SAAS,CAAC,QAAQ,EAAE,CACrB,CAAC;IACJ,CAAC;IAEkB,KAAK,CAAC,SAAS,CAChC,OAAyB;QAEzB,MAAM,GAAG,GAAkB;YACzB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;SAC7B,CAAC;QAEF,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAE3C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,CACX,KAAK,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,eAAe,IAAI,YAAY,EAAE,CAAC"}

package/dist/generator/GeneratorFrontend.d.ts

@@ -1,6 +1,13 @@
 import { Generator, GeneratorCode, GeneratorRunItem } from "./Generator.js";
 import { DecoNames } from "@mxpicture/gcp-functions-common/decorator";
 import { DecoRoutes } from "@mxpicture/gcp-functions-common/types";
+/**
+ * Generator that produces frontend-specific code including API classes, functions, and factory helpers.
+ *
+ * @remarks
+ * Targets the `frontend` package and generates classes extending `FrontendApi`
+ * and `IFrontendFunction`, plus a `create*Api` factory and singleton instance.
+ */
 export declare class GeneratorFrontend extends Generator {
     constructor();
     protected runHeader(current: GeneratorRunItem): Promise<GeneratorCode | null>;

package/dist/generator/GeneratorFrontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorFrontend.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorFrontend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAGL,SAAS,EAKV,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE,qBAAa,iBAAkB,SAAQ,SAAS;;cAUrB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4DhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAqClE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAexE,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;CAWlD;;AAED,wBAAuC"}
+{"version":3,"file":"GeneratorFrontend.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorFrontend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAGL,SAAS,EAKV,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;;cAUrB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4DhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAqClE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAexE,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;CAWlD;;AAED,wBAAuC"}

package/dist/generator/GeneratorFrontend.js

@@ -2,6 +2,13 @@ import { Generator } from "./Generator.js";
 import { Collector } from "../common/Collector.js";
 import { DecoFileExtension, DecoFileType, DecoPropertyType, DecoTargetType, hasCrudRoute, isCrudRoute, } from "@mxpicture/gcp-functions-common/decorator";
 import { extractAnnotationsPaths } from "@mxpicture/gcp-functions-common/annotation";
+/**
+ * Generator that produces frontend-specific code including API classes, functions, and factory helpers.
+ *
+ * @remarks
+ * Targets the `frontend` package and generates classes extending `FrontendApi`
+ * and `IFrontendFunction`, plus a `create*Api` factory and singleton instance.
+ */
 export class GeneratorFrontend extends Generator {
     constructor() {
         super(DecoFileType.frontend, DecoFileExtension.ts, DecoTargetType.frontend, Collector.instance());

package/dist/generator/GeneratorFrontend.js.map

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

package/dist/generator/GeneratorRoutes.d.ts

@@ -1,5 +1,13 @@
 import { Generator, GeneratorCode, GeneratorRunItem } from "./Generator.js";
 import { DecoNames, DecoratorData } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Generator that produces route type definitions and route-name enums.
+ *
+ * @remarks
+ * Targets the `common` package and outputs a `type *Routes` mapped type
+ * and an `enum *RoutesName` for each decorator with routes.
+ * Uses additional imports from the decorator when available.
+ */
 export declare class GeneratorRoutes extends Generator {
     constructor();
     protected runHeader(current: GeneratorRunItem): Promise<GeneratorCode | null>;

package/dist/generator/GeneratorRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorRoutes.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAGL,SAAS,EACT,aAAa,EAEd,MAAM,2CAA2C,CAAC;AAEnD,qBAAa,eAAgB,SAAQ,SAAS;;cAWnB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAmChC,SAAS,CAAC,SAAS,CACjB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,aAAa;IAYzB,SAAS,CAAC,SAAS,CACjB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,aAAa;CAS1B;;AAED,wBAAqC"}
+{"version":3,"file":"GeneratorRoutes.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAGL,SAAS,EACT,aAAa,EAEd,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,SAAS;;cAWnB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAmChC,SAAS,CAAC,SAAS,CACjB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,aAAa;IAYzB,SAAS,CAAC,SAAS,CACjB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,aAAa;CAS1B;;AAED,wBAAqC"}

package/dist/generator/GeneratorRoutes.js

@@ -1,6 +1,14 @@
 import { Generator } from "./Generator.js";
 import { Collector } from "../common/Collector.js";
 import { DecoFileExtension, DecoFileType, DecoTargetType, } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Generator that produces route type definitions and route-name enums.
+ *
+ * @remarks
+ * Targets the `common` package and outputs a `type *Routes` mapped type
+ * and an `enum *RoutesName` for each decorator with routes.
+ * Uses additional imports from the decorator when available.
+ */
 export class GeneratorRoutes extends Generator {
     constructor() {
         super(DecoFileType.routes, DecoFileExtension.ts, DecoTargetType.common, Collector.instance(), true);

package/dist/generator/GeneratorRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorRoutes.js","sourceRoot":"","sources":["../../src/generator/GeneratorRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,YAAY,EAGZ,cAAc,GACf,MAAM,2CAA2C,CAAC;AAEnD,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;QACE,KAAK,CACH,YAAY,CAAC,MAAM,EACnB,iBAAiB,CAAC,EAAE,EACpB,cAAc,CAAC,MAAM,EACrB,SAAS,CAAC,QAAQ,EAAE,EACpB,IAAI,CACL,CAAC;IACJ,CAAC;IAEkB,KAAK,CAAC,SAAS,CAChC,OAAyB;QAEzB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,MAAM,GAAG,GAAkB;YACzB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,uCAAuC;oBAC7C,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE;wBACL,WAAW;wBACX,aAAa;wBACb,UAAU;wBACV,SAAS;wBACT,YAAY;wBACZ,YAAY;qBACb;iBACF;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC;oBACzC,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;iBACnB;aACF;YACD,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAES,SAAS,CACjB,GAAkB,EAClB,KAAgB,EAChB,QAAuB;QAEvB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAE7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,IAAI,CACX,KAAK,SAAS,cAAc,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,YAAY,IAAI,CAC3E,CAAC;QACJ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAES,SAAS,CACjB,GAAkB,EAClB,KAAgB,EAChB,QAAuB;QAEvB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAE7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACnD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,OAAO,SAAS,IAAI,CAAC,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF;AAED,eAAe,IAAI,eAAe,EAAE,CAAC"}
+{"version":3,"file":"GeneratorRoutes.js","sourceRoot":"","sources":["../../src/generator/GeneratorRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,YAAY,EAGZ,cAAc,GACf,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C;QACE,KAAK,CACH,YAAY,CAAC,MAAM,EACnB,iBAAiB,CAAC,EAAE,EACpB,cAAc,CAAC,MAAM,EACrB,SAAS,CAAC,QAAQ,EAAE,EACpB,IAAI,CACL,CAAC;IACJ,CAAC;IAEkB,KAAK,CAAC,SAAS,CAChC,OAAyB;QAEzB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,MAAM,GAAG,GAAkB;YACzB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,uCAAuC;oBAC7C,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE;wBACL,WAAW;wBACX,aAAa;wBACb,UAAU;wBACV,SAAS;wBACT,YAAY;wBACZ,YAAY;qBACb;iBACF;gBACD;oBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC;oBACzC,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;iBACnB;aACF;YACD,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAES,SAAS,CACjB,GAAkB,EAClB,KAAgB,EAChB,QAAuB;QAEvB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAE7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,IAAI,CACX,KAAK,SAAS,cAAc,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,YAAY,IAAI,CAC3E,CAAC;QACJ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAES,SAAS,CACjB,GAAkB,EAClB,KAAgB,EAChB,QAAuB;QAEvB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAE7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACnD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,OAAO,SAAS,IAAI,CAAC,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF;AAED,eAAe,IAAI,eAAe,EAAE,CAAC"}

package/dist/generator/GeneratorZod.d.ts

@@ -1,6 +1,14 @@
 import { Generator, GeneratorCode, GeneratorRunItem } from "./Generator.js";
 import { DecoNames } from "@mxpicture/gcp-functions-common/decorator";
 import { AnnotationsProperty, DecoImport, DecoPropertyBase } from "@mxpicture/gcp-functions-common/types";
+/**
+ * Generator that produces Zod validation schemas and shape objects from decorator annotations.
+ *
+ * @remarks
+ * Targets the `backend` package and outputs a `shape` object, a type-validation
+ * constant, and a `schema` built with `z.object(shape)`. Supports number, string,
+ * boolean, date, array, object, and key property types.
+ */
 export declare class GeneratorZod extends Generator {
     protected zImports: Set<string>;
     protected typeValidationCount: number;

package/dist/generator/GeneratorZod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorZod.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorZod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAUL,SAAS,EAEV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAE/C,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAC5C,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAK;;cAWjB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2BhC,SAAS,CAAC,MAAM,IAAI,IAAI;IAIxB,SAAS,CAAC,IAAI,IAAI,UAAU,EAAE;IAY9B,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM;IAKxD,SAAS,CAAC,UAAU,CAClB,UAAU,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,EACnD,KAAK,EAAE,SAAS,GACf,MAAM,EAAE;IAcX,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMzD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMlD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMjD,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC1C,MAAM,GAAG,IAAI;IAchB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAahB,SAAS,CAAC,QAAQ,CAChB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAYhB,SAAS,CAAC,UAAU,CAClB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAchB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAShB,SAAS,CAAC,SAAS,CACjB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,YAAY,CACpB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;CAKjB;;AAED,wBAAkC"}
+{"version":3,"file":"GeneratorZod.d.ts","sourceRoot":"","sources":["../../src/generator/GeneratorZod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAUL,SAAS,EAEV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAC5C,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAK;;cAWjB,SAAS,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2BhC,SAAS,CAAC,MAAM,IAAI,IAAI;IAIxB,SAAS,CAAC,IAAI,IAAI,UAAU,EAAE;IAY9B,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM;IAKxD,SAAS,CAAC,UAAU,CAClB,UAAU,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,EACnD,KAAK,EAAE,SAAS,GACf,MAAM,EAAE;IAcX,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMzD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMlD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAMjD,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC1C,MAAM,GAAG,IAAI;IAchB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAahB,SAAS,CAAC,QAAQ,CAChB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAYhB,SAAS,CAAC,UAAU,CAClB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAchB,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAShB,SAAS,CAAC,SAAS,CACjB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;IAMhB,SAAS,CAAC,YAAY,CACpB,KAAK,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAC3C,MAAM,GAAG,IAAI;CAKjB;;AAED,wBAAkC"}

package/dist/generator/GeneratorZod.js

@@ -1,6 +1,14 @@
 import { Generator } from "./Generator.js";
 import { Collector } from "../common/Collector.js";
 import { castDecoArray, castDecoBoolean, castDecoDate, castDecoKey, castDecoNumber, castDecoObject, castDecoString, DecoFileExtension, DecoFileType, DecoTargetType, } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Generator that produces Zod validation schemas and shape objects from decorator annotations.
+ *
+ * @remarks
+ * Targets the `backend` package and outputs a `shape` object, a type-validation
+ * constant, and a `schema` built with `z.object(shape)`. Supports number, string,
+ * boolean, date, array, object, and key property types.
+ */
 export class GeneratorZod extends Generator {
     zImports = new Set();
     typeValidationCount = 0;