@formspec/build 0.1.0-alpha.5 → 0.1.0-alpha.50

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

@@ -0,0 +1,22 @@
+/**
+ * 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, MetadataPolicyInput } from "@formspec/core";
+import type { FormIR } from "@formspec/core/internals";
+/**
+ * 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 interface CanonicalizeChainDSLOptions {
+    readonly metadata?: MetadataPolicyInput;
+}
+export declare function canonicalizeChainDSL(form: FormSpec<readonly FormElement[]>, options?: CanonicalizeChainDSLOptions): 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,EAMR,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAYV,MAAM,EAaP,MAAM,0BAA0B,CAAC;AA4ClC;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,CAAC,SAAS,WAAW,EAAE,CAAC,EACtC,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAoBR"}

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,38 @@
+/**
+ * TSDoc canonicalizer — assembles an {@link IRClassAnalysis} into a canonical
+ * {@link FormIR}, applying layout metadata from `@Group` and `@ShowWhen`
+ * TSDoc tags.
+ *
+ * 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/internals";
+import type { IRClassAnalysis } from "../analyzer/class-analyzer.js";
+import type { MetadataPolicyInput } from "@formspec/core";
+/**
+ * Source-level metadata for provenance tracking.
+ */
+export interface TSDocSource {
+    /** Absolute path to the source file. */
+    readonly file: string;
+}
+export interface CanonicalizeTSDocOptions {
+    readonly metadata?: MetadataPolicyInput;
+}
+/**
+ * Wraps an {@link IRClassAnalysis} (from `analyzeClassToIR`,
+ * `analyzeInterfaceToIR`, or `analyzeTypeAliasToIR`) into a canonical
+ * {@link FormIR}.
+ *
+ * Fields with `@Group` TSDoc tags are grouped into `GroupLayoutNode` elements.
+ * Fields with `@ShowWhen` TSDoc tags 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, options?: CanonicalizeTSDocOptions): 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,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,+BAA+B,CAAC;AAE1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CA8BR"}