ng-form-foundry 0.3.1 → 0.3.3

package/index.d.ts

@@ -206,9 +206,10 @@ type DFormGroup<T extends NodeGroup> = FormGroup<FormGroupType<T>>;
 declare function caseFields(body: ChoiceCase): Record<string, NodeType>;
 /**
  * The active case of a choice: an explicit `__case` in the initial value, else
- * the case whose fields best match the initial data (inline wire data carries no
- * `__case`), else the schema `default`. This lets a choice seed from real
- * instance data whose branch is discriminated by which fields are present.
+ * the case {@link inferChoiceCase} ranks best against the initial data (inline
+ * wire data carries no `__case`), else the schema `default`. This lets a choice
+ * seed from real instance data whose branch is discriminated by which fields
+ * are present and required.
  */
 declare function resolveChoiceCase(choice: NodeChoice, initial?: Record<string, unknown> | null): string | undefined;
 /**
@@ -275,6 +276,27 @@ declare function buildControl<T extends NodeType>(node: T, initial?: unknown | n
  * names and value types.
  */
 declare function buildFormFromSchema<S extends NodeGroup>(schema: S, initial?: Record<string, unknown> | null): DFormGroup<S>;
+/**
+ * The wire value at `node`: `value` rebuilt with every choice discriminator
+ * removed.
+ *
+ * A choice's form value is `{ __case, ...fields }` ({@link CASE_KEY}); its wire
+ * encoding is the active case's fields inline, with no discriminator — the case
+ * is recovered from the field shape when the data is seeded back in
+ * ({@link resolveChoiceCase}). The walk is schema-driven: only positions the
+ * schema declares as choices are stripped, so a group child or map entry that
+ * happens to be named `__case` passes through untouched. Values at positions
+ * the schema does not describe pass through unchanged.
+ */
+declare function toWireValue(node: NodeType, value: unknown): unknown;
+/**
+ * Serialize a form built by {@link buildFormFromSchema} to its wire value:
+ * `form.getRawValue()` with every choice's {@link CASE_KEY} discriminator
+ * stripped (see {@link toWireValue}). The result is the inline encoding that
+ * `buildFormFromSchema` accepts back as `initial`, so serialize → rebuild
+ * round-trips the value.
+ */
+declare function serializeForm(schema: NodeGroup, form: FormGroup): Record<string, unknown>;
 /**
  * Capture a schema literal with its exact type while checking it against
  * `NodeGroup`.
@@ -715,5 +737,5 @@ declare class NodeMapRendererComponent implements OnChanges {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NodeMapRendererComponent, "nff-node-map-renderer", never, { "nodeMap": { "alias": "nodeMap"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { CASE_KEY, ConfigEditorComponent, DynamicRecursiveFormComponent, LeafEnumRendererComponent, LeafListRendererComponent, LeafRendererComponent, NodeGroupListRendererComponent, NodeMapRendererComponent, addMapEntry, buildControl, buildFormFromSchema, caseFields, defineSchema, removeMapEntry, renameMapEntry, resolveChoiceCase, switchChoiceCase };
+export { CASE_KEY, ConfigEditorComponent, DynamicRecursiveFormComponent, LeafEnumRendererComponent, LeafListRendererComponent, LeafRendererComponent, NodeGroupListRendererComponent, NodeMapRendererComponent, addMapEntry, buildControl, buildFormFromSchema, caseFields, defineSchema, removeMapEntry, renameMapEntry, resolveChoiceCase, serializeForm, switchChoiceCase, toWireValue };
 export type { AnonLeaf, Appearance, ChoiceCase, DFormControl, DFormGroup, FormGroupType, Leaf, LeafBase, LeafBoolean, LeafEnum, LeafList, LeafNumber, LeafRuntimeType, LeafString, NodeChoice, NodeGroup, NodeGroupList, NodeMap, NodeType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-form-foundry",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Build fully-typed Angular Reactive Forms and Angular Material UI from a declarative, recursive form-description schema.",
   "keywords": [
     "angular",