@formspec/build 0.1.0-alpha.5 → 0.1.0-alpha.50

package/dist/json-schema/generator.d.ts

@@ -1,10 +1,34 @@
 /**
  * JSON Schema generator for FormSpec forms.
+ *
+ * Routes through the canonical IR pipeline: Chain DSL → FormIR → JSON Schema 2020-12.
+ */
+import type { FormElement, FormSpec, MetadataPolicyInput } from "@formspec/core";
+import { type JsonSchema2020 } from "./ir-generator.js";
+/**
+ * Options for generating JSON Schema from a Chain DSL form.
+ *
+ * @public
  */
-import type { FormElement, FormSpec } from "@formspec/core";
-import type { JSONSchema7 } from "./types.js";
+export interface GenerateJsonSchemaOptions {
+    /**
+     * Vendor prefix for emitted extension keywords.
+     * @defaultValue "x-formspec"
+     */
+    readonly vendorPrefix?: string | undefined;
+    /**
+     * JSON Schema representation to use for static enums.
+     * @defaultValue "enum"
+     */
+    readonly enumSerialization?: "enum" | "oneOf";
+    /** Metadata resolution policy for chain DSL generation. */
+    readonly metadata?: MetadataPolicyInput | undefined;
+}
 /**
- * Generates a JSON Schema from a FormSpec.
+ * Generates a JSON Schema 2020-12 from a FormSpec.
+ *
+ * All generation routes through the canonical IR. The chain DSL is first
+ * canonicalized to a FormIR, then the IR-based generator produces the schema.
  *
  * @example
  * ```typescript
@@ -15,7 +39,7 @@ import type { JSONSchema7 } from "./types.js";
  *
  * const schema = generateJsonSchema(form);
  * // {
- * //   $schema: "https://json-schema.org/draft-07/schema#",
+ * //   $schema: "https://json-schema.org/draft/2020-12/schema",
  * //   type: "object",
  * //   properties: {
  * //     name: { type: "string", title: "Name" },
@@ -26,7 +50,9 @@ import type { JSONSchema7 } from "./types.js";
  * ```
  *
  * @param form - The FormSpec to convert
- * @returns A JSON Schema object
+ * @returns A JSON Schema 2020-12 object
+ *
+ * @public
  */
-export declare function generateJsonSchema<E extends readonly FormElement[]>(form: FormSpec<E>): JSONSchema7;
+export declare function generateJsonSchema<E extends readonly FormElement[]>(form: FormSpec<E>, options?: GenerateJsonSchemaOptions): JsonSchema2020;
 //# sourceMappingURL=generator.d.ts.map

package/dist/json-schema/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/json-schema/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAMT,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgK9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EACjE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,WAAW,CAgBb"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/json-schema/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EACjE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,OAAO,CAAC,EAAE,yBAAyB,GAClC,cAAc,CAahB"}

package/dist/json-schema/ir-generator.d.ts

@@ -0,0 +1,149 @@
+/**
+ * JSON Schema 2020-12 generator that consumes the canonical FormIR.
+ *
+ * This generator is a pure function of the IR. It never consults the TypeScript
+ * AST or surface syntax directly — only the IR (per the JSON Schema vocabulary spec §1.2).
+ *
+ * @see https://json-schema.org/draft/2020-12/schema
+ * @see https://json-schema.org/draft/2020-12/schema
+ */
+import type { FormIR } from "@formspec/core/internals";
+import type { ExtensionRegistry } from "../extensions/index.js";
+/**
+ * A JSON Schema 2020-12 document, sub-schema, or keyword collection.
+ *
+ * This interface covers the subset of JSON Schema 2020-12 that this generator
+ * emits, plus an index signature for custom `x-formspec-*` extension keywords.
+ *
+ * @public
+ */
+export interface JsonSchema2020 {
+    /** Declared JSON Schema dialect URI for the document root. */
+    $schema?: string;
+    /** Reference to another schema location. */
+    $ref?: string;
+    /** Named reusable schema definitions keyed by definition name. */
+    $defs?: Record<string, JsonSchema2020>;
+    /** JSON Schema type keyword for the current node. */
+    type?: string;
+    /** Object properties keyed by property name. */
+    properties?: Record<string, JsonSchema2020>;
+    /** Property names that must be present on object values. */
+    required?: string[];
+    /** Item schema applied to array elements. */
+    items?: JsonSchema2020;
+    /** Whether, or how, additional object properties are allowed. */
+    additionalProperties?: boolean | JsonSchema2020;
+    /** Closed set of allowed scalar values. */
+    enum?: readonly (string | number)[];
+    /** Literal value the instance must equal. */
+    const?: unknown;
+    /** Schemas that must all validate successfully. */
+    allOf?: readonly JsonSchema2020[];
+    /** Schemas of which exactly one should validate successfully. */
+    oneOf?: readonly JsonSchema2020[];
+    /** Schemas of which at least one may validate successfully. */
+    anyOf?: readonly JsonSchema2020[];
+    /** Inclusive numeric lower bound. */
+    minimum?: number;
+    /** Inclusive numeric upper bound. */
+    maximum?: number;
+    /** Exclusive numeric lower bound. */
+    exclusiveMinimum?: number;
+    /** Exclusive numeric upper bound. */
+    exclusiveMaximum?: number;
+    /** Required numeric step interval. */
+    multipleOf?: number;
+    /** Inclusive minimum string length. */
+    minLength?: number;
+    /** Inclusive maximum string length. */
+    maxLength?: number;
+    /** Inclusive minimum array length. */
+    minItems?: number;
+    /** Inclusive maximum array length. */
+    maxItems?: number;
+    /** Regular expression pattern applied to string values. */
+    pattern?: string;
+    /** Whether array elements must be unique. */
+    uniqueItems?: boolean;
+    /** Format hint for downstream validators and tooling. */
+    format?: string;
+    /** Human-readable title for the schema node. */
+    title?: string;
+    /** Human-readable description for the schema node. */
+    description?: string;
+    /** Default value suggested for the schema node. */
+    default?: unknown;
+    /** Whether the schema node is deprecated. */
+    deprecated?: boolean;
+    /** Additional vendor-prefixed extension keywords. */
+    [key: `x-${string}`]: unknown;
+}
+/**
+ * Options for generating JSON Schema from a canonical FormIR.
+ *
+ * @internal
+ */
+export interface GenerateJsonSchemaFromIROptions {
+    /**
+     * Registry used to resolve custom types, constraints, and annotations.
+     *
+     * JSON Schema generation throws when custom IR nodes are present without a
+     * matching registration in this registry.
+     */
+    readonly extensionRegistry?: ExtensionRegistry | undefined;
+    /**
+     * Vendor prefix passed to extension `toJsonSchema` hooks.
+     * @defaultValue "x-formspec"
+     */
+    readonly vendorPrefix?: string | undefined;
+    /**
+     * JSON Schema representation to use for static enums.
+     * @defaultValue "enum"
+     */
+    readonly enumSerialization?: "enum" | "oneOf" | undefined;
+}
+/**
+ * Generates a JSON Schema 2020-12 object from a canonical FormIR.
+ *
+ * Groups and conditionals are flattened — they influence UI layout but do not
+ * affect the data schema. All fields appear at the level they would occupy in
+ * the output data.
+ *
+ * Named types in the `typeRegistry` are emitted as `$defs` entries and
+ * referenced via `$ref` (per PP7 — high-fidelity output).
+ *
+ * @example
+ * ```typescript
+ * import { canonicalizeDSL } from "./canonicalize/index.js";
+ * import { generateJsonSchemaFromIR } from "./json-schema/ir-generator.js";
+ * import { formspec, field } from "@formspec/dsl";
+ *
+ * const form = formspec(
+ *   field.text("name", { label: "Name", required: true }),
+ *   field.number("age", { min: 0 }),
+ * );
+ * const ir = canonicalizeDSL(form);
+ * const schema = generateJsonSchemaFromIR(ir);
+ * // {
+ * //   $schema: "https://json-schema.org/draft/2020-12/schema",
+ * //   type: "object",
+ * //   properties: {
+ * //     name: { type: "string", title: "Name" },
+ * //     age:  { type: "number", minimum: 0 }
+ * //   },
+ * //   required: ["name"]
+ * // }
+ * ```
+ *
+ * Advanced API — most consumers should use `generateJsonSchema()` or
+ * `buildFormSchemas()`, which canonicalize form definitions automatically.
+ * Callers of this function are responsible for providing pre-canonicalized IR.
+ *
+ * @param ir - The canonical FormIR produced by a canonicalizer
+ * @returns A plain JSON-serializable JSON Schema 2020-12 object
+ *
+ * @internal
+ */
+export declare function generateJsonSchemaFromIR(ir: FormIR, options?: GenerateJsonSchemaFromIROptions): JsonSchema2020;
+//# sourceMappingURL=ir-generator.d.ts.map

package/dist/json-schema/ir-generator.d.ts.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Zod schemas for JSON Schema output validation.
+ *
+ * These schemas cover the subset of JSON Schema that FormSpec generates,
+ * plus the FormSpec-specific `x-formspec-*` extension properties.
+ *
+ * @see https://json-schema.org/draft/2020-12/schema
+ */
+import { z } from "zod";
+import type { JSONSchema7 } from "./types.js";
+/**
+ * Zod schema for JSON Schema primitive type strings.
+ *
+ * @public
+ */
+export declare const jsonSchemaTypeSchema: z.ZodEnum<["string", "number", "integer", "boolean", "object", "array", "null"]>;
+/**
+ * Zod schema for the legacy JSON Schema 7 subset used by `@formspec/build`.
+ *
+ * @public
+ */
+export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/json-schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kFAQ/B,CAAC;AAaH;;;;GAIG;AAGH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAoEpD,CAAC"}

package/dist/json-schema/types.d.ts

@@ -1,45 +1,81 @@
 /**
- * JSON Schema Draft-07 type definitions.
+ * JSON Schema type definitions.
  *
  * These types are a subset of JSON Schema sufficient for form generation.
  */
 /**
  * JSON Schema primitive types.
+ *
+ * @public
  */
 export type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 /**
- * A JSON Schema definition (draft-07 subset).
+ * A JSON Schema definition (legacy subset used by Zod validator and types.ts).
+ *
+ * @public
  */
 export interface JSONSchema7 {
+    /** Declared JSON Schema dialect URI for the document root. */
     $schema?: string;
+    /** Stable identifier for the schema document or sub-schema. */
     $id?: string;
+    /** Reference to another schema location. */
     $ref?: string;
+    /** Human-readable title for the schema node. */
     title?: string;
+    /** Human-readable description for the schema node. */
     description?: string;
+    /** Whether the schema node is deprecated. */
+    deprecated?: boolean;
+    /** JSON Schema type keyword for the current node. */
     type?: JSONSchemaType | JSONSchemaType[];
+    /** Inclusive minimum string length. */
     minLength?: number;
+    /** Inclusive maximum string length. */
     maxLength?: number;
+    /** Regular expression pattern applied to string values. */
     pattern?: string;
+    /** Inclusive numeric lower bound. */
     minimum?: number;
+    /** Inclusive numeric upper bound. */
     maximum?: number;
+    /** Exclusive numeric lower bound. */
     exclusiveMinimum?: number;
+    /** Exclusive numeric upper bound. */
     exclusiveMaximum?: number;
+    /** Closed set of allowed scalar values. */
     enum?: readonly (string | number | boolean | null)[];
+    /** Literal value the instance must equal. */
     const?: string | number | boolean | null;
+    /** Object properties keyed by property name. */
     properties?: Record<string, JSONSchema7>;
+    /** Property names that must be present on object values. */
     required?: string[];
+    /** Whether, or how, additional object properties are allowed. */
     additionalProperties?: boolean | JSONSchema7;
+    /** Item schema or tuple schemas applied to array elements. */
     items?: JSONSchema7 | JSONSchema7[];
+    /** Inclusive minimum array length. */
     minItems?: number;
+    /** Inclusive maximum array length. */
     maxItems?: number;
+    /** Schemas that must all validate successfully. */
     allOf?: JSONSchema7[];
+    /** Schemas of which at least one may validate successfully. */
     anyOf?: JSONSchema7[];
+    /** Schemas of which exactly one should validate successfully. */
     oneOf?: JSONSchema7[];
+    /** Schema that must not validate successfully. */
     not?: JSONSchema7;
+    /** Conditional branch predicate schema. */
     if?: JSONSchema7;
+    /** Schema applied when the `if` branch matches. */
     then?: JSONSchema7;
+    /** Schema applied when the `if` branch does not match. */
     else?: JSONSchema7;
+    /** Format hint for downstream validators and tooling. */
     format?: string;
+    /** Default value suggested for the schema node. */
     default?: unknown;
     /**
      * Data source key for dynamic enum fields.
@@ -57,4 +93,42 @@ export interface JSONSchema7 {
      */
     "x-formspec-schemaSource"?: string;
 }
+/**
+ * Extension properties for custom FormSpec constraint tags.
+ *
+ * @public
+ */
+export type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
+/**
+ * JSON Schema with FormSpec extension properties for arbitrary `x-formspec-*` keys.
+ *
+ * @public
+ */
+export type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
+/**
+ * Sets a FormSpec extension property on a JSON Schema node.
+ *
+ * Use this to safely add `x-formspec-*` properties to any schema,
+ * including nested schemas typed as `JSONSchema7` (which don't carry
+ * the extension index signature).
+ *
+ * @param schema - Any JSON Schema node
+ * @param key - Extension key (must start with `x-formspec-`)
+ * @param value - Extension value
+ *
+ * @internal
+ */
+export declare function setSchemaExtension(schema: object, key: `x-formspec-${string}`, value: unknown): void;
+/**
+ * Reads a FormSpec extension property from a JSON Schema node.
+ *
+ * Accepts any schema object — `JSONSchema7`, `JsonSchema2020`, `ExtendedJSONSchema7`, etc.
+ *
+ * @param schema - Any JSON Schema node
+ * @param key - Extension key (must start with `x-formspec-`)
+ * @returns The extension value, or `undefined` if not present
+ *
+ * @internal
+ */
+export declare function getSchemaExtension(schema: object, key: `x-formspec-${string}`): unknown;
 //# sourceMappingURL=types.d.ts.map

package/dist/json-schema/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/json-schema/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAGzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAGzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAG7C,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,WAAW,CAAC;IAGlB,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAMlB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/json-schema/types.ts"],"names":[],"mappings":"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"}

package/dist/metadata/collision-guards.d.ts

@@ -0,0 +1,3 @@
+import type { FormIR } from "@formspec/core/internals";
+export declare function assertNoSerializedNameCollisions(ir: FormIR): void;
+//# sourceMappingURL=collision-guards.d.ts.map

package/dist/metadata/collision-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-guards.d.ts","sourceRoot":"","sources":["../../src/metadata/collision-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,MAAM,EAKP,MAAM,0BAA0B,CAAC;AAsHlC,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAejE"}

package/dist/metadata/index.d.ts

@@ -0,0 +1,7 @@
+export type { NormalizedPluralizationPolicy as NormalizedMetadataPluralizationPolicy, NormalizedMetadataScalarPolicy, NormalizedDeclarationMetadataPolicy, NormalizedMetadataPolicy, MetadataResolutionContext, } from "./policy.js";
+export { normalizeMetadataPolicy, getDeclarationMetadataPolicy, makeMetadataContext, defaultApiNameInference, defaultDisplayNameInference, getDefaultMetadataPolicy, } from "./policy.js";
+export type { ExplicitMetadataInput } from "./resolve.js";
+export { resolveMetadata, getSerializedName, getDisplayName } from "./resolve.js";
+export type { ResolveFormIRMetadataOptions } from "./resolve.js";
+export { resolveFormIRMetadata, mergeResolvedMetadata } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/metadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,6BAA6B,IAAI,qCAAqC,EACtE,8BAA8B,EAC9B,mCAAmC,EACnC,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/metadata/policy.d.ts

@@ -0,0 +1,12 @@
+import type { EnumMemberMetadataInferenceContext, MetadataAuthoringSurface, MetadataDeclarationKind, MetadataInferenceContext, MetadataPolicyInput, NormalizedDeclarationMetadataPolicy, NormalizedMetadataPolicy, NormalizedMetadataValuePolicy } from "@formspec/core/internals";
+export type { NormalizedDeclarationMetadataPolicy, NormalizedEnumMemberDisplayNamePolicy, NormalizedEnumMemberMetadataPolicy, NormalizedMetadataPolicy, NormalizedMetadataPluralizationPolicy as NormalizedPluralizationPolicy, } from "@formspec/core/internals";
+export type MetadataResolutionContext = MetadataInferenceContext;
+export type EnumMemberResolutionContext = EnumMemberMetadataInferenceContext;
+export type NormalizedMetadataScalarPolicy = NormalizedMetadataValuePolicy;
+export declare function defaultApiNameInference(_context: MetadataResolutionContext): string;
+export declare function defaultDisplayNameInference(_context: MetadataResolutionContext): string;
+export declare function normalizeMetadataPolicy(input?: MetadataPolicyInput): NormalizedMetadataPolicy;
+export declare function getDeclarationMetadataPolicy(policy: NormalizedMetadataPolicy, declarationKind: MetadataDeclarationKind): NormalizedDeclarationMetadataPolicy;
+export declare function makeMetadataContext(surface: MetadataAuthoringSurface, declarationKind: MetadataDeclarationKind, logicalName: string, buildContext?: unknown): MetadataResolutionContext;
+export declare function getDefaultMetadataPolicy(): NormalizedMetadataPolicy;
+//# sourceMappingURL=policy.d.ts.map

package/dist/metadata/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/metadata/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kCAAkC,EAClC,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EAGxB,mBAAmB,EAEnB,mCAAmC,EAGnC,wBAAwB,EAExB,6BAA6B,EAC9B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,mCAAmC,EACnC,qCAAqC,EACrC,kCAAkC,EAClC,wBAAwB,EACxB,qCAAqC,IAAI,6BAA6B,GACvE,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AACjE,MAAM,MAAM,2BAA2B,GAAG,kCAAkC,CAAC;AAC7E,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAE3E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAEnF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAEvF;AAgGD,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,wBAAwB,CAO7F;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,wBAAwB,EAChC,eAAe,EAAE,uBAAuB,GACvC,mCAAmC,CAErC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,EACjC,eAAe,EAAE,uBAAuB,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,OAAO,GACrB,yBAAyB,CAO3B;AAED,wBAAgB,wBAAwB,IAAI,wBAAwB,CAEnE"}

package/dist/metadata/resolve.d.ts

@@ -0,0 +1,21 @@
+import type { FormIR, MetadataAuthoringSurface, ResolvedMetadata } from "@formspec/core/internals";
+import type { MetadataResolutionContext, NormalizedDeclarationMetadataPolicy, NormalizedMetadataPolicy } from "./policy.js";
+export interface ExplicitMetadataInput {
+    readonly apiName?: string;
+    readonly displayName?: string;
+    readonly apiNamePlural?: string;
+    readonly displayNamePlural?: string;
+}
+export interface ResolveFormIRMetadataOptions {
+    readonly policy: NormalizedMetadataPolicy;
+    readonly surface: MetadataAuthoringSurface;
+    readonly buildContext?: unknown;
+    readonly rootLogicalName?: string;
+    readonly resolveRootTypeMetadata?: boolean;
+}
+export declare function resolveMetadata(explicit: ExplicitMetadataInput | undefined, policy: NormalizedDeclarationMetadataPolicy, context: MetadataResolutionContext): ResolvedMetadata | undefined;
+export declare function mergeResolvedMetadata(baseMetadata: ResolvedMetadata | undefined, overlayMetadata: ResolvedMetadata | undefined): ResolvedMetadata | undefined;
+export declare function getSerializedName(logicalName: string, metadata: ResolvedMetadata | undefined): string;
+export declare function getDisplayName(metadata: ResolvedMetadata | undefined): string | undefined;
+export declare function resolveFormIRMetadata(ir: FormIR, options: ResolveFormIRMetadataOptions): FormIR;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/metadata/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/metadata/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,MAAM,EAEN,wBAAwB,EAExB,gBAAgB,EAIjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAEV,yBAAyB,EACzB,mCAAmC,EACnC,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAoTD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,qBAAqB,GAAG,SAAS,EAC3C,MAAM,EAAE,mCAAmC,EAC3C,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,GAAG,SAAS,CAE9B;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,gBAAgB,GAAG,SAAS,EAC1C,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC5C,gBAAgB,GAAG,SAAS,CA8B9B;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GACrC,MAAM,CAER;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAsB/F"}

package/dist/static-build.d.ts

@@ -0,0 +1,61 @@
+import * as ts from "typescript";
+/**
+ * Supported compiler context for static build-time analysis workflows.
+ *
+ * This context gives consumers access to the TypeScript program, checker, and
+ * source file used to discover declarations before invoking FormSpec schema
+ * generation helpers.
+ *
+ * @public
+ */
+export interface StaticBuildContext {
+    /** Host-owned or FormSpec-created TypeScript program. */
+    readonly program: ts.Program;
+    /** TypeScript checker for symbol and type analysis. */
+    readonly checker: ts.TypeChecker;
+    /** Source file used as the entry module for export resolution. */
+    readonly sourceFile: ts.SourceFile;
+}
+/**
+ * Creates a supported static build context for a source file.
+ *
+ * @param filePath - Entry TypeScript source file used for export resolution
+ * @returns Reusable build context containing the program, checker, and source file
+ *
+ * @public
+ */
+export declare function createStaticBuildContext(filePath: string): StaticBuildContext;
+/**
+ * Creates a supported static build context from an existing host-owned program.
+ *
+ * @param program - Existing TypeScript program supplied by the caller
+ * @param filePath - Entry TypeScript source file used for export resolution
+ * @returns Reusable build context containing the program, checker, and source file
+ *
+ * @public
+ */
+export declare function createStaticBuildContextFromProgram(program: ts.Program, filePath: string): StaticBuildContext;
+/**
+ * Resolves an export from the context source file, following aliases and re-exports.
+ *
+ * @param context - Static build context created for the entry source file
+ * @param exportName - Export name to resolve. Defaults to `"default"`.
+ * @returns Resolved symbol for the export, or `null` when it cannot be found
+ *
+ * @public
+ */
+export declare function resolveModuleExport(context: StaticBuildContext, exportName?: string): ts.Symbol | null;
+/**
+ * Resolves the declaration behind an export from the context source file,
+ * following aliases and re-exports. This helper is intentionally limited to
+ * declaration kinds accepted by declaration-driven schema generation.
+ *
+ * @param context - Static build context created for the entry source file
+ * @param exportName - Export name to resolve. Defaults to `"default"`.
+ * @returns Resolved class, interface, or type-alias declaration for the export,
+ * or `null` when the export does not resolve to one of those schema-source kinds
+ *
+ * @public
+ */
+export declare function resolveModuleExportDeclaration(context: StaticBuildContext, exportName?: string): ts.ClassDeclaration | ts.InterfaceDeclaration | ts.TypeAliasDeclaration | null;
+//# sourceMappingURL=static-build.d.ts.map

package/dist/static-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-build.d.ts","sourceRoot":"","sources":["../src/static-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAOjC;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;CACpC;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAE7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAEpB;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,SAAY,GACrB,EAAE,CAAC,MAAM,GAAG,IAAI,CAiBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,UAAU,SAAY,GACrB,EAAE,CAAC,gBAAgB,GAAG,EAAE,CAAC,oBAAoB,GAAG,EAAE,CAAC,oBAAoB,GAAG,IAAI,CAIhF"}

package/dist/ui-schema/generator.d.ts

@@ -1,11 +1,25 @@
 /**
  * JSON Forms UI Schema generator for FormSpec forms.
+ *
+ * Routes through the canonical IR pipeline: Chain DSL → FormIR → UI Schema.
  */
-import type { FormElement, FormSpec } from "@formspec/core";
+import type { FormElement, FormSpec, MetadataPolicyInput } from "@formspec/core";
 import type { UISchema } from "./types.js";
+/**
+ * Options for generating a UI Schema from a Chain DSL form.
+ *
+ * @public
+ */
+export interface GenerateUiSchemaOptions {
+    /** Metadata resolution policy for chain DSL UI generation. */
+    readonly metadata?: MetadataPolicyInput | undefined;
+}
 /**
  * Generates a JSON Forms UI Schema from a FormSpec.
  *
+ * All generation routes through the canonical IR. The chain DSL is first
+ * canonicalized to a FormIR, then the IR-based generator produces the schema.
+ *
  * @example
  * ```typescript
  * const form = formspec(
@@ -43,6 +57,8 @@ import type { UISchema } from "./types.js";
  *
  * @param form - The FormSpec to convert
  * @returns A JSON Forms UI Schema
+ *
+ * @public
  */
-export declare function generateUiSchema<E extends readonly FormElement[]>(form: FormSpec<E>): UISchema;
+export declare function generateUiSchema<E extends readonly FormElement[]>(form: FormSpec<E>, options?: GenerateUiSchemaOptions): UISchema;
 //# sourceMappingURL=generator.d.ts.map

package/dist/ui-schema/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/ui-schema/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAGT,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,QAAQ,EAIT,MAAM,YAAY,CAAC;AA2HpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EAC/D,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,QAAQ,CAKV"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/ui-schema/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EAC/D,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC,QAAQ,CAMV"}

package/dist/ui-schema/ir-generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * JSON Forms UI Schema generator that operates on the canonical FormIR.
+ *
+ * This generator consumes the IR produced by the Canonicalize phase and
+ * produces a JSON Forms UI Schema. All downstream UI Schema generation
+ * should use this module for UI Schema generation.
+ */
+import type { FormIR } from "@formspec/core/internals";
+import type { UISchema } from "./types.js";
+/**
+ * Generates a JSON Forms UI Schema from a canonical `FormIR`.
+ *
+ * Mapping rules:
+ * - `FieldNode` → `ControlElement` with `scope: "#/properties/<name>"`
+ * - resolved `displayName` metadata → `label` on the `ControlElement`
+ * - `displayName` annotation → fallback `label` when metadata is absent
+ * - `GroupLayoutNode` → `GroupLayout` with recursively converted `elements`
+ * - `ConditionalLayoutNode` → children flattened with a `SHOW` rule
+ * - Nested conditionals → combined `allOf` rule
+ * - Root wrapper is always `{ type: "VerticalLayout", elements: [...] }`
+ *
+ * @example
+ * ```typescript
+ * const ir = canonicalizeDSL(
+ *   formspec(
+ *     group("Customer", field.text("name", { label: "Name" })),
+ *     when(is("status", "draft"), field.text("notes", { label: "Notes" })),
+ *   )
+ * );
+ *
+ * const uiSchema = generateUiSchemaFromIR(ir);
+ * // {
+ * //   type: "VerticalLayout",
+ * //   elements: [
+ * //     {
+ * //       type: "Group",
+ * //       label: "Customer",
+ * //       elements: [{ type: "Control", scope: "#/properties/name", label: "Name" }]
+ * //     },
+ * //     {
+ * //       type: "Control",
+ * //       scope: "#/properties/notes",
+ * //       label: "Notes",
+ * //       rule: { effect: "SHOW", condition: { scope: "#/properties/status", schema: { const: "draft" } } }
+ * //     }
+ * //   ]
+ * // }
+ * ```
+ *
+ * @param ir - The canonical FormIR produced by the Canonicalize phase
+ * @returns A validated JSON Forms UI Schema
+ */
+export declare function generateUiSchemaFromIR(ir: FormIR): UISchema;
+//# sourceMappingURL=ir-generator.d.ts.map

package/dist/ui-schema/ir-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-generator.d.ts","sourceRoot":"","sources":["../../src/ui-schema/ir-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAA6C,MAAM,0BAA0B,CAAC;AAGlG,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAC;AA6MpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAS3D"}