@zeyos/zx 4.4.0 → 5.2.0

package/dist/types/components/view/record-view.d.ts

@@ -274,8 +274,20 @@ export declare class RecordView extends Component<RecordViewOptions> {
     _viewSort: ViewSort;
     _viewSelected: any;
     _viewSelectionAnchor: unknown;
-    _viewFieldControls: HTMLElement;
+    _viewFieldControls: HTMLDetailsElement;
     _viewFieldList: HTMLElement;
+    _viewFieldStatus: HTMLElement;
+    _viewFieldHome: {
+        parent: ParentNode;
+        next: ChildNode;
+        mounted: string;
+    };
+    _viewNativeMounted: HTMLElement;
+    /** @type {{id: string, action: 'toggle'|'up'|'down'}|null} */
+    _viewFieldFocus: {
+        id: string;
+        action: 'toggle' | 'up' | 'down';
+    } | null;
     _viewFieldSettings: ViewFieldControlsSettings;
     _viewFieldControlsTarget: Element;
     _viewInitialized: boolean;
@@ -343,6 +355,26 @@ export declare class RecordView extends Component<RecordViewOptions> {
     getHiddenFields(): string[];
     /** Returns the complete field id order. @returns {string[]} */
     getFieldOrder(): string[];
+    /**
+     * Returns the element that lets a reader show, hide, and reorder this view's fields: the shared
+     * field chooser, or — for a `TableView` with `fieldControls: true` — the column chooser of its
+     * composed `Table`. Null when the view renders none (`fieldControls: false`).
+     *
+     * The element stays owned by the view: move it with {@link RecordView#mountFieldControls}
+     * rather than appending it elsewhere yourself, so `destroy()` can still find and remove it.
+     * @returns {HTMLElement|null}
+     */
+    getFieldControls(): HTMLElement | null;
+    /**
+     * Moves the view's field chooser into a host element — a list toolbar, a pane header — or, with
+     * `null`, back to where the view first rendered it. It keeps driving this view wherever it
+     * sits, and `destroy()` removes it from the host. `ListToolbar.bind()` calls this for every
+     * record view, which is how its field chooser ends up in the bar.
+     * @param {Element|string|null} target Host element or selector; null returns the chooser home.
+     * @returns {HTMLElement|null} The chooser, or null when the view renders none or the target
+     * does not resolve.
+     */
+    mountFieldControls(target: Element | string | null): HTMLElement | null;
     /**
      * Shows or hides one field. The final visible field cannot be hidden.
      * @param {string} id Field id.
@@ -457,6 +489,24 @@ export declare class RecordView extends Component<RecordViewOptions> {
      * @returns {void}
      */
     protected _removeViewFieldControls(): void;
+    /**
+     * A field chooser the concrete view renders natively instead of the shared one. The base class
+     * recognises a composed `Table` exposed through `getTable()` — `TableView` with
+     * `fieldControls: true` keeps Table's own column chooser — and any other subclass may override
+     * this to publish its own.
+     * @protected
+     * @returns {HTMLElement|null}
+     */
+    protected _nativeFieldControls(): HTMLElement | null;
+    /**
+     * Moves a field one place through the chooser's buttons, keeps focus on that field's control
+     * across the re-render, and announces where it landed.
+     * @private
+     * @param {string} id Field id.
+     * @param {-1|1} delta Direction.
+     * @returns {void}
+     */
+    private _moveViewFieldFromChooser;
     /**
      * Resolves the field-chooser trigger label: the configured one, else the translated message.
      * @protected
@@ -488,7 +538,14 @@ export declare class RecordView extends Component<RecordViewOptions> {
     private _emitViewSelection;
     /** @private @param {string} reason @returns {void} */
     private _emitViewState;
-    /** @private @param {string|null} [focusId=null] @returns {void} */
+    /**
+     * Re-renders the chooser list. A focus request names the field and the control that should
+     * hold focus afterwards — a bare id means its checkbox — and falls back to the field's other
+     * enabled control when the requested one became disabled (a move button at either end).
+     * @private
+     * @param {string|{id:string,action:'toggle'|'up'|'down'}|null} [focus=null] Control to focus.
+     * @returns {void}
+     */
     private _renderViewFieldControls;
 }
 /**