@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.
- package/README.md +19 -24
- package/dist/advanced.cjs +659 -474
- package/dist/advanced.cjs.map +1 -1
- package/dist/advanced.d.cts +9 -10
- package/dist/advanced.d.ts +9 -10
- package/dist/advanced.js +3 -3
- package/dist/auth.cjs +10 -10
- package/dist/auth.cjs.map +1 -1
- package/dist/auth.d.cts +5 -4
- package/dist/auth.d.ts +5 -4
- package/dist/auth.js +3 -3
- package/dist/{chunk-GLVZSPV2.js → chunk-4EZ6A23C.js} +4 -3
- package/dist/chunk-4EZ6A23C.js.map +1 -0
- package/dist/{chunk-FNVHSOQQ.js → chunk-KKAWMVEG.js} +11 -11
- package/dist/chunk-KKAWMVEG.js.map +1 -0
- package/dist/{chunk-4PGPVMZB.js → chunk-KOZAW264.js} +4 -3
- package/dist/chunk-KOZAW264.js.map +1 -0
- package/dist/{chunk-ODUBS2NL.js → chunk-KVPVEXWB.js} +40 -17
- package/dist/chunk-KVPVEXWB.js.map +1 -0
- package/dist/{chunk-TU7ATZ4X.js → chunk-LR64FLWO.js} +301 -410
- package/dist/chunk-LR64FLWO.js.map +1 -0
- package/dist/chunk-ZETPUEXH.js +494 -0
- package/dist/chunk-ZETPUEXH.js.map +1 -0
- package/dist/{date-editor-CXKKGNL6.js → date-editor-QT47WY5T.js} +5 -3
- package/dist/date-editor-QT47WY5T.js.map +1 -0
- package/dist/{editor-props-M6Dh0P9f.d.ts → grid-cell-types-C3ARj148.d.cts} +70 -62
- package/dist/{editor-props-M6Dh0P9f.d.cts → grid-cell-types-C3ARj148.d.ts} +70 -62
- package/dist/index.cjs +1150 -703
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +123 -35
- package/dist/index.d.ts +123 -35
- package/dist/index.js +323 -99
- package/dist/index.js.map +1 -1
- package/dist/{sheets-context-CojEFlaY.d.cts → sheets-context-B03WDhZ9.d.cts} +36 -6
- package/dist/{sheets-context-Da55TTR9.d.ts → sheets-context-DmVCOgiX.d.ts} +36 -6
- package/dist/styles.css +6 -0
- package/dist/testing.cjs +476 -108
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.d.cts +11 -7
- package/dist/testing.d.ts +11 -7
- package/dist/testing.js +34 -8
- package/dist/testing.js.map +1 -1
- package/package.json +15 -16
- package/dist/chunk-4PGPVMZB.js.map +0 -1
- package/dist/chunk-FNVHSOQQ.js.map +0 -1
- package/dist/chunk-GLVZSPV2.js.map +0 -1
- package/dist/chunk-H4JJTMP5.js +0 -160
- package/dist/chunk-H4JJTMP5.js.map +0 -1
- package/dist/chunk-ODUBS2NL.js.map +0 -1
- package/dist/chunk-TU7ATZ4X.js.map +0 -1
- package/dist/date-editor-CXKKGNL6.js.map +0 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
import * as
|
|
2
|
-
import
|
|
3
|
-
|
|
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-DmVCOgiX.js';
|
|
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-DmVCOgiX.js';
|
|
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 './
|
|
6
|
-
export { B as BaseCellProps, c as CellCategory,
|
|
7
|
-
import
|
|
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.js';
|
|
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.js';
|
|
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.js';
|
|
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):
|
|
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
|
-
|
|
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:
|
|
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?:
|
|
637
|
-
}) =>
|
|
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
|
|
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):
|
|
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):
|
|
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:
|
|
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 =
|
|
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:
|
|
1167
|
+
findOne: (id: SheetsRowIdentifier) => Promise<TData | null>;
|
|
1091
1168
|
create: (data: RowRecord$1) => Promise<{
|
|
1092
1169
|
createdRow: TData | null;
|
|
1093
1170
|
}>;
|
|
1094
|
-
update: (id:
|
|
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.
|
|
1243
|
-
*
|
|
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:
|
|
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):
|
|
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):
|
|
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
|
-
}):
|
|
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):
|
|
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):
|
|
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):
|
|
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():
|
|
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 };
|