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

package/dist/analyzer/decorator-extractor.d.ts

@@ -1,78 +0,0 @@
-/**
- * Decorator extractor for parsing decorator AST nodes.
- *
- * Extracts decorator names and arguments from class field decorators,
- * supporting the FormSpec decorator DSL (@Field, @Minimum, @Maximum, etc.).
- *
- * Also supports branded type resolution via the TypeScript type checker
- * to detect custom decorators created with `extendDecorator` and
- * `customDecorator` from `@formspec/decorators`.
- */
-import * as ts from "typescript";
-import { type FormSpecDecoratorName } from "@formspec/core";
-/**
- * Extracted decorator information.
- */
-export interface DecoratorInfo {
-    /** Decorator name (e.g., "Field", "Minimum") */
-    name: string;
-    /** Decorator arguments as literal values */
-    args: DecoratorArg[];
-    /** Raw AST node for the decorator (undefined for synthetic JSDoc constraint entries) */
-    node: ts.Decorator | undefined;
-    /** Resolved brand information from the type checker (populated by analyzeField) */
-    resolved?: ResolvedDecorator;
-}
-/**
- * A decorator argument value.
- * Can be a primitive, array, or object literal.
- */
-export type DecoratorArg = string | number | boolean | null | DecoratorArg[] | {
-    [key: string]: DecoratorArg;
-};
-/**
- * Result of resolving a decorator via the type checker.
- */
-export interface ResolvedDecorator {
-    /** Decorator name as it appears in source */
-    name: string;
-    /** If this extends a built-in, the built-in name (e.g., "Field") */
-    extendsBuiltin?: string;
-    /** If this belongs to a CLI extension namespace, the namespace name */
-    extensionName?: string;
-    /** Whether this is a known FormSpec decorator (built-in or factory-created) */
-    isFormSpec: boolean;
-    /** Whether this is a marker (zero-arg) decorator */
-    isMarker: boolean;
-}
-/**
- * Extracts decorators from a class member (property or method).
- *
- * @param member - The class member to extract decorators from
- * @returns Array of extracted decorator info
- */
-export declare function extractDecorators(member: ts.PropertyDeclaration | ts.MethodDeclaration): DecoratorInfo[];
-/**
- * Known FormSpec decorators and their expected argument types.
- *
- * This metadata object provides additional information about each decorator's
- * expected argument types. The keys are constrained to match FormSpecDecoratorName.
- */
-export declare const FORMSPEC_DECORATORS: Record<FormSpecDecoratorName, {
-    argTypes: readonly string[];
-}>;
-/**
- * Resolves a decorator via the TypeScript type checker to determine
- * if it is a FormSpec decorator (built-in, extended, or custom).
- *
- * This enables detection of:
- * 1. Direct imports of built-in decorators from `@formspec/decorators`
- * 2. Extended decorators created via `extendDecorator(...).as(...)`
- * 3. Custom decorators created via `customDecorator(...).as(...)` or `.marker(...)`
- *
- * @param decorator - The decorator AST node
- * @param checker - TypeScript type checker
- * @returns Resolved decorator information, or null if not resolvable
- */
-export declare function resolveDecorator(decorator: ts.Decorator, checker: ts.TypeChecker): ResolvedDecorator | null;
-//# sourceMappingURL=decorator-extractor.d.ts.map

package/dist/analyzer/decorator-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorator-extractor.d.ts","sourceRoot":"","sources":["../../src/analyzer/decorator-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,EAAE,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,iBAAiB,GACpD,aAAa,EAAE,CAgBjB;AA0KD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,EAAE;IAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAuBrF,CAAC;AAgBX;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,EAAE,CAAC,SAAS,EACvB,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,iBAAiB,GAAG,IAAI,CAyH1B"}

package/dist/analyzer/type-converter.d.ts

@@ -1,75 +0,0 @@
-/**
- * Type converter for transforming TypeScript types to JSON Schema and FormSpec.
- *
- * Converts TypeScript types (extracted via type checker) to:
- * - JSON Schema definitions
- * - FormSpec field definitions
- */
-import * as ts from "typescript";
-import type { DecoratorInfo } from "./decorator-extractor.js";
-import { type FieldInfo } from "./class-analyzer.js";
-import { type ExtendedJSONSchema7 } from "../json-schema/types.js";
-/**
- * FormSpec field definition (simplified for output).
- */
-export 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[];
-}
-/**
- * Result of converting a TypeScript type.
- */
-export interface TypeConversionResult {
-    /** JSON Schema representation */
-    jsonSchema: ExtendedJSONSchema7;
-    /** FormSpec field type */
-    formSpecFieldType: string;
-}
-/**
- * Converts a TypeScript type to JSON Schema and FormSpec field type.
- *
- * @param type - The TypeScript type to convert
- * @param checker - TypeScript type checker
- * @returns Conversion result with JSON Schema and FormSpec type
- */
-export declare function convertType(type: ts.Type, checker: ts.TypeChecker): TypeConversionResult;
-/**
- * Creates a FormSpec field definition from a field's type and decorators.
- *
- * @param fieldName - The field name
- * @param type - The TypeScript type
- * @param decorators - Decorators applied to the field
- * @param optional - Whether the field is optional
- * @param checker - TypeScript type checker
- * @returns FormSpec field definition
- */
-export declare function createFormSpecField(fieldName: string, type: ts.Type, decorators: DecoratorInfo[], optional: boolean, checker: ts.TypeChecker, visitedTypes?: Set<ts.Type>): FormSpecField;
-/**
- * Applies decorator constraints to a JSON Schema.
- *
- * @param schema - The base JSON Schema
- * @param decorators - Decorators to apply
- * @param fieldInfo - Optional field info for deprecated/default values
- * @returns Modified JSON Schema with constraints
- */
-export declare function applyDecoratorsToSchema(schema: ExtendedJSONSchema7, decorators: DecoratorInfo[], fieldInfo?: FieldInfo): ExtendedJSONSchema7;
-//# sourceMappingURL=type-converter.d.ts.map

package/dist/analyzer/type-converter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-converter.d.ts","sourceRoot":"","sources":["../../src/analyzer/type-converter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA2HD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,oBAAoB,CAExF;AAqND;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,YAAY,eAAqB,GAChC,aAAa,CAiDf;AAuFD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,aAAa,EAAE,EAC3B,SAAS,CAAC,EAAE,SAAS,GACpB,mBAAmB,CA6FrB"}

package/dist/codegen/index.d.ts

@@ -1,75 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}