@zeyos/zx 4.0.0 → 4.1.1

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

@@ -20,6 +20,10 @@ export type SelectOptions = {
      * Choices pinned above the list, kept through filtering and async loads.
      */
     fixedItems?: SelectItem[];
+    /**
+     * Optional heading above pinned choices.
+     */
+    fixedLabel?: string | null;
     /**
      * Item ID property or reader.
      */
@@ -121,6 +125,38 @@ export type SelectOptions = {
      */
     onaction?: (event: CustomEvent<SelectActionDetail>) => void;
 };
+export type EntitySelectOptions = {
+    /**
+     * Choices pinned above ordinary results.
+     */
+    recent?: SelectItem[];
+    /**
+     * Heading above recent choices.
+     */
+    recentLabel?: string;
+    /**
+     * Optional create command at the bottom.
+     */
+    create?: boolean | SelectAction;
+    /**
+     * Item icon reader.
+     */
+    iconKey?: string | ((item: SelectItem) => unknown);
+    /**
+     * Optional icon colour reader.
+     */
+    colorKey?: string | ((item: SelectItem) => unknown);
+    /**
+     * Secondary-text reader.
+     */
+    subtitleKey?: string | ((item: SelectItem) => unknown);
+    /**
+     * Entity icon renderer.
+     */
+    renderIcon?: ((item: SelectItem, context: {
+        selected: boolean;
+    }) => Node | string | null) | null;
+};
 export type SelectChangeDetail = {
     value: unknown;
     item: SelectItem | null;
@@ -173,8 +209,7 @@ export declare class Select extends Component<SelectOptions> {
     _position: import("../../core/position.js").PositionController;
     _createdRoot: boolean;
     _root: HTMLElement;
-    _originalChildren: any[] | ChildNode[];
-    _originalAttributes: Map<any, any>;
+    _snapshot: import("../../core/dom.js").TargetSnapshot;
     _handleTypeahead: (event: KeyboardEvent | string) => void;
     static cssName: string;
     /** @type {SelectOptions} */
@@ -243,6 +278,13 @@ export declare class Select extends Component<SelectOptions> {
     static status(target: Element | string | null, options?: SelectOptions & {
         items?: Array<Record<string, any>>;
     }): Select;
+    /**
+     * Creates a rich entity picker with optional Recent choices and a create command.
+     * @param {Element|string|null} target Component target.
+     * @param {SelectOptions & EntitySelectOptions} [options={}] Entity-preset options.
+     * @returns {Select}
+     */
+    static entity(target: Element | string | null, options?: SelectOptions & EntitySelectOptions): Select;
     /**
      * Creates the record-permission picker: the fixed Private and Public choices above the groups a
      * record can be shared with. The value is the tri-state ZeyOS stores — `false` for private,
@@ -310,12 +352,12 @@ export declare class Select extends Component<SelectOptions> {
      * @returns {SelectItem[]}
      */
     _matchFixed(query: string): SelectItem[];
+    /** De-duplicates choices by public value while preserving caller order. @param {SelectItem[]} items @param {SelectItem[]} [excluded=[]] @returns {SelectItem[]} */
+    _uniqueItems(items: SelectItem[], excluded?: SelectItem[]): SelectItem[];
     /** @returns {number} */
     _selectedEntryIndex(): number;
     /** @param {number} itemIndex @returns {number} */
     _itemEntryIndex(itemIndex: number): number;
-    /** @param {string} name @returns {void} */
-    _rememberAttribute(element: any, name: string): void;
     /** @param {string} key @param {string} fallback @returns {string} */
     _message(key: string, fallback: string): string;
 }

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

@@ -217,6 +217,22 @@ export type TableOptions = {
      * inert while this is `false`.
      */
     editMode?: TableEditMode;
+    /**
+     * Gesture that starts an editable cell.
+     */
+    editTrigger?: 'single' | 'double';
+    /**
+     * Whether rows expose pointer/keyboard reorder handles.
+     */
+    rowReorder?: boolean;
+    /**
+     * Whether a column visibility chooser is rendered.
+     */
+    columnVisibility?: boolean;
+    /**
+     * Initially hidden column IDs; at least one stays visible.
+     */
+    hiddenColumns?: string[];
     /**
      * Flat parent references projected as an
      * expandable treegrid. Row data and mutation APIs remain flat.
@@ -247,6 +263,11 @@ export type TableOptions = {
     oneditcancel?: (event: CustomEvent<TableEditCancelDetail>) => void;
     oneditinvalid?: (event: CustomEvent<TableEditInvalidDetail>) => void;
     onrowtoggle?: (event: CustomEvent<TableRowToggleDetail>) => void;
+    onrowmove?: (event: CustomEvent<TableRowMoveDetail>) => void;
+    oncolumnvisibilitychange?: (event: CustomEvent<{
+        visible: string[];
+        hidden: string[];
+    }>) => void;
 };
 export type TableRowClickDetail = {
     row: TableRow;
@@ -270,6 +291,13 @@ export type TableRowToggleDetail = {
     id: unknown;
     expanded: boolean;
 };
+export type TableRowMoveDetail = {
+    row: TableRow;
+    id: unknown;
+    target: TableRow;
+    targetId: unknown;
+    position: 'before' | 'after';
+};
 export type TableHierarchyEntry = {
     row: TableRow;
     id: unknown;
@@ -441,6 +469,8 @@ export type TableEditorEntry = {
  * @fires Table#rowtoggle
  * @fires Table#stackedchange
  * @fires Table#grow
+ * @fires Table#rowmove
+ * @fires Table#columnvisibilitychange
  * @extends {Component<TableOptions>}
  */
 export declare class Table extends Component<TableOptions> {
@@ -480,6 +510,7 @@ export declare class Table extends Component<TableOptions> {
     _rowElements: Map<any, any>;
     _restored: boolean;
     _editMode: TableEditMode;
+    _editTrigger: string;
     _edit: {
         id: unknown;
         columnId: string;
@@ -502,12 +533,18 @@ export declare class Table extends Component<TableOptions> {
     _hierarchy: TableHierarchyOptions & {
         column: string;
     };
+    _hiddenColumns: Set<string>;
+    _dragId: any;
+    _grabbedId: any;
     _expanded: Set<unknown>;
     _table: HTMLElement;
     _colgroup: HTMLElement;
     _thead: HTMLElement;
     _tbody: HTMLElement;
     _scroll: HTMLElement;
+    _rowMoveMessage: HTMLElement;
+    _columnControls: HTMLElement;
+    _columnList: HTMLElement;
     _selectAll: HTMLElement;
     _headers: Map<any, any>;
     _hierarchyMeta: Map<unknown, TableHierarchyEntry>;
@@ -575,6 +612,33 @@ export declare class Table extends Component<TableOptions> {
      * @returns {TableRow[]} Current table rows.
      */
     getData(): TableRow[];
+    /** Returns visible column IDs in caller order. @returns {string[]} */
+    getVisibleColumns(): string[];
+    /** Returns hidden column IDs in caller order. @returns {string[]} */
+    getHiddenColumns(): string[];
+    /**
+     * Shows or hides one column. The final visible column cannot be hidden.
+     * @param {string} id Column ID.
+     * @param {boolean} [visible=true] Desired visibility.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setColumnVisible(id: string, visible?: boolean, options?: {
+        silent?: boolean;
+    }): this;
+    /** Toggles one column. @param {string} id @param {{silent?:boolean}} [options={}] @returns {this} */
+    toggleColumn(id: string, options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Reorders one row relative to another and emits a cancelable `rowmove` before committing.
+     * Hierarchical rows may only move among siblings; an active local sort disables manual order.
+     * @param {unknown} id Moving row ID.
+     * @param {unknown} targetId Target row ID.
+     * @param {'before'|'after'} [position='before'] Target edge.
+     * @returns {this}
+     */
+    moveRow(id: unknown, targetId: unknown, position?: 'before' | 'after'): this;
     /**
      * Removes all rows.
      * @returns {this}
@@ -786,6 +850,32 @@ export declare class Table extends Component<TableOptions> {
     isStacked(): boolean;
     /** Restores an enhanced target and releases all component listeners. @returns {void} */
     destroy(): void;
+    /** @returns {TableColumn[]} */
+    _visibleColumns(): TableColumn[];
+    /** @returns {HTMLElement} */
+    _createColumnControls(): HTMLElement;
+    /** @param {string|null} [focusColumn=null] Column checkbox that keeps focus. @returns {void} */
+    _renderColumnControls(focusColumn?: string | null): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleRowDragStart(event: DragEvent): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleRowDragOver(event: DragEvent): void;
+    /** @param {DragEvent} event @returns {void} */
+    _handleRowDrop(event: DragEvent): void;
+    /** @param {KeyboardEvent} event @returns {void} */
+    _handleRowHandleKeydown(event: KeyboardEvent): void;
+    /** @param {unknown} id @returns {unknown[]} */
+    _siblingIds(id: unknown): unknown[];
+    /** @param {unknown} left @param {unknown} right @returns {boolean} */
+    _canMoveTogether(left: unknown, right: unknown): boolean;
+    /** @param {unknown} id @returns {HTMLElement|null} */
+    _rowHandle(id: unknown): HTMLElement | null;
+    /** @returns {void} */
+    _clearDropMarkers(): void;
+    /** @returns {void} */
+    _clearRowDrag(): void;
+    /** @returns {string|null} */
+    _hierarchyColumn(): string | null;
     /** @returns {void} */
     _renderColumns(): void;
     /** @returns {void} */
@@ -1015,6 +1105,19 @@ export declare function projectHierarchyRows(rows: TableRow[], rowId: string | (
  * @returns {TableRow[]} Sorted flat rows.
  */
 export declare function sortHierarchyRows(rows: TableRow[], rowId: string | ((row: TableRow) => unknown), parentId: string | ((row: TableRow) => unknown), getValue: (row: TableRow) => unknown, direction: TableSortDirection): TableRow[];
+/**
+ * Returns a reordered copy, or null when IDs are missing or hierarchical rows are not siblings.
+ * Moving a parent changes its sibling order; hierarchy projection keeps its descendant subtree
+ * attached as a unit because parent references are never rewritten.
+ * @param {TableRow[]} rows
+ * @param {string|((row:TableRow)=>unknown)} rowId
+ * @param {unknown} id
+ * @param {unknown} targetId
+ * @param {'before'|'after'} [position='before']
+ * @param {string|((row:TableRow)=>unknown)|null} [parentId=null]
+ * @returns {TableRow[]|null}
+ */
+export declare function reorderTableRows(rows: TableRow[], rowId: string | ((row: TableRow) => unknown), id: unknown, targetId: unknown, position?: 'before' | 'after', parentId?: string | ((row: TableRow) => unknown) | null): TableRow[] | null;
 /**
  * Resolves the editor type of a column for one row.
  *

package/dist/types/components/tag-picker/tag-picker.d.ts

@@ -19,6 +19,14 @@ export type TagPickerOptions = {
      * Item label property or reader.
      */
     labelKey?: TagLabelReader;
+    /**
+     * Optional item icon property or reader.
+     */
+    iconKey?: TagValueReader;
+    /**
+     * Optional item colour property or reader.
+     */
+    colorKey?: TagValueReader;
     /**
      * Fields searched by local filtering.
      */
@@ -133,6 +141,8 @@ export type TagPickerOptions = {
  * @property {unknown[]} [values=[]] Initially selected IDs.
  * @property {TagValueReader} [valueKey='ID'] Item ID property or reader.
  * @property {TagLabelReader} [labelKey='name'] Item label property or reader.
+ * @property {TagValueReader} [iconKey='icon'] Optional item icon property or reader.
+ * @property {TagValueReader} [colorKey='color'] Optional item colour property or reader.
  * @property {Array<TagValueReader>|null} [searchKeys=null] Fields searched by local filtering.
  * @property {'local'|((query: string) => Promise<TagItem[]>|TagItem[])} [filter='local'] Filtering mode.
  * @property {number} [minQuery=0] Minimum async query length.
@@ -359,6 +369,12 @@ export declare class TagPicker extends Component<TagPickerOptions> {
     _valueOf(item: unknown): unknown;
     /** @param {unknown} item @returns {string} */
     _labelOf(item: unknown): string;
+    /** @param {unknown} item @returns {Node|null} */
+    _iconOf(item: unknown): Node | null;
+    /** @param {unknown} item @returns {string|null} */
+    _colorOf(item: unknown): string | null;
+    /** @param {unknown} item @param {unknown} reader @returns {unknown} */
+    _readItem(item: unknown, reader: unknown): unknown;
     /** @returns {void} */
     _emitChange(): void;
     /** Grows the input to fit its text so the caret stays visible next to the tags. @returns {void} */

package/dist/types/core/dom.d.ts

@@ -62,7 +62,7 @@ export declare function parseCompactTag(compact: string): CompactTag;
  * @returns {HTMLElement}
  */
 export declare function compactElement(compact: string, properties?: DomBuilderProperties | null, content?: unknown): HTMLElement;
-/** Exact migration-facing alias retained for existing ZeyOS builder calls. */
+/** Public compact-builder alias for concise application DOM construction. */
 export declare const __: typeof compactElement;
 /**
  * Returns a trimmed native-link destination unless its parsed scheme can execute document code.

package/dist/types/core/util.d.ts

@@ -53,6 +53,15 @@ export declare function deepMerge<T, U>(a: T, b: U): T & U;
  * @returns {value is Element}
  */
 export declare function isElement(value: unknown): value is Element;
+/**
+ * Accepts concrete CSS colours while rejecting image/function values that could make a colour
+ * descriptor trigger a network request when it is later consumed through a custom property.
+ * `CSS.supports()` provides the authoritative browser check; the conservative fallback covers
+ * ordinary named, hexadecimal, and functional colours in non-browser test environments.
+ * @param {unknown} value Candidate colour.
+ * @returns {value is string}
+ */
+export declare function isCssColor(value: unknown): value is string;
 /**
  * Restricts a number to an inclusive range.
  * @param {number} n Value to restrict.

package/dist/types/index.d.ts

@@ -48,6 +48,7 @@ export { Stepper } from './components/stepper/stepper.js';
 export { Breadcrumb } from './components/breadcrumb/breadcrumb.js';
 export { Pagination, paginationRange } from './components/pagination/pagination.js';
 export { Search } from './components/search/search.js';
+export { AppIcon, appIcon } from './components/app-icon/app-icon.js';
 export { Launcher, rankLauncherItems } from './components/launcher/launcher.js';
 export { Avatar, avatarInitials } from './components/avatar/avatar.js';
 export { AccountMenu } from './components/account-menu/account-menu.js';
@@ -75,12 +76,14 @@ export { Datebox, DateTimeBox } from './components/datebox/datebox.js';
 export { DateRangePicker, clampRange, defaultDateRangePresets, normalizeRange, rangeNights, rangeStateOf } from './components/date-picker/date-range-picker.js';
 export { DateRangeBox, formatRangeText, parseRangeText } from './components/datebox/date-range-box.js';
 export { Timebox, splitTime, joinTime } from './components/timebox/timebox.js';
-export { Table } from './components/table/table.js';
+export { Table, reorderTableRows } from './components/table/table.js';
 export { Grid, billingColumns, isBillingLine } from './components/grid/grid.js';
 export { Chart, ChartJsAdapter, chartSummaryTable, cloneChartValue, isEmptyChartData } from './components/chart/chart.js';
 export { TreeView } from './components/tree/tree.js';
 export { Finder } from './components/finder/finder.js';
 export { DataFilter } from './components/data-filter/data-filter.js';
+export { Filter } from './components/filter/filter.js';
+export { filterOperators, emptyFilterAst, filterCondition, filterGroup, parseFilterAst, cloneFilterAst, stringifyFilterAst, validateFilterAst } from './components/filter/filter-model.js';
 export { Field } from './components/field/field.js';
 export { Fieldset } from './components/fieldset/fieldset.js';
 export { Form } from './components/form/form.js';

package/dist/types/zeyos/icons.d.ts

@@ -64,7 +64,7 @@ export type ModuleChipOptions = {
      */
     size?: number | string;
     /**
-     * Glyph size; `1em` is 60% of the chip edge.
+     * Glyph size relative to the tile edge.
      */
     iconSize?: number | string;
     /**
@@ -79,10 +79,18 @@ export type ModuleChipOptions = {
      * Use the stock Font Awesome fallback glyph.
      */
     standard?: boolean;
+    /**
+     * Explicit glyph override, useful for an offline fallback.
+     */
+    icon?: string | Node | (() => string | Node) | null;
     /**
      * Override the module colour for a server-defined fork or weblet.
      */
     color?: string;
+    /**
+     * AppIcon material treatment.
+     */
+    glass?: false | 'subtle' | 'strong';
     /**
      * Extra class names.
      */
@@ -91,19 +99,28 @@ export type ModuleChipOptions = {
 /**
  * @typedef {Object} ModuleChipOptions
  * @property {number|string} [size=24] Chip edge length.
- * @property {number|string} [iconSize='1em'] Glyph size; `1em` is 60% of the chip edge.
+ * @property {number|string} [iconSize='52%'] Glyph size relative to the tile edge.
  * @property {string|null} [label=null] Accessible label; null marks the chip decorative.
  * @property {boolean} [title=false] Adds the module's display name as a `title` tooltip.
  * @property {boolean} [standard=false] Use the stock Font Awesome fallback glyph.
+ * @property {string|Node|(()=>string|Node)|null} [icon] Explicit glyph override, useful for an offline fallback.
  * @property {string} [color] Override the module colour for a server-defined fork or weblet.
+ * @property {false|'subtle'|'strong'} [glass='subtle'] AppIcon material treatment.
  * @property {string|string[]} [class] Extra class names.
  */
 /**
  * Creates a module's icon chip: the glyph on the module's identity colour, the way ZeyOS draws
- * module icons in navigation and record headers. The glyph colour is whichever of ZeyOS's two
- * foregrounds contrasts better with the background.
+ * module icons in navigation and record headers. AppIcon identity glyphs stay white across every
+ * module colour; material shading and the glyph shadow preserve their silhouette on light colours.
  * @param {string} name Module, entity, or resource name.
  * @param {ModuleChipOptions} [options={}] Display and accessibility options.
  * @returns {HTMLElement} A `<span class="zx-module-icon">` wrapping the glyph.
  */
 export declare function moduleChip(name: string, options?: ModuleChipOptions): HTMLElement;
+/**
+ * Creates the public ZeyOS AppIcon preset for any module, entity, fork, or weblet identity.
+ * @param {string} name Module/entity identifier.
+ * @param {ModuleChipOptions} [options={}] AppIcon options.
+ * @returns {HTMLElement}
+ */
+export declare function zeyosAppIcon(name: string, options?: ModuleChipOptions): HTMLElement;

package/dist/types/zeyos/index.d.ts

@@ -6,7 +6,7 @@ export { fieldToZxField, fieldToZxColumn, resolveFields, registerFieldType } fro
 export { buildListQuery, tableSortToQuery, dataFilterStateToFilters, dateToUnixSeconds, unixSecondsToDate } from './query.js';
 export { connect } from './connect.js';
 export { zeyosModules, moduleAliases, moduleInfo, moduleColor, moduleIconName, moduleKeys, moduleGlyphColor, normalizeModuleName, registerModules } from './modules.js';
-export { ZEYOS_ICON_KIT, useZeyosIcons, moduleIcon, moduleChip } from './icons.js';
+export { ZEYOS_ICON_KIT, useZeyosIcons, moduleIcon, moduleChip, zeyosAppIcon } from './icons.js';
 export { ZEYOS_LAUNCHER_APPLICATIONS, buildZeyosLauncherConfig, zeyosLauncher, normalizeZeyosLauncherApplications, normalizeZeyosLauncherRecords, zeyosActiveIdentifier } from './launcher.js';
 export { zeyosSelect, buildZeyosSelectConfig, zeyosEntitySelect, buildZeyosEntitySelectConfig } from './select.js';
 export { zeyosForm } from './form.js';

package/dist/types/zeyos/select.d.ts

@@ -166,6 +166,7 @@ export declare function zeyosSelect(client: Record<string, any>, resource: strin
  *   subtitleKey?: string|((item: Record<string, unknown>) => unknown)|null,
  *   moduleKey?: string|((item: Record<string, unknown>) => unknown),
  *   none?: boolean|string,
+ *   recent?: Record<string, unknown>[],
  *   create?: boolean|{id?: string|number, label?: string, group?: string, icon?: string|Node, oninvoke?: Function},
  *   renderIcon?: ((item: Record<string, unknown>, context: Record<string, unknown>) => Node|null)|null
  * }} [opts={}] Entity presentation, query, and Select options.
@@ -175,6 +176,7 @@ export declare function buildZeyosEntitySelectConfig(client: Record<string, any>
     subtitleKey?: string | ((item: Record<string, unknown>) => unknown) | null;
     moduleKey?: string | ((item: Record<string, unknown>) => unknown);
     none?: boolean | string;
+    recent?: Record<string, unknown>[];
     create?: boolean | {
         id?: string | number;
         label?: string;