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

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

@@ -0,0 +1,429 @@
+/**
+ * Zod schemas for JSON Forms UI Schema.
+ *
+ * These schemas are the source of truth for UI Schema validation.
+ * TypeScript types are derived from these schemas via `z.infer<>`.
+ *
+ * @see https://jsonforms.io/docs/uischema/
+ */
+import { z } from "zod";
+import type { UISchema } from "./types.js";
+/**
+ * Zod schema for rule effect values.
+ *
+ * @internal
+ */
+export declare const ruleEffectSchema: z.ZodEnum<["SHOW", "HIDE", "ENABLE", "DISABLE"]>;
+/**
+ * Rule effect types for conditional visibility.
+ *
+ * @internal
+ */
+export type RuleEffect = z.infer<typeof ruleEffectSchema>;
+/**
+ * Zod schema for UI Schema element type strings.
+ *
+ * @internal
+ */
+export declare const uiSchemaElementTypeSchema: z.ZodEnum<["Control", "VerticalLayout", "HorizontalLayout", "Group", "Categorization", "Category", "Label"]>;
+/**
+ * UI Schema element types.
+ *
+ * @internal
+ */
+export type UISchemaElementType = z.infer<typeof uiSchemaElementTypeSchema>;
+/**
+ * JSON Schema subset used in rule conditions.
+ *
+ * @internal
+ */
+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[];
+}
+/**
+ * Zod schema for the rule-condition JSON Schema subset.
+ *
+ * @internal
+ */
+export declare const ruleConditionSchema: z.ZodType<RuleConditionSchema>;
+/**
+ * Zod schema for a schema-based rule condition.
+ *
+ * @internal
+ */
+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;
+}>;
+/**
+ * Condition for a rule.
+ *
+ * @internal
+ */
+export type SchemaBasedCondition = z.infer<typeof schemaBasedConditionSchema>;
+/**
+ * Zod schema for a UI Schema rule.
+ *
+ * @internal
+ */
+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, {
+    condition: {
+        schema: RuleConditionSchema;
+        scope: string;
+    };
+    effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+}, {
+    condition: {
+        schema: RuleConditionSchema;
+        scope: string;
+    };
+    effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+}>;
+/**
+ * Rule for conditional element visibility/enablement.
+ *
+ * @internal
+ */
+export type Rule = z.infer<typeof ruleSchema>;
+/**
+ * Union of all UI Schema element types.
+ *
+ * @internal
+ */
+export type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout | Categorization | Category | LabelElement;
+/**
+ * Zod schema for any UI Schema element.
+ *
+ * @internal
+ */
+export declare const uiSchemaElementSchema: z.ZodType<UISchemaElement>;
+/**
+ * Zod schema for a Control element.
+ *
+ * @internal
+ */
+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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * A Control element that binds to a JSON Schema property.
+ *
+ * @internal
+ */
+export type ControlElement = z.infer<typeof controlSchema>;
+/**
+ * A vertical layout element.
+ *
+ * @internal
+ */
+export interface VerticalLayout {
+    type: "VerticalLayout";
+    elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+/**
+ * Zod schema for a vertical layout element.
+ *
+ * @internal
+ */
+export declare const verticalLayoutSchema: z.ZodType<VerticalLayout>;
+/**
+ * A horizontal layout element.
+ *
+ * @internal
+ */
+export interface HorizontalLayout {
+    type: "HorizontalLayout";
+    elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+/**
+ * Zod schema for a horizontal layout element.
+ *
+ * @internal
+ */
+export declare const horizontalLayoutSchema: z.ZodType<HorizontalLayout>;
+/**
+ * A group element with a label.
+ *
+ * @internal
+ */
+export interface GroupLayout {
+    type: "Group";
+    label: string;
+    elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+/**
+ * Zod schema for a group layout element.
+ *
+ * @internal
+ */
+export declare const groupLayoutSchema: z.ZodType<GroupLayout>;
+/**
+ * A Category element, used inside a Categorization layout.
+ *
+ * @internal
+ */
+export interface Category {
+    type: "Category";
+    label: string;
+    elements: UISchemaElement[];
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+/**
+ * Zod schema for a category element.
+ *
+ * @internal
+ */
+export declare const categorySchema: z.ZodType<Category>;
+/**
+ * A Categorization element (tab-based layout).
+ *
+ * @internal
+ */
+export interface Categorization {
+    type: "Categorization";
+    elements: Category[];
+    label?: string | undefined;
+    rule?: Rule | undefined;
+    options?: Record<string, unknown> | undefined;
+    [k: string]: unknown;
+}
+/**
+ * Zod schema for a categorization element.
+ *
+ * @internal
+ */
+export declare const categorizationSchema: z.ZodType<Categorization>;
+/**
+ * Zod schema for a Label element.
+ *
+ * @internal
+ */
+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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    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, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }, {
+        condition: {
+            schema: RuleConditionSchema;
+            scope: string;
+        };
+        effect: "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * A Label element for displaying static text.
+ *
+ * @internal
+ */
+export type LabelElement = z.infer<typeof labelElementSchema>;
+/**
+ * Zod schema for the root UI Schema (layout types only).
+ *
+ * @public
+ */
+export declare const uiSchema: z.ZodType<UISchema>;
+//# sourceMappingURL=schema.d.ts.map

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

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

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

@@ -1,87 +1,231 @@
 /**
  * JSON Forms UI Schema type definitions.
  *
- * These types define the UI layout structure for JSON Forms.
+ * These are the consumer-facing TypeScript shapes. Runtime validation remains
+ * defined separately in `./schema.ts`.
+ *
  * See: https://jsonforms.io/docs/uischema/
  */
-/**
- * UI Schema element types.
- */
-export type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category";
 /**
  * Rule effect types for conditional visibility.
+ *
+ * @public
  */
 export type RuleEffect = "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
 /**
- * JSON Schema subset for rule conditions.
+ * 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 {
+    /** Literal value the condition schema must equal. */
     const?: unknown;
+    /** Allowed values for the condition schema. */
     enum?: readonly unknown[];
+    /** JSON Schema type required by the condition schema. */
     type?: string;
+    /** Negated branch of the condition schema. */
+    not?: RuleConditionSchema;
+    /** Inclusive numeric lower bound in the condition schema. */
     minimum?: number;
+    /** Inclusive numeric upper bound in the condition schema. */
     maximum?: number;
+    /** Exclusive numeric lower bound in the condition schema. */
+    exclusiveMinimum?: number;
+    /** Exclusive numeric upper bound in the condition schema. */
+    exclusiveMaximum?: number;
+    /** Inclusive minimum string length in the condition schema. */
+    minLength?: number;
+    /** Nested property conditions keyed by property name. */
     properties?: Record<string, RuleConditionSchema>;
+    /** Property names that must be present for the condition to match. */
+    required?: string[];
+    /** Schemas that must all match for the condition to succeed. */
     allOf?: RuleConditionSchema[];
 }
 /**
  * Condition for a rule.
+ *
+ * @public
  */
 export interface SchemaBasedCondition {
-    scope: string;
-    schema: RuleConditionSchema;
+    /** JSON Pointer scope the rule evaluates against. */
+    readonly scope: string;
+    /** JSON Schema fragment evaluated at the scoped location. */
+    readonly schema: RuleConditionSchema;
 }
 /**
  * Rule for conditional element visibility/enablement.
+ *
+ * @public
  */
 export interface Rule {
-    effect: RuleEffect;
-    condition: SchemaBasedCondition;
-}
-/**
- * Base interface for all UI Schema elements.
- */
-export interface UISchemaElementBase {
-    type: UISchemaElementType;
-    rule?: Rule;
-    options?: Record<string, unknown>;
+    /** UI effect to apply when the rule condition matches. */
+    readonly effect: RuleEffect;
+    /** Predicate that controls when the UI effect applies. */
+    readonly condition: SchemaBasedCondition;
 }
 /**
  * A Control element that binds to a JSON Schema property.
+ *
+ * @public
  */
-export interface ControlElement extends UISchemaElementBase {
-    type: "Control";
-    scope: string;
-    label?: string;
+export interface ControlElement {
+    /** Discriminator identifying a JSON Forms control element. */
+    readonly type: "Control";
+    /** JSON Pointer scope that this control binds to. */
+    readonly scope: string;
+    /** Optional label override, or `false` to suppress the label. */
+    readonly label?: string | false | undefined;
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific control options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
 }
 /**
  * A vertical layout element.
+ *
+ * @public
  */
-export interface VerticalLayout extends UISchemaElementBase {
-    type: "VerticalLayout";
-    elements: UISchemaElement[];
+export interface VerticalLayout {
+    /** Discriminator identifying a vertical layout container. */
+    readonly type: "VerticalLayout";
+    /** Child elements rendered in vertical order. */
+    readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific layout options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
 }
 /**
  * A horizontal layout element.
+ *
+ * @public
  */
-export interface HorizontalLayout extends UISchemaElementBase {
-    type: "HorizontalLayout";
-    elements: UISchemaElement[];
+export interface HorizontalLayout {
+    /** Discriminator identifying a horizontal layout container. */
+    readonly type: "HorizontalLayout";
+    /** Child elements rendered side by side. */
+    readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific layout options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
 }
 /**
  * A group element with a label.
+ *
+ * @public
  */
-export interface GroupLayout extends UISchemaElementBase {
-    type: "Group";
-    label: string;
-    elements: UISchemaElement[];
+export interface GroupLayout {
+    /** Discriminator identifying a labeled group container. */
+    readonly type: "Group";
+    /** Group label shown by compatible renderers. */
+    readonly label: string;
+    /** Child elements rendered inside the group. */
+    readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific group options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
+}
+/**
+ * A Category element, used inside a Categorization layout.
+ *
+ * @public
+ */
+export interface Category {
+    /** Discriminator identifying a category inside a categorization layout. */
+    readonly type: "Category";
+    /** Category label shown in tabs or step navigation. */
+    readonly label: string;
+    /** Child elements rendered inside the category. */
+    readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific category options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
+}
+/**
+ * A Categorization element (tab-based layout).
+ *
+ * @public
+ */
+export interface Categorization {
+    /** Discriminator identifying a categorization layout. */
+    readonly type: "Categorization";
+    /** Categories rendered as tabs or steps. */
+    readonly elements: Category[];
+    /** Optional label for the overall categorization container. */
+    readonly label?: string | undefined;
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific categorization options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    readonly [k: string]: unknown;
+}
+/**
+ * A Label element for displaying static text.
+ *
+ * @public
+ */
+export interface LabelElement {
+    /** Discriminator identifying a static text label element. */
+    readonly type: "Label";
+    /** Static text content rendered by the label element. */
+    readonly text: string;
+    /** Optional rule controlling visibility or enablement. */
+    readonly rule?: Rule | undefined;
+    /** Renderer-specific label options. */
+    readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
+    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 UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout;
+export type UISchema = VerticalLayout | HorizontalLayout | GroupLayout | Categorization;
 /**
- * Root UI Schema (always a layout).
+ * 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.
+ *
+ * @public
  */
-export type UISchema = VerticalLayout | HorizontalLayout | GroupLayout;
+export interface UISchemaElementBase {
+    /** Discriminator for the concrete JSON Forms element type. */
+    type: UISchemaElementType;
+    /** Optional rule controlling visibility or enablement. */
+    rule?: Rule;
+    /** Renderer-specific options shared by UI schema elements. */
+    options?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map