@constructive-io/sheets 0.3.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/README.md +19 -24
  2. package/dist/advanced.cjs +659 -474
  3. package/dist/advanced.cjs.map +1 -1
  4. package/dist/advanced.d.cts +9 -10
  5. package/dist/advanced.d.ts +9 -10
  6. package/dist/advanced.js +3 -3
  7. package/dist/auth.cjs +10 -10
  8. package/dist/auth.cjs.map +1 -1
  9. package/dist/auth.d.cts +5 -4
  10. package/dist/auth.d.ts +5 -4
  11. package/dist/auth.js +3 -3
  12. package/dist/{chunk-GLVZSPV2.js → chunk-4EZ6A23C.js} +4 -3
  13. package/dist/chunk-4EZ6A23C.js.map +1 -0
  14. package/dist/{chunk-FNVHSOQQ.js → chunk-KKAWMVEG.js} +11 -11
  15. package/dist/chunk-KKAWMVEG.js.map +1 -0
  16. package/dist/{chunk-4PGPVMZB.js → chunk-KOZAW264.js} +4 -3
  17. package/dist/chunk-KOZAW264.js.map +1 -0
  18. package/dist/{chunk-ODUBS2NL.js → chunk-KVPVEXWB.js} +40 -17
  19. package/dist/chunk-KVPVEXWB.js.map +1 -0
  20. package/dist/{chunk-TU7ATZ4X.js → chunk-LR64FLWO.js} +301 -410
  21. package/dist/chunk-LR64FLWO.js.map +1 -0
  22. package/dist/chunk-ZETPUEXH.js +494 -0
  23. package/dist/chunk-ZETPUEXH.js.map +1 -0
  24. package/dist/{date-editor-CXKKGNL6.js → date-editor-QT47WY5T.js} +5 -3
  25. package/dist/date-editor-QT47WY5T.js.map +1 -0
  26. package/dist/{editor-props-M6Dh0P9f.d.ts → grid-cell-types-C3ARj148.d.cts} +70 -62
  27. package/dist/{editor-props-M6Dh0P9f.d.cts → grid-cell-types-C3ARj148.d.ts} +70 -62
  28. package/dist/index.cjs +1150 -703
  29. package/dist/index.cjs.map +1 -1
  30. package/dist/index.d.cts +123 -35
  31. package/dist/index.d.ts +123 -35
  32. package/dist/index.js +323 -99
  33. package/dist/index.js.map +1 -1
  34. package/dist/{sheets-context-CojEFlaY.d.cts → sheets-context-B03WDhZ9.d.cts} +36 -6
  35. package/dist/{sheets-context-Da55TTR9.d.ts → sheets-context-DmVCOgiX.d.ts} +36 -6
  36. package/dist/styles.css +6 -0
  37. package/dist/testing.cjs +476 -108
  38. package/dist/testing.cjs.map +1 -1
  39. package/dist/testing.d.cts +11 -7
  40. package/dist/testing.d.ts +11 -7
  41. package/dist/testing.js +34 -8
  42. package/dist/testing.js.map +1 -1
  43. package/package.json +15 -16
  44. package/dist/chunk-4PGPVMZB.js.map +0 -1
  45. package/dist/chunk-FNVHSOQQ.js.map +0 -1
  46. package/dist/chunk-GLVZSPV2.js.map +0 -1
  47. package/dist/chunk-H4JJTMP5.js +0 -160
  48. package/dist/chunk-H4JJTMP5.js.map +0 -1
  49. package/dist/chunk-ODUBS2NL.js.map +0 -1
  50. package/dist/chunk-TU7ATZ4X.js.map +0 -1
  51. package/dist/date-editor-CXKKGNL6.js.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,14 +1,14 @@
1
- import * as react_jsx_runtime from 'react/jsx-runtime';
2
- import { b as SheetsConfig, C as CellProps, c as CellTypeDefinition, d as CellTypeMatchInput, e as SheetsCellRenderContext, f as SheetsScopeKey, S as SheetsExecuteFn, a as SheetsUploadFn, g as SheetsBackendAdapter } from './sheets-context-CojEFlaY.cjs';
3
- export { n as AdapterListQuery, o as AdapterListResult, p as AdapterPageInfo, A as AdapterTableContext, s as CellColumnDescriptor, r as CellTypePlugin, j as SheetsAuthEmbedded, k as SheetsAuthStandalone, h as SheetsContext, i as SheetsContextValue, t as SheetsLogger, l as createSheetsExecute, m as createSheetsUpload, q as defineCellType, u as useSheetsContext } from './sheets-context-CojEFlaY.cjs';
1
+ import * as react from 'react';
2
+ import react__default, { Component, ReactNode, ErrorInfo } from 'react';
3
+ import { b as SheetsConfig, S as SheetsExecuteFn, C as CellProps, c as CellTypeDefinition, d as SheetsCellRenderContext, e as CellTypeMatchInput, f as SheetsScopeKey, a as SheetsUploadFn, g as SheetsBackendAdapter } from './sheets-context-B03WDhZ9.cjs';
4
+ export { A as AdapterListQuery, h as AdapterListResult, i as AdapterPageInfo, j as AdapterTableContext, k as CellColumnDescriptor, l as CellTypePlugin, m as SheetsAuthEmbedded, n as SheetsAuthStandalone, o as SheetsContext, p as SheetsContextValue, q as SheetsLogger, r as createSheetsExecute, s as createSheetsUpload, t as defineCellType, u as useSheetsContext } from './sheets-context-B03WDhZ9.cjs';
4
5
  import { StoreApi } from 'zustand';
5
- import { R as RelationInfo, d as RelationInfoSlice, E as EditorProps, F as FieldMetadata, S as SheetsCell, e as CellRegistryEntry, b as CellType, f as CellRenderer, g as CellPlugin, h as ColumnSchema } from './editor-props-M6Dh0P9f.cjs';
6
- export { B as BaseCellProps, c as CellCategory, l as CellValue, m as FieldMetadata, i as RelationKind, n as RowData, a as SheetsCellKind, T as TableSchema, j as buildRelationInfoFromMeta, k as isImageField, r as resolveCellType } from './editor-props-M6Dh0P9f.cjs';
7
- import React__default, { Component, ReactNode, ErrorInfo } from 'react';
6
+ import { R as RelationInfo, d as RelationInfoSlice, E as EditorProps, F as FieldMetadata, S as SheetsCell, e as CellRegistryEntry, b as CellType, f as CellRenderer, g as CellPlugin, h as ColumnSchema } from './grid-cell-types-C3ARj148.cjs';
7
+ export { B as BaseCellProps, c as CellCategory, i as CellValue, j as FieldMetadata, k as RelationKind, l as RowData, a as SheetsCellKind, T as TableSchema, m as buildRelationInfoFromMeta, n as isImageField, r as resolveCellType } from './grid-cell-types-C3ARj148.cjs';
8
+ import { RowIdentityValue, TableWriteCapability, MetaTable as MetaTable$1, FieldSelection, MutationOptions, PageInfo, MetaQuery, QueryOptions, Filter } from '@constructive-io/data';
9
+ export { DataError } from '@constructive-io/data';
8
10
  import * as _tanstack_react_query from '@tanstack/react-query';
9
11
  import { UseQueryResult } from '@tanstack/react-query';
10
- import { FieldSelection, MutationOptions, PageInfo, MetaQuery, QueryOptions, Filter } from '@constructive-io/data';
11
- export { DataError } from '@constructive-io/data';
12
12
  import { z } from 'zod';
13
13
  export { SheetsAuthGate, SheetsAuthGateProps, useSheetsForgotPassword, useSheetsLogin, useSheetsRegister, useSheetsResetPassword } from './auth.cjs';
14
14
  import 'graphql';
@@ -17,7 +17,44 @@ interface SheetsProviderProps {
17
17
  config: SheetsConfig;
18
18
  children: React.ReactNode;
19
19
  }
20
- declare function SheetsProvider({ config, children }: SheetsProviderProps): react_jsx_runtime.JSX.Element;
20
+ declare function SheetsProvider({ config, children }: SheetsProviderProps): react.JSX.Element;
21
+
22
+ /**
23
+ * Presigned-URL upload helpers for the sheets cell-upload seam.
24
+ *
25
+ * Replaces the legacy multipart `<endpoint>/upload` POST. The flow is:
26
+ * 1. SHA-256 hash the file bytes (Web Crypto, zero new deps)
27
+ * 2. Call the presigned upload op (discovered via introspection) to get a
28
+ * presigned PUT url + fileId
29
+ * 3. PUT the raw bytes to that url (only Content-Type, NO Authorization)
30
+ * 4. Resolve the stable public `downloadUrl` for the fileId
31
+ *
32
+ * `confirmUpload` is intentionally skipped: the backend plugin creates the file
33
+ * row inside the upload op, so `downloadUrl` resolves immediately.
34
+ *
35
+ * The upload op is discovered via runtime introspection, matched by FIELD/TYPE
36
+ * SHAPE (never a hardcoded name): a root mutation `upload<Type>File(input: {...})`
37
+ * whose input + payload carry the upload shape.
38
+ *
39
+ * The downloadUrl-by-id field is likewise shape-discovered. Three read shapes,
40
+ * preferred in order: the inflected singular `appFile(id:)`; a filtered
41
+ * connection `appFiles(where:{id:{equalTo:$id}}){ nodes { downloadUrl } }`
42
+ * (Relay-disabled backends); and the Relay `node(nodeId:)` fallback.
43
+ */
44
+
45
+ /**
46
+ * Resolve a file's signed `downloadUrl` by id — the public entry point for callers
47
+ * OUTSIDE the upload flow (e.g. a storage browser fetching the preview/copy link for
48
+ * an already-uploaded file).
49
+ *
50
+ * `downloadUrl` is a Grafast computed field, so it cannot be selected through the
51
+ * runtime query builder (`buildSelect` intersects the select against pg columns and
52
+ * drops computed fields). This discovers the by-id field once per endpoint (cached)
53
+ * and reads it through the SAME resolver the upload path uses. Returns null on any
54
+ * failure — a missing url is not exceptional for the caller (it just disables
55
+ * copy/download), so the throwing internals are swallowed here.
56
+ */
57
+ declare function resolveDownloadUrl(execute: SheetsExecuteFn, endpoint: string, fileId: string): Promise<string | null>;
21
58
 
22
59
  type DraftRowStatus = 'idle' | 'saving' | 'error';
23
60
  interface DraftRow {
@@ -84,7 +121,8 @@ interface SheetsAuthState {
84
121
  isAuthenticated: boolean;
85
122
  accessToken: string | null;
86
123
  expiresAt: string | null;
87
- setAuthenticated: (token: string, expiresAt: string) => void;
124
+ identityKey: string | null;
125
+ setAuthenticated: (token: string, expiresAt: string, identityKey?: string | null) => void;
88
126
  setUnauthenticated: () => void;
89
127
  }
90
128
  type SheetsStoreState = DraftRowsSlice & RelationInfoSlice & SheetsAuthState;
@@ -284,6 +322,39 @@ declare function extendRangeToCell(sel: SheetsSelection, col: number, row: numbe
284
322
  */
285
323
  declare function moveActive(sel: SheetsSelection, dCol: number, dRow: number, colCount: number, rowCount: number): SheetsSelection;
286
324
 
325
+ /** A row locator accepted by Sheets CRUD operations. */
326
+ type SheetsRowIdentifier = string | number | Readonly<Record<string, RowIdentityValue>>;
327
+ type SheetsMutationOperation = 'create' | 'update' | 'delete';
328
+ type SheetsRowIdentityResolution = Readonly<{
329
+ status: 'identified';
330
+ /** Backwards-compatible scalar for an ordinary `id` PK; otherwise the PK object. */
331
+ identifier: SheetsRowIdentifier;
332
+ /** GraphQL primary-key input, including renamed and composite keys. */
333
+ primaryKey: Readonly<Record<string, RowIdentityValue>>;
334
+ /** Stable, schema-qualified key used by caches, selection, and editors. */
335
+ key: string;
336
+ }> | Readonly<{
337
+ status: 'unavailable';
338
+ reason: 'no-primary-key' | 'invalid-row';
339
+ }>;
340
+ /**
341
+ * Resolve one server row from `_meta`. The familiar scalar `id` contract is kept
342
+ * for existing adapters, while renamed and composite keys use the full PK input.
343
+ */
344
+ declare function resolveSheetsRowIdentity(table: MetaTable$1, row: Readonly<Record<string, unknown>>): SheetsRowIdentityResolution;
345
+ /** Resolve a public CRUD identifier through the same `_meta` identity contract. */
346
+ declare function resolveSheetsIdentifier(table: MetaTable$1, identifier: SheetsRowIdentifier): SheetsRowIdentityResolution;
347
+ /** Build the PostGraphile connection filter used by `findOne`. */
348
+ declare function sheetsIdentifierToWhere(table: MetaTable$1, identifier: SheetsRowIdentifier): Record<string, {
349
+ equalTo: RowIdentityValue;
350
+ }> | null;
351
+ /** Use scalar IDs as cache keys for compatibility; use serialized identities otherwise. */
352
+ declare function sheetsIdentifierCacheKey(table: MetaTable$1, identifier: SheetsRowIdentifier): string | number | null;
353
+ /** Stable TanStack/selection/editor key with an index fallback only for non-writable rows. */
354
+ declare function sheetsRowKey(table: MetaTable$1, row: Readonly<Record<string, unknown>>, index: number): string;
355
+ declare function getSheetsWriteCapability(table: MetaTable$1 | null): TableWriteCapability | null;
356
+ declare function canRunSheetsMutation(capability: TableWriteCapability | null, operation: SheetsMutationOperation): boolean;
357
+
287
358
  /** A single cell write request. */
288
359
  interface CellWrite {
289
360
  rowIndex: number;
@@ -573,7 +644,7 @@ interface DataGridProps<TRow extends SheetsRow = SheetsRow> {
573
644
  showSelection?: boolean;
574
645
  showPagination?: boolean;
575
646
  onRowSelect?: (selectedRows: TRow[]) => void;
576
- onCellEdit?: (id: string | number, field: string, value: unknown) => void;
647
+ onCellEdit?: (id: SheetsRowIdentifier, field: string, value: unknown) => void;
577
648
  relationChipLimit?: number;
578
649
  relationLabelMaxLength?: number;
579
650
  /**
@@ -633,8 +704,8 @@ interface DataGridProps<TRow extends SheetsRow = SheetsRow> {
633
704
  }
634
705
 
635
706
  declare const Sheets: <TRow extends SheetsRow = SheetsRow>(props: DataGridProps<TRow> & {
636
- ref?: React__default.Ref<SheetsHandle>;
637
- }) => React__default.ReactElement;
707
+ ref?: react__default.Ref<SheetsHandle>;
708
+ }) => react__default.ReactElement;
638
709
  type SheetsProps<TRow extends SheetsRow = SheetsRow> = DataGridProps<TRow>;
639
710
 
640
711
  type RelationMetadataSource = 'relation' | 'foreignKey';
@@ -727,11 +798,8 @@ declare function createCellTypeRegistry(cellTypes: CellTypeDefinition<any>[], bu
727
798
 
728
799
  /** Result of submitting a draft row */
729
800
  interface DraftSubmitResult {
730
- /** The created row with real database ID */
731
- createdRow: {
732
- id: string | number;
733
- [key: string]: unknown;
734
- } | null;
801
+ /** The created row with its metadata-defined primary-key fields. */
802
+ createdRow: Record<string, unknown> | null;
735
803
  }
736
804
 
737
805
  /** Resolved DOM cell payload: the neutral cell plus its (optional) view component. */
@@ -790,8 +858,10 @@ interface SheetsControlsProps {
790
858
  deleteSelected: () => void;
791
859
  onAddRow?: () => void;
792
860
  onExport?: () => void;
861
+ canDelete?: boolean;
862
+ readOnlyReason?: string | null;
793
863
  }
794
- declare function SheetsControls(props: SheetsControlsProps): react_jsx_runtime.JSX.Element;
864
+ declare function SheetsControls(props: SheetsControlsProps): react.JSX.Element;
795
865
 
796
866
  interface GridState {
797
867
  sorting: {
@@ -990,6 +1060,13 @@ interface SheetsShellBindings {
990
1060
  resizeColumn: ReturnType<typeof useGridState>['actions']['resizeColumn'];
991
1061
  frozenCount: number;
992
1062
  selectedRowCount: number;
1063
+ canCreate: boolean;
1064
+ canUpdate: boolean;
1065
+ canDelete: boolean;
1066
+ /** Human-readable reason shown when `_meta` proves the whole table is read-only. */
1067
+ readOnlyReason: string | null;
1068
+ /** Stable identity for selection, TanStack rows, and editor instances. */
1069
+ getRowId: (row: SheetsRow | null | undefined, index: number) => string;
993
1070
  isSubmittingDrafts: boolean;
994
1071
  submitDraftButtonDisabled: boolean;
995
1072
  submitDraftLabel: string;
@@ -1043,7 +1120,7 @@ interface SheetsPaginationProps {
1043
1120
  totalPages: number;
1044
1121
  setPageIndex: React.Dispatch<React.SetStateAction<number>>;
1045
1122
  }
1046
- declare function SheetsPagination(props: SheetsPaginationProps): react_jsx_runtime.JSX.Element;
1123
+ declare function SheetsPagination(props: SheetsPaginationProps): react.JSX.Element;
1047
1124
 
1048
1125
  type TableWithCategory = {
1049
1126
  name: string;
@@ -1059,7 +1136,7 @@ interface TableSelectorProps {
1059
1136
  /** Optional callback when user clicks the "New table" button */
1060
1137
  onNewTable?: () => void;
1061
1138
  }
1062
- declare const SheetsTableSelector: React__default.NamedExoticComponent<TableSelectorProps>;
1139
+ declare const SheetsTableSelector: react__default.NamedExoticComponent<TableSelectorProps>;
1063
1140
 
1064
1141
  interface UseMetaOptions {
1065
1142
  enabled?: boolean;
@@ -1067,7 +1144,7 @@ interface UseMetaOptions {
1067
1144
  declare function useSheetsMeta(options?: UseMetaOptions): UseQueryResult<MetaQuery, Error>;
1068
1145
 
1069
1146
  type RowRecord$1 = Record<string, unknown>;
1070
- type DeleteIdentifier = string | number | Record<string, string | number>;
1147
+ type DeleteIdentifier = SheetsRowIdentifier;
1071
1148
  /**
1072
1149
  * Unified table hook options
1073
1150
  */
@@ -1087,11 +1164,11 @@ interface UseTableResult<TData extends RowRecord$1 = RowRecord$1> {
1087
1164
  totalCount: number;
1088
1165
  isLoading: boolean;
1089
1166
  error: Error | null;
1090
- findOne: (id: string | number) => Promise<TData | null>;
1167
+ findOne: (id: SheetsRowIdentifier) => Promise<TData | null>;
1091
1168
  create: (data: RowRecord$1) => Promise<{
1092
1169
  createdRow: TData | null;
1093
1170
  }>;
1094
- update: (id: string | number, patch: RowRecord$1) => Promise<{
1171
+ update: (id: SheetsRowIdentifier, patch: RowRecord$1) => Promise<{
1095
1172
  updatedRow: TData | null;
1096
1173
  }>;
1097
1174
  delete: (id: DeleteIdentifier) => Promise<{
@@ -1239,8 +1316,9 @@ declare const sheetsQueryKeys: {
1239
1316
  };
1240
1317
 
1241
1318
  /**
1242
- * Create the default PostGraphile-backed adapter. Stateless — safe to share as a
1243
- * module-level singleton.
1319
+ * Create the default PostGraphile-backed adapter. The metadata preflight makes
1320
+ * an outdated endpoint distinguishable from an ordinary transport failure,
1321
+ * while the WeakMap deduplicates that introspection for each executor/session.
1244
1322
  */
1245
1323
  declare function createPostGraphileAdapter(): SheetsBackendAdapter;
1246
1324
 
@@ -1324,6 +1402,10 @@ declare function mapToFrontendCellType(metadata: {
1324
1402
  pgAlias?: string | null;
1325
1403
  pgType?: string | null;
1326
1404
  subtype?: string | null;
1405
+ encoding?: {
1406
+ kind: string;
1407
+ geometrySubtype?: string | null;
1408
+ } | null;
1327
1409
  }): CellType;
1328
1410
  /**
1329
1411
  * Determines if a field represents structured data that should be rendered as JSON
@@ -1342,6 +1424,10 @@ declare function createColumnSchemaFromMeta(field: {
1342
1424
  pgType?: string | null;
1343
1425
  subtype?: string | null;
1344
1426
  typmod?: any;
1427
+ encoding?: {
1428
+ kind: string;
1429
+ geometrySubtype?: string | null;
1430
+ } | null;
1345
1431
  };
1346
1432
  }): ColumnSchema;
1347
1433
 
@@ -1438,6 +1524,7 @@ interface ScalarFieldSpec {
1438
1524
  pgAlias?: string | null;
1439
1525
  subtype?: string | null;
1440
1526
  typmod?: number | null;
1527
+ encoding?: MetaField['type']['encoding'];
1441
1528
  };
1442
1529
  constraints: ScalarConstraintHints;
1443
1530
  }
@@ -1464,7 +1551,7 @@ interface DynamicMutationResult<TData = unknown> {
1464
1551
  error: Error | null;
1465
1552
  }
1466
1553
  declare function useDynamicCreate(tableName: string): DynamicMutationResult;
1467
- declare function useDynamicUpdate(tableName: string, rowId: string | number): DynamicMutationResult;
1554
+ declare function useDynamicUpdate(tableName: string, rowId: SheetsRowIdentifier): DynamicMutationResult;
1468
1555
 
1469
1556
  declare function createMetadataHash(value: unknown): string;
1470
1557
 
@@ -1505,7 +1592,7 @@ interface FeedbackContextValue {
1505
1592
  interface FeedbackProviderProps {
1506
1593
  children: React.ReactNode;
1507
1594
  }
1508
- declare function FeedbackProvider({ children }: FeedbackProviderProps): react_jsx_runtime.JSX.Element;
1595
+ declare function FeedbackProvider({ children }: FeedbackProviderProps): react.JSX.Element;
1509
1596
  declare function useFeedback(): FeedbackContextValue;
1510
1597
  /**
1511
1598
  * Hook for accessing only operation feedback - useful for dock status bar
@@ -1526,14 +1613,14 @@ interface DockStatusBarProps {
1526
1613
  * - Success checkmark + message (auto-dismisses)
1527
1614
  * - Error/partial warning + message with optional retry
1528
1615
  */
1529
- declare function DockStatusBar({ className, onRetry }: DockStatusBarProps): react_jsx_runtime.JSX.Element | null;
1616
+ declare function DockStatusBar({ className, onRetry }: DockStatusBarProps): react.JSX.Element | null;
1530
1617
  /**
1531
1618
  * Compact variant for space-constrained layouts.
1532
1619
  * Shows only icon + abbreviated message.
1533
1620
  */
1534
1621
  declare function DockStatusBarCompact({ className }: {
1535
1622
  className?: string;
1536
- }): react_jsx_runtime.JSX.Element | null;
1623
+ }): react.JSX.Element | null;
1537
1624
 
1538
1625
  interface FloatingStatusProps {
1539
1626
  className?: string;
@@ -1542,7 +1629,7 @@ interface FloatingStatusProps {
1542
1629
  * Standalone floating status indicator for bulk operations.
1543
1630
  * Shows independently of row selection, positioned at bottom-center of grid.
1544
1631
  */
1545
- declare function FloatingStatus({ className }: FloatingStatusProps): react_jsx_runtime.JSX.Element;
1632
+ declare function FloatingStatus({ className }: FloatingStatusProps): react.JSX.Element;
1546
1633
 
1547
1634
  interface SheetsErrorBoundaryProps {
1548
1635
  children: ReactNode;
@@ -1575,19 +1662,20 @@ interface SheetsErrorStateProps {
1575
1662
  onRetry?: () => void;
1576
1663
  }
1577
1664
  /** Shown when the table data (or its metadata) fails to load. */
1578
- declare function SheetsErrorState({ error, onRetry }: SheetsErrorStateProps): react_jsx_runtime.JSX.Element;
1665
+ declare function SheetsErrorState({ error, onRetry }: SheetsErrorStateProps): react.JSX.Element;
1579
1666
  interface SheetsEmptyStateProps {
1580
1667
  tableName?: string;
1581
1668
  onAddRow?: () => void;
1669
+ readOnlyReason?: string | null;
1582
1670
  }
1583
1671
  /** Shown when the table loaded successfully but has no rows. */
1584
- declare function SheetsEmptyState({ tableName, onAddRow }: SheetsEmptyStateProps): react_jsx_runtime.JSX.Element;
1672
+ declare function SheetsEmptyState({ tableName, onAddRow, readOnlyReason }: SheetsEmptyStateProps): react.JSX.Element;
1585
1673
  /**
1586
1674
  * Shown during the initial data load. A STRUCTURAL skeleton of the grid (baseline-ui:
1587
1675
  * prefer skeletons over spinners) — mirrors the real grid's 40px header + 44px rows +
1588
1676
  * horizontal hairlines so the load→loaded swap doesn't jump. Pulse is motion-safe only.
1589
1677
  */
1590
- declare function SheetsLoadingState(): react_jsx_runtime.JSX.Element;
1678
+ declare function SheetsLoadingState(): react.JSX.Element;
1591
1679
 
1592
1680
  interface DataFilteringContextValue {
1593
1681
  filterTree: FilterGroup;
@@ -1647,4 +1735,4 @@ declare function useDataPagination({ initialPageSize, initialPageIndex, totalCou
1647
1735
  }) => any;
1648
1736
  };
1649
1737
 
1650
- export { BOOLEAN_TYPES, BUILTIN_EDITOR_TYPES, type Binding, CellPlugin, CellProps, CellRegistry, CellRegistryEntry, CellRenderer, type CellSlot, type CellSlots, CellType, type CellTypeBuiltins, CellTypeDefinition, CellTypeMatchInput, type CellTypeRegistry, ColumnSchema, type CommandResult, DATE_TIME_TYPES, type DataFilteringContextValue, type DataPaginationContextValue, type DispatchEvent, DockStatusBar, DockStatusBarCompact, type DraftMeta, type DraftRow, type DynamicFormSpec, ENHANCED_TYPES, EditorProps, type ExtractedRange, FeedbackProvider, type FieldTypeMap, type FilterCondition, type FilterGroup, type FilterNode, type FilterValue, FloatingStatus, GEOMETRY_TYPES, type GridCommand, type GridCommandContext, type Interceptor, MAX_FILTER_DEPTH, MEDIA_TYPES, type MetaField, type MetaTable, NON_EDITABLE_TYPES, NUMBER_TYPES, type OperationFeedback, RangeSet, type RelationColumnInfo, RelationInfo, type RowWithDraft, STRUCTURED_DATA_TYPES, type ScalarFieldSpec, type SelectionCurrent, type SelectionRect, Sheets, type SheetsAuthState, SheetsBackendAdapter, SheetsCell, SheetsCellRenderContext, SheetsConfig, SheetsControls, type SheetsControlsProps, type SheetsDraftBindings, SheetsEmptyState, SheetsErrorBoundary, SheetsErrorState, type SheetsEvent, SheetsExecuteFn, type SheetsHandle, SheetsLoadingState, SheetsPagination, type SheetsPaginationBindings, type SheetsPaginationProps, type SheetsProps, SheetsProvider, type SheetsRow, SheetsScopeKey, type SheetsSelection, type SheetsSelectionBindings, type SheetsSlots, type SheetsStoreState, SheetsTableSelector, type SheetsThemeInput, type SheetsThemeTokens, SheetsUploadFn, TYPED_ARRAY_TYPES, type TableSelectorProps, type TableWithCategory, type Trigger, type UploadProgress, type UploadResponse, type UseDataFilteringConfig, type UseDataPaginationConfig, type UseFieldUploadOptions, type UseInfiniteTableOptions, type UseInfiniteTableResult, type UseMetaOptions, type UseSheetsResult, type UseSheetsTableCursorOptions, type UseSheetsTableCursorResult, type UseTableOptions, type UseTableResult, VIEWER_ONLY_TYPES, buildScalarFormSpec, buildZodSchema, clear as clearSheetsSelection, computeDraftMetaSignature, countConditions, createCellTypeRegistry, createColumnSchemaFromMeta, createEmptyGroup, createMetadataHash, createPostGraphileAdapter, emptySheetsSelection, executeFieldUpload, extendRangeToCell, fillDownWrites, fillRightWrites, findTableFormSpec, getCellsInRange, getDraftMeta, isArrayCellType, isDraftRow, isSheetsScopeKey, isStructuredDataType, kbd, mapToFrontendCellType, moveActive, sheetsTableQueryKeys as queryKeys, selectCell, selectRange, selectRow, sheetsQueryKeys, toTSV, toggleRow, tokensFromCssVars, useDataFiltering, useDataGridColumns, useDataPagination, useDynamicCreate, useDynamicUpdate, useFeedback, useOperationFeedback, useRelationColumns, useSheets, useSheetsAdapter, useSheetsFieldUpload, useSheetsImageUpload, useSheetsInfiniteTable, useSheetsMeta, useSheetsStore, useSheetsStoreApi, useSheetsTable, useSheetsTableCursor };
1738
+ export { BOOLEAN_TYPES, BUILTIN_EDITOR_TYPES, type Binding, CellPlugin, CellProps, CellRegistry, CellRegistryEntry, CellRenderer, type CellSlot, type CellSlots, CellType, type CellTypeBuiltins, CellTypeDefinition, CellTypeMatchInput, type CellTypeRegistry, ColumnSchema, type CommandResult, DATE_TIME_TYPES, type DataFilteringContextValue, type DataPaginationContextValue, type DispatchEvent, DockStatusBar, DockStatusBarCompact, type DraftMeta, type DraftRow, type DynamicFormSpec, ENHANCED_TYPES, EditorProps, type ExtractedRange, FeedbackProvider, type FieldTypeMap, type FilterCondition, type FilterGroup, type FilterNode, type FilterValue, FloatingStatus, GEOMETRY_TYPES, type GridCommand, type GridCommandContext, type Interceptor, MAX_FILTER_DEPTH, MEDIA_TYPES, type MetaField, type MetaTable, NON_EDITABLE_TYPES, NUMBER_TYPES, type OperationFeedback, RangeSet, type RelationColumnInfo, RelationInfo, type RowWithDraft, STRUCTURED_DATA_TYPES, type ScalarFieldSpec, type SelectionCurrent, type SelectionRect, Sheets, type SheetsAuthState, SheetsBackendAdapter, SheetsCell, SheetsCellRenderContext, SheetsConfig, SheetsControls, type SheetsControlsProps, type SheetsDraftBindings, SheetsEmptyState, SheetsErrorBoundary, SheetsErrorState, type SheetsEvent, SheetsExecuteFn, type SheetsHandle, SheetsLoadingState, SheetsPagination, type SheetsPaginationBindings, type SheetsPaginationProps, type SheetsProps, SheetsProvider, type SheetsRow, type SheetsRowIdentifier, type SheetsRowIdentityResolution, SheetsScopeKey, type SheetsSelection, type SheetsSelectionBindings, type SheetsSlots, type SheetsStoreState, SheetsTableSelector, type SheetsThemeInput, type SheetsThemeTokens, SheetsUploadFn, TYPED_ARRAY_TYPES, type TableSelectorProps, type TableWithCategory, type Trigger, type UploadProgress, type UploadResponse, type UseDataFilteringConfig, type UseDataPaginationConfig, type UseFieldUploadOptions, type UseInfiniteTableOptions, type UseInfiniteTableResult, type UseMetaOptions, type UseSheetsResult, type UseSheetsTableCursorOptions, type UseSheetsTableCursorResult, type UseTableOptions, type UseTableResult, VIEWER_ONLY_TYPES, buildScalarFormSpec, buildZodSchema, canRunSheetsMutation, clear as clearSheetsSelection, computeDraftMetaSignature, countConditions, createCellTypeRegistry, createColumnSchemaFromMeta, createEmptyGroup, createMetadataHash, createPostGraphileAdapter, emptySheetsSelection, executeFieldUpload, extendRangeToCell, fillDownWrites, fillRightWrites, findTableFormSpec, getCellsInRange, getDraftMeta, getSheetsWriteCapability, isArrayCellType, isDraftRow, isSheetsScopeKey, isStructuredDataType, kbd, mapToFrontendCellType, moveActive, sheetsTableQueryKeys as queryKeys, resolveDownloadUrl, resolveSheetsIdentifier, resolveSheetsRowIdentity, selectCell, selectRange, selectRow, sheetsIdentifierCacheKey, sheetsIdentifierToWhere, sheetsQueryKeys, sheetsRowKey, toTSV, toggleRow, tokensFromCssVars, useDataFiltering, useDataGridColumns, useDataPagination, useDynamicCreate, useDynamicUpdate, useFeedback, useOperationFeedback, useRelationColumns, useSheets, useSheetsAdapter, useSheetsFieldUpload, useSheetsImageUpload, useSheetsInfiniteTable, useSheetsMeta, useSheetsStore, useSheetsStoreApi, useSheetsTable, useSheetsTableCursor };