@nekostack/schema 1.0.0

package/dist/src/builders/schema.d.ts

@@ -0,0 +1,70 @@
+import type { JsonValue, Refinement, SchemaNode } from "../ir/nodes.js";
+import type { ObjectKey } from "../types.js";
+/**
+ * Base of every schema builder.
+ *
+ * Type parameters:
+ *  - TInput:  shape `parse`/`validate` accepts (pre-default, pre-transform)
+ *  - TOutput: shape `parse` returns (post-default, post-transform)
+ *  - TKey:    "required" | "optional" — controls object-field absence
+ *
+ * The phantom `declare` fields exist purely for type inference; they emit no
+ * runtime code. The single source of truth at runtime is `this.node`.
+ */
+export declare abstract class Schema<TInput = unknown, TOutput = TInput, TInputKey extends ObjectKey = "required", TOutputKey extends ObjectKey = TInputKey> {
+    readonly _input: TInput;
+    readonly _output: TOutput;
+    readonly _inputKey: TInputKey;
+    readonly _outputKey: TOutputKey;
+    readonly node: SchemaNode;
+    protected constructor(node: SchemaNode);
+    optional(): Schema<TInput | undefined, TOutput | undefined, "optional", "optional">;
+    nullable(): Schema<TInput | null, TOutput | null, TInputKey, TOutputKey>;
+    nullish(): Schema<TInput | null | undefined, TOutput | null | undefined, "optional", "optional">;
+    /**
+     * Provide a default for missing input. Input becomes optional; output stays
+     * required because the default fills `undefined` in before downstream code
+     * sees it. See the absence-semantics table in the README.
+     */
+    default(value: JsonValue): Schema<TInput | undefined, Exclude<TOutput, undefined>, "optional", "required">;
+    id(id: string): this;
+    version(version: string): this;
+    describe(description: string): this;
+    deprecated(value?: boolean): this;
+    /**
+     * Subclasses override to construct the correct concrete class. The base
+     * class itself never produces instances (it's abstract), but optional /
+     * nullable etc. drop down to `BaseSchema` to surface the right type params.
+     *
+     * **Subclass invariant (load-bearing for v0.5 composition):** `clone(node)`
+     * MUST be a pure IR-replacement operation — return a new instance of the
+     * same concrete subclass with the new `node` and otherwise identical
+     * subclass state. It must NOT mutate `this`, must NOT carry over the old
+     * `node`, and must preserve any subclass-specific bookkeeping the
+     * subclass already passes through its constructor (e.g.
+     * `ArraySchema`'s `elementSchema`, `ObjectSchema`'s `shape`).
+     *
+     * v0.5 composition (`ObjectSchema.partial` / `.required`) reaches into
+     * field-level `clone` via a cast to swap a field's modifiers without
+     * losing subclass identity (`StringSchema.partial()` still yields a
+     * `StringSchema`-shaped instance). Any future Schema subclass that
+     * doesn't honor this invariant — e.g., a `clone` that drops a
+     * subclass-private field — will silently break composition for that
+     * kind of schema. New subclasses ship with a composition-roundtrip
+     * test, or document the divergence explicitly.
+     */
+    protected abstract clone(node: SchemaNode): this;
+    protected cloneSelf(node: SchemaNode): this;
+    /**
+     * Cast a clone as a Schema<TIn, TOut, TKey> for modifier returns. The
+     * runtime instance is still the original subclass — we only narrow the
+     * static type to drop subclass-specific methods (e.g., calling `.optional()`
+     * on a StringSchema yields a base Schema with no further `.min(n)`).
+     */
+    protected cloneAsBase<I, O, IK extends ObjectKey, OK extends ObjectKey>(node: SchemaNode): Schema<I, O, IK, OK>;
+    /** Append a refinement and clone — used by primitive subclasses. */
+    protected withRefinement(refinement: Refinement): this;
+}
+/** Erased Schema reference for generic constraints. */
+export type AnySchema = Schema<any, any, ObjectKey, ObjectKey>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/builders/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/builders/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAGT,UAAU,EACV,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,8BAAsB,MAAM,CAE1B,MAAM,GAAG,OAAO,EAEhB,OAAO,GAAG,MAAM,EAEhB,SAAS,SAAS,SAAS,GAAG,UAAU,EAExC,UAAU,SAAS,SAAS,GAAG,SAAS;IAExC,SAAiB,MAAM,EAAE,MAAM,CAAC;IAChC,SAAiB,OAAO,EAAE,OAAO,CAAC;IAClC,SAAiB,SAAS,EAAE,SAAS,CAAC;IACtC,SAAiB,UAAU,EAAE,UAAU,CAAC;IAExC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,SAAS,aAAa,IAAI,EAAE,UAAU;IAMtC,QAAQ,IAAI,MAAM,CAChB,MAAM,GAAG,SAAS,EAClB,OAAO,GAAG,SAAS,EACnB,UAAU,EACV,UAAU,CACX;IAID,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;IAIxE,OAAO,IAAI,MAAM,CACf,MAAM,GAAG,IAAI,GAAG,SAAS,EACzB,OAAO,GAAG,IAAI,GAAG,SAAS,EAC1B,UAAU,EACV,UAAU,CACX;IAMD;;;;OAIG;IACH,OAAO,CACL,KAAK,EAAE,SAAS,GACf,MAAM,CACP,MAAM,GAAG,SAAS,EAClB,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EAC3B,UAAU,EACV,UAAU,CACX;IAQD,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAInC,UAAU,CAAC,KAAK,UAAO,GAAG,IAAI;IAM9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAEhD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACnB,CAAC,EACD,CAAC,EACD,EAAE,SAAS,SAAS,EACpB,EAAE,SAAS,SAAS,EACpB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;IAIzC,oEAAoE;IACpE,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;CAOvD;AAED,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC"}

package/dist/src/builders/schema.js

@@ -0,0 +1,98 @@
+/**
+ * Base of every schema builder.
+ *
+ * Type parameters:
+ *  - TInput:  shape `parse`/`validate` accepts (pre-default, pre-transform)
+ *  - TOutput: shape `parse` returns (post-default, post-transform)
+ *  - TKey:    "required" | "optional" — controls object-field absence
+ *
+ * The phantom `declare` fields exist purely for type inference; they emit no
+ * runtime code. The single source of truth at runtime is `this.node`.
+ */
+export class Schema {
+    node;
+    constructor(node) {
+        this.node = freeze(node);
+    }
+    // ---- Modifiers (applicable to every schema) ----
+    optional() {
+        return this.cloneAsBase(withModifier(this.node, { optional: true }));
+    }
+    nullable() {
+        return this.cloneAsBase(withModifier(this.node, { nullable: true }));
+    }
+    nullish() {
+        return this.cloneAsBase(withModifier(this.node, { optional: true, nullable: true }));
+    }
+    /**
+     * Provide a default for missing input. Input becomes optional; output stays
+     * required because the default fills `undefined` in before downstream code
+     * sees it. See the absence-semantics table in the README.
+     */
+    default(value) {
+        return this.cloneAsBase(withModifier(this.node, { optional: true, default: { value } }));
+    }
+    // ---- Metadata ----
+    id(id) {
+        return this.cloneSelf(withMetadata(this.node, { id }));
+    }
+    version(version) {
+        return this.cloneSelf(withMetadata(this.node, { version }));
+    }
+    describe(description) {
+        return this.cloneSelf(withMetadata(this.node, { description }));
+    }
+    deprecated(value = true) {
+        return this.cloneSelf(withMetadata(this.node, { deprecated: value }));
+    }
+    cloneSelf(node) {
+        return this.clone(node);
+    }
+    /**
+     * Cast a clone as a Schema<TIn, TOut, TKey> for modifier returns. The
+     * runtime instance is still the original subclass — we only narrow the
+     * static type to drop subclass-specific methods (e.g., calling `.optional()`
+     * on a StringSchema yields a base Schema with no further `.min(n)`).
+     */
+    cloneAsBase(node) {
+        return this.clone(node);
+    }
+    /** Append a refinement and clone — used by primitive subclasses. */
+    withRefinement(refinement) {
+        const existing = this.node.refinements ?? [];
+        return this.clone({
+            ...this.node,
+            refinements: [...existing, refinement],
+        });
+    }
+}
+// ---- Helpers ----
+function withModifier(node, patch) {
+    return {
+        ...node,
+        modifiers: { ...node.modifiers, ...patch },
+    };
+}
+function withMetadata(node, patch) {
+    return {
+        ...node,
+        metadata: { ...node.metadata, ...patch },
+    };
+}
+/**
+ * Deep-freeze in dev/test to make IR mutation immediately loud. Object.freeze
+ * is shallow; we recurse through composites (fields / element / options). The
+ * cost is negligible at definition time and prevents an entire class of bugs
+ * where a downstream consumer mutates a shared IR node.
+ */
+function freeze(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Object.isFrozen(value))
+        return value;
+    for (const key of Object.keys(value)) {
+        freeze(value[key]);
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/builders/schema.js.map

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

package/dist/src/cli-integration.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `@nekostack/schema/cli` integration barrel (Master plan Decision #10).
+ *
+ * This module is the **package-internal integration surface** for
+ * `@nekostack/cli` to import schema primitives that are not part of
+ * the public consumer API:
+ *
+ *   - v0.7 — registry / freshness / generation primitives
+ *   - v0.8 — schema-data migration planning / verification /
+ *     stub-generation primitives (this commit extends the barrel)
+ *
+ * **External consumers should NOT import from this path.** The root
+ * `@nekostack/schema` import surface remains the v0.6 contract
+ * (`s`, `parse`, `safeParse`, `validate`, `ParseError`, IR types,
+ * generators). The names re-exported here are subject to internal
+ * change; engine-swap-safety lives at the root index, not at this
+ * subpath. The negative-leakage gate in
+ * `tests/public-surface.test.ts` enforces that the root never
+ * exposes a v0.7 or v0.8 surface name.
+ *
+ * Re-exports only. No new functions, no new types, no behavior
+ * changes.
+ */
+export { sourceHashFromText } from "./registry/source-hash.js";
+export { parseProvenanceFromText } from "./registry/parse-provenance.js";
+export { buildRegistry, findSchema } from "./registry/build-registry.js";
+export { diffNodes } from "./registry/diff.js";
+export { listHandler } from "./registry/handlers/list.js";
+export { diffHandler } from "./registry/handlers/diff.js";
+export { checkHandler } from "./registry/handlers/check.js";
+export { generateHandler, suggestedPathFor, GENERATOR_KINDS, } from "./registry/handlers/generate.js";
+export type { RegistrySourceEntry, RegistryEntry, Registry, DiffSeverity, DiffKind, DiffChange, FreshnessVerdict, GeneratorKind, GeneratedArtifact, CommittedArtifact, GenerateOpts, GenerateResult, CheckOpts, CheckResult, DiffOpts, DiffResult, ListOpts, ListResult, } from "./registry/types.js";
+export { parseMigrationProvenanceFromText } from "./migrations/parse-provenance.js";
+export { buildMigrationRegistry } from "./migrations/build-migration-registry.js";
+export { planMigration } from "./migrations/plan-migration.js";
+export { verifyMigrationProvenance } from "./migrations/verify-provenance.js";
+export { stubMigration, suggestedMigrationPathFor, } from "./migrations/stub.js";
+export { listMigrationsHandler } from "./migrations/handlers/list.js";
+export { planMigrationHandler } from "./migrations/handlers/plan.js";
+export { verifyMigrationsHandler } from "./migrations/handlers/verify.js";
+export { stubMigrationHandler } from "./migrations/handlers/stub.js";
+export type { Migration, AnyMigration, MigrationSourceEntry, MigrationEntry, MigrationRegistry, MigrationPlan, PlanNote, MigrationVerdict, VerificationResult, MigrationStub, MigrationListOpts, MigrationListResult, MigrationPlanOpts, MigrationPlanResult, MigrationVerifyOpts, MigrationVerifyResult, MigrationStubOpts, MigrationStubResult, } from "./migrations/types.js";
+//# sourceMappingURL=cli-integration.d.ts.map

package/dist/src/cli-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-integration.d.ts","sourceRoot":"","sources":["../../src/cli-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAIzC,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EACL,aAAa,EACb,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAIrE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/src/cli-integration.js

@@ -0,0 +1,48 @@
+/**
+ * `@nekostack/schema/cli` integration barrel (Master plan Decision #10).
+ *
+ * This module is the **package-internal integration surface** for
+ * `@nekostack/cli` to import schema primitives that are not part of
+ * the public consumer API:
+ *
+ *   - v0.7 — registry / freshness / generation primitives
+ *   - v0.8 — schema-data migration planning / verification /
+ *     stub-generation primitives (this commit extends the barrel)
+ *
+ * **External consumers should NOT import from this path.** The root
+ * `@nekostack/schema` import surface remains the v0.6 contract
+ * (`s`, `parse`, `safeParse`, `validate`, `ParseError`, IR types,
+ * generators). The names re-exported here are subject to internal
+ * change; engine-swap-safety lives at the root index, not at this
+ * subpath. The negative-leakage gate in
+ * `tests/public-surface.test.ts` enforces that the root never
+ * exposes a v0.7 or v0.8 surface name.
+ *
+ * Re-exports only. No new functions, no new types, no behavior
+ * changes.
+ */
+// ---- Pure registry primitives ----------------------------------------------
+export { sourceHashFromText } from "./registry/source-hash.js";
+export { parseProvenanceFromText } from "./registry/parse-provenance.js";
+export { buildRegistry, findSchema } from "./registry/build-registry.js";
+export { diffNodes } from "./registry/diff.js";
+// ---- Handlers --------------------------------------------------------------
+export { listHandler } from "./registry/handlers/list.js";
+export { diffHandler } from "./registry/handlers/diff.js";
+export { checkHandler } from "./registry/handlers/check.js";
+export { generateHandler, suggestedPathFor, GENERATOR_KINDS, } from "./registry/handlers/generate.js";
+// =============================================================================
+// v0.8 migration surface
+// =============================================================================
+// ---- Pure migration primitives ---------------------------------------------
+export { parseMigrationProvenanceFromText } from "./migrations/parse-provenance.js";
+export { buildMigrationRegistry } from "./migrations/build-migration-registry.js";
+export { planMigration } from "./migrations/plan-migration.js";
+export { verifyMigrationProvenance } from "./migrations/verify-provenance.js";
+export { stubMigration, suggestedMigrationPathFor, } from "./migrations/stub.js";
+// ---- Migration handlers ----------------------------------------------------
+export { listMigrationsHandler } from "./migrations/handlers/list.js";
+export { planMigrationHandler } from "./migrations/handlers/plan.js";
+export { verifyMigrationsHandler } from "./migrations/handlers/verify.js";
+export { stubMigrationHandler } from "./migrations/handlers/stub.js";
+//# sourceMappingURL=cli-integration.js.map

package/dist/src/cli-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-integration.js","sourceRoot":"","sources":["../../src/cli-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAyBzC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,+EAA+E;AAE/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EACL,aAAa,EACb,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAE/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/errors/issue.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Stable, machine-readable codes for validation issues. The runtime normalizes
+ * raw validator errors (Zod, etc.) into this set so every NekoStack consumer
+ * (form display, API responses, admin diagnostics) reads the same vocabulary.
+ *
+ * Adding a code is a breaking change for consumers that switch on it; removing
+ * one is breaking for anyone that emits it. v1.0 freezes the set.
+ */
+export declare const ISSUE_CODES: readonly ["invalid_type", "missing_required", "unknown_key", "too_small", "too_big", "invalid_enum", "invalid_literal", "invalid_union", "invalid_format", "custom_refinement_failed", "schema_version_unsupported", "recursive_reference_unresolved", "integrity_error", "duplicate_schema_id", "schema_not_found", "version_not_found", "duplicate_migration", "migration_missing_endpoint", "migration_not_found", "migration_chain_broken", "migration_ambiguous_chain", "migration_drift", "migration_cosmetic_drift"];
+export type IssueCode = (typeof ISSUE_CODES)[number];
+export type IssuePath = ReadonlyArray<string | number>;
+export interface Issue {
+    code: IssueCode;
+    path: IssuePath;
+    message: string;
+    expected?: unknown;
+    received?: unknown;
+    schemaId?: string;
+    schemaVersion?: string;
+    severity: "error" | "warning";
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result discriminator used by validate / parse. The output type can differ
+ * from the input type once transforms land (v0.6+).
+ */
+export type Result<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: readonly Issue[];
+};
+//# sourceMappingURL=issue.d.ts.map

package/dist/src/errors/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../../src/errors/issue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,6fA+Ed,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;CAAE,CAAC"}

package/dist/src/errors/issue.js

@@ -0,0 +1,89 @@
+/**
+ * Stable, machine-readable codes for validation issues. The runtime normalizes
+ * raw validator errors (Zod, etc.) into this set so every NekoStack consumer
+ * (form display, API responses, admin diagnostics) reads the same vocabulary.
+ *
+ * Adding a code is a breaking change for consumers that switch on it; removing
+ * one is breaking for anyone that emits it. v1.0 freezes the set.
+ */
+export const ISSUE_CODES = [
+    "invalid_type",
+    "missing_required",
+    "unknown_key",
+    "too_small",
+    "too_big",
+    "invalid_enum",
+    "invalid_literal",
+    "invalid_union",
+    "invalid_format",
+    "custom_refinement_failed",
+    "schema_version_unsupported",
+    "recursive_reference_unresolved",
+    // v0.7 — registry / freshness / loader codes. Added per the Master
+    // plan Decision #15 change-control rule, at each code's first use
+    // site:
+    // - `integrity_error`     — first constructed by `parse-provenance.ts`
+    //   (Step 5) for missing / malformed / self-inconsistent provenance
+    //   blocks. Reused by `checkHandler` (Step 10) for the impossible
+    //   row of the two-hash freshness matrix.
+    // - `duplicate_schema_id` — first constructed by `build-registry.ts`
+    //   (Step 6) when the same `(schemaId, schemaVersion)` pair appears
+    //   in more than one `RegistrySourceEntry`.
+    // - `schema_not_found` / `version_not_found` — first constructed by
+    //   `handlers/check.ts` (Step 10) when a committed artifact's
+    //   provenance points at a schema id (or `(id, version)` pair) that
+    //   isn't in the current Registry. Distinct codes so the CLI can
+    //   format orphan-by-id vs. orphan-by-version differently. Anonymous
+    //   artifacts also use `schema_not_found` (with `metadata.reason =
+    //   "anonymous_artifact"`) since the registry never indexes them.
+    // Remaining v0.7 codes (`schema_load_failed`, plus the verdict-only
+    // identifiers `stale_artifact` / `cosmetic_drift`) — the former lands
+    // in the CLI loader (Step 22); the latter pair are *not* issue codes,
+    // only FreshnessVerdict statuses on `checkHandler`'s success path.
+    "integrity_error",
+    "duplicate_schema_id",
+    "schema_not_found",
+    "version_not_found",
+    // v0.8 — migration codes. Added per the Master plan Decision #15
+    // change-control rule, at each code's first use site:
+    // - `duplicate_migration` — first constructed by
+    //   `migrations/build-migration-registry.ts` (Step 3) when the same
+    //   `(schemaId, fromVersion, toVersion)` triple appears in more than
+    //   one `MigrationSourceEntry`. Mirrors `duplicate_schema_id` from
+    //   v0.7; the planner / verifier rely on the triple being unique.
+    // - `migration_missing_endpoint` — first constructed by
+    //   `migrations/plan-migration.ts` (Step 4) when either the from-
+    //   or to-version is absent from the schema registry. Also used by
+    //   Step 5's verifier when a registered migration references a
+    //   schema version that has since vanished.
+    // - `migration_not_found` — first constructed by `plan-migration.ts`
+    //   (Step 4) when the requested transition is `breaking` and no
+    //   migrations are registered for the schemaId at all.
+    // - `migration_chain_broken` — first constructed by
+    //   `plan-migration.ts` (Step 4) when migrations exist for the
+    //   schemaId but no path bridges (from, to).
+    // - `migration_ambiguous_chain` — first constructed by
+    //   `plan-migration.ts` (Step 4) when two or more distinct chains
+    //   reach the target. The planner refuses to pick.
+    // - `migration_drift` — first constructed by
+    //   `migrations/verify-provenance.ts` (Step 5) when a migration's
+    //   recorded `fromIrHash` or `toIrHash` doesn't match the schema
+    //   registry's current irHash for that version. The migration was
+    //   authored against a schema state that has since changed
+    //   semantically; the transform may no longer be correct. CLI
+    //   maps to LOGICAL_FAILURE.
+    // - `migration_cosmetic_drift` — first constructed by
+    //   `verify-provenance.ts` (Step 5) when irHash matches at both
+    //   endpoints but at least one sourceHash differs. Source was
+    //   edited without semantic effect. v0.8 verifier classifies this
+    //   as a warning verdict; the CLI prints to stderr but the run
+    //   still succeeds.
+    "duplicate_migration",
+    "migration_missing_endpoint",
+    "migration_not_found",
+    "migration_chain_broken",
+    "migration_ambiguous_chain",
+    "migration_drift",
+    "migration_cosmetic_drift",
+];
+//# sourceMappingURL=issue.js.map

package/dist/src/errors/issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../../src/errors/issue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,WAAW;IACX,SAAS;IACT,cAAc;IACd,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,0BAA0B;IAC1B,4BAA4B;IAC5B,gCAAgC;IAChC,mEAAmE;IACnE,kEAAkE;IAClE,QAAQ;IACR,uEAAuE;IACvE,oEAAoE;IACpE,kEAAkE;IAClE,0CAA0C;IAC1C,qEAAqE;IACrE,oEAAoE;IACpE,4CAA4C;IAC5C,oEAAoE;IACpE,8DAA8D;IAC9D,oEAAoE;IACpE,iEAAiE;IACjE,qEAAqE;IACrE,mEAAmE;IACnE,kEAAkE;IAClE,oEAAoE;IACpE,sEAAsE;IACtE,sEAAsE;IACtE,mEAAmE;IACnE,iBAAiB;IACjB,qBAAqB;IACrB,kBAAkB;IAClB,mBAAmB;IACnB,iEAAiE;IACjE,sDAAsD;IACtD,iDAAiD;IACjD,oEAAoE;IACpE,qEAAqE;IACrE,mEAAmE;IACnE,kEAAkE;IAClE,wDAAwD;IACxD,kEAAkE;IAClE,mEAAmE;IACnE,+DAA+D;IAC/D,4CAA4C;IAC5C,qEAAqE;IACrE,gEAAgE;IAChE,uDAAuD;IACvD,oDAAoD;IACpD,+DAA+D;IAC/D,6CAA6C;IAC7C,uDAAuD;IACvD,kEAAkE;IAClE,mDAAmD;IACnD,6CAA6C;IAC7C,kEAAkE;IAClE,iEAAiE;IACjE,kEAAkE;IAClE,2DAA2D;IAC3D,8DAA8D;IAC9D,6BAA6B;IAC7B,sDAAsD;IACtD,gEAAgE;IAChE,8DAA8D;IAC9D,kEAAkE;IAClE,+DAA+D;IAC/D,oBAAoB;IACpB,qBAAqB;IACrB,4BAA4B;IAC5B,qBAAqB;IACrB,wBAAwB;IACxB,2BAA2B;IAC3B,iBAAiB;IACjB,0BAA0B;CAClB,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Stable, machine-readable error thrown when a generator encounters IR it
+ * cannot represent — either an unsupported node kind or a refinement whose
+ * absence would change validation behavior (per Invariant 7).
+ *
+ * Tests assert on `code` / `kind` / `generator` — never on `message`, which
+ * is for humans and can change without breaking the contract.
+ *
+ * Current `kind` values:
+ *   - IR node kinds without generator support: `date`, `union`,
+ *     `recursiveRef`, `transform`.
+ *   - Refinement-level: `runtimeRefinement` (all generators);
+ *     `regexFlags` (JSON Schema / OpenAPI — `pattern` has no flag support).
+ *
+ * Current `generator` values: `typescript`, `zod`, `jsonSchema`, `openApi`,
+ * `diff` (v0.7+ — emitted by `src/registry/diff.ts` for unsupported IR
+ * kinds at diff time). Both unions extend over time as new generators
+ * or new throw cases land; see the active generator docs in
+ * `packages/schema/docs/` for the authoritative per-generator throw
+ * contract.
+ */
+export declare class UnsupportedNodeKindError extends Error {
+    readonly code: "UNSUPPORTED_NODE_KIND";
+    readonly kind: string;
+    readonly generator: "typescript" | "zod" | "jsonSchema" | "openApi" | "diff";
+    constructor(args: {
+        kind: string;
+        generator: "typescript" | "zod" | "jsonSchema" | "openApi" | "diff";
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/generators/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;gBAEjE,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,YAAY,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;KACrE;CASF"}

package/dist/src/generators/errors.js

@@ -0,0 +1,34 @@
+/**
+ * Stable, machine-readable error thrown when a generator encounters IR it
+ * cannot represent — either an unsupported node kind or a refinement whose
+ * absence would change validation behavior (per Invariant 7).
+ *
+ * Tests assert on `code` / `kind` / `generator` — never on `message`, which
+ * is for humans and can change without breaking the contract.
+ *
+ * Current `kind` values:
+ *   - IR node kinds without generator support: `date`, `union`,
+ *     `recursiveRef`, `transform`.
+ *   - Refinement-level: `runtimeRefinement` (all generators);
+ *     `regexFlags` (JSON Schema / OpenAPI — `pattern` has no flag support).
+ *
+ * Current `generator` values: `typescript`, `zod`, `jsonSchema`, `openApi`,
+ * `diff` (v0.7+ — emitted by `src/registry/diff.ts` for unsupported IR
+ * kinds at diff time). Both unions extend over time as new generators
+ * or new throw cases land; see the active generator docs in
+ * `packages/schema/docs/` for the authoritative per-generator throw
+ * contract.
+ */
+export class UnsupportedNodeKindError extends Error {
+    code = "UNSUPPORTED_NODE_KIND";
+    kind;
+    generator;
+    constructor(args) {
+        super(`Generator '${args.generator}' does not support IR node kind '${args.kind}' in this phase. ` +
+            `See packages/schema/docs/ for the active generator contracts.`);
+        this.name = "UnsupportedNodeKindError";
+        this.kind = args.kind;
+        this.generator = args.generator;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/generators/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,uBAAgC,CAAC;IACxC,IAAI,CAAS;IACb,SAAS,CAA2D;IAE7E,YAAY,IAGX;QACC,KAAK,CACH,cAAc,IAAI,CAAC,SAAS,oCAAoC,IAAI,CAAC,IAAI,mBAAmB;YAC1F,+DAA+D,CAClE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,42 @@
+import type { SchemaNode } from "../ir/nodes.js";
+export interface HeaderOptions {
+    /** Which generator emitted this file. Affects the header's `generator` field. */
+    generator: "typescript" | "zod";
+    /** Optional override for the schema-version field, when no `metadata.version` is set on the node. */
+    schemaVersion?: string;
+    /**
+     * Optional sha256 of the originating `*.schema.ts` source bytes
+     * (`registry/source-hash.ts → sourceHashFromText`). When provided,
+     * emitted as a `sourceHash:` line between `irHash:` and `generator:`.
+     * When omitted, the line is **absent entirely** (Master plan Decision #8;
+     * NOT emitted as `null` — older parsers and direct generator callers
+     * see a header indistinguishable from the v0.2–v0.6 shape).
+     *
+     * The CLI (v0.7+, `neko schema *`) passes this through; direct
+     * generator calls (vitest snapshots, ad-hoc scripts) omit it so
+     * existing snapshots remain byte-identical.
+     */
+    sourceHash?: `sha256:${string}`;
+}
+/**
+ * Build the deterministic JSDoc block prepended to every generated file.
+ *
+ * Fields (one per line):
+ *
+ *   @generated by @nekostack/schema
+ *   schemaId:         <metadata.id, or `null` for anonymous schemas>
+ *   schemaVersion:    <metadata.version, or `null` for unversioned schemas>
+ *   irHash:           sha256:<hex>
+ *   [sourceHash:      sha256:<hex>]   ← v0.7+, only when options.sourceHash is set
+ *   generator:        <typescript|zod>
+ *   generatorVersion: <package version string>
+ *
+ *   DO NOT EDIT MANUALLY.
+ *
+ * Determinism: same IR + same generator version + same sourceHash (or
+ * same absence) → byte-identical header. Anonymous schemas (no
+ * `.id()`) emit `schemaId: null` and include a `// anonymous schema`
+ * comment so the omission is intentional and visible.
+ */
+export declare function buildHeader(node: SchemaNode, options: HeaderOptions): string;
+//# sourceMappingURL=header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/generators/header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,SAAS,EAAE,YAAY,GAAG,KAAK,CAAC;IAChC,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,UAAU,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CA8B5E"}

package/dist/src/generators/header.js

@@ -0,0 +1,43 @@
+import { irHash } from "../ir/hash.js";
+import { GENERATOR_VERSION } from "./version.js";
+/**
+ * Build the deterministic JSDoc block prepended to every generated file.
+ *
+ * Fields (one per line):
+ *
+ *   @generated by @nekostack/schema
+ *   schemaId:         <metadata.id, or `null` for anonymous schemas>
+ *   schemaVersion:    <metadata.version, or `null` for unversioned schemas>
+ *   irHash:           sha256:<hex>
+ *   [sourceHash:      sha256:<hex>]   ← v0.7+, only when options.sourceHash is set
+ *   generator:        <typescript|zod>
+ *   generatorVersion: <package version string>
+ *
+ *   DO NOT EDIT MANUALLY.
+ *
+ * Determinism: same IR + same generator version + same sourceHash (or
+ * same absence) → byte-identical header. Anonymous schemas (no
+ * `.id()`) emit `schemaId: null` and include a `// anonymous schema`
+ * comment so the omission is intentional and visible.
+ */
+export function buildHeader(node, options) {
+    const id = node.metadata?.id ?? null;
+    const version = node.metadata?.version ?? options.schemaVersion ?? null;
+    const hash = irHash(node);
+    const lines = [
+        "/**",
+        " * @generated by @nekostack/schema",
+    ];
+    if (id === null) {
+        lines.push(" * // anonymous schema");
+    }
+    lines.push(` * schemaId:         ${id === null ? "null" : id}`, ` * schemaVersion:    ${version === null ? "null" : version}`, ` * irHash:           sha256:${hash}`);
+    if (options.sourceHash !== undefined) {
+        // 11 chars "sourceHash:" + 7 spaces to land the value at column 18,
+        // matching the existing field-name column width.
+        lines.push(` * sourceHash:       ${options.sourceHash}`);
+    }
+    lines.push(` * generator:        ${options.generator}`, ` * generatorVersion: ${GENERATOR_VERSION}`, " *", " * DO NOT EDIT MANUALLY.", " */");
+    return lines.join("\n");
+}
+//# sourceMappingURL=header.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../../src/generators/header.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAsBjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,OAAsB;IAClE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,oCAAoC;KACrC,CAAC;IACF,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,IAAI,CACR,wBAAwB,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EACnD,wBAAwB,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,EAC7D,+BAA+B,IAAI,EAAE,CACtC,CAAC;IACF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,oEAAoE;QACpE,iDAAiD;QACjD,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,CAAC,IAAI,CACR,wBAAwB,OAAO,CAAC,SAAS,EAAE,EAC3C,wBAAwB,iBAAiB,EAAE,EAC3C,IAAI,EACJ,0BAA0B,EAC1B,KAAK,CACN,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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 declare 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.
+     */
+    readonly 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"`.
+     */
+    readonly 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.
+     */
+    readonly strip: "x-nekostack-strip";
+};
+export type JsonSchemaExtensionKey = (typeof JSON_SCHEMA_EXTENSIONS)[keyof typeof JSON_SCHEMA_EXTENSIONS];
+//# sourceMappingURL=json-schema-meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-meta.d.ts","sourceRoot":"","sources":["../../../src/generators/json-schema-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC"}