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

package/dist/__tests__/interface-types.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for interface and type alias schema generation.
+ *
+ * Covers the `generateSchemas` unified entry point, `analyzeInterface`,
+ * `analyzeTypeAlias`, `extractJSDocFieldMetadata`, `@EnumOptions` JSON
+ * parsing, nested type propagation, and error paths.
+ *
+ * @see https://json-schema.org/understanding-json-schema
+ */
+export {};
+//# sourceMappingURL=interface-types.test.d.ts.map

package/dist/__tests__/interface-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/interface-types.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/jsdoc-constraints.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for JSDoc constraint tag extraction.
+ *
+ * Verifies that {@link extractJSDocConstraints} correctly parses TSDoc
+ * constraint tags into synthetic DecoratorInfo objects.
+ *
+ * @see packages/core/src/types/decorators.ts for CONSTRAINT_TAG_DEFINITIONS
+ */
+export {};
+//# sourceMappingURL=jsdoc-constraints.test.d.ts.map

package/dist/__tests__/jsdoc-constraints.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc-constraints.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/jsdoc-constraints.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/analyzer/class-analyzer.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Class analyzer for extracting fields, types, and decorators.
+ *
+ * Analyzes a TypeScript class declaration to extract:
+ * - Field names and TypeScript types
+ * - Decorator metadata (Field, Minimum, Maximum, etc.)
+ * - Field optionality
+ * - TSDoc @deprecated tags
+ * - Default values from property initializers
+ */
+import * as ts from "typescript";
+import { type DecoratorInfo } from "./decorator-extractor.js";
+/**
+ * Analyzed field information from a class.
+ */
+export interface FieldInfo {
+    /** Field name */
+    name: string;
+    /** TypeScript type node for the field */
+    typeNode: ts.TypeNode | undefined;
+    /** Resolved type from the type checker */
+    type: ts.Type;
+    /** Whether the field is optional (has ? modifier) */
+    optional: boolean;
+    /** Decorators applied to the field */
+    decorators: DecoratorInfo[];
+    /** Whether the field has a TSDoc @deprecated tag */
+    deprecated: boolean;
+    /** Default value extracted from the property initializer (literal values only) */
+    defaultValue: unknown;
+}
+/**
+ * Result of analyzing a class declaration.
+ */
+export interface ClassAnalysis {
+    /** Class name */
+    name: string;
+    /** Analyzed fields */
+    fields: FieldInfo[];
+    /** Instance methods */
+    instanceMethods: MethodInfo[];
+    /** Static methods */
+    staticMethods: MethodInfo[];
+}
+/**
+ * Analyzed method information.
+ */
+export interface MethodInfo {
+    /** Method name */
+    name: string;
+    /** Method parameters */
+    parameters: ParameterInfo[];
+    /** Return type node */
+    returnTypeNode: ts.TypeNode | undefined;
+    /** Resolved return type */
+    returnType: ts.Type;
+}
+/**
+ * Analyzed parameter information.
+ */
+export interface ParameterInfo {
+    /** Parameter name */
+    name: string;
+    /** TypeScript type node */
+    typeNode: ts.TypeNode | undefined;
+    /** Resolved type */
+    type: ts.Type;
+    /** If this is InferSchema<typeof X>, the export name X */
+    formSpecExportName: string | null;
+    /** Whether the parameter is optional (has ? or default value) */
+    optional: boolean;
+}
+/**
+ * Analyzes a class declaration to extract fields and methods.
+ *
+ * @param classDecl - The class declaration to analyze
+ * @param checker - TypeScript type checker
+ * @returns Analysis result with fields and methods
+ */
+export declare function analyzeClass(classDecl: ts.ClassDeclaration, checker: ts.TypeChecker): ClassAnalysis;
+/**
+ * Analyzes a property declaration to extract field info.
+ */
+export declare function analyzeField(prop: ts.PropertyDeclaration, checker: ts.TypeChecker): FieldInfo | null;
+/**
+ * Analyzes an interface declaration to extract field information.
+ *
+ * Similar to {@link analyzeClass} but for interface declarations.
+ * Extracts JSDoc constraint tags (`@Minimum`, `@MaxLength`, etc.) and
+ * display metadata (`@Field_displayName`, `@Field_description`) from
+ * property signatures, producing the same {@link ClassAnalysis}
+ * structure for downstream schema generation.
+ *
+ * @param interfaceDecl - The interface declaration to analyze
+ * @param checker - TypeScript type checker
+ * @returns Analysis result with fields (no methods — interfaces have no implementations)
+ */
+export declare function analyzeInterface(interfaceDecl: ts.InterfaceDeclaration, checker: ts.TypeChecker): ClassAnalysis;
+/**
+ * Result of analyzing a type alias — either a successful analysis or
+ * an error describing why the alias can't be analyzed.
+ */
+export type AnalyzeTypeAliasResult = {
+    ok: true;
+    analysis: ClassAnalysis;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Analyzes a type alias declaration to extract field information.
+ *
+ * Supports type aliases whose body is a type literal (object type):
+ *
+ * ```typescript
+ * type Config = {
+ *   // @Field_displayName Name @Minimum 1
+ *   name: string;
+ * };
+ * ```
+ *
+ * Returns an error result (not an exception) for non-object-literal aliases,
+ * allowing callers to accumulate diagnostics across multiple types.
+ *
+ * @param typeAlias - The type alias declaration to analyze
+ * @param checker - TypeScript type checker
+ * @returns Success with analysis, or error with a diagnostic message including line number
+ */
+export declare function analyzeTypeAlias(typeAlias: ts.TypeAliasDeclaration, checker: ts.TypeChecker): AnalyzeTypeAliasResult;
+/**
+ * Analyzes an interface property signature to extract field info.
+ *
+ * Extracts JSDoc constraint tags (`@Minimum`, `@MaxLength`, etc.) and
+ * display metadata (`@DisplayName`, `@Description`) from the property's
+ * TSDoc comments. Also used by the type converter for nested interface/type
+ * alias constraint propagation.
+ */
+export declare function analyzeInterfaceProperty(prop: ts.PropertySignature, checker: ts.TypeChecker): FieldInfo | null;
+//# sourceMappingURL=class-analyzer.d.ts.map

package/dist/analyzer/class-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/class-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAuC,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGnG;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IAClC,0CAA0C;IAC1C,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,kFAAkF;IAClF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uBAAuB;IACvB,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,qBAAqB;IACrB,aAAa,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,uBAAuB;IACvB,cAAc,EAAE,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IACxC,2BAA2B;IAC3B,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC;IAClC,oBAAoB;IACpB,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAC9B,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,EAAE,CAAC,mBAAmB,EAC5B,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,SAAS,GAAG,IAAI,CA6ClB;AAsLD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,EAAE,CAAC,oBAAoB,EACtC,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,aAAa,CAmBf;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,EAAE,CAAC,oBAAoB,EAClC,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,sBAAsB,CAkCxB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAC1B,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,SAAS,GAAG,IAAI,CAyClB"}

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

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

@@ -0,0 +1 @@
+{"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/jsdoc-constraints.d.ts

@@ -0,0 +1,47 @@
+/**
+ * JSDoc constraint tag extractor.
+ *
+ * Extracts constraint tags from JSDoc comments on class fields and returns
+ * synthetic {@link DecoratorInfo} objects that integrate seamlessly with
+ * the existing decorator-based constraint pipeline.
+ *
+ * Supported tags correspond to keys in {@link CONSTRAINT_TAG_DEFINITIONS}
+ * from `@formspec/core` (e.g., `@Minimum`, `@Maximum`, `@Pattern`).
+ */
+import * as ts from "typescript";
+import type { DecoratorInfo } from "./decorator-extractor.js";
+/**
+ * Extracts JSDoc constraint tags from a TypeScript AST node and returns
+ * synthetic {@link DecoratorInfo} objects.
+ *
+ * For each recognised tag (case-sensitive PascalCase match against
+ * {@link CONSTRAINT_TAG_DEFINITIONS}), the comment text is parsed
+ * according to the tag's declared value type:
+ * - `"number"` tags: parsed via `Number()` — skipped when NaN
+ * - `"string"` tags (`Pattern`): used as-is (trimmed)
+ *
+ * @param node - The AST node to inspect for JSDoc tags
+ * @returns Synthetic decorator info objects for each valid constraint tag
+ */
+export declare function extractJSDocConstraints(node: ts.Node): DecoratorInfo[];
+/**
+ * Extracts `@Field_displayName` and `@Field_description` TSDoc tags from
+ * a node and returns a synthetic `Field` {@link DecoratorInfo} if either
+ * is present.
+ *
+ * This enables interface properties to carry display metadata via TSDoc
+ * tags instead of the `@Field` decorator (which requires a class):
+ *
+ * ```typescript
+ * interface Config {
+ *   // @Field_displayName Program Name
+ *   // @Field_description Internal identifier
+ *   programName: string;
+ * }
+ * ```
+ *
+ * @param node - The AST node to inspect for display metadata tags
+ * @returns A synthetic `Field` decorator info, or null if no tags found
+ */
+export declare function extractJSDocFieldMetadata(node: ts.Node): DecoratorInfo | null;
+//# sourceMappingURL=jsdoc-constraints.d.ts.map

package/dist/analyzer/jsdoc-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc-constraints.d.ts","sourceRoot":"","sources":["../../src/analyzer/jsdoc-constraints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,aAAa,EAAE,CAoDtE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,aAAa,GAAG,IAAI,CAiC7E"}

package/dist/analyzer/program.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TypeScript program setup for static analysis.
+ *
+ * Creates a TypeScript program with type checker from a source file,
+ * using the project's tsconfig.json for compiler options.
+ */
+import * as ts from "typescript";
+/**
+ * Result of creating a TypeScript program for analysis.
+ */
+export interface ProgramContext {
+    /** The TypeScript program */
+    program: ts.Program;
+    /** Type checker for resolving types */
+    checker: ts.TypeChecker;
+    /** The source file being analyzed */
+    sourceFile: ts.SourceFile;
+}
+/**
+ * Creates a TypeScript program for analyzing a source file.
+ *
+ * Looks for tsconfig.json in the file's directory or parent directories.
+ * Falls back to default compiler options if no config is found.
+ *
+ * @param filePath - Absolute path to the TypeScript source file
+ * @returns Program context with checker and source file
+ */
+export declare function createProgramContext(filePath: string): ProgramContext;
+/**
+ * Finds a class declaration by name in a source file.
+ *
+ * @param sourceFile - The source file to search
+ * @param className - Name of the class to find
+ * @returns The class declaration node, or null if not found
+ */
+export declare function findClassByName(sourceFile: ts.SourceFile, className: string): ts.ClassDeclaration | null;
+/**
+ * Finds an interface declaration by name in a source file.
+ *
+ * @param sourceFile - The source file to search
+ * @param interfaceName - Name of the interface to find
+ * @returns The interface declaration node, or null if not found
+ */
+export declare function findInterfaceByName(sourceFile: ts.SourceFile, interfaceName: string): ts.InterfaceDeclaration | null;
+/**
+ * Finds a type alias declaration by name in a source file.
+ *
+ * @param sourceFile - The source file to search
+ * @param aliasName - Name of the type alias to find
+ * @returns The type alias declaration node, or null if not found
+ */
+export declare function findTypeAliasByName(sourceFile: ts.SourceFile, aliasName: string): ts.TypeAliasDeclaration | null;
+//# sourceMappingURL=program.d.ts.map

package/dist/analyzer/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/analyzer/program.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,uCAAuC;IACvC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,qCAAqC;IACrC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA6DrE;AA6BD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,MAAM,GAChB,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAE5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,aAAa,EAAE,MAAM,GACpB,EAAE,CAAC,oBAAoB,GAAG,IAAI,CAEhC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,MAAM,GAChB,EAAE,CAAC,oBAAoB,GAAG,IAAI,CAEhC"}

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

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

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