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

package/dist/generators/class-schema.js

@@ -1,140 +0,0 @@
-/**
- * Class schema generator.
- *
- * Generates JSON Schema and FormSpec/UI Schema from statically analyzed
- * class fields and decorators.
- */
-import { convertType, applyDecoratorsToSchema, createFormSpecField, } from "../analyzer/type-converter.js";
-import { createProgramContext, findClassByName, findInterfaceByName, findTypeAliasByName, } from "../analyzer/program.js";
-import { analyzeClass, analyzeInterface, analyzeTypeAlias } from "../analyzer/class-analyzer.js";
-/**
- * Generates JSON Schema and FormSpec from a class analysis.
- *
- * Uses static type information and decorator metadata to build
- * complete schema definitions for a class's fields.
- *
- * @param analysis - The class analysis result
- * @param checker - TypeScript type checker
- * @returns Generated JSON Schema and FormSpec
- */
-export function generateClassSchemas(analysis, checker) {
-    const properties = {};
-    const required = [];
-    const uiElements = [];
-    for (const field of analysis.fields) {
-        // Generate JSON Schema for field
-        const { jsonSchema: baseSchema } = convertType(field.type, checker);
-        const fieldSchema = applyDecoratorsToSchema(baseSchema, field.decorators, field);
-        properties[field.name] = fieldSchema;
-        // Track required fields
-        if (!field.optional) {
-            required.push(field.name);
-        }
-        // Generate FormSpec field
-        const formSpecField = createFormSpecField(field.name, field.type, field.decorators, field.optional, checker);
-        uiElements.push(formSpecField);
-    }
-    // Build complete JSON Schema
-    const jsonSchema = {
-        type: "object",
-        properties,
-        ...(required.length > 0 ? { required } : {}),
-    };
-    // Build FormSpec/UI Schema
-    const uiSchema = {
-        elements: uiElements,
-    };
-    return { jsonSchema, uiSchema };
-}
-/**
- * Generates JSON Schema for a single field.
- *
- * Useful for generating schemas for method return types
- * or individual field extraction.
- *
- * @param field - The field information
- * @param checker - TypeScript type checker
- * @returns JSON Schema for the field's type
- */
-export function generateFieldSchema(field, checker) {
-    const { jsonSchema: baseSchema } = convertType(field.type, checker);
-    return applyDecoratorsToSchema(baseSchema, field.decorators, field);
-}
-/**
- * Generates JSON Schema and FormSpec/UI Schema from a decorated TypeScript class.
- *
- * This is a high-level entry point that handles the entire pipeline:
- * creating a TypeScript program, finding the class, analyzing it,
- * and generating schemas — all in one call.
- *
- * @example
- * ```typescript
- * const result = generateSchemasFromClass({
- *   filePath: "./src/forms.ts",
- *   className: "UserForm",
- * });
- * console.log(result.jsonSchema);
- * ```
- *
- * @param options - File path, class name, and optional compiler options
- * @returns Generated JSON Schema and FormSpec/UI Schema
- */
-export function generateSchemasFromClass(options) {
-    const ctx = createProgramContext(options.filePath);
-    const classDecl = findClassByName(ctx.sourceFile, options.className);
-    if (!classDecl) {
-        throw new Error(`Class "${options.className}" not found in ${options.filePath}`);
-    }
-    const analysis = analyzeClass(classDecl, ctx.checker);
-    return generateClassSchemas(analysis, ctx.checker);
-}
-/**
- * Generates JSON Schema and FormSpec/UI Schema from a named TypeScript
- * type — a decorated class, an interface with TSDoc tags, or a type alias.
- *
- * This is the recommended entry point. It automatically detects whether
- * the name resolves to a class, interface, or type alias and uses the
- * appropriate analysis pipeline:
- *
- * - **Classes**: extracts decorators and JSDoc constraints
- * - **Interfaces**: extracts TSDoc tags (`@Field_displayName`, `@Minimum`, etc.)
- * - **Type aliases**: object literal bodies analyzed like interfaces
- *
- * @example
- * ```typescript
- * // Works with both classes and interfaces — caller doesn't need to know
- * const result = generateSchemas({
- *   filePath: "./src/config.ts",
- *   typeName: "DiscountConfig",
- * });
- * ```
- *
- * @param options - File path and type name
- * @returns Generated JSON Schema and FormSpec/UI Schema
- */
-export function generateSchemas(options) {
-    const ctx = createProgramContext(options.filePath);
-    // Try class first
-    const classDecl = findClassByName(ctx.sourceFile, options.typeName);
-    if (classDecl) {
-        const analysis = analyzeClass(classDecl, ctx.checker);
-        return generateClassSchemas(analysis, ctx.checker);
-    }
-    // Try interface
-    const interfaceDecl = findInterfaceByName(ctx.sourceFile, options.typeName);
-    if (interfaceDecl) {
-        const analysis = analyzeInterface(interfaceDecl, ctx.checker);
-        return generateClassSchemas(analysis, ctx.checker);
-    }
-    // Try type alias
-    const typeAlias = findTypeAliasByName(ctx.sourceFile, options.typeName);
-    if (typeAlias) {
-        const result = analyzeTypeAlias(typeAlias, ctx.checker);
-        if (result.ok) {
-            return generateClassSchemas(result.analysis, ctx.checker);
-        }
-        throw new Error(result.error);
-    }
-    throw new Error(`Type "${options.typeName}" not found as a class, interface, or type alias in ${options.filePath}`);
-}
-//# sourceMappingURL=class-schema.js.map

package/dist/generators/class-schema.js.map

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

package/dist/generators/method-schema.js

@@ -1,108 +0,0 @@
-/**
- * Method schema generator.
- *
- * Generates schemas for method parameters and return types:
- * - Parameters using FormSpec (InferSchema<typeof X>) -> runtime generation
- * - Parameters with regular types -> static type conversion
- * - Return types -> static type conversion
- */
-import { convertType } from "../analyzer/type-converter.js";
-/**
- * Generates schemas for a method's parameters and return type.
- *
- * If a parameter references a FormSpec via `InferSchema<typeof X>`,
- * the schemas are taken from the loaded FormSpec at runtime.
- * Otherwise, schemas are generated from static type analysis.
- *
- * @param method - The method information from static analysis
- * @param checker - TypeScript type checker
- * @param loadedFormSpecs - Map of FormSpec export names to their schemas
- * @returns Generated method schemas
- */
-export function generateMethodSchemas(method, checker, loadedFormSpecs) {
-    // Generate return type schema from static analysis
-    const returnType = convertType(method.returnType, checker).jsonSchema;
-    // Handle parameters
-    const params = generateParamsSchemas(method.parameters, checker, loadedFormSpecs);
-    return {
-        name: method.name,
-        params,
-        returnType,
-    };
-}
-/**
- * Generates schemas for method parameters.
- */
-function generateParamsSchemas(parameters, checker, loadedFormSpecs) {
-    if (parameters.length === 0) {
-        return null;
-    }
-    // Check if any parameter uses InferSchema<typeof X>
-    for (const param of parameters) {
-        if (param.formSpecExportName) {
-            const formSpec = loadedFormSpecs.get(param.formSpecExportName);
-            if (formSpec) {
-                // Use runtime-generated schemas from FormSpec
-                // Cast to our ExtendedJSONSchema7 type (structurally compatible)
-                return {
-                    jsonSchema: formSpec.jsonSchema,
-                    uiSchema: formSpec.uiSchema,
-                    formSpecExport: param.formSpecExportName,
-                };
-            }
-            // FormSpec not found - fall back to static analysis
-            console.warn(`Warning: FormSpec export "${param.formSpecExportName}" not found, using static analysis`);
-        }
-    }
-    // Generate from static type analysis
-    if (parameters.length === 1 && parameters[0]) {
-        // Single parameter - use its type directly
-        const param = parameters[0];
-        const jsonSchema = convertType(param.type, checker).jsonSchema;
-        return {
-            jsonSchema,
-            uiSchema: null,
-            formSpecExport: null,
-        };
-    }
-    // Multiple parameters - create object schema
-    const properties = {};
-    const required = [];
-    for (const param of parameters) {
-        const paramSchema = convertType(param.type, checker).jsonSchema;
-        properties[param.name] = paramSchema;
-        // Only non-optional parameters should be marked as required
-        if (!param.optional) {
-            required.push(param.name);
-        }
-    }
-    return {
-        jsonSchema: {
-            type: "object",
-            properties,
-            ...(required.length > 0 ? { required } : {}),
-        },
-        uiSchema: null,
-        formSpecExport: null,
-    };
-}
-/**
- * Collects all FormSpec export names referenced by methods.
- *
- * Use this to determine which exports to load at runtime.
- *
- * @param methods - Array of method infos
- * @returns Set of FormSpec export names
- */
-export function collectFormSpecReferences(methods) {
-    const references = new Set();
-    for (const method of methods) {
-        for (const param of method.parameters) {
-            if (param.formSpecExportName) {
-                references.add(param.formSpecExportName);
-            }
-        }
-    }
-    return references;
-}
-//# sourceMappingURL=method-schema.js.map

package/dist/generators/method-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"method-schema.js","sourceRoot":"","sources":["../../src/generators/method-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAuC5D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB,EAClB,OAAuB,EACvB,eAAmD;IAEnD,mDAAmD;IACnD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC;IAEtE,oBAAoB;IACpB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAElF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,UAA2B,EAC3B,OAAuB,EACvB,eAAmD;IAEnD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC/D,IAAI,QAAQ,EAAE,CAAC;gBACb,8CAA8C;gBAC9C,iEAAiE;gBACjE,OAAO;oBACL,UAAU,EAAE,QAAQ,CAAC,UAAiC;oBACtD,QAAQ,EAAE,QAAQ,CAAC,QAAyB;oBAC5C,cAAc,EAAE,KAAK,CAAC,kBAAkB;iBACzC,CAAC;YACJ,CAAC;YAED,oDAAoD;YACpD,OAAO,CAAC,IAAI,CACV,6BAA6B,KAAK,CAAC,kBAAkB,oCAAoC,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,2CAA2C;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC;QAC/D,OAAO;YACL,UAAU;YACV,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAwC,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC;QAChE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;QACrC,4DAA4D;QAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C;QACD,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAqB;IAC7D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/json-schema/generator.js

@@ -1,166 +0,0 @@
-/**
- * JSON Schema generator for FormSpec forms.
- */
-/**
- * Generates JSON Schema for nested elements (used for array items and object properties).
- */
-function generateNestedSchema(elements) {
-    const properties = {};
-    const required = [];
-    collectFields(elements, properties, required);
-    // Deduplicate required array (can have duplicates when the same field is defined
-    // in multiple branches/containers, e.g., repeated in different conditional branches)
-    const uniqueRequired = [...new Set(required)];
-    return {
-        type: "object",
-        properties,
-        ...(uniqueRequired.length > 0 && { required: uniqueRequired }),
-    };
-}
-/**
- * Converts a single field to its JSON Schema representation.
- */
-function fieldToJsonSchema(field) {
-    const base = {};
-    if (field.label !== undefined) {
-        base.title = field.label;
-    }
-    switch (field._field) {
-        case "text":
-            return { ...base, type: "string" };
-        case "number":
-            return {
-                ...base,
-                type: "number",
-                ...(field.min !== undefined && { minimum: field.min }),
-                ...(field.max !== undefined && { maximum: field.max }),
-            };
-        case "boolean":
-            return { ...base, type: "boolean" };
-        case "enum": {
-            const opts = field.options;
-            const isObjectOptions = opts.length > 0 &&
-                opts.every((opt) => typeof opt === "object" && "id" in opt && "label" in opt);
-            if (isObjectOptions) {
-                // Object options with id/label: use oneOf with const/title
-                return {
-                    ...base,
-                    type: "string",
-                    oneOf: opts.map((o) => ({
-                        const: o.id,
-                        title: o.label,
-                    })),
-                };
-            }
-            return { ...base, type: "string", enum: opts };
-        }
-        case "dynamic_enum":
-            // Dynamic enums are strings at the schema level
-            // The actual options are resolved at runtime
-            // x-formspec-source indicates the data source key
-            // x-formspec-params indicates dependent field names for fetching options
-            return {
-                ...base,
-                type: "string",
-                "x-formspec-source": field.source,
-                ...(field.params !== undefined &&
-                    field.params.length > 0 && { "x-formspec-params": field.params }),
-            };
-        case "dynamic_schema":
-            // Dynamic schemas are objects with unknown properties
-            // x-formspec-schemaSource indicates where to load the schema from
-            return {
-                ...base,
-                type: "object",
-                additionalProperties: true,
-                "x-formspec-schemaSource": field.schemaSource,
-            };
-        case "array": {
-            const arrayField = field;
-            return {
-                ...base,
-                type: "array",
-                items: generateNestedSchema(arrayField.items),
-                ...(arrayField.minItems !== undefined && { minItems: arrayField.minItems }),
-                ...(arrayField.maxItems !== undefined && { maxItems: arrayField.maxItems }),
-            };
-        }
-        case "object": {
-            const objectField = field;
-            const nestedSchema = generateNestedSchema(objectField.properties);
-            return {
-                ...base,
-                ...nestedSchema,
-            };
-        }
-        default: {
-            // Exhaustiveness check
-            const _exhaustive = field;
-            return _exhaustive;
-        }
-    }
-}
-/**
- * Visits all elements in a form tree, collecting fields and required fields.
- */
-function collectFields(elements, properties, required) {
-    for (const element of elements) {
-        switch (element._type) {
-            case "field":
-                properties[element.name] = fieldToJsonSchema(element);
-                if (element.required === true) {
-                    required.push(element.name);
-                }
-                break;
-            case "group":
-                // Groups don't affect schema structure, just collect their children
-                collectFields(element.elements, properties, required);
-                break;
-            case "conditional":
-                // Conditional fields are still part of the schema
-                // They're just hidden/shown in the UI
-                collectFields(element.elements, properties, required);
-                break;
-        }
-    }
-}
-/**
- * Generates a JSON Schema from a FormSpec.
- *
- * @example
- * ```typescript
- * const form = formspec(
- *   field.text("name", { label: "Name", required: true }),
- *   field.number("age", { min: 0 }),
- * );
- *
- * const schema = generateJsonSchema(form);
- * // {
- * //   $schema: "https://json-schema.org/draft-07/schema#",
- * //   type: "object",
- * //   properties: {
- * //     name: { type: "string", title: "Name" },
- * //     age: { type: "number", minimum: 0 }
- * //   },
- * //   required: ["name"]
- * // }
- * ```
- *
- * @param form - The FormSpec to convert
- * @returns A JSON Schema object
- */
-export function generateJsonSchema(form) {
-    const properties = {};
-    const required = [];
-    collectFields(form.elements, properties, required);
-    // Deduplicate required array (can have duplicates when the same field is defined
-    // in multiple branches/containers, e.g., repeated in different conditional branches)
-    const uniqueRequired = [...new Set(required)];
-    return {
-        $schema: "https://json-schema.org/draft-07/schema#",
-        type: "object",
-        properties,
-        ...(uniqueRequired.length > 0 && { required: uniqueRequired }),
-    };
-}
-//# sourceMappingURL=generator.js.map

package/dist/json-schema/generator.js.map

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

package/dist/json-schema/types.js

@@ -1,33 +0,0 @@
-/**
- * JSON Schema Draft-07 type definitions.
- *
- * These types are a subset of JSON Schema sufficient for form generation.
- */
-/**
- * Sets a FormSpec extension property on a JSON Schema node.
- *
- * Use this to safely add `x-formspec-*` properties to any schema,
- * including nested schemas typed as `JSONSchema7` (which don't carry
- * the extension index signature).
- *
- * @param schema - Any JSON Schema node
- * @param key - Extension key (must start with `x-formspec-`)
- * @param value - Extension value
- */
-export function setSchemaExtension(schema, key, value) {
-    schema[key] = value;
-}
-/**
- * Reads a FormSpec extension property from a JSON Schema node.
- *
- * Use this to safely read `x-formspec-*` properties from any schema,
- * including nested schemas typed as `JSONSchema7`.
- *
- * @param schema - Any JSON Schema node
- * @param key - Extension key (must start with `x-formspec-`)
- * @returns The extension value, or `undefined` if not present
- */
-export function getSchemaExtension(schema, key) {
-    return schema[key];
-}
-//# sourceMappingURL=types.js.map

package/dist/json-schema/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/json-schema/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqGH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,GAA2B,EAC3B,KAAc;IAEb,MAA8B,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,GAA2B;IACjF,OAAQ,MAA8B,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/ui-schema/generator.js

@@ -1,148 +0,0 @@
-/**
- * JSON Forms UI Schema generator for FormSpec forms.
- */
-/**
- * Converts a field name to a JSON Pointer scope.
- */
-function fieldToScope(fieldName) {
-    return `#/properties/${fieldName}`;
-}
-/**
- * Creates a rule for conditional visibility.
- */
-function createShowRule(fieldName, value) {
-    return {
-        effect: "SHOW",
-        condition: {
-            scope: fieldToScope(fieldName),
-            schema: { const: value },
-        },
-    };
-}
-/**
- * Combines two rules into one using allOf.
- *
- * When elements are nested inside multiple conditionals, all conditions
- * must be met for the element to be visible.
- */
-function combineRules(parentRule, childRule) {
-    // Both rules should have the same effect (SHOW)
-    // Combine conditions using allOf
-    const parentCondition = parentRule.condition;
-    const childCondition = childRule.condition;
-    return {
-        effect: "SHOW",
-        condition: {
-            scope: "#",
-            schema: {
-                allOf: [
-                    {
-                        properties: {
-                            [parentCondition.scope.replace("#/properties/", "")]: parentCondition.schema,
-                        },
-                    },
-                    {
-                        properties: {
-                            [childCondition.scope.replace("#/properties/", "")]: childCondition.schema,
-                        },
-                    },
-                ],
-            },
-        },
-    };
-}
-/**
- * Converts form elements to UI Schema elements.
- *
- * @param elements - The form elements to convert
- * @param parentRule - Optional rule inherited from parent conditional
- * @returns Array of UI Schema elements
- */
-function elementsToUiSchema(elements, parentRule) {
-    const result = [];
-    for (const element of elements) {
-        switch (element._type) {
-            case "field": {
-                const control = {
-                    type: "Control",
-                    scope: fieldToScope(element.name),
-                    ...(element.label !== undefined && { label: element.label }),
-                    ...(parentRule !== undefined && { rule: parentRule }),
-                };
-                result.push(control);
-                break;
-            }
-            case "group": {
-                const groupElement = element;
-                const group = {
-                    type: "Group",
-                    label: groupElement.label,
-                    elements: elementsToUiSchema(groupElement.elements, parentRule),
-                    ...(parentRule !== undefined && { rule: parentRule }),
-                };
-                result.push(group);
-                break;
-            }
-            case "conditional": {
-                const conditionalElement = element;
-                // Create a rule for this conditional
-                const newRule = createShowRule(conditionalElement.field, conditionalElement.value);
-                // Combine with parent rule if present (for nested conditionals)
-                const combinedRule = parentRule !== undefined ? combineRules(parentRule, newRule) : newRule;
-                // Apply the combined rule to all children
-                const childElements = elementsToUiSchema(conditionalElement.elements, combinedRule);
-                result.push(...childElements);
-                break;
-            }
-        }
-    }
-    return result;
-}
-/**
- * Generates a JSON Forms UI Schema from a FormSpec.
- *
- * @example
- * ```typescript
- * const form = formspec(
- *   group("Customer",
- *     field.text("name", { label: "Name" }),
- *   ),
- *   when("status", "draft",
- *     field.text("notes", { label: "Notes" }),
- *   ),
- * );
- *
- * const uiSchema = generateUiSchema(form);
- * // {
- * //   type: "VerticalLayout",
- * //   elements: [
- * //     {
- * //       type: "Group",
- * //       label: "Customer",
- * //       elements: [
- * //         { type: "Control", scope: "#/properties/name", label: "Name" }
- * //       ]
- * //     },
- * //     {
- * //       type: "Control",
- * //       scope: "#/properties/notes",
- * //       label: "Notes",
- * //       rule: {
- * //         effect: "SHOW",
- * //         condition: { scope: "#/properties/status", schema: { const: "draft" } }
- * //       }
- * //     }
- * //   ]
- * // }
- * ```
- *
- * @param form - The FormSpec to convert
- * @returns A JSON Forms UI Schema
- */
-export function generateUiSchema(form) {
-    return {
-        type: "VerticalLayout",
-        elements: elementsToUiSchema(form.elements),
-    };
-}
-//# sourceMappingURL=generator.js.map

package/dist/ui-schema/generator.js.map

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

package/dist/ui-schema/types.js

@@ -1,8 +0,0 @@
-/**
- * JSON Forms UI Schema type definitions.
- *
- * These types define the UI layout structure for JSON Forms.
- * See: https://jsonforms.io/docs/uischema/
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/ui-schema/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ui-schema/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}