@skmtc/core 0.18.1 → 0.27.0

package/esm/dsl/webhook/types.d.ts.map

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

package/esm/enrichments/toEnrichmentDescriptor.d.ts

@@ -1,15 +1,8 @@
-import * as v from 'valibot';
+import type * as v from 'valibot';
 /**
- * Widget kind for one enrichment field — the rendered control in the
- * enrichment-editor UI. Mirrors the `EnrichmentFieldKind` enum in the
- * skmtc-hub TypeSpec contract.
+ * Properties shared by every enrichment-field variant.
  */
-export type EnrichmentFieldKind = 'text' | 'textarea' | 'toggle' | 'select' | 'module' | 'accessorPath' | 'array' | 'object';
-/**
- * One node of a serialised enrichment-schema descriptor — the
- * form-renderable projection of a generator's enrichment schema.
- */
-export type EnrichmentField = {
+export type EnrichmentFieldBase = {
     /** Key written into the enrichment values object. */
     key: string;
     /** Human label, derived from the key when no metadata is supplied. */
@@ -17,22 +10,58 @@ export type EnrichmentField = {
     description?: string;
     /** Whether the schema marks this field optional. */
     optional: boolean;
-    kind: EnrichmentFieldKind;
-    /** Choices for a `select` field. */
-    options?: string[];
+};
+/**
+ * The variant-specific part of one enrichment field — the widget `type`
+ * discriminant plus exactly the payload that widget carries. Mirrors the
+ * `EnrichmentField` union in the skmtc-hub TypeSpec contract.
+ *
+ * There are deliberately NO standalone `module` / `schemaPath` widget
+ * types: a component reference is only meaningful WITH the path that gives
+ * it a type, so the pair is declared as one `moduleSelect` field. A
+ * generator that uses the raw `moduleExport` / `schemaPath` schemas
+ * standalone degrades to the generic object/array widgets.
+ */
+export type EnrichmentFieldShape = {
+    type: 'text';
+} | {
+    type: 'textarea';
+} | {
+    type: 'toggle';
+} | {
+    type: 'select';
+    /** The selectable choices. */
+    options: string[];
+} | {
+    type: 'moduleSelect';
     /**
-     * For `kind: 'array'` — a one-element list describing the item shape.
-     * If the item is an object, the synthesised field carries the nested
-     * `fields`; if it is a primitive, the synthesised field carries the
-     * appropriate primitive kind. The single-element convention matches
-     * the contract's `EnrichmentField[]` shape.
+     * The TS source of the contract a chosen module must satisfy for this
+     * field (a single `export type XModule<F> = …` the editor's matcher
+     * checks candidates against). Always present: the module type is
+     * explicit in the declaration (`lensInputModuleType` for the common
+     * lens/input case), never an editor-side default.
      */
-    item?: EnrichmentField[];
-    /** For `kind: 'object'` — the nested object's fields. */
-    fields?: EnrichmentField[];
+    moduleType: string;
+} | {
+    type: 'array';
+    /** Shape of each item. */
+    item: EnrichmentField;
+} | {
+    type: 'object';
+    /** The nested object's fields. */
+    fields: EnrichmentField[];
 };
-/** What a generator targets — operations or models. */
-export type TargetKind = 'operation' | 'model';
+/**
+ * One node of a serialised enrichment-schema descriptor — the
+ * form-renderable projection of a generator's enrichment schema,
+ * discriminated on `type`. Recursive: `array` fields carry a single
+ * `item` shape, `object` fields carry nested `fields`.
+ */
+export type EnrichmentField = EnrichmentFieldBase & EnrichmentFieldShape;
+/** The widget-type discriminant values of {@link EnrichmentField}. */
+export type EnrichmentFieldType = EnrichmentField['type'];
+/** Which subject type a generator enriches — operations, webhooks, or models. */
+export type SubjectType = 'operation' | 'model' | 'webhook';
 /**
  * A generator's enrichment schema, projected for the CMS. The same
  * descriptor is what an agent would drive — the form UI is one
@@ -40,7 +69,14 @@ export type TargetKind = 'operation' | 'model';
  */
 export type EnrichmentDescriptor = {
     generator: string;
-    appliesTo: TargetKind;
+    subjectType: SubjectType;
+    /**
+     * Whether this generator's entry declares variant support
+     * (`supportsVariant: () => true`). The CMS reads it to decide whether to
+     * offer the per-subject variant axis (add / rename / delete variants) above
+     * the subject scope; `false` when the entry omits it.
+     */
+    supportsVariant: boolean;
     fields: EnrichmentField[];
 };
 /**
@@ -54,6 +90,14 @@ export type EnrichmentSource = {
     readonly id: string;
     readonly type: 'oasOperation' | 'gqlOperation' | 'model' | 'webhook';
     readonly toEnrichmentSchema?: () => v.GenericSchema;
+    /**
+     * Whether the entry supports the variant axis. Required: every entry built by
+     * `toOasOperationEntry` / `toGqlOperationEntry` / `toModelEntry` has it,
+     * because the factory inserts a `() => false` default when the author omits
+     * it — so by the time an entry reaches the descriptor the function always
+     * exists.
+     */
+    readonly supportsVariant: () => boolean;
 };
 /**
  * Walk a Valibot object schema and return the projected list of
@@ -71,7 +115,7 @@ export type EnrichmentSource = {
  * umbrella yields `[]`.
  *
  * Generally callers should prefer {@link toEnrichmentDescriptor}, which
- * takes a generator entry and fills in `generator` / `appliesTo`
+ * takes a generator entry and fills in `generator` / `subjectType`
  * automatically. This lower-level entry point is useful in tests and
  * when only the field shape is needed.
  */
@@ -80,8 +124,9 @@ export declare const toEnrichmentFields: (schema: v.GenericSchema | undefined) =
  * Project a generator entry's enrichment schema into a serialisable
  * `EnrichmentDescriptor` the CMS can render as a form. The entry's
  * `id` becomes `descriptor.generator`; its `type` discriminator maps
- * to `appliesTo` (`'oasOperation' | 'gqlOperation'` → `'operation'`;
- * `'model'` → `'model'`). If the entry has no `toEnrichmentSchema`, or
+ * to `subjectType` (`'oasOperation' | 'gqlOperation'` → `'operation'`;
+ * `'webhook'` → `'webhook'`; `'model'` → `'model'`). If the entry has no
+ * `toEnrichmentSchema`, or
  * declares the empty umbrella, the descriptor has an empty `fields`
  * array — the UI hides the section, matching the engine's "no
  * enrichments" behaviour.

package/esm/enrichments/toEnrichmentDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toEnrichmentDescriptor.d.ts","sourceRoot":"","sources":["../../src/enrichments/toEnrichmentDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,OAAO,GACP,QAAQ,CAAA;AAEZ;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,mBAAmB,CAAA;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IACxB,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAC3B,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,OAAO,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,UAAU,CAAA;IACrB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAA;CACpD,CAAA;AAwHD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,aAAa,GAAG,SAAS,KAAG,eAAe,EAKvF,CAAA;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,gBAAgB,KAAG,oBAI/D,CAAA"}
+{"version":3,"file":"toEnrichmentDescriptor.d.ts","sourceRoot":"","sources":["../../src/enrichments/toEnrichmentDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAGjC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,GACD;IACE,IAAI,EAAE,cAAc,CAAA;IACpB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAA;CACtB,GACD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,kCAAkC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAEL;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAExE,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;AAEzD,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAA;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAA;CACxC,CAAA;AAqJD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,aAAa,GAAG,SAAS,KAAG,eAAe,EAKvF,CAAA;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,gBAAgB,KAAG,oBAK/D,CAAA"}

package/esm/enrichments/toEnrichmentDescriptor.js

@@ -1,5 +1,4 @@
-import { moduleExport } from '../types/ModuleExport.js';
-import { accessorPath } from '../types/AccessorPath.js';
+import { moduleTypeOf } from '../types/ModuleSelect.js';
 const isValibotSchema = (input) => typeof input === 'object' &&
     input !== null &&
     'type' in input &&
@@ -13,6 +12,30 @@ const unwrap = (schema) => {
     }
     return { inner: schema, optional: false };
 };
+/**
+ * A `v.pipe(base, …actions)` schema spreads `base` and adds a `pipe` array
+ * whose first element IS the original base schema. The `moduleSelect`
+ * registry lookup must therefore also check the pipe's base, or piping a
+ * moduleSelect through metadata (`v.title(…)`) would silently demote it to
+ * a generic object widget.
+ */
+const baseOf = (schema) => Array.isArray(schema.pipe) && isValibotSchema(schema.pipe[0]) ? schema.pipe[0] : schema;
+/** The `v.title(…)` metadata riding a piped schema, if any — the field label. */
+const titleOf = (schema) => {
+    if (!Array.isArray(schema.pipe))
+        return undefined;
+    for (const action of schema.pipe) {
+        if (typeof action === 'object' &&
+            action !== null &&
+            'type' in action &&
+            action.type === 'title' &&
+            'title' in action &&
+            typeof action.title === 'string') {
+            return action.title;
+        }
+    }
+    return undefined;
+};
 /**
  * Whether an object member should be omitted from the descriptor. A member
  * that unwraps to `v.undefined()` carries no payload — it is the canonical
@@ -30,48 +53,51 @@ const toLabel = (key) => {
     const spaced = key.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ');
     return spaced.charAt(0).toUpperCase() + spaced.slice(1);
 };
-const kindFor = (schema) => {
-    if (isValibotSchema(moduleExport) && schema === moduleExport) {
-        return { kind: 'module' };
-    }
-    if (isValibotSchema(accessorPath) && schema === accessorPath) {
-        return { kind: 'accessorPath' };
+const typeFor = (schema) => {
+    const moduleType = moduleTypeOf(schema) ?? moduleTypeOf(baseOf(schema));
+    if (moduleType !== undefined) {
+        return { type: 'moduleSelect', moduleType };
     }
     switch (schema.type) {
         case 'string':
-            return { kind: 'text' };
+            return { type: 'text' };
         case 'boolean':
-            return { kind: 'toggle' };
+            return { type: 'toggle' };
         case 'number':
-            return { kind: 'text' };
+            return { type: 'text' };
         case 'picklist': {
             const opts = isOptionsArray(schema.options) ? schema.options.map(o => String(o)) : [];
-            return { kind: 'select', options: opts };
+            return { type: 'select', options: opts };
         }
         case 'object': {
             const entries = isEntriesRecord(schema.entries) ? schema.entries : {};
             return {
-                kind: 'object',
+                type: 'object',
                 fields: walkEntries(entries)
             };
         }
         case 'array': {
             if (isValibotSchema(schema.item)) {
-                return { kind: 'array', item: [walkFromShape('', schema.item)] };
+                return { type: 'array', item: walkFromShape('', schema.item) };
             }
-            return { kind: 'array', item: [] };
+            // An unrecognisable item schema degrades to a text item — consistent
+            // with the walker's default posture for unknown leaves.
+            return { type: 'array', item: { key: '', label: '', optional: false, type: 'text' } };
         }
         default:
-            return { kind: 'text' };
+            return { type: 'text' };
     }
 };
 const walkFromShape = (key, rawSchema) => {
     const { inner, optional } = unwrap(rawSchema);
-    return { key, label: toLabel(key), optional, ...kindFor(inner) };
+    // A `v.title(…)` label wins over the key-derived one; the title may ride
+    // the schema itself or sit inside an optional wrapper.
+    const label = titleOf(inner) ?? titleOf(rawSchema) ?? toLabel(key);
+    return { key, label, optional, ...typeFor(inner) };
 };
 const walkField = (key, rawSchema) => {
     if (!isValibotSchema(rawSchema)) {
-        return { key, label: toLabel(key), optional: false, kind: 'text' };
+        return { key, label: toLabel(key), optional: false, type: 'text' };
     }
     return walkFromShape(key, rawSchema);
 };
@@ -79,7 +105,7 @@ const walkField = (key, rawSchema) => {
  * Walk an object schema's `entries` into descriptor fields, omitting members
  * that carry no payload (see {@link isOmittedMember}). The single iteration
  * point shared by the top-level walk ({@link toEnrichmentFields}) and the
- * nested-object case in {@link kindFor}.
+ * nested-object case in {@link typeFor}.
  */
 const walkEntries = (entries) => Object.keys(entries)
     .filter(key => !isOmittedMember(entries[key]))
@@ -100,7 +126,7 @@ const walkEntries = (entries) => Object.keys(entries)
  * umbrella yields `[]`.
  *
  * Generally callers should prefer {@link toEnrichmentDescriptor}, which
- * takes a generator entry and fills in `generator` / `appliesTo`
+ * takes a generator entry and fills in `generator` / `subjectType`
  * automatically. This lower-level entry point is useful in tests and
  * when only the field shape is needed.
  */
@@ -112,21 +138,19 @@ export const toEnrichmentFields = (schema) => {
         return [];
     return walkEntries(inner.entries);
 };
-const toAppliesTo = (entryType) => {
+const toSubjectType = (entryType) => {
     switch (entryType) {
         case 'model':
             return 'model';
         case 'oasOperation':
         case 'gqlOperation':
             return 'operation';
-        // STOPGAP: a webhook is operation-shaped (method + responses), so its
-        // enrichment editor reuses the 'operation' context for now. A dedicated
-        // 'webhook' TargetKind would be more truthful but ripples into the
-        // skmtc-hub TypeSpec contract that TargetKind/appliesTo mirror — deferred
-        // to a coordinated change. (Was an uncovered gap: WebhookConfig joined the
-        // GeneratorConfig union without a toAppliesTo arm.)
+        // A webhook resembles an operation (a path-item keyed by HTTP method) but
+        // is a DISTINCT subject: it is addressed by webhook name, not request path,
+        // and has no request URL. It is its own SubjectType so the editor and the
+        // hub treat it truthfully rather than conflating it with an operation.
         case 'webhook':
-            return 'operation';
+            return 'webhook';
         default: {
             const _exhaustive = entryType;
             throw new Error(`Unhandled generator entry type: ${String(_exhaustive)}`);
@@ -137,8 +161,9 @@ const toAppliesTo = (entryType) => {
  * Project a generator entry's enrichment schema into a serialisable
  * `EnrichmentDescriptor` the CMS can render as a form. The entry's
  * `id` becomes `descriptor.generator`; its `type` discriminator maps
- * to `appliesTo` (`'oasOperation' | 'gqlOperation'` → `'operation'`;
- * `'model'` → `'model'`). If the entry has no `toEnrichmentSchema`, or
+ * to `subjectType` (`'oasOperation' | 'gqlOperation'` → `'operation'`;
+ * `'webhook'` → `'webhook'`; `'model'` → `'model'`). If the entry has no
+ * `toEnrichmentSchema`, or
  * declares the empty umbrella, the descriptor has an empty `fields`
  * array — the UI hides the section, matching the engine's "no
  * enrichments" behaviour.
@@ -152,6 +177,7 @@ const toAppliesTo = (entryType) => {
  */
 export const toEnrichmentDescriptor = (entry) => ({
     generator: entry.id,
-    appliesTo: toAppliesTo(entry.type),
+    subjectType: toSubjectType(entry.type),
+    supportsVariant: entry.supportsVariant(),
     fields: toEnrichmentFields(entry.toEnrichmentSchema?.())
 });

package/esm/enrichments/validateConfig.d.ts

@@ -13,7 +13,7 @@ export type EnrichmentValidationScope = 'subject' | 'generator' | 'stack';
  *
  *  - **operation subject** — `subject` = path, `method` = HTTP method
  *  - **model subject** — `subject` = refName (no `method`)
- *  - **gql operation subject** — `subject` = field name, `method` = root kind
+ *  - **gql operation subject** — `subject` = field name, `method` = root type
  *  - **generator** run-constant — `scope: 'generator'` (no subject routing)
  *  - **stack** run-constant — `scope: 'stack'` (no subject routing)
  *

package/esm/enrichments/validateConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateConfig.d.ts","sourceRoot":"","sources":["../../src/enrichments/validateConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEnE;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,yBAAyB,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,oBAAoB,GAAG,SAAS,EAC7C,SAAS,SAAS,gBAAgB,EAAE,KACnC,yBAAyB,EA6C3B,CAAA"}
+{"version":3,"file":"validateConfig.d.ts","sourceRoot":"","sources":["../../src/enrichments/validateConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEnE;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,yBAAyB,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAuID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,oBAAoB,GAAG,SAAS,EAC7C,SAAS,SAAS,gBAAgB,EAAE,KACnC,yBAAyB,EA+C3B,CAAA"}

package/esm/enrichments/validateConfig.js

@@ -10,10 +10,10 @@ const fieldPath = (path) => path && path.length > 1
     : undefined;
 /**
  * Collect every `{ subject, method?, variant, values }` leaf from a
- * generator's enrichment slot, walking the routing depth its **kind**
+ * generator's enrichment slot, walking the routing depth its **type**
  * dictates — model (`refName → variant`), oas operation
  * (`path → method → variant`), gql operation
- * (`rootKind → fieldName → variant`). Because the kind is read from the
+ * (`rootKind → fieldName → variant`). Because the type is read from the
  * generator entry, operation-vs-model is known authoritatively — there is
  * no `'main' in value` shape-guessing. Reserved keys (`_generator`) are
  * skipped; malformed nodes are skipped (they surface elsewhere, never here

package/esm/gql/_helpers/unwrapType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unwrapType.d.ts","sourceRoot":"","sources":["../../../src/gql/_helpers/unwrapType.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAGtB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAA;IACvB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAA;IACtB,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,WAAW,KAAG,aA2C9C,CAAA"}
+{"version":3,"file":"unwrapType.d.ts","sourceRoot":"","sources":["../../../src/gql/_helpers/unwrapType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAA6B,MAAM,SAAS,CAAA;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAA;IACvB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAA;IACtB,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,WAAW,KAAG,aA2C9C,CAAA"}

package/esm/gql/enum/toEnumType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toEnumType.d.ts","sourceRoot":"","sources":["../../../src/gql/enum/toEnumType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GAAI,6CAKxB,cAAc,KAAG,SAanB,CAAA"}
+{"version":3,"file":"toEnumType.d.ts","sourceRoot":"","sources":["../../../src/gql/enum/toEnumType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GAAI,6CAKxB,cAAc,KAAG,SAenB,CAAA"}

package/esm/gql/field/toFieldSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toFieldSchema.d.ts","sourceRoot":"","sources":["../../../src/gql/field/toFieldSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAU1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAOlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,+BAI3B,iBAAiB,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CA+EjD,CAAA"}
+{"version":3,"file":"toFieldSchema.d.ts","sourceRoot":"","sources":["../../../src/gql/field/toFieldSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAU1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAOlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,+BAI3B,iBAAiB,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAoFjD,CAAA"}

package/esm/gql/input/toInputType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toInputType.d.ts","sourceRoot":"","sources":["../../../src/gql/input/toInputType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,sBAAsB,CAAA;IACjC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,oCAIzB,eAAe,KAAG,SAiCpB,CAAA"}
+{"version":3,"file":"toInputType.d.ts","sourceRoot":"","sources":["../../../src/gql/input/toInputType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,sBAAsB,CAAA;IACjC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,oCAAoC,eAAe,KAAG,SAmCjF,CAAA"}

package/esm/gql/interface/toInterfaceUnion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toInterfaceUnion.d.ts","sourceRoot":"","sources":["../../../src/gql/interface/toInterfaceUnion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAKnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,oBAAoB,CAAA;IACnC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAAI,wCAI9B,oBAAoB,KAAG,QAyBzB,CAAA"}
+{"version":3,"file":"toInterfaceUnion.d.ts","sourceRoot":"","sources":["../../../src/gql/interface/toInterfaceUnion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAKnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,oBAAoB,CAAA;IACnC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAAI,wCAI9B,oBAAoB,KAAG,QA2BzB,CAAA"}

package/esm/gql/object/toObjectType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toObjectType.d.ts","sourceRoot":"","sources":["../../../src/gql/object/toObjectType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,iBAAiB,GAAG,oBAAoB,CAAA;IACpD,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,qCAI1B,gBAAgB,KAAG,SAwDrB,CAAA"}
+{"version":3,"file":"toObjectType.d.ts","sourceRoot":"","sources":["../../../src/gql/object/toObjectType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAKtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,iBAAiB,GAAG,oBAAoB,CAAA;IACpD,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,qCAAqC,gBAAgB,KAAG,SA0DpF,CAAA"}

package/esm/gql/operation/toRootField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toRootField.d.ts","sourceRoot":"","sources":["../../../src/gql/operation/toRootField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,SAAS,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,EAAE,gBAAgB,CAAA;IACzB;;;;;;OAMG;IACH,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,0CAKzB,eAAe,KAAG,YAyDpB,CAAA"}
+{"version":3,"file":"toRootField.d.ts","sourceRoot":"","sources":["../../../src/gql/operation/toRootField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,SAAS,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,EAAE,gBAAgB,CAAA;IACzB;;;;;;OAMG;IACH,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,0CAKzB,eAAe,KAAG,YA4DpB,CAAA"}

package/esm/gql/union/toUnionType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toUnionType.d.ts","sourceRoot":"","sources":["../../../src/gql/union/toUnionType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAKnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,gBAAgB,CAAA;IAC3B,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,oCAIzB,eAAe,KAAG,QAuBpB,CAAA"}
+{"version":3,"file":"toUnionType.d.ts","sourceRoot":"","sources":["../../../src/gql/union/toUnionType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAKnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,gBAAgB,CAAA;IAC3B,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,oCAAoC,eAAe,KAAG,QAyBjF,CAAA"}

package/esm/helpers/applyGeneratedSuffix.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The filename suffix marking a file as engine-owned, applied by the
+ * engine when a projection's `toExportPath` result is stored into
+ * `ContentSettings` (see `GenerateContext.to*ContentSettings`).
+ * Consumers override it per project via
+ * `client.json#settings.generatedSuffix`; setting it to `''` disables
+ * injection entirely.
+ */
+export declare const DEFAULT_GENERATED_SUFFIX = ".generated";
+/**
+ * Inserts the generated-file suffix into an export path, before the
+ * file extension: `@/forms/CreateForm.tsx` →
+ * `@/forms/CreateForm.generated.tsx`.
+ *
+ * Idempotent: a path that already carries the suffix is returned
+ * unchanged, so generators that predate central injection (they
+ * hardcode `.generated` in `toExportPath`) keep producing byte-identical
+ * paths. New generators return suffix-less paths and let the engine
+ * inject.
+ *
+ * Rules:
+ * - `suffix === ''` → path returned unchanged (project-level opt-out).
+ * - A suffix without a leading dot is normalized to have one, so a
+ *   config value of `"gen"` cannot false-positive on names that merely
+ *   end in `gen`.
+ * - The extension is the final `.`-segment (`extname`): a dotted stem
+ *   keeps its dots (`user.model.tsx` → `user.model.generated.tsx`).
+ *   Multi-part extensions are not special-cased (`user.d.ts` →
+ *   `user.d.generated.ts`) — generated declaration files are rare and
+ *   the rule stays predictable.
+ * - No extension → the suffix is appended (`Makefile` →
+ *   `Makefile.generated`).
+ */
+export declare const applyGeneratedSuffix: (path: string, suffix: string) => string;
+/**
+ * The inverse of {@link applyGeneratedSuffix}: removes the
+ * generated-file suffix from an export path
+ * (`@/forms/CreateForm.generated.tsx` → `@/forms/CreateForm.tsx`).
+ * A path without the suffix is returned unchanged. Used by the eject
+ * flow to compute the owned name of a generated file.
+ */
+export declare const removeGeneratedSuffix: (path: string, suffix: string) => string;
+//# sourceMappingURL=applyGeneratedSuffix.d.ts.map

package/esm/helpers/applyGeneratedSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyGeneratedSuffix.d.ts","sourceRoot":"","sources":["../../src/helpers/applyGeneratedSuffix.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MA0BnE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAwBpE,CAAA"}

package/esm/helpers/applyGeneratedSuffix.js

@@ -0,0 +1,79 @@
+import { extname } from '../deps/jsr.io/@std/path/1.1.6/extname.js';
+/**
+ * The filename suffix marking a file as engine-owned, applied by the
+ * engine when a projection's `toExportPath` result is stored into
+ * `ContentSettings` (see `GenerateContext.to*ContentSettings`).
+ * Consumers override it per project via
+ * `client.json#settings.generatedSuffix`; setting it to `''` disables
+ * injection entirely.
+ */
+export const DEFAULT_GENERATED_SUFFIX = '.generated';
+/**
+ * Inserts the generated-file suffix into an export path, before the
+ * file extension: `@/forms/CreateForm.tsx` →
+ * `@/forms/CreateForm.generated.tsx`.
+ *
+ * Idempotent: a path that already carries the suffix is returned
+ * unchanged, so generators that predate central injection (they
+ * hardcode `.generated` in `toExportPath`) keep producing byte-identical
+ * paths. New generators return suffix-less paths and let the engine
+ * inject.
+ *
+ * Rules:
+ * - `suffix === ''` → path returned unchanged (project-level opt-out).
+ * - A suffix without a leading dot is normalized to have one, so a
+ *   config value of `"gen"` cannot false-positive on names that merely
+ *   end in `gen`.
+ * - The extension is the final `.`-segment (`extname`): a dotted stem
+ *   keeps its dots (`user.model.tsx` → `user.model.generated.tsx`).
+ *   Multi-part extensions are not special-cased (`user.d.ts` →
+ *   `user.d.generated.ts`) — generated declaration files are rare and
+ *   the rule stays predictable.
+ * - No extension → the suffix is appended (`Makefile` →
+ *   `Makefile.generated`).
+ */
+export const applyGeneratedSuffix = (path, suffix) => {
+    if (suffix === '') {
+        return path;
+    }
+    const dottedSuffix = suffix.startsWith('.') ? suffix : `.${suffix}`;
+    const extension = extname(path);
+    // A trailing suffix IS the extension for extension-less names that
+    // were already suffixed (`Makefile.generated`).
+    if (extension === dottedSuffix) {
+        return path;
+    }
+    if (extension === '') {
+        return `${path}${dottedSuffix}`;
+    }
+    const stem = path.slice(0, -extension.length);
+    if (stem.endsWith(dottedSuffix)) {
+        return path;
+    }
+    return `${stem}${dottedSuffix}${extension}`;
+};
+/**
+ * The inverse of {@link applyGeneratedSuffix}: removes the
+ * generated-file suffix from an export path
+ * (`@/forms/CreateForm.generated.tsx` → `@/forms/CreateForm.tsx`).
+ * A path without the suffix is returned unchanged. Used by the eject
+ * flow to compute the owned name of a generated file.
+ */
+export const removeGeneratedSuffix = (path, suffix) => {
+    if (suffix === '') {
+        return path;
+    }
+    const dottedSuffix = suffix.startsWith('.') ? suffix : `.${suffix}`;
+    const extension = extname(path);
+    if (extension === dottedSuffix) {
+        return path.slice(0, -dottedSuffix.length);
+    }
+    if (extension === '') {
+        return path;
+    }
+    const stem = path.slice(0, -extension.length);
+    if (stem.endsWith(dottedSuffix)) {
+        return `${stem.slice(0, -dottedSuffix.length)}${extension}`;
+    }
+    return path;
+};

package/esm/helpers/isImported.js

@@ -1,4 +1,4 @@
-import { normalize } from '../deps/jsr.io/@std/path/1.1.4/normalize.js';
+import { normalize } from '../deps/jsr.io/@std/path/1.1.6/normalize.js';
 /**
  * Determines whether two file paths represent different locations (import required).
  *

package/esm/helpers/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/helpers/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAExC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAE1C,CAAA;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,oCAAmC,gBAAqB,KAAG,MA+BjG,CAAA"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/helpers/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAExC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAE1C,CAAA;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,oCAAmC,gBAAqB,KACvD,MA+BF,CAAA"}

package/esm/helpers/toResolvedArtifactPath.js

@@ -60,7 +60,7 @@
  * @module toResolvedArtifactPath
  */
 import "../_dnt.polyfills.js";
-import { join } from '../deps/jsr.io/@std/path/1.1.4/join.js';
+import { join } from '../deps/jsr.io/@std/path/1.1.6/join.js';
 /**
  * Resolves artifact destination paths relative to a base directory.
  *

package/esm/mod.d.ts

@@ -83,6 +83,7 @@ export * from './dsl/CodeFileBase.js';
 export * from './dsl/ImportBase.js';
 export * from './dsl/ReExportBase.js';
 export * from './dsl/JsonFile.js';
+export * from './dsl/MarkdownFile.js';
 export * from './dsl/GeneratedValueList.js';
 export * from './dsl/IdentifierBase.js';
 export * from './dsl/IdentifierType.js';
@@ -116,6 +117,7 @@ export * from './helpers/parseModuleName.js';
 export * from './helpers/toResolvedArtifactPath.js';
 export * from './helpers/withVariant.js';
 export * from './helpers/toVariantList.js';
+export * from './helpers/applyGeneratedSuffix.js';
 export * from './context/StackTrail.js';
 export * from './oas/array/Array.js';
 export * from './oas/array/array-types.js';
@@ -132,6 +134,8 @@ export * from './oas/document/Document.js';
 export * from './oas/example/Example.js';
 export * from './oas/example/example-types.js';
 export * from './oas/header/Header.js';
+export * from './oas/link/Link.js';
+export * from './oas/externalDocs/ExternalDocs.js';
 export * from './oas/info/Info.js';
 export * from './oas/info/info-types.js';
 export * from './oas/license/License.js';
@@ -157,6 +161,7 @@ export * from './parse/v3-0/ref/toRefV31.js';
 export * from './oas/requestBody/RequestBody.js';
 export * from './oas/response/Response.js';
 export * from './oas/schema/Schema.js';
+export * from './oas/schemaPath/traverseSchema.js';
 export * from './parse/v3-0/schema/toSchemasV3.js';
 export * from './oas/securityRequirement/SecurityRequirement.js';
 export * from './oas/securitySchemes/SecurityScheme.js';
@@ -174,6 +179,7 @@ export * from './oas/unknown/unknown-types.js';
 export * from './parse/v3-0/unknown/toUnknown.js';
 export * from './oas/void/Void.js';
 export * from './run/toArtifacts.js';
+export * from './run/toInspection.js';
 export * from './run/toSupportedSubjects.js';
 export type * from './types/SupportedSubjects.js';
 export * from './run/toEnrichmentDefaults.js';
@@ -190,7 +196,8 @@ export * from './types/Manifest.js';
 export * from './types/Method.js';
 export * from './types/Modifiers.js';
 export * from './types/ModuleExport.js';
-export * from './types/AccessorPath.js';
+export * from './types/ModuleSelect.js';
+export * from './types/SchemaPath.js';
 export * from './enrichments/toEnrichmentDescriptor.js';
 export * from './enrichments/validateConfig.js';
 export * from './enrichments/readEnrichments.js';