@skmtc/core 0.0.983 → 0.16.1

package/script/types/AccessorPath.d.ts

@@ -0,0 +1,17 @@
+import * as v from 'valibot';
+/**
+ * A path of property names into a parsed schema document — e.g.
+ * `['customer', 'primaryAddress', 'type']` to reach the nested
+ * `type` property. Generators that overlay per-field enrichments
+ * key those overlays by accessor path.
+ */
+export type AccessorPath = string[];
+/**
+ * Canonical Valibot schema for an `AccessorPath`. Generators should
+ * import this rather than write `v.array(v.string())` inline — the
+ * descriptor walker identity-matches the exported value and emits a
+ * schema-aware path-picker widget (`kind: "accessorPath"`) instead of
+ * a generic array of strings.
+ */
+export declare const accessorPath: v.GenericSchema<AccessorPath>;
+//# sourceMappingURL=AccessorPath.d.ts.map

package/script/types/AccessorPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessorPath.d.ts","sourceRoot":"","sources":["../../src/types/AccessorPath.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,EAAE,CAAA;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAAuB,CAAA"}

package/script/types/AccessorPath.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accessorPath = void 0;
+const v = __importStar(require("valibot"));
+/**
+ * Canonical Valibot schema for an `AccessorPath`. Generators should
+ * import this rather than write `v.array(v.string())` inline — the
+ * descriptor walker identity-matches the exported value and emits a
+ * schema-aware path-picker widget (`kind: "accessorPath"`) instead of
+ * a generic array of strings.
+ */
+exports.accessorPath = v.array(v.string());

package/script/types/AttributionState.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Attribution (gen-maps) **emission** config.
+ *
+ * Attribution *capture* is always on and needs no configuration — it is
+ * intrinsic to the pipeline:
+ *
+ * - **Parse phase**: every parsed OAS / GQL node snapshots the visitor's
+ *   `StackTrail` into its `OasBase` base (`toLocation()` → JSON Pointer).
+ * - **Generate phase**: every `SnippetBase` instance wraps its
+ *   `toString` to capture parent/child edges via a render stack, so
+ *   the post-render span resolver can attribute byte ranges to producers.
+ *
+ * This type configures only **emission**: it is supplied at the run level
+ * (`CoreContext.toArtifacts`) and consumed solely by the post-render
+ * pass. The parse and generate contexts do not carry it, because capture
+ * is unconditional. Without `postPass` you still get capture but no
+ * on-disk output; setting `postPass` activates the pass and surfaces
+ * `sidecars` / `generationMap` on the result.
+ */
+import type { ParserAdapter } from '../anchors/ParserAdapter.js';
+import type { GeneratorMetaLookup } from '../anchors/postPass.js';
+export type AttributionPostPassConfig = {
+    /**
+     * Parser adapter used to resolve landmarks + AST paths. Optional —
+     * when omitted, the post-pass falls back to using the enclosing
+     * Definition's identifier as the landmark and emits an empty AST
+     * path. Sidecars still carry byte ranges, attributions, generators,
+     * schema pointers, and variants. The worker-side pipeline runs
+     * without a parser because native parsers don't bundle cleanly
+     * via `deno bundle`; a host-side post-pass can re-run with a
+     * parser later when full AST data is needed.
+     */
+    parser?: ParserAdapter;
+    /**
+     * Schema source identifier — typically the path or URL the producer
+     * ran against (e.g. `'openapi.json'`). Lands on each sidecar's
+     * `src` field so re-anchor consumers know which schema produced
+     * the file.
+     */
+    schemaSrc: string;
+    /**
+     * Per-generator metadata lookup. The CLI builds this from the
+     * project's `deno.json` + lockfile and threads it in. When absent,
+     * generator entries land with empty version + a `jsr.io` registry.
+     */
+    generatorMeta?: GeneratorMetaLookup;
+};
+export type AttributionState = {
+    postPass?: AttributionPostPassConfig;
+};
+//# sourceMappingURL=AttributionState.d.ts.map

package/script/types/AttributionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributionState.d.ts","sourceRoot":"","sources":["../../src/types/AttributionState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,yBAAyB,CAAA;CACrC,CAAA"}

package/script/types/AttributionState.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Attribution (gen-maps) **emission** config.
+ *
+ * Attribution *capture* is always on and needs no configuration — it is
+ * intrinsic to the pipeline:
+ *
+ * - **Parse phase**: every parsed OAS / GQL node snapshots the visitor's
+ *   `StackTrail` into its `OasBase` base (`toLocation()` → JSON Pointer).
+ * - **Generate phase**: every `SnippetBase` instance wraps its
+ *   `toString` to capture parent/child edges via a render stack, so
+ *   the post-render span resolver can attribute byte ranges to producers.
+ *
+ * This type configures only **emission**: it is supplied at the run level
+ * (`CoreContext.toArtifacts`) and consumed solely by the post-render
+ * pass. The parse and generate contexts do not carry it, because capture
+ * is unconditional. Without `postPass` you still get capture but no
+ * on-disk output; setting `postPass` activates the pass and surfaces
+ * `sidecars` / `generationMap` on the result.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/types/Brand.d.ts

@@ -48,6 +48,7 @@
  *
  * @internal
  */
+import "../_dnt.polyfills.js";
 declare const brand: unique symbol;
 /**
  * Creates a branded type from a base type.
@@ -91,8 +92,8 @@ declare const brand: unique symbol;
  * const schemaRef: RefName = 'User' as RefName;
  *
  * // GeneratorKey ensures generator identification safety
- * type OperationGeneratorKey = Brand<string, 'OperationGeneratorKey'>;
- * const opKey: OperationGeneratorKey = 'api-client|/users|get' as OperationGeneratorKey;
+ * type OasOperationGeneratorKey = Brand<string, 'OasOperationGeneratorKey'>;
+ * const opKey: OasOperationGeneratorKey = 'api-client|/users|get' as OasOperationGeneratorKey;
  * ```
  *
  * @example Runtime behavior

package/script/types/Brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../src/types/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;GAQG;AACH,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}
+{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../src/types/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;GAQG;AACH,OAAO,sBAAsB,CAAC;AAE9B,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/script/types/Brand.js

@@ -41,3 +41,13 @@
  * @module Brand
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Unique symbol used for branding types.
+ *
+ * This symbol is used internally by the {@link Brand} type to create
+ * unique branded types that are structurally identical but nominally
+ * distinct from their base types.
+ *
+ * @internal
+ */
+require("../_dnt.polyfills.js");

package/script/types/DenoJson.d.ts

@@ -1,3 +1,4 @@
+import "../_dnt.polyfills.js";
 import * as v from 'valibot';
 /**
  * Valibot schema for root-level deno.json configuration files.

package/script/types/DenoJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DenoJson.d.ts","sourceRoot":"","sources":["../../src/types/DenoJson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAIrD,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAK3D,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;CACzC,CAAA"}
+{"version":3,"file":"DenoJson.d.ts","sourceRoot":"","sources":["../../src/types/DenoJson.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAIrD,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAK3D,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;CACzC,CAAA"}

package/script/types/DenoJson.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageDenoJson = exports.rootDenoJson = void 0;
+require("../_dnt.polyfills.js");
 const v = __importStar(require("valibot"));
 /**
  * Valibot schema for root-level deno.json configuration files.

package/script/types/EnrichmentDefaults.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The seed enrichment values each generator derives from a document — the
+ * "Generate fields from schema" payload the CMS persists and the user then
+ * edits.
+ *
+ * Produced by calling every generator's `toEnrichmentDefaults` over the parsed
+ * document's supported operations / models (the subject-scope leaf of the
+ * returned umbrella). Unlike {@link SupportedSubjects} this is the *values*, not
+ * the capability set: only generators that advertise `toEnrichmentDefaults`
+ * appear, and only the subjects for which a non-`undefined` default is computed.
+ *
+ * The shape mirrors the `client.json#settings.enrichments` subtree so a host
+ * can fold it straight into settings (subject scope only — the run-constant
+ * `_generator` / `_stack` scopes are out of scope for seeding):
+ *  - operation generator: `[id][path][method][variant] = values`
+ *  - model generator:     `[id][refName][variant] = values`
+ *
+ * `variant` is always `'main'` — seeding targets the default variant; existing
+ * named variants keep their own authored values.
+ */
+/** A subject's default enrichment leaf — opaque to the engine (the generator's
+ *  subject-scope enrichment values, e.g. `{ fields, title }`). */
+export type EnrichmentDefaultsLeaf = Record<string, unknown>;
+/** Operation generator defaults: `path -> method -> variant -> leaf`. */
+export type OperationEnrichmentDefaults = Record<string, Record<string, Record<string, EnrichmentDefaultsLeaf>>>;
+/** Webhook generator defaults: `name -> method -> variant -> leaf` (mirrors
+ *  the operation shape with the webhook name in the `path` slot). */
+export type WebhookEnrichmentDefaults = Record<string, Record<string, Record<string, EnrichmentDefaultsLeaf>>>;
+/** Model generator defaults: `refName -> variant -> leaf`. */
+export type ModelEnrichmentDefaults = Record<string, Record<string, EnrichmentDefaultsLeaf>>;
+/** Generator id → the default enrichment values that generator seeds. */
+export type EnrichmentDefaults = Record<string, OperationEnrichmentDefaults | WebhookEnrichmentDefaults | ModelEnrichmentDefaults>;
+//# sourceMappingURL=EnrichmentDefaults.d.ts.map

package/script/types/EnrichmentDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnrichmentDefaults.d.ts","sourceRoot":"","sources":["../../src/types/EnrichmentDefaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;kEACkE;AAClE,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE5D,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CACvD,CAAA;AAED;qEACqE;AACrE,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAC5C,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CACvD,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAA;AAE5F,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACrC,MAAM,EACN,2BAA2B,GAAG,yBAAyB,GAAG,uBAAuB,CAClF,CAAA"}

package/script/types/EnrichmentDefaults.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * The seed enrichment values each generator derives from a document — the
+ * "Generate fields from schema" payload the CMS persists and the user then
+ * edits.
+ *
+ * Produced by calling every generator's `toEnrichmentDefaults` over the parsed
+ * document's supported operations / models (the subject-scope leaf of the
+ * returned umbrella). Unlike {@link SupportedSubjects} this is the *values*, not
+ * the capability set: only generators that advertise `toEnrichmentDefaults`
+ * appear, and only the subjects for which a non-`undefined` default is computed.
+ *
+ * The shape mirrors the `client.json#settings.enrichments` subtree so a host
+ * can fold it straight into settings (subject scope only — the run-constant
+ * `_generator` / `_stack` scopes are out of scope for seeding):
+ *  - operation generator: `[id][path][method][variant] = values`
+ *  - model generator:     `[id][refName][variant] = values`
+ *
+ * `variant` is always `'main'` — seeding targets the default variant; existing
+ * named variants keep their own authored values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/types/EnrichmentRequest.d.ts

@@ -51,6 +51,7 @@
  *
  * @module EnrichmentRequest
  */
+import "../_dnt.polyfills.js";
 import type * as v from 'valibot';
 /**
  * Represents a request for enrichment data during code generation.

package/script/types/EnrichmentRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnrichmentRequest.d.ts","sourceRoot":"","sources":["../../src/types/EnrichmentRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAEjC;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}
+{"version":3,"file":"EnrichmentRequest.d.ts","sourceRoot":"","sources":["../../src/types/EnrichmentRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAEjC;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/script/types/EnrichmentRequest.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * @fileoverview Enrichment Request System for SKMTC Core
  *
@@ -52,4 +53,4 @@
  *
  * @module EnrichmentRequest
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+require("../_dnt.polyfills.js");