@zeyos/zx 3.0.0 → 4.0.0

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

@@ -0,0 +1,128 @@
+import { Component } from '../../core/component.js';
+export type CardContent = string | Node | Component | null;
+export type ButtonOptions = import('../button/button.js').ButtonOptions;
+export type CardAction = Element | ButtonOptions;
+export type CardLinkDescriptor = {
+    /**
+     * Native link destination; executable/data schemes are rejected.
+     */
+    href: string;
+    /**
+     * Native browsing context.
+     */
+    target?: string;
+    /**
+     * Native link relationship.
+     */
+    rel?: string;
+    /**
+     * Native click listener.
+     */
+    onclick?: (event: MouseEvent) => void;
+};
+export type CardLink = string | CardLinkDescriptor | null;
+export type CardOptions = {
+    /**
+     * Card title.
+     */
+    title?: string;
+    /**
+     * Optional image, avatar, icon, or other media.
+     */
+    media?: CardContent;
+    /**
+     * Main card content; enhanced children are adopted by default.
+     */
+    content?: CardContent;
+    /**
+     * Secondary native controls beside the title.
+     */
+    actions?: CardAction[];
+    /**
+     * Optional metadata or trailing content.
+     */
+    footer?: CardContent;
+    /**
+     * Optional native primary link rendered around the title.
+     */
+    link?: CardLink;
+    /**
+     * Surface treatment.
+     */
+    variant?: 'outlined' | 'raised' | 'filled';
+    /**
+     * Media/content arrangement.
+     */
+    orientation?: 'vertical' | 'horizontal';
+    /**
+     * Semantic title heading level.
+     */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+};
+/** @typedef {string|Node|Component|null} CardContent */
+/** @typedef {import('../button/button.js').ButtonOptions} ButtonOptions */
+/** @typedef {Element|ButtonOptions} CardAction */
+/**
+ * @typedef {Object} CardLinkDescriptor
+ * @property {string} href Native link destination; executable/data schemes are rejected.
+ * @property {string} [target] Native browsing context.
+ * @property {string} [rel] Native link relationship.
+ * @property {(event: MouseEvent) => void} [onclick] Native click listener.
+ */
+/** @typedef {string|CardLinkDescriptor|null} CardLink */
+/**
+ * @typedef {Object} CardOptions
+ * @property {string} [title=''] Card title.
+ * @property {CardContent} [media=null] Optional image, avatar, icon, or other media.
+ * @property {CardContent} [content=null] Main card content; enhanced children are adopted by default.
+ * @property {CardAction[]} [actions=[]] Secondary native controls beside the title.
+ * @property {CardContent} [footer=null] Optional metadata or trailing content.
+ * @property {CardLink} [link=null] Optional native primary link rendered around the title.
+ * @property {'outlined'|'raised'|'filled'} [variant='outlined'] Surface treatment.
+ * @property {'vertical'|'horizontal'} [orientation='vertical'] Media/content arrangement.
+ * @property {1|2|3|4|5|6} [headingLevel=3] Semantic title heading level.
+ */
+/**
+ * Semantic content or record surface with optional media, native primary link, actions, and footer.
+ * The root is never interactive: linked cards keep a real title anchor, so secondary controls are
+ * siblings rather than invalid nested actions.
+ * @extends {Component<CardOptions>}
+ */
+export declare class Card extends Component<CardOptions> {
+    _createdRoot: boolean;
+    _original: import("../../core/dom.js").TargetSnapshot;
+    _cleaned: boolean;
+    _title: string;
+    _link: CardLinkDescriptor;
+    _actionAbort: AbortController;
+    _linkAbort: AbortController;
+    static cssName: string;
+    /** @type {Readonly<CardOptions>} */
+    static defaults: Readonly<CardOptions>;
+    /**
+     * Creates or enhances one card.
+     * @param {Element|string|null} [target=null] Existing card container, selector, or null.
+     * @param {CardOptions} [options={}] Card options.
+     */
+    constructor(target?: Element | string | null, options?: CardOptions);
+    /** @returns {HTMLElement} */
+    render(): HTMLElement;
+    /** Replaces the card title. @param {string} title Next title. @returns {this} */
+    setTitle(title: string): this;
+    /** Replaces or removes the media region. @param {CardContent} content Media. @returns {this} */
+    setMedia(content: CardContent): this;
+    /** Replaces or clears the main content. @param {CardContent} content Content. @returns {this} */
+    setContent(content: CardContent): this;
+    /** Replaces the secondary action controls. @param {CardAction[]} actions Actions. @returns {this} */
+    setActions(actions: CardAction[]): this;
+    /** Replaces or removes the footer. @param {CardContent} content Footer. @returns {this} */
+    setFooter(content: CardContent): this;
+    /** Sets or removes the title's native primary link. @param {CardLink} link Link. @returns {this} */
+    setLink(link: CardLink): this;
+    /** Restores an enhanced target exactly, or removes an owned card. @returns {void} */
+    destroy(): void;
+    /** @returns {void} */
+    _renderHeading(): void;
+    /** @returns {void} */
+    _syncHeader(): void;
+}

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

@@ -219,6 +219,7 @@ export declare class Chart extends Component<ChartOptions> {
     _chartOptions: Record<string, unknown>;
     _loading: boolean;
     _error: unknown;
+    _hasError: boolean;
     _handle: ChartHandle;
     _destroyed: boolean;
     _observer: ResizeObserver;

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

@@ -21,19 +21,39 @@ export type LauncherItem = {
      */
     group?: string;
     /**
-     * Kernel icon name.
+     * Decorative icon name, node, or factory.
      */
-    icon?: string;
+    icon?: string | Node | ((item: LauncherItem) => Node | null);
     /**
      * Compact metadata.
      */
     badge?: string | number;
+    /**
+     * Tile or row presentation.
+     */
+    kind?: 'application' | 'record' | 'action';
+    /**
+     * Whether this is the current application or destination.
+     */
+    current?: boolean;
+    /**
+     * Query state in which the item is visible.
+     */
+    when?: 'always' | 'empty' | 'query';
+    /**
+     * Explicit group order.
+     */
+    groupOrder?: number;
+    /**
+     * Stable order within equally ranked results.
+     */
+    itemOrder?: number;
     /**
      * Emitted value; defaults to `id`.
      */
     value?: unknown;
     /**
-     * Native link target.
+     * Native link target; executable/data schemes are disabled.
      */
     href?: string;
     /**
@@ -66,6 +86,14 @@ export type LauncherSource = {
      * Per-source minimum query length.
      */
     minQuery?: number;
+    /**
+     * Query state in which the source runs.
+     */
+    when?: 'always' | 'empty' | 'query';
+    /**
+     * Whether Zx ranks results or preserves source order.
+     */
+    order?: 'rank' | 'source';
     /**
      * Loader.
      */
@@ -106,6 +134,14 @@ export type LauncherOptions = {
      * Dialog and field label.
      */
     label?: string;
+    /**
+     * Close-button accessible label.
+     */
+    closeLabel?: string;
+    /**
+     * Results-region accessible label.
+     */
+    resultsLabel?: string;
     /**
      * Empty-state text.
      */
@@ -118,6 +154,14 @@ export type LauncherOptions = {
      * Optional global keyboard shortcut.
      */
     shortcut?: 'mod+k' | false;
+    /**
+     * Visible keyboard hints, or false.
+     */
+    hints?: false | {
+        move?: string;
+        open?: string;
+        close?: string;
+    };
     /**
      * Preventable selection listener.
      */
@@ -161,10 +205,15 @@ export type RankedLauncherItem = LauncherItem & {
  * @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|Node|((item: LauncherItem) => Node|null)} [icon] Decorative icon name, node, or factory.
  * @property {string|number} [badge] Compact metadata.
+ * @property {'application'|'record'|'action'} [kind='action'] Tile or row presentation.
+ * @property {boolean} [current=false] Whether this is the current application or destination.
+ * @property {'always'|'empty'|'query'} [when='always'] Query state in which the item is visible.
+ * @property {number} [groupOrder] Explicit group order.
+ * @property {number} [itemOrder] Stable order within equally ranked results.
  * @property {unknown} [value] Emitted value; defaults to `id`.
- * @property {string} [href] Native link target.
+ * @property {string} [href] Native link target; executable/data schemes are disabled.
  * @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.
@@ -175,6 +224,8 @@ export type RankedLauncherItem = LauncherItem & {
  * @property {string} id Source identifier.
  * @property {string} [label] Default group label.
  * @property {number} [minQuery] Per-source minimum query length.
+ * @property {'always'|'empty'|'query'} [when='always'] Query state in which the source runs.
+ * @property {'rank'|'source'} [order='rank'] Whether Zx ranks results or preserves source order.
  * @property {(query: string, context: {signal: AbortSignal}) => Promise<LauncherItem[]>|LauncherItem[]} load Loader.
  */
 /**
@@ -187,9 +238,12 @@ export type RankedLauncherItem = LauncherItem & {
  * @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} [closeLabel='Close launcher'] Close-button accessible label.
+ * @property {string} [resultsLabel='Launcher results'] Results-region accessible 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 {false|{move?: string, open?: string, close?: string}} [hints] Visible keyboard hints, or false.
  * @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.
@@ -217,8 +271,9 @@ export declare class Launcher extends Component<LauncherOptions> {
     _sources: LauncherSource[];
     _sourceItems: Map<any, any>;
     _query: string;
+    _renderedQuery: string;
     _results: any[];
-    _active: number;
+    _active: any;
     _request: AbortController;
     _requestSequence: number;
     _queryTimer: number;
@@ -251,6 +306,8 @@ export declare class Launcher extends Component<LauncherOptions> {
     getQuery(): string;
     /** Replaces local catalogue items. @param {LauncherItem[]} items @returns {this} */
     setItems(items: LauncherItem[]): this;
+    /** Marks one local item as the current destination. @param {string|number|null} id Item id. @returns {this} */
+    setCurrent(id: string | number | null): 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} */
@@ -273,6 +330,8 @@ export declare class Launcher extends Component<LauncherOptions> {
     _syncActive(): void;
     /** @param {KeyboardEvent} event @returns {void} */
     _onKeydown(event: KeyboardEvent): void;
+    /** @param {string} direction @param {number[]} enabled @returns {number|null} */
+    _spatialIndex(direction: string, enabled: number[]): number | null;
     /** @param {number} index @param {Event} event @returns {void} */
     _activate(index: number, event: Event): void;
     /** @param {KeyboardEvent} event @returns {void} */

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

@@ -3,6 +3,14 @@ export type Primitive = string | number | boolean | symbol | bigint | null | und
 export type SelectItem = Record<string, any> | Primitive;
 export type SelectValueReader = string | ((item: SelectItem) => unknown);
 export type SelectLabelReader = string | ((item: SelectItem) => string);
+export type SelectAction = {
+    id: string | number;
+    label: string;
+    icon?: string | Node;
+    description?: string;
+    group?: string;
+    invoke?: (detail: SelectActionDetail) => void;
+};
 export type SelectOptions = {
     /**
      * Available values.
@@ -28,6 +36,22 @@ export type SelectOptions = {
      * Selected-value renderer.
      */
     renderValue?: ((item: SelectItem) => string) | null;
+    /**
+     * Decorative content before the selected text.
+     */
+    renderValueAdornment?: ((item: SelectItem) => Node | string | null) | null;
+    /**
+     * Clear-row renderer.
+     */
+    renderNone?: ((label: string) => Node | string) | null;
+    /**
+     * Clear-row label independent from the input placeholder.
+     */
+    noneLabel?: string | null;
+    /**
+     * Command rows that emit `action` without changing value.
+     */
+    actions?: SelectAction[];
     /**
      * Initially selected ID or item.
      */
@@ -92,6 +116,10 @@ export type SelectOptions = {
      * Async-loaded listener.
      */
     onloaded?: (event: CustomEvent<SelectLoadedDetail>) => void;
+    /**
+     * Preventable command-row listener.
+     */
+    onaction?: (event: CustomEvent<SelectActionDetail>) => void;
 };
 export type SelectChangeDetail = {
     value: unknown;
@@ -103,9 +131,16 @@ export type SelectQueryDetail = {
 export type SelectLoadedDetail = {
     items: SelectItem[];
 };
+export type SelectActionDetail = {
+    id: string | number;
+    action: SelectAction;
+    query: string;
+    select: Select;
+};
 export type SelectOptionEntry = {
     item: SelectItem | null;
     clear: boolean;
+    action: SelectAction | null;
     element: HTMLElement;
 };
 export type SelectSetOptions = {
@@ -126,6 +161,7 @@ export declare class Select extends Component<SelectOptions> {
     _visibleItems: any[];
     _fixedItems: any[] | SelectItem[];
     _visibleFixed: any[] | SelectItem[];
+    _actions: any[] | SelectAction[];
     _selected: SelectItem;
     _optionEntries: any[];
     _activeIndex: number;
@@ -171,6 +207,8 @@ export declare class Select extends Component<SelectOptions> {
      * @returns {this}
      */
     setFixedItems(items: SelectItem[]): this;
+    /** Replaces command rows without changing the selected value. @param {SelectAction[]} actions @returns {this} */
+    setActions(actions: SelectAction[]): this;
     /**
      * Restores the configured initial value.
      * @param {{silent?: boolean}} [options={}] Reset behavior.
@@ -196,6 +234,15 @@ export declare class Select extends Component<SelectOptions> {
      * @returns {Select}
      */
     static priority(target: Element | string | null, options?: SelectOptions): Select;
+    /**
+     * Creates a status picker with shape- and color-distinct workflow indicators.
+     * @param {Element|string|null} target Component target.
+     * @param {SelectOptions & {items?: Array<Record<string, any>>}} [options={}] Select overrides and status items.
+     * @returns {Select}
+     */
+    static status(target: Element | string | null, options?: SelectOptions & {
+        items?: Array<Record<string, any>>;
+    }): 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,
@@ -228,6 +275,8 @@ export declare class Select extends Component<SelectOptions> {
     _renderOptions(): void;
     /** @param {SelectItem|null} item @param {boolean} clear @param {string} [label] @returns {void} */
     _appendOption(item: SelectItem | null, clear: boolean, label?: string): void;
+    /** @param {SelectAction} action @returns {void} */
+    _appendAction(action: SelectAction): void;
     /** @param {SelectItem|null} item @returns {Node|string} */
     _renderItem(item: SelectItem | null): Node | string;
     /** @param {string} query @returns {void} */
@@ -241,6 +290,8 @@ export declare class Select extends Component<SelectOptions> {
     /** @returns {void} */
     _syncInputValue(): void;
     /** @returns {void} */
+    _syncValueAdornment(): void;
+    /** @returns {void} */
     _syncDisabled(): void;
     /** @param {unknown} candidate @returns {SelectItem|null} */
     _findItem(candidate: unknown): SelectItem | null;

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

@@ -444,7 +444,8 @@ export type TableEditorEntry = {
  * @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;
@@ -523,8 +524,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}
      */

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

@@ -64,6 +64,14 @@ export declare function parseCompactTag(compact: string): CompactTag;
 export declare function compactElement(compact: string, properties?: DomBuilderProperties | null, content?: unknown): HTMLElement;
 /** Exact migration-facing alias retained for existing ZeyOS builder calls. */
 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/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';
@@ -50,7 +51,7 @@ export { Search } from './components/search/search.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';

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

@@ -79,6 +79,10 @@ export type ModuleChipOptions = {
      * Use the stock Font Awesome fallback glyph.
      */
     standard?: boolean;
+    /**
+     * Override the module colour for a server-defined fork or weblet.
+     */
+    color?: string;
     /**
      * Extra class names.
      */
@@ -91,6 +95,7 @@ export type ModuleChipOptions = {
  * @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} [color] Override the module colour for a server-defined fork or weblet.
  * @property {string|string[]} [class] Extra class names.
  */
 /**

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

@@ -7,6 +7,7 @@ export { buildListQuery, tableSortToQuery, dataFilterStateToFilters, dateToUnixS
 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_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';