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

package/README.md

@@ -0,0 +1,138 @@
+# @formspec/build
+
+Build tools to compile FormSpec forms into JSON Schema and JSON Forms UI Schema.
+
+## Installation
+
+```bash
+npm install @formspec/build
+# or
+pnpm add @formspec/build
+```
+
+> **Note:** Most users should install the `formspec` umbrella package instead, which re-exports everything from this package.
+
+## Requirements
+
+This package is ESM-only and requires:
+
+```json
+// package.json
+{
+  "type": "module"
+}
+```
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext"
+  }
+}
+```
+
+## Usage
+
+### Generate Schemas in Memory
+
+```typescript
+import { buildFormSchemas } from "@formspec/build";
+import { formspec, field, group } from "@formspec/dsl";
+
+const ContactForm = formspec(
+  field.text("name", { label: "Name", required: true }),
+  field.text("email", { label: "Email", required: true }),
+  field.enum("subject", ["General", "Support", "Sales"])
+);
+
+const { jsonSchema, uiSchema } = buildFormSchemas(ContactForm);
+
+// Use with JSON Forms renderer
+// <JsonForms schema={jsonSchema} uischema={uiSchema} data={formData} />
+```
+
+### Write Schemas to Disk
+
+```typescript
+import { writeSchemas } from "@formspec/build";
+
+const result = writeSchemas(ContactForm, {
+  outDir: "./generated",
+  name: "contact-form",
+  indent: 2,
+});
+
+console.log(`JSON Schema: ${result.jsonSchemaPath}`);
+console.log(`UI Schema: ${result.uiSchemaPath}`);
+// JSON Schema: ./generated/contact-form-schema.json
+// UI Schema: ./generated/contact-form-uischema.json
+```
+
+### Use Individual Generators
+
+```typescript
+import { generateJsonSchema, generateUiSchema } from "@formspec/build";
+
+const jsonSchema = generateJsonSchema(ContactForm);
+const uiSchema = generateUiSchema(ContactForm);
+```
+
+## Generated Output
+
+### JSON Schema (Draft-07)
+
+```json
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "name": { "type": "string", "title": "Name" },
+    "email": { "type": "string", "title": "Email" },
+    "subject": {
+      "type": "string",
+      "enum": ["General", "Support", "Sales"]
+    }
+  },
+  "required": ["name", "email"]
+}
+```
+
+### JSON Forms UI Schema
+
+```json
+{
+  "type": "VerticalLayout",
+  "elements": [
+    { "type": "Control", "scope": "#/properties/name", "label": "Name" },
+    { "type": "Control", "scope": "#/properties/email", "label": "Email" },
+    { "type": "Control", "scope": "#/properties/subject" }
+  ]
+}
+```
+
+## API Reference
+
+### Functions
+
+| Function                      | Description                             |
+| ----------------------------- | --------------------------------------- |
+| `buildFormSchemas(form)`      | Generate both JSON Schema and UI Schema |
+| `generateJsonSchema(form)`    | Generate only JSON Schema               |
+| `generateUiSchema(form)`      | Generate only UI Schema                 |
+| `writeSchemas(form, options)` | Build and write schemas to disk         |
+
+### Types
+
+| Type                  | Description                       |
+| --------------------- | --------------------------------- |
+| `BuildResult`         | Return type of `buildFormSchemas` |
+| `WriteSchemasOptions` | Options for `writeSchemas`        |
+| `WriteSchemasResult`  | Return type of `writeSchemas`     |
+| `JSONSchema7`         | JSON Schema Draft-07 type         |
+| `UISchema`            | JSON Forms UI Schema type         |
+
+## License
+
+UNLICENSED

package/dist/__tests__/analyzer-edge-cases.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Edge case and negative tests for analysis and generation components.
+ *
+ * Tests cover:
+ * - Complex union types
+ * - Nullable and optional patterns
+ * - Array edge cases
+ * - Object edge cases
+ * - Decorator extractor edge cases
+ * - Program context error handling
+ */
+export {};
+//# sourceMappingURL=analyzer-edge-cases.test.d.ts.map

package/dist/__tests__/analyzer-edge-cases.test.d.ts.map

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

package/dist/__tests__/analyzer.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the analyzer module.
+ */
+export {};
+//# sourceMappingURL=analyzer.test.d.ts.map

package/dist/__tests__/analyzer.test.d.ts.map

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

package/dist/__tests__/codegen.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for the codegen type generation functions.
+ */
+export {};
+//# sourceMappingURL=codegen.test.d.ts.map

package/dist/__tests__/codegen.test.d.ts.map

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

package/dist/__tests__/decorator-pipeline.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Integration tests for the decorated class -> static analysis -> JSON Schema pipeline.
+ *
+ * Tests the full pipeline: decorated TypeScript class -> analyzeClass -> generateClassSchemas
+ * -> JSON Schema + UI Schema output, including extended and custom decorator support.
+ *
+ * @see packages/decorators/src/index.ts for decorator definitions
+ * @see packages/build/src/analyzer/decorator-extractor.ts for brand resolution
+ */
+export {};
+//# sourceMappingURL=decorator-pipeline.test.d.ts.map

package/dist/__tests__/decorator-pipeline.test.d.ts.map

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

package/dist/__tests__/fixtures/edge-cases.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Edge case fixtures for testing type converter and analyzer.
+ *
+ * These test various TypeScript type patterns that might cause issues.
+ */
+/**
+ * Mixed type union (not just literals) - should produce oneOf.
+ */
+export declare class MixedUnionTypes {
+    mixedPrimitive: string | number;
+    complexUnion: string | {
+        nested: boolean;
+    };
+    objectUnion: {
+        type: "a";
+        valueA: string;
+    } | {
+        type: "b";
+        valueB: number;
+    };
+}
+/**
+ * Various nullable patterns.
+ */
+export declare class NullablePatterns {
+    nullableString: string | null;
+    undefinedString: string | undefined;
+    optionalNullable?: string | null;
+    tripleUnion: string | null | undefined;
+    nullableStatus: "active" | "inactive" | null;
+}
+/**
+ * Various array patterns.
+ */
+export declare class ArrayEdgeCases {
+    strings: string[];
+    mixedArray: (string | number)[];
+    nullableArray: string[] | null;
+    objectArray: {
+        id: number;
+        name: string;
+    }[];
+    anyArray: unknown[];
+    nestedArray: string[][];
+}
+/**
+ * Various object type patterns.
+ */
+export declare class ObjectEdgeCases {
+    emptyObject: {};
+    stringRecord: Record<string, string>;
+    deepNested: {
+        level1: {
+            level2: {
+                level3: {
+                    value: string;
+                };
+            };
+        };
+    };
+    optionalProps: {
+        required: string;
+        optional?: number;
+    };
+}
+/**
+ * Special TypeScript types.
+ */
+export declare class SpecialTypes {
+    anyField: any;
+    unknownField: unknown;
+    voidField: void;
+    dateField: Date;
+}
+/**
+ * Various enum patterns.
+ */
+export declare class EnumVariations {
+    singleLiteral: "only";
+    numberEnum: 1 | 2 | 3;
+    mixedLiterals: "string" | 42;
+    largeEnum: "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j";
+}
+/**
+ * Simple class with no decorators for testing analyzer edge cases.
+ */
+export declare class NoDecoratorsClass {
+    name: string;
+    count?: number;
+    active: boolean;
+}
+export declare const notFormSpec1: null;
+export declare const notFormSpec2: undefined;
+export declare const notFormSpec3 = "string";
+export declare const notFormSpec4 = 123;
+export declare const notFormSpec5: {
+    notElements: never[];
+};
+export declare const notFormSpec6: {
+    elements: string;
+};
+export declare const notFormSpec7: {
+    elements: {
+        missingType: boolean;
+    }[];
+};
+export declare const notFormSpec8: {
+    elements: null[];
+};
+//# sourceMappingURL=edge-cases.d.ts.map

package/dist/__tests__/fixtures/edge-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-cases.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/edge-cases.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,qBAAa,eAAe;IAE1B,cAAc,EAAG,MAAM,GAAG,MAAM,CAAC;IAGjC,YAAY,EAAG,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAG5C,WAAW,EAAG;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,cAAc,EAAG,MAAM,GAAG,IAAI,CAAC;IAG/B,eAAe,EAAG,MAAM,GAAG,SAAS,CAAC;IAGrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGjC,WAAW,EAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAGxC,cAAc,EAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC;CAC/C;AAMD;;GAEG;AACH,qBAAa,cAAc;IAEzB,OAAO,EAAG,MAAM,EAAE,CAAC;IAGnB,UAAU,EAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAGjC,aAAa,EAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAGhC,WAAW,EAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAG7C,QAAQ,EAAG,OAAO,EAAE,CAAC;IAGrB,WAAW,EAAG,MAAM,EAAE,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,qBAAa,eAAe;IAG1B,WAAW,EAAG,EAAE,CAAC;IAGjB,YAAY,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGtC,UAAU,EAAG;QACX,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC;iBACf,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IAGF,aAAa,EAAG;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAMD;;GAEG;AACH,qBAAa,YAAY;IAGvB,QAAQ,EAAG,GAAG,CAAC;IAGf,YAAY,EAAG,OAAO,CAAC;IAOvB,SAAS,EAAG,IAAI,CAAC;IAGjB,SAAS,EAAG,IAAI,CAAC;CAClB;AAMD;;GAEG;AACH,qBAAa,cAAc;IAEzB,aAAa,EAAG,MAAM,CAAC;IAGvB,UAAU,EAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAIvB,aAAa,EAAG,QAAQ,GAAG,EAAE,CAAC;IAG9B,SAAS,EAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CACvE;AAMD;;GAEG;AACH,qBAAa,iBAAiB;IAE5B,IAAI,EAAG,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,MAAM,EAAG,OAAO,CAAC;CAClB;AAMD,eAAO,MAAM,YAAY,MAAO,CAAC;AACjC,eAAO,MAAM,YAAY,WAAY,CAAC;AACtC,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY;;CAAsB,CAAC;AAChD,eAAO,MAAM,YAAY;;CAA4B,CAAC;AACtD,eAAO,MAAM,YAAY;;;;CAAwC,CAAC;AAClE,eAAO,MAAM,YAAY;;CAAuB,CAAC"}

package/dist/__tests__/fixtures/example-a-builtins.d.ts

@@ -0,0 +1,12 @@
+export declare class ExampleAForm {
+    name: string;
+    age: number;
+    score: number;
+    email?: string;
+    country: "us" | "ca";
+    state?: string;
+    /** @deprecated Use email instead */
+    fax?: string;
+    role: "admin" | "user";
+}
+//# sourceMappingURL=example-a-builtins.d.ts.map

package/dist/__tests__/fixtures/example-a-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-a-builtins.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-a-builtins.ts"],"names":[],"mappings":"AAaA,qBAAa,YAAY;IAIvB,IAAI,EAAG,MAAM,CAAC;IAKd,GAAG,EAAG,MAAM,CAAC;IAIb,KAAK,EAAG,MAAM,CAAC;IAIf,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,OAAO,EAAG,IAAI,GAAG,IAAI,CAAC;IAItB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IAEpC,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAU;CACjC"}

package/dist/__tests__/fixtures/example-b-decorators.d.ts

@@ -0,0 +1,5 @@
+import type { FieldOptions } from "@formspec/decorators";
+export declare const CustomField: ((_args: FieldOptions) => (value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecExtendsBrand<"Field">;
+export declare const Floor: ((_args: number) => (value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecExtendsBrand<"Minimum">;
+export declare const Ceiling: ((_args: number) => (value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecExtendsBrand<"Maximum">;
+//# sourceMappingURL=example-b-decorators.d.ts.map

package/dist/__tests__/fixtures/example-b-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-b-decorators.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-b-decorators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,WAAW,2JAA2D,CAAC;AACpF,eAAO,MAAM,KAAK,uJAAiD,CAAC;AACpE,eAAO,MAAM,OAAO,uJAAmD,CAAC"}

package/dist/__tests__/fixtures/example-b-extended.d.ts

@@ -0,0 +1,5 @@
+export declare class ExampleBForm {
+    amount: number;
+    label: string;
+}
+//# sourceMappingURL=example-b-extended.d.ts.map

package/dist/__tests__/fixtures/example-b-extended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-b-extended.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-b-extended.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAIvB,MAAM,EAAG,MAAM,CAAC;IAGhB,KAAK,EAAG,MAAM,CAAC;CAChB"}

package/dist/__tests__/fixtures/example-c-custom.d.ts

@@ -0,0 +1,5 @@
+export declare class ExampleCForm {
+    heading: string;
+    urgency: number;
+}
+//# sourceMappingURL=example-c-custom.d.ts.map

package/dist/__tests__/fixtures/example-c-custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-c-custom.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-c-custom.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IAGvB,OAAO,EAAG,MAAM,CAAC;IAKjB,OAAO,EAAG,MAAM,CAAC;CAClB"}

package/dist/__tests__/fixtures/example-c-decorators.d.ts

@@ -0,0 +1,5 @@
+export declare const Title: ((value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecMarkerBrand & import("@formspec/decorators").FormSpecExtensionBrand<"title-field">;
+export declare const Priority: ((_args: {
+    level: string;
+}) => (value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecExtensionBrand<"priority">;
+//# sourceMappingURL=example-c-decorators.d.ts.map

package/dist/__tests__/fixtures/example-c-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-c-decorators.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-c-decorators.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,+LAAiD,CAAC;AACpE,eAAO,MAAM,QAAQ;WAA2C,MAAM;0IAAe,CAAC"}

package/dist/__tests__/fixtures/example-d-mixed-decorators.d.ts

@@ -0,0 +1,6 @@
+export declare class ExampleDForm {
+    username: string;
+    score: number;
+    plain: string;
+}
+//# sourceMappingURL=example-d-mixed-decorators.d.ts.map

package/dist/__tests__/fixtures/example-d-mixed-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-d-mixed-decorators.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-d-mixed-decorators.ts"],"names":[],"mappings":"AAYA,qBAAa,YAAY;IAGvB,QAAQ,EAAG,MAAM,CAAC;IAIlB,KAAK,EAAG,MAAM,CAAC;IAGf,KAAK,EAAG,MAAM,CAAC;CAChB"}

package/dist/__tests__/fixtures/example-e-decorators.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Custom decorator created without an extension namespace.
+ * The `customDecorator()` no-arg overload produces decorators
+ * that are recognized as FormSpec but have no extensionName,
+ * so no x-formspec-* keys should be emitted.
+ */
+export declare const Highlight: ((value: undefined, context: ClassFieldDecoratorContext) => void) & import("@formspec/decorators").FormSpecMarkerBrand;
+export declare const Metadata: (_args: {
+    key: string;
+}) => (value: undefined, context: ClassFieldDecoratorContext) => void;
+//# sourceMappingURL=example-e-decorators.d.ts.map

package/dist/__tests__/fixtures/example-e-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-e-decorators.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-e-decorators.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,wHAAwC,CAAC;AAC/D,eAAO,MAAM,QAAQ;SAA+B,MAAM;qEAAe,CAAC"}

package/dist/__tests__/fixtures/example-e-no-namespace.d.ts

@@ -0,0 +1,5 @@
+export declare class ExampleEForm {
+    title: string;
+    notes: string;
+}
+//# sourceMappingURL=example-e-no-namespace.d.ts.map

package/dist/__tests__/fixtures/example-e-no-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-e-no-namespace.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-e-no-namespace.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IAGvB,KAAK,EAAG,MAAM,CAAC;IAIf,KAAK,EAAG,MAAM,CAAC;CAChB"}

package/dist/__tests__/fixtures/example-interface-types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Test fixtures for interface and type alias analysis.
+ *
+ * Tests the TSDoc-based schema extraction pipeline for interfaces,
+ * type aliases, nested types, and edge cases.
+ */
+export interface SimpleConfig {
+    /**
+     * @Field_displayName Full Name
+     * @Field_description The user's legal name
+     * @MinLength 1
+     * @MaxLength 200
+     */
+    name: string;
+    /** @Field_displayName Age @Minimum 0 @Maximum 150 */
+    age: number;
+    /** @Field_displayName Email @Pattern ^[^@]+@[^@]+$ */
+    email?: string;
+    /** @Field_displayName Active */
+    active: boolean;
+}
+export interface WithEnumOptions {
+    /**
+     * @Field_displayName Status
+     * @EnumOptions ["draft","active","archived"]
+     */
+    status: "draft" | "active" | "archived";
+    /**
+     * @Field_displayName Priority
+     * @EnumOptions [{"id":"low","label":"Low Priority"},{"id":"high","label":"High Priority"}]
+     */
+    priority: "low" | "high";
+}
+export interface EmptyInterface {
+}
+export interface OnlyOptionalFields {
+    /** @Field_displayName Notes */
+    notes?: string;
+    /** @Field_displayName Tags */
+    tags?: string;
+}
+/** @deprecated Use NewConfig instead */
+export interface DeprecatedFieldInterface {
+    /** @deprecated Use fullName instead */
+    name?: string;
+    /** @Field_displayName Full Name */
+    fullName: string;
+}
+export type SimpleTypeAlias = {
+    /** @Field_displayName Label @MinLength 1 */
+    label: string;
+    /** @Field_displayName Count @Minimum 0 */
+    count: number;
+    /** @Field_displayName Description */
+    description?: string;
+};
+export type TypeAliasWithEnumOptions = {
+    /**
+     * @Field_displayName Color
+     * @EnumOptions ["red","green","blue"]
+     */
+    color: "red" | "green" | "blue";
+};
+export type StringAlias = string;
+export type UnionAlias = "a" | "b" | "c";
+/** @Minimum 0 @Maximum 100 */
+export type Percent = number;
+/** @MinLength 1 @MaxLength 255 @Pattern ^[^@]+@[^@]+$ */
+export type Email = string;
+/** @Field_displayName Discount Rate @Field_description Percentage discount applied @Minimum 0 @Maximum 100 */
+export type AnnotatedPercent = number;
+export interface ConfigWithAliasedTypes {
+    /** @Field_displayName Discount */
+    discount: Percent;
+    /** @Field_displayName Contact Email */
+    contactEmail: Email;
+    /** @Field_displayName Tax Rate */
+    taxRate: AnnotatedPercent;
+}
+export interface Address {
+    /** @Field_displayName Street @MinLength 1 @MaxLength 200 */
+    street: string;
+    /** @Field_displayName City @MinLength 1 */
+    city: string;
+    /** @Field_displayName Zip @Pattern ^[0-9]{5}$ */
+    zip?: string;
+}
+export type ContactInfo = {
+    /** @Field_displayName Email @Pattern ^[^@]+@[^@]+$ */
+    email: string;
+    /** @Field_displayName Phone @MaxLength 20 */
+    phone?: string;
+};
+export interface NestedConfig {
+    /** @Field_displayName Name */
+    name: string;
+    /** @Field_displayName Address */
+    address: Address;
+    /** @Field_displayName Contact */
+    contact: ContactInfo;
+}
+//# sourceMappingURL=example-interface-types.d.ts.map

package/dist/__tests__/fixtures/example-interface-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-interface-types.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-interface-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IAEZ,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAExC;;;OAGG;IACH,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;CAC1B;AAGD,MAAM,WAAW,cAAc;CAAG;AAElC,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,MAAM,eAAe,GAAG;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAGF,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;CACjC,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAIzC,8BAA8B;AAC9B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,yDAAyD;AACzD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,8GAA8G;AAC9G,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAElB,uCAAuC;IACvC,YAAY,EAAE,KAAK,CAAC;IAEpB,kCAAkC;IAClC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAID,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/__tests__/fixtures/example-jsdoc-constraints.d.ts

@@ -0,0 +1,16 @@
+export declare class JSDocConstraintsForm {
+    /** @MinLength 1 @MaxLength 200 */
+    name: string;
+    /** @Minimum 0 @Maximum 150 */
+    age: number;
+    /** @Minimum 0.01 @Maximum 1000 */
+    weight: number;
+    /** @Minimum -273.15 */
+    temperature: number;
+    /** @Pattern ^[A-Z]{3}-\d{4}$ */
+    sku: string;
+    /** @ExclusiveMaximum 10000 */
+    stock: number;
+    notes?: string;
+}
+//# sourceMappingURL=example-jsdoc-constraints.d.ts.map

package/dist/__tests__/fixtures/example-jsdoc-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-jsdoc-constraints.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-jsdoc-constraints.ts"],"names":[],"mappings":"AAEA,qBAAa,oBAAoB;IAC/B,kCAAkC;IAElC,IAAI,EAAG,MAAM,CAAC;IAEd,8BAA8B;IAE9B,GAAG,EAAG,MAAM,CAAC;IAEb,kCAAkC;IAElC,MAAM,EAAG,MAAM,CAAC;IAEhB,uBAAuB;IAEvB,WAAW,EAAG,MAAM,CAAC;IAErB,gCAAgC;IAEhC,GAAG,EAAG,MAAM,CAAC;IAGb,8BAA8B;IAG9B,KAAK,EAAG,MAAM,CAAC;IAIf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/__tests__/fixtures/example-nested-class.d.ts

@@ -0,0 +1,45 @@
+export declare class Address {
+    street: string;
+    city: string;
+    zip?: string;
+}
+export declare class Dimensions {
+    /** @Minimum 0 @Maximum 10000 */
+    width: number;
+    /** @Minimum 0 @Maximum 10000 */
+    height: number;
+    /** @Minimum 0 */
+    depth: number;
+}
+export declare class UserWithAddress {
+    username: string;
+    address: Address;
+}
+export declare class ProductWithDimensions {
+    name: string;
+    dimensions: Dimensions;
+}
+export declare class Customer {
+    name: string;
+    address: Address;
+}
+export declare class Order {
+    orderId: string;
+    customer: Customer;
+}
+export declare class NodeA {
+    name: string;
+    sibling?: NodeB;
+}
+export declare class NodeB {
+    label: string;
+    sibling?: NodeA;
+}
+export declare class WithInlineObject {
+    title: string;
+    metadata: {
+        key: string;
+        value: string;
+    };
+}
+//# sourceMappingURL=example-nested-class.d.ts.map

package/dist/__tests__/fixtures/example-nested-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-nested-class.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-nested-class.ts"],"names":[],"mappings":"AAIA,qBAAa,OAAO;IAIlB,MAAM,EAAG,MAAM,CAAC;IAIhB,IAAI,EAAG,MAAM,CAAC;IAId,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,UAAU;IACrB,gCAAgC;IAEhC,KAAK,EAAG,MAAM,CAAC;IAEf,gCAAgC;IAEhC,MAAM,EAAG,MAAM,CAAC;IAEhB,iBAAiB;IAEjB,KAAK,EAAG,MAAM,CAAC;CAChB;AAID,qBAAa,eAAe;IAG1B,QAAQ,EAAG,MAAM,CAAC;IAGlB,OAAO,EAAG,OAAO,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAEhC,IAAI,EAAG,MAAM,CAAC;IAGd,UAAU,EAAG,UAAU,CAAC;CACzB;AAID,qBAAa,QAAQ;IAGnB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,EAAG,OAAO,CAAC;CACnB;AAED,qBAAa,KAAK;IAEhB,OAAO,EAAG,MAAM,CAAC;IAGjB,QAAQ,EAAG,QAAQ,CAAC;CACrB;AAID,qBAAa,KAAK;IAGhB,IAAI,EAAG,MAAM,CAAC;IAEd,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,qBAAa,KAAK;IAEhB,KAAK,EAAG,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAID,qBAAa,gBAAgB;IAE3B,KAAK,EAAG,MAAM,CAAC;IAEf,QAAQ,EAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C"}

package/dist/__tests__/fixtures/sample-forms.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Test fixture for CLI analyzer.
+ *
+ * Contains both:
+ * - Decorated classes (class + decorator DSL)
+ * - FormSpec exports (chain DSL)
+ */
+import type { InferFormSchema } from "@formspec/dsl";
+/**
+ * FormSpec for user registration.
+ */
+export declare const UserRegistrationForm: import("@formspec/core").FormSpec<readonly [import("@formspec/core").TextField<"username">, import("@formspec/core").TextField<"email">, import("@formspec/core").TextField<"password">, import("@formspec/core").BooleanField<"acceptTerms">]>;
+/**
+ * FormSpec for product configuration.
+ */
+export declare const ProductConfigForm: import("@formspec/core").FormSpec<readonly [import("@formspec/core").TextField<"name">, import("@formspec/core").NumberField<"price">, import("@formspec/core").StaticEnumField<"status", readonly ["draft", "active", "archived"]>]>;
+/**
+ * FormSpec for method parameters.
+ */
+export declare const ActivateParams: import("@formspec/core").FormSpec<readonly [import("@formspec/core").NumberField<"amount">, import("@formspec/core").NumberField<"installments">]>;
+export declare const CancelParams: import("@formspec/core").FormSpec<readonly [import("@formspec/core").StaticEnumField<"reason", readonly ["user_request", "fraud", "other"]>, import("@formspec/core").TextField<"notes">]>;
+/**
+ * Sample class with decorated fields and methods.
+ */
+export declare class InstallmentPlan {
+    status: "active" | "paused" | "canceled";
+    amount: number;
+    customerEmail?: string;
+    installments: number;
+    /**
+     * Activates the plan with the given parameters.
+     */
+    activate(params: InferFormSchema<typeof ActivateParams>): {
+        success: boolean;
+    };
+    /**
+     * Cancels the plan.
+     */
+    cancelPlan(params: InferFormSchema<typeof CancelParams>): void;
+    /**
+     * Static factory method.
+     */
+    static createStandard(name: string, amount: number): InstallmentPlan;
+}
+export declare class SimpleProduct {
+    name: string;
+    price?: number;
+    active: boolean;
+    tags?: string[];
+    update(data: {
+        name?: string;
+        price?: number;
+    }): boolean;
+}
+//# sourceMappingURL=sample-forms.d.ts.map

package/dist/__tests__/fixtures/sample-forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-forms.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/sample-forms.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,oBAAoB,iPAKhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,uOAM7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,oJAG1B,CAAC;AAEF,eAAO,MAAM,YAAY,4LAKxB,CAAC;AAMF;;GAEG;AACH,qBAAa,eAAe;IAC1B,MAAM,EAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE1C,MAAM,EAAG,MAAM,CAAC;IAEhB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,YAAY,EAAG,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,cAAc,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAK9E;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe;CAKrE;AAMD,qBAAa,aAAa;IACxB,IAAI,EAAG,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,EAAG,OAAO,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;CAKzD"}