@skmtc/core 0.0.984 → 0.16.2

package/esm/dsl/CodeFileBase.js

@@ -0,0 +1,60 @@
+import { FileBase } from './FileBase.js';
+/**
+ * The base every language's *code* file extends — a {@link FileBase} that
+ * also carries imports. (`JsonFile`, which has no imports, extends
+ * {@link FileBase} directly.)
+ *
+ * The import collection and its merge are **language-neutral**: imports are
+ * held keyed by {@link ImportBase.mergeKey} and collapsed via
+ * {@link ImportBase.merge}, with no language-specific logic. The spike
+ * proved this same `Map` + merge serves TypeScript (per-module grouping,
+ * type-tags) and Go (whole-package imports, discarded symbol lists)
+ * identically — only the *arrangement* of the rendered import section
+ * differs, which is why `toString()` stays abstract and lives on the
+ * language subclass (`TsFile`, `GoFile`).
+ */
+export class CodeFileBase extends FileBase {
+    constructor() {
+        super(...arguments);
+        /** Registered imports, keyed by {@link ImportBase.mergeKey}. */
+        Object.defineProperty(this, "imports", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        /** Registered re-exports, keyed by {@link ReExportBase.mergeKey}. */
+        Object.defineProperty(this, "reExports", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Merge imports in, collapsing any that share a `mergeKey()` with an
+     * existing entry via {@link ImportBase.merge}. Neutral — the engine's
+     * `register` calls this on the abstract base for every language's file.
+     */
+    addImports(incoming) {
+        for (const importEntry of incoming) {
+            const key = importEntry.mergeKey();
+            const existing = this.imports.get(key);
+            this.imports.set(key, existing ? existing.merge(importEntry) : importEntry);
+        }
+    }
+    /**
+     * Merge re-exports in, collapsing any that share a `mergeKey()` with an
+     * existing entry via {@link ReExportBase.merge}. Neutral — the engine's
+     * `register` calls this on the abstract base; a language without
+     * re-exports never receives any (its concise register vocabulary has no
+     * `reExports` field).
+     */
+    addReExports(incoming) {
+        for (const reExportEntry of incoming) {
+            const key = reExportEntry.mergeKey();
+            const existing = this.reExports.get(key);
+            this.reExports.set(key, existing ? existing.merge(reExportEntry) : reExportEntry);
+        }
+    }
+}

package/esm/dsl/ContentSettings.d.ts

@@ -1,4 +1,4 @@
-import type { Identifier } from './Identifier.js';
+import type { IdentifierBase } from './IdentifierBase.js';
 /**
  * Arguments for creating empty ContentSettings without enrichments.
  */
@@ -6,7 +6,14 @@ type EmptyArgs = {
     /** The path where generated content will be exported */
     exportPath: string;
     /** The identifier for the content being generated */
-    identifier: Identifier;
+    identifier: IdentifierBase;
+    /**
+     * The operation variant this content belongs to. Optional on
+     * {@link ContentSettings.empty} — defaults to `'main'` since model
+     * Projections (the primary `empty()` callers) don't participate in
+     * the operation-variant axis.
+     */
+    variant?: string;
 };
 /**
  * Arguments for creating ContentSettings with enrichments.
@@ -15,11 +22,18 @@ type EmptyArgs = {
  */
 type CreateArgs<EnrichmentType = undefined> = {
     /** The identifier for the content being generated */
-    identifier: Identifier;
+    identifier: IdentifierBase;
     /** The path where generated content will be exported */
     exportPath: string;
     /** Custom enrichment data for extending generation */
     enrichments: EnrichmentType;
+    /**
+     * The operation variant this content belongs to. For variants-aware
+     * operation generators this carries the per-call variant name
+     * (`'main'`, `'customer'`, `'line-items'`, …); for variants-unaware
+     * operation generators and for model Projections it is `'main'`.
+     */
+    variant: string;
 };
 /**
  * Configuration settings for content generators in the SKMTC DSL system.
@@ -29,9 +43,9 @@ type CreateArgs<EnrichmentType = undefined> = {
  * identify the content, and any custom enrichment data for extending
  * the generation process.
  *
- * This class is used by both {@link ModelBase} and {@link OperationBase}
- * to configure their generation behavior, providing a consistent interface
- * for generator settings across the system.
+ * This class is used by {@link ModelProjectionBase}, {@link OasOperationProjectionBase}, and
+ * {@link GqlOperationProjectionBase} to configure their generation behavior,
+ * providing a consistent interface for generator settings across the system.
  *
  * ## Key Features
  *
@@ -44,11 +58,12 @@ type CreateArgs<EnrichmentType = undefined> = {
  *
  * @example Basic settings without enrichments
  * ```typescript
- * import { ContentSettings, Identifier } from '@skmtc/core';
+ * import { ContentSettings } from '@skmtc/core';
+ * import { createType } from '@skmtc/lang-typescript';
  *
  * const settings = ContentSettings.empty({
  *   exportPath: './src/generated/models.ts',
- *   identifier: Identifier.createType('UserModels')
+ *   identifier: createType('UserModels')
  * });
  *
  * console.log(settings.exportPath); // './src/generated/models.ts'
@@ -64,7 +79,7 @@ type CreateArgs<EnrichmentType = undefined> = {
  * };
  *
  * const enrichedSettings = new ContentSettings({
- *   identifier: Identifier.createType('ValidatedModels'),
+ *   identifier: createType('ValidatedModels'),
  *   exportPath: './src/models/validated.ts',
  *   enrichments: {
  *     validateRequired: true,
@@ -79,14 +94,14 @@ type CreateArgs<EnrichmentType = undefined> = {
  * }
  * ```
  *
- * @example Using with ModelBase
+ * @example Using with ModelProjectionBase
  * ```typescript
- * class ValidatedModelGenerator extends ModelBase<ValidationEnrichment> {
+ * class ValidatedModelGenerator extends ModelProjectionBase<ValidationEnrichment> {
  *   constructor(args) {
  *     super({
  *       ...args,
  *       settings: new ContentSettings({
- *         identifier: Identifier.createType(args.refName),
+ *         identifier: createType(args.refName),
  *         exportPath: './src/validated-models.ts',
  *         enrichments: {
  *           validateRequired: true,
@@ -116,11 +131,18 @@ type CreateArgs<EnrichmentType = undefined> = {
  */
 export declare class ContentSettings<EnrichmentType = undefined> {
     /** The identifier for the content being generated */
-    identifier: Identifier;
+    identifier: IdentifierBase;
     /** The path where generated content will be exported */
     exportPath: string;
     /** Custom enrichment data for extending generation */
     enrichments: EnrichmentType;
+    /**
+     * Operation variant this content belongs to. Carries the variant name
+     * threaded from the engine's per-operation dispatch through the
+     * Driver into this Projection. `'main'` for variants-unaware
+     * operation generators and for model Projections.
+     */
+    variant: string;
     /**
      * Creates a new ContentSettings instance with enrichments.
      *
@@ -128,20 +150,22 @@ export declare class ContentSettings<EnrichmentType = undefined> {
      * @param args.identifier - The identifier for the content being generated
      * @param args.exportPath - The path where generated content will be exported
      * @param args.enrichments - Custom enrichment data for extending generation
+     * @param args.variant - Operation variant name (`'main'` for variants-unaware Projections)
      *
      * @example
      * ```typescript
      * const settings = new ContentSettings({
-     *   identifier: Identifier.createType('ApiModels'),
+     *   identifier: createType('ApiModels'),
      *   exportPath: './src/api/models.ts',
      *   enrichments: {
      *     includeValidation: true,
      *     format: 'detailed'
-     *   }
+     *   },
+     *   variant: 'main'
      * });
      * ```
      */
-    constructor({ identifier, exportPath, enrichments }: CreateArgs<EnrichmentType>);
+    constructor({ identifier, exportPath, enrichments, variant }: CreateArgs<EnrichmentType>);
     /**
      * Factory method to create ContentSettings without enrichments.
      *
@@ -157,19 +181,19 @@ export declare class ContentSettings<EnrichmentType = undefined> {
      * @example
      * ```typescript
      * const basicSettings = ContentSettings.empty({
-     *   identifier: Identifier.createType('SimpleModels'),
+     *   identifier: createType('SimpleModels'),
      *   exportPath: './src/models.ts'
      * });
      *
      * console.log(basicSettings.enrichments); // undefined
      *
      * // Use in generator
-     * class SimpleGenerator extends ModelBase {
+     * class SimpleGenerator extends ModelProjectionBase {
      *   constructor(args) {
      *     super({
      *       ...args,
      *       settings: ContentSettings.empty({
-     *         identifier: Identifier.createType(args.refName),
+     *         identifier: createType(args.refName),
      *         exportPath: './src/simple-models.ts'
      *       })
      *     });
@@ -177,7 +201,7 @@ export declare class ContentSettings<EnrichmentType = undefined> {
      * }
      * ```
      */
-    static empty({ identifier, exportPath }: EmptyArgs): ContentSettings<undefined>;
+    static empty({ identifier, exportPath, variant }: EmptyArgs): ContentSettings<undefined>;
 }
 export {};
 //# sourceMappingURL=ContentSettings.d.ts.map

package/esm/dsl/ContentSettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentSettings.d.ts","sourceRoot":"","sources":["../../src/dsl/ContentSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,KAAK,SAAS,GAAG;IACf,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,KAAK,UAAU,CAAC,cAAc,GAAG,SAAS,IAAI;IAC5C,qDAAqD;IACrD,UAAU,EAAE,UAAU,CAAA;IACtB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,WAAW,EAAE,cAAc,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,qBAAa,eAAe,CAAC,cAAc,GAAG,SAAS;IACrD,qDAAqD;IACrD,UAAU,EAAE,UAAU,CAAA;IAEtB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAElB,sDAAsD;IACtD,WAAW,EAAE,cAAc,CAAA;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;gBACS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC;IAM/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;CAOhF"}
+{"version":3,"file":"ContentSettings.d.ts","sourceRoot":"","sources":["../../src/dsl/ContentSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzD;;GAEG;AACH,KAAK,SAAS,GAAG;IACf,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,UAAU,EAAE,cAAc,CAAA;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,KAAK,UAAU,CAAC,cAAc,GAAG,SAAS,IAAI;IAC5C,qDAAqD;IACrD,UAAU,EAAE,cAAc,CAAA;IAC1B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,WAAW,EAAE,cAAc,CAAA;IAC3B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,qBAAa,eAAe,CAAC,cAAc,GAAG,SAAS;IACrD,qDAAqD;IACrD,UAAU,EAAE,cAAc,CAAA;IAE1B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAElB,sDAAsD;IACtD,WAAW,EAAE,cAAc,CAAA;IAE3B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC;IAOxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CAAC,KAAK,CAAC,EACX,UAAU,EACV,UAAU,EACV,OAAyB,EAC1B,EAAE,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;CAQ1C"}

package/esm/dsl/ContentSettings.js

@@ -1,3 +1,4 @@
+import { DEFAULT_VARIANT } from '../types/Variant.js';
 /**
  * Configuration settings for content generators in the SKMTC DSL system.
  *
@@ -6,9 +7,9 @@
  * identify the content, and any custom enrichment data for extending
  * the generation process.
  *
- * This class is used by both {@link ModelBase} and {@link OperationBase}
- * to configure their generation behavior, providing a consistent interface
- * for generator settings across the system.
+ * This class is used by {@link ModelProjectionBase}, {@link OasOperationProjectionBase}, and
+ * {@link GqlOperationProjectionBase} to configure their generation behavior,
+ * providing a consistent interface for generator settings across the system.
  *
  * ## Key Features
  *
@@ -21,11 +22,12 @@
  *
  * @example Basic settings without enrichments
  * ```typescript
- * import { ContentSettings, Identifier } from '@skmtc/core';
+ * import { ContentSettings } from '@skmtc/core';
+ * import { createType } from '@skmtc/lang-typescript';
  *
  * const settings = ContentSettings.empty({
  *   exportPath: './src/generated/models.ts',
- *   identifier: Identifier.createType('UserModels')
+ *   identifier: createType('UserModels')
  * });
  *
  * console.log(settings.exportPath); // './src/generated/models.ts'
@@ -41,7 +43,7 @@
  * };
  *
  * const enrichedSettings = new ContentSettings({
- *   identifier: Identifier.createType('ValidatedModels'),
+ *   identifier: createType('ValidatedModels'),
  *   exportPath: './src/models/validated.ts',
  *   enrichments: {
  *     validateRequired: true,
@@ -56,14 +58,14 @@
  * }
  * ```
  *
- * @example Using with ModelBase
+ * @example Using with ModelProjectionBase
  * ```typescript
- * class ValidatedModelGenerator extends ModelBase<ValidationEnrichment> {
+ * class ValidatedModelGenerator extends ModelProjectionBase<ValidationEnrichment> {
  *   constructor(args) {
  *     super({
  *       ...args,
  *       settings: new ContentSettings({
- *         identifier: Identifier.createType(args.refName),
+ *         identifier: createType(args.refName),
  *         exportPath: './src/validated-models.ts',
  *         enrichments: {
  *           validateRequired: true,
@@ -99,20 +101,22 @@ export class ContentSettings {
      * @param args.identifier - The identifier for the content being generated
      * @param args.exportPath - The path where generated content will be exported
      * @param args.enrichments - Custom enrichment data for extending generation
+     * @param args.variant - Operation variant name (`'main'` for variants-unaware Projections)
      *
      * @example
      * ```typescript
      * const settings = new ContentSettings({
-     *   identifier: Identifier.createType('ApiModels'),
+     *   identifier: createType('ApiModels'),
      *   exportPath: './src/api/models.ts',
      *   enrichments: {
      *     includeValidation: true,
      *     format: 'detailed'
-     *   }
+     *   },
+     *   variant: 'main'
      * });
      * ```
      */
-    constructor({ identifier, exportPath, enrichments }) {
+    constructor({ identifier, exportPath, enrichments, variant }) {
         /** The identifier for the content being generated */
         Object.defineProperty(this, "identifier", {
             enumerable: true,
@@ -134,9 +138,22 @@ export class ContentSettings {
             writable: true,
             value: void 0
         });
+        /**
+         * Operation variant this content belongs to. Carries the variant name
+         * threaded from the engine's per-operation dispatch through the
+         * Driver into this Projection. `'main'` for variants-unaware
+         * operation generators and for model Projections.
+         */
+        Object.defineProperty(this, "variant", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.identifier = identifier;
         this.exportPath = exportPath;
         this.enrichments = enrichments;
+        this.variant = variant;
     }
     /**
      * Factory method to create ContentSettings without enrichments.
@@ -153,19 +170,19 @@ export class ContentSettings {
      * @example
      * ```typescript
      * const basicSettings = ContentSettings.empty({
-     *   identifier: Identifier.createType('SimpleModels'),
+     *   identifier: createType('SimpleModels'),
      *   exportPath: './src/models.ts'
      * });
      *
      * console.log(basicSettings.enrichments); // undefined
      *
      * // Use in generator
-     * class SimpleGenerator extends ModelBase {
+     * class SimpleGenerator extends ModelProjectionBase {
      *   constructor(args) {
      *     super({
      *       ...args,
      *       settings: ContentSettings.empty({
-     *         identifier: Identifier.createType(args.refName),
+     *         identifier: createType(args.refName),
      *         exportPath: './src/simple-models.ts'
      *       })
      *     });
@@ -173,11 +190,12 @@ export class ContentSettings {
      * }
      * ```
      */
-    static empty({ identifier, exportPath }) {
+    static empty({ identifier, exportPath, variant = DEFAULT_VARIANT }) {
         return new ContentSettings({
             identifier,
             exportPath,
-            enrichments: undefined
+            enrichments: undefined,
+            variant
         });
     }
 }

package/esm/dsl/CustomValue.d.ts

@@ -1,5 +1,6 @@
+import "../_dnt.polyfills.js";
 import type { GenerateContextType } from '../context/generateTypes.js';
-import { ContentBase } from './ContentBase.js';
+import { SnippetBase } from './SnippetBase.js';
 import type { Stringable } from './Stringable.js';
 import type { GeneratorKey } from './GeneratorKeys.js';
 import type { OasRef } from '../oas/ref/Ref.js';
@@ -26,7 +27,7 @@ type CreateArgs = {
  * console.log(customValue.toString()); // "const customCode = "generated";"
  * ```
  */
-export declare class CustomValue extends ContentBase {
+export declare class CustomValue extends SnippetBase {
     /** Type identifier for this custom value */
     type: "custom";
     /** The underlying value content that can be converted to string */

package/esm/dsl/CustomValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomValue.d.ts","sourceRoot":"","sources":["../../src/dsl/CustomValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,KAAK,EAAE,UAAU,CAAA;IACjB,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,4CAA4C;IAC5C,IAAI,EAAG,QAAQ,CAAS;IACxB,mEAAmE;IACnE,KAAK,EAAE,UAAU,CAAA;IAEjB;;;;OAIG;gBACS,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,UAAU;IAMxD;;;;OAIG;IACH,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC;;;;OAIG;IACH,OAAO,IAAI,WAAW;IAItB;;;;OAIG;IACH,WAAW,IAAI,WAAW;IAI1B;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAG5B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAA"}
+{"version":3,"file":"CustomValue.d.ts","sourceRoot":"","sources":["../../src/dsl/CustomValue.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,KAAK,EAAE,UAAU,CAAA;IACjB,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,4CAA4C;IAC5C,IAAI,EAAG,QAAQ,CAAS;IACxB,mEAAmE;IACnE,KAAK,EAAE,UAAU,CAAA;IAEjB;;;;OAIG;gBACS,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,UAAU;IAMxD;;;;OAIG;IACH,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC;;;;OAIG;IACH,OAAO,IAAI,WAAW;IAItB;;;;OAIG;IACH,WAAW,IAAI,WAAW;IAI1B;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAG5B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAA"}

package/esm/dsl/CustomValue.js

@@ -1,4 +1,5 @@
-import { ContentBase } from './ContentBase.js';
+import "../_dnt.polyfills.js";
+import { SnippetBase } from './SnippetBase.js';
 /**
  * Represents a custom value in the SKMTC generation pipeline.
  *
@@ -17,7 +18,7 @@ import { ContentBase } from './ContentBase.js';
  * console.log(customValue.toString()); // "const customCode = "generated";"
  * ```
  */
-export class CustomValue extends ContentBase {
+export class CustomValue extends SnippetBase {
     /**
      * Creates a new CustomValue instance.
      *