@formspec/build 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/build.d.ts

@@ -65,6 +65,30 @@ export declare interface BuildResult {
     readonly uiSchema: UISchema;
 }
 
+/**
+ * Generated schemas for a class.
+ */
+export declare interface ClassSchemas {
+    /** JSON Schema for validation */
+    jsonSchema: ExtendedJSONSchema7;
+    /** FormSpec/UI Schema for rendering */
+    uiSchema: {
+        elements: FormSpecField[];
+    };
+}
+
+/**
+ * Options for code generation.
+ */
+export declare interface CodegenOptions {
+    /** Source files to analyze (glob patterns supported) */
+    files: string[];
+    /** Output file path */
+    output: string;
+    /** Base directory for relative imports */
+    baseDir?: string;
+}
+
 /**
  * A Control element that binds to a JSON Schema property.
  */
@@ -74,6 +98,88 @@ export declare interface ControlElement extends UISchemaElementBase {
     label?: string;
 }
 
+/**
+ * Information about a decorated class found during codegen analysis.
+ *
+ * Used to track which classes need type metadata patches and where
+ * they are located in the source tree.
+ */
+export declare interface DecoratedClassInfo {
+    /** Class name as it appears in the source file */
+    name: string;
+    /** Import path to the source file (relative to output, without extension) */
+    sourcePath: string;
+    /** Type metadata for all decorated properties in the class */
+    typeMetadata: Record<string, TypeMetadata>;
+    /** Whether the class is exported from its source file */
+    isExported: boolean;
+}
+
+/** JSON Schema with FormSpec extension properties for arbitrary x-formspec-* keys. */
+export declare type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
+
+/**
+ * Finds all decorated classes in the given source files.
+ */
+export declare function findDecoratedClasses(files: string[], baseDir: string): DecoratedClassInfo[];
+
+/**
+ * FormSpec field definition (simplified for output).
+ */
+export declare interface FormSpecField {
+    _field: string;
+    id: string;
+    label?: string;
+    placeholder?: string;
+    description?: string;
+    required?: boolean;
+    min?: number;
+    max?: number;
+    step?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    options?: (string | {
+        id: string;
+        label: string;
+    })[];
+    showWhen?: object;
+    group?: string;
+    fields?: FormSpecField[];
+}
+
+/** Extension properties for custom FormSpec decorators. */
+export declare type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
+
+/**
+ * Generates the codegen output file content.
+ */
+export declare function generateCodegenOutput(classes: DecoratedClassInfo[], outputPath: string, baseDir: string): string;
+
+/**
+ * Options for generating schemas from a decorated class.
+ */
+export declare interface GenerateFromClassOptions {
+    /** Path to the TypeScript source file */
+    filePath: string;
+    /** Class name to analyze */
+    className: string;
+}
+
+/**
+ * Result of generating schemas from a decorated class.
+ */
+export declare interface GenerateFromClassResult {
+    /** JSON Schema for validation */
+    jsonSchema: ExtendedJSONSchema7;
+    /** FormSpec/UI Schema for rendering */
+    uiSchema: {
+        elements: FormSpecField[];
+    };
+}
+
 /**
  * Generates a JSON Schema from a FormSpec.
  *
@@ -101,6 +207,27 @@ export declare interface ControlElement extends UISchemaElementBase {
  */
 export declare function generateJsonSchema<E extends readonly FormElement[]>(form: FormSpec<E>): JSONSchema7;
 
+/**
+ * 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 declare function generateSchemasFromClass(options: GenerateFromClassOptions): GenerateFromClassResult;
+
 /**
  * Generates a JSON Forms UI Schema from a FormSpec.
  *
@@ -144,6 +271,18 @@ export declare function generateJsonSchema<E extends readonly FormElement[]>(for
  */
 export declare function generateUiSchema<E extends readonly FormElement[]>(form: FormSpec<E>): UISchema;
 
+/**
+ * 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 declare function getSchemaExtension(schema: JSONSchema7, key: `x-formspec-${string}`): unknown;
+
 /**
  * A group element with a label.
  */
@@ -170,6 +309,7 @@ export declare interface JSONSchema7 {
     $ref?: string;
     title?: string;
     description?: string;
+    deprecated?: boolean;
     type?: JSONSchemaType | JSONSchemaType[];
     minLength?: number;
     maxLength?: number;
@@ -233,7 +373,7 @@ export declare interface Rule {
 /**
  * JSON Schema subset for rule conditions.
  */
-declare interface RuleConditionSchema {
+export declare interface RuleConditionSchema {
     const?: unknown;
     enum?: readonly unknown[];
     type?: string;
@@ -248,6 +388,11 @@ declare interface RuleConditionSchema {
  */
 export declare type RuleEffect = "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
 
+/**
+ * Runs the code generation.
+ */
+export declare function runCodegen(options: CodegenOptions): void;
+
 /**
  * Condition for a rule.
  */
@@ -256,6 +401,55 @@ export declare interface SchemaBasedCondition {
     schema: RuleConditionSchema;
 }
 
+/**
+ * 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 declare function setSchemaExtension(schema: JSONSchema7, key: `x-formspec-${string}`, value: unknown): void;
+
+/**
+ * Code generation for FormSpec type metadata.
+ *
+ * Generates a TypeScript file that patches decorated classes with
+ * their extracted type metadata, enabling runtime schema generation
+ * as an alternative to a TypeScript transformer.
+ *
+ * Usage:
+ *   formspec codegen ./src/forms.ts -o ./src/__formspec_types__.ts
+ *
+ * Then in your code:
+ *   import './__formspec_types__';  // Patches all decorated classes
+ *   import { UserFormSchema, getUserFormFormSpec } from './__formspec_types__';
+ *   const spec = getUserFormFormSpec();
+ */
+/**
+ * Type metadata format used by `@formspec/decorators`.
+ *
+ * Represents the runtime type information for a field that TypeScript
+ * normally erases at compile time.
+ */
+export declare interface TypeMetadata {
+    /** Base type: "string", "number", "boolean", "enum", "array", "object", "unknown" */
+    type: string;
+    /** For enum types, the possible literal values */
+    values?: unknown[];
+    /** For array types, metadata about the array element type */
+    itemType?: TypeMetadata;
+    /** For object types, metadata about each property */
+    properties?: Record<string, TypeMetadata>;
+    /** Whether the field accepts null */
+    nullable?: boolean;
+    /** Whether the field is optional (T | undefined or ?: modifier) */
+    optional?: boolean;
+}
+
 /**
  * Root UI Schema (always a layout).
  */
@@ -269,7 +463,7 @@ export declare type UISchemaElement = ControlElement | VerticalLayout | Horizont
 /**
  * Base interface for all UI Schema elements.
  */
-declare interface UISchemaElementBase {
+export declare interface UISchemaElementBase {
     type: UISchemaElementType;
     rule?: Rule;
     options?: Record<string, unknown>;

package/dist/cli.js

@@ -107,9 +107,7 @@ async function main() {
         const module = (await import(fileUrl));
         // Look for the form export
         const form = module["default"] ?? module["form"];
-        if (!form ||
-            typeof form !== "object" ||
-            !("elements" in form)) {
+        if (!form || typeof form !== "object" || !("elements" in form)) {
             console.error("Error: Input file must export a FormSpec as default export or as 'form'");
             console.error("Example:");
             console.error('  export default formspec(field.text("name"));');

package/dist/cli.js.map

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

package/dist/codegen/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Code generation for FormSpec type metadata.
+ *
+ * Generates a TypeScript file that patches decorated classes with
+ * their extracted type metadata, enabling runtime schema generation
+ * as an alternative to a TypeScript transformer.
+ *
+ * Usage:
+ *   formspec codegen ./src/forms.ts -o ./src/__formspec_types__.ts
+ *
+ * Then in your code:
+ *   import './__formspec_types__';  // Patches all decorated classes
+ *   import { UserFormSchema, getUserFormFormSpec } from './__formspec_types__';
+ *   const spec = getUserFormFormSpec();
+ */
+/**
+ * Type metadata format used by `@formspec/decorators`.
+ *
+ * Represents the runtime type information for a field that TypeScript
+ * normally erases at compile time.
+ */
+export interface TypeMetadata {
+    /** Base type: "string", "number", "boolean", "enum", "array", "object", "unknown" */
+    type: string;
+    /** For enum types, the possible literal values */
+    values?: unknown[];
+    /** For array types, metadata about the array element type */
+    itemType?: TypeMetadata;
+    /** For object types, metadata about each property */
+    properties?: Record<string, TypeMetadata>;
+    /** Whether the field accepts null */
+    nullable?: boolean;
+    /** Whether the field is optional (T | undefined or ?: modifier) */
+    optional?: boolean;
+}
+/**
+ * Information about a decorated class found during codegen analysis.
+ *
+ * Used to track which classes need type metadata patches and where
+ * they are located in the source tree.
+ */
+export interface DecoratedClassInfo {
+    /** Class name as it appears in the source file */
+    name: string;
+    /** Import path to the source file (relative to output, without extension) */
+    sourcePath: string;
+    /** Type metadata for all decorated properties in the class */
+    typeMetadata: Record<string, TypeMetadata>;
+    /** Whether the class is exported from its source file */
+    isExported: boolean;
+}
+/**
+ * Options for code generation.
+ */
+export interface CodegenOptions {
+    /** Source files to analyze (glob patterns supported) */
+    files: string[];
+    /** Output file path */
+    output: string;
+    /** Base directory for relative imports */
+    baseDir?: string;
+}
+/**
+ * Finds all decorated classes in the given source files.
+ */
+export declare function findDecoratedClasses(files: string[], baseDir: string): DecoratedClassInfo[];
+/**
+ * Generates the codegen output file content.
+ */
+export declare function generateCodegenOutput(classes: DecoratedClassInfo[], outputPath: string, baseDir: string): string;
+/**
+ * Runs the code generation.
+ */
+export declare function runCodegen(options: CodegenOptions): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAoC3F;AA6MD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,MAAM,CAuER;AA2RD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA6CxD"}