@cratis/components 3.6.0 → 4.0.0

package/dist/esm/DataTables/DataTableFilterMeta.js

@@ -1,6 +1,3 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/** Built-in match modes supported by Cratis data tables. */
 const DataTableFilterMatchMode = {
     StartsWith: 'startsWith',
     Contains: 'contains',

package/dist/esm/DataTables/DataTableFilterMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableFilterMeta.js","sources":["../../../DataTables/DataTableFilterMeta.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AAEA;AACO,MAAM,wBAAwB,GAAG;AACpC,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,QAAQ,EAAE,UAAU;AACpB,IAAA,WAAW,EAAE,aAAa;AAC1B,IAAA,QAAQ,EAAE,UAAU;AACpB,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,SAAS,EAAE,WAAW;AACtB,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,QAAQ,EAAE,IAAI;AACd,IAAA,eAAe,EAAE,KAAK;AACtB,IAAA,WAAW,EAAE,IAAI;AACjB,IAAA,kBAAkB,EAAE,KAAK;AACzB,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,SAAS,EAAE,WAAW;AACtB,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,SAAS,EAAE,WAAW;;;"}
+{"version":3,"file":"DataTableFilterMeta.js","sources":["../../../DataTables/DataTableFilterMeta.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIO,MAAM,wBAAwB,GAAG;AACpC,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,QAAQ,EAAE,UAAU;AACpB,IAAA,WAAW,EAAE,aAAa;AAC1B,IAAA,QAAQ,EAAE,UAAU;AACpB,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,SAAS,EAAE,WAAW;AACtB,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,QAAQ,EAAE,IAAI;AACd,IAAA,eAAe,EAAE,KAAK;AACtB,IAAA,WAAW,EAAE,IAAI;AACjB,IAAA,kBAAkB,EAAE,KAAK;AACzB,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,SAAS,EAAE,WAAW;AACtB,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,SAAS,EAAE,WAAW;;;"}

package/dist/esm/DataTables/DataTableForObservableQuery.d.ts

@@ -1,27 +1,118 @@
-import type { DataTableRootProps } from '@primereact/types/primitive/datatable';
+import type { DataTableParts } from './DataTableCore.js';
 import type { Constructor } from '@cratis/fundamentals';
 import { type IObservableQueryFor } from '@cratis/arc/queries';
 import { type ReactNode } from 'react';
-import { type TablePaginatorProps } from './TablePaginator';
-import type { DataTableFilterMeta } from './DataTableFilterMeta';
-import type { DataTableSelectionChangeEvent } from './DataTableSelectionChangeEvent';
+import { type TablePaginatorParts, type TablePaginatorProps } from './TablePaginator.js';
+import type { DataTableFilterMeta } from './DataTableFilterMeta.js';
+import type { DataTableSelectionChangeEvent } from './DataTableSelectionChangeEvent.js';
+/**
+ * Props for {@link DataTableForObservableQuery}.
+ *
+ * @typeParam TQuery - The query class implementing `IObservableQueryFor`.
+ * @typeParam TDataType - The row type returned by the query.
+ * @typeParam TArguments - The query's argument object type.
+ */
 export interface DataTableForObservableQueryProps<TQuery extends IObservableQueryFor<TDataType, TArguments> | IObservableQueryFor<TDataType[], TArguments>, TDataType extends object, TArguments extends object> {
+    /**
+     * Children to render — `<Column>` elements describing the visible columns.
+     */
     children?: ReactNode;
+    /**
+     * The type of query to use
+     */
     query: Constructor<TQuery>;
+    /**
+     * Optional arguments to pass to the query
+     */
     queryArguments?: TArguments;
+    /**
+     * The message to show when there is no data
+     */
     emptyMessage: string;
+    /**
+     * The key to use for the data
+     */
     dataKey?: string | undefined;
+    /**
+     * The current selection.
+     */
     selection?: TDataType | undefined | null;
+    /**
+     * Callback for when the selection changes
+     */
     onSelectionChange?(event: DataTableSelectionChangeEvent<TDataType>): void;
+    /**
+     * Fields to use for global filtering
+     */
     globalFilterFields?: string[] | undefined;
+    /** Placeholder for the loaded-page search input. */
+    globalSearchPlaceholder?: string;
+    /** Accessible name for the loaded-page search input. */
+    globalSearchAriaLabel?: string;
+    /**
+     * Default filters to use
+     */
     defaultFilters?: DataTableFilterMeta;
+    /**
+     * @deprecated Filtering is always applied to the currently loaded page.
+     * This compatibility prop no longer toggles behavior and does not change
+     * server-reported pagination totals. Retained for source compatibility only.
+     */
     clientFiltering?: boolean;
+    /**
+     * Extra CSS class name forwarded to the underlying DataTable root.
+     */
     className?: string;
-    pt?: DataTableRootProps['pt'];
-    ptOptions?: DataTableRootProps['ptOptions'];
+    /** Cratis-owned per-part attributes applied to the underlying table. */
+    pt?: DataTableParts;
+    /**
+     * @deprecated Cratis parts always merge. Remove this renderer-era option.
+     */
+    ptOptions?: object;
+    /**
+     * @deprecated Components always uses consumer-owned CSS. Customize through `pt` and CSS instead.
+     */
     unstyled?: boolean;
+    /** Extra CSS class name forwarded to the paginator. */
     paginatorClassName?: string;
+    /** Cratis-owned attributes for paginator parts. */
+    paginatorPt?: TablePaginatorParts;
+    /**
+     * @deprecated Cratis paginator parts always merge. Remove this renderer-era option.
+     */
+    paginatorPtOptions?: object;
+    /** Accessible names for the paginator controls. Override any to localize. */
     paginatorAriaLabels?: TablePaginatorProps['ariaLabels'];
 }
+/**
+ * A paged data table bound to a real-time Cratis Arc observable query
+ * (`IObservableQueryFor<TDataType, TArguments>`). Subscribes via
+ * `useObservableQueryWithPaging`, so the table re-renders automatically as the
+ * underlying read model changes server-side. Rows render through the semantic Cratis-owned
+ * {@link DataTableCore} inside an internally-scrolling region that resizes to
+ * fill its container.
+ *
+ * ## Children
+ *
+ * Children are Cratis `<Column>` elements describing the visible columns.
+ *
+ * ```tsx
+ * import { DataTableForObservableQuery, Column } from '@cratis/components/DataTables';
+ * import { AllTasks } from './AllTasks';     // observable proxy from C#
+ *
+ * <DataTableForObservableQuery query={AllTasks} emptyMessage="No tasks">
+ *     <Column field="title" header="Title" sortable />
+ *     <Column field="assignee" header="Assignee" />
+ * </DataTableForObservableQuery>
+ * ```
+ *
+ * Use {@link DataTableForQuery} for one-shot snapshot queries. Use
+ * {@link DataPage} for a higher-level layout that combines this table with
+ * an action menubar, selection, and a details pane.
+ *
+ * @typeParam TQuery - The query class (proxy generated from C# `IObservableQueryFor`).
+ * @typeParam TDataType - The row type returned by the query.
+ * @typeParam TArguments - The query's argument object type.
+ * @param props - {@link DataTableForObservableQueryProps}.
+ */
 export declare const DataTableForObservableQuery: <TQuery extends IObservableQueryFor<TDataType, TArguments> | IObservableQueryFor<TDataType[], TArguments>, TDataType extends object, TArguments extends object>(props: DataTableForObservableQueryProps<TQuery, TDataType, TArguments>) => import("react").JSX.Element;
-//# sourceMappingURL=DataTableForObservableQuery.d.ts.map

package/dist/esm/DataTables/DataTableForObservableQuery.js

@@ -6,55 +6,7 @@ import { DataTableCore } from './DataTableCore.js';
 import { TablePaginator } from './TablePaginator.js';
 
 const paging = new Paging(0, 20);
-/**
- * A paged data table bound to a real-time Cratis Arc observable query
- * (`IObservableQueryFor<TDataType, TArguments>`). Subscribes via
- * `useObservableQueryWithPaging`, so the table re-renders automatically as the
- * underlying read model changes server-side. Rows render through the headless
- * {@link DataTableCore} inside an internally-scrolling region that resizes to
- * fill its container.
- *
- * ## Children
- *
- * Children are Cratis `<Column>` elements describing the visible columns.
- *
- * ```tsx
- * import { DataTableForObservableQuery, Column } from '@cratis/components/DataTables';
- * import { AllTasks } from './AllTasks';     // observable proxy from C#
- *
- * <DataTableForObservableQuery query={AllTasks} emptyMessage="No tasks">
- *     <Column field="title" header="Title" sortable />
- *     <Column field="assignee" header="Assignee" />
- * </DataTableForObservableQuery>
- * ```
- *
- * Use {@link DataTableForQuery} for one-shot snapshot queries. Use
- * {@link DataPage} for a higher-level layout that combines this table with
- * an action menubar, selection, and a details pane.
- *
- * @typeParam TQuery - The query class (proxy generated from C# `IObservableQueryFor`).
- * @typeParam TDataType - The row type returned by the query.
- * @typeParam TArguments - The query's argument object type.
- * @param props - {@link DataTableForObservableQueryProps}.
- */
 const DataTableForObservableQuery = (props) => {
-    // Type arguments are supplied explicitly, and the constructor is erased on the way in
-    // (Cratis/Components#135). Two separate defects in `@cratis/arc.react` make the plain call
-    // fail to type-check:
-    //
-    // 1. `useObservableQueryWithPaging<TDataType, TQuery extends IObservableQueryFor<TDataType>, …>`
-    //    gives `TDataType` no inference site — it appears only inside `TQuery`'s constraint — so it
-    //    silently falls back to `unknown` and `result` comes back as `QueryResultWithState<unknown>`.
-    // 2. `ObservableQuerySubscription<T>` carries a `private _connection`, which makes it nominally
-    //    typed. `@cratis/arc.react` pins `@cratis/arc` to an exact version, so any consumer whose own
-    //    `@cratis/arc` differs by even a patch gets a second nested copy — two declarations of that
-    //    class, and TS2345 "types have separate declarations of a private property". Our peer range
-    //    deliberately spans `>=20.3.1 <22`, so we cannot assume a consumer's tree is deduped.
-    //
-    // Erasing the constructor type sidesteps the nominal comparison, and naming `TDataType`
-    // explicitly recovers the row type this component is generic over — strictly better than the
-    // `unknown` the inference would otherwise produce. Remove both once Arc returns an interface
-    // from `subscribe()` and makes `TDataType` inferable.
     const [result, , setPage] = useObservableQueryWithPaging(props.query, paging, props.queryArguments);
     const containerRef = useRef(null);
     const [tableHeight, setTableHeight] = useState(600);
@@ -62,7 +14,6 @@ const DataTableForObservableQuery = (props) => {
     const totalItems = result.paging.totalItems;
     const pageCount = result.paging.totalPages;
     const showPaginator = totalItems > 0 && pageCount > 1;
-    // SAFETY: Arc observable collection queries are row-typed while runtime data is the current row array.
     const rows = result.data;
     const emptyMessage = result.isPerforming && rows.length === 0 ? null : props.emptyMessage;
     useEffect(() => {
@@ -104,10 +55,10 @@ const DataTableForObservableQuery = (props) => {
             border: '1px solid var(--cratis-surface-border)',
             borderRadius: 'var(--cratis-border-radius)',
             overflow: 'hidden',
-        }, children: [jsx("div", { style: { height: `${tableHeight}px`, overflow: 'hidden' }, children: jsx(DataTableCore, { data: rows, dataKey: props.dataKey, emptyMessage: emptyMessage, selectionMode: 'single', selection: props.selection, onSelectionChange: props.onSelectionChange, globalFilterFields: props.globalFilterFields, defaultFilters: props.defaultFilters, scrollable: true, scrollHeight: '100%', className: props.className, style: { minWidth: '100%' }, pt: props.pt, ptOptions: props.ptOptions, unstyled: props.unstyled, children: props.children }) }), showPaginator && (jsx("div", { style: {
+        }, children: [jsx("div", { style: { height: `${tableHeight}px`, overflow: 'hidden' }, children: jsx(DataTableCore, { data: rows, dataKey: props.dataKey, emptyMessage: emptyMessage, selectionMode: 'single', selection: props.selection, onSelectionChange: props.onSelectionChange, globalFilterFields: props.globalFilterFields, globalSearchPlaceholder: props.globalSearchPlaceholder, globalSearchAriaLabel: props.globalSearchAriaLabel, defaultFilters: props.defaultFilters, scrollable: true, scrollHeight: '100%', className: props.className, style: { minWidth: '100%' }, pt: props.pt, ptOptions: props.ptOptions, unstyled: props.unstyled, children: props.children }) }), showPaginator && (jsx("div", { style: {
                     borderTop: '1px solid var(--cratis-surface-border)',
                     flexShrink: 0,
-                }, children: jsx(TablePaginator, { page: result.paging.page, pageCount: pageCount, onPageChange: setPage, totalItems: totalItems, pageSize: paging.pageSize, className: props.paginatorClassName, ariaLabels: props.paginatorAriaLabels }) }))] }));
+                }, children: jsx(TablePaginator, { page: result.paging.page, pageCount: pageCount, onPageChange: setPage, totalItems: totalItems, pageSize: paging.pageSize, className: props.paginatorClassName, ariaLabels: props.paginatorAriaLabels, pt: props.paginatorPt, ptOptions: props.paginatorPtOptions }) }))] }));
 };
 
 export { DataTableForObservableQuery };

package/dist/esm/DataTables/DataTableForObservableQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableForObservableQuery.js","sources":["../../../DataTables/DataTableForObservableQuery.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;;;;AAoGA,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;AACI,MAAM,2BAA2B,GAAG,CAOvC,KAAsE,KACtE;;;;;;;;;;;;;;;;;;IAkBA,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,4BAA4B,CAItD,KAAK,CAAC,KAAc,EAAE,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC;AACrD,IAAA,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC;IACjD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAS,GAAG,CAAC;AAC3D,IAAA,MAAM,UAAU,GAAG,MAAM,CAA4C,SAAS,CAAC;AAC/E,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;AAC3C,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;IAC1C,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC;;AAGrD,IAAA,MAAM,IAAI,GAAG,MAAM,CAAC,IAA8B;IAClD,MAAM,YAAY,GACd,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,YAAY;IAExE,SAAS,CAAC,MAAK;QACX,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE;QAE3B,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,KAAI;AAClD,YAAA,IAAI,UAAU,CAAC,OAAO,EAAE;AACpB,gBAAA,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;YACpC;AAEA,YAAA,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,MAAK;AACjC,gBAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;AACzB,oBAAA,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM;AAChD,oBAAA,IAAI,eAAe,GAAG,CAAC,EAAE;wBACrB,MAAM,eAAe,GAAG,aAAa,GAAG,EAAE,GAAG,CAAC;AAC9C,wBAAA,MAAM,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,CAAC;wBAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC;AAEjD,wBAAA,cAAc,CAAC,CAAC,UAAU,KAAI;4BAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE;AACtC,gCAAA,OAAO,SAAS;4BACpB;AACA,4BAAA,OAAO,UAAU;AACrB,wBAAA,CAAC,CAAC;oBACN;gBACJ;YACJ,CAAC,EAAE,EAAE,CAAC;AACV,QAAA,CAAC,CAAC;AAEF,QAAA,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;AAE5C,QAAA,OAAO,MAAK;AACR,YAAA,IAAI,UAAU,CAAC,OAAO,EAAE;AACpB,gBAAA,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;YACpC;YACA,cAAc,CAAC,UAAU,EAAE;AAC/B,QAAA,CAAC;AACL,IAAA,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;AAEnB,IAAA,QACIA,IAAA,CAAA,KAAA,EAAA,EACI,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE;AACH,YAAA,OAAO,EAAE,MAAM;AACf,YAAA,aAAa,EAAE,QAAQ;AACvB,YAAA,MAAM,EAAE,MAAM;AACd,YAAA,MAAM,EAAE,wCAAwC;AAChD,YAAA,YAAY,EAAE,6BAA6B;AAC3C,YAAA,QAAQ,EAAE,QAAQ;SACrB,EAAA,QAAA,EAAA,CAEDC,GAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAE,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,EAAA,CAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAA,QAAA,EAC1DA,GAAA,CAAC,aAAa,EAAA,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAC,QAAQ,EACtB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAC1C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAC5C,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,UAAU,QACV,YAAY,EAAC,MAAM,EACnB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAC3B,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAA,QAAA,EAEvB,KAAK,CAAC,QAAQ,EAAA,CACH,EAAA,CACd,EAEL,aAAa,KACVA,GAAA,CAAA,KAAA,EAAA,EACI,KAAK,EAAE;AACH,oBAAA,SAAS,EAAE,wCAAwC;AACnD,oBAAA,UAAU,EAAE,CAAC;iBAChB,EAAA,QAAA,EAEDA,GAAA,CAAC,cAAc,EAAA,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EACxB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,SAAS,EAAE,KAAK,CAAC,kBAAkB,EAEnC,UAAU,EAAE,KAAK,CAAC,mBAAmB,GACvC,EAAA,CACA,CACT,CAAA,EAAA,CACC;AAEd;;"}
+{"version":3,"file":"DataTableForObservableQuery.js","sources":["../../../DataTables/DataTableForObservableQuery.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":"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"}

package/dist/esm/DataTables/DataTableForQuery.d.ts

@@ -1,27 +1,131 @@
-import type { DataTableRootProps } from '@primereact/types/primitive/datatable';
+import type { DataTableParts } from './DataTableCore.js';
 import type { Constructor } from '@cratis/fundamentals';
 import { type IQueryFor } from '@cratis/arc/queries';
 import type { ReactNode } from 'react';
-import { type TablePaginatorProps } from './TablePaginator';
-import type { DataTableFilterMeta } from './DataTableFilterMeta';
-import type { DataTableSelectionChangeEvent } from './DataTableSelectionChangeEvent';
+import { type TablePaginatorParts, type TablePaginatorProps } from './TablePaginator.js';
+import type { DataTableFilterMeta } from './DataTableFilterMeta.js';
+import type { DataTableSelectionChangeEvent } from './DataTableSelectionChangeEvent.js';
+/**
+ * Props for {@link DataTableForQuery}.
+ *
+ * @typeParam TQuery - The query class implementing `IQueryFor`.
+ * @typeParam TDataType - The row type returned by the query.
+ * @typeParam TArguments - The query's argument object type, or `object` if it takes none.
+ */
 export interface DataTableForQueryProps<TQuery extends IQueryFor<TDataType, TArguments> | IQueryFor<TDataType[], TArguments>, TDataType extends object, TArguments extends object> {
+    /**
+     * Children to render — `<Column>` elements describing the visible columns.
+     */
     children?: ReactNode;
+    /**
+     * The type of query to use
+     */
     query: Constructor<TQuery>;
+    /**
+     * Optional Arguments to pass to the query
+     */
     queryArguments?: TArguments;
+    /**
+     * The message to show when there is no data
+     */
     emptyMessage: string;
+    /**
+     * The key to use for the data
+     */
     dataKey?: string | undefined;
+    /**
+     * The current selection.
+     */
     selection?: TDataType | undefined | null;
+    /**
+     * Callback for when the selection changes
+     */
     onSelectionChange?(event: DataTableSelectionChangeEvent<TDataType>): void;
+    /**
+     * Fields to use for global filtering
+     */
     globalFilterFields?: string[] | undefined;
+    /** Placeholder for the loaded-page search input. */
+    globalSearchPlaceholder?: string;
+    /** Accessible name for the loaded-page search input. */
+    globalSearchAriaLabel?: string;
+    /**
+     * Default filters to use
+     */
     defaultFilters?: DataTableFilterMeta;
+    /**
+     * @deprecated Filtering is always applied to the currently loaded page.
+     * This compatibility prop no longer toggles behavior and does not change
+     * server-reported pagination totals. Retained for source compatibility only.
+     */
     clientFiltering?: boolean;
+    /**
+     * Extra CSS class name forwarded to the underlying DataTable root.
+     */
     className?: string;
-    pt?: DataTableRootProps['pt'];
-    ptOptions?: DataTableRootProps['ptOptions'];
+    /** Cratis-owned per-part attributes applied to the underlying table. */
+    pt?: DataTableParts;
+    /**
+     * @deprecated Cratis parts always merge. Remove this renderer-era option.
+     */
+    ptOptions?: object;
+    /**
+     * @deprecated Components always uses consumer-owned CSS. Customize through `pt` and CSS instead.
+     */
     unstyled?: boolean;
+    /** Extra CSS class name forwarded to the paginator. */
     paginatorClassName?: string;
+    /** Cratis-owned attributes for paginator parts. */
+    paginatorPt?: TablePaginatorParts;
+    /**
+     * @deprecated Cratis paginator parts always merge. Remove this renderer-era option.
+     */
+    paginatorPtOptions?: object;
+    /** Accessible names for the paginator controls. Override any to localize. */
     paginatorAriaLabels?: TablePaginatorProps['ariaLabels'];
 }
+/**
+ * A paged data table bound to a snapshot Cratis Arc query
+ * (`IQueryFor<TDataType, TArguments>`). Subscribes via
+ * `useQueryWithPaging` from `@cratis/arc.react/queries`, renders the result
+ * page through the semantic Cratis-owned {@link DataTableCore}, and shows a
+ * {@link TablePaginator} when the result set exceeds one page.
+ *
+ * ## What `TQuery` is
+ *
+ * `TQuery` is the auto-generated TypeScript class produced by the Arc proxy
+ * generator from a C# read model's static query method. `dotnet build`
+ * writes a `.ts` file per query with the right return type and a `use()`
+ * hook; importing the class is all the connection-to-the-backend you need.
+ *
+ * ## Children
+ *
+ * Children are Cratis `<Column>` elements describing the visible columns —
+ * `field`, `header`, custom `body` templates, and `sortable`.
+ *
+ * ```tsx
+ * import { DataTableForQuery, Column } from '@cratis/components/DataTables';
+ * import { AllAuthors } from './AllAuthors';     // proxy from C#
+ *
+ * <DataTableForQuery query={AllAuthors} emptyMessage="No authors">
+ *     <Column field="name"  header="Name" sortable />
+ *     <Column field="email" header="Email" />
+ * </DataTableForQuery>
+ * ```
+ *
+ * Use {@link DataTableForObservableQuery} for queries that should update in
+ * real time as the underlying read model changes server-side. Use
+ * {@link DataPage} for a higher-level layout that combines this table with
+ * an action menubar, selection, and a details pane.
+ *
+ * ## Styling
+ *
+ * Forward `pt` / `ptOptions` / `unstyled` / `className` to the underlying
+ * DataTable. See [pass-through cheat sheet](../../Documentation/Styling/pass-through.md).
+ *
+ * @typeParam TQuery - The query class (proxy generated from C# `IQueryFor`).
+ * @typeParam TDataType - The row type returned by the query.
+ * @typeParam TArguments - The query's argument object type.
+ * @param props - {@link DataTableForQueryProps}.
+ */
 export declare const DataTableForQuery: <TQuery extends IQueryFor<TDataType, TArguments> | IQueryFor<TDataType[], TArguments>, TDataType extends object, TArguments extends object>(props: DataTableForQueryProps<TQuery, TDataType, TArguments>) => import("react").JSX.Element;
-//# sourceMappingURL=DataTableForQuery.d.ts.map

package/dist/esm/DataTables/DataTableForQuery.js

@@ -5,55 +5,10 @@ import { DataTableCore } from './DataTableCore.js';
 import { TablePaginator } from './TablePaginator.js';
 
 const paging = new Paging(0, 20);
-/**
- * A paged data table bound to a snapshot Cratis Arc query
- * (`IQueryFor<TDataType, TArguments>`). Subscribes via
- * `useQueryWithPaging` from `@cratis/arc.react/queries`, renders the result
- * page through the headless {@link DataTableCore}, and shows a
- * {@link TablePaginator} when the result set exceeds one page.
- *
- * ## What `TQuery` is
- *
- * `TQuery` is the auto-generated TypeScript class produced by the Arc proxy
- * generator from a C# read model's static query method. `dotnet build`
- * writes a `.ts` file per query with the right return type and a `use()`
- * hook; importing the class is all the connection-to-the-backend you need.
- *
- * ## Children
- *
- * Children are Cratis `<Column>` elements describing the visible columns —
- * `field`, `header`, custom `body` templates, and `sortable`.
- *
- * ```tsx
- * import { DataTableForQuery, Column } from '@cratis/components/DataTables';
- * import { AllAuthors } from './AllAuthors';     // proxy from C#
- *
- * <DataTableForQuery query={AllAuthors} emptyMessage="No authors">
- *     <Column field="name"  header="Name" sortable />
- *     <Column field="email" header="Email" />
- * </DataTableForQuery>
- * ```
- *
- * Use {@link DataTableForObservableQuery} for queries that should update in
- * real time as the underlying read model changes server-side. Use
- * {@link DataPage} for a higher-level layout that combines this table with
- * an action menubar, selection, and a details pane.
- *
- * ## Styling
- *
- * Forward `pt` / `ptOptions` / `unstyled` / `className` to the underlying
- * DataTable. See [pass-through cheat sheet](../../Documentation/Styling/pass-through.md).
- *
- * @typeParam TQuery - The query class (proxy generated from C# `IQueryFor`).
- * @typeParam TDataType - The row type returned by the query.
- * @typeParam TArguments - The query's argument object type.
- * @param props - {@link DataTableForQueryProps}.
- */
 const DataTableForQuery = (props) => {
     const [result, , , setPage] = useQueryWithPaging(props.query, paging, props.queryArguments);
     const totalItems = result.paging.totalItems;
     const pageCount = result.paging.totalPages;
-    // SAFETY: Arc collection queries are row-typed while their runtime data is the current row array.
     const rows = result.data;
     const emptyMessage = result.isPerforming && rows.length === 0 ? null : props.emptyMessage;
     return (jsxs("div", { style: {
@@ -63,10 +18,10 @@ const DataTableForQuery = (props) => {
             border: '1px solid var(--cratis-surface-border)',
             borderRadius: 'var(--cratis-border-radius)',
             overflow: 'hidden',
-        }, children: [jsx("div", { style: { flex: 1, minHeight: 0, overflow: 'auto' }, children: jsx(DataTableCore, { data: rows, dataKey: props.dataKey, emptyMessage: emptyMessage, selectionMode: 'single', selection: props.selection, onSelectionChange: props.onSelectionChange, globalFilterFields: props.globalFilterFields, defaultFilters: props.defaultFilters, className: props.className, style: { minWidth: '100%' }, pt: props.pt, ptOptions: props.ptOptions, unstyled: props.unstyled, children: props.children }) }), totalItems > 0 && pageCount > 1 && (jsx("div", { style: {
+        }, children: [jsx("div", { style: { flex: 1, minHeight: 0, overflow: 'hidden' }, children: jsx(DataTableCore, { data: rows, dataKey: props.dataKey, emptyMessage: emptyMessage, selectionMode: 'single', selection: props.selection, onSelectionChange: props.onSelectionChange, globalFilterFields: props.globalFilterFields, globalSearchPlaceholder: props.globalSearchPlaceholder, globalSearchAriaLabel: props.globalSearchAriaLabel, defaultFilters: props.defaultFilters, scrollable: true, scrollHeight: '100%', className: props.className, style: { minWidth: '100%' }, pt: props.pt, ptOptions: props.ptOptions, unstyled: props.unstyled, children: props.children }) }), totalItems > 0 && pageCount > 1 && (jsx("div", { style: {
                     borderTop: '1px solid var(--cratis-surface-border)',
                     flexShrink: 0,
-                }, children: jsx(TablePaginator, { page: result.paging.page, pageCount: pageCount, onPageChange: setPage, totalItems: totalItems, pageSize: paging.pageSize, className: props.paginatorClassName, ariaLabels: props.paginatorAriaLabels }) }))] }));
+                }, children: jsx(TablePaginator, { page: result.paging.page, pageCount: pageCount, onPageChange: setPage, totalItems: totalItems, pageSize: paging.pageSize, className: props.paginatorClassName, ariaLabels: props.paginatorAriaLabels, pt: props.paginatorPt, ptOptions: props.paginatorPtOptions }) }))] }));
 };
 
 export { DataTableForQuery };

package/dist/esm/DataTables/DataTableForQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableForQuery.js","sources":["../../../DataTables/DataTableForQuery.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;;;AAkGA,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CG;AACI,MAAM,iBAAiB,GAAG,CAK7B,KAA4D,KAC5D;IACA,MAAM,CAAC,MAAM,MAAM,OAAO,CAAC,GAAG,kBAAkB,CAC5C,KAAK,CAAC,KAAK,EACX,MAAM,EACN,KAAK,CAAC,cAAc,CACvB;AACD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;AAC3C,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;;AAG1C,IAAA,MAAM,IAAI,GAAG,MAAM,CAAC,IAA8B;IAClD,MAAM,YAAY,GACd,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,YAAY;IAExE,QACIA,IAAA,CAAA,KAAA,EAAA,EACI,KAAK,EAAE;AACH,YAAA,OAAO,EAAE,MAAM;AACf,YAAA,aAAa,EAAE,QAAQ;AACvB,YAAA,MAAM,EAAE,MAAM;AACd,YAAA,MAAM,EAAE,wCAAwC;AAChD,YAAA,YAAY,EAAE,6BAA6B;AAC3C,YAAA,QAAQ,EAAE,QAAQ;SACrB,EAAA,QAAA,EAAA,CAEDC,GAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAA,QAAA,EACnDA,GAAA,CAAC,aAAa,IACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAC,QAAQ,EACtB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAC1C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAC5C,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAC3B,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAA,QAAA,EAEvB,KAAK,CAAC,QAAQ,EAAA,CACH,GACd,EAEL,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,KAC5BA,GAAA,CAAA,KAAA,EAAA,EACI,KAAK,EAAE;AACH,oBAAA,SAAS,EAAE,wCAAwC;AACnD,oBAAA,UAAU,EAAE,CAAC;iBAChB,EAAA,QAAA,EAEDA,GAAA,CAAC,cAAc,EAAA,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EACxB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,SAAS,EAAE,KAAK,CAAC,kBAAkB,EACnC,UAAU,EAAE,KAAK,CAAC,mBAAmB,GACvC,EAAA,CACA,CACT,CAAA,EAAA,CACC;AAEd;;"}
+{"version":3,"file":"DataTableForQuery.js","sources":["../../../DataTables/DataTableForQuery.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;;;AAwHA,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;AA8CzB,MAAM,iBAAiB,GAAG,CAK7B,KAA4D,KAC5D;IACA,MAAM,CAAC,MAAM,MAAM,OAAO,CAAC,GAAG,kBAAkB,CAC5C,KAAK,CAAC,KAAK,EACX,MAAM,EACN,KAAK,CAAC,cAAc,CACvB;AACD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;AAC3C,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU;AAG1C,IAAA,MAAM,IAAI,GAAG,MAAM,CAAC,IAA8B;IAClD,MAAM,YAAY,GACd,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,YAAY;IAExE,QACIA,IAAA,CAAA,KAAA,EAAA,EACI,KAAK,EAAE;AACH,YAAA,OAAO,EAAE,MAAM;AACf,YAAA,aAAa,EAAE,QAAQ;AACvB,YAAA,MAAM,EAAE,MAAM;AACd,YAAA,MAAM,EAAE,wCAAwC;AAChD,YAAA,YAAY,EAAE,6BAA6B;AAC3C,YAAA,QAAQ,EAAE,QAAQ;AACrB,SAAA,EAAA,QAAA,EAAA,CAQDC,GAAA,CAAA,KAAA,EAAA,EAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAA,QAAA,EACrDA,GAAA,CAAC,aAAa,EAAA,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAC,QAAQ,EACtB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAC1C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAC5C,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,EACtD,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAClD,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,UAAU,EAAA,IAAA,EACV,YAAY,EAAC,MAAM,EACnB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAC3B,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,YAEvB,KAAK,CAAC,QAAQ,EAAA,CACH,EAAA,CACd,EAEL,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,KAC5BA,GAAA,CAAA,KAAA,EAAA,EACI,KAAK,EAAE;AACH,oBAAA,SAAS,EAAE,wCAAwC;AACnD,oBAAA,UAAU,EAAE,CAAC;iBAChB,EAAA,QAAA,EAEDA,GAAA,CAAC,cAAc,EAAA,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EACxB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,SAAS,EAAE,KAAK,CAAC,kBAAkB,EACnC,UAAU,EAAE,KAAK,CAAC,mBAAmB,EACrC,EAAE,EAAE,KAAK,CAAC,WAAW,EACrB,SAAS,EAAE,KAAK,CAAC,kBAAkB,EAAA,CACrC,EAAA,CACA,CACT,CAAA,EAAA,CACC;AAEd;;"}

package/dist/esm/DataTables/DataTableSelectionChangeEvent.d.ts

@@ -1,6 +1,16 @@
 import type { SyntheticEvent } from 'react';
+/**
+ * Fired when the selected row of a Cratis data table changes. Replaces
+ * the legacy renderer's single-selection event.
+ * The `value` field is preserved so existing `event.value` call sites keep
+ * working.
+ *
+ * @typeParam TData - The row type.
+ */
 export interface DataTableSelectionChangeEvent<TData> {
+    /** The newly-selected row, or `null` when the selection was cleared. */
     value: TData | null;
+    /** The DOM event that triggered the change, when available. */
     originalEvent?: SyntheticEvent;
 }
 //# sourceMappingURL=DataTableSelectionChangeEvent.d.ts.map

package/dist/esm/DataTables/DataTableSelectionChangeEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableSelectionChangeEvent.d.ts","sourceRoot":"","sources":["../../../DataTables/DataTableSelectionChangeEvent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAW5C,MAAM,WAAW,6BAA6B,CAAC,KAAK;IAEhD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,aAAa,CAAC,EAAE,cAAc,CAAC;CAClC"}
+{"version":3,"file":"DataTableSelectionChangeEvent.d.ts","sourceRoot":"","sources":["../../../DataTables/DataTableSelectionChangeEvent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,6BAA6B,CAAC,KAAK;IAChD,wEAAwE;IACxE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,cAAc,CAAC;CAClC"}

package/dist/esm/DataTables/DataTableSelectionChangeEvent.js

@@ -1,2 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 export {};
 //# sourceMappingURL=DataTableSelectionChangeEvent.js.map

package/dist/esm/DataTables/DataTableSelectionChangeEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableSelectionChangeEvent.js","sourceRoot":"","sources":["../../../DataTables/DataTableSelectionChangeEvent.ts"],"names":[],"mappings":""}
+{"version":3,"file":"DataTableSelectionChangeEvent.js","sourceRoot":"","sources":["../../../DataTables/DataTableSelectionChangeEvent.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/esm/DataTables/TablePaginator.d.ts

@@ -1,9 +1,35 @@
+import type { HTMLAttributes } from 'react';
+import type { ButtonParts } from '../Common/Button.js';
+/** Stable Cratis-owned paginator parts. */
+export interface TablePaginatorParts {
+    /** Pagination navigation root. */
+    root?: HTMLAttributes<HTMLDivElement>;
+    /** Loaded item-range report. */
+    range?: HTMLAttributes<HTMLSpanElement>;
+    /** Current page / page-count report. */
+    info?: HTMLAttributes<HTMLSpanElement>;
+    /** First-page Button parts. */
+    first?: ButtonParts;
+    /** Previous-page Button parts. */
+    previous?: ButtonParts;
+    /** Next-page Button parts. */
+    next?: ButtonParts;
+    /** Last-page Button parts. */
+    last?: ButtonParts;
+}
+/** Props for {@link TablePaginator}. */
 export interface TablePaginatorProps {
+    /** The current page, zero-based. */
     page: number;
+    /** The total number of pages. */
     pageCount: number;
+    /** Invoked with the requested zero-based page. */
     onPageChange: (page: number) => void;
+    /** Total number of records across all pages — enables the "X–Y of Z" range report. */
     totalItems?: number;
+    /** Rows per page — enables the "X–Y of Z" range report. */
     pageSize?: number;
+    /** Accessible names for the paginator and its controls. Override any to localize. */
     ariaLabels?: {
         navigation?: string;
         first?: string;
@@ -11,7 +37,17 @@ export interface TablePaginatorProps {
         next?: string;
         last?: string;
     };
+    /** Extra class name for the paginator container. */
     className?: string;
+    /** Cratis-owned paginator part attributes. */
+    pt?: TablePaginatorParts;
+    /**
+     * @deprecated Cratis parts always merge. Remove this renderer-era option.
+     */
+    ptOptions?: object;
 }
-export declare const TablePaginator: ({ page, pageCount, onPageChange, totalItems, pageSize, ariaLabels, className, }: TablePaginatorProps) => import("react").JSX.Element;
-//# sourceMappingURL=TablePaginator.d.ts.map
+/**
+ * A minimal first/previous/next/last paginator. The Cratis data tables drive paging through Arc's
+ * paging hook and receive requested zero-based pages through `onPageChange`.
+ */
+export declare const TablePaginator: (props: TablePaginatorProps) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/esm/DataTables/TablePaginator.js

@@ -1,30 +1,15 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
-import { Button } from 'primereact/button';
-import { useLocale } from '@primereact/core/locale';
-import { paginatorRange } from './paginatorRange.js';
+import { unstable_useSlot } from '../renderer/RendererContext.js';
+import { renderSlot } from '../renderer/renderSlot.js';
+import { TablePaginatorImplementation } from './TablePaginatorImplementation.js';
 
-/**
- * A minimal first/previous/next/last paginator. PrimeReact 11's `Paginator`
- * is a headless compositional slot rather than a ready-made control, and the
- * Cratis data tables drive paging through Arc's paging hook rather than the
- * table's internal pagination — so this renders the page controls wired to a
- * simple `onPageChange(pageIndex)` callback.
- */
-const TablePaginator = ({ page, pageCount, onPageChange, totalItems, pageSize, ariaLabels, className, }) => {
-    const { messages } = useLocale();
-    const isFirst = page <= 0;
-    const isLast = page >= pageCount - 1;
-    const rangeReport = paginatorRange(page, pageSize, totalItems);
-    const labels = {
-        navigation: ariaLabels?.navigation ?? messages.aria.navigation,
-        first: ariaLabels?.first ?? messages.aria.firstPageLabel,
-        previous: ariaLabels?.previous ?? messages.aria.prevPageLabel,
-        next: ariaLabels?.next ?? messages.aria.nextPageLabel,
-        last: ariaLabels?.last ?? messages.aria.lastPageLabel,
-    };
-    return (jsxs("div", { role: 'navigation', "aria-label": labels.navigation, className: className
-            ? `cratis-table-paginator ${className}`
-            : 'cratis-table-paginator', children: [rangeReport && (jsx("span", { className: 'cratis-table-paginator-range', children: rangeReport })), jsx(Button, { variant: 'text', disabled: isFirst, onClick: () => onPageChange(0), "aria-label": labels.first, children: jsx("i", { className: 'pi pi-angle-double-left' }) }), jsx(Button, { variant: 'text', disabled: isFirst, onClick: () => onPageChange(page - 1), "aria-label": labels.previous, children: jsx("i", { className: 'pi pi-angle-left' }) }), jsxs("span", { className: 'cratis-table-paginator-info', children: [page + 1, " / ", Math.max(pageCount, 1)] }), jsx(Button, { variant: 'text', disabled: isLast, onClick: () => onPageChange(page + 1), "aria-label": labels.next, children: jsx("i", { className: 'pi pi-angle-right' }) }), jsx(Button, { variant: 'text', disabled: isLast, onClick: () => onPageChange(pageCount - 1), "aria-label": labels.last, children: jsx("i", { className: 'pi pi-angle-double-right' }) })] }));
+const coreTablePaginatorDeclaration = Object.freeze({
+    mode: 'atomic',
+    fidelity: 'native',
+    render: TablePaginatorImplementation,
+});
+const TablePaginator = (props) => {
+    const declaration = unstable_useSlot('datatables.paginator', coreTablePaginatorDeclaration);
+    return renderSlot(declaration, props);
 };
 
 export { TablePaginator };

package/dist/esm/DataTables/TablePaginator.js.map

@@ -1 +1 @@
-{"version":3,"file":"TablePaginator.js","sources":["../../../DataTables/TablePaginator.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx"],"mappings":";;;;;AA+BA;;;;;;AAMG;MACU,cAAc,GAAG,CAAC,EAC3B,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,GACS,KAAI;AACtB,IAAA,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE;AAChC,IAAA,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC;AACzB,IAAA,MAAM,MAAM,GAAG,IAAI,IAAI,SAAS,GAAG,CAAC;IACpC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;AAC9D,IAAA,MAAM,MAAM,GAAG;QACX,UAAU,EAAE,UAAU,EAAE,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU;QAC9D,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc;QACxD,QAAQ,EAAE,UAAU,EAAE,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa;QAC7D,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa;QACrD,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa;KACxD;AAED,IAAA,QACIA,IAAA,CAAA,KAAA,EAAA,EACI,IAAI,EAAC,YAAY,EAAA,YAAA,EACL,MAAM,CAAC,UAAU,EAC7B,SAAS,EACL;cACM,CAAA,uBAAA,EAA0B,SAAS,CAAA;AACrC,cAAE,wBAAwB,EAAA,QAAA,EAAA,CAGjC,WAAW,KACRC,GAAA,CAAA,MAAA,EAAA,EAAM,SAAS,EAAC,8BAA8B,YAAE,WAAW,EAAA,CAAQ,CACtE,EACDA,GAAA,CAAC,MAAM,EAAA,EACH,OAAO,EAAC,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,gBAClB,MAAM,CAAC,KAAK,EAAA,QAAA,EAExBA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,yBAAyB,EAAA,CAAG,EAAA,CACpC,EACTA,GAAA,CAAC,MAAM,EAAA,EACH,OAAO,EAAC,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,EAAA,YAAA,EACzB,MAAM,CAAC,QAAQ,EAAA,QAAA,EAE3BA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,kBAAkB,GAAG,EAAA,CAC7B,EACTD,eAAM,SAAS,EAAC,6BAA6B,EAAA,QAAA,EAAA,CACxC,IAAI,GAAG,CAAC,EAAA,KAAA,EAAK,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA,EAAA,CACjC,EACPC,GAAA,CAAC,MAAM,IACH,OAAO,EAAC,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,EAAA,YAAA,EACzB,MAAM,CAAC,IAAI,EAAA,QAAA,EAEvBA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,mBAAmB,EAAA,CAAG,GAC9B,EACTA,GAAA,CAAC,MAAM,EAAA,EACH,OAAO,EAAC,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC,EAAA,YAAA,EAC9B,MAAM,CAAC,IAAI,EAAA,QAAA,EAEvBA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,0BAA0B,GAAG,EAAA,CACrC,CAAA,EAAA,CACP;AAEd;;"}
+{"version":3,"file":"TablePaginator.js","sources":["../../../DataTables/TablePaginator.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;AA0DA,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;AAChD,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,QAAQ,EAAE,QAAQ;AAClB,IAAA,MAAM,EAAE,4BAA4B;AACvC,CAAA,CAA4D;AAMtD,MAAM,cAAc,GAAG,CAAC,KAA0B,KAAI;IACzD,MAAM,WAAW,GAAG,gBAAgB,CAChC,sBAAsB,EACtB,6BAA6B,CAChC;AACD,IAAA,OAAO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC;AACzC;;"}

package/dist/esm/DataTables/TablePaginatorImplementation.d.ts

@@ -0,0 +1,8 @@
+import type { TablePaginatorProps } from './TablePaginator.js';
+/**
+ * A minimal first/previous/next/last paginator. The
+ * Cratis data tables drive paging through Arc's paging hook rather than the
+ * table's internal pagination — so this renders the page controls wired to a
+ * simple `onPageChange(pageIndex)` callback.
+ */
+export declare const TablePaginatorImplementation: ({ page, pageCount, onPageChange, totalItems, pageSize, ariaLabels, className, pt, }: TablePaginatorProps) => import("react").JSX.Element;