@zeyos/zx 4.1.0 → 4.2.0

package/dist/types/components/view/record-view.d.ts

@@ -0,0 +1,464 @@
+import { Component } from '../../core/component.js';
+export type ViewRecord = Record<string, any>;
+export type ViewSortDirection = 'asc' | 'desc';
+export type ViewSelectionMode = false | 'single' | 'multi';
+export type ViewField = {
+    /**
+     * Stable field identifier and default record property.
+     */
+    id: string;
+    /**
+     * Human-readable field label.
+     */
+    label: string;
+    /**
+     * Value accessor.
+     */
+    get?: (record: ViewRecord, index: number) => unknown;
+    /**
+     * Text-safe renderer. A returned Node is adopted; every other value is inserted as text.
+     */
+    render?: (record: ViewRecord, index: number, value: unknown) => Node | string | number | null | undefined;
+    /**
+     * Local sort accessor.
+     */
+    sortValue?: (record: ViewRecord, index: number) => unknown;
+    /**
+     * Whether the field may become the active sort.
+     */
+    sortable?: boolean;
+    /**
+     * Initial visibility when `hiddenFields` does not name the field.
+     */
+    visible?: boolean;
+    /**
+     * Semantic display type available to concrete views.
+     */
+    type?: string;
+    /**
+     * Whether title/subtitle fields also appear in metadata.
+     */
+    duplicate?: boolean;
+    /**
+     * Table-oriented width hint.
+     */
+    width?: string;
+    /**
+     * Alignment hint.
+     */
+    align?: 'start' | 'center' | 'end' | 'left' | 'right';
+    /**
+     * View-specific descriptor values.
+     */
+    view?: Record<string, unknown>;
+};
+export type ViewSort = {
+    /**
+     * Field id.
+     */
+    id: string;
+    /**
+     * Sort direction.
+     */
+    dir: ViewSortDirection;
+};
+export type RecordViewState = {
+    /**
+     * State schema version.
+     */
+    version: 1;
+    /**
+     * Complete reconciled field order.
+     */
+    fieldOrder: string[];
+    /**
+     * Hidden field ids.
+     */
+    hiddenFields: string[];
+    /**
+     * Active sort.
+     */
+    sort: ViewSort | null;
+};
+export type RecordViewOptions = {
+    /**
+     * Shared ordered field descriptors.
+     */
+    fields?: ViewField[];
+    /**
+     * Initial records.
+     */
+    data?: ViewRecord[];
+    /**
+     * Record id accessor.
+     */
+    recordId?: string | ((record: ViewRecord) => unknown);
+    /**
+     * Initial sort.
+     */
+    sort?: ViewSort | null;
+    /**
+     * Whether Zx reorders local records.
+     */
+    sortMode?: 'local' | 'server';
+    /**
+     * Record selection behavior.
+     */
+    selectable?: ViewSelectionMode;
+    /**
+     * Initially selected record ids.
+     */
+    selection?: unknown[];
+    /**
+     * Field ids in preferred order.
+     */
+    fieldOrder?: string[];
+    /**
+     * Initially hidden field ids.
+     */
+    hiddenFields?: string[];
+    /**
+     * Whether concrete views show the shared field chooser.
+     */
+    fieldControls?: boolean;
+    /**
+     * Empty-result content.
+     */
+    emptyText?: string | Node | (() => string | Node) | null;
+    onrecordclick?: (event: CustomEvent<Record<string, unknown>>) => void;
+    onrecorddblclick?: (event: CustomEvent<Record<string, unknown>>) => void;
+    ondatachange?: (event: CustomEvent<{
+        records: ViewRecord[];
+    }>) => void;
+    onselectionchange?: (event: CustomEvent<{
+        records: ViewRecord[];
+        ids: unknown[];
+    }>) => void;
+    onsortchange?: (event: CustomEvent<{
+        id: string | null;
+        dir: ViewSortDirection | null;
+    }>) => void;
+    onfieldvisibilitychange?: (event: CustomEvent<{
+        visible: string[];
+        hidden: string[];
+    }>) => void;
+    onfieldorderchange?: (event: CustomEvent<{
+        order: string[];
+    }>) => void;
+    onstatechange?: (event: CustomEvent<{
+        state: RecordViewState;
+        reason: string;
+    }>) => void;
+};
+/** @typedef {Record<string, any>} ViewRecord */
+/** @typedef {'asc'|'desc'} ViewSortDirection */
+/** @typedef {false|'single'|'multi'} ViewSelectionMode */
+/**
+ * @typedef {Object} ViewField
+ * @property {string} id Stable field identifier and default record property.
+ * @property {string} label Human-readable field label.
+ * @property {(record: ViewRecord, index: number) => unknown} [get] Value accessor.
+ * @property {(record: ViewRecord, index: number, value: unknown) => Node|string|number|null|undefined} [render]
+ * Text-safe renderer. A returned Node is adopted; every other value is inserted as text.
+ * @property {(record: ViewRecord, index: number) => unknown} [sortValue] Local sort accessor.
+ * @property {boolean} [sortable=false] Whether the field may become the active sort.
+ * @property {boolean} [visible=true] Initial visibility when `hiddenFields` does not name the field.
+ * @property {string} [type='text'] Semantic display type available to concrete views.
+ * @property {boolean} [duplicate=false] Whether title/subtitle fields also appear in metadata.
+ * @property {string} [width] Table-oriented width hint.
+ * @property {'start'|'center'|'end'|'left'|'right'} [align] Alignment hint.
+ * @property {Record<string, unknown>} [view] View-specific descriptor values.
+ */
+/**
+ * @typedef {Object} ViewSort
+ * @property {string} id Field id.
+ * @property {ViewSortDirection} dir Sort direction.
+ */
+/**
+ * @typedef {Object} RecordViewState
+ * @property {1} version State schema version.
+ * @property {string[]} fieldOrder Complete reconciled field order.
+ * @property {string[]} hiddenFields Hidden field ids.
+ * @property {ViewSort|null} sort Active sort.
+ */
+/**
+ * @typedef {Object} RecordViewOptions
+ * @property {ViewField[]} [fields=[]] Shared ordered field descriptors.
+ * @property {ViewRecord[]} [data=[]] Initial records.
+ * @property {string|((record: ViewRecord) => unknown)} [recordId='ID'] Record id accessor.
+ * @property {ViewSort|null} [sort=null] Initial sort.
+ * @property {'local'|'server'} [sortMode='local'] Whether Zx reorders local records.
+ * @property {ViewSelectionMode} [selectable=false] Record selection behavior.
+ * @property {unknown[]} [selection=[]] Initially selected record ids.
+ * @property {string[]} [fieldOrder=[]] Field ids in preferred order.
+ * @property {string[]} [hiddenFields=[]] Initially hidden field ids.
+ * @property {boolean} [fieldControls=true] Whether concrete views show the shared field chooser.
+ * @property {string|Node|(() => string|Node)|null} [emptyText=null] Empty-result content.
+ * @property {(event: CustomEvent<Record<string, unknown>>) => void} [onrecordclick]
+ * @property {(event: CustomEvent<Record<string, unknown>>) => void} [onrecorddblclick]
+ * @property {(event: CustomEvent<{records:ViewRecord[]}>) => void} [ondatachange]
+ * @property {(event: CustomEvent<{records:ViewRecord[],ids:unknown[]}>) => void} [onselectionchange]
+ * @property {(event: CustomEvent<{id:string|null,dir:ViewSortDirection|null}>) => void} [onsortchange]
+ * @property {(event: CustomEvent<{visible:string[],hidden:string[]}>) => void} [onfieldvisibilitychange]
+ * @property {(event: CustomEvent<{order:string[]}>) => void} [onfieldorderchange]
+ * @property {(event: CustomEvent<{state:RecordViewState,reason:string}>) => void} [onstatechange]
+ */
+/**
+ * Presentation-neutral state and controls shared by record collection views. Concrete view classes
+ * initialize this base from their `render()` method and implement `_refreshView()`.
+ * @fires RecordView#datachange
+ * @fires RecordView#selectionchange
+ * @fires RecordView#sortchange
+ * @fires RecordView#fieldvisibilitychange
+ * @fires RecordView#fieldorderchange
+ * @fires RecordView#statechange
+ * @extends {Component<RecordViewOptions>}
+ */
+export declare class RecordView extends Component<RecordViewOptions> {
+    _recordViewOriginal: import("../../core/dom.js").TargetSnapshot;
+    _recordViewDestroyed: boolean;
+    _viewFields: ViewField[];
+    _viewFieldOrder: string[];
+    _viewHidden: Set<string>;
+    _viewData: ViewRecord[];
+    _viewSort: ViewSort;
+    _viewSelected: any;
+    _viewSelectionAnchor: unknown;
+    _viewFieldControls: HTMLElement;
+    _viewFieldList: HTMLElement;
+    _viewInitialized: boolean;
+    static cssName: string;
+    /** @type {Readonly<RecordViewOptions>} */
+    static defaults: Readonly<RecordViewOptions>;
+    /**
+     * Creates the abstract base as a minimal record view. Concrete views normally call this through
+     * their own explicitly typed constructors.
+     * @param {Element|string|null} [target=null] Existing root, selector, or null.
+     * @param {RecordViewOptions} [options={}] Shared view options.
+     */
+    constructor(target?: Element | string | null, options?: RecordViewOptions);
+    /** @returns {HTMLElement} Minimal base root. */
+    render(): HTMLElement;
+    /** Cleans up a directly instantiated base view and restores an enhanced target. @returns {void} */
+    destroy(): void;
+    /**
+     * Initializes shared state during a concrete view's `render()` call.
+     * @protected
+     * @param {HTMLElement} root Concrete view root.
+     * @returns {void}
+     */
+    protected _initRecordView(root: HTMLElement): void;
+    /**
+     * Replaces every record and clears selections whose ids disappeared.
+     * @param {ViewRecord[]} records New records.
+     * @returns {this}
+     */
+    setData(records: ViewRecord[]): this;
+    /**
+     * Appends records without mutating the supplied array.
+     * @param {ViewRecord[]} records Records to append.
+     * @returns {this}
+     */
+    addData(records: ViewRecord[]): this;
+    /**
+     * Replaces the record currently identified by `id`.
+     * @param {unknown} id Existing record id.
+     * @param {ViewRecord} record Replacement record.
+     * @returns {this}
+     */
+    updateRecord(id: unknown, record: ViewRecord): this;
+    /**
+     * Removes one record by id.
+     * @param {unknown} id Record id.
+     * @returns {this}
+     */
+    removeRecord(id: unknown): this;
+    /** Returns a record by id. @param {unknown} id Record id. @returns {ViewRecord|null} */
+    getRecord(id: unknown): ViewRecord | null;
+    /** Returns a shallow copy in current display order. @returns {ViewRecord[]} */
+    getData(): ViewRecord[];
+    /**
+     * Replaces field descriptors while reconciling order, visibility, and sort by stable id.
+     * @param {ViewField[]} fields Next fields.
+     * @returns {this}
+     */
+    setFields(fields: ViewField[]): this;
+    /** Returns cloned field descriptors in configured order. @returns {ViewField[]} */
+    getFields(): ViewField[];
+    /** Returns visible cloned descriptors in configured order. @returns {ViewField[]} */
+    getVisibleFields(): ViewField[];
+    /** Returns hidden field ids in configured order. @returns {string[]} */
+    getHiddenFields(): string[];
+    /** Returns the complete field id order. @returns {string[]} */
+    getFieldOrder(): string[];
+    /**
+     * Shows or hides one field. The final visible field cannot be hidden.
+     * @param {string} id Field id.
+     * @param {boolean} [visible=true] Desired visibility.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setFieldVisible(id: string, visible?: boolean, options?: {
+        silent?: boolean;
+    }): this;
+    /** Toggles one field. @param {string} id Field id. @param {{silent?:boolean}} [options={}] @returns {this} */
+    toggleField(id: string, options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Moves one field relative to another.
+     * @param {string} id Moving field id.
+     * @param {string} targetId Target field id.
+     * @param {'before'|'after'} [position='before'] Target edge.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    moveField(id: string, targetId: string, position?: 'before' | 'after', options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Reconciles a preferred field order with every current field.
+     * @param {string[]} order Preferred ids.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setFieldOrder(order: string[], options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Changes or clears the active sort.
+     * @param {string|null} id Sort field, or null to clear.
+     * @param {ViewSortDirection} [dir='asc'] Direction.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setSort(id: string | null, dir?: ViewSortDirection, options?: {
+        silent?: boolean;
+    }): this;
+    /** Returns a copy of the active sort. @returns {ViewSort|null} */
+    getSort(): ViewSort | null;
+    /** Returns selected records in display order. @returns {ViewRecord[]} */
+    getSelection(): ViewRecord[];
+    /** Returns selected record ids in display order. @returns {unknown[]} */
+    getSelectionIds(): unknown[];
+    /**
+     * Replaces selection from record ids.
+     * @param {unknown[]} ids Record ids.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setSelection(ids: unknown[], options?: {
+        silent?: boolean;
+    }): this;
+    /** Clears selection. @param {{silent?:boolean}} [options={}] @returns {this} */
+    clearSelection(options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Toggles a record selection, with optional multi-select range behavior.
+     * @param {unknown} id Record id.
+     * @param {{selected?:boolean,range?:boolean}} [options={}] Toggle behavior.
+     * @returns {this}
+     */
+    toggleSelection(id: unknown, options?: {
+        selected?: boolean;
+        range?: boolean;
+    }): this;
+    /**
+     * Marks the whole view busy without imposing a loading presentation.
+     * @param {boolean} [loading=true] Busy state.
+     * @returns {this}
+     */
+    setLoading(loading?: boolean): this;
+    /** Returns JSON-safe, persistence-neutral view configuration. @returns {RecordViewState} */
+    getViewState(): RecordViewState;
+    /**
+     * Restores common configuration. Unknown fields are ignored and newly introduced fields append.
+     * @param {Partial<RecordViewState>|null} state Saved state.
+     * @param {{silent?:boolean}} [options={}] Event behavior.
+     * @returns {this}
+     */
+    setViewState(state: Partial<RecordViewState> | null, options?: {
+        silent?: boolean;
+    }): this;
+    /**
+     * Builds the shared show/hide and ordering disclosure for a concrete view toolbar.
+     * @protected
+     * @param {string} [label='Fields'] Trigger label.
+     * @returns {HTMLElement} Disclosure element.
+     */
+    protected _createViewFieldControls(label?: string): HTMLElement;
+    /** Concrete renderers override this hook. @protected @param {string} _reason Refresh reason. @returns {void} */
+    protected _refreshView(_reason: string): void;
+    /** Reads one record's stable id. @protected @param {ViewRecord} record Record. @returns {unknown} */
+    protected _viewRecordId(record: ViewRecord): unknown;
+    /** Returns whether a record is selected. @protected @param {unknown} id Record id. @returns {boolean} */
+    protected _isViewSelected(id: unknown): boolean;
+    /** Sorts the internal record copy. @private @returns {void} */
+    private _sortViewData;
+    /** @private @param {unknown[]} selection @returns {void} */
+    private _setInitialSelection;
+    /** @private @returns {boolean} */
+    private _pruneViewSelection;
+    /** @private @returns {void} */
+    private _emitViewSelection;
+    /** @private @param {string} reason @returns {void} */
+    private _emitViewState;
+    /** @private @param {string|null} [focusId=null] @returns {void} */
+    private _renderViewFieldControls;
+}
+/**
+ * Validates and clones field descriptors.
+ * @param {ViewField[]} fields Fields.
+ * @returns {ViewField[]} Normalized fields.
+ */
+export declare function normalizeViewFields(fields: ViewField[]): ViewField[];
+/**
+ * Reconciles a partial or stale order with all current fields.
+ * @param {ViewField[]} fields Current fields.
+ * @param {unknown} order Preferred ids.
+ * @returns {string[]} Complete order.
+ */
+export declare function reconcileFieldOrder(fields: ViewField[], order: unknown): string[];
+/**
+ * Moves one id in an immutable order.
+ * @param {string[]} order Current order.
+ * @param {string} id Moving id.
+ * @param {string} targetId Target id.
+ * @param {'before'|'after'} [position='before'] Target edge.
+ * @returns {string[]} Next order, or an unchanged copy for invalid moves.
+ */
+export declare function moveViewField(order: string[], id: string, targetId: string, position?: 'before' | 'after'): string[];
+/**
+ * Reads one field through its accessor or record property.
+ * @param {ViewField} field Field.
+ * @param {ViewRecord} record Record.
+ * @param {number} [index=0] Display index.
+ * @returns {unknown} Field value.
+ */
+export declare function readViewField(field: ViewField, record: ViewRecord, index?: number): unknown;
+/**
+ * Resolves display content without parsing HTML.
+ * @param {ViewField} field Field.
+ * @param {ViewRecord} record Record.
+ * @param {number} [index=0] Display index.
+ * @returns {Node|string|number|null|undefined} Rendered content.
+ */
+export declare function renderViewField(field: ViewField, record: ViewRecord, index?: number): Node | string | number | null | undefined;
+/**
+ * Stably sorts a cloned record array by one shared field descriptor.
+ * @param {ViewRecord[]} records Records.
+ * @param {ViewField[]} fields Fields.
+ * @param {ViewSort|null} sort Sort.
+ * @returns {ViewRecord[]} Sorted copy.
+ */
+export declare function sortViewRecords(records: ViewRecord[], fields: ViewField[], sort: ViewSort | null): ViewRecord[];
+/**
+ * Normalizes saved common state against current fields.
+ * @param {Partial<RecordViewState>|null|undefined} state Saved state.
+ * @param {ViewField[]} fields Current normalized fields.
+ * @returns {RecordViewState} Reconciled state.
+ */
+export declare function normalizeViewState(state: Partial<RecordViewState> | null | undefined, fields: ViewField[]): RecordViewState;
+/** Reads a stable record id. @param {ViewRecord} record @param {string|((record:ViewRecord)=>unknown)} accessor @returns {unknown} */
+export declare function viewRecordId(record: ViewRecord, accessor: string | ((record: ViewRecord) => unknown)): unknown;

package/dist/types/index.d.ts

@@ -38,6 +38,7 @@ 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 { Aurora } from './components/aurora/aurora.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';
@@ -76,7 +77,13 @@ export { Datebox, DateTimeBox } from './components/datebox/datebox.js';
 export { DateRangePicker, clampRange, defaultDateRangePresets, normalizeRange, rangeNights, rangeStateOf } from './components/date-picker/date-range-picker.js';
 export { DateRangeBox, formatRangeText, parseRangeText } from './components/datebox/date-range-box.js';
 export { Timebox, splitTime, joinTime } from './components/timebox/timebox.js';
+export { Calendar } from './components/calendar/calendar.js';
+export { CALENDAR_VIEWS, addCalendarDays, calendarDayDifference, calendarDayKey, calendarEventIntersects, calendarEventSpansDays, calendarRange, cloneCalendarEvent, layoutCalendarSpans, layoutTimedCalendarEvents, normalizeCalendarEvents, shiftCalendarEvent, startOfCalendarDay, startOfCalendarWeek } from './components/calendar/calendar-model.js';
+export { RecordView, normalizeViewFields, reconcileFieldOrder, moveViewField, readViewField, renderViewField, sortViewRecords, normalizeViewState, viewRecordId } from './components/view/record-view.js';
 export { Table, reorderTableRows } from './components/table/table.js';
+export { TableView } from './components/table-view/table-view.js';
+export { CardView } from './components/card-view/card-view.js';
+export { KanbanView } from './components/kanban-view/kanban-view.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';

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

@@ -0,0 +1,91 @@
+import { Calendar } from '../index.js';
+export type ZeyosCalendarOptions = {
+    /**
+     * Current ZeyOS appointment/event occurrences.
+     */
+    appointments?: Record<string, any>[];
+    /**
+     * Already-normalized generic Calendar records.
+     */
+    events?: Record<string, any>[];
+    /**
+     * Calendar anchor.
+     */
+    date?: string | number | Date | null;
+    /**
+     * Initial view.
+     */
+    view?: 'agenda' | 'day' | 'week' | 'month' | 'year';
+    /**
+     * Apply move/resize proposals locally before persistence.
+     */
+    optimistic?: boolean;
+    /**
+     * Enable moving and resizing.
+     */
+    editable?: boolean;
+    /**
+     * User-preferred first weekday.
+     */
+    weekStart?: number;
+    /**
+     * Show five days in week view.
+     */
+    workweek?: boolean;
+    /**
+     * Persistence listener.
+     */
+    oneventchange?: (event: CustomEvent<Record<string, any>>) => void;
+};
+/**
+ * @typedef {Object} ZeyosCalendarOptions
+ * @property {Record<string, any>[]} [appointments=[]] Current ZeyOS appointment/event occurrences.
+ * @property {Record<string, any>[]} [events] Already-normalized generic Calendar records.
+ * @property {string|number|Date|null} [date] Calendar anchor.
+ * @property {'agenda'|'day'|'week'|'month'|'year'} [view='month'] Initial view.
+ * @property {boolean} [optimistic=true] Apply move/resize proposals locally before persistence.
+ * @property {boolean} [editable=false] Enable moving and resizing.
+ * @property {number} [weekStart=1] User-preferred first weekday.
+ * @property {boolean} [workweek=false] Show five days in week view.
+ * @property {(event: CustomEvent<Record<string, any>>) => void} [oneventchange] Persistence listener.
+ */
+/**
+ * Maps one expanded ZeyOS appointment/event row to the product-neutral Calendar shape. Occurrence
+ * identity includes the start timestamp because recurring rows intentionally share their base ID;
+ * persistence callers keep using `event.data.ID`.
+ * @param {Record<string, any>} record ZeyOS row.
+ * @returns {Record<string, any>} Generic Calendar event.
+ */
+export declare function zeyosAppointmentToEvent(record: Record<string, any>): Record<string, any>;
+/** @param {Record<string, any>[]} records @returns {Record<string, any>[]} */
+export declare function zeyosAppointmentsToEvents(records: Record<string, any>[]): Record<string, any>[];
+/**
+ * Converts a proposed Calendar occurrence back to the current ZeyOS appointment update fields.
+ * The base appointment identifier remains the source record's `ID`; date values become Unix
+ * seconds and the adapter never adds recurrence or DAV fields.
+ * @param {{start: Date, end: Date, data?: Record<string, any>}} event Calendar event proposal.
+ * @returns {{ID?: unknown, datefrom: number|null, dateto: number|null}}
+ */
+export declare function calendarEventToZeyosPatch(event: {
+    start: Date;
+    end: Date;
+    data?: Record<string, any>;
+}): {
+    ID?: unknown;
+    datefrom: number | null;
+    dateto: number | null;
+};
+/**
+ * Builds Calendar options while preserving every explicit generic option. `appointments` is
+ * mapped only when present; callers may instead pass already-normalized `events`.
+ * @param {ZeyosCalendarOptions & Record<string, any>} [options={}] ZeyOS and Calendar options.
+ * @returns {Record<string, any>} Plain Calendar options.
+ */
+export declare function buildZeyosCalendarOptions(options?: ZeyosCalendarOptions & Record<string, any>): Record<string, any>;
+/**
+ * Creates a Calendar that accepts current ZeyOS appointment/event occurrences directly.
+ * @param {Element|string|null} target Existing target or null.
+ * @param {ZeyosCalendarOptions & Record<string, any>} [options={}] Adapter and Calendar options.
+ * @returns {Calendar}
+ */
+export declare function zeyosCalendar(target: Element | string | null, options?: ZeyosCalendarOptions & Record<string, any>): Calendar;

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

@@ -87,6 +87,18 @@ export type ModuleChipOptions = {
      * Override the module colour for a server-defined fork or weblet.
      */
     color?: string;
+    /**
+     * Optional corner badge.
+     */
+    badge?: string | number | null;
+    /**
+     * Whether the application identity is selected.
+     */
+    selected?: boolean;
+    /**
+     * AppIcon vessel geometry.
+     */
+    shape?: 'tile' | 'circle';
     /**
      * AppIcon material treatment.
      */
@@ -105,20 +117,24 @@ export type ModuleChipOptions = {
  * @property {boolean} [standard=false] Use the stock Font Awesome fallback glyph.
  * @property {string|Node|(()=>string|Node)|null} [icon] Explicit glyph override, useful for an offline fallback.
  * @property {string} [color] Override the module colour for a server-defined fork or weblet.
+ * @property {string|number|null} [badge=null] Optional corner badge.
+ * @property {boolean} [selected=false] Whether the application identity is selected.
+ * @property {'tile'|'circle'} [shape='tile'] AppIcon vessel geometry.
  * @property {false|'subtle'|'strong'} [glass='subtle'] AppIcon material treatment.
  * @property {string|string[]} [class] Extra class names.
  */
 /**
  * Creates a module's icon chip: the glyph on the module's identity colour, the way ZeyOS draws
- * module icons in navigation and record headers. The glyph colour is whichever of ZeyOS's two
- * foregrounds contrasts better with the background.
+ * module icons in navigation and record headers. AppIcon identity glyphs stay white across every
+ * module colour; material shading preserves their silhouette on light colours.
  * @param {string} name Module, entity, or resource name.
  * @param {ModuleChipOptions} [options={}] Display and accessibility options.
  * @returns {HTMLElement} A `<span class="zx-module-icon">` wrapping the glyph.
  */
 export declare function moduleChip(name: string, options?: ModuleChipOptions): HTMLElement;
 /**
- * Creates the public ZeyOS AppIcon preset for any module, entity, fork, or weblet identity.
+ * Creates the public ZeyOS application-identity preset for any module, fork, or weblet. It uses
+ * the circular application vessel by default; use `moduleChip()` for compact entity/record tiles.
  * @param {string} name Module/entity identifier.
  * @param {ModuleChipOptions} [options={}] AppIcon options.
  * @returns {HTMLElement}

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

@@ -11,3 +11,7 @@ export { ZEYOS_LAUNCHER_APPLICATIONS, buildZeyosLauncherConfig, zeyosLauncher, n
 export { zeyosSelect, buildZeyosSelectConfig, zeyosEntitySelect, buildZeyosEntitySelectConfig } from './select.js';
 export { zeyosForm } from './form.js';
 export { zeyosTable } from './table.js';
+export { buildZeyosCalendarOptions, calendarEventToZeyosPatch, zeyosAppointmentToEvent, zeyosAppointmentsToEvents, zeyosCalendar } from './calendar.js';
+export { buildZeyosViewConfig, zeyosView } from './view.js';
+export { SAVED_VIEWS_VERSION, SavedViewDuplicateNameError, SavedViewRegistry, SavedViewScopeMismatchError, createSavedViewRegistry, migrateSavedViewDocument, normalizeSavedViewDocument, normalizeSavedViewScope } from './saved-views.js';
+export { createLegacySavedViewTransport, legacySavedViewRequest } from './legacy-saved-views.js';