@mxpicture/gcp-functions-generator 2.1.34 → 2.1.36

package/dist/run/GeneratorBaseFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBaseFile.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorBaseFile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,8BAAsB,iBAAkB,SAAQ,oBAAoB;aAIhD,QAAQ,EAAE,MAAM;IACzB,MAAM,EAAE,kBAAkB;IAJnC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAGV,QAAQ,EAAE,MAAM,EACzB,MAAM,EAAE,kBAAkB;IAMnB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;aAEe,YAAY,IAAI,MAAM,EAAE;aACxB,cAAc,IAAI,MAAM,EAAE;aAC1B,UAAU,IAAI,IAAI;aAElB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAE3C,OAAO,IAAI,MAAM;IAIF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cAgB9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAI1C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}
+{"version":3,"file":"GeneratorBaseFile.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorBaseFile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;GAOG;AACH,8BAAsB,iBAAkB,SAAQ,oBAAoB;aAIhD,QAAQ,EAAE,MAAM;IACzB,MAAM,EAAE,kBAAkB;IAJnC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAGV,QAAQ,EAAE,MAAM,EACzB,MAAM,EAAE,kBAAkB;IAMnB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;aAEe,YAAY,IAAI,MAAM,EAAE;aACxB,cAAc,IAAI,MAAM,EAAE;aAC1B,UAAU,IAAI,IAAI;aAElB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAE3C,OAAO,IAAI,MAAM;IAIF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cAgB9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAI1C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}

package/dist/run/GeneratorBaseFile.js

@@ -3,6 +3,14 @@ import { writeFile } from "node:fs/promises";
 import { DecoFileExtension } from "@mxpicture/gcp-functions-common/decorator";
 import { formatCode, formatJson } from "@mxpicture/build-api/code";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
+/**
+ * Common base for files emitted by the generator.
+ *
+ * @remarks
+ * Holds the file's basename, exposes virtual and real paths via the parent
+ * directory, and provides `persist()` which formats `.ts` / `.json` output
+ * before writing.
+ */
 export class GeneratorBaseFile extends GeneratorBasePersist {
     filename;
     parent;

package/dist/run/GeneratorBaseFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBaseFile.js","sourceRoot":"","sources":["../../src/run/GeneratorBaseFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,MAAM,OAAgB,iBAAkB,SAAQ,oBAAoB;IAIhD;IACT;IAJO,GAAG,CAAS;IAE5B,YACkB,QAAgB,EACzB,MAA0B;QAEjC,KAAK,EAAE,CAAC;QAHQ,aAAQ,GAAR,QAAQ,CAAQ;QACzB,WAAM,GAAN,MAAM,CAAoB;QAGjC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEe,QAAQ;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IACe,QAAQ,CAAC,KAA0B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAW,YAAY;QACrB,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAW,eAAe;QACxB,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACjC,CAAC;IAQM,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE1B,IAAI;YACF,IAAI,CAAC,GAAG,KAAK,iBAAiB,CAAC,EAAE;gBAC/B,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAC9B,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,iBAAiB,CAAC,IAAI;oBACnC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;oBAC9B,CAAC,CAAC,IAAI,CAAC;QAEb,MAAM,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE;YACvC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAAY;QACtC,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAAY;QACtC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"GeneratorBaseFile.js","sourceRoot":"","sources":["../../src/run/GeneratorBaseFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;;;;;;GAOG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,oBAAoB;IAIhD;IACT;IAJO,GAAG,CAAS;IAE5B,YACkB,QAAgB,EACzB,MAA0B;QAEjC,KAAK,EAAE,CAAC;QAHQ,aAAQ,GAAR,QAAQ,CAAQ;QACzB,WAAM,GAAN,MAAM,CAAoB;QAGjC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEe,QAAQ;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IACe,QAAQ,CAAC,KAA0B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAW,YAAY;QACrB,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAW,eAAe;QACxB,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACjC,CAAC;IAQM,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE1B,IAAI;YACF,IAAI,CAAC,GAAG,KAAK,iBAAiB,CAAC,EAAE;gBAC/B,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAC9B,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,iBAAiB,CAAC,IAAI;oBACnC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;oBAC9B,CAAC,CAAC,IAAI,CAAC;QAEb,MAAM,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE;YACvC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAAY;QACtC,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAAY;QACtC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/run/GeneratorBasePersist.d.ts

@@ -1,6 +1,16 @@
 import { GeneratorBase } from "./GeneratorBase.js";
+/**
+ * Adds `load` / `persist` lifecycle hooks to {@link GeneratorBase}.
+ *
+ * @remarks
+ * Subclasses implement how they read their state from disk and how they
+ * write generated artefacts back. Both methods return `this` to support
+ * fluent call chains.
+ */
 export declare abstract class GeneratorBasePersist extends GeneratorBase {
+    /** Loads any state required from disk. */
     abstract load(): Promise<this>;
+    /** Writes any generated artefacts to disk. */
     abstract persist(): Promise<this>;
 }
 //# sourceMappingURL=GeneratorBasePersist.d.ts.map

package/dist/run/GeneratorBasePersist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBasePersist.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorBasePersist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,8BAAsB,oBAAqB,SAAQ,aAAa;aAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;aACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CACzC"}
+{"version":3,"file":"GeneratorBasePersist.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorBasePersist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;GAOG;AACH,8BAAsB,oBAAqB,SAAQ,aAAa;IAC9D,0CAA0C;aAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrC,8CAA8C;aAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CACzC"}

package/dist/run/GeneratorBasePersist.js

@@ -1,4 +1,12 @@
 import { GeneratorBase } from "./GeneratorBase.js";
+/**
+ * Adds `load` / `persist` lifecycle hooks to {@link GeneratorBase}.
+ *
+ * @remarks
+ * Subclasses implement how they read their state from disk and how they
+ * write generated artefacts back. Both methods return `this` to support
+ * fluent call chains.
+ */
 export class GeneratorBasePersist extends GeneratorBase {
 }
 //# sourceMappingURL=GeneratorBasePersist.js.map

package/dist/run/GeneratorBasePersist.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorBasePersist.js","sourceRoot":"","sources":["../../src/run/GeneratorBasePersist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAgB,oBAAqB,SAAQ,aAAa;CAG/D"}
+{"version":3,"file":"GeneratorBasePersist.js","sourceRoot":"","sources":["../../src/run/GeneratorBasePersist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,OAAgB,oBAAqB,SAAQ,aAAa;CAK/D"}

package/dist/run/GeneratorCache.d.ts

@@ -1,23 +1,51 @@
 import { type DecoNames, type DecoratorData } from "@mxpicture/gcp-functions-common/decorator";
 import type { DecoRoutes } from "@mxpicture/gcp-functions-common/types";
 import type { GeneratorRunItem } from "../common/types.common.js";
+/** Cached metadata used by frontend code generation. */
 export interface GeneratorCacheEntryFE {
+    /** Frontend-targeted names for this decorator. */
     names: DecoNames;
 }
+/** Cached metadata used by backend code generation. */
 export interface GeneratorCacheEntryBE {
+    /** API super-class chosen based on the decorator's route mix. */
     apiSuperClass: string;
+    /** Whether the generated API class is abstract (has non-CRUD additional routes). */
     isApiAbstract: boolean;
+    /** Whether the factory should extend `IBackendStoreFactory` (vs the plain factory). */
     isStoreFactory: boolean;
+    /** Backend-targeted names for this decorator. */
     names: DecoNames;
 }
+/**
+ * Resolved per-decorator metadata cached across generator runs.
+ *
+ * @remarks
+ * Computed lazily by {@link GeneratorCache.set} from the raw decorator data and
+ * filled in for backend and/or frontend on demand.
+ */
 export interface GeneratorCacheEntry {
+    /** Decorator name. */
     name: string;
+    /** The raw decorator data extracted from the template. */
     raw: DecoratorData;
+    /** Non-CRUD routes that require explicit declaration in generated code. */
     additionalRoutes: DecoRoutes;
+    /** Decorator namespace (`"default"` when none was set). */
     namespace: string;
+    /** Backend-targeted metadata, populated for backend generators. */
     backend?: GeneratorCacheEntryBE;
+    /** Frontend-targeted metadata, populated for frontend generators. */
     frontend?: GeneratorCacheEntryFE;
 }
+/**
+ * Process-local cache of decorator metadata shared across generators.
+ *
+ * @remarks
+ * Reuses derived data (super-class, abstract flag, additional routes, names)
+ * so each generator doesn't recompute it. Access via the {@link cache},
+ * {@link cacheBE}, {@link cacheFE}, and {@link setCache} helpers.
+ */
 export declare class GeneratorCache {
     protected _entries: Map<string, GeneratorCacheEntry>;
     constructor();
@@ -25,12 +53,39 @@ export declare class GeneratorCache {
     get(name: string): GeneratorCacheEntry;
     protected ensureEntry(item: GeneratorRunItem): GeneratorCacheEntry;
 }
+/**
+ * Returns the cached entry for the given decorator name.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry.
+ * @throws Error when no entry has been registered for `name`.
+ */
 export declare const cache: (name: string) => GeneratorCacheEntry;
+/**
+ * Returns the cached entry narrowed to its frontend metadata.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry with non-optional `frontend`.
+ * @throws Error when frontend metadata has not been populated.
+ */
 export declare const cacheFE: (name: string) => GeneratorCacheEntry & {
     frontend: GeneratorCacheEntryFE;
 };
+/**
+ * Returns the cached entry narrowed to its backend metadata.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry with non-optional `backend`.
+ * @throws Error when backend metadata has not been populated.
+ */
 export declare const cacheBE: (name: string) => GeneratorCacheEntry & {
     backend: GeneratorCacheEntryBE;
 };
+/**
+ * Populates or refreshes the cached entry for a run item.
+ *
+ * @param item - The run item to register.
+ * @returns The resulting cache entry.
+ */
 export declare const setCache: (item: GeneratorRunItem) => GeneratorCacheEntry;
 //# sourceMappingURL=GeneratorCache.d.ts.map

package/dist/run/GeneratorCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorCache.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,aAAa,CAAC;IACnB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;;IAI1D,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB;IA6BhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAM7C,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB;CAyBnE;AAID,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,mBAIpC,CAAC;AAEF,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,KACX,mBAAmB,GAAG;IAAE,QAAQ,EAAE,qBAAqB,CAAA;CAKzD,CAAC;AAEF,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,KACX,mBAAmB,GAAG;IAAE,OAAO,EAAE,qBAAqB,CAAA;CAKxD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,gBAAgB,wBAAqB,CAAC"}
+{"version":3,"file":"GeneratorCache.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,aAAa,EAAE,OAAO,CAAC;IACvB,uFAAuF;IACvF,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,EAAE,aAAa,CAAC;IACnB,2EAA2E;IAC3E,gBAAgB,EAAE,UAAU,CAAC;IAC7B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;;IAI1D,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB;IA6BhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAM7C,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB;CAyBnE;AAID;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,mBAIpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,KACX,mBAAmB,GAAG;IAAE,QAAQ,EAAE,qBAAqB,CAAA;CAKzD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,KACX,mBAAmB,GAAG;IAAE,OAAO,EAAE,qBAAqB,CAAA;CAKxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,gBAAgB,wBAAqB,CAAC"}

package/dist/run/GeneratorCache.js

@@ -1,4 +1,12 @@
 import { hasCrudRoute, hasCustomCrudRoute, isCrudRoute, isCustomCrudRoute, } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Process-local cache of decorator metadata shared across generators.
+ *
+ * @remarks
+ * Reuses derived data (super-class, abstract flag, additional routes, names)
+ * so each generator doesn't recompute it. Access via the {@link cache},
+ * {@link cacheBE}, {@link cacheFE}, and {@link setCache} helpers.
+ */
 export class GeneratorCache {
     _entries = new Map();
     constructor() { }
@@ -54,23 +62,50 @@ export class GeneratorCache {
     }
 }
 const _cache = new GeneratorCache();
+/**
+ * Returns the cached entry for the given decorator name.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry.
+ * @throws Error when no entry has been registered for `name`.
+ */
 export const cache = (name) => {
     const entry = _cache.get(name);
     if (!entry)
         throw new Error(`No cache entry available for "${name}"`);
     return entry;
 };
+/**
+ * Returns the cached entry narrowed to its frontend metadata.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry with non-optional `frontend`.
+ * @throws Error when frontend metadata has not been populated.
+ */
 export const cacheFE = (name) => {
     const entry = cache(name);
     if (!entry.frontend)
         throw new Error(`No cache frontend entry available for "${name}"`);
     return entry;
 };
+/**
+ * Returns the cached entry narrowed to its backend metadata.
+ *
+ * @param name - The decorator name to look up.
+ * @returns The cached entry with non-optional `backend`.
+ * @throws Error when backend metadata has not been populated.
+ */
 export const cacheBE = (name) => {
     const entry = cache(name);
     if (!entry.backend)
         throw new Error(`No cache backend entry available for "${name}"`);
     return entry;
 };
+/**
+ * Populates or refreshes the cached entry for a run item.
+ *
+ * @param item - The run item to register.
+ * @returns The resulting cache entry.
+ */
 export const setCache = (item) => _cache.set(item);
 //# sourceMappingURL=GeneratorCache.js.map

package/dist/run/GeneratorCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorCache.js","sourceRoot":"","sources":["../../src/run/GeneratorCache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GeneratorCache.js","sourceRoot":"","sources":["../../src/run/GeneratorCache.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,GAGlB,MAAM,2CAA2C,CAAC;AA4CnD;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACf,QAAQ,GAAqC,IAAI,GAAG,EAAE,CAAC;IAEjE,gBAAsB,CAAC;IAEhB,GAAG,CAAC,IAAsB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAErC,UAAU;QACV,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;gBACxD,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;oBAC9B,CAAC,CAAC,mBAAmB;oBACrB,CAAC,CAAC,iBAAiB,CAAC;YAExB,KAAK,CAAC,OAAO,GAAG;gBACd,aAAa;gBACb,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC7D,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI;gBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,WAAW;QACX,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,CAAC,QAAQ,GAAG;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,GAAG,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,GAAG,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAES,WAAW,CAAC,IAAsB;QAC1C,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAExC,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;aACtD,MAAM,CACL,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CACnE;aACA,MAAM,CAAC,CAAC,GAAe,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACxC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;QAET,KAAK,GAAG;YACN,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG;YACH,gBAAgB;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;SACtC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAuB,EAAE;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,GAAG,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EAC+C,EAAE;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,QAAQ;QACjB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,GAAG,CAAC,CAAC;IACrE,OAAO,KAAkE,CAAC;AAC5E,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EAC8C,EAAE;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO;QAChB,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,GAAG,CAAC,CAAC;IACpE,OAAO,KAAiE,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/dist/run/GeneratorDirectory.d.ts

@@ -4,6 +4,14 @@ import { GeneratorFile } from "./GeneratorFile.js";
 import { GeneratorBarrel } from "./GeneratorBarrel.js";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
 import type { GeneratorBaseDebugs } from "./GeneratorBase.js";
+/**
+ * A package sub-directory grouped by {@link DecoFileType} (e.g. `src/backend`).
+ *
+ * @remarks
+ * Owns the {@link GeneratorFile} instances generated for one file type and
+ * the auto-emitted {@link GeneratorBarrel} (`index.ts`). `persist()` writes
+ * the directory and every file in parallel.
+ */
 export declare class GeneratorDirectory extends GeneratorBasePersist {
     readonly fileType: DecoFileType;
     parent: GeneratorPackage;

package/dist/run/GeneratorDirectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorDirectory.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,qBAAa,kBAAmB,SAAQ,oBAAoB;aAKxC,QAAQ,EAAE,YAAY;IAC/B,MAAM,EAAE,gBAAgB;IALjC,SAAgB,KAAK,EAAE,aAAa,EAAE,CAAM;IAC5C,SAAgB,MAAM,EAAE,eAAe,CAAC;gBAGtB,QAAQ,EAAE,YAAY,EAC/B,MAAM,EAAE,gBAAgB;IAMjB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAEM,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/C"}
+{"version":3,"file":"GeneratorDirectory.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,oBAAoB;aAKxC,QAAQ,EAAE,YAAY;IAC/B,MAAM,EAAE,gBAAgB;IALjC,SAAgB,KAAK,EAAE,aAAa,EAAE,CAAM;IAC5C,SAAgB,MAAM,EAAE,eAAe,CAAC;gBAGtB,QAAQ,EAAE,YAAY,EAC/B,MAAM,EAAE,gBAAgB;IAMjB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAEM,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/C"}

package/dist/run/GeneratorDirectory.js

@@ -2,6 +2,14 @@ import { GeneratorFile } from "./GeneratorFile.js";
 import { GeneratorBarrel } from "./GeneratorBarrel.js";
 import { mkdir } from "node:fs/promises";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
+/**
+ * A package sub-directory grouped by {@link DecoFileType} (e.g. `src/backend`).
+ *
+ * @remarks
+ * Owns the {@link GeneratorFile} instances generated for one file type and
+ * the auto-emitted {@link GeneratorBarrel} (`index.ts`). `persist()` writes
+ * the directory and every file in parallel.
+ */
 export class GeneratorDirectory extends GeneratorBasePersist {
     fileType;
     parent;

package/dist/run/GeneratorDirectory.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorDirectory.js","sourceRoot":"","sources":["../../src/run/GeneratorDirectory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAKxC;IACT;IALO,KAAK,GAAoB,EAAE,CAAC;IAC5B,MAAM,CAAkB;IAExC,YACkB,QAAsB,EAC/B,MAAwB;QAE/B,KAAK,EAAE,CAAC;QAHQ,aAAQ,GAAR,QAAQ,CAAc;QAC/B,WAAM,GAAN,MAAM,CAAkB;QAG/B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEe,QAAQ;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IACe,QAAQ,CAAC,KAA0B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAEM,IAAI,CAAC,QAAgB;QAC1B,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YACrB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"GeneratorDirectory.js","sourceRoot":"","sources":["../../src/run/GeneratorDirectory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAKxC;IACT;IALO,KAAK,GAAoB,EAAE,CAAC;IAC5B,MAAM,CAAkB;IAExC,YACkB,QAAsB,EAC/B,MAAwB;QAE/B,KAAK,EAAE,CAAC;QAHQ,aAAQ,GAAR,QAAQ,CAAc;QAC/B,WAAM,GAAN,MAAM,CAAkB;QAG/B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEe,QAAQ;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IACe,QAAQ,CAAC,KAA0B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAEM,IAAI,CAAC,QAAgB;QAC1B,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YACrB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/run/GeneratorFile.d.ts

@@ -5,7 +5,22 @@ import { GeneratorFileImports } from "./GeneratorFileImports.js";
 import type { FileDiagnostics, IFile } from "@mxpicture/build-api/file";
 import type { ExportNodeFile } from "@mxpicture/build-api/types";
 import type { GeneratorBaseDebugs } from "./GeneratorBase.js";
+/**
+ * Returns a stable string key for a TypeScript diagnostic, used for retry counting.
+ *
+ * @param diag - The diagnostic, or a pre-computed key string.
+ * @returns The diagnostic key.
+ */
 export declare const diagKey: (diag: FileDiagnostics | string) => string;
+/**
+ * A single generated TypeScript file, including its logic code and resolved imports.
+ *
+ * @remarks
+ * Tracks per-diagnostic retry counts so the import-resolution loop bails out
+ * after `maxTries` attempts at fixing the same error. `useResolve` must be
+ * called before the file can be persisted so a {@link GeneratorFileImports}
+ * is available to emit imports.
+ */
 export declare class GeneratorFile extends GeneratorBaseFile implements IFile {
     readonly maxTries: number;
     protected _version: number;

package/dist/run/GeneratorFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorFile.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorFile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,OAAO,GAAI,MAAM,eAAe,GAAG,MAAM,KAAG,MACM,CAAC;AAEhE,qBAAa,aAAc,SAAQ,iBAAkB,YAAW,KAAK;aAWjD,QAAQ,EAAE,MAAM;IAVlC,SAAS,CAAC,QAAQ,SAAK;IAEvB,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACvD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAM;IACpC,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,CAAM;IAC/C,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;gBAGhD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EACV,QAAQ,GAAE,MAAU;IAKtB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAKnD,UAAU,IAAI,IAAI;IAIlB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM;IAIhD,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO;IAIlD,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM;IAU9C,WAAW,IAAI,eAAe,EAAE;IAIhC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,IAAI;IAIpB,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IASzC,IAAW,OAAO,IAAI,oBAAoB,CAIzC;IAEM,OAAO,IAAI,MAAM;IAGjB,WAAW,IAAI,MAAM;IAGrB,UAAU,IAAI,MAAM;IAGpB,cAAc,IAAI,eAAe,EAAE;IAGnC,UAAU,IAAI,MAAM;IAIX,YAAY,IAAI,MAAM,EAAE;IAGxB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlC,UAAU,IAAI,IAAI;IAMZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,SAAS,KAAK,EAAE,6GAEf;IAED,SAAS,CAAC,cAAc,IAAI,cAAc,EAAE;IAQ5C,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;CAepE"}
+{"version":3,"file":"GeneratorFile.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorFile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,eAAe,GAAG,MAAM,KAAG,MACM,CAAC;AAEhE;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,iBAAkB,YAAW,KAAK;aAWjD,QAAQ,EAAE,MAAM;IAVlC,SAAS,CAAC,QAAQ,SAAK;IAEvB,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACvD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAM;IACpC,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,CAAM;IAC/C,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;gBAGhD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EACV,QAAQ,GAAE,MAAU;IAKtB,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAKnD,UAAU,IAAI,IAAI;IAIlB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM;IAIhD,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO;IAIlD,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM;IAU9C,WAAW,IAAI,eAAe,EAAE;IAIhC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,IAAI;IAIpB,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IASzC,IAAW,OAAO,IAAI,oBAAoB,CAIzC;IAEM,OAAO,IAAI,MAAM;IAGjB,WAAW,IAAI,MAAM;IAGrB,UAAU,IAAI,MAAM;IAGpB,cAAc,IAAI,eAAe,EAAE;IAGnC,UAAU,IAAI,MAAM;IAIX,YAAY,IAAI,MAAM,EAAE;IAGxB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlC,UAAU,IAAI,IAAI;IAMZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,SAAS,KAAK,EAAE,6GAEf;IAED,SAAS,CAAC,cAAc,IAAI,cAAc,EAAE;IAQ5C,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;CAepE"}

package/dist/run/GeneratorFile.js

@@ -1,7 +1,22 @@
 import { extractExportsFilesString } from "@mxpicture/build-api/exp";
 import { GeneratorBaseFile } from "./GeneratorBaseFile.js";
 import { GeneratorFileImports } from "./GeneratorFileImports.js";
+/**
+ * Returns a stable string key for a TypeScript diagnostic, used for retry counting.
+ *
+ * @param diag - The diagnostic, or a pre-computed key string.
+ * @returns The diagnostic key.
+ */
 export const diagKey = (diag) => typeof diag === "string" ? diag : diag.messageText.toString();
+/**
+ * A single generated TypeScript file, including its logic code and resolved imports.
+ *
+ * @remarks
+ * Tracks per-diagnostic retry counts so the import-resolution loop bails out
+ * after `maxTries` attempts at fixing the same error. `useResolve` must be
+ * called before the file can be persisted so a {@link GeneratorFileImports}
+ * is available to emit imports.
+ */
 export class GeneratorFile extends GeneratorBaseFile {
     maxTries;
     _version = 0;

package/dist/run/GeneratorFile.js.map

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

package/dist/run/GeneratorFileImports.d.ts

@@ -4,6 +4,15 @@ import type { GeneratorFile } from "./GeneratorFile.js";
 import { type ExportsLookupRef } from "@mxpicture/build-api/exp";
 import { GeneratorBase, type GeneratorBaseDebugs } from "./GeneratorBase.js";
 import { GeneratorFileImportType } from "../common/run.common.js";
+/**
+ * Tracks and resolves the import statements emitted alongside a {@link GeneratorFile}.
+ *
+ * @remarks
+ * Consumes the TypeScript compiler diagnostics attached to the file
+ * (`missingImport`, `valueImportMissing`, `typeImportMissing`, …) and adds
+ * the corresponding entries to the import list. Resolution is driven by the
+ * file's lookup table and the resolver policy passed at construction time.
+ */
 export declare class GeneratorFileImports extends GeneratorBase {
     readonly file: GeneratorFile;
     resolver: DecoResolve;

package/dist/run/GeneratorFileImports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorFileImports.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorFileImports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,qBAAa,oBAAqB,SAAQ,aAAa;aAQnC,IAAI,EAAE,aAAa;IAC5B,QAAQ,EAAE,WAAW;IARvB,OAAO,EAAE,YAAY,EAAE,CAAM;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAM;IAExC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IACpC,SAAS,CAAC,MAAM,EAAE,mBAAmB,CAAM;gBAGzB,IAAI,EAAE,aAAa,EAC5B,QAAQ,EAAE,WAAW;IAKd,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAK1D,IAAW,KAAK,IAAI,UAAU,EAAE,CAE/B;IAED,IAAW,IAAI,IAAI,MAAM,EAAE,CAE1B;IAEM,UAAU,IAAI,OAAO;IAqC5B,SAAS,CAAC,WAAW,CACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,OAAO;CAkEX"}
+{"version":3,"file":"GeneratorFileImports.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorFileImports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;aAQnC,IAAI,EAAE,aAAa;IAC5B,QAAQ,EAAE,WAAW;IARvB,OAAO,EAAE,YAAY,EAAE,CAAM;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAM;IAExC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IACpC,SAAS,CAAC,MAAM,EAAE,mBAAmB,CAAM;gBAGzB,IAAI,EAAE,aAAa,EAC5B,QAAQ,EAAE,WAAW;IAKd,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAK1D,IAAW,KAAK,IAAI,UAAU,EAAE,CAE/B;IAED,IAAW,IAAI,IAAI,MAAM,EAAE,CAE1B;IAEM,UAAU,IAAI,OAAO;IAqC5B,SAAS,CAAC,WAAW,CACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,OAAO;CAkEX"}

package/dist/run/GeneratorFileImports.js

@@ -3,6 +3,15 @@ import { TsErrorCode } from "@mxpicture/build-api/enum";
 import { ExportsContent, splitExportsAlias, } from "@mxpicture/build-api/exp";
 import { GeneratorBase } from "./GeneratorBase.js";
 import { GeneratorFileImportType } from "../common/run.common.js";
+/**
+ * Tracks and resolves the import statements emitted alongside a {@link GeneratorFile}.
+ *
+ * @remarks
+ * Consumes the TypeScript compiler diagnostics attached to the file
+ * (`missingImport`, `valueImportMissing`, `typeImportMissing`, …) and adds
+ * the corresponding entries to the import list. Resolution is driven by the
+ * file's lookup table and the resolver policy passed at construction time.
+ */
 export class GeneratorFileImports extends GeneratorBase {
     file;
     resolver;

package/dist/run/GeneratorFileImports.js.map

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

package/dist/run/GeneratorFs.d.ts

@@ -9,7 +9,24 @@ import type { CacheBackendParams, ExportsLookupParamsItem } from "@mxpicture/bui
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
 import type { GeneratorBaseDebugs } from "./GeneratorBase.js";
 import type { Trace } from "@mxpicture/build-api/trace";
+/**
+ * Callback invoked for every file inspected during a diagnostics pass.
+ *
+ * @param file - The file being inspected.
+ * @param checkIteration - Zero-based iteration index, incremented each pass.
+ */
 export type IssueLogger = (file: GeneratorFile, checkIteration: number) => void;
+/**
+ * Root of the in-memory file tree representing the workspace being generated.
+ *
+ * @remarks
+ * Discovers packages on `load`, owns the cross-package {@link ExportsLookup},
+ * and drives the diagnostics-then-imports retry loop via
+ * {@link runImports} / {@link check4diagnostics}. `persist()` writes every
+ * file in every package to disk in parallel.
+ *
+ * @typeParam H - The {@link IFilesHandler} implementation used to run TypeScript diagnostics.
+ */
 export declare class GeneratorFs<H extends IFilesHandler<GeneratorFile>> extends GeneratorBasePersist {
     readonly rootPath: string;
     readonly handler: H;

package/dist/run/GeneratorFs.d.ts.map

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

package/dist/run/GeneratorFs.js

@@ -4,6 +4,17 @@ import { guardDecoPackageType, guardThrow, } from "@mxpicture/gcp-functions-comm
 import { FileImports } from "@mxpicture/build-api/file";
 import { ExportsLookup } from "@mxpicture/build-api/exp";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
+/**
+ * Root of the in-memory file tree representing the workspace being generated.
+ *
+ * @remarks
+ * Discovers packages on `load`, owns the cross-package {@link ExportsLookup},
+ * and drives the diagnostics-then-imports retry loop via
+ * {@link runImports} / {@link check4diagnostics}. `persist()` writes every
+ * file in every package to disk in parallel.
+ *
+ * @typeParam H - The {@link IFilesHandler} implementation used to run TypeScript diagnostics.
+ */
 export class GeneratorFs extends GeneratorBasePersist {
     rootPath;
     handler;

package/dist/run/GeneratorFs.js.map

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

package/dist/run/GeneratorPackage.d.ts

@@ -7,6 +7,14 @@ import type { GeneratorFile } from "./GeneratorFile.js";
 import type { ExportsFile } from "@mxpicture/build-api/exp";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
 import type { GeneratorBaseDebugs } from "./GeneratorBase.js";
+/**
+ * One workspace package (e.g. `packages/backend`) within the generator's file tree.
+ *
+ * @remarks
+ * Owns the package's `package.json`, its generator-managed source directories,
+ * and the cached `exports.gen.json` lookup of all installed packages.
+ * `persist()` writes every owned directory and updates `package.json` exports.
+ */
 export declare class GeneratorPackage extends GeneratorBasePersist {
     readonly pkgType: DecoPackageType;
     readonly parent: GeneratorFs<IFilesHandler<GeneratorFile>>;

package/dist/run/GeneratorPackage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorPackage.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorPackage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,qBAAa,gBAAiB,SAAQ,oBAAoB;aAOtC,OAAO,EAAE,eAAe;aACxB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAPnE,SAAgB,IAAI,EAAE,kBAAkB,EAAE,CAAM;IAChD,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAQ;IAE3C,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAG5B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAKnD,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,IAAI,IAAI,WAAW,CAI7B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,UAAU,IAAI,cAAc,CAYtC;IAEM,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB;IAStD,IAAW,aAAa,IAAI,UAAU,EAAE,CAEvC;IAEqB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/C"}
+{"version":3,"file":"GeneratorPackage.d.ts","sourceRoot":"","sources":["../../src/run/GeneratorPackage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;aAOtC,OAAO,EAAE,eAAe;aACxB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAPnE,SAAgB,IAAI,EAAE,kBAAkB,EAAE,CAAM;IAChD,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAQ;IAE3C,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAG5B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAKnD,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAGtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI1D,IAAW,IAAI,IAAI,WAAW,CAI7B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,UAAU,IAAI,cAAc,CAYtC;IAEM,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB;IAStD,IAAW,aAAa,IAAI,UAAU,EAAE,CAEvC;IAEqB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/C"}

package/dist/run/GeneratorPackage.js

@@ -4,6 +4,14 @@ import { mkdir } from "node:fs/promises";
 import { getDependenciesItem, packageAPIsArray, runExtractDeps, } from "@mxpicture/build-api/exp";
 import { join } from "node:path";
 import { GeneratorBasePersist } from "./GeneratorBasePersist.js";
+/**
+ * One workspace package (e.g. `packages/backend`) within the generator's file tree.
+ *
+ * @remarks
+ * Owns the package's `package.json`, its generator-managed source directories,
+ * and the cached `exports.gen.json` lookup of all installed packages.
+ * `persist()` writes every owned directory and updates `package.json` exports.
+ */
 export class GeneratorPackage extends GeneratorBasePersist {
     pkgType;
     parent;

package/dist/run/GeneratorPackage.js.map

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