ng-form-foundry 0.5.3 → 0.5.5

package/index.d.ts

@@ -327,6 +327,24 @@ declare function addMapEntry(group: FormGroup, map: NodeMap, key?: string): stri
 declare function renameMapEntry(group: FormGroup, map: NodeMap, oldKey: string, newKey: string): boolean;
 /** Remove entry `key` unless the map is at `minEntries`. Returns whether it was removed. */
 declare function removeMapEntry(group: FormGroup, map: NodeMap, key: string): boolean;
+/**
+ * Materialize or de-materialize an optional (presence) child of `group`,
+ * mirroring the presence toggle the form UI offers — but callable by any host
+ * holding the {@link FormGroup}, for a key at any depth. `present: true` builds
+ * the child fresh from `schema` (seeded with `initial` if given; nested
+ * presence descendants start absent, as {@link buildControl}); `present: false`
+ * removes it, dropping the key from the form value.
+ *
+ * The materialize direction is why the coupling exists: a materialized
+ * non-nullable presence leaf carries `Validators.required`, because an
+ * enabled-but-empty key would serialize as `null` and fail a typed schema. A
+ * host that materializes fields for editing therefore drops the ones left
+ * empty on cancel by de-materializing them — this API is that primitive.
+ *
+ * `schema` must be the presence node for `key`; a non-presence `schema` is a
+ * no-op. Returns whether the form changed.
+ */
+declare function setNodePresence(group: FormGroup, schema: NodeType, key: string, present: boolean, initial?: unknown): boolean;
 /**
  * Build the `AbstractControl` for a single schema node.
  *
@@ -525,7 +543,8 @@ declare class DynamicRecursiveFormComponent implements OnInit {
      * Add or remove a presence node's control on this form — any presence kind:
      * group, leaf, map, or choice. Removing it drops the key from `form.value`;
      * adding it builds the control fresh from its schema (nested presence
-     * children start absent).
+     * children start absent). Delegates to {@link setNodePresence}, the
+     * host-callable primitive.
      */
     toggleNodePresence(key: string, schema: NodeType, present: boolean): void;
     /**
@@ -638,6 +657,7 @@ interface TreeNode {
     /** Present on a present optional child node: drives the row's remove control. */
     presenceRemovable?: {
         key: string;
+        schema: NodeType;
     };
     /** Field-layout appearance inherited from ancestor groups, for the node's detail-section form. */
     inherited?: Appearance | null;
@@ -698,6 +718,22 @@ declare class ConfigEditorComponent implements OnDestroy {
      * shows on the next rebind or structural rebuild, not immediately.
      */
     readonly rootTitle: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Whether selecting a tree row also expands the node's own children.
+     * Off by default: a click selects (the detail pane shows the subtree
+     * anyway) and the twisty alone controls expansion, so browsing a deep
+     * config does not keep unfolding the tree. Ancestors of the selection are
+     * always expanded — the selected row itself must stay visible.
+     */
+    readonly expandOnClick: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether the detail pane shows its top breadcrumb (the selected node's
+     * path, with the member remove control beside it). Hosts whose tree
+     * already tells the user where they are can turn it off — the section
+     * trail headings inside the detail stay, and member removal remains
+     * available on the tree rows and section headings.
+     */
+    readonly showBreadcrumb: _angular_core.InputSignal<boolean>;
     root: TreeNode;
     selected: TreeNode | null;
     /** The selected subtree as a flat, breadcrumb-separated section list. */
@@ -708,6 +744,7 @@ declare class ConfigEditorComponent implements OnDestroy {
     private shape;
     private changes?;
     private readonly host;
+    private readonly cdr;
     /** Stable per-instance ids for the shape signature, so replacing a control (setControl) reads as a structural change. */
     private readonly controlIds;
     private controlIdSeq;
@@ -715,6 +752,15 @@ declare class ConfigEditorComponent implements OnDestroy {
     ngOnDestroy(): void;
     /** 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.
+     */
+    refresh(): void;
     select(node: TreeNode, reveal?: boolean): void;
     /**
      * Root-to-`target` path for the detail-pane breadcrumb (inclusive of both ends),
@@ -889,7 +935,7 @@ declare class ConfigEditorComponent implements OnDestroy {
      */
     private escapeSeg;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfigEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfigEditorComponent, "nff-config-editor", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": true; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "rootTitle": { "alias": "rootTitle"; "required": false; "isSignal": true; }; }, { "editable": "editableChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfigEditorComponent, "nff-config-editor", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": true; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "rootTitle": { "alias": "rootTitle"; "required": false; "isSignal": true; }; "expandOnClick": { "alias": "expandOnClick"; "required": false; "isSignal": true; }; "showBreadcrumb": { "alias": "showBreadcrumb"; "required": false; "isSignal": true; }; }, { "editable": "editableChange"; }, never, never, true, never>;
 }
 
 declare class LeafRendererComponent implements AfterViewInit {
@@ -924,6 +970,7 @@ declare class LeafListRendererComponent implements OnInit {
     formArray: any;
     editable: boolean;
     minItems: number;
+    maxItems: number;
     /**
      * The parent group's grid layout (its `fieldsLayout` styles). A stacked list
      * spans the parent's full row, so its entries repeat the same tracks and
@@ -945,10 +992,14 @@ declare class LeafListRendererComponent implements OnInit {
     /** Applies {@link layout} to the host (the entries' container) while stacked. */
     get hostLayout(): LayoutStyles | null;
     ngOnInit(): void;
+    get effectiveMin(): number;
+    get effectiveMax(): number;
+    /** Whether another item may be appended (below the effective maximum). */
+    get canAdd(): boolean;
     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; }; "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"; }, never, never, true, never>;
 }
 
 declare class LeafEnumRendererComponent {
@@ -1040,9 +1091,13 @@ declare class NodeGroupListRendererComponent implements OnInit, AfterViewInit {
     items: QueryList<DynamicRecursiveFormComponent>;
     cdr: ChangeDetectorRef;
     ngOnInit(): void;
+    get effectiveMin(): number;
+    get effectiveMax(): number;
+    /** Whether another item may be appended (below the effective maximum). */
+    get canAdd(): boolean;
     ngAfterViewInit(): void;
     removeItem($index: number): void;
-    addItem: (index: number) => void;
+    addItem: (index?: number) => void;
     setLastEditable(): void;
     asFormGroup(group: any): FormGroup;
     getTitle($index: number): string;
@@ -1078,6 +1133,10 @@ declare class NodeMapRendererComponent implements OnChanges {
     get valueLeaf(): Leaf;
     /** The value schema as a group (used when `value.kind === 'nodeGroup'`). */
     get valueGroup(): NodeGroup;
+    /** Narrowing casts for the complex value kinds the template renders. */
+    protected asLeafList(v: unknown): LeafList;
+    protected asNodeGroupList(v: unknown): NodeGroupList;
+    protected asNodeMap(v: unknown): NodeMap;
     get atMax(): boolean;
     get atMin(): boolean;
     /** Append a new entry under a unique placeholder key. Delegates to {@link addMapEntry}. */
@@ -1092,9 +1151,10 @@ declare class NodeMapRendererComponent implements OnChanges {
     renameEntry(oldKey: string, rawKey: string): void;
     protected readonly asFormControl: typeof asFormControl;
     protected readonly asFormGroup: typeof asFormGroup;
+    protected readonly asFormArray: typeof asFormArray;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NodeMapRendererComponent, never>;
     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; }; "showAbsentOptionals": { "alias": "showAbsentOptionals"; "required": false; }; "inheritedAppearance": { "alias": "inheritedAppearance"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { CASE_KEY, ConfigEditorComponent, DynamicRecursiveFormComponent, LeafEnumRendererComponent, LeafListRendererComponent, LeafRendererComponent, NodeGroupListRendererComponent, NodeMapRendererComponent, RadixInputDirective, addMapEntry, buildControl, buildFormFromSchema, caseDisplayLabels, caseFields, defineSchema, formatRadix, removeMapEntry, renameMapEntry, resolveChoiceCase, serializeForm, switchChoiceCase, toWireValue };
+export { CASE_KEY, ConfigEditorComponent, DynamicRecursiveFormComponent, LeafEnumRendererComponent, LeafListRendererComponent, LeafRendererComponent, NodeGroupListRendererComponent, NodeMapRendererComponent, RadixInputDirective, addMapEntry, buildControl, buildFormFromSchema, caseDisplayLabels, caseFields, defineSchema, formatRadix, removeMapEntry, renameMapEntry, resolveChoiceCase, serializeForm, setNodePresence, switchChoiceCase, toWireValue };
 export type { AnonLeaf, Appearance, ChoiceCase, DFormControl, DFormGroup, FormGroupType, Leaf, LeafBase, LeafBoolean, LeafEnum, LeafList, LeafNumber, LeafRuntimeType, LeafString, NodeChoice, NodeGroup, NodeGroupList, NodeMap, NodeType, Radix };

package/package.json

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