@object-ui/plugin-list 17.3.0 → 17.5.0

package/README.md

@@ -180,6 +180,42 @@ interface ListViewSchema {
 }
 ```
 
+## Page binding — `dataSource` (referencing a saved view by name)
+
+On a metadata page, a `list-view` component can bind its data through the spec's
+per-element data source (`PageComponentSchema.dataSource`,
+`ElementDataSourceSchema`) instead of spelling `objectName` and inlining the
+view's configuration:
+
+```json
+{
+  "type": "list-view",
+  "dataSource": { "object": "account", "view": "hot", "limit": 10 }
+}
+```
+
+`view` names a **saved view** of that object — either one embedded in the object
+definition (`listViews`) or one created in the UI (the metadata overlay an
+adapter serves from `listViews()`). Its `columns`, `filter`, `sort`, page size
+and view kind are applied to the render, so a page no longer has to keep a second
+copy of a view's configuration in sync with the view itself. Both the short key
+(`hot`) and the qualified id (`account.hot`) resolve.
+
+**Precedence.** `dataSource.*` keys are authoritative — the author wrote them on
+this placement, and they beat the component's own same-named key. Values that
+come from the named view are a *baseline*: a key written on the component itself
+is more specific than the view it points at, so the component's key wins
+(an empty `columns: []` counts as "not authored"). `filter` is the exception —
+the spec calls `dataSource.filter` "additional filter criteria", so the
+component's filter, the view's filter and the binding's filter all AND together.
+A binding can narrow what the view selects, never widen it.
+
+**An unresolvable `view` is an error, not an empty table.** If the named view
+does not exist, the block renders a configuration error listing the object's
+actual views, and issues no query. It deliberately does not fall back to the
+object's default view: that would turn a typo into a silently *wider* answer on a
+page that still looks like it works.
+
 ## Sorting (and why relational columns are not offered)
 
 The toolbar sort becomes a server `$orderby` on the **flat field name**, so the
@@ -191,10 +227,22 @@ user's side). The server cannot order by the related name without a join, and
 `objectstack#4256` settled that it will not add one.
 
 So the sort picker withholds relational fields and says so. To sort by a related
-record's name, denormalize it onto this object with a **formula field** and sort
-that column like any other text column. A relational field that the view's
-CURRENT sort already uses stays listed, labelled `(by ID)`, so existing view
-metadata round-trips instead of silently losing its sort.
+record's name, denormalize that name onto this object as a **stored field,
+written when the source changes**, then sort by that field — the remedy the
+server's own refusal prescribes, in the same words the sort panel's hint uses.
+
+**Not a formula field.** A formula value is computed on read, so no driver
+materializes a column behind it, and since `objectstack#6994` the server answers
+a sort that names one with a hard `400 INVALID_SORT` (before that it degraded
+silently: the rows came back in an arbitrary order under a `200`, `asc` and
+`desc` identical). The picker withholds formula fields for the same reason
+(`objectui#4243`), so there is no formula column here to sort "like any other
+text column" — the column you sort is the stored one the denormalization writes.
+
+A field the view's CURRENT sort already uses stays listed under both rules —
+relational ones labelled `(by ID)` — so existing view metadata round-trips
+instead of silently losing its sort, and a sort the server would refuse can
+still be edited away in the picker that otherwise hides its field.
 
 Column-header sorting inside the grid is unaffected: it is client-side over the
 rows already loaded, where the label the cell shows IS available, so it orders by
@@ -204,17 +252,6 @@ that label (see `getSortValue` in `@object-ui/core`).
 
 The ListView automatically persists the user's view type preference in localStorage using the key `listview-{objectName}-view`.
 
-<!-- release-metadata:v3.3.0 -->
-
-## Compatibility
-
-- **React:** 18.x or 19.x
-- **Node.js:** ≥ 18
-- **TypeScript:** ≥ 5.0 (strict mode)
-- **`@objectstack/spec`:** ^3.3.0
-- **`@objectstack/client`:** ^3.3.0
-- **Tailwind CSS:** ≥ 3.4 (for packages with UI)
-
 ## Links
 
 - 📚 [Documentation](https://www.objectui.org/docs/plugins/plugin-list)

package/dist/ListView.d.ts

@@ -9,9 +9,46 @@ import { ListViewSchema } from '@object-ui/types';
  * LICENSE file in the root directory of this source tree.
  */
 import * as React from 'react';
+/**
+ * The list view's props.
+ *
+ * ## Why there is no `[key: string]: any` here (objectui#4528)
+ *
+ * There used to be one, and it erased this entire interface. A string index
+ * signature puts `string` into `keyof Props`, so `'ref' extends keyof Props` is
+ * always true and React's `PropsWithoutRef` takes its `Omit` branch — and
+ * `Omit` over a type carrying a string index signature keeps ONLY the index
+ * signature. Every declared property below was dropped from the resolved type.
+ * Measured on the pre-fix source:
+ * `keyof React.ComponentProps< typeof ListView >` was `string | number`, and
+ * `React.ComponentProps< typeof ListView >['onRowClick']` was `any`, while this
+ * interface went on declaring `(record: Record< string, unknown >) => void`.
+ *
+ * The same trap, in `packages/components`, is objectui#4422 / PR #4438; this is
+ * the sweep of the two packages that issue left unswept.
+ *
+ * ## The props that were only ever reachable through it
+ *
+ * `ListView` reads several props it never declared, because the index signature
+ * was answering for them — `dataSource`, `onAddRecord`, `onBulkAction`,
+ * `onPageSizeChange` are read directly, and `onEdit` / `onDelete` /
+ * `onBulkDelete` ride the `{...props}` forward into the active view component
+ * (`ObjectGrid` declares all three). They are declared by name below, at the
+ * type each one actually lands on, rather than left to an index signature that
+ * types them `any` and erases everything around them.
+ */
 export interface ListViewProps {
     schema: ListViewSchema;
     className?: string;
+    /**
+     * Data-source adapter. Read directly (`dataSource.find`,
+     * `dataSource.getObjectSchema`, `dataSource.onMutation`) and forwarded to the
+     * active view component. Typed `any` deliberately: that is what it resolved
+     * to before objectui#4528, so declaring it changes what is DECLARED without
+     * changing what any call site is held to. Narrowing it to a real adapter type
+     * is a separate change with its own consumer sweep.
+     */
+    dataSource?: any;
     onViewChange?: (view: ViewType) => void;
     onFilterChange?: (filters: any) => void;
     onSortChange?: (sort: any) => void;
@@ -42,7 +79,21 @@ export interface ListViewProps {
     initialFilters?: FilterGroup;
     /** Initial search term to restore at mount (same one-shot semantics as `initialFilters`). */
     initialSearchTerm?: string;
-    [key: string]: any;
+    /** Called when the user asks for a new record (toolbar "+ New" and the empty-state CTA). */
+    onAddRecord?: () => void;
+    /** Called with a non-delete bulk action key and the currently selected rows. */
+    onBulkAction?: (action: string, records: any[]) => void;
+    /** Called when the user picks a different page size in the pager. */
+    onPageSizeChange?: (pageSize: number) => void;
+    /**
+     * Row-level affordances forwarded to the active view component. `ObjectGrid`
+     * declares all three with exactly these signatures; they are named here so the
+     * hosts that pass them (`ObjectView`, `StudioDesignSurface`) are held to a
+     * contract instead of to an index signature.
+     */
+    onEdit?: (record: any) => void;
+    onDelete?: (record: any) => void;
+    onBulkDelete?: (records: any[]) => void;
 }
 /**
  * Filter-builder / view operator → filter-AST operator.
@@ -62,10 +113,6 @@ export declare function mapOperator(op: string): string;
  * E.g., ['status', 'in', ['a','b']] → ['or', ['status','=','a'], ['status','=','b']]
  */
 export declare function normalizeFilterCondition(condition: any[]): any[];
-/**
- * Format an action identifier string into a human-readable label.
- * e.g., 'send_email' → 'Send Email'
- */
 /**
  * Normalize a view's `sort` declaration to SortItem[]. @objectstack/spec
  * ListViewSchema.sort is `string | Array<{ field, order }>` — the TOP-LEVEL
@@ -92,6 +139,37 @@ export declare function resolveAddRecordPlacement(position: unknown): {
     top: boolean;
     bottom: boolean;
 };
+/**
+ * The date axis a timeline view renders on.
+ *
+ * ONE resolution, consumed by both read-sites that decide the timeline's fate:
+ * the capability gate (may this view offer the Timeline visualization?) and the
+ * timeline render branch (which field does it bucket by?). Those two used to
+ * carry separate, unequal source lists, and the gate was the wider of the pair —
+ * it accepted `options.calendar.startDateField` as a timeline-resolvable axis
+ * while the render branch never read calendar config at all. A view that binds
+ * its dates under `calendar` therefore got the Timeline option offered and then
+ * bucketed every record into "No date" (objectui#3129), which is exactly the
+ * shape the report isolated: the same fields render fine in Calendar and Gantt.
+ *
+ * A calendar binding IS a legitimate timeline axis in this product, not a
+ * lenient fallback bolted on here: the capability gate has always said so, and
+ * `InterfaceListPage` derives a timeline's default binding from the very same
+ * `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`.
+ *
+ * Exported for the regression suite, which pins each authoring shape.
+ */
+export declare function resolveTimelineDateBinding(schema: any): {
+    startDateField?: string;
+    endDateField?: string;
+    titleField?: string;
+};
 /**
  * Normalize an array of filter conditions, expanding `in`/`not in` operators
  * and ensuring consistent AST structure.
@@ -141,6 +219,7 @@ export declare function convertFilterGroupToAST(group: FilterGroup): any[];
  *               `$expand` substituted for it (see `toPredicateRecord`).
  */
 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>;
 /**
  * Imperative handle exposed by ListView via React.forwardRef.
  * Allows parent components to trigger a data refresh programmatically.
@@ -157,5 +236,5 @@ export interface ListViewHandle {
     /** Force the ListView to re-fetch data from the DataSource */
     refresh(): void;
 }
-export declare const ListView: React.ForwardRefExoticComponent<Omit<ListViewProps, "ref"> & React.RefAttributes<ListViewHandle>>;
+export declare const ListView: React.ForwardRefExoticComponent<ListViewProps & React.RefAttributes<ListViewHandle>>;
 //# sourceMappingURL=ListView.d.ts.map

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":"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"}

package/dist/ListViewBlock.d.ts

@@ -0,0 +1,69 @@
+import { default as React } from 'react';
+import { ListViewHandle, ListViewProps } from './ListView';
+/**
+ * Registry entry point for `<ListView>` — two bridges in one component.
+ *
+ * ## 1. The data-source ADAPTER (#3144)
+ *
+ * `ListView` reads `props.dataSource` (the injected adapter), and
+ * `SchemaRenderer` never passes it — it only puts the data source on
+ * `SchemaRendererContext`. Registering the component bare meant that on the
+ * registry/SDUI path (a metadata page, a `kind:'react'` page, the designer
+ * preview) it received no data source at all: its `getObjectSchema` effect
+ * returned immediately, nothing was ever fetched, and it rendered the "Nothing
+ * here" empty state — while its registry `inputs` declared `objectName`
+ * **required**. The app never showed this because the console reaches ListView
+ * through `ObjectView`'s `renderListView` render-prop, which passes a data
+ * source itself. That is the objectstack#4413 shape (a declared binding nothing
+ * can consume), caught by
+ * `apps/console/src/__tests__/public-block-binding-reach.test.tsx` rather than by
+ * hand. `object-form`, `object-kanban` and `object-calendar` carry the same
+ * one-line bridge.
+ *
+ * An explicit `dataSource` prop still wins — hosts that pass their own (as
+ * `ObjectView` does) are unaffected. `useContext` rather than
+ * `useSchemaContext()` because the latter throws outside a provider, and a bare
+ * `<ListView>` with a host-supplied data source must keep working.
+ *
+ * ## 2. The spec's per-element data BINDING (objectstack#5576)
+ *
+ * `PageComponentSchema.dataSource` — `{ object, view?, filter?, sort?, limit? }` —
+ * is how a page component declares what to query. It was published and unread:
+ * `resolveElementDataSource` dropped `view`, had no caller outside its own test,
+ * and nothing mapped `object` onto `objectName`. Worse, the binding and the
+ * adapter above collide by NAME, so a page that wrote the binding the spec
+ * documents got the plain `{ object, view }` object where the adapter belongs:
+ * the first `dataSource.find(…)` threw `dataSource.find is not a function` and
+ * the list rendered **"Couldn't load records"**. Three `list-view` components on
+ * one home page, the two without `dataSource` fine and the spec-compliant one
+ * broken, is the single-variable reproduction in the issue.
+ *
+ * `SchemaRenderer` no longer spreads the schema's `dataSource` as a prop, which
+ * removes the collision at its source. This component completes the other half:
+ * it maps the binding onto the props `ListView` actually reads, resolving a named
+ * saved view through `ElementDataSourceGate`.
+ *
+ * ### Where the precedence table lives (objectui#4038)
+ *
+ * It is NOT here. objectstack#5576 landed this block's own ~45-line copy of
+ * "binding overrides the component key / a view is only a baseline / `filter`
+ * AND-combines / an empty `columns` counts as unauthored / the row cap lands on
+ * `pagination.pageSize` / `viewType` only when undeclared", and objectstack#6953
+ * then lifted that same table into `@object-ui/react` when the other eight
+ * object-bound blocks needed it. Two copies of one table is how the spec's
+ * "*additional* filter criteria" quietly becomes two dialects — the next person
+ * to change the rules changes one side. So the table now lives ONCE, in
+ * {@link ElementDataSourceGate}, and this block contributes only the part that is
+ * genuinely its own: {@link LIST_VIEW_DATA_SOURCE}, the names of the keys it
+ * reads. The behaviour is unchanged in both directions — that objectstack#5576's
+ * whole suite passes here untouched is the acceptance criterion of the
+ * convergence, not a happy accident.
+ *
+ * An unresolvable `view` still fails loudly (the gate renders the configuration
+ * error rather than falling back to the object's default view): silently widening
+ * a named view to "all records" is the failure class the binding exists to
+ * remove, and the one an AI-authored page hides best.
+ */
+declare const ListViewBlock: React.ForwardRefExoticComponent<ListViewProps & React.RefAttributes<ListViewHandle>>;
+export { ListViewBlock };
+//# sourceMappingURL=ListViewBlock.d.ts.map

package/dist/ListViewBlock.d.ts.map

@@ -0,0 +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"}

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;AAgB/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;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAyG5D,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAsDpD,CAAC"}
+{"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;AAuFD;;;;;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"}

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;AAU/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;AA+BD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA4DxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAqE9C,CAAC"}
+{"version":3,"file":"TabBar.d.ts","sourceRoot":"","sources":["../../src/components/TabBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/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;AAkED;;;;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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ViewSettingsPopover.d.ts","sourceRoot":"","sources":["../../src/components/ViewSettingsPopover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoB/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAC7C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;IACvC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAExC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IAElG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAE9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAEjD,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AA8CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,qBAkNlE"}
+{"version":3,"file":"ViewSettingsPopover.d.ts","sourceRoot":"","sources":["../../src/components/ViewSettingsPopover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoB/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAC7C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;IACvC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAExC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IAElG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAE9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAEjD,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AA8CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,qBAwNlE"}

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 import { ListView } from './ListView';
+import { ListViewBlock } from './ListViewBlock';
 import { ViewSwitcher } from './ViewSwitcher';
 import { ObjectGallery } from './ObjectGallery';
-export { ListView, ViewSwitcher, ObjectGallery };
+export { ListView, ListViewBlock, ViewSwitcher, ObjectGallery };
 export { ViewSwitcherDropdown } from './ViewSwitcher';
 export { TabBar, TabBarSelect } from './components/TabBar';
 export type { TabBarProps, ViewTab } from './components/TabBar';
 export { UserFilters } from './UserFilters';
 export type { UserFiltersProps } from './UserFilters';
 export { evaluateConditionalFormatting, normalizeFilterCondition, normalizeFilters } from './ListView';
+export { LIST_DEFAULT_TRANSLATIONS } from './ListView';
 export type { ListViewProps, ListViewHandle } from './ListView';
 export type { ObjectGalleryProps } from './ObjectGallery';
 export type { ViewSwitcherProps, ViewType } from './ViewSwitcher';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,QAAQ,EAA2C,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}