@zeyos/zx 3.0.0 → 4.0.0

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;

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

@@ -156,6 +156,45 @@ export declare function buildZeyosSelectConfig(client: Record<string, any>, reso
 export declare function zeyosSelect(client: Record<string, any>, resource: string, opts?: ZeyosSelectOptions): Select & {
     ready: Promise<Select>;
 };
+/**
+ * Builds the rich, resource-specific Entity-box preset over the generic injected Select binding.
+ * It adds module-colored icons, optional subtitles/groups, a fixed clear row, and an optional
+ * application-owned create command without changing the selected ID contract.
+ * @param {Record<string, any>} client Injected ZeyOS client instance.
+ * @param {string} resource Resource such as `projects` or `accounts`.
+ * @param {ZeyosSelectOptions & {
+ *   subtitleKey?: string|((item: Record<string, unknown>) => unknown)|null,
+ *   moduleKey?: string|((item: Record<string, unknown>) => unknown),
+ *   none?: boolean|string,
+ *   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.
+ * @returns {Record<string, any>} Plain Select options.
+ */
+export declare function buildZeyosEntitySelectConfig(client: Record<string, any>, resource: string, opts?: ZeyosSelectOptions & {
+    subtitleKey?: string | ((item: Record<string, unknown>) => unknown) | null;
+    moduleKey?: string | ((item: Record<string, unknown>) => unknown);
+    none?: boolean | string;
+    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;
+}): Record<string, any>;
+/**
+ * Creates a ZeyOS Entity-box preset. Await `select.ready` when a non-null initial ID must be
+ * hydrated before presentation.
+ * @param {Record<string, any>} client Injected ZeyOS client instance.
+ * @param {string} resource Resource name.
+ * @param {Record<string, any>} [opts={}] Entity Select options.
+ * @returns {Select & {ready: Promise<Select>}}
+ */
+export declare function zeyosEntitySelect(client: Record<string, any>, resource: string, opts?: Record<string, any>): Select & {
+    ready: Promise<Select>;
+};
 /**
  * Normalizes list output without importing the client package. If the injected client exposes its
  * own `normalizeListResult`, that implementation wins; otherwise arrays and `.data` are handled