@object-ui/plugin-list 17.7.0 → 18.0.0

package/dist/ListView.d.ts

@@ -1,6 +1,7 @@
-import { SortItem, FilterGroup } from '@object-ui/components';
-import { ViewType } from './ViewSwitcher.js';
+import { SortItem, FilterBuilderRowGroup } from '@object-ui/components';
 import { ListViewSchema } from '@object-ui/types';
+import { ListViewVisualization } from '@object-ui/core';
+import { GroupingConfig } from '@objectstack/spec/ui';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.
@@ -107,19 +108,19 @@ export interface ListViewProps {
      * is a separate change with its own consumer sweep.
      */
     dataSource?: any;
-    onViewChange?: (view: ViewType) => void;
+    onViewChange?: (view: ListViewVisualization) => void;
     /**
      * Fires with the advanced-filter group the toolbar's `FilterBuilder` emitted.
      *
-     * `FilterGroup` because that is what the one call site actually passes: the
+     * `FilterBuilderRowGroup` because that is what the one call site actually passes: the
      * builder's own `onChange` value, handed straight through beside
-     * `setCurrentFilters` — itself `React.useState<FilterGroup>`. Deliberately NOT
+     * `setCurrentFilters` — itself `React.useState<FilterBuilderRowGroup>`. Deliberately NOT
      * the filter AST `normalizeFilters` / `buildEffectiveFilter` speak: those run
      * later, on the query-building path, and nothing they produce reaches this
      * callback. A host receives the BUILDER's group verbatim, which is what lets
      * it round-trip back in through `initialFilters`.
      */
-    onFilterChange?: (filters: FilterGroup) => void;
+    onFilterChange?: (filters: FilterBuilderRowGroup) => void;
     /**
      * Fires with the view's sort after a builder edit, a header click or a
      * "reset to the view's default".
@@ -132,10 +133,28 @@ export interface ListViewProps {
      * decides whether platform-unsortable entries are still present (#6455).
      */
     onSortChange?: (sort: SortItem[]) => void;
+    /**
+     * Fires with the grouping after a user edit in either grouping editor: the
+     * toolbar's Group panel (a level added, changed or removed, or Clear) and the
+     * compact toolbar's settings popover. `undefined` when the grouping is
+     * cleared.
+     *
+     * The value is the spec's `GroupingConfig`, the shape `schema.grouping`
+     * takes, so a host hands it back through `schema.grouping` unchanged
+     * (objectui#11860). Not fired when the list re-reads a changed
+     * `schema.grouping` or `groupBy`: that value came from the host.
+     */
+    onGroupingChange?: (grouping: GroupingConfig | undefined) => void;
     onSearchChange?: (search: string) => void;
     /** Called when the user toggles fields via the Hide Fields popover. */
     onHiddenFieldsChange?: (hidden: string[]) => void;
-    /** Called when the user toggles inline record editing in View settings. */
+    /**
+     * Called when the user toggles inline record editing. Wiring it is also what
+     * offers the wide toolbar's toggle. The toggle switches the grid's edit MODE,
+     * which `ListView` keeps in its own state. A host should not persist it into
+     * the view's `inlineEdit`: that key is the author's permission, and it folds
+     * into `userActions.editInline` (objectui#5144).
+     */
     onInlineEditChange?: (next: boolean) => void;
     /** Called when the user resizes/reorders columns in the underlying grid. */
     onColumnStateChange?: (state: {
@@ -171,7 +190,7 @@ export interface ListViewProps {
      * later prop changes don't override in-flight user edits, so hosts remount
      * (via `key`) when they need to swap the restored value (view switch).
      */
-    initialFilters?: FilterGroup;
+    initialFilters?: FilterBuilderRowGroup;
     /** Initial search term to restore at mount (same one-shot semantics as `initialFilters`). */
     initialSearchTerm?: string;
     /** Called when the user asks for a new record (toolbar "+ New" and the empty-state CTA). */
@@ -189,6 +208,65 @@ export interface ListViewProps {
     onEdit?: (record: any) => void;
     onDelete?: (record: any) => void;
     onBulkDelete?: (records: any[]) => void;
+    /**
+     * A host-drawn node rendered FIRST in the toolbar row's left group, before
+     * the user filters, in a `min-w-0 flex-1` wrapper: it takes the width the
+     * right-hand tool cluster leaves (objectui#12440). The console passes its
+     * saved-view `ViewTabBar` here, so the view tabs and Filter · Sort ·
+     * Display · Search share one row.
+     *
+     * A HOST prop on the React component, never a schema key: it is a React
+     * node a host composes, nothing an author writes, and the list view's own
+     * `tabs` key is retired from the protocol (objectui#11073). It is
+     * destructured by name so it never rides the `{...props}` forward into the
+     * active view component. Absent ⇒ the toolbar row is exactly what it was.
+     *
+     * A host that passes it carries the view's DESCRIPTION too (objectui#12528):
+     * the console's `ViewTabBar` draws it as the active tab's tooltip and ▾ menu
+     * header, so the list draws none. Without it the list draws the description
+     * itself, as an info control at the start of the toolbar row — never as a
+     * row of its own, so the toolbar sits at one height with or without one.
+     */
+    toolbarLeading?: React.ReactNode;
+    /**
+     * Whether the grid opens with row numbers in its leading cell — the opening
+     * state of the Display control's session-only switch, and what its "Reset to
+     * view default" returns to. Default `true`. A HOST prop, never a schema key:
+     * the console's Setup app opens its lists without them (objectui#12606), a
+     * posture of the console, not of the view.
+     */
+    defaultRowNumbers?: boolean;
+    /**
+     * The VIEW'S OWN hidden fields and row height, for a host that lays the
+     * user's own preference over them in `schema` (objectui#12949). The Display
+     * control's trigger count and its "Reset to view default" compare these two
+     * settings against this value rather than against `schema`, and the reset
+     * hands it back through the same doors the controls write through
+     * (`onHiddenFieldsChange`, `schema.onDensityChange`), so the user's
+     * preference follows.
+     *
+     * When it is passed, its members are the whole baseline: an absent
+     * `hiddenFields` means the view hides nothing, an absent `rowHeight` means
+     * the view's default density. Absent ⇒ `schema` is the view's own, exactly
+     * as before. A HOST prop, never a schema key: it is the host's split of one
+     * composed value into its two sources, nothing an author writes.
+     */
+    viewDefaults?: Pick<ListViewSchema, 'hiddenFields' | 'rowHeight'>;
+    /**
+     * Draw the COMPACT posture (objectui#12703): a header with the list's title
+     * and record count over two-line rows (the view's first visible column, its
+     * second muted below), and none of the toolbar, view tabs, row-number column,
+     * pager or record-count bar. The `list-view` page block passes it when the
+     * page region it sits in is narrower than half the page
+     * (`usePageRegionPosture` from `@object-ui/components`).
+     *
+     * A HOST prop, never a schema key: the posture is measured by the page
+     * renderer, never authored, and `@objectstack/spec` declares no key for it.
+     * It applies to a paged grid, the view that draws the rows this component
+     * fetches a page of; any other kind (a board, a calendar, a grouped grid)
+     * keeps its full rendering. Absent ⇒ the full list, exactly as before.
+     */
+    compact?: boolean;
 }
 /**
  * Filter-builder / view operator → filter-AST operator.
@@ -275,10 +353,13 @@ export declare function resolveAddRecordPlacement(position: unknown): {
  * `defaultCalendarFromObject` helper it uses for calendars. What was missing is
  * that one of the two read-sites never honoured the promise the other made.
  *
- * Both nestings are read at each level, spec-canonical key first: the
- * spec-authored `schema.timeline` / `schema.calendar` and the legacy
- * `schema.options.*` twin that app-shell's object pages still emit. `dateField`
- * is the pre-#2231 alias for `startDateField`.
+ * Both nestings are read at each level: the spec-authored `schema.timeline` /
+ * `schema.calendar` and the legacy `schema.options.*` twin that app-shell's
+ * object pages still emit. Each by its spec key only. The pre-#2231 `dateField`
+ * alias for `startDateField` had a rung here until objectui#6152 round 14
+ * retired it: every list-view door refuses it by name on all four blocks, and
+ * the calendar branch already ignored it (objectui#8355), so one stored row
+ * could draw a Timeline on a key its Calendar dropped.
  *
  * Exported for the regression suite, which pins each authoring shape.
  */
@@ -311,11 +392,12 @@ export declare function normalizeFilters(filters: any[]): any[];
  * record. An earlier version of this comment called that unreachable, on the
  * grounds that nothing in the repo hands a list view an object filter. That was
  * wrong: `ObjectView` passes `mergedFilters` straight into this schema's
- * `filter`, and its last fallback is `table.defaultFilters`, declared
- * `Record<string, any>`. `toFilterNode` now converts it instead.
+ * `filter`, and its last fallback was `table.defaultFilters`, declared
+ * `Record<string, any>` (retired since objectui#12030; `table.filter` takes
+ * the same object). `toFilterNode` now converts it instead.
  */
-export declare function buildEffectiveFilter(baseFilter: unknown, currentFilters: FilterGroup, userFilterConditions: any[]): any[] | Record<string, any> | undefined;
-export declare function convertFilterGroupToAST(group: FilterGroup): any[];
+export declare function buildEffectiveFilter(baseFilter: unknown, currentFilters: FilterBuilderRowGroup, userFilterConditions: any[]): any[] | Record<string, any> | undefined;
+export declare function convertFilterGroupToAST(group: FilterBuilderRowGroup): any[];
 /**
  * Evaluate conditional formatting rules against a record.
  * Returns a CSSProperties object for the first matching rule, or empty object.
@@ -337,6 +419,25 @@ export declare function convertFilterGroupToAST(group: FilterGroup): any[];
  */
 export declare function evaluateConditionalFormatting(record: Record<string, unknown>, rules?: ListViewSchema['conditionalFormatting'], scope?: Record<string, unknown>, fields?: unknown): React.CSSProperties;
 export declare const LIST_DEFAULT_TRANSLATIONS: Record<string, string>;
+/**
+ * Safe wrapper for useObjectTranslation that falls back to English defaults
+ * when I18nProvider is not available (e.g., standalone usage outside console).
+ *
+ * Delegates to `@object-ui/i18n`'s `createSafeTranslation`. The local copy
+ * this replaced wrapped the hook in try/catch — the very thing the comment on
+ * `useListViewObjectLabel` below warns against (objectui#2879).
+ *
+ * Exported for this package's `ObjectGallery` only (objectui#12217), which
+ * draws `ListEmptyState`'s `list.*` copy when no `ListView` is around it; the
+ * package barrel does not re-export it.
+ */
+export declare const useListViewTranslation: () => {
+    t: (key: string, options?: Record<string, unknown>) => string;
+    language: string;
+} | {
+    t: import('i18next').TFunction<string, undefined>;
+    language: string;
+};
 /**
  * The `$top` of the ONE unpaged fetch a list view makes when no usable page
  * size is declared: every view this component does not page on the server
@@ -347,14 +448,22 @@ export declare const LIST_DEFAULT_TRANSLATIONS: Record<string, string>;
  * A fetch batch, ⛔ not a page size (objectui#9853, ruling 5824040487,
  * structure B): its value is kept, and it does not follow the display default,
  * so no view silently loses reachable records when the protocol's page size
- * moves. A DECLARED `pagination.pageSize` still sizes this fetch, as it always
- * has; only the undeclared fallback is split by kind.
+ * moves. A DECLARED `pagination.pageSize` still sizes this fetch on every
+ * view but a windowed calendar; only the undeclared fallback is split by kind.
+ * A calendar with a start date bound walks its visible days in steps of this
+ * batch whatever page size is declared, so a declared size no longer sizes its
+ * fetch (`calendarWindowed`, objectui#12081).
  *
  * Exported for pins that assert "the fetch batch" rather than its value
  * (objectui#9853, ruling record 5909000462); the package index does not
  * re-export it.
  */
 export declare const DEFAULT_LIST_FETCH_BATCH_SIZE = 100;
+/**
+ * How many of the view's columns a card carries when the kanban block names
+ * no card fields of its own (objectui#12619).
+ */
+export declare const KANBAN_VIEW_CARD_FIELD_COUNT = 2;
 /**
  * Imperative handle exposed by ListView via React.forwardRef.
  * Allows parent components to trigger a data refresh programmatically.

package/dist/ListView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ListView.d.ts","sourceRoot":"","sources":["../src/ListView.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAwB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAMhE,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAgBxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;CAWqB,CAAC;AAmI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC1C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClD,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACpE,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACxE,gFAAgF;IAChF,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IACtG;;;;;OAKG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACzC;AA8DD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,UAiDrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAAO,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CA4BhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAqBzD;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAU9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,GAAG;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAoBA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAKtD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,EACnB,cAAc,EAAE,WAAW,EAC3B,oBAAoB,EAAE,GAAG,EAAE,GAC1B,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CASzC;AAUD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,CA4EjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,CAAC,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAC/C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,OAAO,GACf,KAAK,CAAC,aAAa,CAErB;AAcD,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkI5D,CAAC;AAsDF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAmFjD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,QAAQ,sFA2wInB,CAAC"}
+{"version":3,"file":"ListView.d.ts","sourceRoot":"","sources":["../src/ListView.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAmBnE,OAAO,KAAK,EAAkB,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,KAAK,qBAAqB,EAAylB,MAAM,iBAAiB,CAAC;AAWppB,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,sBAAsB,CAAC;AAKrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;CAWqB,CAAC;AA8K3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC1D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC1C;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IAClE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClD;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACpE,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACxE,gFAAgF;IAChF,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IACtG;;;;;OAKG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC;IAClE;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA8DD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,UAiDrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAAO,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CA4BhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAqBzD;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAU9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,GAAG;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAoBA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAKtD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,EACnB,cAAc,EAAE,qBAAqB,EACrC,oBAAoB,EAAE,GAAG,EAAE,GAC1B,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CASzC;AAUD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,GAAG,EAAE,CA4E3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,CAAC,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAC/C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,OAAO,GACf,KAAK,CAAC,aAAa,CAErB;AAcD,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJ5D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;4BAzlClC,CAAC;;;;;CA4lCD,CAAC;AAyCF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAoBjD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAgR9C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,QAAQ,sFAs9JnB,CAAC"}

package/dist/ListViewBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ListViewBlock.d.ts","sourceRoot":"","sources":["../src/ListViewBlock.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAO1C,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAqB/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,QAAA,MAAM,aAAa,sFA0BhB,CAAC;AAGJ,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"ListViewBlock.d.ts","sourceRoot":"","sources":["../src/ListViewBlock.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAc1C,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAyN/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,QAAA,MAAM,aAAa,sFA0GhB,CAAC;AAGJ,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/ListViewCompact.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * The compact posture of a list block (objectui#12703): what `ListView` draws
+ * in place of its toolbar, its grid and its record-count bar when the page
+ * region it sits in is narrower than half the page.
+ *
+ * A short list, not a small grid: a header with the list's title and its
+ * record count, then one row per record whose first line is the view's first
+ * visible column and whose muted second line is its second. No toolbar, no
+ * view tabs, no row-number column, no pager — those belong to the object
+ * list, and a rail beside `main` has no room for them.
+ *
+ * Values render through the shared cell renderers (`getCellRenderer`), so a
+ * date, a picklist label or a related record reads the way the grid and the
+ * gallery draw it. ⛔ No second formatter lives here.
+ *
+ * Under the rows, a "View all" link to the rest (objectui#12703 part 2): drawn
+ * only when the block hands a destination through
+ * {@link CompactListDestinationContext}, which it builds from the host's
+ * `listHref` / `openList`. A host without that seam draws no link.
+ */
+import * as React from 'react';
+/**
+ * Where the compact list's "View all" link goes: a document href and the SPA
+ * open that reaches the same place. The page block builds it from the host's
+ * `listHref` / `openList` (`RelatedRecordActionsValue`) and the object and saved
+ * view it is bound to; `null` (the default) draws no link.
+ *
+ * A context rather than a `ListView` prop because the destination is the
+ * block's, not the list's: only the page block knows its binding, and the
+ * object list page, which never draws the compact posture, has none.
+ * Package-internal, like this module.
+ */
+export interface CompactListDestination {
+    href: string;
+    /** SPA navigation to `href`; absent, the anchor navigates on its own. */
+    open?: () => void;
+}
+export declare const CompactListDestinationContext: React.Context<CompactListDestination | null>;
+/** The compact list's footer: a real link to the rest of the list. */
+export declare function ListViewCompactFooter({ destination }: {
+    destination: CompactListDestination;
+}): React.JSX.Element;
+/** The two columns a compact row draws: the view's first two visible ones. */
+export declare function compactRowColumns(fields: readonly unknown[]): {
+    primary?: string;
+    secondary?: string;
+};
+export interface ListViewCompactHeaderProps {
+    title?: string;
+    /** The record count to show, or `null` while it is not known. */
+    count: number | null;
+    /** The count as a sentence, the badge's accessible name (`list.recordCount`). */
+    countLabel?: string;
+}
+/** The compact list's header: its title and its record count. */
+export declare function ListViewCompactHeader({ title, count, countLabel }: ListViewCompactHeaderProps): React.JSX.Element | null;
+export interface ListViewCompactRowsProps {
+    rows: readonly Record<string, unknown>[];
+    /** The view's visible columns, in order (`ListView`'s `effectiveFields`). */
+    fields: readonly unknown[];
+    objectName?: string;
+    /** The object's metadata, for the field types the cells format by. */
+    objectDef?: {
+        fields?: Record<string, Record<string, unknown>>;
+    } | null;
+    onRowClick?: (record: Record<string, unknown>) => void;
+}
+/** The compact list's rows: the first visible column over the second, muted. */
+export declare function ListViewCompactRows({ rows, fields, objectName, objectDef, onRowClick }: ListViewCompactRowsProps): React.JSX.Element;
+//# sourceMappingURL=ListViewCompact.d.ts.map

package/dist/ListViewCompact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListViewCompact.d.ts","sourceRoot":"","sources":["../src/ListViewCompact.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,6BAA6B,8CAA2D,CAAC;AAEtG,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,EAAE,sBAAsB,CAAA;CAAE,qBAyB7F;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAKtG;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,0BAA0B,4BAsB7F;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACzC,6EAA6E;IAC7E,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACxD;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,wBAAwB,qBA6EhH"}

package/dist/ObjectGallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectGallery.d.ts","sourceRoot":"","sources":["../src/ObjectGallery.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AAKrF,OAAO,KAAK,EAAE,UAAU,EAAiB,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAIpG,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mGAAmG;IACnG,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACrE;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACvE;AA2LD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAslBtD,CAAC"}
+{"version":3,"file":"ObjectGallery.d.ts","sourceRoot":"","sources":["../src/ObjectGallery.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AAKrF,OAAO,KAAK,EAAE,UAAU,EAAiB,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAOpG,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mGAAmG;IACnG,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACrE;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACvE;AA2LD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAkpBtD,CAAC"}

package/dist/UserFilters.d.ts

@@ -28,6 +28,19 @@ export interface UserFiltersProps {
     config: NonNullable<ListViewSchema['userFilters']>;
     /** Object definition for auto-deriving field options */
     objectDef?: any;
+    /**
+     * True while the host is still fetching `objectDef` (objectui#12890).
+     *
+     * An unlabelled chip takes its label from the definition, so until it
+     * arrives the only name the chip has is the machine key (`category`), which
+     * a viewer reads as the field's name and then sees replaced by the real one
+     * (`分类`). While pending, such a chip draws a skeleton instead of the key.
+     * An authored `label` is drawn either way. Once the host settles the fetch
+     * this is false, and a field the settled definition does not name falls back
+     * to the key exactly as before. Omitted means settled: a host that passes no
+     * definition at all keeps drawing the key.
+     */
+    objectDefPending?: boolean;
     /** Current data for computing counts */
     data?: any[];
     /** Callback when filter state changes */
@@ -56,5 +69,5 @@ export interface UserFiltersProps {
  * - **tabs**: named filter preset tab bar
  * - **toggle**: on/off toggle buttons per field
  */
-export declare function UserFilters({ config, objectDef, data, onFilterChange, maxVisible, className, initialSelections, onSelectionsChange, }: UserFiltersProps): React.JSX.Element | null;
+export declare function UserFilters({ config, objectDef, objectDefPending, data, onFilterChange, maxVisible, className, initialSelections, onSelectionsChange, }: UserFiltersProps): React.JSX.Element | null;
 //# sourceMappingURL=UserFilters.d.ts.map

package/dist/UserFilters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserFilters.d.ts","sourceRoot":"","sources":["../src/UserFilters.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiDvD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAMpG,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACnD,wDAAwD;IACxD,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,yCAAyC;IACzC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzC,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACrE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CAC7F;AA6ED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,IAAS,EACT,cAAc,EACd,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,GACnB,EAAE,gBAAgB,4BA+ClB"}
+{"version":3,"file":"UserFilters.d.ts","sourceRoot":"","sources":["../src/UserFilters.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAmIvD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAMpG,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACnD,wDAAwD;IACxD,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,yCAAyC;IACzC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzC,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACrE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CAC7F;AA6ED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,gBAAwB,EACxB,IAAS,EACT,cAAc,EACd,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,GACnB,EAAE,gBAAgB,4BAiDlB"}

package/dist/ViewSwitcher.d.ts

@@ -8,31 +8,39 @@ import { ListViewVisualization } from '@object-ui/core';
  */
 import * as React from 'react';
 /**
- * The visualizations this switcher offers.
+ * The visualizations this switcher offers are `@object-ui/core`'s
+ * {@link ListViewVisualization} (`ca3942729`), which derives from
+ * `@objectstack/spec/ui` through `@object-ui/types`' `ViewType`.
  *
- * DERIVED from `@object-ui/core`'s {@link ListViewVisualization} (`ca3942729`),
- * which derives from `@objectstack/spec/ui` through `@object-ui/types`' `ViewType`.
- *
- * This nine-arm union was written out by hand here, and that is a THIRD
+ * A nine-arm union was once written out by hand here, and that was a THIRD
  * re-declaration of one vocabulary — the card behind `ca3942729` was filed against the two in
  * `@object-ui/types`, and the maps below were described there as total over the
  * shared union when they were in fact total over this private copy. A map that
  * is total over a copy is exactly as incomplete as the copy, so the two
- * `Record<ViewType, …>` below only became honest guards once this alias
- * replaced the copy: the next visualization the spec adds now fails the build
- * in both of them.
+ * `Record<ListViewVisualization, …>` below are honest guards only because they
+ * key on the derived union: the next visualization the spec adds fails the
+ * build in both of them.
+ *
+ * Spelled by that name, not re-exported as `ViewType`. This module used to
+ * publish an alias `ViewType = ListViewVisualization`, a second meaning behind
+ * the name `@object-ui/types` gives the whole view-type vocabulary — the alias
+ * lacked its `list` and `detail` arms (objectui#6349, batch 7). `page` is
+ * deliberately NOT a visualization: the spec models it as a list view that
+ * mounts a published page rather than one a user switches into, and
+ * `AppearanceConfig.allowedVisualizations` excludes it for the same reason.
  *
- * Exported unchanged in membership — this is the same nine names it always
- * carried. `page` is deliberately NOT among them: the spec models it as a list
- * view that mounts a published page rather than a visualization a user switches
- * into, and `AppearanceConfig.allowedVisualizations` excludes it for the same
- * reason.
+ * The props are named `ListViewSwitcherProps`, not `ViewSwitcherProps`, for the
+ * same reason. `@object-ui/plugin-view` publishes `ViewSwitcherProps` for a
+ * different switcher: the `view-switcher` renderer, which takes a
+ * `ViewSwitcherSchema` and the host callbacks and is keyed on the whole
+ * `ViewType`. Neither package depends on the other, so the two could not share
+ * one declaration. The general name stays with the schema-driven renderer, and
+ * this list view's switcher has the specific one (objectui#6349, batch 8).
  */
-export type ViewType = ListViewVisualization;
-export interface ViewSwitcherProps {
-    currentView: ViewType;
-    availableViews?: ViewType[];
-    onViewChange: (view: ViewType) => void;
+export interface ListViewSwitcherProps {
+    currentView: ListViewVisualization;
+    availableViews?: ListViewVisualization[];
+    onViewChange: (view: ListViewVisualization) => void;
     className?: string;
     /** Enable animated transitions between views (default: true) */
     animated?: boolean;
@@ -43,6 +51,6 @@ export interface ViewSwitcherProps {
  * menu of the available visualizations. Replaces the full button row so
  * the toolbar stays one line tall.
  */
-export declare const ViewSwitcherDropdown: React.FC<ViewSwitcherProps>;
-export declare const ViewSwitcher: React.FC<ViewSwitcherProps>;
+export declare const ViewSwitcherDropdown: React.FC<ListViewSwitcherProps>;
+export declare const ViewSwitcher: React.FC<ListViewSwitcherProps>;
 //# sourceMappingURL=ViewSwitcher.d.ts.map

package/dist/ViewSwitcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewSwitcher.d.ts","sourceRoot":"","sources":["../src/ViewSwitcher.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAe7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,QAAQ,CAAC;IACtB,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0GD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA0G5D,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwDpD,CAAC"}
+{"version":3,"file":"ViewSwitcher.d.ts","sourceRoot":"","sources":["../src/ViewSwitcher.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAe7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,qBAAqB,CAAC;IACnC,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,YAAY,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0GD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA0GhE,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAwDxD,CAAC"}

package/dist/calendarWindow.d.ts

@@ -0,0 +1,102 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * A fetch window over local calendar days, spelled `YYYY-MM-DD`: `from` is the
+ * first day asked for and `to` the day after the last, so the window is
+ * half-open. Held as two strings so it is compared, stored and keyed by VALUE.
+ */
+export interface CalendarWindow {
+    from: string;
+    to: string;
+}
+/** The range a calendar reports: local midnights, `end` exclusive. */
+export interface CalendarVisibleRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * The window to fetch for a reported range: the drawn days, widened by ONE day
+ * on each side.
+ *
+ * The widening is what makes a day-bounded comparison safe on every stored
+ * shape. A date-time is stored as a UTC instant, and the calendar places it on
+ * the LOCAL day it falls on; the two differ by up to fourteen hours, so an event
+ * at 01:00 on the first visible day in UTC+8 is stored on the previous UTC day
+ * and would fall outside an unwidened `from`. One day covers every offset, and a
+ * date-only value (`YYYY-MM-DD`, compared as written) is covered either way. The
+ * extra day on each side is fetched and not drawn: the grids place an event by
+ * its day, so a row outside the drawn days costs a row of the batch and nothing
+ * on screen.
+ */
+export declare function calendarWindowFor(range: CalendarVisibleRange): CalendarWindow;
+/**
+ * The window to fetch before the calendar has reported any range: one that
+ * covers whatever month grid it can open on today.
+ *
+ * The hosted calendar opens on today, in the month view (`ListView` hands it no
+ * date and no `defaultView`). Its month grid is six weeks that open on the
+ * locale's first day of the week, so it starts at most six days before the 1st
+ * and ends at most fourteen days after the last day of the month (a 28-day
+ * month that opens on the week's first day). Covering that bound means this
+ * window holds every day of the grid whatever the locale, so the calendar's
+ * first report, which is the exact grid, falls inside it and asks for nothing
+ * more. It also means a list view always has a window to fetch: one whose
+ * calendar never reports a range (a host's own `object-calendar` renderer)
+ * still draws today's month instead of nothing.
+ */
+export declare function initialCalendarWindow(now?: Date): CalendarWindow;
+/** Does `outer` hold every day of `inner`? (`YYYY-MM-DD` compares as written.) */
+export declare function calendarWindowCovers(outer: CalendarWindow, inner: CalendarWindow): boolean;
+/**
+ * The filter node that selects a window's records on the calendar's date
+ * field(s), plus the records that have no start date at all.
+ *
+ *   - Without an end field, an event is a day: its start falls in the window.
+ *   - With one, an event is a span, and it is drawn on every day it touches, so
+ *     it is selected when it starts before the window ends AND either starts or
+ *     ends inside the window or after it opens. A span with no end is a day
+ *     again, which the `start >= from` arm covers.
+ *   - ⛔ The records with NO start date are selected too. They are not on the
+ *     grid: `ObjectCalendar` counts them under the grid in its "Unscheduled"
+ *     area, which exists so that their absence from the grid is said rather
+ *     than silent (`bc5870c9f`). A window on the start field alone would drop
+ *     every one of them, and the area with them.
+ *
+ * Built in the filter AST the rest of this package sends (`mergeFilterNodes`
+ * joins it to the view's own filter under one `and`): `and` / `or` heads and
+ * `[field, operator, value]` triples, `is_null` as a 2-tuple. The bounds are
+ * `YYYY-MM-DD` strings, the spelling the date macros resolve to.
+ */
+export declare function calendarWindowFilter(window: CalendarWindow, startField: string, endField?: string): unknown[];
+/** What {@link fetchCalendarWindow} brings back. */
+export interface CalendarWindowRows {
+    /**
+     * The window's records, at most {@link NON_GRID_ROW_CEILING} + 1: the walk
+     * stops one row past the ceiling, the probe row `applyNonGridRowCeiling`
+     * reads truncation from.
+     */
+    data: any[];
+    /** The window's size when the adapter reported one (`QueryResult.total`). */
+    total?: number;
+}
+/**
+ * Walk a window in fetch-batch steps: `$top` is the batch (or the rows still
+ * wanted, at the end), `$skip` moves by what came back, and the walk stops at
+ * the first short batch or one row past the ceiling.
+ *
+ * ⛔ The step is the batch, never a bigger `$top`: the batch is the unit the
+ * protocol is asked in (objectui#9853), and the ceiling is a stop condition,
+ * not a request size.
+ *
+ * `extract` reads the rows out of one answer: the caller's own reader, so the
+ * walk accepts exactly the envelopes the caller's single fetch accepts.
+ * `isCurrent` is asked after every answer: when it says no, a newer request
+ * owns the screen and the walk returns `null` without asking for more.
+ */
+export declare function fetchCalendarWindow(find: (params: Record<string, unknown>) => Promise<unknown>, params: Record<string, unknown>, batch: number, extract: (result: unknown) => any[], isCurrent: () => boolean): Promise<CalendarWindowRows | null>;
+//# sourceMappingURL=calendarWindow.d.ts.map

package/dist/calendarWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarWindow.d.ts","sourceRoot":"","sources":["../src/calendarWindow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAE7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,IAAiB,GAAG,cAAc,CAI5E;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAE1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,EAAE,CAKX;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,EAAE,EACnC,SAAS,EAAE,MAAM,OAAO,GACvB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAepC"}

package/dist/components/TabBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabBar.d.ts","sourceRoot":"","sources":["../../src/components/TabBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqDD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA6DxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAsE9C,CAAC"}
+{"version":3,"file":"TabBar.d.ts","sourceRoot":"","sources":["../../src/components/TabBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqDD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA6DxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAyE9C,CAAC"}