@formspec/build 0.1.0-alpha.22 → 0.1.0-alpha.23

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

@@ -4,15 +4,19 @@
  * Routes through the canonical IR pipeline: Chain DSL → FormIR → JSON Schema 2020-12.
  */
 import type { FormElement, FormSpec } from "@formspec/core";
-import { type GenerateJsonSchemaFromIROptions, type JsonSchema2020 } from "./ir-generator.js";
+import { type JsonSchema2020 } from "./ir-generator.js";
 /**
  * Options for generating JSON Schema from a Chain DSL form.
  *
- * These options are forwarded to the IR-based JSON Schema generator.
- *
  * @public
  */
-export type GenerateJsonSchemaOptions = GenerateJsonSchemaFromIROptions;
+export interface GenerateJsonSchemaOptions {
+    /**
+     * Vendor prefix for emitted extension keywords.
+     * @defaultValue "x-formspec"
+     */
+    readonly vendorPrefix?: string | undefined;
+}
 /**
  * Generates a JSON Schema 2020-12 from a FormSpec.
  *

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;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EACjE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,OAAO,CAAC,EAAE,yBAAyB,GAClC,cAAc,CAGhB"}
+{"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,MAAM,gBAAgB,CAAC;AAE5D,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;CAC5C;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,CAKhB"}

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

@@ -7,7 +7,7 @@
  * @see https://json-schema.org/draft/2020-12/schema
  * @see https://json-schema.org/draft/2020-12/schema
  */
-import type { FormIR, JsonValue } from "@formspec/core";
+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.
@@ -27,7 +27,7 @@ export interface JsonSchema2020 {
     items?: JsonSchema2020;
     additionalProperties?: boolean | JsonSchema2020;
     enum?: readonly (string | number)[];
-    const?: JsonValue;
+    const?: unknown;
     allOf?: readonly JsonSchema2020[];
     oneOf?: readonly JsonSchema2020[];
     anyOf?: readonly JsonSchema2020[];
@@ -52,7 +52,7 @@ export interface JsonSchema2020 {
 /**
  * Options for generating JSON Schema from a canonical FormIR.
  *
- * @public
+ * @internal
  */
 export interface GenerateJsonSchemaFromIROptions {
     /**
@@ -108,7 +108,7 @@ export interface GenerateJsonSchemaFromIROptions {
  * @param ir - The canonical FormIR produced by a canonicalizer
  * @returns A plain JSON-serializable JSON Schema 2020-12 object
  *
- * @public
+ * @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

@@ -1 +1 @@
-{"version":3,"file":"ir-generator.d.ts","sourceRoot":"","sources":["../../src/json-schema/ir-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,MAAM,EAgBN,SAAS,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC;CAC/B;AAqBD;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,+BAA+B,GACxC,cAAc,CAwChB"}
+{"version":3,"file":"ir-generator.d.ts","sourceRoot":"","sources":["../../src/json-schema/ir-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,MAAM,EAgBP,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC;CAC/B;AAqBD;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,+BAA+B,GACxC,cAAc,CAwChB"}

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

@@ -11,13 +11,13 @@ import type { JSONSchema7 } from "./types.js";
 /**
  * Zod schema for JSON Schema primitive type strings.
  *
- * @public
+ * @internal
  */
 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
+ * @internal
  */
 export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -6,13 +6,13 @@
 /**
  * JSON Schema primitive types.
  *
- * @public
+ * @beta
  */
 export type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 /**
  * A JSON Schema definition (legacy subset used by Zod validator and types.ts).
  *
- * @public
+ * @beta
  */
 export interface JSONSchema7 {
     $schema?: string;
@@ -65,13 +65,13 @@ export interface JSONSchema7 {
 /**
  * Extension properties for custom FormSpec constraint tags.
  *
- * @public
+ * @beta
  */
 export type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
 /**
  * JSON Schema with FormSpec extension properties for arbitrary `x-formspec-*` keys.
  *
- * @public
+ * @beta
  */
 export type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
 /**
@@ -85,7 +85,7 @@ export type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
  * @param key - Extension key (must start with `x-formspec-`)
  * @param value - Extension value
  *
- * @public
+ * @internal
  */
 export declare function setSchemaExtension(schema: object, key: `x-formspec-${string}`, value: unknown): void;
 /**
@@ -97,7 +97,7 @@ export declare function setSchemaExtension(schema: object, key: `x-formspec-${st
  * @param key - Extension key (must start with `x-formspec-`)
  * @returns The extension value, or `undefined` if not present
  *
- * @public
+ * @internal
  */
 export declare function getSchemaExtension(schema: object, key: `x-formspec-${string}`): unknown;
 //# sourceMappingURL=types.d.ts.map

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

@@ -5,7 +5,7 @@
  * 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";
+import type { FormIR } from "@formspec/core/internals";
 import type { UISchema } from "./types.js";
 /**
  * Generates a JSON Forms UI Schema from a canonical `FormIR`.

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

@@ -1 +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,gBAAgB,CAAC;AACxF,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAC;AAuLpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAO3D"}
+{"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;AAClG,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAC;AAuLpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAO3D"}

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

@@ -10,31 +10,31 @@ import { z } from "zod";
 /**
  * Zod schema for rule effect values.
  *
- * @public
+ * @internal
  */
 export declare const ruleEffectSchema: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
 /**
  * Rule effect types for conditional visibility.
  *
- * @public
+ * @internal
  */
 export type RuleEffect = z.infer<typeof ruleEffectSchema>;
 /**
  * Zod schema for UI Schema element type strings.
  *
- * @public
+ * @internal
  */
 export declare const uiSchemaElementTypeSchema: z.ZodEnum<["Control", "VerticalLayout", "HorizontalLayout", "Group", "Categorization", "Category", "Label"]>;
 /**
  * UI Schema element types.
  *
- * @public
+ * @internal
  */
 export type UISchemaElementType = z.infer<typeof uiSchemaElementTypeSchema>;
 /**
  * JSON Schema subset used in rule conditions.
  *
- * @public
+ * @internal
  */
 export interface RuleConditionSchema {
     const?: unknown;
@@ -53,13 +53,13 @@ export interface RuleConditionSchema {
 /**
  * Zod schema for the rule-condition JSON Schema subset.
  *
- * @public
+ * @internal
  */
 export declare const ruleConditionSchema: z.ZodType<RuleConditionSchema>;
 /**
  * Zod schema for a schema-based rule condition.
  *
- * @public
+ * @internal
  */
 export declare const schemaBasedConditionSchema: z.ZodObject<{
     scope: z.ZodString;
@@ -74,13 +74,13 @@ export declare const schemaBasedConditionSchema: z.ZodObject<{
 /**
  * Condition for a rule.
  *
- * @public
+ * @internal
  */
 export type SchemaBasedCondition = z.infer<typeof schemaBasedConditionSchema>;
 /**
  * Zod schema for a UI Schema rule.
  *
- * @public
+ * @internal
  */
 export declare const ruleSchema: z.ZodObject<{
     effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
@@ -110,25 +110,25 @@ export declare const ruleSchema: z.ZodObject<{
 /**
  * Rule for conditional element visibility/enablement.
  *
- * @public
+ * @internal
  */
 export type Rule = z.infer<typeof ruleSchema>;
 /**
  * Union of all UI Schema element types.
  *
- * @public
+ * @internal
  */
 export type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout | Categorization | Category | LabelElement;
 /**
  * Zod schema for any UI Schema element.
  *
- * @public
+ * @internal
  */
 export declare const uiSchemaElementSchema: z.ZodType<UISchemaElement>;
 /**
  * Zod schema for a Control element.
  *
- * @public
+ * @internal
  */
 export declare const controlSchema: z.ZodObject<{
     type: z.ZodLiteral<"Control">;
@@ -224,13 +224,13 @@ export declare const controlSchema: z.ZodObject<{
 /**
  * A Control element that binds to a JSON Schema property.
  *
- * @public
+ * @internal
  */
 export type ControlElement = z.infer<typeof controlSchema>;
 /**
  * A vertical layout element.
  *
- * @public
+ * @internal
  */
 export interface VerticalLayout {
     type: "VerticalLayout";
@@ -242,13 +242,13 @@ export interface VerticalLayout {
 /**
  * Zod schema for a vertical layout element.
  *
- * @public
+ * @internal
  */
 export declare const verticalLayoutSchema: z.ZodType<VerticalLayout>;
 /**
  * A horizontal layout element.
  *
- * @public
+ * @internal
  */
 export interface HorizontalLayout {
     type: "HorizontalLayout";
@@ -260,13 +260,13 @@ export interface HorizontalLayout {
 /**
  * Zod schema for a horizontal layout element.
  *
- * @public
+ * @internal
  */
 export declare const horizontalLayoutSchema: z.ZodType<HorizontalLayout>;
 /**
  * A group element with a label.
  *
- * @public
+ * @internal
  */
 export interface GroupLayout {
     type: "Group";
@@ -279,13 +279,13 @@ export interface GroupLayout {
 /**
  * Zod schema for a group layout element.
  *
- * @public
+ * @internal
  */
 export declare const groupLayoutSchema: z.ZodType<GroupLayout>;
 /**
  * A Category element, used inside a Categorization layout.
  *
- * @public
+ * @internal
  */
 export interface Category {
     type: "Category";
@@ -298,13 +298,13 @@ export interface Category {
 /**
  * Zod schema for a category element.
  *
- * @public
+ * @internal
  */
 export declare const categorySchema: z.ZodType<Category>;
 /**
  * A Categorization element (tab-based layout).
  *
- * @public
+ * @internal
  */
 export interface Categorization {
     type: "Categorization";
@@ -317,13 +317,13 @@ export interface Categorization {
 /**
  * Zod schema for a categorization element.
  *
- * @public
+ * @internal
  */
 export declare const categorizationSchema: z.ZodType<Categorization>;
 /**
  * Zod schema for a Label element.
  *
- * @public
+ * @internal
  */
 export declare const labelElementSchema: z.ZodObject<{
     type: z.ZodLiteral<"Label">;
@@ -416,19 +416,19 @@ export declare const labelElementSchema: z.ZodObject<{
 /**
  * A Label element for displaying static text.
  *
- * @public
+ * @internal
  */
 export type LabelElement = z.infer<typeof labelElementSchema>;
 /**
  * Root UI Schema (always a layout — not a Control, Category, or Label).
  *
- * @public
+ * @internal
  */
 export type UISchema = VerticalLayout | HorizontalLayout | GroupLayout | Categorization;
 /**
  * Zod schema for the root UI Schema (layout types only).
  *
- * @public
+ * @internal
  */
 export declare const uiSchema: z.ZodType<UISchema>;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1,11 +1,160 @@
 /**
  * JSON Forms UI Schema type definitions.
  *
- * Types are derived from Zod schemas in ./schema.ts.
+ * These are the consumer-facing TypeScript shapes. Runtime validation remains
+ * defined separately in `./schema.ts`.
+ *
  * See: https://jsonforms.io/docs/uischema/
  */
-export type { RuleConditionSchema, SchemaBasedCondition, Rule, RuleEffect, ControlElement, VerticalLayout, HorizontalLayout, GroupLayout, Categorization, Category, LabelElement, UISchemaElement, UISchemaElementType, UISchema, } from "./schema.js";
-import type { Rule, UISchemaElementType } from "./schema.js";
+/**
+ * Rule effect types for conditional visibility.
+ *
+ * @public
+ */
+export type RuleEffect = "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+/**
+ * UI Schema element types.
+ *
+ * @public
+ */
+export type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category" | "Label";
+/**
+ * JSON Schema subset used in rule conditions.
+ *
+ * @public
+ */
+export interface RuleConditionSchema {
+    const?: unknown;
+    enum?: readonly unknown[];
+    type?: string;
+    not?: RuleConditionSchema;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    properties?: Record<string, RuleConditionSchema>;
+    required?: string[];
+    allOf?: RuleConditionSchema[];
+}
+/**
+ * Condition for a rule.
+ *
+ * @public
+ */
+export interface SchemaBasedCondition {
+    readonly scope: string;
+    readonly schema: RuleConditionSchema;
+}
+/**
+ * Rule for conditional element visibility/enablement.
+ *
+ * @public
+ */
+export interface Rule {
+    readonly effect: RuleEffect;
+    readonly condition: SchemaBasedCondition;
+}
+/**
+ * A Control element that binds to a JSON Schema property.
+ *
+ * @public
+ */
+export interface ControlElement {
+    readonly type: "Control";
+    readonly scope: string;
+    readonly label?: string | false | undefined;
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A vertical layout element.
+ *
+ * @public
+ */
+export interface VerticalLayout {
+    readonly type: "VerticalLayout";
+    readonly elements: UISchemaElement[];
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A horizontal layout element.
+ *
+ * @public
+ */
+export interface HorizontalLayout {
+    readonly type: "HorizontalLayout";
+    readonly elements: UISchemaElement[];
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A group element with a label.
+ *
+ * @public
+ */
+export interface GroupLayout {
+    readonly type: "Group";
+    readonly label: string;
+    readonly elements: UISchemaElement[];
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A Category element, used inside a Categorization layout.
+ *
+ * @public
+ */
+export interface Category {
+    readonly type: "Category";
+    readonly label: string;
+    readonly elements: UISchemaElement[];
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A Categorization element (tab-based layout).
+ *
+ * @public
+ */
+export interface Categorization {
+    readonly type: "Categorization";
+    readonly elements: Category[];
+    readonly label?: string | undefined;
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * A Label element for displaying static text.
+ *
+ * @public
+ */
+export interface LabelElement {
+    readonly type: "Label";
+    readonly text: string;
+    readonly rule?: Rule | undefined;
+    readonly options?: Record<string, unknown> | undefined;
+    readonly [k: string]: unknown;
+}
+/**
+ * Union of all UI Schema element types.
+ *
+ * @public
+ */
+export type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout | Categorization | Category | LabelElement;
+/**
+ * Root UI Schema (always a layout — not a Control, Category, or Label).
+ *
+ * @public
+ */
+export type UISchema = VerticalLayout | HorizontalLayout | GroupLayout | Categorization;
 /**
  * Base interface for all UI Schema elements.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ui-schema/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ui-schema/types.ts"],"names":[],"mappings":"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"}

package/dist/validate/constraint-validator.d.ts

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import { type ConstraintSemanticDiagnostic } from "@formspec/analysis/internal";
-import type { FormIR } from "@formspec/core";
+import type { FormIR } from "@formspec/core/internals";
 import type { ExtensionRegistry } from "../extensions/index.js";
 export type ValidationDiagnostic = ConstraintSemanticDiagnostic;
 export interface ValidationResult {

package/dist/validate/constraint-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-validator.d.ts","sourceRoot":"","sources":["../../src/validate/constraint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAA4C,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AA6ED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAepF"}
+{"version":3,"file":"constraint-validator.d.ts","sourceRoot":"","sources":["../../src/validate/constraint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAA4C,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AA6ED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAepF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formspec/build",
-  "version": "0.1.0-alpha.22",
+  "version": "0.1.0-alpha.23",
   "description": "Build tools to compile FormSpec forms to JSON Schema and UI Schema",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -34,15 +34,15 @@
     "@microsoft/tsdoc": "^0.16.0",
     "@microsoft/tsdoc-config": "^0.18.1",
     "zod": "^3.25.0",
-    "@formspec/analysis": "0.1.0-alpha.22",
-    "@formspec/core": "0.1.0-alpha.21"
+    "@formspec/analysis": "0.1.0-alpha.23",
+    "@formspec/core": "0.1.0-alpha.23"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
   },
   "devDependencies": {
     "vitest": "^3.0.0",
-    "@formspec/dsl": "0.1.0-alpha.21"
+    "@formspec/dsl": "0.1.0-alpha.23"
   },
   "publishConfig": {
     "access": "public"
@@ -50,12 +50,12 @@
   "keywords": [],
   "license": "UNLICENSED",
   "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly && api-extractor run --local",
+    "build": "tsup && tsc --emitDeclarationOnly && pnpm run api-extractor:local",
     "clean": "rm -rf dist temp",
     "typecheck": "tsc --noEmit",
     "test": "pnpm run build && vitest run",
-    "api-extractor": "api-extractor run",
-    "api-extractor:local": "api-extractor run --local",
-    "api-documenter": "api-documenter markdown -i temp -o docs"
+    "api-extractor": "api-extractor run && node ../../scripts/normalize-generated-markdown.mjs api-report",
+    "api-extractor:local": "api-extractor run --local && node ../../scripts/normalize-generated-markdown.mjs api-report",
+    "api-documenter": "api-documenter markdown -i temp -o docs && node ../../scripts/normalize-generated-markdown.mjs docs"
   }
 }

package/dist/__tests__/alias-chain-propagation.test.d.ts

@@ -1,9 +0,0 @@
-/**
- * Tests for transitive type alias constraint propagation.
- *
- * Verifies that constraints declared on type aliases propagate transitively
- * through alias chains (e.g., Integer → Percentage → field), and that
- * excessively deep chains throw a clear error.
- */
-export {};
-//# sourceMappingURL=alias-chain-propagation.test.d.ts.map

package/dist/__tests__/alias-chain-propagation.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alias-chain-propagation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/alias-chain-propagation.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/chain-dsl-canonicalizer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=chain-dsl-canonicalizer.test.d.ts.map

package/dist/__tests__/chain-dsl-canonicalizer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain-dsl-canonicalizer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/chain-dsl-canonicalizer.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/class-schema.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=class-schema.test.d.ts.map

package/dist/__tests__/class-schema.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"class-schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/class-schema.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cli.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cli.test.d.ts.map

package/dist/__tests__/cli.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/constraint-validator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=constraint-validator.test.d.ts.map

package/dist/__tests__/constraint-validator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constraint-validator.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/constraint-validator.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/date-extension.integration.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=date-extension.integration.test.d.ts.map

package/dist/__tests__/date-extension.integration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"date-extension.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/date-extension.integration.test.ts"],"names":[],"mappings":""}