@zeyos/zx 2.1.0 → 2.2.0

package/dist/types/compat/map/date-time.d.ts

@@ -0,0 +1,80 @@
+import { DatePicker as ZxDatePicker, MonthPicker as ZxMonthPicker, TimePicker as ZxTimePicker } from '../../index.js';
+import { GxWrapper } from '../base.js';
+/** Legacy segmented date box presented through the Zx formatted date input. */
+export declare class Datebox extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Date|number|string|null} timestamp @param {'milliseconds'|'seconds'} [unit] @returns {this} */
+    set(timestamp: Date | number | string | null, unit?: 'milliseconds' | 'seconds'): this;
+    /** @param {'milliseconds'|'seconds'|'date'} [unit] @returns {Date|number|null} */
+    get(unit?: 'milliseconds' | 'seconds' | 'date'): Date | number | null;
+    /** @returns {this} */ enable(): this;
+    /** @returns {this} */ disable(): this;
+}
+/** Shared inline picker wrapper with legacy date formatting. */
+declare class PickerBase extends GxWrapper {
+    _date: Date;
+    static legacyName: string;
+    /** @type {new (target: Element|string|null, options?: any) => any} */
+    static Picker: new (target: Element | string | null, options?: any) => any;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Date|number|string|null} value @returns {this} */
+    set(value: Date | number | string | null): this;
+    /** @param {string} [format] @returns {Date|number|string|null} */
+    get(format?: string): Date | number | string | null;
+    /** @returns {number|null} */ getSeconds(): number | null;
+    /** @param {boolean} readOnly @returns {this} */ setReadOnly(readOnly: boolean): this;
+    /** @param {string} format @param {boolean} [enableTimePicker] @returns {this} */ setFormat(format: string, enableTimePicker?: boolean): this;
+    /** @returns {Date|null} */
+    _readDate(): Date | null;
+    /** @param {{h?: number, m?: number, s?: number}|null} time @returns {Date} */
+    _dateFromTime(time: {
+        h?: number;
+        m?: number;
+        s?: number;
+    } | null): Date;
+}
+/** Legacy date picker. */
+export declare class DatePicker extends PickerBase {
+    static legacyName: string;
+    static Picker: typeof ZxDatePicker;
+}
+/** Legacy month picker. */
+export declare class MonthPicker extends PickerBase {
+    static legacyName: string;
+    static Picker: typeof ZxMonthPicker;
+}
+/** Legacy time picker. */
+export declare class TimePicker extends PickerBase {
+    static legacyName: string;
+    static Picker: typeof ZxTimePicker;
+}
+/** Shared duration Timebox wrapper. */
+declare class TimeboxBase extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {number} time @param {'seconds'|'minutes'|'hours'} [unit] @returns {this} */ set(time: number, unit?: 'seconds' | 'minutes' | 'hours'): this;
+    /** @param {'seconds'|'minutes'|'hours'} [unit] @param {number} [precision=0] @returns {number} */
+    get(unit?: 'seconds' | 'minutes' | 'hours', precision?: number): number;
+    /** @returns {this} */ update(): this;
+    /** @returns {this} */ enable(): this;
+    /** @returns {this} */ disable(): this;
+    /** @returns {boolean} */ disabled(): boolean;
+    /** @param {boolean} positive @returns {this} */ setPrefix(positive: boolean): this;
+}
+/** Legacy core Timebox. */
+export declare class CoreTimebox extends TimeboxBase {
+    static legacyName: string;
+}
+/** Legacy ZeyOS Timebox. */
+export declare class Timebox extends TimeboxBase {
+    static legacyName: string;
+}
+/** Legacy bootstrap Timebox. */
+export declare class BootstrapTimebox extends TimeboxBase {
+    static legacyName: string;
+}
+export {};

package/dist/types/compat/map/factory.d.ts

@@ -0,0 +1,9 @@
+/** Legacy ZeyOS DOM factory mapped to Zx button and icon primitives. */
+export declare const Factory: Readonly<{
+    /** @param {string} name @returns {SVGSVGElement} */
+    Icon(name: string): SVGSVGElement;
+    /** @param {string} text @param {string} [type=''] @param {string} [iconName] @param {Record<string, any>} [options={}] @returns {HTMLButtonElement} */
+    Button(text: string, type?: string, iconName?: string, options?: Record<string, any>): HTMLButtonElement;
+    /** @param {HTMLButtonElement[]} buttons @returns {HTMLDivElement} */
+    ButtonsGroup(buttons: HTMLButtonElement[]): HTMLDivElement;
+}>;

package/dist/types/compat/map/form.d.ts

@@ -0,0 +1,98 @@
+import { GxWrapper } from '../base.js';
+/** Legacy bootstrap form. */
+export declare class Form extends GxWrapper {
+    _fieldsets: any[];
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Fieldset|Record<string, any>} fieldset @returns {Fieldset} */
+    addFieldset(fieldset: Fieldset | Record<string, any>): Fieldset;
+    /** @param {unknown} content @returns {this} */
+    addActions(content: unknown): this;
+    /** @param {string} id @returns {unknown} */ getValue(id: string): unknown;
+    /** @returns {Record<string, unknown>} */ getValues(): Record<string, unknown>;
+    /** @param {string} id @returns {Field|null} */ getField(id: string): Field | null;
+    /** @returns {Fieldset[]} */ getFieldsets(): Fieldset[];
+    /** @param {string} id @param {unknown} value @returns {this} */ setValue(id: string, value: unknown): this;
+    /** @param {Record<string, unknown>} values @returns {this} */ setValues(values: Record<string, unknown>): this;
+    /** @param {Record<string, unknown>} [highlights={}] @param {string} [type='error'] @returns {number} */ setHighlights(highlights?: Record<string, unknown>, type?: string): number;
+    /** @param {Record<string, unknown>} [highlights={}] @param {string} [type='error'] @returns {number} */ setHintHighlights(highlights?: Record<string, unknown>, type?: string): number;
+    /** @returns {this} */ reset(): this;
+}
+/** Legacy bootstrap fieldset. */
+export declare class Fieldset extends GxWrapper {
+    _fields: {};
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Record<string, any>} fields @returns {this} */ addFields(fields: Record<string, any>): this;
+    /** @param {string} id @param {unknown} field @returns {Field|unknown} */
+    addFieldItem(id: string, field: unknown): Field | unknown;
+    /** @param {string} id @param {string|Function|Element} type @param {Record<string, any>} [options={}] @returns {Field} */
+    addField(id: string, type: string | Function | Element, options?: Record<string, any>): Field;
+    /** @returns {this} */ clear(): this;
+    /** @param {string} id @returns {boolean} */ hasField(id: string): boolean;
+    /** @param {string} id @returns {Field|null} */ getField(id: string): Field | null;
+    /** @returns {Record<string, Field>} */ getFields(): Record<string, Field>;
+    /** @param {string} id @returns {unknown} */ getValue(id: string): unknown;
+    /** @returns {Record<string, unknown>} */ getValues(): Record<string, unknown>;
+    /** @param {string} id @param {unknown} value @returns {this} */ setValue(id: string, value: unknown): this;
+    /** @param {Record<string, unknown>} values @returns {this} */ setValues(values: Record<string, unknown>): this;
+    /** @returns {this} */ reset(): this;
+    /** @param {string} id @returns {this} */ focus(id: string): this;
+    /** @param {Record<string, unknown>} [highlights={}] @param {string} [type='error'] @returns {number} */
+    setHighlights(highlights?: Record<string, unknown>, type?: string): number;
+    /** @param {Record<string, unknown>} [highlights={}] @param {string} [type='error'] @returns {number} */ setHintHighlights(highlights?: Record<string, unknown>, type?: string): number;
+}
+/** Legacy bootstrap single field. */
+export declare class Field extends GxWrapper {
+    _type: any;
+    static legacyName: string;
+    /** @param {Record<string, any>} [options={}] */
+    constructor(options?: Record<string, any>);
+    /** @param {string} label @returns {this} */ setLabel(label: string): this;
+    /** @param {string} help @returns {this} */ setHelp(help: string): this;
+    /** @returns {unknown} */ getValue(): unknown;
+    /** @param {unknown} value @returns {this} */ setValue(value: unknown): this;
+    /** @param {boolean} disabled @returns {this} */ setDisabled(disabled: boolean): this;
+    /** @param {unknown} label @param {string} [type='warning'] @returns {this} */
+    setHighlight(label: unknown, type?: string): this;
+    /** @param {unknown} label @param {string} [type='warning'] @returns {this} */ setHintHighlight(label: unknown, type?: string): this;
+    /** @returns {this} */ reset(): this;
+    /** @returns {this} */ focus(): this;
+}
+/** Legacy bootstrap chip list. */
+export declare class ValueList extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {unknown} value @returns {boolean} */ addValue(value: unknown): boolean;
+    /** @returns {unknown[]} */ getValues(): unknown[];
+    /** @param {unknown[]} values @returns {this} */ setValues(values: unknown[]): this;
+    /** @returns {this} */ enable(): this;
+    /** @returns {this} */ disable(): this;
+    /** @returns {this} */ focus(): this;
+}
+/** Legacy JSON-string multi-value editor. */
+export declare class MultiValueEditor extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @returns {string} */ getValue(): string;
+    /** @param {string|unknown[]} value @returns {this} */ setValue(value: string | unknown[]): this;
+}
+/** Legacy bootstrap upload field. */
+export declare class FieldUpload extends GxWrapper {
+    _value: unknown;
+    static legacyName: string;
+    /** @param {Record<string, any>} [options={}] */
+    constructor(options?: Record<string, any>);
+    /** @param {unknown} source @returns {this} */ setValue(source: unknown): this;
+    /** @returns {null} */ getValue(): null;
+    /** @param {unknown} source @returns {this} */
+    setImage(source: unknown): this;
+    /** @param {boolean} disabled @returns {this} */ setDisabled(disabled: boolean): this;
+    /** @returns {this} */ reset(): this;
+    /** @param {unknown} response @returns {void} */
+    _handleResponse(response: unknown): void;
+}

package/dist/types/compat/map/helpers.d.ts

@@ -0,0 +1,12 @@
+/** @param {Element|string|null|undefined} target @returns {Element|null} */
+export declare function targetElement(target: Element | string | null | undefined): Element | null;
+/** @param {unknown} value @returns {unknown} */
+export declare function legacyContent(value: unknown): unknown;
+/** @param {unknown} value @returns {'info'|'success'|'warning'|'error'} */
+export declare function messageKind(value: unknown): 'info' | 'success' | 'warning' | 'error';
+/** @param {Function} fn @param {string} legacyName @param {string} replacement @returns {void} */
+export declare function warnFunctionOnce(fn: Function, legacyName: string, replacement: string): void;
+/** @param {Function} owner @param {string} method @param {string} replacement @returns {void} */
+export declare function warnMethodOnce(owner: Function, method: string, replacement: string): void;
+/** @param {unknown} value @returns {string} */
+export declare function textLabel(value: unknown): string;

package/dist/types/compat/map/http.d.ts

@@ -0,0 +1,36 @@
+import { Http } from '../../index.js';
+import { GxWrapper } from '../base.js';
+/** Legacy generic HTTP client. */
+export declare class Client extends GxWrapper {
+    _http: Http;
+    static legacyName: string;
+    /** @param {Record<string, any>} [options={}] */
+    constructor(options?: Record<string, any>);
+    /** @param {string} path @param {unknown} data @param {Function|Record<string, Function>} [callback] @param {string} [resulttype] @returns {Promise<unknown>} */
+    post(path: string, data: unknown, callback?: Function | Record<string, Function>, resulttype?: string): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {Function|Record<string, Function>} [callback] @param {string} [resulttype] @returns {Promise<unknown>} */
+    get(path: string, data: unknown, callback?: Function | Record<string, Function>, resulttype?: string): Promise<unknown>;
+    /** @param {unknown} data @param {string} [method='GET'] @param {Function|Record<string, Function>} [callback] @param {string} [resulttype] @param {string} [path=''] @returns {Promise<unknown>} */
+    request(data: unknown, method?: string, callback?: Function | Record<string, Function>, resulttype?: string, path?: string): Promise<unknown>;
+}
+/** Legacy ZeyOS REST request client. */
+export declare class Request extends GxWrapper {
+    _files: File[];
+    baseUrl: string;
+    _http: Http;
+    static legacyName: string;
+    /** @param {Record<string, any>} [options={}] */
+    constructor(options?: Record<string, any>);
+    /** @param {string} service @param {string} [accesskey=''] @returns {this} */
+    setService(service: string, accesskey?: string): this;
+    /** @param {string} path @param {unknown} data @param {Function} [callback] @param {string} [method='GET'] @returns {Promise<unknown>} */
+    send(path: string, data: unknown, callback?: Function, method?: string): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {Function} [callback] @returns {Promise<unknown>} */ post(path: string, data: unknown, callback?: Function): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {Function} [callback] @returns {Promise<unknown>} */ get(path: string, data: unknown, callback?: Function): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {Function} [callback] @returns {Promise<unknown>} */ put(path: string, data: unknown, callback?: Function): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {Function} [callback] @returns {Promise<unknown>} */ delete(path: string, data: unknown, callback?: Function): Promise<unknown>;
+    /** @param {string} path @param {unknown} data @param {File[]|FileList|Element[]} files @param {Function} [callback] @returns {Promise<unknown>} */
+    upload(path: string, data: unknown, files: File[] | FileList | Element[], callback?: Function): Promise<unknown>;
+    /** @param {string} path @returns {Window|null} */ openLink(path: string): Window | null;
+    /** @param {string} error @returns {void} */ showError(error: string): void;
+}

package/dist/types/compat/map/layout.d.ts

@@ -0,0 +1,106 @@
+import { GxWrapper } from '../base.js';
+/** Legacy ZeyOS collapsible groupbox. */
+export declare class Groupbox extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @returns {this} */
+    toggle(): this;
+    /** @returns {this} */
+    open(): this;
+    /** @returns {this} */
+    close(): this;
+    /** @returns {boolean} */
+    isOpen(): boolean;
+    /** @param {string} title @returns {this} */
+    setTitle(title: string): this;
+    /** @returns {void} */
+    _syncAct(): void;
+}
+/** Legacy positional panel wrapper. */
+export declare class Panel extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {string} title @param {unknown} content @param {boolean} [open=true] */
+    constructor(display: Element | string | null, title?: string, content?: unknown, open?: boolean);
+    /** @returns {this} */
+    toggle(): this;
+    /** @returns {this} */
+    open(): this;
+    /** @returns {this} */
+    close(): this;
+    /** @returns {boolean} */
+    isOpen(): boolean;
+    /** @param {unknown} content @returns {this} */
+    setContent(content: unknown): this;
+    /** @param {string} title @returns {this} */
+    setTitle(title: string): this;
+}
+/** Legacy positional master panel wrapper. */
+export declare class MasterPanel extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {string} title @param {unknown} content @param {unknown[]} [buttons=[]] */
+    constructor(display: Element | string | null, title?: string, content?: unknown, buttons?: unknown[]);
+    /** @param {unknown} content @returns {this} */
+    setContent(content: unknown): this;
+    /** @param {string} title @returns {this} */
+    setTitle(title: string): this;
+}
+/** Shared legacy tabbox implementation; subclasses only change warning identity. */
+export declare class Tabbox extends GxWrapper {
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Record<string, any>|string} frame @param {string} [title] @param {unknown} [content] @returns {this} */
+    addTab(frame: Record<string, any> | string, title?: string, content?: unknown): this;
+    /** @param {string} name @returns {this} */
+    closeTab(name: string): this;
+    /** @param {string|number} name @returns {this} */
+    openTab(name: string | number): this;
+    /** @param {string} name @param {string} title @returns {this} */
+    setTabTitle(name: string, title: string): this;
+    /** @param {string} name @param {unknown} content @param {string} [_style] @returns {this} */
+    setHighlight(name: string, content: unknown, _style?: string): this;
+    /** @returns {string|null} */
+    getActive(): string | null;
+    /** @returns {void} */
+    _syncAct(): void;
+}
+/** Bootstrap-flavoured tabbox with the same behavior. */
+export declare class BootstrapTabbox extends Tabbox {
+    static legacyName: string;
+}
+/** Legacy bootstrap navigation bar. */
+export declare class NavigationBar extends GxWrapper {
+    _frames: any[];
+    static legacyName: string;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {Record<string, any>|string} frame @param {string} [title] @param {unknown} [content] @returns {this} */
+    addTab(frame: Record<string, any> | string, title?: string, content?: unknown): this;
+    /** @param {string} name @returns {this} */
+    closeTab(name: string): this;
+    /** @param {string} name @returns {this} */
+    openTab(name: string): this;
+    /** @param {string|Element} title @returns {this} */
+    setTitle(title: string | Element): this;
+    /** @param {string} name @param {string} title @returns {this} */
+    setTabTitle(name: string, title: string): this;
+    /** @param {unknown[]} buttons @returns {this} */
+    setNavigationButtons(buttons: unknown[]): this;
+    /** @param {string} name @param {unknown} content @param {string} [_style] @returns {this} */
+    setHighlight(name: string, content: unknown, _style?: string): this;
+    /** @returns {void} */
+    _rebuild(): void;
+    /** @returns {void} */
+    _syncAct(): void;
+}
+/** Legacy standalone search control. */
+export declare class Search extends GxWrapper {
+    static legacyName: string;
+    /** @param {Record<string, any>} [options={}] */
+    constructor(options?: Record<string, any>);
+    /** @returns {string} */
+    get(): string;
+    /** @param {string} value @returns {this} */
+    set(value: string): this;
+}

package/dist/types/compat/map/options.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Pure option and event translations shared by the gx compatibility wrappers.
+ * Keeping these helpers DOM-free makes the migration contract directly testable in Node.
+ * @module gx-compat-options
+ */
+/** @type {Readonly<Record<string, string>>} */
+export declare const SELECT_OPTION_MAP: Readonly<Record<string, string>>;
+/** @type {Readonly<Record<string, string>>} */
+export declare const CHECKLIST_OPTION_MAP: Readonly<Record<string, string>>;
+/** @type {Readonly<Record<string, string>>} */
+export declare const TABLE_OPTION_MAP: Readonly<Record<string, string>>;
+/** @type {Readonly<Record<string, string>>} */
+export declare const FORM_OPTION_MAP: Readonly<Record<string, string>>;
+/** @type {Readonly<Record<string, string>>} */
+export declare const FIELD_TYPE_MAP: Readonly<Record<string, string>>;
+/**
+ * Renames known keys while retaining unrelated options.
+ * @param {Record<string, any>|null|undefined} source Legacy options.
+ * @param {Readonly<Record<string, string>>} mapping Rename table.
+ * @returns {Record<string, any>} Translated copy.
+ */
+export declare function renameOptions(source: Record<string, any> | null | undefined, mapping: Readonly<Record<string, string>>): Record<string, any>;
+/**
+ * Converts legacy Select options to their Zx equivalents.
+ * @param {Record<string, any>} [options={}] Legacy Select options.
+ * @returns {Record<string, any>} Zx Select options.
+ */
+export declare function translateSelectOptions(options?: Record<string, any>): Record<string, any>;
+/**
+ * Converts legacy Checklist options to Zx Checklist options.
+ * @param {Record<string, any>} [options={}] Legacy Checklist options.
+ * @returns {Record<string, any>} Zx Checklist options.
+ */
+export declare function translateChecklistOptions(options?: Record<string, any>): Record<string, any>;
+/**
+ * Converts the legacy Datebox token array to the kernel format string.
+ * Existing percent-token format strings pass through unchanged.
+ * @param {unknown} format Legacy array or format string.
+ * @returns {string} Kernel date format.
+ */
+export declare function translateDateboxFormat(format: unknown): string;
+/**
+ * Resolves the legacy one-based `show` option to a tab name.
+ * @param {Array<{name?: unknown}>} frames Legacy frame list.
+ * @param {unknown} show Name or one-based numeric index.
+ * @returns {string|null} Resolved name.
+ */
+export declare function resolveTabName(frames: Array<{
+    name?: unknown;
+}>, show: unknown): string | null;
+/**
+ * Converts legacy Tabbox options without normalizing DOM content.
+ * @param {Record<string, any>} [options={}] Legacy Tabbox options.
+ * @returns {{tabs: Array<Record<string, any>>, active: string|null, height: unknown}}
+ */
+export declare function translateTabboxOptions(options?: Record<string, any>): {
+    tabs: Array<Record<string, any>>;
+    active: string | null;
+    height: unknown;
+};
+/**
+ * Converts a legacy table column list and its initial filter state.
+ * A cell adapter can turn legacy cell objects into DOM nodes in browser wrappers.
+ * @param {Record<string, any>} [options={}] Legacy Table options.
+ * @param {(cell: unknown) => unknown} [adaptCell=defaultCellAdapter] Cell adapter.
+ * @returns {Record<string, any>} Zx Table options.
+ */
+export declare function translateTableOptions(options?: Record<string, any>, adaptCell?: (cell: unknown) => unknown): Record<string, any>;
+/**
+ * Converts a legacy field descriptor to Zx Field options.
+ * Component-specific `props` are completed by the browser wrapper.
+ * @param {Record<string, any>} [options={}] Legacy field descriptor.
+ * @returns {Record<string, any>} Zx Field options.
+ */
+export declare function translateFieldOptions(options?: Record<string, any>): Record<string, any>;
+/**
+ * Positional legacy event arguments for the mappings exercised by wrappers.
+ * @type {Readonly<Record<string, (detail: Record<string, any>, wrapper: unknown, event?: Event) => unknown[]>>}
+ */
+export declare const LEGACY_EVENT_ARGS: Readonly<Record<string, (detail: Record<string, any>, wrapper: unknown, event?: Event) => unknown[]>>;

package/dist/types/compat/map/select.d.ts

@@ -0,0 +1,95 @@
+import { GxWrapper } from '../base.js';
+/** Shared Select facade; concrete subclasses choose filtering and warning identity. */
+declare class SelectBase extends GxWrapper {
+    _http: any;
+    data: any;
+    static legacyName: string;
+    /** @type {string|false} */
+    static filterMode: string | false;
+    /** @param {Element|string|null} display @param {Record<string, any>} [options={}] */
+    constructor(display: Element | string | null, options?: Record<string, any>);
+    /** @param {unknown} selection @param {boolean} [noEvents=false] @returns {this} */
+    set(selection: unknown, noEvents?: boolean): this;
+    /** @param {unknown} id @param {boolean} [noEvents=false] @returns {this} */
+    setId(id: unknown, noEvents?: boolean): this;
+    /** @param {unknown} [item] @returns {unknown} */
+    getId(item?: unknown): unknown;
+    /** @returns {unknown} */
+    getValue(): unknown;
+    /** @returns {unknown} */
+    getSelected(): unknown;
+    /** @param {unknown[]} data @returns {this} */
+    setData(data: unknown[]): this;
+    /** @returns {Element[]} */
+    getRows(): Element[];
+    /** @param {boolean} [noEvents=false] @returns {this} */
+    reset(noEvents?: boolean): this;
+    /** @returns {this} */
+    enable(): this;
+    /** @returns {this} */
+    disable(): this;
+    /** @returns {this} */
+    show(): this;
+    /** @returns {this} */
+    hide(): this;
+    /** @returns {boolean} */
+    isOpen(): boolean;
+    /** @returns {this} */
+    search(): this;
+    /** @returns {this} */
+    showLoader(): this;
+    /** @returns {this} */
+    hideLoader(): this;
+    /** @param {string} query @returns {Promise<unknown[]>} */
+    _load(query: string): Promise<unknown[]>;
+    /** @param {string} query @returns {Promise<unknown>} */
+    _loadUrl(query: string): Promise<unknown>;
+    /** @param {string} query @returns {Promise<unknown>} */
+    _loadRest(query: string): Promise<unknown>;
+}
+/** Legacy ZeyOS select. */
+export declare class Select extends SelectBase {
+    static legacyName: string;
+}
+/** Legacy ZeyOS locally filterable select. */
+export declare class SelectFilter extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+/** Legacy ZeyOS HTTP-backed select. */
+export declare class SelectDyn extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+/** Legacy ZeyOS priority select. */
+export declare class SelectPrio extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+/** Legacy bootstrap select. */
+export declare class BootstrapSelect extends SelectBase {
+    static legacyName: string;
+}
+/** Legacy bootstrap locally filterable select. */
+export declare class BootstrapSelectFilter extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+/** Legacy bootstrap HTTP-backed select. */
+export declare class BootstrapSelectDyn extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+/** Legacy bootstrap REST-backed select. */
+export declare class SelectDynREST extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+    /** Loads and selects a REST item by ID when it is not already cached. @param {unknown} id @returns {Promise<void>} */
+    setEntityId(id: unknown): Promise<void>;
+}
+/** Legacy bootstrap priority select. */
+export declare class BootstrapSelectPrio extends SelectBase {
+    static legacyName: string;
+    static filterMode: string;
+}
+export {};

package/dist/types/compat/map/stubs.d.ts

@@ -0,0 +1,32 @@
+/** Direct Settings subclassing is intentionally outside the compatibility contract. */
+export declare const Settings: {
+    new (): {};
+};
+/** Direct Container subclassing is intentionally outside the compatibility contract. */
+export declare const Container: {
+    new (): {};
+};
+/** Legacy collapse animation stub. */
+export declare const Collapse: {
+    new (): {};
+};
+/** Legacy blend animation stub. */
+export declare const Blend: {
+    new (): {};
+};
+/** Legacy HUD stub. */
+export declare const Hud: {
+    new (): {};
+};
+/** Legacy toggling helper stub. */
+export declare const Toggling: {
+    new (): {};
+};
+/** Legacy horizontal group stub. */
+export declare const HGroup: {
+    new (): {};
+};
+/** Legacy templates stub. */
+export declare const Templates: {
+    new (): {};
+};

package/dist/types/compat/map/utilities.d.ts

@@ -0,0 +1,37 @@
+import { parse } from '../globals.js';
+/** Legacy utility namespace backed by dependency-free implementations. */
+export declare const util: Readonly<{
+    initValue: typeof initValue;
+    initNum: typeof initNum;
+    formatTime: typeof formatTime;
+    getMinutes: typeof getMinutes;
+    formatNum: typeof formatNum;
+    getNumber: typeof getNumber;
+    printf: typeof printf;
+    parseResult: typeof parseResult;
+    Parse: typeof parse;
+    isArray: (arg: any) => arg is any[];
+    isObject: (value: any) => boolean;
+    isFunction: (value: any) => boolean;
+    isString: (value: any) => value is string;
+    isNumber: (value: any) => boolean;
+    isElement: (value: any) => boolean;
+    isNode: (value: any) => boolean;
+    Console: (source: any, message: any) => void;
+}>;
+/** @param {Record<string, unknown>} object @param {string} key @param {unknown} fallback @returns {unknown} */
+export declare function initValue(object: Record<string, unknown>, key: string, fallback: unknown): unknown;
+/** @param {unknown} value @returns {number} */
+export declare function initNum(value: unknown): number;
+/** @param {unknown} value @returns {string} */
+export declare function formatTime(value: unknown): string;
+/** @param {unknown} value @returns {number} */
+export declare function getMinutes(value: unknown): number;
+/** @param {unknown} value @param {string} [decimal='.'] @param {string} [thousands=','] @param {number} [decimals=2] @returns {string} */
+export declare function formatNum(value: unknown, decimal?: string, thousands?: string, decimals?: number): string;
+/** @param {unknown} value @param {string} [decimal=','] @returns {number} */
+export declare function getNumber(value: unknown, decimal?: string): number;
+/** @param {unknown} template @param {unknown|unknown[]} [values=[]] @returns {string} */
+export declare function printf(template: unknown, values?: unknown | unknown[]): string;
+/** @param {unknown} response @returns {unknown} */
+export declare function parseResult(response: unknown): unknown;

package/dist/types/compat-entry.d.ts

@@ -0,0 +1,5 @@
+/** Browser entry point for the gx compatibility bundle. */
+import * as zx from './index.js';
+import gx from './compat/index.js';
+export { gx, zx };
+export default gx;

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

@@ -0,0 +1,46 @@
+export type BadgeOptions = {
+    /**
+     * Visible badge text.
+     */
+    label?: string;
+    /**
+     * Icon name from `icons.js`, rendered before the label.
+     */
+    icon?: string | null;
+    /**
+     * Semantic intent.
+     */
+    kind?: 'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info';
+    /**
+     * Fill treatment.
+     */
+    variant?: 'soft' | 'solid' | 'outline';
+    /**
+     * Badge size.
+     */
+    size?: 'md' | 'sm';
+    /**
+     * Renders a small leading status dot instead of an icon.
+     */
+    dot?: boolean;
+    /**
+     * Native title text; also names an icon-only or dot-only badge.
+     */
+    title?: string;
+};
+/**
+ * Creates a status pill: a small, non-interactive label carrying a semantic colour.
+ *
+ * The badge is plain text content, so it needs no ARIA of its own. A badge without a label but
+ * with a `title` is named for assistive technology through `role="img"`.
+ *
+ * @param {BadgeOptions} [opts={}] Badge options.
+ * @returns {HTMLSpanElement}
+ */
+export declare function badge(opts?: BadgeOptions): HTMLSpanElement;
+/**
+ * Groups badges into a wrapping row.
+ * @param {HTMLSpanElement[]} badges Badges to group.
+ * @returns {HTMLSpanElement}
+ */
+export declare function badgeGroup(badges: HTMLSpanElement[]): HTMLSpanElement;