@zeyos/zx 2.2.1 → 3.0.0

package/dist/types/components/grid/grid.d.ts

@@ -0,0 +1,172 @@
+import { Table } from '../table/table.js';
+export type BillingRow = Record<string, any>;
+export type GridOptions = Object;
+export type BillingFields = {
+    /**
+     * Row identifier field.
+     */
+    id?: string;
+    /**
+     * Parent identifier field.
+     */
+    parent?: string;
+    /**
+     * Line description field.
+     */
+    item?: string;
+    /**
+     * Line-kind field (`group`/`subtotal` rows are read-only).
+     */
+    kind?: string;
+    /**
+     * Quantity field.
+     */
+    quantity?: string;
+    /**
+     * Unit field.
+     */
+    unit?: string;
+    /**
+     * Unit-price field.
+     */
+    unitPrice?: string;
+    /**
+     * Currency-code field.
+     */
+    currency?: string;
+    /**
+     * Line-total field.
+     */
+    total?: string;
+};
+export type BillingItemsOptions = {
+    /**
+     * Billing rows.
+     */
+    data?: BillingRow[];
+    /**
+     * Schema field overrides.
+     */
+    fields?: Partial<BillingFields>;
+    /**
+     * Unit choices.
+     */
+    units?: Array<{
+        value: unknown;
+        label: string;
+    }> | Record<string, string>;
+    /**
+     * Currency choices.
+     */
+    currencies?: Array<{
+        value: unknown;
+        label: string;
+    }> | Record<string, string>;
+    /**
+     * Fallback currency.
+     */
+    currency?: string;
+    /**
+     * Number/currency locale.
+     */
+    locale?: string;
+    /**
+     * Currency fraction digits.
+     */
+    decimals?: number;
+    /**
+     * Per-canonical-column overrides.
+     */
+    columnOverrides?: Record<string, object>;
+    /**
+     * Optional total calculation; defaults to quantity × unit price.
+     */
+    lineTotal?: (row: BillingRow, changes: Record<string, unknown>) => number | null | undefined;
+    /**
+     * Complete column replacement.
+     */
+    columns?: import('../table/table.js').TableColumn[];
+    /**
+     * Caller edit listener, invoked after total calculation.
+     */
+    oneditcommit?: (event: CustomEvent<import('../table/table.js').TableEditCommitDetail>) => void;
+};
+/** @typedef {Record<string, any>} BillingRow */
+/**
+ * @typedef {Object} GridOptions
+ * Grid inherits its constructor options and runtime API from `Table`; this record owns the Grid
+ * name in generated documentation, where the Table API is shown alongside it.
+ */
+/**
+ * @typedef {Object} BillingFields
+ * @property {string} [id='id'] Row identifier field.
+ * @property {string} [parent='parent'] Parent identifier field.
+ * @property {string} [item='item'] Line description field.
+ * @property {string} [kind='kind'] Line-kind field (`group`/`subtotal` rows are read-only).
+ * @property {string} [quantity='quantity'] Quantity field.
+ * @property {string} [unit='unit'] Unit field.
+ * @property {string} [unitPrice='unitPrice'] Unit-price field.
+ * @property {string} [currency='currency'] Currency-code field.
+ * @property {string} [total='total'] Line-total field.
+ */
+/**
+ * @typedef {Object} BillingItemsOptions
+ * @property {BillingRow[]} [data=[]] Billing rows.
+ * @property {Partial<BillingFields>} [fields={}] Schema field overrides.
+ * @property {Array<{value: unknown, label: string}>|Record<string, string>} [units=[]] Unit choices.
+ * @property {Array<{value: unknown, label: string}>|Record<string, string>} [currencies=[]] Currency choices.
+ * @property {string} [currency='EUR'] Fallback currency.
+ * @property {string} [locale] Number/currency locale.
+ * @property {number} [decimals=2] Currency fraction digits.
+ * @property {Record<string, object>} [columnOverrides={}] Per-canonical-column overrides.
+ * @property {(row: BillingRow, changes: Record<string, unknown>) => number|null|undefined} [lineTotal] Optional total calculation; defaults to quantity × unit price.
+ * @property {import('../table/table.js').TableColumn[]} [columns] Complete column replacement.
+ * @property {(event: CustomEvent<import('../table/table.js').TableEditCommitDetail>) => void} [oneditcommit] Caller edit listener, invoked after total calculation.
+ */
+/**
+ * Public data grid. It deliberately inherits Table's DOM/CSS/API instead of forking the data layer.
+ * @extends {Table}
+ */
+export declare class Grid extends Table {
+    static cssName: string;
+    /**
+     * Creates a generic data grid with the complete inherited Table contract.
+     * @param {Element|string|null} target Grid target.
+     * @param {GridOptions & import('../table/table.js').TableOptions} [options={}] Grid/Table options.
+     */
+    constructor(target?: Element | string | null, options?: GridOptions & import('../table/table.js').TableOptions);
+    /**
+     * Creates an editable hierarchical billing-line grid.
+     * @param {Element|string|null} target Grid target.
+     * @param {BillingItemsOptions & import('../table/table.js').TableOptions} [options={}] Preset and Table overrides.
+     * @returns {Grid}
+     */
+    static BillingItems(target: Element | string | null, options?: BillingItemsOptions & import('../table/table.js').TableOptions): Grid;
+}
+/**
+ * Builds the Table-compatible options behind `Grid.BillingItems()` without touching the DOM.
+ * @param {BillingItemsOptions & import('../table/table.js').TableOptions} [options={}] Preset and Table overrides.
+ * @returns {import('../table/table.js').TableOptions}
+ */
+export declare function billingItemsConfig(options?: BillingItemsOptions & import('../table/table.js').TableOptions): import('../table/table.js').TableOptions;
+/**
+ * Returns whether a billing row is an editable line rather than a group/subtotal.
+ * @param {BillingRow} row Row.
+ * @param {BillingFields} [fields=DEFAULT_FIELDS] Field map.
+ * @returns {boolean}
+ */
+export declare function isBillingLine(row: BillingRow, fields?: BillingFields): boolean;
+/**
+ * Produces the preset columns without mutating overrides.
+ * @param {BillingFields} fields Field map.
+ * @param {{units: unknown, currencies: unknown, currency: string, locale?: string, decimals: number, columnOverrides: Record<string, object>}} options Formatting/editor options.
+ * @returns {import('../table/table.js').TableColumn[]}
+ */
+export declare function billingColumns(fields: BillingFields, { units, currencies, currency, locale, decimals, columnOverrides }: {
+    units: unknown;
+    currencies: unknown;
+    currency: string;
+    locale?: string;
+    decimals: number;
+    columnOverrides: Record<string, object>;
+}): import('../table/table.js').TableColumn[];

package/dist/types/components/launcher/launcher.d.ts

@@ -0,0 +1,300 @@
+import { Component } from '../../core/component.js';
+export type LauncherItem = {
+    /**
+     * Stable item identifier.
+     */
+    id: string | number;
+    /**
+     * Visible label.
+     */
+    label: string;
+    /**
+     * Secondary text.
+     */
+    description?: string;
+    /**
+     * Additional search text.
+     */
+    keywords?: string | string[];
+    /**
+     * Result group.
+     */
+    group?: string;
+    /**
+     * Kernel icon name.
+     */
+    icon?: string;
+    /**
+     * Compact metadata.
+     */
+    badge?: string | number;
+    /**
+     * Emitted value; defaults to `id`.
+     */
+    value?: unknown;
+    /**
+     * Native link target.
+     */
+    href?: string;
+    /**
+     * Native link browsing context.
+     */
+    target?: string;
+    /**
+     * Application-owned callback for non-link actions.
+     */
+    invoke?: () => void;
+    /**
+     * Pinned state or explicit pinned order.
+     */
+    pinned?: boolean | number;
+    /**
+     * Whether activation is unavailable.
+     */
+    disabled?: boolean;
+};
+export type LauncherSource = {
+    /**
+     * Source identifier.
+     */
+    id: string;
+    /**
+     * Default group label.
+     */
+    label?: string;
+    /**
+     * Per-source minimum query length.
+     */
+    minQuery?: number;
+    /**
+     * Loader.
+     */
+    load: (query: string, context: {
+        signal: AbortSignal;
+    }) => Promise<LauncherItem[]> | LauncherItem[];
+};
+export type LauncherOptions = {
+    /**
+     * Local application/action catalogue.
+     */
+    items?: LauncherItem[];
+    /**
+     * Abortable asynchronous result sources.
+     */
+    sources?: LauncherSource[];
+    /**
+     * Initial query.
+     */
+    query?: string;
+    /**
+     * Source-query delay in milliseconds.
+     */
+    debounce?: number;
+    /**
+     * Global source minimum query length.
+     */
+    minQuery?: number;
+    /**
+     * Maximum combined results.
+     */
+    maxResults?: number;
+    /**
+     * Search-field placeholder.
+     */
+    placeholder?: string;
+    /**
+     * Dialog and field label.
+     */
+    label?: string;
+    /**
+     * Empty-state text.
+     */
+    emptyText?: string;
+    /**
+     * Loading-state text.
+     */
+    loadingText?: string;
+    /**
+     * Optional global keyboard shortcut.
+     */
+    shortcut?: 'mod+k' | false;
+    /**
+     * Preventable selection listener.
+     */
+    onselect?: (event: CustomEvent<LauncherSelectDetail>) => void;
+    /**
+     * Query-change listener.
+     */
+    onquery?: (event: CustomEvent<{
+        query: string;
+    }>) => void;
+    /**
+     * Open listener.
+     */
+    onopen?: (event: CustomEvent<Record<string, never>>) => void;
+    /**
+     * Close listener.
+     */
+    onclose?: (event: CustomEvent<Record<string, never>>) => void;
+    /**
+     * Source error listener.
+     */
+    onerror?: (event: CustomEvent<{
+        source: LauncherSource;
+        error: unknown;
+    }>) => void;
+};
+export type LauncherSelectDetail = {
+    item: LauncherItem;
+    value: unknown;
+    source: string | null;
+    query: string;
+};
+export type RankedLauncherItem = LauncherItem & {
+    _source?: string | null;
+    _score?: number;
+};
+/**
+ * @typedef {Object} LauncherItem
+ * @property {string|number} id Stable item identifier.
+ * @property {string} label Visible label.
+ * @property {string} [description] Secondary text.
+ * @property {string|string[]} [keywords] Additional search text.
+ * @property {string} [group] Result group.
+ * @property {string} [icon] Kernel icon name.
+ * @property {string|number} [badge] Compact metadata.
+ * @property {unknown} [value] Emitted value; defaults to `id`.
+ * @property {string} [href] Native link target.
+ * @property {string} [target] Native link browsing context.
+ * @property {() => void} [invoke] Application-owned callback for non-link actions.
+ * @property {boolean|number} [pinned] Pinned state or explicit pinned order.
+ * @property {boolean} [disabled] Whether activation is unavailable.
+ */
+/**
+ * @typedef {Object} LauncherSource
+ * @property {string} id Source identifier.
+ * @property {string} [label] Default group label.
+ * @property {number} [minQuery] Per-source minimum query length.
+ * @property {(query: string, context: {signal: AbortSignal}) => Promise<LauncherItem[]>|LauncherItem[]} load Loader.
+ */
+/**
+ * @typedef {Object} LauncherOptions
+ * @property {LauncherItem[]} [items=[]] Local application/action catalogue.
+ * @property {LauncherSource[]} [sources=[]] Abortable asynchronous result sources.
+ * @property {string} [query=''] Initial query.
+ * @property {number} [debounce=250] Source-query delay in milliseconds.
+ * @property {number} [minQuery=0] Global source minimum query length.
+ * @property {number} [maxResults=100] Maximum combined results.
+ * @property {string} [placeholder='Search applications and records'] Search-field placeholder.
+ * @property {string} [label='Launcher'] Dialog and field label.
+ * @property {string} [emptyText='No results'] Empty-state text.
+ * @property {string} [loadingText='Searching…'] Loading-state text.
+ * @property {'mod+k'|false} [shortcut='mod+k'] Optional global keyboard shortcut.
+ * @property {(event: CustomEvent<LauncherSelectDetail>) => void} [onselect] Preventable selection listener.
+ * @property {(event: CustomEvent<{query: string}>) => void} [onquery] Query-change listener.
+ * @property {(event: CustomEvent<Record<string, never>>) => void} [onopen] Open listener.
+ * @property {(event: CustomEvent<Record<string, never>>) => void} [onclose] Close listener.
+ * @property {(event: CustomEvent<{source: LauncherSource, error: unknown}>) => void} [onerror] Source error listener.
+ */
+/** @typedef {{item: LauncherItem, value: unknown, source: string|null, query: string}} LauncherSelectDetail */
+/** @typedef {LauncherItem & {_source?: string|null, _score?: number}} RankedLauncherItem */
+/**
+ * Abortable command/search dialog that emits application-owned actions without routing itself.
+ * @fires Launcher#select
+ * @fires Launcher#query
+ * @fires Launcher#open
+ * @fires Launcher#close
+ * @fires Launcher#error
+ * @extends {Component<LauncherOptions>}
+ */
+export declare class Launcher extends Component<LauncherOptions> {
+    _createdRoot: boolean;
+    _original: {
+        attributes: string[][];
+        children: ChildNode[];
+    };
+    _items: LauncherItem[];
+    _sources: LauncherSource[];
+    _sourceItems: Map<any, any>;
+    _query: string;
+    _results: any[];
+    _active: number;
+    _request: AbortController;
+    _requestSequence: number;
+    _queryTimer: number;
+    _busy: boolean;
+    _destroyed: boolean;
+    static cssName: string;
+    /** @type {Readonly<LauncherOptions>} */
+    static defaults: Readonly<LauncherOptions>;
+    /**
+     * Creates an owned launcher dialog or enhances an existing `<dialog>` target.
+     * @param {HTMLDialogElement|string|null} [target=null] Dialog target, selector, or null.
+     * @param {LauncherOptions} [options={}] Launcher options.
+     */
+    constructor(target?: HTMLDialogElement | string | null, options?: LauncherOptions);
+    /** @returns {HTMLDialogElement} */
+    render(): HTMLDialogElement;
+    /** Opens the launcher and focuses/selects its query. @returns {this} @fires Launcher#open */
+    open(): this;
+    /** Closes the launcher. @returns {this} */
+    close(): this;
+    /** Toggles the launcher. @returns {this} */
+    toggle(): this;
+    /** Reports whether the launcher is open. @returns {boolean} */
+    isOpen(): boolean;
+    /** Focuses and selects the query field. @returns {this} */
+    focus(): this;
+    /** Replaces the query and refreshes local and remote results. @param {string} query @returns {this} */
+    setQuery(query: string): this;
+    /** Returns the untrimmed query. @returns {string} */
+    getQuery(): string;
+    /** Replaces local catalogue items. @param {LauncherItem[]} items @returns {this} */
+    setItems(items: LauncherItem[]): this;
+    /** Replaces asynchronous sources and aborts work from the old set. @param {LauncherSource[]} sources @returns {this} */
+    setSources(sources: LauncherSource[]): this;
+    /** Aborts sources and removes the owned dialog. @returns {void} */
+    destroy(): void;
+    /** @returns {void} */
+    _refresh(): void;
+    /** @returns {Promise<void>} */
+    _loadSources(): Promise<void>;
+    /** @param {boolean} busy @returns {void} */
+    _setBusy(busy: boolean): void;
+    /** @returns {void} */
+    _abortRequest(): void;
+    /** @returns {void} */
+    _renderResults(): void;
+    /** @param {RankedLauncherItem} item @param {number} index @returns {HTMLElement} */
+    _option(item: RankedLauncherItem, index: number): HTMLElement;
+    /** @returns {void} */
+    _renderStatus(): void;
+    /** @returns {void} */
+    _syncActive(): void;
+    /** @param {KeyboardEvent} event @returns {void} */
+    _onKeydown(event: KeyboardEvent): void;
+    /** @param {number} index @param {Event} event @returns {void} */
+    _activate(index: number, event: Event): void;
+    /** @param {KeyboardEvent} event @returns {void} */
+    _onDocumentKeydown(event: KeyboardEvent): void;
+}
+/**
+ * Ranks launcher items using the current ZeyOS application tiers.
+ * @param {RankedLauncherItem[]} items Items to rank.
+ * @param {string} query Query.
+ * @param {number} [limit=100] Maximum returned items.
+ * @returns {RankedLauncherItem[]}
+ */
+export declare function rankLauncherItems(items: RankedLauncherItem[], query: string, limit?: number): RankedLauncherItem[];
+/**
+ * Flattens loaded source results in configured source order rather than response-completion order.
+ * @param {LauncherSource[]} sources Configured sources.
+ * @param {Map<string, RankedLauncherItem[]>} sourceItems Loaded result map.
+ * @returns {RankedLauncherItem[]}
+ */
+export declare function orderedLauncherSourceItems(sources: LauncherSource[], sourceItems: Map<string, RankedLauncherItem[]>): RankedLauncherItem[];
+/** Fired when a result is activated. @event Launcher#select @type {CustomEvent<LauncherSelectDetail>} */
+/** Fired when the query changes. @event Launcher#query @type {CustomEvent<{query: string}>} */
+/** Fired after the dialog opens. @event Launcher#open @type {CustomEvent<Record<string, never>>} */
+/** Fired after the dialog closes. @event Launcher#close @type {CustomEvent<Record<string, never>>} */
+/** Fired when one asynchronous source fails. @event Launcher#error @type {CustomEvent<{source: LauncherSource, error: unknown}>} */

package/dist/types/components/layout/layout.d.ts

@@ -29,7 +29,7 @@ export type StackOptions = {
      */
     class?: string;
 };
-export type GridOptions = {
+export type LayoutGridOptions = {
     /**
      * Column count at full width. Null fills the row with as
      * many tracks of `min` width as fit.
@@ -80,7 +80,7 @@ export type DomChild = import('../../core/dom.js').DomChild;
  * @property {string} [class=''] Extra class names.
  */
 /**
- * @typedef {Object} GridOptions
+ * @typedef {Object} LayoutGridOptions
  * @property {number|null} [columns=null] Column count at full width. Null fills the row with as
  *   many tracks of `min` width as fit.
  * @property {number|string} [min='16rem'] Narrowest a track may get before the grid drops a
@@ -117,11 +117,11 @@ export declare function stack(options?: StackOptions, ...children: DomChild[]):
  * in a full-width page, a split pane, and a modal. Nothing here consults the viewport, which is
  * the usual reason a "responsive" grid still breaks inside a narrow panel.
  *
- * @param {GridOptions} [options={}] Grid options.
+ * @param {LayoutGridOptions} [options={}] Grid options.
  * @param {...DomChild} children Cells.
  * @returns {HTMLDivElement}
  */
-export declare function grid(options?: GridOptions, ...children: DomChild[]): HTMLDivElement;
+export declare function grid(options?: LayoutGridOptions, ...children: DomChild[]): HTMLDivElement;
 /**
  * Creates a box that holds a fixed aspect ratio whatever its width, so an image, a map, or a
  * chart placeholder reserves its space before it loads.

package/dist/types/components/menu-button/menu-button.d.ts

@@ -46,7 +46,7 @@ export type MenuButtonOptions = {
     /**
      * Menu placement.
      */
-    placement?: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top';
+    placement?: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top' | 'right-start' | 'right-end' | 'left-start' | 'left-end' | 'right' | 'left';
     /**
      * Select event listener.
      */
@@ -79,7 +79,7 @@ export type MenuButtonOptions = {
  * @property {string|null} [icon=null] Trigger icon name.
  * @property {'default'|'primary'|'danger'|'ghost'} [kind='default'] Trigger button kind.
  * @property {MenuButtonItem[]} [items=[]] Menu items and separators.
- * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'} [placement='bottom-start'] Menu placement.
+ * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'} [placement='bottom-start'] Menu placement.
  * @property {(event: CustomEvent<{value: unknown, item: MenuItem}>) => void} [onselect] Select event listener.
  * @property {(event: CustomEvent<Record<string, never>>) => void} [onopen] Open event listener.
  * @property {(event: CustomEvent<Record<string, never>>) => void} [onclose] Close event listener.
@@ -128,6 +128,14 @@ export declare class MenuButton extends Component<MenuButtonOptions> {
      * @returns {boolean}
      */
     isOpen(): boolean;
+    /** Returns the trigger button. @returns {HTMLElement} */
+    getTrigger(): HTMLElement;
+    /** Returns the owned menu panel. @returns {HTMLElement} */
+    getPanel(): HTMLElement;
+    /** Opens the menu and focuses its first enabled item. @returns {this} */
+    focusFirst(): this;
+    /** Opens the menu and focuses its last enabled item. @returns {this} */
+    focusLast(): this;
     /**
      * Sets the visible trigger label.
      * @param {string} label Trigger label.

package/dist/types/components/modal/modal.d.ts

@@ -67,6 +67,31 @@ export declare class Modal extends Component<ModalOptions> {
      * @param {ModalOptions} [options={}] Modal options.
      */
     constructor(_target?: Element | string | null, options?: ModalOptions);
+    /**
+     * Element the owned dialog is appended to. Overridden by subclasses that live inside a host
+     * rather than at the document level.
+     *
+     * Called from `render()`, which the base constructor runs before any subclass field
+     * initializers, so an override may read `this.options` but must not touch instance state.
+     * @returns {Element}
+     */
+    mountTarget(): Element;
+    /**
+     * Puts the dialog on screen. Overridden by subclasses that open non-modally.
+     * @returns {void}
+     */
+    _show(): void;
+    /**
+     * Whether an incoming `close` event is a real dismissal.
+     *
+     * A dialog cannot move between the top layer and the page flow while it is open, so a subclass
+     * that re-hosts itself has to close and immediately reopen. `close` is dispatched in a queued
+     * task, not synchronously, so that stale event arrives once the dialog is already open again —
+     * late enough to clobber `data-state`, fire a `close` nobody asked for, and trip
+     * `destroyOnClose`. Returning false from an override drops it at the source instead.
+     * @returns {boolean}
+     */
+    _isRealClose(): boolean;
     /**
      * Creates the owned native dialog.
      * @returns {HTMLDialogElement}

package/dist/types/components/multi-value-editor/multi-value-editor.d.ts

@@ -12,21 +12,34 @@ export type MultiValueEditorOptions = {
      * Add-row button text.
      */
     addLabel?: string;
+    /**
+     * Reordering affordances each row gets:
+     * a drag handle, the up/down buttons, both, or neither.
+     */
+    reorder?: 'both' | 'buttons' | 'drag' | 'none';
+    /**
+     * Values change listener.
+     */
+    onchange?: (event: CustomEvent<{
+        values: string[];
+    }>) => void;
 };
-/**
- * @typedef {Object} MultiValueEditorOptions
- * @property {unknown[]} [values=[]] Initial ordered values.
- * @property {unknown[]|Record<string, string>|null} [options=null] Allowed values; null uses text inputs.
- * @property {string} [addLabel='Add value'] Add-row button text.
- */
 /**
  * Ordered value editor with explicit editable rows and controls.
+ *
+ * Rows reorder by dragging their handle or by pressing the up/down buttons — `reorder` picks which
+ * of the two a row offers. The handle is also a keyboard control (arrows, Home, End), so drag-only
+ * mode still reorders without a pointer.
  * @fires MultiValueEditor#change
  * @extends {Component<MultiValueEditorOptions>}
  */
 export declare class MultiValueEditor extends Component<MultiValueEditorOptions> {
     _values: string[];
     _ownedNodes: any[];
+    _initialState: string;
+    _dragIndex: number;
+    /** @type {HTMLElement|null} Row made draggable by a pointer press on its handle. */
+    _armed: HTMLElement | null;
     _rows: HTMLElement;
     _add: HTMLElement;
     static cssName: string;
@@ -48,12 +61,64 @@ export declare class MultiValueEditor extends Component<MultiValueEditorOptions>
     setValues(values: unknown[], { silent }?: {
         silent?: boolean;
     }): this;
-    /** @param {number} [focusIndex=-1] @returns {void} */
-    _renderRows(focusIndex?: number): void;
+    /** @returns {{drag: boolean, buttons: boolean}} */
+    _reorder(): {
+        drag: boolean;
+        buttons: boolean;
+    };
+    /**
+     * @param {number} [focusIndex=-1] Row to focus after the render, or -1 for none.
+     * @param {keyof PARTS} [focusPart='value'] Which control of that row takes focus.
+     * @returns {void}
+     */
+    _renderRows(focusIndex?: number, focusPart?: keyof PARTS): void;
     /** @param {MouseEvent} event @returns {void} */
     _handleClick(event: MouseEvent): void;
     /** @param {Event} event @returns {void} */
     _handleChange(event: Event): void;
+    /**
+     * The handle is the keyboard equivalent of dragging it, so `reorder: 'drag'` is still operable
+     * without a pointer.
+     * @param {KeyboardEvent} event
+     * @returns {void}
+     */
+    _handleKeydown(event: KeyboardEvent): void;
+    /**
+     * Arms the row for dragging. Only the handle does this, so text selection inside a row's input
+     * keeps working and a stray drag cannot reorder anything.
+     * @param {PointerEvent} event
+     * @returns {void}
+     */
+    _handlePointerDown(event: PointerEvent): void;
+    /** @returns {void} */
+    _disarm(): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleDragStart(event: DragEvent): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleDragOver(event: DragEvent): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleDragLeave(event: DragEvent): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleDrop(event: DragEvent): void;
+    /** @returns {void} */
+    _finishDrag(): void;
+    /**
+     * Insertion slot (0…length) for a pointer at `clientY`.
+     * @param {number} clientY Pointer position.
+     * @returns {number}
+     */
+    _dropTarget(clientY: number): number;
+    /** @param {number} slot Insertion slot to mark. @returns {void} */
+    _showDrop(slot: number): void;
+    /** @returns {void} */
+    _clearDrop(): void;
+    /**
+     * @param {number} from Index to move.
+     * @param {number} to Destination index.
+     * @param {keyof PARTS} part Control of the moved row that takes focus.
+     * @returns {boolean} Whether anything moved.
+     */
+    _move(from: number, to: number, part: keyof PARTS): boolean;
     /** @returns {void} */
     _emitChange(): void;
     /** @returns {void} */
@@ -62,5 +127,5 @@ export declare class MultiValueEditor extends Component<MultiValueEditorOptions>
 /**
  * Ordered values changed event.
  * @event MultiValueEditor#change
- * @type {CustomEvent<{values: string[]}>
+ * @type {CustomEvent<{values: string[]}>}
  */