ng-form-foundry 0.5.5 → 0.6.0

package/index.d.ts

@@ -152,6 +152,14 @@ type LeafList<TKind extends Leaf['type'] = Leaf['type']> = {
     maxItems?: number;
     /** Present every item in this base — see {@link LeafNumber.radix}. */
     radix?: 2 | 8 | 16;
+    /**
+     * Optional scalar list whose *presence itself* is data — an absent key,
+     * distinct from a present-but-empty list. Off means no control and no key in
+     * the value; on means the (possibly empty) list is materialized. Mirrors
+     * {@link NodeGroup.presence}; lets a round-trip distinguish `x = ( )` (present,
+     * empty) from an absent `x`.
+     */
+    presence?: boolean;
 };
 type NodeGroupList = {
     kind: 'nodeGroupList';
@@ -161,6 +169,8 @@ type NodeGroupList = {
     type: NodeGroup;
     minItems?: number;
     maxItems?: number;
+    /** Optional list whose presence is itself data — see {@link LeafList.presence}. */
+    presence?: boolean;
 };
 type NodeGroup = {
     kind: 'nodeGroup';
@@ -568,6 +578,14 @@ declare class DynamicRecursiveFormComponent implements OnInit {
      * rendered field when the toggle just created it.
      */
     toggleLeafPresence(key: string, schema: Leaf, present: boolean): void;
+    /**
+     * Materialize an absent presence (optional / `advisoryRequired`) list *with
+     * its first entry* — clicking "Add <list>" makes the first entry appear at
+     * once. An optional list has no present-empty state: removing the last entry
+     * de-materializes it (→ absent). A required list is always present instead and
+     * uses the renderer's own "Add item" affordance, so it never routes here.
+     */
+    addPresenceList(key: string, schema: NodeType): void;
     protected objectKeys(obj: Record<string, unknown>): string[];
     /** The active case name of a choice control, or null if none is selected. */
     protected activeCase(key: string): string | null;
@@ -753,12 +771,18 @@ declare class ConfigEditorComponent implements OnDestroy {
     /** Bind the editor to a schema/form pair: fresh tree, root selection, and shape-sync subscription. */
     private attach;
     /**
-     * Force the editor to re-read the bound form. Call this when the form was
-     * mutated in a way the editor's own `valueChanges` subscription could not
-     * observe — a structural change made with `{ emitEvent: false }`, or a
-     * mutation while a detached change detector left the view unchecked. It
-     * re-syncs the tree structure, rebuilds the current selection's sections
-     * from the live controls, and renders them.
+     * Force the editor to re-read the bound form. A leaf field normally reflects
+     * an external `setValue` on its own — the reactive value accessor writes the
+     * value synchronously, no change detection needed — so this is only for the
+     * corners that bypass that: a structural change made with
+     * `{ emitEvent: false }` (the tree wouldn't otherwise rebuild), a non-reactive
+     * display (the case selector, a map key) that needs re-reading, or a host
+     * whose change detector was detached during the mutation.
+     *
+     * It re-syncs the tree structure and **tears down and recreates** the detail
+     * sections, so every rendered control rebinds to the live form and re-pulls
+     * its current value — even a field whose bound input somehow missed the
+     * external write.
      */
     refresh(): void;
     select(node: TreeNode, reveal?: boolean): void;
@@ -979,6 +1003,12 @@ declare class LeafListRendererComponent implements OnInit {
      */
     layout: LayoutStyles | null;
     message: EventEmitter<any>;
+    /**
+     * Emitted from the empty-list remove button when the list is a presence list —
+     * the host removes the whole list (de-materializes it, → absent). Only wired
+     * for a `presence` `leafList`; the parent maps it to `setNodePresence`.
+     */
+    removeList: EventEmitter<void>;
     matDialog: MatDialog;
     /**
      * Take a full-width row of its own once the array holds more than one entry.
@@ -999,7 +1029,7 @@ declare class LeafListRendererComponent implements OnInit {
     removeItem($index: number): void;
     addItem(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LeafListRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LeafListRendererComponent, "nff-leaf-list-renderer", never, { "leaf_": { "alias": "leaf_"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "formArray": { "alias": "formArray"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; "minItems": { "alias": "minItems"; "required": false; }; "maxItems": { "alias": "maxItems"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; }, { "message": "message"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LeafListRendererComponent, "nff-leaf-list-renderer", never, { "leaf_": { "alias": "leaf_"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "formArray": { "alias": "formArray"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; "minItems": { "alias": "minItems"; "required": false; }; "maxItems": { "alias": "maxItems"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; }, { "message": "message"; "removeList": "removeList"; }, never, never, true, never>;
 }
 
 declare class LeafEnumRendererComponent {
@@ -1088,6 +1118,12 @@ declare class NodeGroupListRendererComponent implements OnInit, AfterViewInit {
     /** Field-layout appearance from the enclosing group, forwarded to every item form. */
     inheritedAppearance: Appearance | null;
     message: EventEmitter<any>;
+    /**
+     * Emitted when the last entry of a presence (optional / advisoryRequired) list
+     * is removed — the host de-materializes the whole list (→ absent). An optional
+     * list has no present-empty state; a required list never routes here.
+     */
+    removeList: EventEmitter<void>;
     items: QueryList<DynamicRecursiveFormComponent>;
     cdr: ChangeDetectorRef;
     ngOnInit(): void;
@@ -1102,7 +1138,7 @@ declare class NodeGroupListRendererComponent implements OnInit, AfterViewInit {
     asFormGroup(group: any): FormGroup;
     getTitle($index: number): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NodeGroupListRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NodeGroupListRendererComponent, "nff-node-group-list-renderer", never, { "nodeGroupList": { "alias": "nodeGroupList"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "formArray": { "alias": "formArray"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; "showAbsentOptionals": { "alias": "showAbsentOptionals"; "required": false; }; "minItems": { "alias": "minItems"; "required": false; }; "maxItems": { "alias": "maxItems"; "required": false; }; "inheritedAppearance": { "alias": "inheritedAppearance"; "required": false; }; }, { "message": "message"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NodeGroupListRendererComponent, "nff-node-group-list-renderer", never, { "nodeGroupList": { "alias": "nodeGroupList"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "formArray": { "alias": "formArray"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; "showAbsentOptionals": { "alias": "showAbsentOptionals"; "required": false; }; "minItems": { "alias": "minItems"; "required": false; }; "maxItems": { "alias": "maxItems"; "required": false; }; "inheritedAppearance": { "alias": "inheritedAppearance"; "required": false; }; }, { "message": "message"; "removeList": "removeList"; }, never, never, true, never>;
 }
 
 /**

package/package.json

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