@object-ui/plugin-list 17.6.0 → 18.0.0

package/dist/ListView.d.ts

@@ -1,6 +1,7 @@
-import { SortItem, FilterGroup } from '@object-ui/components';
-import { ViewType } from './ViewSwitcher';
+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.
@@ -11,11 +12,22 @@ import { ListViewSchema } from '@object-ui/types';
 import * as React from 'react';
 /**
  * The `case 'map'` branch below builds an `object-map` schema by flattening
- * `schema.options.map`'s CONTENTS to the top level. Whitelisted to these keys —
- * `ObjectMapConfigSchema`'s shape minus `style` — rather than the whole bag:
- * `style` is ALSO `BaseSchema.style` (inline CSS, legal on every node), and
- * spreading the raw `map` block collapsed the two namespaces onto one key
- * (objectui#5177).
+ * `schema.options.map`'s CONTENTS to the top level — one entry per key
+ * `ObjectMapConfigSchema` declares, written under the name the FLAT form uses
+ * for that key. Whitelisted rather than a whole-bag spread: `style` is ALSO
+ * `BaseSchema.style` (inline CSS, legal on every node), and spreading the raw
+ * `map` block collapsed the two namespaces onto one key (objectui#5177). That
+ * reason is unchanged, and so is its consequence: a key the declaration does
+ * NOT carry never reaches the product.
+ *
+ * `style` IS delivered (objectui#9950) — under its flat spelling `mapStyle`,
+ * NOT by widening the whitelist to let `style` through unrenamed.
+ * `getMapConfig` in `ObjectMap.tsx` reads `schema.mapStyle || schema.map?.style`
+ * and deliberately does NOT read a top-level `style`, because that key is the
+ * base face's inline CSS (objectui#5017). `mapStyle` is itself a declared
+ * member of `ObjectMapSchema`, so the flat product stays inside the declaration
+ * at both ends. Before this, a view authoring `map: { style: '<url>' }` parsed
+ * green, was dropped here, and the map painted the PUBLIC DEMO TILES.
  *
  * HAND-LISTED, not derived at runtime — deliberately, and only here (`plugin-
  * map`'s own `FLAT_MAP_CONFIG_KEYS` in `ObjectMap.tsx` DOES derive from
@@ -32,14 +44,30 @@ import * as React from 'react';
  * gets away with the runtime import only because nothing in
  * console-starter's graph reaches `@object-ui/plugin-map` today.
  *
- * Anti-drift is a TEST, not this comment: `ListView.mapFlatten.test.tsx` pins
- * this exact list against `ObjectMapConfigSchema.shape` — imported only from
- * that TEST file, which the alias-closure walker explicitly excludes from
- * traversal — so a key added to or removed from the declaration still fails
- * here, loudly and by name, without reintroducing the runtime edge that
- * breaks the walker.
+ * Anti-drift is TWO mechanisms, neither of them this comment:
+ * - the type below is TOTAL — a `Record` over EVERY `keyof ObjectMapConfig`,
+ *   not a list of some of them — so a key added to the declaration fails
+ *   `tsc` here until it is given a flat spelling. A key can no longer be
+ *   left out by simply not being written down, which is how `style` was.
+ * - `ListView.mapFlatten.test.tsx` pins this object's key set against
+ *   `ObjectMapConfigSchema.shape` — imported only from that TEST file, which
+ *   the alias-closure walker explicitly excludes from traversal — and asserts
+ *   the RELATION (every declared key is delivered under its flat spelling).
+ *   The pre-#9950 pin could not see the omission because it compared the hand
+ *   list against `shape` MINUS `style`: the set it measured against was
+ *   narrowed by the same subtraction the defect was made of, so it stayed
+ *   green while an authored style was being discarded.
  */
-export declare const FLAT_MAP_CONFIG_KEYS: readonly ["latitudeField", "longitudeField", "locationField", "titleField", "descriptionField", "zoom", "center"];
+export declare const FLAT_MAP_CONFIG_SPELLING: {
+    readonly latitudeField: "latitudeField";
+    readonly longitudeField: "longitudeField";
+    readonly locationField: "locationField";
+    readonly titleField: "titleField";
+    readonly descriptionField: "descriptionField";
+    readonly zoom: "zoom";
+    readonly center: "center";
+    readonly style: "mapStyle";
+};
 /**
  * The list view's props.
  *
@@ -80,21 +108,76 @@ export interface ListViewProps {
      * is a separate change with its own consumer sweep.
      */
     dataSource?: any;
-    onViewChange?: (view: ViewType) => void;
-    onFilterChange?: (filters: any) => void;
-    onSortChange?: (sort: any) => void;
+    onViewChange?: (view: ListViewVisualization) => void;
+    /**
+     * Fires with the advanced-filter group the toolbar's `FilterBuilder` emitted.
+     *
+     * `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<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: FilterBuilderRowGroup) => void;
+    /**
+     * Fires with the view's sort after a builder edit, a header click or a
+     * "reset to the view's default".
+     *
+     * `SortItem[]` because every emit crosses exactly one boundary —
+     * `emitSortChange` — and both of its legs carry that element type: the array
+     * passed in, and `filterPlatformSortableSort`'s return, which is generic in
+     * the element (readonly T[] in, T[] out) and so preserves whatever it is
+     * given. Normalized-vs-raw therefore does not move the TYPE here; it only
+     * 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: {
         order?: string[];
         widths?: Record<string, number>;
     }) => void;
-    /** Callback when a row/item is clicked (overrides NavigationConfig) */
-    onRowClick?: (record: Record<string, unknown>) => void;
+    /**
+     * Callback when a row/item is clicked (overrides NavigationConfig).
+     *
+     * TWO parameters since objectui#9357, and the second is not decoration: this
+     * prop reaches `useNavigationOverlay` as its `onRowClick`, and `handleClick`
+     * invokes it as `onRowClick(record, event)` — the modifier payload a host
+     * needs to implement Cmd/Ctrl/middle-click for itself. Declaring one
+     * parameter hid the second on the ONE line a host reads. Spelled `any` and
+     * not `HandleClickModifiers` for the reason objectui#9341 measured on
+     * `ObjectKanbanSchema.onCardClick`: that interface lives in
+     * `@object-ui/react`, the published twins in `@object-ui/types` may not name
+     * it, and a host that discovered the payload from the implementation
+     * annotated it `React.MouseEvent` — which a narrower declaration refuses
+     * contravariantly. `BaseSchema`'s own `onClick` / `onChange` / `onSubmit`
+     * already use this spelling for exactly this situation.
+     */
+    onRowClick?: (record: Record<string, unknown>, event?: any) => void;
     /** Show view type switcher (Grid/Kanban/etc). Default: false (view type is fixed) */
     showViewSwitcher?: boolean;
     /** Initial user-filter selections to restore (field → values; `_tab` for the active preset). */
@@ -107,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). */
@@ -125,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.
@@ -211,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.
  */
@@ -247,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.
@@ -273,6 +419,51 @@ 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
+ * (`paginate` is false), which is every kind but the flat grid, plus a grouped
+ * grid's window. Those views have no pager, so rows past this number are not
+ * reachable at all (`dataLimitReached` says so).
+ *
+ * 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 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":"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"}
+{"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

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { ListViewHandle, ListViewProps } from './ListView';
+import { ListViewHandle, ListViewProps } from './ListView.js';
 /**
  * Registry entry point for `<ListView>` — two bridges in one component.
  *

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,sFAwBjB,CAAC;AAGH,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

@@ -1,29 +1,41 @@
 import { default as React } from 'react';
-import { GalleryConfig, ViewNavigationConfig, GroupingConfig } from '@object-ui/types';
+import { DataSource, ObjectGallerySchema } from '@object-ui/types';
 export interface ObjectGalleryProps {
-    schema: {
-        objectName?: string;
-        bind?: string;
-        filter?: unknown;
-        data?: Record<string, unknown>[];
-        className?: string;
-        gallery?: GalleryConfig;
-        /** Navigation config for item click behavior */
-        navigation?: ViewNavigationConfig;
-        /** Grouping configuration for sectioned display */
-        grouping?: GroupingConfig;
-        /** @deprecated Use gallery.coverField instead */
-        imageField?: string;
-        /** @deprecated Use gallery.titleField instead */
-        titleField?: string;
-    };
+    /**
+     * The `object-gallery` node — anchored to the exported schema type
+     * (objectui#6576). Every `BaseSchema` member is writable, `bind` and
+     * `className` included; the widget's own keys are declared there.
+     */
+    schema: ObjectGallerySchema;
     data?: Record<string, unknown>[];
-    dataSource?: {
-        find: (name: string, query: unknown) => Promise<unknown>;
-    };
-    onCardClick?: (record: Record<string, unknown>) => void;
-    /** Callback when a row/item is clicked (overrides NavigationConfig) */
-    onRowClick?: (record: Record<string, unknown>) => void;
+    /**
+     * The host's adapter. Declared as the published `DataSource` contract
+     * (objectui#7912) — this used to be a hand-rolled `{ find(name, query:
+     * unknown): Promise<unknown> }` stand-in, which is a second, weaker
+     * spelling of a type this repo already publishes: it accepted any object
+     * with a `find`, and it erased `find`'s real parameter and return types at
+     * every call below.
+     */
+    dataSource?: DataSource;
+    /** The other arm of the same `??` that feeds the hook — see `onRowClick` below (objectui#9357). */
+    onCardClick?: (record: Record<string, unknown>, event?: any) => void;
+    /**
+     * Callback when a row/item is clicked (overrides NavigationConfig).
+     *
+     * TWO parameters since objectui#9357, and the second is not decoration: this
+     * prop reaches `useNavigationOverlay` as its `onRowClick`, and `handleClick`
+     * invokes it as `onRowClick(record, event)` — the modifier payload a host
+     * needs to implement Cmd/Ctrl/middle-click for itself. Declaring one
+     * parameter hid the second on the ONE line a host reads. Spelled `any` and
+     * not `HandleClickModifiers` for the reason objectui#9341 measured on
+     * `ObjectKanbanSchema.onCardClick`: that interface lives in
+     * `@object-ui/react`, the published twins in `@object-ui/types` may not name
+     * it, and a host that discovered the payload from the implementation
+     * annotated it `React.MouseEvent` — which a narrower declaration refuses
+     * contravariantly. `BaseSchema`'s own `onClick` / `onChange` / `onSubmit`
+     * already use this spelling for exactly this situation.
+     */
+    onRowClick?: (record: Record<string, unknown>, event?: any) => void;
 }
 export declare const ObjectGallery: React.FC<ObjectGalleryProps>;
 //# sourceMappingURL=ObjectGallery.d.ts.map

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;AAIrF,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAI5F,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,gDAAgD;QAChD,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,mDAAmD;QACnD,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,iDAAiD;QACjD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iDAAiD;QACjD,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC1E,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxD,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC1D;AAyLD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA+XtD,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;AAmDvD;;;;;;;;;;;;;;;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

@@ -1,3 +1,4 @@
+import { ListViewVisualization } from '@object-ui/core';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.
@@ -6,11 +7,40 @@
  * LICENSE file in the root directory of this source tree.
  */
 import * as React from 'react';
-export type ViewType = 'grid' | 'kanban' | 'gallery' | 'calendar' | 'timeline' | 'gantt' | 'map' | 'chart' | 'tree';
-export interface ViewSwitcherProps {
-    currentView: ViewType;
-    availableViews?: ViewType[];
-    onViewChange: (view: ViewType) => void;
+/**
+ * The visualizations this switcher offers are `@object-ui/core`'s
+ * {@link ListViewVisualization} (`ca3942729`), which derives from
+ * `@objectstack/spec/ui` through `@object-ui/types`' `ViewType`.
+ *
+ * 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<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.
+ *
+ * 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 interface ListViewSwitcherProps {
+    currentView: ListViewVisualization;
+    availableViews?: ListViewVisualization[];
+    onViewChange: (view: ListViewVisualization) => void;
     className?: string;
     /** Enable animated transitions between views (default: true) */
     animated?: boolean;
@@ -21,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;AAiB/B,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAEX,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"}