@zeyos/zx 2.3.0 → 4.0.0

package/dist/types/core/drag-axis.d.ts

@@ -0,0 +1,111 @@
+/** Pixels an arrow key moves a handle. */
+export declare const STEP = 16;
+/** Pixels a shifted arrow key moves a handle. */
+export declare const STEP_LARGE = 64;
+export type DragAxisOptions = {
+    /**
+     * Axis the handle moves along. `horizontal` reads
+     * `clientX`, `vertical` reads `clientY`.
+     */
+    orientation: 'horizontal' | 'vertical';
+    /**
+     * Called on pointer-down before the
+     * drag begins. Return `false` to refuse it — the usual reason being that there is nothing to
+     * resize on either side of the handle.
+     */
+    onStart?: (event: PointerEvent) => boolean | void;
+    /**
+     * Called at most once per frame with the signed pixel
+     * distance travelled along the axis since pointer-down.
+     */
+    onMove: (delta: number) => void;
+    /**
+     * Called once the pointer is released.
+     * `moved` is false for a press that never travelled, which is a click rather than a drag.
+     */
+    onEnd?: (delta: number, moved: boolean) => void;
+    /**
+     * Called for an arrow key along the
+     * axis. `large` is true while Shift is held.
+     */
+    onStep?: (direction: -1 | 1, large: boolean) => void;
+    /**
+     * Called for Home and End.
+     */
+    onJump?: (edge: 'min' | 'max') => void;
+    /**
+     * Called for Enter and Space, which components use for the
+     * collapse affordance a splitter is expected to offer.
+     */
+    onActivate?: () => void;
+    /**
+     * Consulted before every interaction.
+     */
+    disabled?: () => boolean;
+};
+export type DragAxisController = {
+    /**
+     * Whether a drag is in flight.
+     */
+    isDragging: () => boolean;
+    /**
+     * Ends any drag in flight without reporting it.
+     */
+    cancel: () => void;
+    /**
+     * Removes listeners and cancels any drag in flight.
+     */
+    destroy: () => void;
+};
+/**
+ * @typedef {Object} DragAxisOptions
+ * @property {'horizontal'|'vertical'} orientation Axis the handle moves along. `horizontal` reads
+ *   `clientX`, `vertical` reads `clientY`.
+ * @property {(event: PointerEvent) => boolean|void} [onStart] Called on pointer-down before the
+ *   drag begins. Return `false` to refuse it — the usual reason being that there is nothing to
+ *   resize on either side of the handle.
+ * @property {(delta: number) => void} onMove Called at most once per frame with the signed pixel
+ *   distance travelled along the axis since pointer-down.
+ * @property {(delta: number, moved: boolean) => void} [onEnd] Called once the pointer is released.
+ *   `moved` is false for a press that never travelled, which is a click rather than a drag.
+ * @property {(direction: -1|1, large: boolean) => void} [onStep] Called for an arrow key along the
+ *   axis. `large` is true while Shift is held.
+ * @property {(edge: 'min'|'max') => void} [onJump] Called for Home and End.
+ * @property {() => void} [onActivate] Called for Enter and Space, which components use for the
+ *   collapse affordance a splitter is expected to offer.
+ * @property {() => boolean} [disabled] Consulted before every interaction.
+ */
+/**
+ * @typedef {Object} DragAxisController
+ * @property {() => boolean} isDragging Whether a drag is in flight.
+ * @property {() => void} cancel Ends any drag in flight without reporting it.
+ * @property {() => void} destroy Removes listeners and cancels any drag in flight.
+ */
+/**
+ * Pointer and keyboard mechanics for anything dragged along one axis — a split divider, a dock
+ * divider, the resizable edge of a sheet.
+ *
+ * Deliberately knows nothing about sizes. It reports the signed distance travelled and leaves
+ * every consumer to do its own arithmetic, because the three that need it disagree about what a
+ * drag means: a split view moves one boundary, a dock moves size between two neighbours, and a
+ * sheet grows in the opposite direction depending on which edge it is attached to. What they do
+ * share is the fiddly part — pointer capture that survives the pointer leaving the handle, one
+ * write per frame however fast the pointer reports, telling a click apart from a zero-distance
+ * drag, and the WAI-ARIA keyboard map.
+ *
+ * @param {Element} handle Element the pointer grabs; also the keyboard target.
+ * @param {DragAxisOptions} options Axis and callbacks.
+ * @returns {DragAxisController}
+ */
+export declare function dragAxis(handle: Element, options: DragAxisOptions): DragAxisController;
+/**
+ * Resolves a size option to pixels without touching the DOM.
+ *
+ * Numbers, bare numeric strings, and `px` lengths are pixels; a percentage resolves against
+ * `total`. Every other CSS length — `rem`, `vh`, `calc()` — needs the browser, so it returns `NaN`
+ * and the caller hands the value to CSS instead of guessing at it.
+ * @param {number|string} value Size option.
+ * @param {number} total Container size along the split axis, in pixels.
+ * @returns {number} Pixels, or `NaN` when only the browser can resolve the value.
+ */
+export declare function resolveSize(value: number | string, total: number): number;

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

@@ -1,5 +1,6 @@
+export type Placement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top' | 'right-start' | 'right-end' | 'left-start' | 'left-end' | 'right' | 'left';
 export type PositionOptions = {
-    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';
     /**
      * Gap between anchor and floating element.
      */
@@ -23,9 +24,10 @@ export type PositionController = {
      */
     destroy: () => void;
 };
+/** @typedef {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'} Placement */
 /**
  * @typedef {Object} PositionOptions
- * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'} [placement='bottom-start']
+ * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'} [placement='bottom-start']
  * @property {number} [offset=4] Gap between anchor and floating element.
  * @property {boolean} [flip=true] Flip vertically when the preferred side overflows.
  * @property {boolean} [matchWidth=false] Set the floating element's minimum width to the anchor width.

package/dist/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 export declare function registerFieldAdapters(): void;
 export { Component } from './core/component.js';
-export { h, htmlEscape, resolveElement, highlightMatch } from './core/dom.js';
+export { h, htmlEscape, resolveElement, highlightMatch, __, compactElement, fragment, parseCompactTag, applyCompactProperties, appendContent, appendCompact, appendCompactChild, onCompactEvent, offCompactEvent, fireCompactEvent } from './core/dom.js';
 export { position } from './core/position.js';
 export { breakpoints, breakpointOf, matchBreakpoint, onBreakpoint } from './core/breakpoint.js';
 export { Http, zeyosService, parseResult } from './core/http.js';
@@ -37,18 +37,27 @@ 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';
+export { Dock } from './components/dock/dock.js';
 export { Tabbox } from './components/tabbox/tabbox.js';
 export { NavigationBar } from './components/navigation-bar/navigation-bar.js';
 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 { 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 { 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';
 export { Dialog } from './components/dialog/dialog.js';
+export { Sheet } from './components/sheet/sheet.js';
+export { SheetStack } from './components/sheet/sheet-stack.js';
 export { Dropdown } from './components/dropdown/dropdown.js';
 export { Tooltip, tooltip, describe } from './components/tooltip/tooltip.js';
 export { MenuButton } from './components/menu-button/menu-button.js';
@@ -59,7 +68,6 @@ export { TagPicker } from './components/tag-picker/tag-picker.js';
 export { NumberField, parseNumber, snapNumber } from './components/number-field/number-field.js';
 export { Rating } from './components/rating/rating.js';
 export { Slider, stepPrecision } from './components/slider/slider.js';
-export { Permission } from './components/permission/permission.js';
 export { DatePicker } from './components/date-picker/date-picker.js';
 export { MonthPicker } from './components/date-picker/month-picker.js';
 export { TimePicker } from './components/date-picker/time-picker.js';
@@ -68,12 +76,15 @@ export { DateRangePicker, clampRange, defaultDateRangePresets, normalizeRange, r
 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 { 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 { Field } from './components/field/field.js';
 export { Fieldset } from './components/fieldset/fieldset.js';
 export { Form } from './components/form/form.js';
+export { Questionnaire } from './components/questionnaire/questionnaire.js';
 export { ValueList } from './components/value-list/value-list.js';
 export { MultiValueEditor } from './components/multi-value-editor/multi-value-editor.js';
 export { FieldUpload } from './components/field-upload/field-upload.js';

package/dist/types/internal/app-rail.d.ts

@@ -0,0 +1,265 @@
+import { Component } from '../core/component.js';
+import { Dropdown } from '../components/dropdown/dropdown.js';
+export type AppNavItem = {
+    /**
+     * Stable item identifier.
+     */
+    id: string | number;
+    /**
+     * Visible/accessibility label.
+     */
+    label: string;
+    /**
+     * Icon name, node, component, or factory.
+     */
+    icon?: string | Node | {
+        toElement: () => Node | null;
+    } | ((context: Record<string, any>, item: AppNavItem) => Node | null);
+    /**
+     * Count or status badge.
+     */
+    badge?: string | number;
+    /**
+     * Emitted value; defaults to `id`.
+     */
+    value?: unknown;
+    /**
+     * Native navigation target; executable/data schemes are disabled.
+     */
+    href?: string;
+    /**
+     * Native link browsing context.
+     */
+    target?: string;
+    /**
+     * Application-owned non-link action.
+     */
+    invoke?: () => void;
+    /**
+     * Whether activation is unavailable.
+     */
+    disabled?: boolean;
+    /**
+     * Child destinations/actions.
+     */
+    children?: AppNavItem[];
+};
+export type AppRailPresenterOptions = {
+    /**
+     * Application navigation tree.
+     */
+    items?: AppNavItem[];
+    /**
+     * Active item id.
+     */
+    active?: string | number | null;
+    /**
+     * Rail flow.
+     */
+    orientation?: 'vertical' | 'horizontal';
+    /**
+     * Workspace edge occupied by the rail.
+     */
+    side?: 'left' | 'right' | 'top' | 'bottom';
+    /**
+     * Navigation accessible label.
+     */
+    label?: string;
+    /**
+     * Leading rail content.
+     */
+    header?: Node | string | number | {
+        toElement: () => Node | null;
+    } | null;
+    /**
+     * Trailing rail content.
+     */
+    footer?: Node | string | number | {
+        toElement: () => Node | null;
+    } | null;
+    /**
+     * Hover-open delay in milliseconds.
+     */
+    openDelay?: number;
+    /**
+     * Pointer/focus crossing grace in milliseconds.
+     */
+    closeDelay?: number;
+    /**
+     * Optional host icon renderer.
+     */
+    renderIcon?: (item: AppNavItem, context: Record<string, any>) => Node | null;
+    /**
+     * Preventable action listener.
+     */
+    onselect?: (event: CustomEvent<AppNavSelectDetail>) => void;
+    /**
+     * Flyout-state listener.
+     */
+    onflyoutchange?: (event: CustomEvent<{
+        item: AppNavItem;
+        id: string | number;
+        open: boolean;
+    }>) => void;
+};
+export type AppNavSelectDetail = {
+    item: AppNavItem;
+    id: string | number;
+    value: unknown;
+    href: string | null;
+    event: Event;
+};
+export type RailFlyout = {
+    key: string;
+    parentKey: string | null;
+    item: AppNavItem;
+    trigger: HTMLElement;
+    panel: HTMLElement;
+    dropdown: Dropdown;
+};
+/**
+ * @typedef {Object} AppNavItem
+ * @property {string|number} id Stable item identifier.
+ * @property {string} label Visible/accessibility label.
+ * @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; 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} AppRailPresenterOptions
+ * @property {AppNavItem[]} [items=[]] Application navigation tree.
+ * @property {string|number|null} [active=null] Active item id.
+ * @property {'vertical'|'horizontal'} [orientation='vertical'] Rail flow.
+ * @property {'left'|'right'|'top'|'bottom'} [side='left'] Workspace edge occupied by the rail.
+ * @property {string} [label='Applications'] Navigation accessible label.
+ * @property {Node|string|number|{toElement: () => Node|null}|null} [header=null] Leading rail content.
+ * @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.
+ */
+/** @typedef {{item: AppNavItem, id: string|number, value: unknown, href: string|null, event: Event}} AppNavSelectDetail */
+/** @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 AppRailPresenter#select
+ * @fires AppRailPresenter#flyoutchange
+ * @extends {Component<AppRailPresenterOptions>}
+ */
+export declare class AppRailPresenter extends Component<AppRailPresenterOptions> {
+    _createdRoot: boolean;
+    _original: {
+        attributes: string[][];
+        children: ChildNode[];
+    };
+    _items: AppNavItem[];
+    _active: string | number;
+    _flyouts: Map<any, any>;
+    _tooltips: any[];
+    _tooltipById: Map<any, any>;
+    _interaction: RailListenerScope;
+    _openTimers: Map<any, any>;
+    _closeTimers: Map<any, any>;
+    _pointerFocus: WeakSet<object>;
+    _silenceFlyoutEvents: boolean;
+    static cssName: string;
+    /** @type {Readonly<AppRailPresenterOptions>} */
+    static defaults: Readonly<AppRailPresenterOptions>;
+    /**
+     * Creates or enhances a rail host.
+     * @param {Element|string|null} target Rail target.
+     * @param {AppRailPresenterOptions} [options={}] Rail options.
+     */
+    constructor(target?: Element | string | null, options?: AppRailPresenterOptions);
+    /** @returns {HTMLElement} */
+    render(): HTMLElement;
+    /** Replaces navigation items and closes removed flyouts. @param {AppNavItem[]} items @returns {this} */
+    setItems(items: AppNavItem[]): this;
+    /** Sets the active item without routing. @param {string|number|null} id @returns {this} */
+    setActive(id: string | number | null): this;
+    /** Returns a shallow copy of normalized items. @returns {AppNavItem[]} */
+    getItems(): AppNavItem[];
+    /** Opens one item's flyout, optionally focusing its first action. @param {string|number} id @param {{focus?: boolean}} [options={}] @returns {this} */
+    openFlyout(id: string | number, { focus }?: {
+        focus?: boolean;
+    }): this;
+    /** Closes one flyout. @param {string|number} id @returns {this} */
+    closeFlyout(id: string | number): this;
+    /** Closes every flyout and cancels pending hover/focus transitions. @returns {this} */
+    closeAllFlyouts(): this;
+    /** Reports whether an item's flyout is open. @param {string|number} id @returns {boolean} */
+    isFlyoutOpen(id: string | number): boolean;
+    /** Focuses the first top-level rail item. @returns {this} */
+    focus(): this;
+    /** Reports whether a node belongs to this rail, including detached flyout panels. @param {Node|null} node @returns {boolean} @private */
+    private _containsNode;
+    /** Destroys body popovers/tooltips and restores or removes the root. @returns {void} */
+    destroy(): void;
+    /** @returns {void} */
+    _rebuild(): void;
+    /** @param {AppNavItem} item @param {HTMLElement} trigger @param {string} key @param {string|null} parentKey @returns {void} */
+    _buildFlyout(item: AppNavItem, trigger: HTMLElement, key: string, parentKey: string | null): void;
+    /** @param {AppNavItem} item @param {Event} event @returns {Event} */
+    _select(item: AppNavItem, event: Event): Event;
+    /** @param {KeyboardEvent} event @returns {void} */
+    _onRailKeydown(event: KeyboardEvent): void;
+    /** @param {KeyboardEvent} event @param {RailFlyout} flyout @returns {void} */
+    _onFlyoutKeydown(event: KeyboardEvent, flyout: RailFlyout): void;
+    /** @param {string|number} id @returns {void} */
+    _scheduleOpen(id: string | number): void;
+    /** @param {string|number} id @returns {void} */
+    _scheduleClose(id: string | number): void;
+    /** Schedules a flyout and, when leaving a detached panel, each owning flyout for re-evaluation. @param {RailFlyout} flyout @param {boolean} ancestors @returns {void} */
+    _scheduleFlyoutClose(flyout: RailFlyout, ancestors: boolean): void;
+    /** Resolves a public id or internal descendant path. @param {string|number} id @returns {RailFlyout|null} */
+    _resolveFlyout(id: string | number): RailFlyout | null;
+    /** Closes the root flyout that owns a selected descendant. @param {string} key @returns {void} */
+    _closeFlyoutChain(key: string): void;
+    /** Reports whether one flyout owns another through its parent chain. @param {RailFlyout} ancestor @param {RailFlyout} descendant @returns {boolean} */
+    _isAncestor(ancestor: RailFlyout, descendant: RailFlyout): boolean;
+    /** Cancels crossing timers for a flyout and optionally every owning flyout. @param {RailFlyout} flyout @param {boolean} ancestors @returns {void} */
+    _cancelFlyoutTimers(flyout: RailFlyout, ancestors: boolean): void;
+    /** Reports pointer/focus presence in a flyout branch, including detached descendant panels. @param {RailFlyout} flyout @returns {boolean} */
+    _branchInteracting(flyout: RailFlyout): boolean;
+    /** Restores trigger focus without immediately reopening the flyout through its focus handler. @param {HTMLElement} trigger @returns {void} */
+    _restoreFocus(trigger: HTMLElement): void;
+    /** @param {string} key @returns {void} */
+    _cancelTimers(key: string): void;
+    /** @param {Map<string, ReturnType<typeof setTimeout>>} timers @param {string} key @returns {void} */
+    _cancelTimer(timers: Map<string, ReturnType<typeof setTimeout>>, key: string): void;
+    /** @returns {void} */
+    _syncActive(): void;
+    /** @returns {void} */
+    _clearArtifacts(): void;
+}
+/** Owns listeners attached to one dynamic rail render so `setItems()` can release them immediately. */
+declare class RailListenerScope extends Component {
+    /** @param {HTMLElement} host Rail host. */
+    constructor(host: HTMLElement);
+    /** @returns {HTMLElement} */
+    render(): HTMLElement;
+}
+/**
+ * Normalizes an application navigation tree without mutating caller data.
+ * @param {unknown} items Candidate tree.
+ * @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 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';

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;