@formspec/build 0.1.0-alpha.10 → 0.1.0-alpha.12

package/dist/canonicalize/chain-dsl-canonicalizer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonicalizer that translates chain DSL `FormSpec` objects into the
+ * canonical FormIR intermediate representation.
+ *
+ * This module maps the runtime objects produced by `@formspec/dsl` builder
+ * functions (`field.*`, `group`, `when`, `formspec`) into the IR that all
+ * downstream phases (validation, JSON Schema generation, UI Schema generation)
+ * consume.
+ */
+import type { FormElement, FormSpec, FormIR } from "@formspec/core";
+/**
+ * Translates a chain DSL `FormSpec` into the canonical `FormIR`.
+ *
+ * @param form - A form specification created via `formspec(...)` from `@formspec/dsl`
+ * @returns The canonical intermediate representation
+ */
+export declare function canonicalizeChainDSL(form: FormSpec<readonly FormElement[]>): FormIR;
+//# sourceMappingURL=chain-dsl-canonicalizer.d.ts.map

package/dist/canonicalize/chain-dsl-canonicalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-dsl-canonicalizer.d.ts","sourceRoot":"","sources":["../../src/canonicalize/chain-dsl-canonicalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EASV,WAAW,EACX,QAAQ,EAiBR,MAAM,EAWP,MAAM,gBAAgB,CAAC;AAqCxB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,WAAW,EAAE,CAAC,GAAG,MAAM,CAQnF"}

package/dist/canonicalize/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canonicalization layer — converts authoring surface output to canonical IR.
+ *
+ * @packageDocumentation
+ */
+export { canonicalizeChainDSL } from "./chain-dsl-canonicalizer.js";
+export { canonicalizeTSDoc, type TSDocSource } from "./tsdoc-canonicalizer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/canonicalize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canonicalize/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/canonicalize/tsdoc-canonicalizer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TSDoc canonicalizer — assembles an {@link IRClassAnalysis} into a canonical
+ * {@link FormIR}, applying layout metadata from `@Group` and `@ShowWhen`
+ * decorators.
+ *
+ * The analysis functions in `class-analyzer.ts` produce `FieldNode[]`,
+ * `fieldLayouts`, and `typeRegistry` directly. This canonicalizer uses
+ * the layout metadata to wrap fields in `GroupLayoutNode` and
+ * `ConditionalLayoutNode` elements.
+ */
+import type { FormIR } from "@formspec/core";
+import type { IRClassAnalysis } from "../analyzer/class-analyzer.js";
+/**
+ * Source-level metadata for provenance tracking.
+ */
+export interface TSDocSource {
+    /** Absolute path to the source file. */
+    readonly file: string;
+}
+/**
+ * Wraps an {@link IRClassAnalysis} (from `analyzeClassToIR`,
+ * `analyzeInterfaceToIR`, or `analyzeTypeAliasToIR`) into a canonical
+ * {@link FormIR}.
+ *
+ * Fields with `@Group` decorators are grouped into `GroupLayoutNode` elements.
+ * Fields with `@ShowWhen` decorators are wrapped in `ConditionalLayoutNode` elements.
+ * When both are present, the conditional wraps the field inside the group.
+ *
+ * @param analysis - IR analysis result (fields are already FieldNode[])
+ * @param source - Optional source file metadata for provenance
+ * @returns The canonical FormIR
+ */
+export declare function canonicalizeTSDoc(analysis: IRClassAnalysis, source?: TSDocSource): FormIR;
+//# sourceMappingURL=tsdoc-canonicalizer.d.ts.map

package/dist/canonicalize/tsdoc-canonicalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc-canonicalizer.d.ts","sourceRoot":"","sources":["../../src/canonicalize/tsdoc-canonicalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,+BAA+B,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAmBzF"}