@formspec/build 0.1.0-alpha.10 → 0.1.0-alpha.11

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAU5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAiBhF,kCAAkC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAY5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAmC,IAAiB;IAClF,OAAO;QACL,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC;QACpC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC"}
+{"version":3,"sources":["../src/json-schema/schema.ts","../src/json-schema/generator.ts","../src/ui-schema/schema.ts","../src/ui-schema/generator.ts","../src/json-schema/types.ts","../src/browser.ts"],"sourcesContent":["/**\n * Zod schemas for JSON Schema draft-07 output validation.\n *\n * These schemas cover the subset of JSON Schema draft-07 that FormSpec generates,\n * plus the FormSpec-specific `x-formspec-*` extension properties.\n *\n * @see https://json-schema.org/draft-07/schema\n */\n\nimport { z } from \"zod\";\nimport type { JSONSchema7 } from \"./types.js\";\n\n// =============================================================================\n// JSON Schema type enum\n// =============================================================================\n\n/**\n * Zod schema for JSON Schema primitive type strings.\n */\nexport const jsonSchemaTypeSchema = z.enum([\n  \"string\",\n  \"number\",\n  \"integer\",\n  \"boolean\",\n  \"object\",\n  \"array\",\n  \"null\",\n]);\n\n// =============================================================================\n// JSON Schema draft-07 schema (recursive)\n// =============================================================================\n\n// We annotate with z.ZodType<JSONSchema7> for the recursive self-reference.\n// The @ts-expect-error is required because exactOptionalPropertyTypes:true causes\n// Zod's inferred output type for optional fields (`T | undefined`) to be\n// incompatible with the JSONSchema7 interface's exact optional fields (`T?`).\n// The runtime behavior is correct: z.optional() will strip `undefined` values\n// during parsing and correctly handle absent keys.\n//\n// @ts-expect-error -- exactOptionalPropertyTypes: Zod optional infers `T | undefined`\n// but JSONSchema7 uses exact optional `?:` which disallows explicit undefined.\nexport const jsonSchema7Schema: z.ZodType<JSONSchema7> = z.lazy(() =>\n  z\n    .object({\n      $schema: z.string().optional(),\n      $id: z.string().optional(),\n      $ref: z.string().optional(),\n\n      // Metadata\n      title: z.string().optional(),\n      description: z.string().optional(),\n      deprecated: z.boolean().optional(),\n\n      // Type\n      type: z.union([jsonSchemaTypeSchema, z.array(jsonSchemaTypeSchema)]).optional(),\n\n      // String validation\n      minLength: z.number().optional(),\n      maxLength: z.number().optional(),\n      pattern: z.string().optional(),\n\n      // Number validation\n      minimum: z.number().optional(),\n      maximum: z.number().optional(),\n      exclusiveMinimum: z.number().optional(),\n      exclusiveMaximum: z.number().optional(),\n\n      // Enum\n      enum: z\n        .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))\n        .readonly()\n        .optional(),\n      const: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),\n\n      // Object\n      properties: z.record(z.string(), jsonSchema7Schema).optional(),\n      required: z.array(z.string()).optional(),\n      additionalProperties: z.union([z.boolean(), jsonSchema7Schema]).optional(),\n\n      // Array\n      items: z.union([jsonSchema7Schema, z.array(jsonSchema7Schema)]).optional(),\n      minItems: z.number().optional(),\n      maxItems: z.number().optional(),\n\n      // Composition\n      allOf: z.array(jsonSchema7Schema).optional(),\n      anyOf: z.array(jsonSchema7Schema).optional(),\n      oneOf: z.array(jsonSchema7Schema).optional(),\n      not: jsonSchema7Schema.optional(),\n\n      // Conditional\n      if: jsonSchema7Schema.optional(),\n      then: jsonSchema7Schema.optional(),\n      else: jsonSchema7Schema.optional(),\n\n      // Format\n      format: z.string().optional(),\n\n      // Default\n      default: z.unknown().optional(),\n\n      // FormSpec extensions\n      \"x-formspec-source\": z.string().optional(),\n      \"x-formspec-params\": z.array(z.string()).readonly().optional(),\n      \"x-formspec-schemaSource\": z.string().optional(),\n    })\n    // passthrough preserves arbitrary x-formspec-* extension properties\n    // added by custom decorators without causing validation failures\n    .passthrough()\n);\n","/**\n * JSON Schema generator for FormSpec forms.\n */\n\nimport type {\n  FormElement,\n  FormSpec,\n  AnyField,\n  Group,\n  Conditional,\n  ArrayField,\n  ObjectField,\n} from \"@formspec/core\";\nimport type { JSONSchema7 } from \"./types.js\";\nimport { jsonSchema7Schema } from \"./schema.js\";\nimport { z } from \"zod\";\n\n/**\n * Parses a value through a Zod schema, converting validation errors to a descriptive Error.\n */\nfunction parseOrThrow<T>(schema: z.ZodType<T>, value: unknown, label: string): T {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      throw new Error(\n        `Generated ${label} failed validation:\\n${error.issues.map((i) => `  ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\")}`\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Generates JSON Schema for nested elements (used for array items and object properties).\n */\nfunction generateNestedSchema(elements: readonly FormElement[]): JSONSchema7 {\n  const properties: Record<string, JSONSchema7> = {};\n  const required: string[] = [];\n\n  collectFields(elements, properties, required);\n\n  // Deduplicate required array (can have duplicates when the same field is defined\n  // in multiple branches/containers, e.g., repeated in different conditional branches)\n  const uniqueRequired = [...new Set(required)];\n\n  return {\n    type: \"object\",\n    properties,\n    ...(uniqueRequired.length > 0 && { required: uniqueRequired }),\n  };\n}\n\n/**\n * Converts a single field to its JSON Schema representation.\n */\nfunction fieldToJsonSchema(field: AnyField): JSONSchema7 {\n  const base: JSONSchema7 = {};\n\n  if (field.label !== undefined) {\n    base.title = field.label;\n  }\n\n  switch (field._field) {\n    case \"text\":\n      return { ...base, type: \"string\" };\n\n    case \"number\":\n      return {\n        ...base,\n        type: \"number\",\n        ...(field.min !== undefined && { minimum: field.min }),\n        ...(field.max !== undefined && { maximum: field.max }),\n      };\n\n    case \"boolean\":\n      return { ...base, type: \"boolean\" };\n\n    case \"enum\": {\n      const opts = field.options;\n      const isObjectOptions =\n        opts.length > 0 &&\n        opts.every(\n          (opt): opt is { id: string; label: string } =>\n            typeof opt === \"object\" && \"id\" in opt && \"label\" in opt\n        );\n      if (isObjectOptions) {\n        // Object options with id/label: use oneOf with const/title\n        return {\n          ...base,\n          type: \"string\",\n          oneOf: opts.map((o) => ({\n            const: o.id,\n            title: o.label,\n          })),\n        };\n      }\n      return { ...base, type: \"string\", enum: opts as readonly string[] };\n    }\n\n    case \"dynamic_enum\":\n      // Dynamic enums are strings at the schema level\n      // The actual options are resolved at runtime\n      // x-formspec-source indicates the data source key\n      // x-formspec-params indicates dependent field names for fetching options\n      return {\n        ...base,\n        type: \"string\",\n        \"x-formspec-source\": field.source,\n        ...(field.params !== undefined &&\n          field.params.length > 0 && { \"x-formspec-params\": field.params }),\n      };\n\n    case \"dynamic_schema\":\n      // Dynamic schemas are objects with unknown properties\n      // x-formspec-schemaSource indicates where to load the schema from\n      return {\n        ...base,\n        type: \"object\",\n        additionalProperties: true,\n        \"x-formspec-schemaSource\": field.schemaSource,\n      };\n\n    case \"array\": {\n      const arrayField = field as ArrayField<string, readonly FormElement[]>;\n      return {\n        ...base,\n        type: \"array\",\n        items: generateNestedSchema(arrayField.items),\n        ...(arrayField.minItems !== undefined && { minItems: arrayField.minItems }),\n        ...(arrayField.maxItems !== undefined && { maxItems: arrayField.maxItems }),\n      };\n    }\n\n    case \"object\": {\n      const objectField = field as ObjectField<string, readonly FormElement[]>;\n      const nestedSchema = generateNestedSchema(objectField.properties);\n      return {\n        ...base,\n        ...nestedSchema,\n      };\n    }\n\n    default: {\n      // Exhaustiveness check\n      const _exhaustive: never = field;\n      return _exhaustive;\n    }\n  }\n}\n\n/**\n * Visits all elements in a form tree, collecting fields and required fields.\n */\nfunction collectFields(\n  elements: readonly FormElement[],\n  properties: Record<string, JSONSchema7>,\n  required: string[]\n): void {\n  for (const element of elements) {\n    switch (element._type) {\n      case \"field\":\n        properties[element.name] = fieldToJsonSchema(element);\n        if (element.required === true) {\n          required.push(element.name);\n        }\n        break;\n\n      case \"group\":\n        // Groups don't affect schema structure, just collect their children\n        collectFields((element as Group<readonly FormElement[]>).elements, properties, required);\n        break;\n\n      case \"conditional\":\n        // Conditional fields are still part of the schema\n        // They're just hidden/shown in the UI\n        collectFields(\n          (element as Conditional<string, unknown, readonly FormElement[]>).elements,\n          properties,\n          required\n        );\n        break;\n    }\n  }\n}\n\n/**\n * Generates a JSON Schema from a FormSpec.\n *\n * @example\n * ```typescript\n * const form = formspec(\n *   field.text(\"name\", { label: \"Name\", required: true }),\n *   field.number(\"age\", { min: 0 }),\n * );\n *\n * const schema = generateJsonSchema(form);\n * // {\n * //   $schema: \"https://json-schema.org/draft-07/schema#\",\n * //   type: \"object\",\n * //   properties: {\n * //     name: { type: \"string\", title: \"Name\" },\n * //     age: { type: \"number\", minimum: 0 }\n * //   },\n * //   required: [\"name\"]\n * // }\n * ```\n *\n * @param form - The FormSpec to convert\n * @returns A JSON Schema object\n */\nexport function generateJsonSchema<E extends readonly FormElement[]>(\n  form: FormSpec<E>\n): JSONSchema7 {\n  const properties: Record<string, JSONSchema7> = {};\n  const required: string[] = [];\n\n  collectFields(form.elements, properties, required);\n\n  // Deduplicate required array (can have duplicates when the same field is defined\n  // in multiple branches/containers, e.g., repeated in different conditional branches)\n  const uniqueRequired = [...new Set(required)];\n\n  const result: JSONSchema7 = {\n    $schema: \"https://json-schema.org/draft-07/schema#\",\n    type: \"object\",\n    properties,\n    ...(uniqueRequired.length > 0 && { required: uniqueRequired }),\n  };\n\n  return parseOrThrow(jsonSchema7Schema, result, \"JSON Schema\");\n}\n","/**\n * Zod schemas for JSON Forms UI Schema.\n *\n * These schemas are the source of truth for UI Schema validation.\n * TypeScript types are derived from these schemas via `z.infer<>`.\n *\n * @see https://jsonforms.io/docs/uischema/\n */\n\nimport { z } from \"zod\";\n\n// =============================================================================\n// Primitive helpers\n// =============================================================================\n\n/** JSON Pointer string (e.g., \"#/properties/fieldName\") */\nconst jsonPointerSchema = z.string();\n\n// =============================================================================\n// Rule Effect and Element Type enums\n// =============================================================================\n\n/**\n * Zod schema for rule effect values.\n */\nexport const ruleEffectSchema = z.enum([\"SHOW\", \"HIDE\", \"ENABLE\", \"DISABLE\"]);\n\n/**\n * Rule effect types for conditional visibility.\n */\nexport type RuleEffect = z.infer<typeof ruleEffectSchema>;\n\n/**\n * Zod schema for UI Schema element type strings.\n */\nexport const uiSchemaElementTypeSchema = z.enum([\n  \"Control\",\n  \"VerticalLayout\",\n  \"HorizontalLayout\",\n  \"Group\",\n  \"Categorization\",\n  \"Category\",\n  \"Label\",\n]);\n\n/**\n * UI Schema element types.\n */\nexport type UISchemaElementType = z.infer<typeof uiSchemaElementTypeSchema>;\n\n// =============================================================================\n// Rule Condition Schema (recursive)\n// =============================================================================\n\n// Forward-declare the recursive TypeScript type.\n// We use an interface here (rather than z.infer<>) because the recursive\n// z.lazy() type annotation requires us to pre-declare the shape.\n/**\n * JSON Schema subset used in rule conditions.\n */\nexport interface RuleConditionSchema {\n  const?: unknown;\n  enum?: readonly unknown[];\n  type?: string;\n  not?: RuleConditionSchema;\n  minimum?: number;\n  maximum?: number;\n  exclusiveMinimum?: number;\n  exclusiveMaximum?: number;\n  minLength?: number;\n  properties?: Record<string, RuleConditionSchema>;\n  required?: string[];\n  allOf?: RuleConditionSchema[];\n}\n\n// Build the Zod schema referencing the pre-declared interface.\n// We use z.ZodType<RuleConditionSchema> so the recursive reference works.\n// The interface uses `?` (exact optional), and z.ZodType checks output only,\n// so the optional fields (which Zod infers as `T | undefined`) are compatible\n// because `T | undefined` is assignable to the optional field slot.\n//\n// @ts-expect-error -- exactOptionalPropertyTypes: the Zod output type for optional\n// fields is `T | undefined`, but our interface uses `?` (exact optional, key may\n// be absent). This is a known mismatch when using z.ZodType<T> with\n// exactOptionalPropertyTypes:true; the runtime behavior is correct.\nexport const ruleConditionSchema: z.ZodType<RuleConditionSchema> = z.lazy(() =>\n  z\n    .object({\n      const: z.unknown().optional(),\n      enum: z.array(z.unknown()).readonly().optional(),\n      type: z.string().optional(),\n      not: ruleConditionSchema.optional(),\n      minimum: z.number().optional(),\n      maximum: z.number().optional(),\n      exclusiveMinimum: z.number().optional(),\n      exclusiveMaximum: z.number().optional(),\n      minLength: z.number().optional(),\n      properties: z.record(z.string(), ruleConditionSchema).optional(),\n      required: z.array(z.string()).optional(),\n      allOf: z.array(ruleConditionSchema).optional(),\n    })\n    .strict()\n);\n\n// =============================================================================\n// Schema-Based Condition and Rule\n// =============================================================================\n\n/**\n * Zod schema for a schema-based rule condition.\n */\nexport const schemaBasedConditionSchema = z\n  .object({\n    scope: jsonPointerSchema,\n    schema: ruleConditionSchema,\n  })\n  .strict();\n\n/**\n * Condition for a rule.\n */\nexport type SchemaBasedCondition = z.infer<typeof schemaBasedConditionSchema>;\n\n/**\n * Zod schema for a UI Schema rule.\n */\nexport const ruleSchema = z\n  .object({\n    effect: ruleEffectSchema,\n    condition: schemaBasedConditionSchema,\n  })\n  .strict();\n\n/**\n * Rule for conditional element visibility/enablement.\n */\nexport type Rule = z.infer<typeof ruleSchema>;\n\n// =============================================================================\n// UI Schema Element Schemas (recursive via z.lazy)\n// =============================================================================\n\n// Forward-declare UISchemaElement so layout schemas can reference it.\n// We declare the type up-front and wire the Zod schema below.\n/**\n * Union of all UI Schema element types.\n */\nexport type UISchemaElement =\n  | ControlElement\n  | VerticalLayout\n  | HorizontalLayout\n  | GroupLayout\n  | Categorization\n  | Category\n  | LabelElement;\n\n// The Zod schema for UISchemaElement is defined as a const using z.lazy(),\n// which defers evaluation until first use. This allows all element schemas\n// below to be referenced even though they are declared after this line.\nexport const uiSchemaElementSchema: z.ZodType<UISchemaElement> = z.lazy(() =>\n  z.union([\n    controlSchema,\n    verticalLayoutSchema,\n    horizontalLayoutSchema,\n    groupLayoutSchema,\n    categorizationSchema,\n    categorySchema,\n    labelElementSchema,\n  ])\n) as z.ZodType<UISchemaElement>;\n\n// -----------------------------------------------------------------------------\n// Control\n// -----------------------------------------------------------------------------\n\n/**\n * Zod schema for a Control element.\n */\nexport const controlSchema = z\n  .object({\n    type: z.literal(\"Control\"),\n    scope: jsonPointerSchema,\n    label: z.union([z.string(), z.literal(false)]).optional(),\n    rule: ruleSchema.optional(),\n    options: z.record(z.string(), z.unknown()).optional(),\n  })\n  .passthrough();\n\n/**\n * A Control element that binds to a JSON Schema property.\n */\nexport type ControlElement = z.infer<typeof controlSchema>;\n\n// -----------------------------------------------------------------------------\n// VerticalLayout\n// -----------------------------------------------------------------------------\n\n// Pre-declare the interface so the Zod schema can reference UISchemaElement.\n/**\n * A vertical layout element.\n */\nexport interface VerticalLayout {\n  type: \"VerticalLayout\";\n  elements: UISchemaElement[];\n  rule?: Rule | undefined;\n  options?: Record<string, unknown> | undefined;\n  [k: string]: unknown;\n}\n\nexport const verticalLayoutSchema: z.ZodType<VerticalLayout> = z.lazy(() =>\n  z\n    .object({\n      type: z.literal(\"VerticalLayout\"),\n      elements: z.array(uiSchemaElementSchema),\n      rule: ruleSchema.optional(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    })\n    .passthrough()\n);\n\n// -----------------------------------------------------------------------------\n// HorizontalLayout\n// -----------------------------------------------------------------------------\n\n/**\n * A horizontal layout element.\n */\nexport interface HorizontalLayout {\n  type: \"HorizontalLayout\";\n  elements: UISchemaElement[];\n  rule?: Rule | undefined;\n  options?: Record<string, unknown> | undefined;\n  [k: string]: unknown;\n}\n\nexport const horizontalLayoutSchema: z.ZodType<HorizontalLayout> = z.lazy(() =>\n  z\n    .object({\n      type: z.literal(\"HorizontalLayout\"),\n      elements: z.array(uiSchemaElementSchema),\n      rule: ruleSchema.optional(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    })\n    .passthrough()\n);\n\n// -----------------------------------------------------------------------------\n// GroupLayout\n// -----------------------------------------------------------------------------\n\n/**\n * A group element with a label.\n */\nexport interface GroupLayout {\n  type: \"Group\";\n  label: string;\n  elements: UISchemaElement[];\n  rule?: Rule | undefined;\n  options?: Record<string, unknown> | undefined;\n  [k: string]: unknown;\n}\n\nexport const groupLayoutSchema: z.ZodType<GroupLayout> = z.lazy(() =>\n  z\n    .object({\n      type: z.literal(\"Group\"),\n      label: z.string(),\n      elements: z.array(uiSchemaElementSchema),\n      rule: ruleSchema.optional(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    })\n    .passthrough()\n);\n\n// -----------------------------------------------------------------------------\n// Category\n// -----------------------------------------------------------------------------\n\n/**\n * A Category element, used inside a Categorization layout.\n */\nexport interface Category {\n  type: \"Category\";\n  label: string;\n  elements: UISchemaElement[];\n  rule?: Rule | undefined;\n  options?: Record<string, unknown> | undefined;\n  [k: string]: unknown;\n}\n\nexport const categorySchema: z.ZodType<Category> = z.lazy(() =>\n  z\n    .object({\n      type: z.literal(\"Category\"),\n      label: z.string(),\n      elements: z.array(uiSchemaElementSchema),\n      rule: ruleSchema.optional(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    })\n    .passthrough()\n);\n\n// -----------------------------------------------------------------------------\n// Categorization\n// -----------------------------------------------------------------------------\n\n/**\n * A Categorization element (tab-based layout).\n */\nexport interface Categorization {\n  type: \"Categorization\";\n  elements: Category[];\n  label?: string | undefined;\n  rule?: Rule | undefined;\n  options?: Record<string, unknown> | undefined;\n  [k: string]: unknown;\n}\n\nexport const categorizationSchema: z.ZodType<Categorization> = z.lazy(() =>\n  z\n    .object({\n      type: z.literal(\"Categorization\"),\n      elements: z.array(categorySchema),\n      label: z.string().optional(),\n      rule: ruleSchema.optional(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    })\n    .passthrough()\n);\n\n// -----------------------------------------------------------------------------\n// LabelElement\n// -----------------------------------------------------------------------------\n\n/**\n * Zod schema for a Label element.\n */\nexport const labelElementSchema = z\n  .object({\n    type: z.literal(\"Label\"),\n    text: z.string(),\n    rule: ruleSchema.optional(),\n    options: z.record(z.string(), z.unknown()).optional(),\n  })\n  .passthrough();\n\n/**\n * A Label element for displaying static text.\n */\nexport type LabelElement = z.infer<typeof labelElementSchema>;\n\n// =============================================================================\n// Root UISchema\n// =============================================================================\n\n/**\n * Root UI Schema (always a layout — not a Control, Category, or Label).\n */\nexport type UISchema = VerticalLayout | HorizontalLayout | GroupLayout | Categorization;\n\n/**\n * Zod schema for the root UI Schema (layout types only).\n */\nexport const uiSchema: z.ZodType<UISchema> = z.lazy(() =>\n  z.union([verticalLayoutSchema, horizontalLayoutSchema, groupLayoutSchema, categorizationSchema])\n) as z.ZodType<UISchema>;\n","/**\n * JSON Forms UI Schema generator for FormSpec forms.\n */\n\nimport type { FormElement, FormSpec, Group, Conditional } from \"@formspec/core\";\nimport type { UISchemaElement, UISchema, ControlElement, GroupLayout, Rule } from \"./types.js\";\nimport { uiSchema as uiSchemaValidator } from \"./schema.js\";\nimport type { FormSpecField } from \"../analyzer/type-converter.js\";\nimport { z } from \"zod\";\n\n/**\n * Parses a value through a Zod schema, converting validation errors to a descriptive Error.\n */\nfunction parseOrThrow<T>(schema: z.ZodType<T>, value: unknown, label: string): T {\n  try {\n    return schema.parse(value);\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      throw new Error(\n        `Generated ${label} failed validation:\\n${error.issues.map((i) => `  ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\")}`\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Converts a field name to a JSON Pointer scope.\n */\nfunction fieldToScope(fieldName: string): string {\n  return `#/properties/${fieldName}`;\n}\n\n/**\n * Creates a rule for conditional visibility.\n */\nfunction createShowRule(fieldName: string, value: unknown): Rule {\n  return {\n    effect: \"SHOW\",\n    condition: {\n      scope: fieldToScope(fieldName),\n      schema: { const: value },\n    },\n  };\n}\n\n/**\n * Combines two rules into one using allOf.\n *\n * When elements are nested inside multiple conditionals, all conditions\n * must be met for the element to be visible.\n */\nfunction combineRules(parentRule: Rule, childRule: Rule): Rule {\n  // Both rules should have the same effect (SHOW)\n  // Combine conditions using allOf\n  const parentCondition = parentRule.condition;\n  const childCondition = childRule.condition;\n\n  return {\n    effect: \"SHOW\",\n    condition: {\n      scope: \"#\",\n      schema: {\n        allOf: [\n          {\n            properties: {\n              [parentCondition.scope.replace(\"#/properties/\", \"\")]: parentCondition.schema,\n            },\n          },\n          {\n            properties: {\n              [childCondition.scope.replace(\"#/properties/\", \"\")]: childCondition.schema,\n            },\n          },\n        ],\n      },\n    },\n  };\n}\n\n/**\n * Converts form elements to UI Schema elements.\n *\n * @param elements - The form elements to convert\n * @param parentRule - Optional rule inherited from parent conditional\n * @returns Array of UI Schema elements\n */\nfunction elementsToUiSchema(\n  elements: readonly FormElement[],\n  parentRule?: Rule\n): UISchemaElement[] {\n  const result: UISchemaElement[] = [];\n\n  for (const element of elements) {\n    switch (element._type) {\n      case \"field\": {\n        const control: ControlElement = {\n          type: \"Control\",\n          scope: fieldToScope(element.name),\n          ...(element.label !== undefined && { label: element.label }),\n          ...(parentRule !== undefined && { rule: parentRule }),\n        };\n        result.push(control);\n        break;\n      }\n\n      case \"group\": {\n        const groupElement = element as Group<readonly FormElement[]>;\n        const group: GroupLayout = {\n          type: \"Group\",\n          label: groupElement.label,\n          elements: elementsToUiSchema(groupElement.elements, parentRule),\n          ...(parentRule !== undefined && { rule: parentRule }),\n        };\n        result.push(group);\n        break;\n      }\n\n      case \"conditional\": {\n        const conditionalElement = element as Conditional<string, unknown, readonly FormElement[]>;\n        // Create a rule for this conditional\n        const newRule = createShowRule(conditionalElement.field, conditionalElement.value);\n        // Combine with parent rule if present (for nested conditionals)\n        const combinedRule = parentRule !== undefined ? combineRules(parentRule, newRule) : newRule;\n        // Apply the combined rule to all children\n        const childElements = elementsToUiSchema(conditionalElement.elements, combinedRule);\n        result.push(...childElements);\n        break;\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Converts a single FormSpecField to a ControlElement, resolving showWhen into a rule.\n *\n * @param field - The FormSpecField to convert\n * @param scopePrefix - The JSON Pointer prefix for the field's scope\n * @returns A ControlElement\n */\nfunction formSpecFieldToElement(\n  field: FormSpecField,\n  scopePrefix = \"#/properties\"\n): ControlElement {\n  const control: ControlElement = {\n    type: \"Control\",\n    scope: `${scopePrefix}/${field.id}`,\n  };\n\n  if (field.label !== undefined) {\n    control.label = field.label;\n  }\n\n  if (\n    field.showWhen !== undefined &&\n    typeof field.showWhen === \"object\" &&\n    \"field\" in field.showWhen &&\n    \"value\" in field.showWhen\n  ) {\n    const sw = field.showWhen as { field: string; value: unknown };\n    control.rule = {\n      effect: \"SHOW\",\n      condition: {\n        scope: `#/properties/${sw.field}`,\n        schema: { const: sw.value },\n      },\n    };\n  }\n\n  return control;\n}\n\n/**\n * Converts FormSpecField[] (from decorator/interface/type analysis) to a JSON Forms UISchema.\n *\n * Mapping:\n * - Each field → `{ type: \"Control\", scope: \"#/properties/{id}\", label? }`\n * - `showWhen: { field, value }` → rule with SHOW effect\n * - `group` property → Groups fields by group name, preserving insertion order\n * - `fields` (nested object) → single Control pointing to the object property\n * - Root wrapper → `{ type: \"VerticalLayout\", elements }`\n *\n * @param fields - The FormSpecField array to convert\n * @returns A JSON Forms UISchema\n */\nexport function generateUiSchemaFromFields(fields: FormSpecField[]): UISchema {\n  // Collect elements, grouping by the `group` property.\n  // Map preserves insertion order — first occurrence of a group name determines its position.\n  const groupMap = new Map<string, ControlElement[]>();\n  const orderedKeys: (string | null)[] = []; // null = ungrouped slot\n  const ungrouped: ControlElement[] = [];\n\n  for (const field of fields) {\n    const element = formSpecFieldToElement(field);\n\n    if (field.group !== undefined) {\n      if (!groupMap.has(field.group)) {\n        groupMap.set(field.group, []);\n        orderedKeys.push(field.group);\n      }\n      // We know the key exists since we just set it above.\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n      groupMap.get(field.group)!.push(element);\n    } else {\n      // Track position for ungrouped fields relative to grouped fields.\n      // Use a sentinel to mark the slot for ungrouped elements inline.\n      orderedKeys.push(null);\n      ungrouped.push(element);\n    }\n  }\n\n  // Build the flat elements list respecting insertion order.\n  const elements: UISchemaElement[] = [];\n  let ungroupedIndex = 0;\n\n  for (const key of orderedKeys) {\n    if (key === null) {\n      // Ungrouped field — emit directly.\n      const el = ungrouped[ungroupedIndex++];\n      if (el !== undefined) {\n        elements.push(el);\n      }\n    } else {\n      // Each group key appears in orderedKeys exactly once (guarded by\n      // `!groupMap.has()` above), so we emit the Group element directly.\n      const groupElements = groupMap.get(key) ?? [];\n      const groupLayout: GroupLayout = {\n        type: \"Group\",\n        label: key,\n        elements: groupElements,\n      };\n      elements.push(groupLayout);\n    }\n  }\n\n  const result: UISchema = {\n    type: \"VerticalLayout\",\n    elements,\n  };\n\n  return parseOrThrow(uiSchemaValidator, result, \"UI Schema\");\n}\n\n/**\n * Generates a JSON Forms UI Schema from a FormSpec.\n *\n * @example\n * ```typescript\n * const form = formspec(\n *   group(\"Customer\",\n *     field.text(\"name\", { label: \"Name\" }),\n *   ),\n *   when(\"status\", \"draft\",\n *     field.text(\"notes\", { label: \"Notes\" }),\n *   ),\n * );\n *\n * const uiSchema = generateUiSchema(form);\n * // {\n * //   type: \"VerticalLayout\",\n * //   elements: [\n * //     {\n * //       type: \"Group\",\n * //       label: \"Customer\",\n * //       elements: [\n * //         { type: \"Control\", scope: \"#/properties/name\", label: \"Name\" }\n * //       ]\n * //     },\n * //     {\n * //       type: \"Control\",\n * //       scope: \"#/properties/notes\",\n * //       label: \"Notes\",\n * //       rule: {\n * //         effect: \"SHOW\",\n * //         condition: { scope: \"#/properties/status\", schema: { const: \"draft\" } }\n * //       }\n * //     }\n * //   ]\n * // }\n * ```\n *\n * @param form - The FormSpec to convert\n * @returns A JSON Forms UI Schema\n */\nexport function generateUiSchema<E extends readonly FormElement[]>(form: FormSpec<E>): UISchema {\n  const result: UISchema = {\n    type: \"VerticalLayout\",\n    elements: elementsToUiSchema(form.elements),\n  };\n\n  return parseOrThrow(uiSchemaValidator, result, \"UI Schema\");\n}\n","/**\n * JSON Schema Draft-07 type definitions.\n *\n * These types are a subset of JSON Schema sufficient for form generation.\n */\n\n/**\n * JSON Schema primitive types.\n */\nexport type JSONSchemaType =\n  | \"string\"\n  | \"number\"\n  | \"integer\"\n  | \"boolean\"\n  | \"object\"\n  | \"array\"\n  | \"null\";\n\n/**\n * A JSON Schema definition (draft-07 subset).\n */\nexport interface JSONSchema7 {\n  $schema?: string;\n  $id?: string;\n  $ref?: string;\n\n  // Metadata\n  title?: string;\n  description?: string;\n  deprecated?: boolean;\n\n  // Type\n  type?: JSONSchemaType | JSONSchemaType[];\n\n  // String validation\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n\n  // Number validation\n  minimum?: number;\n  maximum?: number;\n  exclusiveMinimum?: number;\n  exclusiveMaximum?: number;\n\n  // Enum\n  enum?: readonly (string | number | boolean | null)[];\n  const?: string | number | boolean | null;\n\n  // Object\n  properties?: Record<string, JSONSchema7>;\n  required?: string[];\n  additionalProperties?: boolean | JSONSchema7;\n\n  // Array\n  items?: JSONSchema7 | JSONSchema7[];\n  minItems?: number;\n  maxItems?: number;\n\n  // Composition\n  allOf?: JSONSchema7[];\n  anyOf?: JSONSchema7[];\n  oneOf?: JSONSchema7[];\n  not?: JSONSchema7;\n\n  // Conditional\n  if?: JSONSchema7;\n  then?: JSONSchema7;\n  else?: JSONSchema7;\n\n  // Format\n  format?: string;\n\n  // Default\n  default?: unknown;\n\n  // =============================================================================\n  // FormSpec Extensions (x- prefixed)\n  // =============================================================================\n\n  /**\n   * Data source key for dynamic enum fields.\n   * Indicates that options should be fetched from a registered resolver.\n   */\n  \"x-formspec-source\"?: string;\n\n  /**\n   * Field names whose values are needed to fetch dynamic enum options.\n   * Used for dependent/cascading dropdowns.\n   */\n  \"x-formspec-params\"?: readonly string[];\n\n  /**\n   * Schema source identifier for dynamic schema fields.\n   * Indicates that the schema should be loaded dynamically at runtime.\n   */\n  \"x-formspec-schemaSource\"?: string;\n}\n\n/** Extension properties for custom FormSpec decorators. */\nexport type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;\n\n/** JSON Schema with FormSpec extension properties for arbitrary x-formspec-* keys. */\nexport type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;\n\n/**\n * Sets a FormSpec extension property on a JSON Schema node.\n *\n * Use this to safely add `x-formspec-*` properties to any schema,\n * including nested schemas typed as `JSONSchema7` (which don't carry\n * the extension index signature).\n *\n * @param schema - Any JSON Schema node\n * @param key - Extension key (must start with `x-formspec-`)\n * @param value - Extension value\n */\nexport function setSchemaExtension(\n  schema: JSONSchema7,\n  key: `x-formspec-${string}`,\n  value: unknown\n): void {\n  (schema as ExtendedJSONSchema7)[key] = value;\n}\n\n/**\n * Reads a FormSpec extension property from a JSON Schema node.\n *\n * Use this to safely read `x-formspec-*` properties from any schema,\n * including nested schemas typed as `JSONSchema7`.\n *\n * @param schema - Any JSON Schema node\n * @param key - Extension key (must start with `x-formspec-`)\n * @returns The extension value, or `undefined` if not present\n */\nexport function getSchemaExtension(schema: JSONSchema7, key: `x-formspec-${string}`): unknown {\n  return (schema as ExtendedJSONSchema7)[key];\n}\n","/**\n * Browser-safe exports for `@formspec/build`.\n *\n * This entry point excludes Node.js-specific functions like `writeSchemas`\n * that use `node:fs` and `node:path`, making it suitable for browser environments.\n *\n * @example\n * ```typescript\n * // In browser code (e.g., playground)\n * import { buildFormSchemas, generateJsonSchema, generateUiSchema } from \"@formspec/build/browser\";\n *\n * const form = formspec(field.text(\"name\"));\n * const { jsonSchema, uiSchema } = buildFormSchemas(form);\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { FormElement, FormSpec } from \"@formspec/core\";\nimport { generateJsonSchema } from \"./json-schema/generator.js\";\nimport { generateUiSchema } from \"./ui-schema/generator.js\";\n\n// Re-export types\nexport type {\n  JSONSchema7,\n  JSONSchemaType,\n  ExtendedJSONSchema7,\n  FormSpecSchemaExtensions,\n} from \"./json-schema/types.js\";\n\nexport { setSchemaExtension, getSchemaExtension } from \"./json-schema/types.js\";\n\nexport type {\n  UISchema,\n  UISchemaElement,\n  UISchemaElementBase,\n  UISchemaElementType,\n  ControlElement,\n  VerticalLayout,\n  HorizontalLayout,\n  GroupLayout,\n  Categorization,\n  Category,\n  LabelElement,\n  Rule,\n  RuleEffect,\n  RuleConditionSchema,\n  SchemaBasedCondition,\n} from \"./ui-schema/types.js\";\n\n// Zod validation schemas\nexport {\n  ruleEffectSchema,\n  uiSchemaElementTypeSchema,\n  ruleConditionSchema,\n  schemaBasedConditionSchema,\n  ruleSchema,\n  controlSchema,\n  verticalLayoutSchema,\n  horizontalLayoutSchema,\n  groupLayoutSchema,\n  categorizationSchema,\n  categorySchema,\n  labelElementSchema,\n  uiSchemaElementSchema,\n  uiSchema as uiSchemaSchema,\n} from \"./ui-schema/schema.js\";\n\nexport { jsonSchemaTypeSchema, jsonSchema7Schema } from \"./json-schema/schema.js\";\n\n// Re-export individual generators\nexport { generateJsonSchema } from \"./json-schema/generator.js\";\nexport { generateUiSchema, generateUiSchemaFromFields } from \"./ui-schema/generator.js\";\n\n/**\n * Result of building form schemas.\n */\nexport interface BuildResult {\n  /** JSON Schema for validation */\n  readonly jsonSchema: ReturnType<typeof generateJsonSchema>;\n  /** JSON Forms UI Schema for rendering */\n  readonly uiSchema: ReturnType<typeof generateUiSchema>;\n}\n\n/**\n * Builds both JSON Schema and UI Schema from a FormSpec.\n *\n * This is a browser-safe version that does not include file system operations.\n *\n * @example\n * ```typescript\n * const form = formspec(\n *   field.text(\"name\", { required: true }),\n *   field.number(\"age\", { min: 0 }),\n * );\n *\n * const { jsonSchema, uiSchema } = buildFormSchemas(form);\n * ```\n *\n * @param form - The FormSpec to build schemas from\n * @returns Object containing both jsonSchema and uiSchema\n */\nexport function buildFormSchemas<E extends readonly FormElement[]>(form: FormSpec<E>): BuildResult {\n  return {\n    jsonSchema: generateJsonSchema(form),\n    uiSchema: generateUiSchema(form),\n  };\n}\n"],"mappings":"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","names":["z","z","z","parseOrThrow"]}

package/dist/build.d.ts

@@ -25,6 +25,7 @@
 
 import type { FormElement } from '@formspec/core';
 import type { FormSpec } from '@formspec/core';
+import { z } from 'zod';
 
 /**
  * Builds both JSON Schema and UI Schema from a FormSpec.
@@ -65,16 +66,42 @@ export declare interface BuildResult {
     readonly uiSchema: UISchema;
 }
 
+/**
+ * A Categorization element (tab-based layout).
+ */
+export declare interface Categorization {
+    type: "Categorization";
+    elements: Category[];
+    label?: string | undefined;
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+
+export declare const categorizationSchema: z.ZodType<Categorization>;
+
+/**
+ * A Category element, used inside a Categorization layout.
+ */
+export declare interface Category {
+    type: "Category";
+    label: string;
+    elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+
+export declare const categorySchema: z.ZodType<Category>;
+
 /**
  * Generated schemas for a class.
  */
 export declare interface ClassSchemas {
     /** JSON Schema for validation */
     jsonSchema: ExtendedJSONSchema7;
-    /** FormSpec/UI Schema for rendering */
-    uiSchema: {
-        elements: FormSpecField[];
-    };
+    /** JSON Forms UI Schema for rendering */
+    uiSchema: UISchema;
 }
 
 /**
@@ -92,11 +119,102 @@ export declare interface CodegenOptions {
 /**
  * A Control element that binds to a JSON Schema property.
  */
-export declare interface ControlElement extends UISchemaElementBase {
-    type: "Control";
-    scope: string;
-    label?: string;
-}
+export declare type ControlElement = z.infer<typeof controlSchema>;
+
+/**
+ * Zod schema for a Control element.
+ */
+export declare const controlSchema: z.ZodObject<{
+    type: z.ZodLiteral<"Control">;
+    scope: z.ZodString;
+    label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<false>]>>;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodLiteral<"Control">;
+    scope: z.ZodString;
+    label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<false>]>>;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodLiteral<"Control">;
+    scope: z.ZodString;
+    label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<false>]>>;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
 
 /**
  * Information about a decorated class found during codegen analysis.
@@ -174,10 +292,8 @@ export declare interface GenerateFromClassOptions {
 export declare interface GenerateFromClassResult {
     /** JSON Schema for validation */
     jsonSchema: ExtendedJSONSchema7;
-    /** FormSpec/UI Schema for rendering */
-    uiSchema: {
-        elements: FormSpecField[];
-    };
+    /** JSON Forms UI Schema for rendering */
+    uiSchema: UISchema;
 }
 
 /**
@@ -307,6 +423,21 @@ export declare interface GenerateSchemasOptions {
  */
 export declare function generateUiSchema<E extends readonly FormElement[]>(form: FormSpec<E>): UISchema;
 
+/**
+ * Converts FormSpecField[] (from decorator/interface/type analysis) to a JSON Forms UISchema.
+ *
+ * Mapping:
+ * - Each field → `{ type: "Control", scope: "#/properties/{id}", label? }`
+ * - `showWhen: { field, value }` → rule with SHOW effect
+ * - `group` property → Groups fields by group name, preserving insertion order
+ * - `fields` (nested object) → single Control pointing to the object property
+ * - Root wrapper → `{ type: "VerticalLayout", elements }`
+ *
+ * @param fields - The FormSpecField array to convert
+ * @returns A JSON Forms UISchema
+ */
+export declare function generateUiSchemaFromFields(fields: FormSpecField[]): UISchema;
+
 /**
  * Reads a FormSpec extension property from a JSON Schema node.
  *
@@ -322,20 +453,30 @@ export declare function getSchemaExtension(schema: JSONSchema7, key: `x-formspec
 /**
  * A group element with a label.
  */
-export declare interface GroupLayout extends UISchemaElementBase {
+export declare interface GroupLayout {
     type: "Group";
     label: string;
     elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
 }
 
+export declare const groupLayoutSchema: z.ZodType<GroupLayout>;
+
 /**
  * A horizontal layout element.
  */
-export declare interface HorizontalLayout extends UISchemaElementBase {
+export declare interface HorizontalLayout {
     type: "HorizontalLayout";
     elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
 }
 
+export declare const horizontalLayoutSchema: z.ZodType<HorizontalLayout>;
+
 /**
  * A JSON Schema definition (draft-07 subset).
  */
@@ -388,6 +529,8 @@ export declare interface JSONSchema7 {
     "x-formspec-schemaSource"?: string;
 }
 
+export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
+
 /**
  * JSON Schema Draft-07 type definitions.
  *
@@ -398,31 +541,171 @@ export declare interface JSONSchema7 {
  */
 export declare type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 
+/**
+ * Zod schema for JSON Schema primitive type strings.
+ */
+export declare const jsonSchemaTypeSchema: z.ZodEnum<["string", "number", "integer", "boolean", "object", "array", "null"]>;
+
+/**
+ * A Label element for displaying static text.
+ */
+export declare type LabelElement = z.infer<typeof labelElementSchema>;
+
+/**
+ * Zod schema for a Label element.
+ */
+export declare const labelElementSchema: z.ZodObject<{
+    type: z.ZodLiteral<"Label">;
+    text: z.ZodString;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodLiteral<"Label">;
+    text: z.ZodString;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodLiteral<"Label">;
+    text: z.ZodString;
+    rule: z.ZodOptional<z.ZodObject<{
+        effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+        condition: z.ZodObject<{
+            scope: z.ZodString;
+            schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+        }, "strict", z.ZodTypeAny, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }, {
+            schema: RuleConditionSchema;
+            scope: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }, {
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+
 /**
  * Rule for conditional element visibility/enablement.
  */
-export declare interface Rule {
-    effect: RuleEffect;
-    condition: SchemaBasedCondition;
-}
+export declare type Rule = z.infer<typeof ruleSchema>;
 
 /**
- * JSON Schema subset for rule conditions.
+ * JSON Schema subset used in rule conditions.
  */
 export declare 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[];
 }
 
+export declare const ruleConditionSchema: z.ZodType<RuleConditionSchema>;
+
 /**
  * Rule effect types for conditional visibility.
  */
-export declare type RuleEffect = "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+export declare type RuleEffect = z.infer<typeof ruleEffectSchema>;
+
+/**
+ * Zod schema for rule effect values.
+ */
+export declare const ruleEffectSchema: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+
+/**
+ * Zod schema for a UI Schema rule.
+ */
+export declare const ruleSchema: z.ZodObject<{
+    effect: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+    condition: z.ZodObject<{
+        scope: z.ZodString;
+        schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+    }, "strict", z.ZodTypeAny, {
+        schema: RuleConditionSchema;
+        scope: string;
+    }, {
+        schema: RuleConditionSchema;
+        scope: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    condition: {
+        schema: RuleConditionSchema;
+        scope: string;
+    };
+}, {
+    effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    condition: {
+        schema: RuleConditionSchema;
+        scope: string;
+    };
+}>;
 
 /**
  * Runs the code generation.
@@ -432,10 +715,21 @@ export declare function runCodegen(options: CodegenOptions): void;
 /**
  * Condition for a rule.
  */
-export declare interface SchemaBasedCondition {
+export declare type SchemaBasedCondition = z.infer<typeof schemaBasedConditionSchema>;
+
+/**
+ * Zod schema for a schema-based rule condition.
+ */
+export declare const schemaBasedConditionSchema: z.ZodObject<{
+    scope: z.ZodString;
+    schema: z.ZodType<RuleConditionSchema, z.ZodTypeDef, RuleConditionSchema>;
+}, "strict", z.ZodTypeAny, {
+    schema: RuleConditionSchema;
     scope: string;
+}, {
     schema: RuleConditionSchema;
-}
+    scope: string;
+}>;
 
 /**
  * Sets a FormSpec extension property on a JSON Schema node.
@@ -487,17 +781,22 @@ export declare interface TypeMetadata {
 }
 
 /**
- * Root UI Schema (always a layout).
+ * Root UI Schema (always a layout — not a Control, Category, or Label).
  */
-export declare type UISchema = VerticalLayout | HorizontalLayout | GroupLayout;
+export declare type UISchema = VerticalLayout | HorizontalLayout | GroupLayout | Categorization;
 
 /**
  * Union of all UI Schema element types.
  */
-export declare type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout;
+export declare type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout | Categorization | Category | LabelElement;
 
 /**
  * Base interface for all UI Schema elements.
+ *
+ * This is a manually maintained interface representing the common shape
+ * shared by all element types. It is kept as an interface (rather than
+ * derived from Zod) because it is the base of a discriminated union, not
+ * a union member itself.
  */
 export declare interface UISchemaElementBase {
     type: UISchemaElementType;
@@ -505,25 +804,36 @@ export declare interface UISchemaElementBase {
     options?: Record<string, unknown>;
 }
 
+export declare const uiSchemaElementSchema: z.ZodType<UISchemaElement>;
+
 /**
- * JSON Forms UI Schema type definitions.
- *
- * These types define the UI layout structure for JSON Forms.
- * See: https://jsonforms.io/docs/uischema/
+ * UI Schema element types.
  */
+export declare type UISchemaElementType = z.infer<typeof uiSchemaElementTypeSchema>;
+
 /**
- * UI Schema element types.
+ * Zod schema for UI Schema element type strings.
  */
-export declare type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category";
+export declare const uiSchemaElementTypeSchema: z.ZodEnum<["Control", "VerticalLayout", "HorizontalLayout", "Group", "Categorization", "Category", "Label"]>;
+
+/**
+ * Zod schema for the root UI Schema (layout types only).
+ */
+export declare const uiSchemaSchema: z.ZodType<UISchema>;
 
 /**
  * A vertical layout element.
  */
-export declare interface VerticalLayout extends UISchemaElementBase {
+export declare interface VerticalLayout {
     type: "VerticalLayout";
     elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
 }
 
+export declare const verticalLayoutSchema: z.ZodType<VerticalLayout>;
+
 /**
  * Builds and writes both JSON Schema and UI Schema files to disk.
  *