@formspec/build 0.1.0-alpha.2 → 0.1.0-alpha.20

package/README.md

@@ -0,0 +1,120 @@
+# @formspec/build
+
+Build-time schema generation for FormSpec.
+
+This package covers:
+
+- Chain DSL to JSON Schema / UI Schema compilation
+- Static analysis of TypeScript classes, interfaces, and type aliases with TSDoc tags
+- Canonical IR generation and validation
+- Extension-aware schema generation with custom vendor keywords
+
+## Install
+
+```bash
+pnpm add @formspec/build
+```
+
+Most app code can use `formspec`, but use `@formspec/build` directly when you need static analysis or lower-level generation APIs.
+
+## Public Entry Points
+
+| Entry point                 | Purpose                                |
+| --------------------------- | -------------------------------------- |
+| `@formspec/build`           | Public build APIs                      |
+| `@formspec/build/browser`   | Browser-safe schema generation surface |
+| `@formspec/build/internals` | Unstable internal APIs used by the CLI |
+
+## Chain DSL Generation
+
+```ts
+import { buildFormSchemas } from "@formspec/build";
+import { field, formspec } from "@formspec/dsl";
+
+const form = formspec(
+  field.text("name", { required: true }),
+  field.enum("status", ["draft", "published"] as const)
+);
+
+const { jsonSchema, uiSchema } = buildFormSchemas(form);
+```
+
+## Static Analysis
+
+`generateSchemas()` is the main entry point for TSDoc-backed generation.
+
+```ts
+import { generateSchemas } from "@formspec/build";
+
+const { jsonSchema, uiSchema } = generateSchemas({
+  filePath: "./src/forms.ts",
+  typeName: "ProductConfig",
+});
+```
+
+`generateSchemasFromClass()` remains available when the input is definitely a class declaration.
+
+```ts
+import { generateSchemasFromClass } from "@formspec/build";
+
+const result = generateSchemasFromClass({
+  filePath: "./src/forms.ts",
+  className: "ProductConfig",
+});
+```
+
+### Supported TSDoc Examples
+
+```ts
+export interface ProductConfig {
+  /** @displayName Product Name @minLength 1 */
+  name: string;
+
+  /** @format email */
+  supportEmail?: string;
+
+  /** @placeholder Search products */
+  query?: string;
+
+  /** @minimum 0 @maximum 9999.99 */
+  price: number;
+
+  /** @uniqueItems */
+  tags: string[];
+}
+```
+
+## Extension-Aware Generation
+
+Both chain and static generation APIs accept `extensionRegistry` and `vendorPrefix` where relevant.
+
+```ts
+import { createExtensionRegistry, generateSchemas } from "@formspec/build";
+
+const registry = createExtensionRegistry([myExtension]);
+
+const result = generateSchemas({
+  filePath: "./src/forms.ts",
+  typeName: "Invoice",
+  extensionRegistry: registry,
+  vendorPrefix: "x-acme",
+});
+```
+
+Generation validates canonical IR before emitting schemas. Invalid inputs now fail generation with structured diagnostic codes surfaced in the thrown error.
+
+## Main Exports
+
+- `buildFormSchemas(form, options?)`
+- `generateJsonSchema(form, options?)`
+- `generateUiSchema(form)`
+- `writeSchemas(form, options)`
+- `generateSchemas(options)`
+- `generateSchemasFromClass(options)`
+- `generateJsonSchemaFromIR(ir, options?)`
+- `buildMixedAuthoringSchemas(options)`
+- `createExtensionRegistry(extensions)`
+
+## License
+
+UNLICENSED

package/dist/__tests__/alias-chain-propagation.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for transitive type alias constraint propagation.
+ *
+ * Verifies that constraints declared on type aliases propagate transitively
+ * through alias chains (e.g., Integer → Percentage → field), and that
+ * excessively deep chains throw a clear error.
+ */
+export {};
+//# sourceMappingURL=alias-chain-propagation.test.d.ts.map

package/dist/__tests__/alias-chain-propagation.test.d.ts.map

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

package/dist/__tests__/chain-dsl-canonicalizer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chain-dsl-canonicalizer.test.d.ts.map

package/dist/__tests__/chain-dsl-canonicalizer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-dsl-canonicalizer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/chain-dsl-canonicalizer.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/class-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=class-schema.test.d.ts.map

package/dist/__tests__/class-schema.test.d.ts.map

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

package/dist/__tests__/constraint-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=constraint-validator.test.d.ts.map

package/dist/__tests__/constraint-validator.test.d.ts.map

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

package/dist/__tests__/date-extension.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=date-extension.integration.test.d.ts.map

package/dist/__tests__/date-extension.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-extension.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/date-extension.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/extension-api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-api.test.d.ts.map

package/dist/__tests__/extension-api.test.d.ts.map

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

package/dist/__tests__/extension-runtime.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-runtime.integration.test.d.ts.map

package/dist/__tests__/extension-runtime.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-runtime.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/extension-runtime.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fixtures/alias-chains.d.ts

@@ -0,0 +1,37 @@
+/** @multipleOf 1 */
+type Integer = number;
+/** @minimum 0 @maximum 100 */
+type Percentage = Integer;
+export declare class TwoLevelChain {
+    /** @minimum 10 */
+    cpuUsage: Percentage;
+    memoryUsage: Percentage;
+}
+/** @minimum 0 */
+type Base = number;
+/** @maximum 1000 */
+type Mid = Base;
+/** @multipleOf 5 */
+type Leaf = Mid;
+export declare class ThreeLevelChain {
+    value: Leaf;
+}
+export declare class NoAlias {
+    /** @minimum 0 */
+    count: number;
+}
+type D0 = number;
+type D1 = D0;
+type D2 = D1;
+type D3 = D2;
+type D4 = D3;
+type D5 = D4;
+type D6 = D5;
+type D7 = D6;
+type D8 = D7;
+type D9 = D8;
+export declare class ExceedsMaxDepth {
+    value: D9;
+}
+export {};
+//# sourceMappingURL=alias-chains.d.ts.map

package/dist/__tests__/fixtures/alias-chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-chains.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/alias-chains.ts"],"names":[],"mappings":"AAIA,oBAAoB;AACpB,KAAK,OAAO,GAAG,MAAM,CAAC;AAEtB,8BAA8B;AAC9B,KAAK,UAAU,GAAG,OAAO,CAAC;AAE1B,qBAAa,aAAa;IACxB,kBAAkB;IAClB,QAAQ,EAAG,UAAU,CAAC;IACtB,WAAW,EAAG,UAAU,CAAC;CAC1B;AAID,iBAAiB;AACjB,KAAK,IAAI,GAAG,MAAM,CAAC;AAEnB,oBAAoB;AACpB,KAAK,GAAG,GAAG,IAAI,CAAC;AAEhB,oBAAoB;AACpB,KAAK,IAAI,GAAG,GAAG,CAAC;AAEhB,qBAAa,eAAe;IAC1B,KAAK,EAAG,IAAI,CAAC;CACd;AAID,qBAAa,OAAO;IAClB,iBAAiB;IACjB,KAAK,EAAG,MAAM,CAAC;CAChB;AAOD,KAAK,EAAE,GAAG,MAAM,CAAC;AACjB,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AACb,KAAK,EAAE,GAAG,EAAE,CAAC;AAEb,qBAAa,eAAe;IAC1B,KAAK,EAAG,EAAE,CAAC;CACZ"}

package/dist/__tests__/fixtures/class-schema-regressions.d.ts

@@ -0,0 +1,87 @@
+export declare class NotificationPreferences {
+    /** @defaultValue "email" */
+    channel?: string;
+    /** @defaultValue 3 */
+    retryCount?: number;
+    /** @defaultValue true */
+    enabled?: boolean;
+    /** @defaultValue null */
+    nickname?: string | null;
+}
+export declare class ContactForm {
+    /** @format email */
+    emailAddress: string;
+    /** @format date */
+    birthDate: string;
+    /** @format uri */
+    website: string;
+}
+export declare class SearchForm {
+    /** @placeholder Search by keyword... */
+    query: string;
+}
+export declare class SettingsForm {
+    /** @deprecated Use displayName instead */
+    legacyName: string;
+    /** @displayName Display Name */
+    displayName: string;
+}
+export declare class TagManager {
+    /** @minItems 1 @maxItems 10 @uniqueItems */
+    tags: string[];
+}
+export declare class SurveyForm {
+    /** @maxLength 280 */
+    responses: string[];
+}
+/**
+ * Summary text becomes the root schema description when no explicit tag is present.
+ */
+export declare class DescriptionPrecedenceForm {
+    /**
+     * Summary that should be ignored.
+     * @remarks Ignored remarks.
+     * @description Explicit description wins.
+     */
+    explicit: string;
+    /** @remarks Remarks become description when no explicit description is present. */
+    remarks: string;
+    /** Summary text becomes the description when there are no explicit tags. */
+    summary: string;
+}
+export declare class PriceRange {
+    /** @minimum 100 @maximum 50 */
+    price: number;
+}
+export declare class MismatchedForm {
+    /** @minimum 0 */
+    label: string;
+}
+interface Address {
+    street: string;
+    city: string;
+}
+export declare class LocationForm {
+    /** @minLength :zipCode 5 */
+    address: Address;
+}
+interface Dimensions {
+    name: string;
+    width: number;
+}
+export declare class BoxForm {
+    /** @minimum :name 0 */
+    size: Dimensions;
+}
+/** @minimum 0 */
+type SafeTemperature = number;
+export declare class ThermostatForm {
+    /** @minimum -10 */
+    target: SafeTemperature;
+}
+/** @minimum 0 */
+export declare class InvalidPlacementForm {
+    value: number;
+}
+export {};
+//# sourceMappingURL=class-schema-regressions.d.ts.map

package/dist/__tests__/fixtures/class-schema-regressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-schema-regressions.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/class-schema-regressions.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAuB;IAClC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,WAAW;IACtB,oBAAoB;IACpB,YAAY,EAAG,MAAM,CAAC;IAEtB,mBAAmB;IACnB,SAAS,EAAG,MAAM,CAAC;IAEnB,kBAAkB;IAClB,OAAO,EAAG,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,wCAAwC;IACxC,KAAK,EAAG,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,0CAA0C;IAC1C,UAAU,EAAG,MAAM,CAAC;IAEpB,gCAAgC;IAChC,WAAW,EAAG,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,4CAA4C;IAC5C,IAAI,EAAG,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,UAAU;IACrB,qBAAqB;IACrB,SAAS,EAAG,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;;;OAIG;IACH,QAAQ,EAAG,MAAM,CAAC;IAElB,mFAAmF;IACnF,OAAO,EAAG,MAAM,CAAC;IAEjB,4EAA4E;IAC5E,OAAO,EAAG,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,+BAA+B;IAC/B,KAAK,EAAG,MAAM,CAAC;CAChB;AAED,qBAAa,cAAc;IACzB,iBAAiB;IACjB,KAAK,EAAG,MAAM,CAAC;CAChB;AAED,UAAU,OAAO;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB,4BAA4B;IAC5B,OAAO,EAAG,OAAO,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,OAAO;IAClB,uBAAuB;IACvB,IAAI,EAAG,UAAU,CAAC;CACnB;AAED,iBAAiB;AACjB,KAAK,eAAe,GAAG,MAAM,CAAC;AAE9B,qBAAa,cAAc;IACzB,mBAAmB;IACnB,MAAM,EAAG,eAAe,CAAC;CAC1B;AAED,iBAAiB;AACjB,qBAAa,oBAAoB;IAC/B,KAAK,EAAG,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,132 @@
+/**
+ * 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[][];
+}
+/**
+ * Self-referential dictionary type — used to verify the circular-reference
+ * guard in `tryResolveRecordType`.  An index signature that references its
+ * own interface is the TS-valid equivalent of `Record<string, X>` where X
+ * is self-referential; without the guard, resolving the value type would
+ * recurse infinitely.
+ */
+export interface SelfRefRecord {
+    [key: string]: SelfRefRecord;
+}
+export interface StringMap {
+    [key: string]: string;
+}
+/**
+ * Various object type patterns.
+ */
+export declare class CircularNode {
+    id: string;
+    next?: CircularNode;
+}
+/**
+ * Various object type patterns.
+ */
+export declare class ObjectEdgeCases {
+    emptyObject: {};
+    stringRecord: Record<string, string>;
+    namedStringMap: StringMap;
+    selfRefRecord: SelfRefRecord;
+    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":"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"}

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

@@ -0,0 +1,30 @@
+export declare class ExampleAForm {
+    /** @displayName Full Name
+     *  @description Your legal name
+     *  @minLength 2
+     *  @maxLength 100
+     */
+    name: string;
+    /** @displayName Age
+     *  @minimum 0
+     *  @maximum 150
+     */
+    age: number;
+    /** @displayName Score
+     *  @exclusiveMinimum 0
+     */
+    score: number;
+    /** @displayName Email
+     *  @pattern ^[^@]+@[^@]+$
+     */
+    email?: string;
+    /** @displayName Country
+     *  @enumOptions [{"id":"us","label":"United States"},{"id":"ca","label":"Canada"}]
+     */
+    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;IACvB;;;;OAIG;IACH,IAAI,EAAG,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,EAAG,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAG,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAG,IAAI,GAAG,IAAI,CAAC;IAEtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAU;CACjC"}

package/dist/__tests__/fixtures/example-date-extension.d.ts

@@ -0,0 +1,12 @@
+import { type ConstraintTagRegistration, type CustomConstraintRegistration, type CustomTypeRegistration } from "@formspec/core";
+export declare const DATE_EXTENSION_ID = "x-formspec/example-date";
+export declare const DATE_TIME_TYPE_ID = "x-formspec/example-date/DateTime";
+export declare function parseCanonicalDateTime(raw: string): string;
+export declare const dateTimeType: CustomTypeRegistration;
+export declare const afterConstraint: CustomConstraintRegistration;
+export declare const beforeConstraint: CustomConstraintRegistration;
+export declare const afterTag: ConstraintTagRegistration;
+export declare const beforeTag: ConstraintTagRegistration;
+export declare const dateExtension: import("@formspec/core").ExtensionDefinition;
+export declare function createDateExtensionRegistry(): import("../../extensions/registry.js").ExtensionRegistry;
+//# sourceMappingURL=example-date-extension.d.ts.map

package/dist/__tests__/fixtures/example-date-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-date-extension.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-date-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAG5B,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,iBAAiB,qCAAkC,CAAC;AAKjE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAc1D;AAoBD,eAAO,MAAM,YAAY,EAAE,sBASzB,CAAC;AAwBH,eAAO,MAAM,eAAe,8BAAiD,CAAC;AAC9E,eAAO,MAAM,gBAAgB,8BAAmD,CAAC;AAEjF,eAAO,MAAM,QAAQ,EAAE,yBAKrB,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,yBAKtB,CAAC;AAEH,eAAO,MAAM,aAAa,8CAKxB,CAAC;AAEH,wBAAgB,2BAA2B,6DAE1C"}

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 {
+    /**
+     * @displayName Full Name
+     * @description The user's legal name
+     * @minLength 1
+     * @maxLength 200
+     */
+    name: string;
+    /** @displayName Age @minimum 0 @maximum 150 */
+    age: number;
+    /** @displayName Email @pattern ^[^@]+@[^@]+$ */
+    email?: string;
+    /** @displayName Active */
+    active: boolean;
+}
+export interface WithEnumOptions {
+    /**
+     * @displayName Status
+     * @enumOptions ["draft","active","archived"]
+     */
+    status: "draft" | "active" | "archived";
+    /**
+     * @displayName Priority
+     * @enumOptions [{"id":"low","label":"Low Priority"},{"id":"high","label":"High Priority"}]
+     */
+    priority: "low" | "high";
+}
+export interface EmptyInterface {
+}
+export interface OnlyOptionalFields {
+    /** @displayName Notes */
+    notes?: string;
+    /** @displayName Tags */
+    tags?: string;
+}
+/** @deprecated Use NewConfig instead */
+export interface DeprecatedFieldInterface {
+    /** @deprecated Use fullName instead */
+    name?: string;
+    /** @displayName Full Name */
+    fullName: string;
+}
+export type SimpleTypeAlias = {
+    /** @displayName Label @minLength 1 */
+    label: string;
+    /** @displayName Count @minimum 0 */
+    count: number;
+    /** @displayName Description */
+    description?: string;
+};
+export type TypeAliasWithEnumOptions = {
+    /**
+     * @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;
+/** @displayName Discount Rate @description Percentage discount applied @minimum 0 @maximum 100 */
+export type AnnotatedPercent = number;
+export interface ConfigWithAliasedTypes {
+    /** @displayName Discount */
+    discount: Percent;
+    /** @displayName Contact Email */
+    contactEmail: Email;
+    /** @displayName Tax Rate */
+    taxRate: AnnotatedPercent;
+}
+export interface Address {
+    /** @displayName Street @minLength 1 @maxLength 200 */
+    street: string;
+    /** @displayName City @minLength 1 */
+    city: string;
+    /** @displayName Zip @pattern ^[0-9]{5}$ */
+    zip?: string;
+}
+export type ContactInfo = {
+    /** @displayName Email @pattern ^[^@]+@[^@]+$ */
+    email: string;
+    /** @displayName Phone @maxLength 20 */
+    phone?: string;
+};
+export interface NestedConfig {
+    /** @displayName Name */
+    name: string;
+    /** @displayName Address */
+    address: Address;
+    /** @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,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,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,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,MAAM,eAAe,GAAG;IAC5B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,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,kGAAkG;AAClG,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAElB,iCAAiC;IACjC,YAAY,EAAE,KAAK,CAAC;IAEpB,4BAA4B;IAC5B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAID,MAAM,WAAW,OAAO;IACtB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/__tests__/fixtures/example-numeric-extension.d.ts

@@ -0,0 +1,20 @@
+import { type ConstraintTagRegistration, type CustomTypeRegistration } from "@formspec/core";
+export declare const NUMERIC_EXTENSION_ID = "x-formspec/example-numeric";
+export declare const DECIMAL_TYPE_ID = "x-formspec/example-numeric/Decimal";
+export declare const BIGINT_TYPE_ID = "x-formspec/example-numeric/BigInt";
+export interface DecimalValue {
+    readonly coefficient: bigint;
+    readonly scale: number;
+}
+export declare function parseDecimal(raw: string): DecimalValue;
+export declare function formatDecimal(value: DecimalValue): string;
+export declare function compareDecimal(left: DecimalValue, right: DecimalValue): -1 | 0 | 1;
+export declare function addDecimal(left: DecimalValue, right: DecimalValue): DecimalValue;
+export declare function subtractDecimal(left: DecimalValue, right: DecimalValue): DecimalValue;
+export declare const decimalType: CustomTypeRegistration;
+export declare const bigIntType: CustomTypeRegistration;
+export declare const maxSigFigTag: ConstraintTagRegistration;
+export declare const maxDecimalPlacesTag: ConstraintTagRegistration;
+export declare const numericExtension: import("@formspec/core").ExtensionDefinition;
+export declare function createNumericExtensionRegistry(): import("../../extensions/registry.js").ExtensionRegistry;
+//# sourceMappingURL=example-numeric-extension.d.ts.map

package/dist/__tests__/fixtures/example-numeric-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-numeric-extension.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/example-numeric-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAE9B,KAAK,sBAAsB,EAG5B,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AACjE,eAAO,MAAM,eAAe,uCAAoC,CAAC;AACjE,eAAO,MAAM,cAAc,sCAAmC,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAetD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAazD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CASlF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAQhF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAQrF;AAgDD,eAAO,MAAM,WAAW,EAAE,sBAkCxB,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,sBAOvB,CAAC;AA6FH,eAAO,MAAM,YAAY,EAAE,yBAKzB,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,yBAKhC,CAAC;AAEH,eAAO,MAAM,gBAAgB,8CAa3B,CAAC;AAEH,wBAAgB,8BAA8B,6DAE7C"}

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

@@ -0,0 +1,7 @@
+type MoneyDecimal = string;
+export interface BillingForm {
+    /** @minimum USD */
+    amount: MoneyDecimal;
+}
+export {};
+//# sourceMappingURL=extension-forms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-forms.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/extension-forms.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,MAAM,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB"}