@skmtc/core 0.18.1 → 0.27.0

package/script/dsl/GeneratorKeys.d.ts

@@ -129,7 +129,7 @@ export type OasOperationGeneratorKey = Brand<NakedOasOperationGeneratorKey, 'Oas
  * Branded type for GraphQL operation generator keys.
  *
  * Sibling to {@link OasOperationGeneratorKey} for the GraphQL protocol. The key
- * encodes the generator ID, the root kind (`query` / `mutation` /
+ * encodes the generator ID, the root type (`query` / `mutation` /
  * `subscription`), and the root field name.
  */
 export type GqlOperationGeneratorKey = Brand<NakedGqlOperationGeneratorKey, 'GqlOperationGeneratorKey'>;
@@ -210,15 +210,15 @@ type ToOasOperationGeneratorKeyArgs = {
     path: string;
     /** HTTP method */
     method: Method;
-    /** Operation variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Operation variant name — omitted means `'main'` */
+    variant?: string;
 } | {
     /** Unique identifier for the generator */
     generatorId: string;
     /** OpenAPI operation object containing path and method */
     operation: OasOperation;
-    /** Operation variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Operation variant name — omitted means `'main'` */
+    variant?: string;
 };
 /**
  * Creates an OAS operation generator key from generator ID and operation details.
@@ -271,15 +271,15 @@ type ToWebhookGeneratorKeyArgs = {
     name: string;
     /** HTTP method */
     method: Method;
-    /** Webhook variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Webhook variant name — omitted means `'main'` */
+    variant?: string;
 } | {
     /** Unique identifier for the generator */
     generatorId: string;
     /** OpenAPI webhook object containing name and method */
     webhook: OasWebhook;
-    /** Webhook variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Webhook variant name — omitted means `'main'` */
+    variant?: string;
 };
 /**
  * Creates a webhook generator key from generator ID and webhook details.
@@ -293,25 +293,25 @@ export declare const toWebhookGeneratorKey: ({ generatorId, variant, ...rest }:
  * Arguments for {@link toGqlOperationGeneratorKey}.
  *
  * Can specify operation details directly or provide a {@link GqlOperation}
- * object from which the root kind and field name will be extracted. The
+ * object from which the root type and field name will be extracted. The
  * `variant` segment is always required (see {@link Variant}).
  */
 type ToGqlOperationGeneratorKeyArgs = {
     /** Unique identifier for the generator */
     generatorId: string;
-    /** GraphQL root kind */
+    /** GraphQL root type */
     rootKind: GqlRootKind;
     /** Root field name */
     fieldName: string;
-    /** Operation variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Operation variant name — omitted means `'main'` */
+    variant?: string;
 } | {
     /** Unique identifier for the generator */
     generatorId: string;
     /** GraphQL operation object */
     operation: GqlOperation;
-    /** Operation variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Operation variant name — omitted means `'main'` */
+    variant?: string;
 };
 /**
  * Creates a GraphQL operation generator key.
@@ -331,8 +331,8 @@ type ToModelGeneratorKeyArgs = {
     generatorId: string;
     /** Reference name of the schema model */
     refName: RefName;
-    /** Model variant name (use `'main'` for variants-unaware generators) */
-    variant: string;
+    /** Model variant name — omitted means `'main'` */
+    variant?: string;
 };
 /**
  * Creates a model generator key from generator ID, schema reference name,
@@ -455,7 +455,7 @@ export declare const isWebhookGeneratorKey: (arg: unknown) => arg is WebhookGene
  *
  * Validates that the argument is a string with the format
  * `generatorId|rootKind|fieldName`, with `rootKind` constrained to a
- * GraphQL root operation kind (`query` / `mutation` / `subscription`).
+ * GraphQL root operation type (`query` / `mutation` / `subscription`).
  */
 export declare const isGqlOperationGeneratorKey: (arg: unknown) => arg is GqlOperationGeneratorKey;
 /**
@@ -572,7 +572,7 @@ export type GeneratorKeyObject = {
     type: 'gqlOperation';
     /** Generator identifier */
     generatorId: string;
-    /** GraphQL root kind */
+    /** GraphQL root type */
     rootKind: GqlRootKind;
     /** Root field name */
     fieldName: string;

package/script/dsl/GeneratorKeys.d.ts.map

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

package/script/dsl/GeneratorKeys.js

@@ -68,6 +68,7 @@ exports.fromGeneratorKey = exports.toGeneratorId = exports.isGeneratorOnlyKey =
  */
 require("../_dnt.polyfills.js");
 const Method_js_1 = require("../types/Method.js");
+const Variant_js_1 = require("../types/Variant.js");
 const GQL_ROOT_KINDS = ['query', 'mutation', 'subscription'];
 const isGqlRootKind = (value) => GQL_ROOT_KINDS.includes(value);
 /**
@@ -105,7 +106,7 @@ const isGqlRootKind = (value) => GQL_ROOT_KINDS.includes(value);
  * // Result: 'rest-client|/posts|post' (branded)
  * ```
  */
-const toOasOperationGeneratorKey = ({ generatorId, variant, ...rest }) => {
+const toOasOperationGeneratorKey = ({ generatorId, variant = Variant_js_1.DEFAULT_VARIANT, ...rest }) => {
     const { path, method } = 'operation' in rest ? rest.operation : rest;
     const nakedKey = `${generatorId}|${path}|${method}|${variant}`;
     return nakedKey;
@@ -118,7 +119,7 @@ exports.toOasOperationGeneratorKey = toOasOperationGeneratorKey;
  * Format: `generatorId|webhook|name|method|variant`. The literal `webhook`
  * segment keeps webhook keys from colliding with operation keys.
  */
-const toWebhookGeneratorKey = ({ generatorId, variant, ...rest }) => {
+const toWebhookGeneratorKey = ({ generatorId, variant = Variant_js_1.DEFAULT_VARIANT, ...rest }) => {
     const { name, method } = 'webhook' in rest ? rest.webhook : rest;
     const nakedKey = `${generatorId}|webhook|${name}|${method}|${variant}`;
     return nakedKey;
@@ -130,7 +131,7 @@ exports.toWebhookGeneratorKey = toWebhookGeneratorKey;
  * Sibling to {@link toOasOperationGeneratorKey} for the GraphQL protocol. Format:
  * `generatorId|rootKind|fieldName|variant`.
  */
-const toGqlOperationGeneratorKey = ({ generatorId, variant, ...rest }) => {
+const toGqlOperationGeneratorKey = ({ generatorId, variant = Variant_js_1.DEFAULT_VARIANT, ...rest }) => {
     const { rootKind, fieldName } = 'operation' in rest
         ? { rootKind: rest.operation.rootKind, fieldName: rest.operation.fieldName }
         : rest;
@@ -166,7 +167,7 @@ exports.toGqlOperationGeneratorKey = toGqlOperationGeneratorKey;
  * // Result: 'zod-schemas|CreateUserRequest|coercive' (branded)
  * ```
  */
-const toModelGeneratorKey = ({ generatorId, refName, variant }) => {
+const toModelGeneratorKey = ({ generatorId, refName, variant = Variant_js_1.DEFAULT_VARIANT }) => {
     const nakedKey = `${generatorId}|${refName}|${variant}`;
     return nakedKey;
 };
@@ -316,7 +317,7 @@ exports.isWebhookGeneratorKey = isWebhookGeneratorKey;
  *
  * Validates that the argument is a string with the format
  * `generatorId|rootKind|fieldName`, with `rootKind` constrained to a
- * GraphQL root operation kind (`query` / `mutation` / `subscription`).
+ * GraphQL root operation type (`query` / `mutation` / `subscription`).
  */
 const isGqlOperationGeneratorKey = (arg) => {
     if (typeof arg !== 'string') {

package/script/dsl/IdentifierBase.d.ts

@@ -17,19 +17,19 @@ export type IdentifierBaseArgs = {
  * `(name, exportPath)` cross-generator cache key, and `DefinitionBase`. The
  * engine reads ONLY `.name` (the cache-key source); `typeName` and
  * `exported` are language-neutral facts it threads but never interprets.
- * Crucially it carries NO `kind` — the per-language declaration vocabulary
+ * Crucially it carries NO `type` — the per-language declaration vocabulary
  * lives, typed, on the language subclasses.
  *
  * It completes the neutral `*Base` family
  * (`CodeFileBase` / `DefinitionBase` / `ImportBase`): the concrete,
- * kind-carrying subclasses (`TsIdentifier`, `KtIdentifier`) live in the
+ * type-carrying subclasses (`TsIdentifier`, `KtIdentifier`) live in the
  * `@skmtc/lang-*` packages and **extend** this base. Construction goes
  * through a language package's factories (`createVariable` / `createType`
  * for TypeScript; `createDataClass` / `createEnumClass` / … for Kotlin) or
  * the engine's assembly seam `lang.toIdentifier({ name, ...identifierType })`.
- * The engine holds the result as `IdentifierBase`; the language's `kind` is
- * read only by the language renderers, which narrow via an `instanceof`
- * guard (`isTsIdentifier` / `isKtIdentifier`).
+ * The engine holds the result as `IdentifierBase`; the language's `type` is
+ * read only by the language renderers, which narrow back to the concrete
+ * subclass via `instanceof` (e.g. `value instanceof TsIdentifier`).
  */
 export declare class IdentifierBase {
     /** The identifier name — the only field the engine reads. */
@@ -51,5 +51,19 @@ export declare class IdentifierBase {
      * identifier is interpolated into generated code.
      */
     toString(): string;
+    /**
+     * The key under which a file stores and dedups this identifier's
+     * definition: two definitions whose identifiers share a `declarationKey`
+     * occupy the same declaration slot, so the later one collapses into the
+     * first (the cross-generator cache then resolves a name to its
+     * first-registered definition).
+     *
+     * The neutral default is the bare {@link name} — one definition per name,
+     * which is what most languages want. A language whose declaration space is
+     * richer overrides this: TypeScript folds in the declaration `type` so a
+     * `class Foo` and a `declare namespace Foo` — distinct declarations the
+     * compiler legitimately merges — get distinct keys instead of colliding.
+     */
+    declarationKey(): string;
 }
 //# sourceMappingURL=IdentifierBase.d.ts.map

package/script/dsl/IdentifierBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentifierBase.d.ts","sourceRoot":"","sources":["../../src/dsl/IdentifierBase.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAc;IACzB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IAEZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAA;gBAEL,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB;IAM5D;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"IdentifierBase.d.ts","sourceRoot":"","sources":["../../src/dsl/IdentifierBase.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAc;IACzB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IAEZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAA;gBAEL,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB;IAM5D;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/script/dsl/IdentifierBase.js

@@ -9,19 +9,19 @@ exports.IdentifierBase = void 0;
  * `(name, exportPath)` cross-generator cache key, and `DefinitionBase`. The
  * engine reads ONLY `.name` (the cache-key source); `typeName` and
  * `exported` are language-neutral facts it threads but never interprets.
- * Crucially it carries NO `kind` — the per-language declaration vocabulary
+ * Crucially it carries NO `type` — the per-language declaration vocabulary
  * lives, typed, on the language subclasses.
  *
  * It completes the neutral `*Base` family
  * (`CodeFileBase` / `DefinitionBase` / `ImportBase`): the concrete,
- * kind-carrying subclasses (`TsIdentifier`, `KtIdentifier`) live in the
+ * type-carrying subclasses (`TsIdentifier`, `KtIdentifier`) live in the
  * `@skmtc/lang-*` packages and **extend** this base. Construction goes
  * through a language package's factories (`createVariable` / `createType`
  * for TypeScript; `createDataClass` / `createEnumClass` / … for Kotlin) or
  * the engine's assembly seam `lang.toIdentifier({ name, ...identifierType })`.
- * The engine holds the result as `IdentifierBase`; the language's `kind` is
- * read only by the language renderers, which narrow via an `instanceof`
- * guard (`isTsIdentifier` / `isKtIdentifier`).
+ * The engine holds the result as `IdentifierBase`; the language's `type` is
+ * read only by the language renderers, which narrow back to the concrete
+ * subclass via `instanceof` (e.g. `value instanceof TsIdentifier`).
  */
 class IdentifierBase {
     constructor({ name, typeName, exported }) {
@@ -64,5 +64,21 @@ class IdentifierBase {
     toString() {
         return this.name;
     }
+    /**
+     * The key under which a file stores and dedups this identifier's
+     * definition: two definitions whose identifiers share a `declarationKey`
+     * occupy the same declaration slot, so the later one collapses into the
+     * first (the cross-generator cache then resolves a name to its
+     * first-registered definition).
+     *
+     * The neutral default is the bare {@link name} — one definition per name,
+     * which is what most languages want. A language whose declaration space is
+     * richer overrides this: TypeScript folds in the declaration `type` so a
+     * `class Foo` and a `declare namespace Foo` — distinct declarations the
+     * compiler legitimately merges — get distinct keys instead of colliding.
+     */
+    declarationKey() {
+        return this.name;
+    }
 }
 exports.IdentifierBase = IdentifierBase;

package/script/dsl/IdentifierType.d.ts

@@ -1,28 +1,22 @@
-import type { Lang, LangKind } from './Lang.js';
 /**
  * The non-`name` parts of an identifier — everything a projection's
  * `toIdentifierType` derives from the schema (context-aware), bundled so
  * the engine can assemble the full identifier with
  * `lang.toIdentifier({ name, ...identifierType })`.
  *
- * Generic over the projection's {@link Lang}: the `kind` is drawn from that
- * language's declaration vocabulary, recovered via {@link LangKind} from the
- * typed `kind` on the {@link import('@/dsl/IdentifierBase.ts').IdentifierBase}
- * subclass the lang produces (`KtEntityKind` for `KtLang`, `TsEntityKind` for
- * the TypeScript `Lang`, …). A bare `Lang` falls back to the loose
- * `kind: string` — the opaque-kind boundary the engine never interprets.
- *
- * This is what lets a language's projection-base veneer parameterize core's
- * config (`ModelProjectionBaseConfig<E, KtLang>`) instead of recasting
- * `toIdentifierType`'s return: the tightening rides the `L` type argument.
+ * The `type` is the opaque-boundary `string` — the engine never interprets
+ * it. Each language's declaration-type vocabulary is a fixed fact of its lang
+ * package; a lang veneer tightens `toIdentifierType`'s return to its own
+ * `XxIdentifierType` (`type` narrowed to `XxEntityType`), which is assignable
+ * back to this shape. Core never models or recovers that vocabulary.
  *
  * Pairs with `toIdentifierName(args) -> string` (the pure, cache-key
  * source): the engine assembles
  * `lang.toIdentifier({ name: P.toIdentifierName(args), ...P.toIdentifierType(coordinate, context) })`.
  */
-export type IdentifierType<L extends Lang = Lang> = {
-    /** Per-language declaration kind — `LangKind<L>`, opaque to the engine. */
-    kind: LangKind<L>;
+export type IdentifierType = {
+    /** Per-language declaration type — the opaque-boundary `string`. */
+    type: string;
     /** Optional type annotation, opaque to the engine (lang-interpreted). */
     typeName?: string;
     /** Whether the identifier is exported. Defaults to `true`. */

package/script/dsl/IdentifierType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentifierType.d.ts","sourceRoot":"","sources":["../../src/dsl/IdentifierType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,IAAI;IAClD,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA"}
+{"version":3,"file":"IdentifierType.d.ts","sourceRoot":"","sources":["../../src/dsl/IdentifierType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA"}

package/script/dsl/Lang.d.ts

@@ -10,13 +10,9 @@ import type { SnippetBase, SnippetBaseArgs } from './SnippetBase.js';
  * Arguments for {@link Lang.toDefinition} — everything the language needs
  * to wrap a generated `value` in its own `Definition` subclass.
  *
- * `identifier` stays the neutral {@link IdentifierBase}: the engine holds
- * identifiers as the base and passes that to the factory (which narrows via
- * its own `instanceof` guard). Keeping it neutral is also what lets a typed
- * `Lang` (e.g. `KtLang`) satisfy the bare `Lang` constraint — `identifier`
- * is a contravariant parameter, so a narrower type here would break the
- * subtype relation. The typed identifier surfaces only on `toIdentifier`'s
- * RETURN (a covariant position).
+ * `identifier` is the neutral {@link IdentifierBase}: the engine holds
+ * identifiers as the base and passes that to the factory, which narrows to
+ * its own concrete subclass via `instanceof`.
  */
 export type LangToDefinitionArgs<V extends GeneratedValue = GeneratedValue> = {
     context: GenerateContextType;
@@ -40,12 +36,12 @@ export type LangToImportArgs = {
  * seam. `name` comes from the projection's pure `toIdentifierName`; the
  * remaining fields come from the context-aware `toIdentifierType`
  * (spread in). The language builds its concrete `IdentifierBase` subclass
- * (`TsIdentifier` / `KtIdentifier`), reading the opaque `kind` into its
- * typed `EntityKind` slot.
+ * (`TsIdentifier` / `KtIdentifier`), reading the opaque `type` into its
+ * typed `EntityType` slot.
  */
 export type LangToIdentifierArgs = {
     name: string;
-    kind: string;
+    type: string;
     typeName?: string;
     exported?: boolean;
 };
@@ -72,7 +68,7 @@ export type LangToIdentifierArgs = {
  * vocabulary is intra-lang-package (each language's register function
  * converts its own form), so the neutral interface never names one.
  */
-export type Lang<IdentifierT extends IdentifierBase = IdentifierBase> = {
+export type Lang = {
     /** Construct the language's file for `path`. */
     createFile: (args: {
         path: string;
@@ -84,28 +80,14 @@ export type Lang<IdentifierT extends IdentifierBase = IdentifierBase> = {
     toImport: (args: LangToImportArgs) => ImportBase;
     /**
      * Assemble this language's `IdentifierBase` subclass from name +
-     * kind/type/exported. `kind` arrives as the opaque-boundary `string` (the
-     * engine never narrows it); the language reads it into its typed
-     * `EntityKind` slot. The returned `IdentifierT` is the language's concrete
-     * subclass — its typed `kind` is the ONLY place `IdentifierT` appears (a
-     * covariant return position), which is what lets {@link IdentifierType}
-     * recover the vocabulary to tighten the projection config while a typed
-     * `Lang` still satisfies the bare `Lang` constraint.
+     * type/typeName/exported. `type` arrives as the opaque-boundary `string` — the
+     * engine never narrows it; the language reads it into its own typed
+     * `EntityType` slot. The engine holds the result as the neutral
+     * `IdentifierBase`; the declaration-type vocabulary is a fixed fact of each
+     * language package, never modelled or recovered here.
      */
-    toIdentifier: (args: LangToIdentifierArgs) => IdentifierT;
+    toIdentifier: (args: LangToIdentifierArgs) => IdentifierBase;
 };
-/**
- * The language's declaration-kind vocabulary, recovered from the typed
- * `kind` on the {@link IdentifierBase} subclass a `Lang` produces.
- *
- * `KtIdentifier` carries `kind: KtEntityKind`, `TsIdentifier` carries
- * `kind: TsEntityKind`, … The neutral `IdentifierBase` has no `kind`, so a
- * bare `Lang` falls back to the loose `string` — the opaque-kind boundary
- * the engine speaks.
- */
-export type LangKind<L extends Lang> = ReturnType<L['toIdentifier']> extends {
-    kind: infer Kind extends string;
-} ? Kind : string;
 /**
  * The constructor contract a language's snippet base class must satisfy to
  * be used as the `base` of a projection-base factory
@@ -124,13 +106,11 @@ export type LangKind<L extends Lang> = ReturnType<L['toIdentifier']> extends {
  * generic over the base's *instance* type cannot type-safely extend it
  * (TS2415/TS2545 — see the scratch in `notes/lang/14`), and the price would
  * be that language-specific instance members are type-erased on projection
- * classes. Only the STATIC `lang` is parameterized — over the neutral `Lang`
- * by default, narrowed to a language's typed `Lang` (e.g. `KtLang`) when a
- * veneer threads `L` through. Narrowing a covariant static intersection does
- * not reawaken TS2415; the `extends config.base` in the factories stays well
- * typed because the instance side is unchanged.
+ * classes. The static `lang` is the neutral {@link Lang} — the engine reads
+ * it language-blind; each lang package's concrete declaration-type vocabulary
+ * is a fixed fact of that package, never recovered through this type.
  */
-export type LangSnippetConstructor<L extends Lang = Lang> = (new (args: SnippetBaseArgs) => SnippetBase) & {
-    lang: L;
+export type LangSnippetConstructor = (new (args: SnippetBaseArgs) => SnippetBase) & {
+    lang: Lang;
 };
 //# sourceMappingURL=Lang.d.ts.map

package/script/dsl/Lang.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Lang.d.ts","sourceRoot":"","sources":["../../src/dsl/Lang.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI;IAC5E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,cAAc,CAAA;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,cAAc,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,IAAI,CAAC,WAAW,SAAS,cAAc,GAAG,cAAc,IAAI;IACtE,gDAAgD;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;KAAE,KAAK,QAAQ,CAAA;IACtF,yEAAyE;IACzE,YAAY,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAAA;IAC5F,mEAAmE;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,UAAU,CAAA;IAChD;;;;;;;;;OASG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,WAAW,CAAA;CAC1D,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,SAAS;IAC3E,IAAI,EAAE,MAAM,IAAI,SAAS,MAAM,CAAA;CAChC,GACG,IAAI,GACJ,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,IAAI,CAAC,KAC3D,IAAI,EAAE,eAAe,KAClB,WAAW,CAAC,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAA"}
+{"version":3,"file":"Lang.d.ts","sourceRoot":"","sources":["../../src/dsl/Lang.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI;IAC5E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,cAAc,CAAA;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,cAAc,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,gDAAgD;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;KAAE,KAAK,QAAQ,CAAA;IACtF,yEAAyE;IACzE,YAAY,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAAA;IAC5F,mEAAmE;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,UAAU,CAAA;IAChD;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,cAAc,CAAA;CAC7D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,IAAI,EAAE,eAAe,KAAK,WAAW,CAAC,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA"}

package/script/dsl/MarkdownFile.d.ts

@@ -0,0 +1,55 @@
+import { FileBase } from './FileBase.js';
+import type { Stringable } from './Stringable.js';
+/**
+ * Constructor arguments for {@link MarkdownFile}.
+ */
+type MarkdownFileArgs = {
+    /** The file path for the generated Markdown file */
+    path: string;
+    /** The Markdown content to write to the file */
+    content: Stringable;
+};
+/**
+ * Represents a Markdown file in the SKMTC DSL system.
+ *
+ * The Markdown counterpart of {@link import('@/dsl/JsonFile.ts').JsonFile}: a
+ * degenerate, non-code file that extends {@link FileBase} directly — it holds
+ * no definitions, imports or re-exports, because Markdown has no grammar to
+ * coordinate. Its `content` is any {@link Stringable} (a string or a composed
+ * snippet tree) and `toString()` renders it verbatim. Written through
+ * `GenerateContext.registerMarkdown`.
+ *
+ * @example
+ * ```typescript
+ * import { MarkdownFile } from '@skmtc/core';
+ *
+ * const doc = new MarkdownFile({
+ *   path: '@/docs/GetPet.generated.md',
+ *   content: '# Get pet'
+ * });
+ *
+ * console.log(doc.toString()); // '# Get pet'
+ * ```
+ */
+export declare class MarkdownFile extends FileBase {
+    /** The file type, always 'markdown' for Markdown files */
+    fileType: 'markdown';
+    /** The Markdown content to write to the file */
+    content: Stringable;
+    /**
+     * Creates a new MarkdownFile instance.
+     *
+     * @param args - Markdown file configuration
+     * @param args.path - The output path for this Markdown file
+     * @param args.content - The Markdown content to write
+     */
+    constructor({ path, content }: MarkdownFileArgs);
+    /**
+     * Renders the Markdown content to a string.
+     *
+     * @returns The Markdown content as a string
+     */
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=MarkdownFile.d.ts.map

package/script/dsl/MarkdownFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownFile.d.ts","sourceRoot":"","sources":["../../src/dsl/MarkdownFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,OAAO,EAAE,UAAU,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,0DAA0D;IAC1D,QAAQ,EAAE,UAAU,CAAa;IAEjC,gDAAgD;IAChD,OAAO,EAAE,UAAU,CAAA;IAEnB;;;;;;OAMG;gBACS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,gBAAgB;IAK/C;;;;OAIG;IACM,QAAQ,IAAI,MAAM;CAG5B"}

package/script/dsl/MarkdownFile.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownFile = void 0;
+const FileBase_js_1 = require("./FileBase.js");
+/**
+ * Represents a Markdown file in the SKMTC DSL system.
+ *
+ * The Markdown counterpart of {@link import('@/dsl/JsonFile.ts').JsonFile}: a
+ * degenerate, non-code file that extends {@link FileBase} directly — it holds
+ * no definitions, imports or re-exports, because Markdown has no grammar to
+ * coordinate. Its `content` is any {@link Stringable} (a string or a composed
+ * snippet tree) and `toString()` renders it verbatim. Written through
+ * `GenerateContext.registerMarkdown`.
+ *
+ * @example
+ * ```typescript
+ * import { MarkdownFile } from '@skmtc/core';
+ *
+ * const doc = new MarkdownFile({
+ *   path: '@/docs/GetPet.generated.md',
+ *   content: '# Get pet'
+ * });
+ *
+ * console.log(doc.toString()); // '# Get pet'
+ * ```
+ */
+class MarkdownFile extends FileBase_js_1.FileBase {
+    /**
+     * Creates a new MarkdownFile instance.
+     *
+     * @param args - Markdown file configuration
+     * @param args.path - The output path for this Markdown file
+     * @param args.content - The Markdown content to write
+     */
+    constructor({ path, content }) {
+        super({ path });
+        /** The file type, always 'markdown' for Markdown files */
+        Object.defineProperty(this, "fileType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'markdown'
+        });
+        /** The Markdown content to write to the file */
+        Object.defineProperty(this, "content", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.content = content;
+    }
+    /**
+     * Renders the Markdown content to a string.
+     *
+     * @returns The Markdown content as a string
+     */
+    toString() {
+        return this.content.toString();
+    }
+}
+exports.MarkdownFile = MarkdownFile;

package/script/dsl/model/ModelDriver.d.ts

@@ -16,8 +16,10 @@ type CreateModelArgs<V extends GeneratedValue, EnrichmentType> = {
      * peer's enrichment for this variant, asserts the variant exists
      * (or is the default `'main'` which is always permitted), and
      * threads it into the projection's `ContentSettings`.
+     * Optional — omitting it means `'main'`, so variants-unaware
+     * callers keep working unchanged.
      */
-    variant: string;
+    variant?: string;
 };
 /**
  * Driver for the model insertion lifecycle.

package/script/dsl/model/ModelDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/ModelDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAMrD,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,IAAI;IAC/D,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc;IAC/D,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EACf,OAAO,EACP,QAAQ,EACR,OAAO,EACR,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BrC,OAAO,CAAC,KAAK;IAoBb;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,gBAAgB;CAsBzB"}
+{"version":3,"file":"ModelDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/ModelDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAMrD,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,IAAI;IAC/D,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc;IAC/D,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EACf,OAAO,EACP,QAAQ,EACR,OAAyB,EAC1B,EAAE,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BrC,OAAO,CAAC,KAAK;IAoBb;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,gBAAgB;CAsBzB"}

package/script/dsl/model/ModelDriver.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModelDriver = void 0;
-const normalize_js_1 = require("../../deps/jsr.io/@std/path/1.1.4/normalize.js");
+const normalize_js_1 = require("../../deps/jsr.io/@std/path/1.1.6/normalize.js");
 const GeneratorKeys_js_1 = require("../GeneratorKeys.js");
 const Variant_js_1 = require("../../types/Variant.js");
 const get_js_1 = __importDefault(require("lodash-es/get.js"));
@@ -18,7 +18,7 @@ const get_js_1 = __importDefault(require("lodash-es/get.js"));
  * from the projection's `exportPath`.
  */
 class ModelDriver {
-    constructor({ context, projection, refName, destinationPath, rootRef, noExport, variant }) {
+    constructor({ context, projection, refName, destinationPath, rootRef, noExport, variant = Variant_js_1.DEFAULT_VARIANT }) {
         Object.defineProperty(this, "context", {
             enumerable: true,
             configurable: true,
@@ -87,7 +87,7 @@ class ModelDriver {
             refName,
             variant
         });
-        assertPeerSupported({ context, projection, refName });
+        assertPeerSupported({ context, projection, refName, variant });
         this.settings = this.context.toModelContentSettings({ refName, projection, variant });
         this.definition = this.apply({ destinationPath });
         this.context.modelDepth[`${projection.id}:${refName}`] = 0;
@@ -217,11 +217,9 @@ const assertPeerVariantExists = ({ context, generatorId, refName, variant }) =>
  * model: `toModelProjectionBase` defaults it to `() => true`, and a
  * hand-rolled projection may omit it.
  */
-const assertPeerSupported = ({ context, projection, refName }) => {
-    if (typeof projection.isSupported !== 'function') {
-        return;
-    }
-    if (!projection.isSupported({ refName, context })) {
+const assertPeerSupported = ({ context, projection, refName, variant }) => {
+    const isSupported = projection.isSupported ?? (() => true);
+    if (!isSupported({ refName, context, variant })) {
         throw new Error(`[${projection.id}] Cannot insert '${refName}' — peer generator ` +
             `does not support this model (isSupported returned false).`);
     }