@zeyos/zx 4.3.4 → 5.0.0

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

@@ -22,6 +22,19 @@ export type ResolveFieldOptions = {
      * Per-field label overrides.
      */
     labels?: Record<string, string>;
+    /**
+     * Per-field semantic format overrides (`date`,
+     * `datetime`, `money`, or any registered key). The schema types a timestamp only by its storage,
+     * so this is how a Unix-second field the built-in rules misread is declared a calendar day
+     * (`date`) or an instant (`datetime`).
+     */
+    formats?: Record<string, string>;
+    /**
+     * IANA time zone of the ZeyOS instance, such as `Europe/Vienna`.
+     * Date-only fields store midnight of a calendar day in this zone; it is copied onto every field's
+     * metadata as `timeZone`. Defaults to the runtime's own zone.
+     */
+    timeZone?: string;
 };
 /** @typedef {Record<string, unknown>} FieldMeta */
 /**
@@ -34,6 +47,13 @@ export type ResolveFieldOptions = {
  * @property {string[]} [fields] Curated allow-list; its order becomes the output order.
  * @property {string[]} [exclude] Field ids to omit.
  * @property {Record<string, string>} [labels] Per-field label overrides.
+ * @property {Record<string, string>} [formats] Per-field semantic format overrides (`date`,
+ * `datetime`, `money`, or any registered key). The schema types a timestamp only by its storage,
+ * so this is how a Unix-second field the built-in rules misread is declared a calendar day
+ * (`date`) or an instant (`datetime`).
+ * @property {string} [timeZone] IANA time zone of the ZeyOS instance, such as `Europe/Vienna`.
+ * Date-only fields store midnight of a calendar day in this zone; it is copied onto every field's
+ * metadata as `timeZone`. Defaults to the runtime's own zone.
  */
 /**
  * Extensible ZeyOS semantic/DB type registry. Keys are normalized to lowercase. Built-in choices:
@@ -61,7 +81,8 @@ export declare function fieldToZxField(meta: FieldMeta): Record<string, unknown>
 /**
  * Converts normalized ZeyOS field metadata to a Zx Table column configuration. Renderers return
  * strings only (never DOM): references/enums show labels, numeric columns are right-aligned,
- * booleans show a check, and Unix seconds are formatted as dates.
+ * booleans show a check, and Unix seconds are formatted as dates — a date-only field as the
+ * calendar day it names in `meta.timeZone`, with no time; a date-time field with its time.
  * @param {FieldMeta} meta Normalized metadata containing at least `id` or `name`.
  * @returns {Record<string, unknown>} Plain Zx Table column descriptor.
  */
@@ -71,6 +92,8 @@ export declare function fieldToZxColumn(meta: FieldMeta): Record<string, unknown
  * client returns names from `schema.fields(resource)` and definitions from
  * `schema.describe(resource).fields`; embedded `enum` data is authoritative. A compatible
  * `schema.enums(resource, field)` is used when supplied by another client version/stub.
+ * `formats` overrides a field's semantic `format`, and `timeZone` is validated once and copied
+ * onto every field.
  * @param {Record<string, any>} client Injected `@zeyos/client` instance.
  * @param {string} resource Schema resource name such as `tickets`.
  * @param {ResolveFieldOptions} [opts={}] Curation options.

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

@@ -1,4 +1,5 @@
 import { Table } from '../index.js';
+export type TableOptions = import('../components/table/table.js').TableOptions;
 export type ZeyosTableOptions = {
     /**
      * Curated ordered field allow-list.
@@ -8,6 +9,16 @@ export type ZeyosTableOptions = {
      * Per-field label overrides.
      */
     labels?: Record<string, string>;
+    /**
+     * Per-field semantic format overrides, such as
+     * `{ duedate: 'date' }` for a Unix-second field that holds a calendar day.
+     */
+    formats?: Record<string, string>;
+    /**
+     * IANA time zone of the ZeyOS instance. Date-only columns show the
+     * calendar day their stored midnight names in this zone; defaults to the runtime's own zone.
+     */
+    timeZone?: string;
     /**
      * Row id accessor.
      */
@@ -43,6 +54,91 @@ export type ZeyosTableOptions = {
      * Row activation callback.
      */
     onRowClick?: (row: Record<string, unknown>, event: CustomEvent<Record<string, unknown>>) => void;
+    /**
+     * Table frame treatment; `'plain'` for a
+     * table inside a pane or card that already draws the box.
+     */
+    variant?: TableOptions['variant'];
+    /**
+     * Whether alternate rows use the zebra background.
+     */
+    zebra?: boolean;
+    /**
+     * Whether column headers stick while scrolling.
+     */
+    stickyHeader?: boolean;
+    /**
+     * Width below which rows stack.
+     */
+    responsive?: TableOptions['responsive'];
+    /**
+     * Rows rendered at first from a loaded page.
+     */
+    growing?: TableOptions['growing'];
+    /**
+     * What the table shows with no rows.
+     */
+    emptyText?: TableOptions['emptyText'];
+    /**
+     * Additional row class callback.
+     */
+    rowClass?: TableOptions['rowClass'];
+    /**
+     * Row property or callback naming each row's kind.
+     */
+    rowKind?: TableOptions['rowKind'];
+    /**
+     * Presentation per row kind.
+     */
+    rowKinds?: TableOptions['rowKinds'];
+    /**
+     * Whether a column visibility chooser is rendered.
+     */
+    columnVisibility?: boolean;
+    /**
+     * Whether the column chooser exposes reorder controls.
+     */
+    columnReorder?: boolean;
+    /**
+     * Initially hidden column ids.
+     */
+    hiddenColumns?: string[];
+    /**
+     * Table `rowclick` listener, beside `onRowClick`.
+     */
+    onrowclick?: TableOptions['onrowclick'];
+    /**
+     * Table `rowdblclick` listener.
+     */
+    onrowdblclick?: TableOptions['onrowdblclick'];
+    /**
+     * Table `sort` listener; the binding reloads either way.
+     */
+    onsort?: TableOptions['onsort'];
+    /**
+     * Table `selectionchange` listener.
+     */
+    onselectionchange?: TableOptions['onselectionchange'];
+    /**
+     * Table `datachange` listener.
+     */
+    ondatachange?: TableOptions['ondatachange'];
+    /**
+     * Table `stackedchange` listener.
+     */
+    onstackedchange?: TableOptions['onstackedchange'];
+    /**
+     * Table `grow` listener.
+     */
+    ongrow?: TableOptions['ongrow'];
+    /**
+     * Table `columnvisibilitychange` listener.
+     */
+    oncolumnvisibilitychange?: TableOptions['oncolumnvisibilitychange'];
+    /**
+     * Table `columnorderchange` listener.
+     */
+    oncolumnorderchange?: TableOptions['oncolumnorderchange'];
 };
 export type ZeyosTableConfig = {
     /**
@@ -136,19 +232,6 @@ export type ZeyosTableBinding = {
      */
     destroy: () => void;
 };
-/**
- * @typedef {Object} ZeyosTableOptions
- * @property {string[]} [fields] Curated ordered field allow-list.
- * @property {Record<string, string>} [labels] Per-field label overrides.
- * @property {string|((row: Record<string, unknown>) => unknown)} [rowId='ID'] Row id accessor.
- * @property {number} [pageSize=50] Server page size.
- * @property {{id: string, dir: 'asc'|'desc'}|null} [sort=null] Initial server sort.
- * @property {Record<string, unknown>} [filters] Initial ZeyOS predicates.
- * @property {string} [search=''] Initial full-text query.
- * @property {false|'single'|'multi'} [selectable=false] Row selection mode.
- * @property {number|string|null} [height=null] Table scroll-region height.
- * @property {(row: Record<string, unknown>, event: CustomEvent<Record<string, unknown>>) => void} [onRowClick] Row activation callback.
- */
 /**
  * @typedef {Object} ZeyosTableConfig
  * @property {Record<string, any>[]} fieldMeta Ordered normalized schema metadata.
@@ -186,7 +269,8 @@ export type ZeyosTableBinding = {
  * Builds the DOM-free schema-derived columns and Table options used by {@link zeyosTable}. Entity
  * projections include an `<field>_label` alias from a real label field on the referenced resource.
  * Amount fields use each row's real `currency` value for display while retaining the WP14 typed
- * column strategy and right alignment.
+ * column strategy and right alignment. Enum columns show labels, date-only columns calendar days in
+ * `timeZone`, and Table presentation options and listeners pass through to `tableOptions`.
  * @param {Record<string, any>} client Injected ZeyOS client instance.
  * @param {string} resource Resource name such as `transactions`.
  * @param {ZeyosTableOptions} [opts={}] Schema, table, and initial query options.
@@ -197,6 +281,8 @@ export declare function buildZeyosTableConfig(client: Record<string, any>, resou
  * Generates a server-backed Zx Table. Sorting automatically reloads page zero. `load({page: 0})`
  * replaces data, higher pages append it, and `loadMore()` uses `limit`/`offset` plus the returned
  * count. DataFilter callers can map state with `dataFilterStateToFilters` before `setFilters()`.
+ * Table presentation options (`variant`, `zebra`, `stickyHeader`, `responsive`, `emptyText`, …) and
+ * listeners are passed through to the generated Table.
  * @param {Record<string, any>} client Injected ZeyOS client instance.
  * @param {string} resource Resource name such as `transactions`.
  * @param {ZeyosTableOptions} [opts={}] Schema, table, and initial query options.

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

@@ -46,6 +46,16 @@ export type ZeyosViewOptions = {
      * Per-field label overrides.
      */
     labels?: Record<string, string>;
+    /**
+     * Per-field semantic format overrides, such as
+     * `{ duedate: 'date' }` for a Unix-second field that holds a calendar day.
+     */
+    formats?: Record<string, string>;
+    /**
+     * IANA time zone of the ZeyOS instance; date-only fields show the
+     * calendar day their stored midnight names in it. Defaults to the runtime's own zone.
+     */
+    timeZone?: string;
     /**
      * View descriptor overrides.
      */