@zeyos/zx 3.0.0 → 4.1.0

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,10 +469,13 @@ 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> {
-    _originalChildren: ChildNode[];
+    _createdRoot: boolean;
+    _original: import("../../core/dom.js").TargetSnapshot;
     _columns: {
         id: string;
         label: string;
@@ -479,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;
@@ -501,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>;
@@ -523,8 +561,8 @@ export declare class Table extends Component<TableOptions> {
     render(): HTMLElement;
     /**
      * Toggles a loading state. While loading, the body is dimmed, an indeterminate progress bar is
-     * shown, and `aria-busy` is set — a lightweight take on the busy/skeleton pattern used by
-     * enterprise tables (SAP UI5, Salesforce SLDS). Call `setLoading(false)` (or `setData`) when done.
+     * shown, and `aria-busy` is set — a lightweight enterprise-table busy and skeleton pattern.
+     * Call `setLoading(false)` (or `setData`) when done.
      * @param {boolean} [loading=true] Whether the table is loading.
      * @returns {this}
      */
@@ -574,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}
@@ -785,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} */
@@ -1014,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,8 +62,16 @@ 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.
+ * Relative URLs, fragments, and ordinary application protocols remain valid; malformed and
+ * control-obfuscated script/data schemes are rejected.
+ * @param {unknown} value Candidate href.
+ * @returns {string|null}
+ */
+export declare function safeHref(value: unknown): string | null;
 /**
  * Applies the established ZeyOS property rules to an existing element:
  * `Dname` → `data-name`, `SfontSize` → `style.fontSize`, `on*` → a legacy-compatible listener,

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

@@ -37,6 +37,7 @@ export { CopyInput } from './components/copy/copy-input.js';
 export { Toolbar } from './components/toolbar/toolbar.js';
 export { Toggle } from './components/toggle/toggle.js';
 export { Groupbox } from './components/groupbox/groupbox.js';
+export { Card } from './components/card/card.js';
 export { Panel } from './components/panel/panel.js';
 export { MasterPanel } from './components/master-panel/master-panel.js';
 export { SplitView, clampSize, resolveSize, snapSize } from './components/split-view/split-view.js';
@@ -47,10 +48,11 @@ 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';
-export { AppRail, normalizeAppItems } from './components/app-rail/app-rail.js';
+export { normalizeAppItems } from './internal/app-rail.js';
 export { AppSidebar } from './components/app-sidebar/app-sidebar.js';
 export { Message } from './components/message/message.js';
 export { Modal } from './components/modal/modal.js';
@@ -74,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/{components/app-rail → internal}/app-rail.d.ts

@@ -1,5 +1,5 @@
-import { Component } from '../../core/component.js';
-import { Dropdown } from '../dropdown/dropdown.js';
+import { Component } from '../core/component.js';
+import { Dropdown } from '../components/dropdown/dropdown.js';
 export type AppNavItem = {
     /**
      * Stable item identifier.
@@ -10,9 +10,11 @@ export type AppNavItem = {
      */
     label: string;
     /**
-     * Kernel icon name.
+     * Icon name, node, component, or factory.
      */
-    icon?: string;
+    icon?: string | Node | {
+        toElement: () => Node | null;
+    } | ((context: Record<string, any>, item: AppNavItem) => Node | null);
     /**
      * Count or status badge.
      */
@@ -22,7 +24,7 @@ export type AppNavItem = {
      */
     value?: unknown;
     /**
-     * Native navigation target.
+     * Native navigation target; executable/data schemes are disabled.
      */
     href?: string;
     /**
@@ -42,7 +44,7 @@ export type AppNavItem = {
      */
     children?: AppNavItem[];
 };
-export type AppRailOptions = {
+export type AppRailPresenterOptions = {
     /**
      * Application navigation tree.
      */
@@ -83,6 +85,10 @@ export type AppRailOptions = {
      * Pointer/focus crossing grace in milliseconds.
      */
     closeDelay?: number;
+    /**
+     * Optional host icon renderer.
+     */
+    renderIcon?: (item: AppNavItem, context: Record<string, any>) => Node | null;
     /**
      * Preventable action listener.
      */
@@ -115,17 +121,17 @@ export type RailFlyout = {
  * @typedef {Object} AppNavItem
  * @property {string|number} id Stable item identifier.
  * @property {string} label Visible/accessibility label.
- * @property {string} [icon] Kernel icon name.
+ * @property {string|Node|{toElement: () => Node|null}|((context: Record<string, any>, item: AppNavItem) => Node|null)} [icon] Icon name, node, component, or factory.
  * @property {string|number} [badge] Count or status badge.
  * @property {unknown} [value] Emitted value; defaults to `id`.
- * @property {string} [href] Native navigation target.
+ * @property {string} [href] Native navigation target; executable/data schemes are disabled.
  * @property {string} [target] Native link browsing context.
  * @property {() => void} [invoke] Application-owned non-link action.
  * @property {boolean} [disabled] Whether activation is unavailable.
  * @property {AppNavItem[]} [children] Child destinations/actions.
  */
 /**
- * @typedef {Object} AppRailOptions
+ * @typedef {Object} AppRailPresenterOptions
  * @property {AppNavItem[]} [items=[]] Application navigation tree.
  * @property {string|number|null} [active=null] Active item id.
  * @property {'vertical'|'horizontal'} [orientation='vertical'] Rail flow.
@@ -135,6 +141,7 @@ export type RailFlyout = {
  * @property {Node|string|number|{toElement: () => Node|null}|null} [footer=null] Trailing rail content.
  * @property {number} [openDelay=80] Hover-open delay in milliseconds.
  * @property {number} [closeDelay=160] Pointer/focus crossing grace in milliseconds.
+ * @property {(item: AppNavItem, context: Record<string, any>) => Node|null} [renderIcon] Optional host icon renderer.
  * @property {(event: CustomEvent<AppNavSelectDetail>) => void} [onselect] Preventable action listener.
  * @property {(event: CustomEvent<{item: AppNavItem, id: string|number, open: boolean}>) => void} [onflyoutchange] Flyout-state listener.
  */
@@ -142,11 +149,11 @@ export type RailFlyout = {
 /** @typedef {{key: string, parentKey: string|null, item: AppNavItem, trigger: HTMLElement, panel: HTMLElement, dropdown: Dropdown}} RailFlyout */
 /**
  * Minimized application navigation; descendants always open in hover/focus flyouts, never inline.
- * @fires AppRail#select
- * @fires AppRail#flyoutchange
- * @extends {Component<AppRailOptions>}
+ * @fires AppRailPresenter#select
+ * @fires AppRailPresenter#flyoutchange
+ * @extends {Component<AppRailPresenterOptions>}
  */
-export declare class AppRail extends Component<AppRailOptions> {
+export declare class AppRailPresenter extends Component<AppRailPresenterOptions> {
     _createdRoot: boolean;
     _original: {
         attributes: string[][];
@@ -163,14 +170,14 @@ export declare class AppRail extends Component<AppRailOptions> {
     _pointerFocus: WeakSet<object>;
     _silenceFlyoutEvents: boolean;
     static cssName: string;
-    /** @type {Readonly<AppRailOptions>} */
-    static defaults: Readonly<AppRailOptions>;
+    /** @type {Readonly<AppRailPresenterOptions>} */
+    static defaults: Readonly<AppRailPresenterOptions>;
     /**
      * Creates or enhances a rail host.
      * @param {Element|string|null} target Rail target.
-     * @param {AppRailOptions} [options={}] Rail options.
+     * @param {AppRailPresenterOptions} [options={}] Rail options.
      */
-    constructor(target?: Element | string | null, options?: AppRailOptions);
+    constructor(target?: Element | string | null, options?: AppRailPresenterOptions);
     /** @returns {HTMLElement} */
     render(): HTMLElement;
     /** Replaces navigation items and closes removed flyouts. @param {AppNavItem[]} items @returns {this} */
@@ -245,6 +252,14 @@ declare class RailListenerScope extends Component {
  * @returns {AppNavItem[]}
  */
 export declare function normalizeAppItems(items: unknown): AppNavItem[];
+/**
+ * Resolves a host-rendered or item-owned navigation icon without moving a mounted source node.
+ * @param {AppNavItem} item Navigation item.
+ * @param {unknown} renderer Optional component-level renderer.
+ * @param {Record<string, any>} context Presentation context.
+ * @returns {Node|null}
+ */
+export declare function appNavIcon(item: AppNavItem, renderer: unknown, context: Record<string, any>): Node | null;
 export {};
-/** Fired when a destination/action is activated. @event AppRail#select @type {CustomEvent<AppNavSelectDetail>} */
-/** Fired when a flyout opens or closes. @event AppRail#flyoutchange @type {CustomEvent<{item: AppNavItem, id: string|number, open: boolean}>} */
+/** Fired when a destination/action is activated. @event AppRailPresenter#select @type {CustomEvent<AppNavSelectDetail>} */
+/** Fired when a flyout opens or closes. @event AppRailPresenter#flyoutchange @type {CustomEvent<{item: AppNavItem, id: string|number, open: boolean}>} */

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,6 +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.
      */
@@ -87,10 +99,13 @@ 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.
  */
 /**
@@ -102,3 +117,10 @@ export type ModuleChipOptions = {
  * @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,8 @@ 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 { zeyosSelect } from './select.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';
 export { zeyosTable } from './table.js';

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

@@ -0,0 +1,147 @@
+import { Launcher } from '../components/launcher/launcher.js';
+/** Static application identifiers present in the current ZeyOS shell prototype. */
+export declare const ZEYOS_LAUNCHER_APPLICATIONS: readonly string[];
+export type ZeyosLauncherState = {
+    /**
+     * Permitted module catalogue.
+     */
+    modules?: Record<string, string> | Array<string | Record<string, any>>;
+    /**
+     * Forks/weblets and authoritative menu entries.
+     */
+    menuApps?: Array<Array<any> | Record<string, any>>;
+    /**
+     * Application identifiers in pinned order.
+     */
+    pinned?: string[];
+    /**
+     * Recent records.
+     */
+    recent?: Array<Array<any> | Record<string, any>>;
+    /**
+     * Current module, `fork#…`, or `weblet#…` identifier.
+     */
+    activeIdentifier?: string | null;
+    /**
+     * Permission predicate.
+     */
+    canUseModule?: (module: string) => boolean;
+    /**
+     * Record search loader.
+     */
+    search?: (query: string, context: {
+        signal: AbortSignal;
+    }) => Promise<unknown> | unknown;
+    /**
+     * Recent-record loader.
+     */
+    loadRecent?: (context: {
+        signal: AbortSignal;
+    }) => Promise<unknown> | unknown;
+    /**
+     * Maps an app to href/invoke/value metadata.
+     */
+    resolveApplication?: (app: unknown) => Record<string, any> | null;
+    /**
+     * Maps a record to href/invoke/value metadata.
+     */
+    resolveRecord?: (record: unknown) => Record<string, any> | null;
+    /**
+     * Localized applications/recent/results/entity labels and hints.
+     */
+    labels?: Record<string, any>;
+    /**
+     * Host icon renderer for modules, forks, and weblets.
+     */
+    renderApplicationIcon?: (app: unknown, normalized: Record<string, any>) => Node | null;
+    /**
+     * Host record icon renderer.
+     */
+    renderRecordIcon?: (record: unknown, normalized: Record<string, any>) => Node | null;
+    /**
+     * Legacy weblet-only icon renderer.
+     */
+    renderWebletIcon?: (app: unknown, normalized: Record<string, any>) => Node | null;
+};
+export type ZeyosLauncherOptions = {
+    /**
+     * Use stock icon fallbacks instead of the optional ZeyOS kit.
+     */
+    standardIcons?: boolean;
+    /**
+     * Extra generic Launcher items.
+     */
+    items?: Array<Record<string, any>>;
+    /**
+     * Extra generic Launcher sources.
+     */
+    sources?: Array<Record<string, any>>;
+};
+/**
+ * @typedef {Object} ZeyosLauncherState
+ * @property {Record<string, string>|Array<string|Record<string, any>>} [modules={}] Permitted module catalogue.
+ * @property {Array<Array<any>|Record<string, any>>} [menuApps=[]] Forks/weblets and authoritative menu entries.
+ * @property {string[]} [pinned=[]] Application identifiers in pinned order.
+ * @property {Array<Array<any>|Record<string, any>>} [recent=[]] Recent records.
+ * @property {string|null} [activeIdentifier=null] Current module, `fork#…`, or `weblet#…` identifier.
+ * @property {(module: string) => boolean} [canUseModule] Permission predicate.
+ * @property {(query: string, context: {signal: AbortSignal}) => Promise<unknown>|unknown} [search] Record search loader.
+ * @property {(context: {signal: AbortSignal}) => Promise<unknown>|unknown} [loadRecent] Recent-record loader.
+ * @property {(app: unknown) => Record<string, any>|null} [resolveApplication] Maps an app to href/invoke/value metadata.
+ * @property {(record: unknown) => Record<string, any>|null} [resolveRecord] Maps a record to href/invoke/value metadata.
+ * @property {Record<string, any>} [labels] Localized applications/recent/results/entity labels and hints.
+ * @property {(app: unknown, normalized: Record<string, any>) => Node|null} [renderApplicationIcon] Host icon renderer for modules, forks, and weblets.
+ * @property {(record: unknown, normalized: Record<string, any>) => Node|null} [renderRecordIcon] Host record icon renderer.
+ * @property {(app: unknown, normalized: Record<string, any>) => Node|null} [renderWebletIcon] Legacy weblet-only icon renderer.
+ */
+/**
+ * @typedef {Object} ZeyosLauncherOptions
+ * @property {boolean} [standardIcons=false] Use stock icon fallbacks instead of the optional ZeyOS kit.
+ * @property {Array<Record<string, any>>} [items] Extra generic Launcher items.
+ * @property {Array<Record<string, any>>} [sources] Extra generic Launcher sources.
+ */
+/**
+ * Builds a generic Launcher configuration from explicitly injected ZeyOS shell state. It never
+ * reads PG/C globals and never resolves a route itself.
+ * @param {ZeyosLauncherState} [state={}] Application-owned shell state.
+ * @param {ZeyosLauncherOptions & Record<string, any>} [options={}] Adapter and Launcher options.
+ * @returns {Record<string, any>} Plain Launcher options.
+ */
+export declare function buildZeyosLauncherConfig(state?: ZeyosLauncherState, options?: ZeyosLauncherOptions & Record<string, any>): Record<string, any>;
+/**
+ * Creates the ZeyOS-configured Launcher. State and route resolvers remain caller-owned inputs.
+ * @param {ZeyosLauncherState} [state={}] Injected shell state.
+ * @param {ZeyosLauncherOptions & Record<string, any>} [options={}] Adapter and Launcher options.
+ * @returns {Launcher}
+ */
+export declare function zeyosLauncher(state?: ZeyosLauncherState, options?: ZeyosLauncherOptions & Record<string, any>): Launcher;
+/**
+ * Normalizes module, fork, and weblet applications while preserving menu authority and pin order.
+ * @param {ZeyosLauncherState} [state={}] Injected shell state.
+ * @param {{standardIcons?: boolean, renderApplicationIcon?: Function, renderWebletIcon?: Function}} [options={}] Icon options.
+ * @returns {Array<Record<string, any>>}
+ */
+export declare function normalizeZeyosLauncherApplications(state?: ZeyosLauncherState, options?: {
+    standardIcons?: boolean;
+    renderApplicationIcon?: Function;
+    renderWebletIcon?: Function;
+}): Array<Record<string, any>>;
+/**
+ * Normalizes recent records or grouped search payloads without losing server/group order.
+ * @param {unknown} payload Recent/search payload.
+ * @param {{query?: string, labels?: Record<string, any>, resolveRecord?: Function, renderRecordIcon?: Function, standardIcons?: boolean}} [options={}] Mapping options.
+ * @returns {Array<Record<string, any>>}
+ */
+export declare function normalizeZeyosLauncherRecords(payload: unknown, options?: {
+    query?: string;
+    labels?: Record<string, any>;
+    resolveRecord?: Function;
+    renderRecordIcon?: Function;
+    standardIcons?: boolean;
+}): Array<Record<string, any>>;
+/** @param {{module?: string, fork?: unknown, weblet?: unknown}} state @returns {string} */
+export declare function zeyosActiveIdentifier(state?: {
+    module?: string;
+    fork?: unknown;
+    weblet?: unknown;
+}): string;