@formspec/cli 0.1.0-alpha.10

package/README.md

@@ -0,0 +1,480 @@
+# @formspec/cli
+
+CLI tool for generating JSON Schema and JSON Forms UI Schema from TypeScript source files.
+
+## Installation
+
+```bash
+npm install @formspec/cli
+# or
+pnpm add @formspec/cli
+```
+
+## Requirements
+
+**Package configuration** (package.json):
+
+```json
+{
+  "type": "module"
+}
+```
+
+**TypeScript configuration** (tsconfig.json):
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext"
+  }
+}
+```
+
+## Quick Start
+
+```bash
+# Generate schemas from a TypeScript class
+formspec generate ./src/forms.ts MyClass -o ./generated
+
+# Generate schemas from all FormSpec exports in a file (chain DSL)
+formspec generate ./src/forms.ts -o ./generated
+```
+
+## Commands
+
+### `generate` - Build-time Schema Generation
+
+Generate JSON Schema and UI Schema files from TypeScript source files.
+
+```bash
+formspec generate <file> [className] [options]
+```
+
+**Arguments:**
+
+- `<file>` - Path to TypeScript source file
+- `[className]` - Optional class name to analyze (required for decorated classes)
+
+**Options:**
+
+- `-o, --output <dir>` - Output directory (default: `./generated`)
+- `-c, --compiled <path>` - Path to compiled JS file (auto-detected if omitted)
+
+**Examples:**
+
+```bash
+# Generate from a decorated class
+formspec generate ./src/forms.ts UserForm -o ./generated
+
+# Generate from chain DSL exports (requires compiled JS)
+tsc && formspec generate ./src/forms.ts -o ./generated
+```
+
+### `codegen` - Runtime Type Metadata Generation
+
+Generate a TypeScript file that patches decorated classes with type metadata, enabling runtime schema generation.
+
+```bash
+formspec codegen <files...> [options]
+```
+
+**Arguments:**
+
+- `<files...>` - TypeScript source files to analyze
+
+**Options:**
+
+- `-o, --output <file>` - Output file (default: `./__formspec_types__.ts`)
+
+**Examples:**
+
+```bash
+# Generate type metadata for a single file
+formspec codegen ./src/forms.ts -o ./src/__formspec_types__.ts
+
+# Generate for multiple files
+formspec codegen ./src/**/*.ts -o ./src/__formspec_types__.ts
+```
+
+**Usage in code:**
+
+```typescript
+// Import once at application entry point (side-effect import)
+import "./__formspec_types__.js";
+
+// Then use runtime schema generation
+import { UserForm } from "./forms.js";
+import { buildFormSchemas } from "@formspec/decorators";
+
+const { jsonSchema, uiSchema } = buildFormSchemas(UserForm);
+```
+
+**When to use `codegen`:**
+
+- You want to generate schemas at runtime (not build time)
+- You're using the decorator DSL (not chain DSL)
+- You need type information that TypeScript erases at compile time
+
+> **Note:** The chain DSL (`@formspec/dsl`) doesn't require codegen because it preserves type information at runtime.
+
+## Output Formats
+
+FormSpec supports two output formats for UI schemas:
+
+### FormSpec Native Format (`ux_spec.json`)
+
+Generated by the CLI's `generate` command. Uses FormSpec's internal representation:
+
+```json
+{
+  "elements": [
+    {
+      "_field": "text",
+      "id": "name",
+      "label": "Full Name",
+      "required": true
+    },
+    {
+      "_field": "enum",
+      "id": "country",
+      "label": "Country",
+      "options": [
+        { "id": "us", "label": "United States" },
+        { "id": "ca", "label": "Canada" }
+      ]
+    }
+  ]
+}
+```
+
+### JSON Forms Format (`uiSchema`)
+
+Generated by `buildFormSchemas()` at runtime. Compatible with [JSON Forms](https://jsonforms.io/):
+
+```json
+{
+  "type": "VerticalLayout",
+  "elements": [
+    {
+      "type": "Control",
+      "scope": "#/properties/name",
+      "label": "Full Name"
+    },
+    {
+      "type": "Control",
+      "scope": "#/properties/country",
+      "label": "Country"
+    }
+  ]
+}
+```
+
+### Which Format to Use
+
+| Use Case               | Format          | Generated By             |
+| ---------------------- | --------------- | ------------------------ |
+| Custom form renderer   | FormSpec Native | `formspec generate` CLI  |
+| JSON Forms library     | JSON Forms      | `buildFormSchemas()`     |
+| Server-side generation | Either          | Depends on your renderer |
+
+Both formats are generated from the same FormSpec definition, ensuring consistency between build-time and runtime generation.
+
+## When to Use
+
+### Decorators + CLI vs Chain DSL
+
+FormSpec offers two approaches for defining forms:
+
+| Approach             | Best For                            | Schema Generation                                      |
+| -------------------- | ----------------------------------- | ------------------------------------------------------ |
+| **Decorators + CLI** | Class-based data models, DTOs       | Build-time (static analysis) or runtime (with codegen) |
+| **Chain DSL**        | Dynamic forms, runtime construction | Build-time or runtime (no code generation needed)      |
+
+**Use decorators + CLI when:**
+
+- Your forms map directly to TypeScript classes or DTOs
+- You prefer class-based modeling with validation constraints
+- You want type information inferred from TypeScript (no redundant type hints)
+- You need to generate schemas at build time for CI/CD pipelines
+
+**Use Chain DSL (`@formspec/dsl`) when:**
+
+- Forms are constructed dynamically at runtime
+- Form definitions come from a database or API
+- Forms don't correspond to specific TypeScript types
+- You want runtime schema generation without a build step
+
+Both approaches produce identical JSON Schema and UI Schema output.
+
+## Features
+
+### Static Type Analysis
+
+The CLI uses the TypeScript Compiler API to statically analyze your source files. It automatically infers:
+
+| TypeScript Type     | JSON Schema                                 | FormSpec Field                           |
+| ------------------- | ------------------------------------------- | ---------------------------------------- |
+| `string`            | `{ "type": "string" }`                      | `{ "_field": "text" }`                   |
+| `number`            | `{ "type": "number" }`                      | `{ "_field": "number" }`                 |
+| `boolean`           | `{ "type": "boolean" }`                     | `{ "_field": "boolean" }`                |
+| `"a" \| "b" \| "c"` | `{ "enum": ["a", "b", "c"] }`               | `{ "_field": "enum", "options": [...] }` |
+| `string[]`          | `{ "type": "array", "items": {...} }`       | `{ "_field": "array" }`                  |
+| `{ a: string }`     | `{ "type": "object", "properties": {...} }` | `{ "_field": "object" }`                 |
+| `field?: T`         | not in `required` array                     | `{ "required": false }`                  |
+
+### Decorator Recognition
+
+The CLI recognizes decorators by name through static analysis. You don't need a specific decorator library - any decorator with a recognized name will work.
+
+#### Supported Decorators
+
+| Decorator            | Purpose                   | Example                                              |
+| -------------------- | ------------------------- | ---------------------------------------------------- |
+| `@Label(text)`       | Set field label           | `@Label("Full Name")`                                |
+| `@Placeholder(text)` | Set placeholder text      | `@Placeholder("Enter name...")`                      |
+| `@Description(text)` | Set field description     | `@Description("Your legal name")`                    |
+| `@Min(n)`            | Set minimum value         | `@Min(0)`                                            |
+| `@Max(n)`            | Set maximum value         | `@Max(100)`                                          |
+| `@MinLength(n)`      | Set minimum string length | `@MinLength(1)`                                      |
+| `@MaxLength(n)`      | Set maximum string length | `@MaxLength(255)`                                    |
+| `@MinItems(n)`       | Set minimum array items   | `@MinItems(1)`                                       |
+| `@MaxItems(n)`       | Set maximum array items   | `@MaxItems(10)`                                      |
+| `@Pattern(regex)`    | Set validation pattern    | `@Pattern("^[a-z]+$")`                               |
+| `@EnumOptions(opts)` | Override enum options     | `@EnumOptions([{id: "us", label: "United States"}])` |
+| `@ShowWhen(cond)`    | Conditional visibility    | `@ShowWhen({ field: "type", value: "other" })`       |
+| `@Group(name)`       | Group fields together     | `@Group("Contact Info")`                             |
+
+#### Using Decorators
+
+Install the `@formspec/decorators` package:
+
+```bash
+npm install @formspec/decorators
+```
+
+Then use the decorators in your class:
+
+```typescript
+// user-registration.ts
+import { Label, Min, Max, EnumOptions } from "@formspec/decorators";
+
+class UserRegistration {
+  @Label("Full Name")
+  name!: string;
+
+  @Label("Email Address")
+  email!: string;
+
+  @Label("Age")
+  @Min(18)
+  @Max(120)
+  age?: number;
+
+  @Label("Country")
+  @EnumOptions([
+    { id: "us", label: "United States" },
+    { id: "ca", label: "Canada" },
+    { id: "uk", label: "United Kingdom" },
+  ])
+  country!: "us" | "ca" | "uk";
+}
+```
+
+Run the CLI:
+
+```bash
+formspec generate ./src/user-registration.ts UserRegistration -o ./generated
+```
+
+> **Note**: The decorators are no-ops at runtime with zero overhead. The CLI reads them through static analysis of your TypeScript source code.
+
+### FormSpec Chain DSL Support
+
+The CLI also supports the FormSpec chain DSL. Export your FormSpec definitions and the CLI will generate schemas for them:
+
+```typescript
+// forms.ts
+import { formspec, field } from "@formspec/dsl";
+
+export const ContactForm = formspec(
+  field.text("name", { label: "Name", required: true }),
+  field.text("email", { label: "Email", required: true }),
+  field.text("message", { label: "Message" })
+);
+```
+
+```bash
+formspec generate ./src/forms.ts -o ./generated
+```
+
+### Method Parameter Analysis
+
+The CLI can detect `InferSchema<typeof X>` or `InferFormSchema<typeof X>` patterns in method parameters and use the referenced FormSpec to generate parameter schemas:
+
+```typescript
+import { formspec, field, type InferFormSchema } from "@formspec/dsl";
+
+export const ActivateParams = formspec(
+  field.number("amount", { label: "Amount", min: 100 }),
+  field.number("installments", { min: 2, max: 12 })
+);
+
+class PaymentPlan {
+  status!: "active" | "paused" | "canceled";
+
+  activate(params: InferFormSchema<typeof ActivateParams>): boolean {
+    // ...
+  }
+}
+```
+
+The CLI will generate schemas for both the class fields and the method parameters.
+
+## Output Structure
+
+```
+generated/
+├── ClassName/
+│   ├── schema.json           # JSON Schema for class fields
+│   ├── ux_spec.json          # JSON Forms UI Schema for form rendering
+│   ├── instance_methods/
+│   │   └── methodName/
+│   │       ├── params.schema.json
+│   │       ├── params.ux_spec.json  # (if FormSpec-based params)
+│   │       └── return_type.schema.json
+│   └── static_methods/
+│       └── methodName/
+│           └── ...
+└── formspecs/
+    └── ExportName/
+        ├── schema.json
+        └── ux_spec.json
+```
+
+## Example Output
+
+Given this TypeScript class:
+
+```typescript
+import { Label, Min, Max, EnumOptions } from "@formspec/decorators";
+
+class ContactForm {
+  @Label("Full Name")
+  name!: string;
+
+  @Label("Email Address")
+  email!: string;
+
+  @Label("Age")
+  @Min(18)
+  @Max(120)
+  age?: number;
+
+  @Label("Country")
+  @EnumOptions([
+    { id: "us", label: "United States" },
+    { id: "ca", label: "Canada" },
+  ])
+  country!: "us" | "ca";
+}
+```
+
+Running `formspec generate ./contact-form.ts ContactForm` produces:
+
+**schema.json:**
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "name": { "type": "string", "title": "Full Name" },
+    "email": { "type": "string", "title": "Email Address" },
+    "age": { "type": "number", "title": "Age", "minimum": 18, "maximum": 120 },
+    "country": { "enum": ["us", "ca"], "title": "Country" }
+  },
+  "required": ["name", "email", "country"]
+}
+```
+
+**ux_spec.json:**
+
+```json
+{
+  "elements": [
+    { "_field": "text", "id": "name", "label": "Full Name", "required": true },
+    { "_field": "text", "id": "email", "label": "Email Address", "required": true },
+    { "_field": "number", "id": "age", "label": "Age", "min": 18, "max": 120 },
+    {
+      "_field": "enum",
+      "id": "country",
+      "label": "Country",
+      "required": true,
+      "options": [
+        { "id": "us", "label": "United States" },
+        { "id": "ca", "label": "Canada" }
+      ]
+    }
+  ]
+}
+```
+
+## CLI Reference
+
+```
+formspec generate <file> [className] [options]
+
+Arguments:
+  <file>        Path to TypeScript source file
+  [className]   Optional class name (if omitted, generates from FormSpec exports only)
+
+Options:
+  -o, --output <dir>    Output directory (default: ./generated)
+  -c, --compiled <path> Path to compiled JS file (auto-detected if omitted)
+  -h, --help            Show help message
+
+Aliases:
+  formspec analyze      Same as 'generate' (backwards compatibility)
+```
+
+## TypeScript Configuration
+
+For decorator support, ensure your `tsconfig.json` includes:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true
+  }
+}
+```
+
+> **Note**: The `emitDecoratorMetadata` flag is not required. The CLI performs static analysis and reads decorators directly from the AST without using reflection.
+
+## Troubleshooting
+
+### "Could not load compiled module" Warning
+
+This warning appears when the CLI cannot find a compiled JavaScript version of your TypeScript file. This is expected if you haven't compiled your TypeScript yet.
+
+**The CLI will still work** - it uses static TypeScript analysis which doesn't require compiled output. The warning only affects method parameters that use `InferSchema<typeof X>`, which require the FormSpec to be loaded at runtime.
+
+To suppress this warning, compile your TypeScript first:
+
+```bash
+tsc
+formspec generate ./src/forms.ts MyClass -o ./generated
+```
+
+### Decorators Not Being Recognized
+
+Ensure:
+
+1. Decorator names match exactly (case-sensitive): `@Label`, not `@label`
+2. Decorators are function calls: `@Label("text")`, not `@Label`
+3. The decorator is imported (even if it's a stub)
+
+## License
+
+UNLICENSED

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

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for the analyzer module (imported from @formspec/build).
+ *
+ * These tests verify that the CLI can use the analysis API from @formspec/build.
+ * Comprehensive analyzer tests are in @formspec/build.
+ */
+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;;;;;GAKG"}

package/dist/__tests__/analyzer.test.js

@@ -0,0 +1,70 @@
+/**
+ * Unit tests for the analyzer module (imported from @formspec/build).
+ *
+ * These tests verify that the CLI can use the analysis API from @formspec/build.
+ * Comprehensive analyzer tests are in @formspec/build.
+ */
+import { describe, it, expect } from "vitest";
+import * as path from "node:path";
+import { createProgramContext, findClassByName, analyzeClass } from "@formspec/build/internals";
+const fixturesDir = path.join(__dirname, "fixtures");
+const sampleFormsPath = path.join(fixturesDir, "sample-forms.ts");
+describe("program", () => {
+    it("creates program context from TypeScript file", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        expect(ctx.program).toBeDefined();
+        expect(ctx.checker).toBeDefined();
+        expect(ctx.sourceFile).toBeDefined();
+        expect(ctx.sourceFile.fileName).toContain("sample-forms.ts");
+    });
+    it("throws for non-existent file", () => {
+        expect(() => createProgramContext("/non/existent/file.ts")).toThrow();
+    });
+});
+describe("findClassByName", () => {
+    it("finds InstallmentPlan class", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        const classDecl = findClassByName(ctx.sourceFile, "InstallmentPlan");
+        expect(classDecl).not.toBeNull();
+        expect(classDecl?.name?.text).toBe("InstallmentPlan");
+    });
+    it("finds SimpleProduct class", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        const classDecl = findClassByName(ctx.sourceFile, "SimpleProduct");
+        expect(classDecl).not.toBeNull();
+        expect(classDecl?.name?.text).toBe("SimpleProduct");
+    });
+    it("returns null for non-existent class", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        const classDecl = findClassByName(ctx.sourceFile, "NonExistentClass");
+        expect(classDecl).toBeNull();
+    });
+});
+describe("analyzeClass", () => {
+    it("analyzes InstallmentPlan fields", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        const classDecl = findClassByName(ctx.sourceFile, "InstallmentPlan");
+        if (!classDecl)
+            throw new Error("InstallmentPlan class not found");
+        const analysis = analyzeClass(classDecl, ctx.checker);
+        expect(analysis.name).toBe("InstallmentPlan");
+        expect(analysis.fields).toHaveLength(4);
+        const fieldNames = analysis.fields.map((f) => f.name);
+        expect(fieldNames).toContain("status");
+        expect(fieldNames).toContain("amount");
+        expect(fieldNames).toContain("customerEmail");
+        expect(fieldNames).toContain("installments");
+    });
+    it("detects optional fields", () => {
+        const ctx = createProgramContext(sampleFormsPath);
+        const classDecl = findClassByName(ctx.sourceFile, "InstallmentPlan");
+        if (!classDecl)
+            throw new Error("InstallmentPlan class not found");
+        const analysis = analyzeClass(classDecl, ctx.checker);
+        const emailField = analysis.fields.find((f) => f.name === "customerEmail");
+        const amountField = analysis.fields.find((f) => f.name === "amount");
+        expect(emailField?.optional).toBe(true);
+        expect(amountField?.optional).toBe(false);
+    });
+});
+//# sourceMappingURL=analyzer.test.js.map

package/dist/__tests__/analyzer.test.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Tests for the codegen type generation functions (imported from @formspec/build).
+ *
+ * Comprehensive codegen tests are in @formspec/build.
+ * This file verifies the CLI can access the codegen API.
+ */
+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;;;;;GAKG"}

package/dist/__tests__/codegen.test.js

@@ -0,0 +1,51 @@
+/**
+ * Tests for the codegen type generation functions (imported from @formspec/build).
+ *
+ * Comprehensive codegen tests are in @formspec/build.
+ * This file verifies the CLI can access the codegen API.
+ */
+import { describe, it, expect } from "vitest";
+import { generateCodegenOutput } from "@formspec/build";
+function createTypeMetadata(overrides = {}) {
+    return {
+        type: "string",
+        ...overrides,
+    };
+}
+function createDecoratedClassInfo(overrides = {}) {
+    return {
+        name: "TestForm",
+        sourcePath: "./test-form",
+        typeMetadata: {},
+        isExported: true,
+        ...overrides,
+    };
+}
+describe("generateCodegenOutput (from @formspec/build)", () => {
+    it("generates correct schema type for primitive fields", () => {
+        const cls = createDecoratedClassInfo({
+            name: "UserForm",
+            typeMetadata: {
+                name: createTypeMetadata({ type: "string" }),
+                age: createTypeMetadata({ type: "number" }),
+                active: createTypeMetadata({ type: "boolean" }),
+            },
+        });
+        const output = generateCodegenOutput([cls], "/tmp/out.ts", "/tmp");
+        expect(output).toContain("export type UserFormSchema = {");
+        expect(output).toContain("name: string;");
+        expect(output).toContain("age: number;");
+        expect(output).toContain("active: boolean;");
+    });
+    it("generates typed accessor function", () => {
+        const cls = createDecoratedClassInfo({
+            name: "UserForm",
+            typeMetadata: {
+                name: createTypeMetadata({ type: "string" }),
+            },
+        });
+        const output = generateCodegenOutput([cls], "/tmp/out.ts", "/tmp");
+        expect(output).toContain("export function getUserFormFormSpec(): UserFormFormSpec {");
+    });
+});
+//# sourceMappingURL=codegen.test.js.map

package/dist/__tests__/codegen.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.test.js","sourceRoot":"","sources":["../../src/__tests__/codegen.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAA8C,MAAM,iBAAiB,CAAC;AAEpG,SAAS,kBAAkB,CAAC,YAAmC,EAAE;IAC/D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,YAAyC,EAAE;IAC3E,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,aAAa;QACzB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,IAAI;QAChB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAG,wBAAwB,CAAC;YACnC,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE;gBACZ,IAAI,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC5C,GAAG,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,MAAM,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aAChD;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,qBAAqB,CAAC,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,wBAAwB,CAAC;YACnC,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE;gBACZ,IAAI,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aAC7C;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,qBAAqB,CAAC,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2DAA2D,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Edge case and negative tests for CLI-specific components.
+ *
+ * Tests cover:
+ * - isFormSpec detection edge cases
+ * - File I/O error handling (output writer)
+ * - FormSpec loading failures
+ *
+ * Note: Analysis and generation edge cases are tested in @formspec/build.
+ */
+export {};
+//# sourceMappingURL=edge-cases.test.d.ts.map

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

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