@nekostack/schema 1.0.0

package/dist/src/generators/json-schema-meta.js

@@ -0,0 +1,35 @@
+/**
+ * Codified `x-nekostack-*` extension keys used by the JSON Schema generator.
+ *
+ * These are the contract; any new extension key the generator emits must
+ * land here first. Stringly-typed extensions in the generator body would
+ * make typos and drift easy — the constants make both the spelling and the
+ * meaning grep-able.
+ *
+ * See [`docs/JSON_SCHEMA_MAPPING.md`](../../docs/JSON_SCHEMA_MAPPING.md) for
+ * the per-key contract: when each is emitted, what it means, and what
+ * NekoStack-aware consumers should do with it.
+ */
+export const JSON_SCHEMA_EXTENSIONS = {
+    /**
+     * Top-level provenance object: `{ generator, generatorVersion, irHash,
+     * schemaId, schemaVersion }`. Replaces the v0.2-style JSDoc header since
+     * JSON has no comment syntax.
+     */
+    provenance: "x-nekostack",
+    /**
+     * Tag on a node carrying `default()`: signals that JSON Schema validators
+     * will NOT apply the default (it's annotation only); the NekoStack runtime
+     * (or the generated Zod) is responsible. Value is the literal string
+     * `"runtime"`.
+     */
+    defaultAppliedBy: "x-nekostack-default-applied-by",
+    /**
+     * Tag on an object whose unknown-key policy is `stripUnknown`: signals
+     * that the schema accepts unknown keys (`additionalProperties: true`)
+     * and that NekoStack-aware runtime/CLI consumers should strip them.
+     * JSON Schema cannot express mutation; this is the bridge.
+     */
+    strip: "x-nekostack-strip",
+};
+//# sourceMappingURL=json-schema-meta.js.map

package/dist/src/generators/json-schema-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-meta.js","sourceRoot":"","sources":["../../../src/generators/json-schema-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;;;;OAIG;IACH,UAAU,EAAE,aAAa;IAEzB;;;;;OAKG;IACH,gBAAgB,EAAE,gCAAgC;IAElD;;;;;OAKG;IACH,KAAK,EAAE,mBAAmB;CAClB,CAAC"}

package/dist/src/generators/json-schema.d.ts

@@ -0,0 +1,26 @@
+import type { SchemaNode } from "../ir/nodes.js";
+import type { JsonSchemaGeneratorOptions } from "./types.js";
+/**
+ * Generate a JSON Schema **draft 2020-12** document from a `SchemaNode`.
+ *
+ * v0.4: refactored to a thin root wrapper that delegates the IR-to-fragment
+ * translation to {@link emitSchemaFragment}. The wrapper owns:
+ *  - `$schema` (draft 2020-12 URL)
+ *  - `$id` strategy (URN by default; URL via `options.idBase`)
+ *  - `x-nekostack` provenance with `generator: "jsonSchema"`
+ *  - Canonical serialization + trailing newline
+ *
+ * The wrapper does NOT own: absence semantics, object policy, portable
+ * refinements, runtime-refinement / regex-with-flags throws, canonical
+ * key sort. Those live in [`schema-fragment.ts`](./schema-fragment.ts) and
+ * are shared with the OpenAPI generator (v0.4+). See
+ * [`docs/JSON_SCHEMA_MAPPING.md`](../../docs/JSON_SCHEMA_MAPPING.md) for
+ * the contract.
+ *
+ * Throws `UnsupportedNodeKindError({ ..., generator: "jsonSchema" })`
+ * (Invariant 7) for: IR kinds without v0.3 mapping (`date` / `union` /
+ * `recursiveRef` / `transform`), runtime refinements, and regex with
+ * non-empty flags.
+ */
+export declare function generateJsonSchema(node: SchemaNode, options?: JsonSchemaGeneratorOptions): string;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/src/generators/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../../src/generators/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAWR"}

package/dist/src/generators/json-schema.js

@@ -0,0 +1,88 @@
+import { irHash } from "../ir/hash.js";
+import { GENERATOR_VERSION } from "./version.js";
+import { JSON_SCHEMA_EXTENSIONS } from "./json-schema-meta.js";
+import { canonicalize, emitSchemaFragment, } from "./schema-fragment.js";
+/**
+ * Generate a JSON Schema **draft 2020-12** document from a `SchemaNode`.
+ *
+ * v0.4: refactored to a thin root wrapper that delegates the IR-to-fragment
+ * translation to {@link emitSchemaFragment}. The wrapper owns:
+ *  - `$schema` (draft 2020-12 URL)
+ *  - `$id` strategy (URN by default; URL via `options.idBase`)
+ *  - `x-nekostack` provenance with `generator: "jsonSchema"`
+ *  - Canonical serialization + trailing newline
+ *
+ * The wrapper does NOT own: absence semantics, object policy, portable
+ * refinements, runtime-refinement / regex-with-flags throws, canonical
+ * key sort. Those live in [`schema-fragment.ts`](./schema-fragment.ts) and
+ * are shared with the OpenAPI generator (v0.4+). See
+ * [`docs/JSON_SCHEMA_MAPPING.md`](../../docs/JSON_SCHEMA_MAPPING.md) for
+ * the contract.
+ *
+ * Throws `UnsupportedNodeKindError({ ..., generator: "jsonSchema" })`
+ * (Invariant 7) for: IR kinds without v0.3 mapping (`date` / `union` /
+ * `recursiveRef` / `transform`), runtime refinements, and regex with
+ * non-empty flags.
+ */
+export function generateJsonSchema(node, options = {}) {
+    const body = emitSchemaFragment(node, { generator: "jsonSchema" });
+    const idBlock = emitRootIdBlock(node, options);
+    const provenance = emitProvenance(node, options.sourceHash);
+    const root = {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        ...idBlock,
+        ...body,
+        ...provenance,
+    };
+    return JSON.stringify(canonicalize(root), null, 2) + "\n";
+}
+// ---------- root-level provenance + identity ----------
+/**
+ * v0.3 placed provenance under a single `x-nekostack` extension object so
+ * it doesn't pollute the top-level JSON Schema namespace and is easy for
+ * downstream tooling to read or strip. Mirrors the v0.2 JSDoc header
+ * concept, adapted for a comment-less format.
+ *
+ * v0.7 adds `sourceHash` as an optional field. When the caller passes
+ * `options.sourceHash`, the field appears in the `x-nekostack` block;
+ * when omitted, the field is absent entirely (Master plan Decision #8 —
+ * NOT emitted as `null`). `canonicalize` drops `undefined` values, so
+ * setting the field to `undefined` here is equivalent to omitting it
+ * from the output JSON.
+ */
+function emitProvenance(node, sourceHash) {
+    return {
+        [JSON_SCHEMA_EXTENSIONS.provenance]: {
+            generator: "jsonSchema",
+            generatorVersion: GENERATOR_VERSION,
+            irHash: `sha256:${irHash(node)}`,
+            ...(sourceHash !== undefined ? { sourceHash } : {}),
+            schemaId: node.metadata?.id ?? null,
+            schemaVersion: node.metadata?.version ?? null,
+        },
+    };
+}
+function emitRootIdBlock(node, options) {
+    const id = node.metadata?.id;
+    if (!id)
+        return {}; // anonymous → no $id (Decision #3)
+    const version = node.metadata?.version;
+    return { $id: formatId(id, version, options) };
+}
+/**
+ * Decision #2: URN by default (`urn:nekostack:schema:<id>:<version>`).
+ * URL-shaped IDs are opt-in via `options.idBase`. If `version` is absent,
+ * emit the URN/URL without the trailing version segment.
+ */
+function formatId(id, version, options) {
+    if (options.idBase !== undefined) {
+        const base = options.idBase.replace(/\/+$/, "");
+        return version === undefined
+            ? `${base}/${id}`
+            : `${base}/${id}/${version}`;
+    }
+    return version === undefined
+        ? `urn:nekostack:schema:${id}`
+        : `urn:nekostack:schema:${id}:${version}`;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/src/generators/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../../src/generators/json-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAgB,EAChB,UAAsC,EAAE;IAExC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,8CAA8C;QACvD,GAAG,OAAO;QACV,GAAG,IAAI;QACP,GAAG,UAAU;KACd,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC;AAED,yDAAyD;AAEzD;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CACrB,IAAgB,EAChB,UAA0C;IAE1C,OAAO;QACL,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE;YACnC,SAAS,EAAE,YAAY;YACvB,gBAAgB,EAAE,iBAAiB;YACnC,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,EAAE;YAChC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI;YACnC,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;SAC9C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,IAAgB,EAChB,OAAmC;IAEnC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,mCAAmC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;IACvC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CACf,EAAU,EACV,OAA2B,EAC3B,OAAmC;IAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,OAAO,KAAK,SAAS;YAC1B,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE;YACjB,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,wBAAwB,EAAE,EAAE;QAC9B,CAAC,CAAC,wBAAwB,EAAE,IAAI,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/src/generators/openapi.d.ts

@@ -0,0 +1,33 @@
+import type { SchemaNode } from "../ir/nodes.js";
+import type { OpenApiGeneratorOptions } from "./types.js";
+/**
+ * Generate an **OpenAPI 3.1 Schema Component** from a `SchemaNode`.
+ *
+ * The output is the value that would live under `components.schemas.<Name>`
+ * in a full OpenAPI document — NOT the document itself. Composing it into
+ * paths / operations / responses / requestBodies / etc. is the consumer's
+ * job (or `@nekostack/api`'s when that package exists).
+ *
+ * Differences from {@link generateJsonSchema}:
+ *  - No `$schema` keyword — OpenAPI 3.1 documents declare the schema dialect
+ *    once at the document root via `jsonSchemaDialect`; component schemas
+ *    inherit it.
+ *  - No `$id` — component identity is the position in the document
+ *    (`#/components/schemas/<Name>`), per Decision #5.
+ *  - Provenance `generator: "openApi"`.
+ *
+ * The IR-to-fragment translation (absence semantics, object policy,
+ * portable refinements, `stripUnknown` extension, throw paths,
+ * canonicalization) is shared with the JSON Schema generator via
+ * [`schema-fragment.ts`](./schema-fragment.ts). See
+ * [`docs/JSON_SCHEMA_MAPPING.md`](../../docs/JSON_SCHEMA_MAPPING.md) for
+ * the shared contract and the (small) OpenAPI deltas in
+ * [`docs/OPENAPI_MAPPING.md`](../../docs/OPENAPI_MAPPING.md).
+ *
+ * Throws `UnsupportedNodeKindError({ ..., generator: "openApi" })` per
+ * Invariant 7 for: IR kinds without v0.3-style mapping (`date`, `union`,
+ * `recursiveRef`, `transform`), runtime refinements, and regex with
+ * non-empty flags.
+ */
+export declare function generateOpenApiSchemaComponent(node: SchemaNode, options?: OpenApiGeneratorOptions): string;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/src/generators/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/generators/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAQR"}

package/dist/src/generators/openapi.js

@@ -0,0 +1,61 @@
+import { irHash } from "../ir/hash.js";
+import { GENERATOR_VERSION } from "./version.js";
+import { JSON_SCHEMA_EXTENSIONS } from "./json-schema-meta.js";
+import { canonicalize, emitSchemaFragment, } from "./schema-fragment.js";
+/**
+ * Generate an **OpenAPI 3.1 Schema Component** from a `SchemaNode`.
+ *
+ * The output is the value that would live under `components.schemas.<Name>`
+ * in a full OpenAPI document — NOT the document itself. Composing it into
+ * paths / operations / responses / requestBodies / etc. is the consumer's
+ * job (or `@nekostack/api`'s when that package exists).
+ *
+ * Differences from {@link generateJsonSchema}:
+ *  - No `$schema` keyword — OpenAPI 3.1 documents declare the schema dialect
+ *    once at the document root via `jsonSchemaDialect`; component schemas
+ *    inherit it.
+ *  - No `$id` — component identity is the position in the document
+ *    (`#/components/schemas/<Name>`), per Decision #5.
+ *  - Provenance `generator: "openApi"`.
+ *
+ * The IR-to-fragment translation (absence semantics, object policy,
+ * portable refinements, `stripUnknown` extension, throw paths,
+ * canonicalization) is shared with the JSON Schema generator via
+ * [`schema-fragment.ts`](./schema-fragment.ts). See
+ * [`docs/JSON_SCHEMA_MAPPING.md`](../../docs/JSON_SCHEMA_MAPPING.md) for
+ * the shared contract and the (small) OpenAPI deltas in
+ * [`docs/OPENAPI_MAPPING.md`](../../docs/OPENAPI_MAPPING.md).
+ *
+ * Throws `UnsupportedNodeKindError({ ..., generator: "openApi" })` per
+ * Invariant 7 for: IR kinds without v0.3-style mapping (`date`, `union`,
+ * `recursiveRef`, `transform`), runtime refinements, and regex with
+ * non-empty flags.
+ */
+export function generateOpenApiSchemaComponent(node, options = {}) {
+    const body = emitSchemaFragment(node, { generator: "openApi" });
+    const provenance = emitProvenance(node, options.sourceHash);
+    const root = {
+        ...body,
+        ...provenance,
+    };
+    return JSON.stringify(canonicalize(root), null, 2) + "\n";
+}
+/**
+ * Same shape as the JSON Schema provenance block, but with
+ * `generator: "openApi"`. v0.7 adds the optional `sourceHash` field
+ * (Master plan Decision #8); when omitted, the field is absent
+ * entirely from the emitted JSON (`canonicalize` drops `undefined`).
+ */
+function emitProvenance(node, sourceHash) {
+    return {
+        [JSON_SCHEMA_EXTENSIONS.provenance]: {
+            generator: "openApi",
+            generatorVersion: GENERATOR_VERSION,
+            irHash: `sha256:${irHash(node)}`,
+            ...(sourceHash !== undefined ? { sourceHash } : {}),
+            schemaId: node.metadata?.id ?? null,
+            schemaVersion: node.metadata?.version ?? null,
+        },
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/src/generators/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../src/generators/openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,8BAA8B,CAC5C,IAAgB,EAChB,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG;QACX,GAAG,IAAI;QACP,GAAG,UAAU;KACd,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACrB,IAAgB,EAChB,UAA0C;IAE1C,OAAO;QACL,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE;YACnC,SAAS,EAAE,SAAS;YACpB,gBAAgB,EAAE,iBAAiB;YACnC,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,EAAE;YAChC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI;YACnC,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;SAC9C;KACF,CAAC;AACJ,CAAC"}

package/dist/src/generators/schema-fragment.d.ts

@@ -0,0 +1,55 @@
+import type { JsonValue, SchemaNode } from "../ir/nodes.js";
+/**
+ * Shared IR → JSON-Schema-shaped fragment emitter consumed by both
+ * `json-schema.ts` and `openapi.ts`.
+ *
+ * **Why this module exists** (Decision #3, v0.4 plan): OpenAPI 3.1 Schema
+ * Objects are explicitly aligned with JSON Schema draft 2020-12 — the spec
+ * calls them a superset. Each wrapper has its own root structure (`$schema`,
+ * `$id`, provenance generator name), but the IR → fragment translation
+ * itself is identical and must not be duplicated. Duplication would create
+ * a real drift vector: bug fixes would have to land twice, behavior could
+ * silently diverge.
+ *
+ * The wrappers own:
+ *  - Root document structure
+ *  - `$schema` / `$id` decisions
+ *  - Provenance `generator` field value
+ *
+ * This module owns:
+ *  - Primitive type mapping
+ *  - Array + object body mapping (including `required` array per absence semantics)
+ *  - Object unknown-key policy (including `x-nekostack-strip`)
+ *  - Portable refinement → keyword mapping
+ *  - Runtime-refinement and regex-with-flags throws (Invariant 7)
+ *  - Canonical key sort (`canonicalize`)
+ *
+ * Throw guards use the wrapper's generator name via `options.generator` so
+ * `UnsupportedNodeKindError` reports the right caller (`"jsonSchema"` vs
+ * `"openApi"`) — tests assert on this field per the v0.2 stable-error
+ * contract.
+ */
+export interface SchemaFragmentOptions {
+    /**
+     * Which wrapper is calling. Used only to populate the `generator` field
+     * of any `UnsupportedNodeKindError` thrown during translation. The
+     * emitted fragment itself is identical regardless — OpenAPI 3.1 Schema
+     * Objects are draft-2020-12-compatible.
+     */
+    generator: "jsonSchema" | "openApi";
+}
+/**
+ * Emit the JSON-Schema-shaped fragment for a node. Returns a plain object;
+ * wrappers add `$schema` / `$id` / provenance and JSON-stringify.
+ *
+ * Throws `UnsupportedNodeKindError` with `options.generator` for runtime
+ * refinements (Decision #11) before walking the node — cheaper to fail
+ * fast than to emit a partial fragment.
+ */
+export declare function emitSchemaFragment(node: SchemaNode, options: SchemaFragmentOptions): Record<string, JsonValue>;
+/**
+ * Canonical key-sort, recursive. Wrappers apply this to the assembled root
+ * before stringifying so the output is byte-stable across runs.
+ */
+export declare function canonicalize(value: unknown): unknown;
+//# sourceMappingURL=schema-fragment.d.ts.map

package/dist/src/generators/schema-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fragment.d.ts","sourceRoot":"","sources":["../../../src/generators/schema-fragment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EAIT,UAAU,EACX,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAgB3B;AA6OD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUpD"}

package/dist/src/generators/schema-fragment.js

@@ -0,0 +1,253 @@
+import { UnsupportedNodeKindError } from "./errors.js";
+import { JSON_SCHEMA_EXTENSIONS } from "./json-schema-meta.js";
+/**
+ * Emit the JSON-Schema-shaped fragment for a node. Returns a plain object;
+ * wrappers add `$schema` / `$id` / provenance and JSON-stringify.
+ *
+ * Throws `UnsupportedNodeKindError` with `options.generator` for runtime
+ * refinements (Decision #11) before walking the node — cheaper to fail
+ * fast than to emit a partial fragment.
+ */
+export function emitSchemaFragment(node, options) {
+    for (const r of node.refinements ?? []) {
+        if (r.kind === "runtime") {
+            throw new UnsupportedNodeKindError({
+                kind: "runtimeRefinement",
+                generator: options.generator,
+            });
+        }
+    }
+    const base = emitBareType(node, options);
+    applyPortableRefinements(base, node.refinements ?? [], options);
+    applyDescription(base, node);
+    applyNullability(base, node);
+    applyDefault(base, node);
+    return base;
+}
+function emitBareType(node, options) {
+    switch (node.kind) {
+        case "string":
+            return { type: "string" };
+        case "number":
+            return { type: "number" };
+        case "boolean":
+            return { type: "boolean" };
+        case "literal":
+            return emitLiteral(node);
+        case "enum":
+            return emitEnum(node);
+        case "array":
+            return emitArray(node, options);
+        case "object":
+            return emitObject(node, options);
+        default:
+            throw new UnsupportedNodeKindError({
+                kind: node.kind,
+                generator: options.generator,
+            });
+    }
+}
+function emitLiteral(node) {
+    return { const: node.value };
+}
+function emitEnum(node) {
+    if (node.values.length === 0) {
+        throw new Error("Cannot emit JSON Schema for an empty enum");
+    }
+    return { enum: [...node.values] };
+}
+function emitArray(node, options) {
+    return {
+        type: "array",
+        items: emitSchemaFragment(node.element, options),
+    };
+}
+function emitObject(node, options) {
+    const entries = Object.entries(node.fields);
+    const properties = {};
+    const required = [];
+    for (const [key, field] of entries) {
+        properties[key] = emitSchemaFragment(field, options);
+        if (isObjectRequired(field))
+            required.push(key);
+    }
+    const out = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0)
+        out.required = required;
+    // Decision #12 (corrected in v0.3): `stripUnknown` accepts unknown keys
+    // (`additionalProperties: true`) and tags `x-nekostack-strip: true` so
+    // NekoStack-aware consumers know to strip them. JSON Schema (and OpenAPI
+    // Schema Objects) cannot express mutation; stripping happens in the
+    // runtime.
+    switch (node.unknownKeys) {
+        case "strict":
+            out.additionalProperties = false;
+            break;
+        case "passthrough":
+            out.additionalProperties = true;
+            break;
+        case "stripUnknown":
+            out.additionalProperties = true;
+            out[JSON_SCHEMA_EXTENSIONS.strip] = true;
+            break;
+    }
+    return out;
+}
+/**
+ * Object-field requiredness per Decisions #6-#9:
+ *  - `optional()`              → not in `required` array
+ *  - `nullable()`              → IS in `required` (null is a value)
+ *  - `nullish()`               → not in `required`
+ *  - `default(v)`              → not in `required` (input-optional honored;
+ *                                 default applied by runtime, not the schema)
+ */
+function isObjectRequired(node) {
+    const mods = node.modifiers ?? {};
+    if (mods.optional)
+        return false;
+    if (mods.default !== undefined)
+        return false;
+    return true;
+}
+// ---------- refinements ----------
+function applyPortableRefinements(out, refinements, options) {
+    for (const r of refinements) {
+        if (r.kind !== "portable")
+            continue; // runtime already threw
+        applyPortableRefinement(out, r, options);
+    }
+}
+function applyPortableRefinement(out, r, options) {
+    const params = r.params ?? {};
+    switch (r.name) {
+        case "minLength":
+            out.minLength = numParam(params.value);
+            return;
+        case "maxLength":
+            out.maxLength = numParam(params.value);
+            return;
+        case "length": {
+            const v = numParam(params.value);
+            out.minLength = v;
+            out.maxLength = v;
+            return;
+        }
+        case "regex": {
+            // Decision #11a: regex with non-empty flags throws — emitting
+            // source-only `pattern` would change validation behavior (drop
+            // case-insensitivity etc.), and Invariant 7 forbids silent drops.
+            const source = String(params.source ?? "");
+            const flags = String(params.flags ?? "");
+            if (flags.length > 0) {
+                throw new UnsupportedNodeKindError({
+                    kind: "regexFlags",
+                    generator: options.generator,
+                });
+            }
+            out.pattern = source;
+            return;
+        }
+        case "email":
+            out.format = "email";
+            return;
+        case "uuid":
+            out.format = "uuid";
+            return;
+        case "url":
+            out.format = "uri";
+            return;
+        case "int":
+            out.type = "integer";
+            return;
+        case "min":
+            out.minimum = numParam(params.value);
+            return;
+        case "max":
+            out.maximum = numParam(params.value);
+            return;
+        case "gt":
+            out.exclusiveMinimum = numParam(params.value);
+            return;
+        case "lt":
+            out.exclusiveMaximum = numParam(params.value);
+            return;
+        case "multipleOf":
+            out.multipleOf = numParam(params.value);
+            return;
+        case "minItems":
+            out.minItems = numParam(params.value);
+            return;
+        case "maxItems":
+            out.maxItems = numParam(params.value);
+            return;
+    }
+}
+// ---------- modifiers + description ----------
+function applyDescription(out, node) {
+    if (node.metadata?.description)
+        out.description = node.metadata.description;
+    if (node.metadata?.deprecated)
+        out.deprecated = true;
+}
+function applyNullability(out, node) {
+    if (!node.modifiers?.nullable)
+        return;
+    if ("type" in out && out.type !== undefined) {
+        const current = out.type;
+        if (Array.isArray(current)) {
+            if (!current.includes("null"))
+                out.type = [...current, "null"];
+        }
+        else {
+            out.type = [current, "null"];
+        }
+        return;
+    }
+    if ("enum" in out && Array.isArray(out.enum)) {
+        if (!out.enum.includes(null))
+            out.enum = [...out.enum, null];
+        return;
+    }
+    if ("const" in out) {
+        const value = out.const;
+        delete out.const;
+        out.anyOf = [{ const: value }, { type: "null" }];
+        return;
+    }
+}
+function applyDefault(out, node) {
+    const def = node.modifiers?.default;
+    if (def === undefined)
+        return;
+    out.default = def.value;
+    out[JSON_SCHEMA_EXTENSIONS.defaultAppliedBy] = "runtime";
+}
+// ---------- helpers ----------
+function numParam(value) {
+    if (typeof value !== "number") {
+        throw new Error(`Expected numeric refinement param, got ${typeof value}`);
+    }
+    return value;
+}
+/**
+ * Canonical key-sort, recursive. Wrappers apply this to the assembled root
+ * before stringifying so the output is byte-stable across runs.
+ */
+export function canonicalize(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    const out = {};
+    for (const key of Object.keys(value).sort()) {
+        const v = value[key];
+        if (v === undefined)
+            continue;
+        out[key] = canonicalize(v);
+    }
+    return out;
+}
+//# sourceMappingURL=schema-fragment.js.map

package/dist/src/generators/schema-fragment.js.map

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

package/dist/src/generators/ts.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaNode } from "../ir/nodes.js";
+import type { TypeScriptGeneratorOptions } from "./types.js";
+/**
+ * Generate a TypeScript type alias from a SchemaNode.
+ *
+ * Modes (Decision #9):
+ *  - "output" (default): post-default shape, matches `s.infer<T>` / `s.output<T>`.
+ *  - "input":            pre-default shape, matches `s.input<T>`.
+ *  - "both":             emits both `<Name>Input` and `<Name>Output`.
+ *
+ * Naming: derived from `metadata.id`'s last dotted segment, or
+ * `options.typeName`, or `"Schema"` for anonymous schemas. In `"both"` mode,
+ * the suffixes are always appended — no bare `<Name>`.
+ *
+ * Headers: deterministic JSDoc preamble per `buildHeader`. Same IR + same
+ * generator version → byte-identical output.
+ */
+export declare function generateTypeScript(node: SchemaNode, options?: TypeScriptGeneratorOptions): string;
+//# sourceMappingURL=ts.d.ts.map

package/dist/src/generators/ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts.d.ts","sourceRoot":"","sources":["../../../src/generators/ts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAuBR"}