@ai-matrx/records 0.83.2 → 0.84.1

package/dist/react/index.d.cts

@@ -15174,6 +15174,13 @@ declare function useSeededAnswer<T>(key: string | null, run: (client: RecordsCli
     ok: false;
     error: RecordsError;
 }>): T | undefined;
+/**
+ * A TILE'S NUMBER FROM THE SERVER'S SEED (lane SEED-ENTITY): the rows of `custom.record_aggregate`
+ * for `spec` over `tableId`, when the page seed holds that exact question (`askTileSeed`, records-ui
+ * `/first-page`); else `undefined` and the tile reads for itself. Asks through `client.recordAggregate`,
+ * so the arguments are exactly the ones the tile's own read sends.
+ */
+declare function useSeededAggregate(tableId: Uuid | null, spec: Omit<Parameters<RecordsClient["recordAggregate"]>[0], "table_id">): AggregateRow[] | undefined;
 /** One Table's declaration. */
 declare function useTable(tableId: Uuid | null): Async<Table | null>;
 /** Every Table this person can see in this organization. */
@@ -15548,6 +15555,19 @@ interface SeedStore {
         ok: false;
         error: RecordsError;
     }>, config: RecordsConfig): Promise<SeedOutcome<T>>;
+    /**
+     * The same, for a reader that holds no records client (the entity engine): `run` is handed a data
+     * source that answers from the seed only. A miss anywhere in the run is "not seeded".
+     */
+    runSource<T>(slot: string, run: (source: RecordsDataSource) => Promise<{
+        ok: true;
+        data: T;
+    } | {
+        ok: false;
+        error: unknown;
+    }>): Promise<SeedOutcome<T>>;
+    /** Epoch ms the server asked. */
+    at: number;
 }
 interface RecordsSeedProviderProps {
     /** What the server asked for this page as the person (`recordingDataSource(...).seed()`), or null. */
@@ -15556,6 +15576,24 @@ interface RecordsSeedProviderProps {
 }
 /** Mount above a server-rendered records screen. A null seed is no seed: every hook asks for itself. */
 declare function RecordsSeedProvider({ seed, children }: RecordsSeedProviderProps): react.FunctionComponentElement<react.ProviderProps<SeedStore | null>>;
+/**
+ * A READER WITHOUT A RECORDS CLIENT, AGAINST THE PAGE SEED (lane SEED-ENTITY): under a live
+ * `<RecordsSeedProvider>`, `run` is asked of a data source that answers from the seed only —
+ * suspending on the server and while hydrating, never touching the network. Its answer (and when the
+ * server asked) is returned for the reader to start from; a miss, or no seed, answers `undefined` and
+ * the reader asks for itself. Always suspends while the seed is live (React matches awaited promises
+ * by order), so call it unconditionally.
+ */
+declare function useSeededSource<T>(key: string | null, run: (source: RecordsDataSource) => Promise<{
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: unknown;
+}>): {
+    data: T;
+    at: number;
+} | undefined;
 
 /** How long an entry outlives its last reader, so a remount or an Undo costs nothing. */
 declare const RECORDS_CACHE_GRACE_MS = 30000;
@@ -16008,4 +16046,4 @@ interface ArchiveDeliberatelyArgs {
 }
 declare function archiveAppTableDeliberately(client: RecordsClient, args: ArchiveDeliberatelyArgs): Promise<RecordsResult<TableArchiveProgress>>;
 
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, ADDRESS_PARTS, AGENT_WRITER_WORDS, APP_ROWS_CEILING, ARCHIVE_LANES, ARCHIVE_LANE_LABEL, ARCHIVE_LANE_MEANS, type AbsenceReason, type ActionRefusal, type ActionRunResult, type Actor, type AddressPart, type AddressValue, type AggregateBucket, type AggregateCompare, type AggregateCompareKind, type AggregateCompareWindows, type AggregateDelta, type AggregateFilter, type AggregateGroupValue, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, type AnyAppTableDef, type AnyStoreTable, type AppField, type AppFields, type AppRows, type AppTableChecked, type AppTableDef, type AppTableEnsured, type AppTableGraduation, type AppTableInput, type AppTableOrgOptions, type AppTableScope, type AppTableStatus, type AppUpsertOptions, type ArchiveDeliberatelyArgs, type ArchiveLane, type ArchivedChecklistTemplate, type ArchivedDoorRow, type ArchivedForm, type ArchivedRow, type AutomationAction, type AutomationDeclared, type AutomationFilter, type AutomationFlipped, type AutomationItem, type AutomationLastRun, type AutomationList, type AutomationRun, type AutomationRunStatus, type AutomationRuns, type AutomationSpec, type AutomationStep, type AutomationTrigger, type AutomationValue, type AutomationValues, BARCODE_SYMBOLOGIES, BUILT_KIND_WORD, type BookingAvailability, type BookingDeclared, type BookingSummary, type BookingWindow, CHOICE_NUDGES, COMPUTE_ON, CONTEXT_POLICIES, type CaptureField, type CaptureFileRef, type CaptureOutcome, type CaptureQuestion, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSheetFace, type CaptureSheetSummary, type CaptureSyncReport, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceCellBack, type ChoiceLike, type ChoiceNudge, type ChoiceOption, type ChoiceOptions, type ChoiceRehome, type ChoiceUsage, type ChoicesRehomed, type CoerceOptions, type Coerced, type CoercedAnswers, type CoercibleField, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DECLARABLE_FIELD_KINDS, DEFAULT_ARCHIVE_LANE, DEFAULT_PORTAL_ARCHIVE_FILTER, DELIVERIES, DRILL_CHART_TOKENS, DRILL_DESCRIPTION_MAX, DRILL_DOORS, DRILL_SCHEMA, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type DashboardTarget, type DashboardTargetBase, type DashboardTargetOp, type DashboardTargetResult, type DashboardTotals, type DataHomeTable, type DeclarableFieldKind, type DecorationColor, type DecorationPath, type DecorationRule, type DecorationRuleOp, type DecorationTarget, type Delivery, type DigestPreview, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, type DrillAdHocOp, type DrillAnswer, type DrillAnswerRow, type DrillChartToken, type DrillDeclaration, type DrillDefinition, type DrillDimension, type DrillFinding, type DrillGrain, type DrillHaving, type DrillLane, type DrillLevel, type DrillMeasure, type DrillMeasureOp, type DrillMeasureWhereValue, type DrillPath, type DrillQuestion, type DrillRecords, type DrillRowsPage, type DrillSource, type DrillView, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityBackLinkItem, type EntityBackLinks, type EntityFieldRights, type EntityFieldValue, type EntityFieldsAcross, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityRef, type EntityRefWithWords, type EntityReferenceKind, type EntityReferenceRead, type EntityRowWritten, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_KINDS, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldDrift, type FieldDriftAspect, type FieldDuplicated, type FieldHistoryEntry, type FieldKind, type FieldOptionEdit, type FieldOptions, type FieldPatch, type FieldProposal, type FieldRetyped, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormArchiveAnswer, type FormLookOptions, type FormResults, type FormRoute, type FormSummary, type FormulaParse, type Freshness, GRADUATION_BASE_COLUMNS, type GraduatedRelation, type GraduatedRow, type GridLayout, type GridLayoutMode, type GridRowHeight, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportColumnsDeclared, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, type InboxCounts, type InboxStateChange, type InsertOf, type IoExportPage, KERNEL_TABLES, type KernelTableName, type KernelTargets, type KeysetRow, type ListTableRowsOptions, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MigrationUndone, type MissingBehavior, type MyLevel, type MySubscription, NEWER_FIELD_KINDS, NOT_A_MEMBER_WORDS, type NewEntityFieldDeclaration, type NewFieldDeclaration, type NewerFieldKind, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OutsideShareAnswer, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, PIPELINE_RULE_KINDS, PORTAL_ACCENTS, PORTAL_ARCHIVE_FILTERS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PersonStamp, type PgError, type Pipeline, type PipelineColumn, type PipelineDeclared, type PipelineGate, type PipelineGatePreview, type PipelineMissingField, type PipelineMoveMany, type PipelineMoveManyItem, type PipelineMoveManyResult, type PipelineMoveResult, type PipelineMoveVerdict, type PipelineRule, type PipelineRuleKind, type PipelineSpec, type PipelineStage, type PipelineVerdict, type PortalAccent, type PortalArchiveAnswer, type PortalArchiveFilter, type PortalCard, type PortalConfig, type PortalConfigInput, type PortalFooterLink, type PortalFormAnswer, type PortalFormInput, type PortalFormRef, type PortalFormSpec, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalStage, type PortalStyle, type PortalStyleInput, type PortalSummary, type PortalTableExposure, type PortalTableRef, type PredictedRefusal, type ProvenancePointer, type PublicPicture, type PublishBinding, type PublishBindingKind, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, type QuietHours, RECORDS_CACHE_GRACE_MS, REFUSALS_WORTH_REPEATING, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, REVERSE_LINKS_PAGE_MAX, REVERSE_LINKS_RECORDS_PER_CALL, ROW_WEB_NOT_READY, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordChange, type RecordChangeAction, type RecordChangeResult, type RecordComment, type RecordDocument, type RecordEvent, type RecordFilter, type RecordGraphWritten, type RecordHeader, type RecordHistoryEntry, type RecordKeysetPage, type RecordPage, type RecordPageData, type RecordPageSort, type RecordRead, type RecordRevision, type RecordRowControls, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsChangeSink, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, RecordsHoldScope, type RecordsMerged, RecordsProvider, type RecordsProviderProps, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, RecordsSeedProvider, type RecordsSeedProviderProps, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationDisplay, type RelationFlavor, type RelationIcons, type RelationNameIndex, type RelationNameMatch, type RelationNamesAnswer, type RelationProperties, type RelationTarget, type RelationWordsManyArgs, type ResolutionTriple, type ResolvedPublishBinding, type ResolvedPublishBindingKind, type RestorePreview, type RestoreResult, type RetiredActorWord, type RetypeBehaviour, type RetypePreview, type ReverseColumn, type ReverseLink, type ReverseLinks, type ReverseLinksManyArgs, type RowAction, type RowActionStep, type RowDefaultsApplied, type RowOf, type RowTemplateRow, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, SEED_FRESH_MS, SHOWN_TO_LABEL, SHOWN_TO_VALUES, SHOWN_TO_WHO_MAY_CHANGE, STAGE_RULE_ENFORCEMENT, STAGE_RULE_ON_FAIL, STATUS_GROUPS, STATUS_GROUP_WORDS, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, STORE_ROWS_CEILING, SYSTEM_WRITER_WORDS, type SavedViewColorBy, type SavedViewDefinition, type SavedViewLayout, type SavedViewRow, type SavedViewSpecIn, type ShownTo, type SourceArchived, type StagePending, type StagePendingOnBoard, type StageRuleEnforcement, type StageRuleOnFail, type StageRuleWarning, type StaleWriteDetail, type StatusGroup, type StorageMode, type StoreDoorName, type StoreFilter, type StoreInsertOf, type StoreRefusalCode, type StoreRowOf, type StoreRowSnapshot, type StoreTable, type StoreTableColumn, type StoreTableRows, type StoreTableSort, type StoreTableWhere, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, type SubscriptionSpec, TABLE_DISPLAYS, TABLE_KIND_PREFIX, TABLE_ORIGINS, TABLE_TYPES, TO_ASSOCIATION, TO_CUSTOM_FIELDS, type Table, type TableArchiveProgress, type TableCapacity, type TableCopyInProgress, type TableDecorations, type TableDisplay, type TableDuplicateProgress, type TableDuplicated, type TableHome, type TableHomeDestination, type TableKindFacts, type TableListEntry, type TableMoved, type TableOrigin, type TablePlacement, type TablePlacementFact, type TableProposal, type TableRenderSchema, type TableRestoreProgress, type TableRowCount, type TableRowDefaults, type TableRowDefaultsPatch, type TableSchemaMode, type TableSyncResult, type TableSyncSource, type TableSyncSpec, type TableType, type TableWebhook, type TableWebhookDeclared, type Timestamp, type TypedChoiceDecision, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, type UniqueKeys, type UseAppTable, type UseAppTableOptions, type UseEntityBackLinks, type UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordOptions, type UseRecordPageOptions, type UseRecordPageState, type UseRecordsOptions, type UseRecordsState, type UseStoreTable, type UseTableArchive, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type ViewLayout, type ViewOrderSet, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprovalState, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDecideMany, type WorkDecideManyItem, type WorkDecideManyResult, type WorkDecideVerdict, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInboxView, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, actionRefusals, addressFromText, addressMapUrl, addressText, allowsOtherValues, archiveAppTableDeliberately, archiveTableRow, archivedByLine, archivedWhen, asChoiceNudge, asPermissionLevel, atLeast, bookingPath, callersTimeZone, checkAppTable, choiceSlug, choiceValuesOf, choicesOf, coerceTypedAnswer, coerceTypedAnswers, coercionLabel, decideTypedChoice, declareDrillDefinition, defineAppTable, drillAnswerOf, drillFindingKnob, durationText, emptyArchiveLine, emptyPortalArchiveLine, ensureAppTable, entityReferenceKinds, entityReferenceKindsOf, entityReferenceSearch, entityReferenceWords, entityRefsOf, entityRefsToWrite, err, exportPageXlsx, f, fieldKindFor, fieldKindOf, forgetAllOps, graduatedRow, graduationProblems, hasQuietHours, highestLevel, holdsARetiredChoice, indexedDbStore, isAddressValue, isArchiveLane, isDecided, isEntityReferenceConfig, isFoundation, isOwnOp, isPersonStamp, isPortalAccent, isPortalArchiveFilter, isRecordsErr, isRuleFilter, isShownTo, isTableKind, isTheChosen, keptGroups, keptOutOfSight, keptTableHref, liftWithheld, listAppRows, listTableRows, localeDateOrder, looksLikeAnId, mayDrag, measureKey, memoryStore, mintClientKey, mintOpId, moveConsequence, moveInOrder, newerKindExportWords, newerKindOf, newerKindWords, offeredAsContext, ok, openCaptureQueue, optionKey, optionLabel, parseFieldDrift, parseTableCopiesInProgress, parseTableDuplicateProgress, parseTableDuplicated, parseTableHome, parseTableMoved, personStampText, portalArchiveConsequence, portalConfirmLine, portalPath, portalTitleTypedBack, previewRetype, previewRuleChange, publicFormPath, rankTypedMatches, ratingMaxOf, readTypedDate, readTypedDuration, readTypedNumber, readTypedTime, recordChangeTrigger, recordSourceKey, recordSourceTable, recordsCacheCounters, recordsUseSentence, rehomeSentence, relationNameIndexOf, relationNameKey, relationNamesIn, rememberedOpCount, removeAppRow, removedChoicesInUse, richTextPlain, rowFromDocument, ruleThatRefuses, rulesWithTopStar, safeLinkHref, sameDocument, scopeChip, sha256Hex, sheetSyncSpec, sourceArchivedOf, splitListCell, stableFilterKey, statusGroupOf, storeTable, tableIdOf, tableJsonSchema, tableKindMapping, tableKindSlug, tableRenderSchema, tableShapeChanged, twoDigitYear, typedDateText, typedMatchScore, typedTimeText, updateTableRow, upsertAppRow, useAppTable, useEntityBackLinks, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityReferenceKinds, useEntityReferenceSearch, useEntityReferenceWords, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordChangeRevision, useRecordMutation, useRecordPage, useRecords, useRecordsActor, useRecordsClient, useRecordsHold, useReverseColumns, useReverseLinks, useRowActions, useSeededAnswer, useStoreTable, useTable, useTableArchive, useTables, valueConverts, withCallersClock, withRowCounts, withTablePlacement, writeTableRow };
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, ADDRESS_PARTS, AGENT_WRITER_WORDS, APP_ROWS_CEILING, ARCHIVE_LANES, ARCHIVE_LANE_LABEL, ARCHIVE_LANE_MEANS, type AbsenceReason, type ActionRefusal, type ActionRunResult, type Actor, type AddressPart, type AddressValue, type AggregateBucket, type AggregateCompare, type AggregateCompareKind, type AggregateCompareWindows, type AggregateDelta, type AggregateFilter, type AggregateGroupValue, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, type AnyAppTableDef, type AnyStoreTable, type AppField, type AppFields, type AppRows, type AppTableChecked, type AppTableDef, type AppTableEnsured, type AppTableGraduation, type AppTableInput, type AppTableOrgOptions, type AppTableScope, type AppTableStatus, type AppUpsertOptions, type ArchiveDeliberatelyArgs, type ArchiveLane, type ArchivedChecklistTemplate, type ArchivedDoorRow, type ArchivedForm, type ArchivedRow, type AutomationAction, type AutomationDeclared, type AutomationFilter, type AutomationFlipped, type AutomationItem, type AutomationLastRun, type AutomationList, type AutomationRun, type AutomationRunStatus, type AutomationRuns, type AutomationSpec, type AutomationStep, type AutomationTrigger, type AutomationValue, type AutomationValues, BARCODE_SYMBOLOGIES, BUILT_KIND_WORD, type BookingAvailability, type BookingDeclared, type BookingSummary, type BookingWindow, CHOICE_NUDGES, COMPUTE_ON, CONTEXT_POLICIES, type CaptureField, type CaptureFileRef, type CaptureOutcome, type CaptureQuestion, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSheetFace, type CaptureSheetSummary, type CaptureSyncReport, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceCellBack, type ChoiceLike, type ChoiceNudge, type ChoiceOption, type ChoiceOptions, type ChoiceRehome, type ChoiceUsage, type ChoicesRehomed, type CoerceOptions, type Coerced, type CoercedAnswers, type CoercibleField, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DECLARABLE_FIELD_KINDS, DEFAULT_ARCHIVE_LANE, DEFAULT_PORTAL_ARCHIVE_FILTER, DELIVERIES, DRILL_CHART_TOKENS, DRILL_DESCRIPTION_MAX, DRILL_DOORS, DRILL_SCHEMA, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type DashboardTarget, type DashboardTargetBase, type DashboardTargetOp, type DashboardTargetResult, type DashboardTotals, type DataHomeTable, type DeclarableFieldKind, type DecorationColor, type DecorationPath, type DecorationRule, type DecorationRuleOp, type DecorationTarget, type Delivery, type DigestPreview, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, type DrillAdHocOp, type DrillAnswer, type DrillAnswerRow, type DrillChartToken, type DrillDeclaration, type DrillDefinition, type DrillDimension, type DrillFinding, type DrillGrain, type DrillHaving, type DrillLane, type DrillLevel, type DrillMeasure, type DrillMeasureOp, type DrillMeasureWhereValue, type DrillPath, type DrillQuestion, type DrillRecords, type DrillRowsPage, type DrillSource, type DrillView, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityBackLinkItem, type EntityBackLinks, type EntityFieldRights, type EntityFieldValue, type EntityFieldsAcross, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityRef, type EntityRefWithWords, type EntityReferenceKind, type EntityReferenceRead, type EntityRowWritten, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_KINDS, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldDrift, type FieldDriftAspect, type FieldDuplicated, type FieldHistoryEntry, type FieldKind, type FieldOptionEdit, type FieldOptions, type FieldPatch, type FieldProposal, type FieldRetyped, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormArchiveAnswer, type FormLookOptions, type FormResults, type FormRoute, type FormSummary, type FormulaParse, type Freshness, GRADUATION_BASE_COLUMNS, type GraduatedRelation, type GraduatedRow, type GridLayout, type GridLayoutMode, type GridRowHeight, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportColumnsDeclared, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, type InboxCounts, type InboxStateChange, type InsertOf, type IoExportPage, KERNEL_TABLES, type KernelTableName, type KernelTargets, type KeysetRow, type ListTableRowsOptions, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MigrationUndone, type MissingBehavior, type MyLevel, type MySubscription, NEWER_FIELD_KINDS, NOT_A_MEMBER_WORDS, type NewEntityFieldDeclaration, type NewFieldDeclaration, type NewerFieldKind, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OutsideShareAnswer, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, PIPELINE_RULE_KINDS, PORTAL_ACCENTS, PORTAL_ARCHIVE_FILTERS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PersonStamp, type PgError, type Pipeline, type PipelineColumn, type PipelineDeclared, type PipelineGate, type PipelineGatePreview, type PipelineMissingField, type PipelineMoveMany, type PipelineMoveManyItem, type PipelineMoveManyResult, type PipelineMoveResult, type PipelineMoveVerdict, type PipelineRule, type PipelineRuleKind, type PipelineSpec, type PipelineStage, type PipelineVerdict, type PortalAccent, type PortalArchiveAnswer, type PortalArchiveFilter, type PortalCard, type PortalConfig, type PortalConfigInput, type PortalFooterLink, type PortalFormAnswer, type PortalFormInput, type PortalFormRef, type PortalFormSpec, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalStage, type PortalStyle, type PortalStyleInput, type PortalSummary, type PortalTableExposure, type PortalTableRef, type PredictedRefusal, type ProvenancePointer, type PublicPicture, type PublishBinding, type PublishBindingKind, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, type QuietHours, RECORDS_CACHE_GRACE_MS, REFUSALS_WORTH_REPEATING, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, REVERSE_LINKS_PAGE_MAX, REVERSE_LINKS_RECORDS_PER_CALL, ROW_WEB_NOT_READY, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordChange, type RecordChangeAction, type RecordChangeResult, type RecordComment, type RecordDocument, type RecordEvent, type RecordFilter, type RecordGraphWritten, type RecordHeader, type RecordHistoryEntry, type RecordKeysetPage, type RecordPage, type RecordPageData, type RecordPageSort, type RecordRead, type RecordRevision, type RecordRowControls, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsChangeSink, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, RecordsHoldScope, type RecordsMerged, RecordsProvider, type RecordsProviderProps, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, RecordsSeedProvider, type RecordsSeedProviderProps, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationDisplay, type RelationFlavor, type RelationIcons, type RelationNameIndex, type RelationNameMatch, type RelationNamesAnswer, type RelationProperties, type RelationTarget, type RelationWordsManyArgs, type ResolutionTriple, type ResolvedPublishBinding, type ResolvedPublishBindingKind, type RestorePreview, type RestoreResult, type RetiredActorWord, type RetypeBehaviour, type RetypePreview, type ReverseColumn, type ReverseLink, type ReverseLinks, type ReverseLinksManyArgs, type RowAction, type RowActionStep, type RowDefaultsApplied, type RowOf, type RowTemplateRow, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, SEED_FRESH_MS, SHOWN_TO_LABEL, SHOWN_TO_VALUES, SHOWN_TO_WHO_MAY_CHANGE, STAGE_RULE_ENFORCEMENT, STAGE_RULE_ON_FAIL, STATUS_GROUPS, STATUS_GROUP_WORDS, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, STORE_ROWS_CEILING, SYSTEM_WRITER_WORDS, type SavedViewColorBy, type SavedViewDefinition, type SavedViewLayout, type SavedViewRow, type SavedViewSpecIn, type ShownTo, type SourceArchived, type StagePending, type StagePendingOnBoard, type StageRuleEnforcement, type StageRuleOnFail, type StageRuleWarning, type StaleWriteDetail, type StatusGroup, type StorageMode, type StoreDoorName, type StoreFilter, type StoreInsertOf, type StoreRefusalCode, type StoreRowOf, type StoreRowSnapshot, type StoreTable, type StoreTableColumn, type StoreTableRows, type StoreTableSort, type StoreTableWhere, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, type SubscriptionSpec, TABLE_DISPLAYS, TABLE_KIND_PREFIX, TABLE_ORIGINS, TABLE_TYPES, TO_ASSOCIATION, TO_CUSTOM_FIELDS, type Table, type TableArchiveProgress, type TableCapacity, type TableCopyInProgress, type TableDecorations, type TableDisplay, type TableDuplicateProgress, type TableDuplicated, type TableHome, type TableHomeDestination, type TableKindFacts, type TableListEntry, type TableMoved, type TableOrigin, type TablePlacement, type TablePlacementFact, type TableProposal, type TableRenderSchema, type TableRestoreProgress, type TableRowCount, type TableRowDefaults, type TableRowDefaultsPatch, type TableSchemaMode, type TableSyncResult, type TableSyncSource, type TableSyncSpec, type TableType, type TableWebhook, type TableWebhookDeclared, type Timestamp, type TypedChoiceDecision, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, type UniqueKeys, type UseAppTable, type UseAppTableOptions, type UseEntityBackLinks, type UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordOptions, type UseRecordPageOptions, type UseRecordPageState, type UseRecordsOptions, type UseRecordsState, type UseStoreTable, type UseTableArchive, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type ViewLayout, type ViewOrderSet, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprovalState, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDecideMany, type WorkDecideManyItem, type WorkDecideManyResult, type WorkDecideVerdict, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInboxView, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, actionRefusals, addressFromText, addressMapUrl, addressText, allowsOtherValues, archiveAppTableDeliberately, archiveTableRow, archivedByLine, archivedWhen, asChoiceNudge, asPermissionLevel, atLeast, bookingPath, callersTimeZone, checkAppTable, choiceSlug, choiceValuesOf, choicesOf, coerceTypedAnswer, coerceTypedAnswers, coercionLabel, decideTypedChoice, declareDrillDefinition, defineAppTable, drillAnswerOf, drillFindingKnob, durationText, emptyArchiveLine, emptyPortalArchiveLine, ensureAppTable, entityReferenceKinds, entityReferenceKindsOf, entityReferenceSearch, entityReferenceWords, entityRefsOf, entityRefsToWrite, err, exportPageXlsx, f, fieldKindFor, fieldKindOf, forgetAllOps, graduatedRow, graduationProblems, hasQuietHours, highestLevel, holdsARetiredChoice, indexedDbStore, isAddressValue, isArchiveLane, isDecided, isEntityReferenceConfig, isFoundation, isOwnOp, isPersonStamp, isPortalAccent, isPortalArchiveFilter, isRecordsErr, isRuleFilter, isShownTo, isTableKind, isTheChosen, keptGroups, keptOutOfSight, keptTableHref, liftWithheld, listAppRows, listTableRows, localeDateOrder, looksLikeAnId, mayDrag, measureKey, memoryStore, mintClientKey, mintOpId, moveConsequence, moveInOrder, newerKindExportWords, newerKindOf, newerKindWords, offeredAsContext, ok, openCaptureQueue, optionKey, optionLabel, parseFieldDrift, parseTableCopiesInProgress, parseTableDuplicateProgress, parseTableDuplicated, parseTableHome, parseTableMoved, personStampText, portalArchiveConsequence, portalConfirmLine, portalPath, portalTitleTypedBack, previewRetype, previewRuleChange, publicFormPath, rankTypedMatches, ratingMaxOf, readTypedDate, readTypedDuration, readTypedNumber, readTypedTime, recordChangeTrigger, recordSourceKey, recordSourceTable, recordsCacheCounters, recordsUseSentence, rehomeSentence, relationNameIndexOf, relationNameKey, relationNamesIn, rememberedOpCount, removeAppRow, removedChoicesInUse, richTextPlain, rowFromDocument, ruleThatRefuses, rulesWithTopStar, safeLinkHref, sameDocument, scopeChip, sha256Hex, sheetSyncSpec, sourceArchivedOf, splitListCell, stableFilterKey, statusGroupOf, storeTable, tableIdOf, tableJsonSchema, tableKindMapping, tableKindSlug, tableRenderSchema, tableShapeChanged, twoDigitYear, typedDateText, typedMatchScore, typedTimeText, updateTableRow, upsertAppRow, useAppTable, useEntityBackLinks, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityReferenceKinds, useEntityReferenceSearch, useEntityReferenceWords, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordChangeRevision, useRecordMutation, useRecordPage, useRecords, useRecordsActor, useRecordsClient, useRecordsHold, useReverseColumns, useReverseLinks, useRowActions, useSeededAggregate, useSeededAnswer, useSeededSource, useStoreTable, useTable, useTableArchive, useTables, valueConverts, withCallersClock, withRowCounts, withTablePlacement, writeTableRow };

package/dist/react/index.d.ts

@@ -15174,6 +15174,13 @@ declare function useSeededAnswer<T>(key: string | null, run: (client: RecordsCli
     ok: false;
     error: RecordsError;
 }>): T | undefined;
+/**
+ * A TILE'S NUMBER FROM THE SERVER'S SEED (lane SEED-ENTITY): the rows of `custom.record_aggregate`
+ * for `spec` over `tableId`, when the page seed holds that exact question (`askTileSeed`, records-ui
+ * `/first-page`); else `undefined` and the tile reads for itself. Asks through `client.recordAggregate`,
+ * so the arguments are exactly the ones the tile's own read sends.
+ */
+declare function useSeededAggregate(tableId: Uuid | null, spec: Omit<Parameters<RecordsClient["recordAggregate"]>[0], "table_id">): AggregateRow[] | undefined;
 /** One Table's declaration. */
 declare function useTable(tableId: Uuid | null): Async<Table | null>;
 /** Every Table this person can see in this organization. */
@@ -15548,6 +15555,19 @@ interface SeedStore {
         ok: false;
         error: RecordsError;
     }>, config: RecordsConfig): Promise<SeedOutcome<T>>;
+    /**
+     * The same, for a reader that holds no records client (the entity engine): `run` is handed a data
+     * source that answers from the seed only. A miss anywhere in the run is "not seeded".
+     */
+    runSource<T>(slot: string, run: (source: RecordsDataSource) => Promise<{
+        ok: true;
+        data: T;
+    } | {
+        ok: false;
+        error: unknown;
+    }>): Promise<SeedOutcome<T>>;
+    /** Epoch ms the server asked. */
+    at: number;
 }
 interface RecordsSeedProviderProps {
     /** What the server asked for this page as the person (`recordingDataSource(...).seed()`), or null. */
@@ -15556,6 +15576,24 @@ interface RecordsSeedProviderProps {
 }
 /** Mount above a server-rendered records screen. A null seed is no seed: every hook asks for itself. */
 declare function RecordsSeedProvider({ seed, children }: RecordsSeedProviderProps): react.FunctionComponentElement<react.ProviderProps<SeedStore | null>>;
+/**
+ * A READER WITHOUT A RECORDS CLIENT, AGAINST THE PAGE SEED (lane SEED-ENTITY): under a live
+ * `<RecordsSeedProvider>`, `run` is asked of a data source that answers from the seed only —
+ * suspending on the server and while hydrating, never touching the network. Its answer (and when the
+ * server asked) is returned for the reader to start from; a miss, or no seed, answers `undefined` and
+ * the reader asks for itself. Always suspends while the seed is live (React matches awaited promises
+ * by order), so call it unconditionally.
+ */
+declare function useSeededSource<T>(key: string | null, run: (source: RecordsDataSource) => Promise<{
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: unknown;
+}>): {
+    data: T;
+    at: number;
+} | undefined;
 
 /** How long an entry outlives its last reader, so a remount or an Undo costs nothing. */
 declare const RECORDS_CACHE_GRACE_MS = 30000;
@@ -16008,4 +16046,4 @@ interface ArchiveDeliberatelyArgs {
 }
 declare function archiveAppTableDeliberately(client: RecordsClient, args: ArchiveDeliberatelyArgs): Promise<RecordsResult<TableArchiveProgress>>;
 
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, ADDRESS_PARTS, AGENT_WRITER_WORDS, APP_ROWS_CEILING, ARCHIVE_LANES, ARCHIVE_LANE_LABEL, ARCHIVE_LANE_MEANS, type AbsenceReason, type ActionRefusal, type ActionRunResult, type Actor, type AddressPart, type AddressValue, type AggregateBucket, type AggregateCompare, type AggregateCompareKind, type AggregateCompareWindows, type AggregateDelta, type AggregateFilter, type AggregateGroupValue, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, type AnyAppTableDef, type AnyStoreTable, type AppField, type AppFields, type AppRows, type AppTableChecked, type AppTableDef, type AppTableEnsured, type AppTableGraduation, type AppTableInput, type AppTableOrgOptions, type AppTableScope, type AppTableStatus, type AppUpsertOptions, type ArchiveDeliberatelyArgs, type ArchiveLane, type ArchivedChecklistTemplate, type ArchivedDoorRow, type ArchivedForm, type ArchivedRow, type AutomationAction, type AutomationDeclared, type AutomationFilter, type AutomationFlipped, type AutomationItem, type AutomationLastRun, type AutomationList, type AutomationRun, type AutomationRunStatus, type AutomationRuns, type AutomationSpec, type AutomationStep, type AutomationTrigger, type AutomationValue, type AutomationValues, BARCODE_SYMBOLOGIES, BUILT_KIND_WORD, type BookingAvailability, type BookingDeclared, type BookingSummary, type BookingWindow, CHOICE_NUDGES, COMPUTE_ON, CONTEXT_POLICIES, type CaptureField, type CaptureFileRef, type CaptureOutcome, type CaptureQuestion, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSheetFace, type CaptureSheetSummary, type CaptureSyncReport, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceCellBack, type ChoiceLike, type ChoiceNudge, type ChoiceOption, type ChoiceOptions, type ChoiceRehome, type ChoiceUsage, type ChoicesRehomed, type CoerceOptions, type Coerced, type CoercedAnswers, type CoercibleField, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DECLARABLE_FIELD_KINDS, DEFAULT_ARCHIVE_LANE, DEFAULT_PORTAL_ARCHIVE_FILTER, DELIVERIES, DRILL_CHART_TOKENS, DRILL_DESCRIPTION_MAX, DRILL_DOORS, DRILL_SCHEMA, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type DashboardTarget, type DashboardTargetBase, type DashboardTargetOp, type DashboardTargetResult, type DashboardTotals, type DataHomeTable, type DeclarableFieldKind, type DecorationColor, type DecorationPath, type DecorationRule, type DecorationRuleOp, type DecorationTarget, type Delivery, type DigestPreview, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, type DrillAdHocOp, type DrillAnswer, type DrillAnswerRow, type DrillChartToken, type DrillDeclaration, type DrillDefinition, type DrillDimension, type DrillFinding, type DrillGrain, type DrillHaving, type DrillLane, type DrillLevel, type DrillMeasure, type DrillMeasureOp, type DrillMeasureWhereValue, type DrillPath, type DrillQuestion, type DrillRecords, type DrillRowsPage, type DrillSource, type DrillView, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityBackLinkItem, type EntityBackLinks, type EntityFieldRights, type EntityFieldValue, type EntityFieldsAcross, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityRef, type EntityRefWithWords, type EntityReferenceKind, type EntityReferenceRead, type EntityRowWritten, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_KINDS, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldDrift, type FieldDriftAspect, type FieldDuplicated, type FieldHistoryEntry, type FieldKind, type FieldOptionEdit, type FieldOptions, type FieldPatch, type FieldProposal, type FieldRetyped, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormArchiveAnswer, type FormLookOptions, type FormResults, type FormRoute, type FormSummary, type FormulaParse, type Freshness, GRADUATION_BASE_COLUMNS, type GraduatedRelation, type GraduatedRow, type GridLayout, type GridLayoutMode, type GridRowHeight, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportColumnsDeclared, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, type InboxCounts, type InboxStateChange, type InsertOf, type IoExportPage, KERNEL_TABLES, type KernelTableName, type KernelTargets, type KeysetRow, type ListTableRowsOptions, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MigrationUndone, type MissingBehavior, type MyLevel, type MySubscription, NEWER_FIELD_KINDS, NOT_A_MEMBER_WORDS, type NewEntityFieldDeclaration, type NewFieldDeclaration, type NewerFieldKind, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OutsideShareAnswer, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, PIPELINE_RULE_KINDS, PORTAL_ACCENTS, PORTAL_ARCHIVE_FILTERS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PersonStamp, type PgError, type Pipeline, type PipelineColumn, type PipelineDeclared, type PipelineGate, type PipelineGatePreview, type PipelineMissingField, type PipelineMoveMany, type PipelineMoveManyItem, type PipelineMoveManyResult, type PipelineMoveResult, type PipelineMoveVerdict, type PipelineRule, type PipelineRuleKind, type PipelineSpec, type PipelineStage, type PipelineVerdict, type PortalAccent, type PortalArchiveAnswer, type PortalArchiveFilter, type PortalCard, type PortalConfig, type PortalConfigInput, type PortalFooterLink, type PortalFormAnswer, type PortalFormInput, type PortalFormRef, type PortalFormSpec, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalStage, type PortalStyle, type PortalStyleInput, type PortalSummary, type PortalTableExposure, type PortalTableRef, type PredictedRefusal, type ProvenancePointer, type PublicPicture, type PublishBinding, type PublishBindingKind, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, type QuietHours, RECORDS_CACHE_GRACE_MS, REFUSALS_WORTH_REPEATING, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, REVERSE_LINKS_PAGE_MAX, REVERSE_LINKS_RECORDS_PER_CALL, ROW_WEB_NOT_READY, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordChange, type RecordChangeAction, type RecordChangeResult, type RecordComment, type RecordDocument, type RecordEvent, type RecordFilter, type RecordGraphWritten, type RecordHeader, type RecordHistoryEntry, type RecordKeysetPage, type RecordPage, type RecordPageData, type RecordPageSort, type RecordRead, type RecordRevision, type RecordRowControls, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsChangeSink, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, RecordsHoldScope, type RecordsMerged, RecordsProvider, type RecordsProviderProps, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, RecordsSeedProvider, type RecordsSeedProviderProps, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationDisplay, type RelationFlavor, type RelationIcons, type RelationNameIndex, type RelationNameMatch, type RelationNamesAnswer, type RelationProperties, type RelationTarget, type RelationWordsManyArgs, type ResolutionTriple, type ResolvedPublishBinding, type ResolvedPublishBindingKind, type RestorePreview, type RestoreResult, type RetiredActorWord, type RetypeBehaviour, type RetypePreview, type ReverseColumn, type ReverseLink, type ReverseLinks, type ReverseLinksManyArgs, type RowAction, type RowActionStep, type RowDefaultsApplied, type RowOf, type RowTemplateRow, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, SEED_FRESH_MS, SHOWN_TO_LABEL, SHOWN_TO_VALUES, SHOWN_TO_WHO_MAY_CHANGE, STAGE_RULE_ENFORCEMENT, STAGE_RULE_ON_FAIL, STATUS_GROUPS, STATUS_GROUP_WORDS, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, STORE_ROWS_CEILING, SYSTEM_WRITER_WORDS, type SavedViewColorBy, type SavedViewDefinition, type SavedViewLayout, type SavedViewRow, type SavedViewSpecIn, type ShownTo, type SourceArchived, type StagePending, type StagePendingOnBoard, type StageRuleEnforcement, type StageRuleOnFail, type StageRuleWarning, type StaleWriteDetail, type StatusGroup, type StorageMode, type StoreDoorName, type StoreFilter, type StoreInsertOf, type StoreRefusalCode, type StoreRowOf, type StoreRowSnapshot, type StoreTable, type StoreTableColumn, type StoreTableRows, type StoreTableSort, type StoreTableWhere, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, type SubscriptionSpec, TABLE_DISPLAYS, TABLE_KIND_PREFIX, TABLE_ORIGINS, TABLE_TYPES, TO_ASSOCIATION, TO_CUSTOM_FIELDS, type Table, type TableArchiveProgress, type TableCapacity, type TableCopyInProgress, type TableDecorations, type TableDisplay, type TableDuplicateProgress, type TableDuplicated, type TableHome, type TableHomeDestination, type TableKindFacts, type TableListEntry, type TableMoved, type TableOrigin, type TablePlacement, type TablePlacementFact, type TableProposal, type TableRenderSchema, type TableRestoreProgress, type TableRowCount, type TableRowDefaults, type TableRowDefaultsPatch, type TableSchemaMode, type TableSyncResult, type TableSyncSource, type TableSyncSpec, type TableType, type TableWebhook, type TableWebhookDeclared, type Timestamp, type TypedChoiceDecision, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, type UniqueKeys, type UseAppTable, type UseAppTableOptions, type UseEntityBackLinks, type UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordOptions, type UseRecordPageOptions, type UseRecordPageState, type UseRecordsOptions, type UseRecordsState, type UseStoreTable, type UseTableArchive, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type ViewLayout, type ViewOrderSet, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprovalState, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDecideMany, type WorkDecideManyItem, type WorkDecideManyResult, type WorkDecideVerdict, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInboxView, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, actionRefusals, addressFromText, addressMapUrl, addressText, allowsOtherValues, archiveAppTableDeliberately, archiveTableRow, archivedByLine, archivedWhen, asChoiceNudge, asPermissionLevel, atLeast, bookingPath, callersTimeZone, checkAppTable, choiceSlug, choiceValuesOf, choicesOf, coerceTypedAnswer, coerceTypedAnswers, coercionLabel, decideTypedChoice, declareDrillDefinition, defineAppTable, drillAnswerOf, drillFindingKnob, durationText, emptyArchiveLine, emptyPortalArchiveLine, ensureAppTable, entityReferenceKinds, entityReferenceKindsOf, entityReferenceSearch, entityReferenceWords, entityRefsOf, entityRefsToWrite, err, exportPageXlsx, f, fieldKindFor, fieldKindOf, forgetAllOps, graduatedRow, graduationProblems, hasQuietHours, highestLevel, holdsARetiredChoice, indexedDbStore, isAddressValue, isArchiveLane, isDecided, isEntityReferenceConfig, isFoundation, isOwnOp, isPersonStamp, isPortalAccent, isPortalArchiveFilter, isRecordsErr, isRuleFilter, isShownTo, isTableKind, isTheChosen, keptGroups, keptOutOfSight, keptTableHref, liftWithheld, listAppRows, listTableRows, localeDateOrder, looksLikeAnId, mayDrag, measureKey, memoryStore, mintClientKey, mintOpId, moveConsequence, moveInOrder, newerKindExportWords, newerKindOf, newerKindWords, offeredAsContext, ok, openCaptureQueue, optionKey, optionLabel, parseFieldDrift, parseTableCopiesInProgress, parseTableDuplicateProgress, parseTableDuplicated, parseTableHome, parseTableMoved, personStampText, portalArchiveConsequence, portalConfirmLine, portalPath, portalTitleTypedBack, previewRetype, previewRuleChange, publicFormPath, rankTypedMatches, ratingMaxOf, readTypedDate, readTypedDuration, readTypedNumber, readTypedTime, recordChangeTrigger, recordSourceKey, recordSourceTable, recordsCacheCounters, recordsUseSentence, rehomeSentence, relationNameIndexOf, relationNameKey, relationNamesIn, rememberedOpCount, removeAppRow, removedChoicesInUse, richTextPlain, rowFromDocument, ruleThatRefuses, rulesWithTopStar, safeLinkHref, sameDocument, scopeChip, sha256Hex, sheetSyncSpec, sourceArchivedOf, splitListCell, stableFilterKey, statusGroupOf, storeTable, tableIdOf, tableJsonSchema, tableKindMapping, tableKindSlug, tableRenderSchema, tableShapeChanged, twoDigitYear, typedDateText, typedMatchScore, typedTimeText, updateTableRow, upsertAppRow, useAppTable, useEntityBackLinks, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityReferenceKinds, useEntityReferenceSearch, useEntityReferenceWords, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordChangeRevision, useRecordMutation, useRecordPage, useRecords, useRecordsActor, useRecordsClient, useRecordsHold, useReverseColumns, useReverseLinks, useRowActions, useSeededAnswer, useStoreTable, useTable, useTableArchive, useTables, valueConverts, withCallersClock, withRowCounts, withTablePlacement, writeTableRow };
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, ADDRESS_PARTS, AGENT_WRITER_WORDS, APP_ROWS_CEILING, ARCHIVE_LANES, ARCHIVE_LANE_LABEL, ARCHIVE_LANE_MEANS, type AbsenceReason, type ActionRefusal, type ActionRunResult, type Actor, type AddressPart, type AddressValue, type AggregateBucket, type AggregateCompare, type AggregateCompareKind, type AggregateCompareWindows, type AggregateDelta, type AggregateFilter, type AggregateGroupValue, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, type AnyAppTableDef, type AnyStoreTable, type AppField, type AppFields, type AppRows, type AppTableChecked, type AppTableDef, type AppTableEnsured, type AppTableGraduation, type AppTableInput, type AppTableOrgOptions, type AppTableScope, type AppTableStatus, type AppUpsertOptions, type ArchiveDeliberatelyArgs, type ArchiveLane, type ArchivedChecklistTemplate, type ArchivedDoorRow, type ArchivedForm, type ArchivedRow, type AutomationAction, type AutomationDeclared, type AutomationFilter, type AutomationFlipped, type AutomationItem, type AutomationLastRun, type AutomationList, type AutomationRun, type AutomationRunStatus, type AutomationRuns, type AutomationSpec, type AutomationStep, type AutomationTrigger, type AutomationValue, type AutomationValues, BARCODE_SYMBOLOGIES, BUILT_KIND_WORD, type BookingAvailability, type BookingDeclared, type BookingSummary, type BookingWindow, CHOICE_NUDGES, COMPUTE_ON, CONTEXT_POLICIES, type CaptureField, type CaptureFileRef, type CaptureOutcome, type CaptureQuestion, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSheetFace, type CaptureSheetSummary, type CaptureSyncReport, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceCellBack, type ChoiceLike, type ChoiceNudge, type ChoiceOption, type ChoiceOptions, type ChoiceRehome, type ChoiceUsage, type ChoicesRehomed, type CoerceOptions, type Coerced, type CoercedAnswers, type CoercibleField, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DECLARABLE_FIELD_KINDS, DEFAULT_ARCHIVE_LANE, DEFAULT_PORTAL_ARCHIVE_FILTER, DELIVERIES, DRILL_CHART_TOKENS, DRILL_DESCRIPTION_MAX, DRILL_DOORS, DRILL_SCHEMA, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type DashboardTarget, type DashboardTargetBase, type DashboardTargetOp, type DashboardTargetResult, type DashboardTotals, type DataHomeTable, type DeclarableFieldKind, type DecorationColor, type DecorationPath, type DecorationRule, type DecorationRuleOp, type DecorationTarget, type Delivery, type DigestPreview, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, type DrillAdHocOp, type DrillAnswer, type DrillAnswerRow, type DrillChartToken, type DrillDeclaration, type DrillDefinition, type DrillDimension, type DrillFinding, type DrillGrain, type DrillHaving, type DrillLane, type DrillLevel, type DrillMeasure, type DrillMeasureOp, type DrillMeasureWhereValue, type DrillPath, type DrillQuestion, type DrillRecords, type DrillRowsPage, type DrillSource, type DrillView, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityBackLinkItem, type EntityBackLinks, type EntityFieldRights, type EntityFieldValue, type EntityFieldsAcross, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityRef, type EntityRefWithWords, type EntityReferenceKind, type EntityReferenceRead, type EntityRowWritten, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_KINDS, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldDrift, type FieldDriftAspect, type FieldDuplicated, type FieldHistoryEntry, type FieldKind, type FieldOptionEdit, type FieldOptions, type FieldPatch, type FieldProposal, type FieldRetyped, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormArchiveAnswer, type FormLookOptions, type FormResults, type FormRoute, type FormSummary, type FormulaParse, type Freshness, GRADUATION_BASE_COLUMNS, type GraduatedRelation, type GraduatedRow, type GridLayout, type GridLayoutMode, type GridRowHeight, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportColumnsDeclared, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, type InboxCounts, type InboxStateChange, type InsertOf, type IoExportPage, KERNEL_TABLES, type KernelTableName, type KernelTargets, type KeysetRow, type ListTableRowsOptions, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MigrationUndone, type MissingBehavior, type MyLevel, type MySubscription, NEWER_FIELD_KINDS, NOT_A_MEMBER_WORDS, type NewEntityFieldDeclaration, type NewFieldDeclaration, type NewerFieldKind, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OutsideShareAnswer, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, PIPELINE_RULE_KINDS, PORTAL_ACCENTS, PORTAL_ARCHIVE_FILTERS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PersonStamp, type PgError, type Pipeline, type PipelineColumn, type PipelineDeclared, type PipelineGate, type PipelineGatePreview, type PipelineMissingField, type PipelineMoveMany, type PipelineMoveManyItem, type PipelineMoveManyResult, type PipelineMoveResult, type PipelineMoveVerdict, type PipelineRule, type PipelineRuleKind, type PipelineSpec, type PipelineStage, type PipelineVerdict, type PortalAccent, type PortalArchiveAnswer, type PortalArchiveFilter, type PortalCard, type PortalConfig, type PortalConfigInput, type PortalFooterLink, type PortalFormAnswer, type PortalFormInput, type PortalFormRef, type PortalFormSpec, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalStage, type PortalStyle, type PortalStyleInput, type PortalSummary, type PortalTableExposure, type PortalTableRef, type PredictedRefusal, type ProvenancePointer, type PublicPicture, type PublishBinding, type PublishBindingKind, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, type QuietHours, RECORDS_CACHE_GRACE_MS, REFUSALS_WORTH_REPEATING, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, REVERSE_LINKS_PAGE_MAX, REVERSE_LINKS_RECORDS_PER_CALL, ROW_WEB_NOT_READY, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordChange, type RecordChangeAction, type RecordChangeResult, type RecordComment, type RecordDocument, type RecordEvent, type RecordFilter, type RecordGraphWritten, type RecordHeader, type RecordHistoryEntry, type RecordKeysetPage, type RecordPage, type RecordPageData, type RecordPageSort, type RecordRead, type RecordRevision, type RecordRowControls, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsChangeSink, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, RecordsHoldScope, type RecordsMerged, RecordsProvider, type RecordsProviderProps, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, RecordsSeedProvider, type RecordsSeedProviderProps, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationDisplay, type RelationFlavor, type RelationIcons, type RelationNameIndex, type RelationNameMatch, type RelationNamesAnswer, type RelationProperties, type RelationTarget, type RelationWordsManyArgs, type ResolutionTriple, type ResolvedPublishBinding, type ResolvedPublishBindingKind, type RestorePreview, type RestoreResult, type RetiredActorWord, type RetypeBehaviour, type RetypePreview, type ReverseColumn, type ReverseLink, type ReverseLinks, type ReverseLinksManyArgs, type RowAction, type RowActionStep, type RowDefaultsApplied, type RowOf, type RowTemplateRow, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, SEED_FRESH_MS, SHOWN_TO_LABEL, SHOWN_TO_VALUES, SHOWN_TO_WHO_MAY_CHANGE, STAGE_RULE_ENFORCEMENT, STAGE_RULE_ON_FAIL, STATUS_GROUPS, STATUS_GROUP_WORDS, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, STORE_ROWS_CEILING, SYSTEM_WRITER_WORDS, type SavedViewColorBy, type SavedViewDefinition, type SavedViewLayout, type SavedViewRow, type SavedViewSpecIn, type ShownTo, type SourceArchived, type StagePending, type StagePendingOnBoard, type StageRuleEnforcement, type StageRuleOnFail, type StageRuleWarning, type StaleWriteDetail, type StatusGroup, type StorageMode, type StoreDoorName, type StoreFilter, type StoreInsertOf, type StoreRefusalCode, type StoreRowOf, type StoreRowSnapshot, type StoreTable, type StoreTableColumn, type StoreTableRows, type StoreTableSort, type StoreTableWhere, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, type SubscriptionSpec, TABLE_DISPLAYS, TABLE_KIND_PREFIX, TABLE_ORIGINS, TABLE_TYPES, TO_ASSOCIATION, TO_CUSTOM_FIELDS, type Table, type TableArchiveProgress, type TableCapacity, type TableCopyInProgress, type TableDecorations, type TableDisplay, type TableDuplicateProgress, type TableDuplicated, type TableHome, type TableHomeDestination, type TableKindFacts, type TableListEntry, type TableMoved, type TableOrigin, type TablePlacement, type TablePlacementFact, type TableProposal, type TableRenderSchema, type TableRestoreProgress, type TableRowCount, type TableRowDefaults, type TableRowDefaultsPatch, type TableSchemaMode, type TableSyncResult, type TableSyncSource, type TableSyncSpec, type TableType, type TableWebhook, type TableWebhookDeclared, type Timestamp, type TypedChoiceDecision, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, type UniqueKeys, type UseAppTable, type UseAppTableOptions, type UseEntityBackLinks, type UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordOptions, type UseRecordPageOptions, type UseRecordPageState, type UseRecordsOptions, type UseRecordsState, type UseStoreTable, type UseTableArchive, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type ViewLayout, type ViewOrderSet, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprovalState, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDecideMany, type WorkDecideManyItem, type WorkDecideManyResult, type WorkDecideVerdict, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInboxView, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, actionRefusals, addressFromText, addressMapUrl, addressText, allowsOtherValues, archiveAppTableDeliberately, archiveTableRow, archivedByLine, archivedWhen, asChoiceNudge, asPermissionLevel, atLeast, bookingPath, callersTimeZone, checkAppTable, choiceSlug, choiceValuesOf, choicesOf, coerceTypedAnswer, coerceTypedAnswers, coercionLabel, decideTypedChoice, declareDrillDefinition, defineAppTable, drillAnswerOf, drillFindingKnob, durationText, emptyArchiveLine, emptyPortalArchiveLine, ensureAppTable, entityReferenceKinds, entityReferenceKindsOf, entityReferenceSearch, entityReferenceWords, entityRefsOf, entityRefsToWrite, err, exportPageXlsx, f, fieldKindFor, fieldKindOf, forgetAllOps, graduatedRow, graduationProblems, hasQuietHours, highestLevel, holdsARetiredChoice, indexedDbStore, isAddressValue, isArchiveLane, isDecided, isEntityReferenceConfig, isFoundation, isOwnOp, isPersonStamp, isPortalAccent, isPortalArchiveFilter, isRecordsErr, isRuleFilter, isShownTo, isTableKind, isTheChosen, keptGroups, keptOutOfSight, keptTableHref, liftWithheld, listAppRows, listTableRows, localeDateOrder, looksLikeAnId, mayDrag, measureKey, memoryStore, mintClientKey, mintOpId, moveConsequence, moveInOrder, newerKindExportWords, newerKindOf, newerKindWords, offeredAsContext, ok, openCaptureQueue, optionKey, optionLabel, parseFieldDrift, parseTableCopiesInProgress, parseTableDuplicateProgress, parseTableDuplicated, parseTableHome, parseTableMoved, personStampText, portalArchiveConsequence, portalConfirmLine, portalPath, portalTitleTypedBack, previewRetype, previewRuleChange, publicFormPath, rankTypedMatches, ratingMaxOf, readTypedDate, readTypedDuration, readTypedNumber, readTypedTime, recordChangeTrigger, recordSourceKey, recordSourceTable, recordsCacheCounters, recordsUseSentence, rehomeSentence, relationNameIndexOf, relationNameKey, relationNamesIn, rememberedOpCount, removeAppRow, removedChoicesInUse, richTextPlain, rowFromDocument, ruleThatRefuses, rulesWithTopStar, safeLinkHref, sameDocument, scopeChip, sha256Hex, sheetSyncSpec, sourceArchivedOf, splitListCell, stableFilterKey, statusGroupOf, storeTable, tableIdOf, tableJsonSchema, tableKindMapping, tableKindSlug, tableRenderSchema, tableShapeChanged, twoDigitYear, typedDateText, typedMatchScore, typedTimeText, updateTableRow, upsertAppRow, useAppTable, useEntityBackLinks, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityReferenceKinds, useEntityReferenceSearch, useEntityReferenceWords, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordChangeRevision, useRecordMutation, useRecordPage, useRecords, useRecordsActor, useRecordsClient, useRecordsHold, useReverseColumns, useReverseLinks, useRowActions, useSeededAggregate, useSeededAnswer, useSeededSource, useStoreTable, useTable, useTableArchive, useTables, valueConverts, withCallersClock, withRowCounts, withTablePlacement, writeTableRow };

package/dist/react/index.js

@@ -7576,7 +7576,7 @@ function useRecordsActor() {
 }
 
 // src/react/hooks.ts
-import { use, useCallback, useEffect as useEffect3, useId, useMemo as useMemo2, useRef as useRef2, useState, useSyncExternalStore } from "react";
+import { use as use2, useCallback, useEffect as useEffect3, useId, useMemo as useMemo2, useRef as useRef2, useState, useSyncExternalStore } from "react";
 
 // src/react/dataCache.ts
 var RECORDS_CACHE_GRACE_MS = 3e4;
@@ -7766,7 +7766,7 @@ function recordsCacheCounters() {
 }
 
 // src/react/seed.tsx
-import { createContext as createContext2, createElement as createElement2, useContext as useContext2, useEffect } from "react";
+import { createContext as createContext2, createElement as createElement2, use, useContext as useContext2, useEffect } from "react";
 
 // src/core/seed.ts
 var BUNDLE_DOORS = /* @__PURE__ */ new Set(["table_page_bundle", "record_page_bundle"]);
@@ -7832,8 +7832,22 @@ function storeFor(seed) {
   if (held) return held;
   const index = seedIndex(seed);
   const runs = /* @__PURE__ */ new Map();
+  const sourceRuns = /* @__PURE__ */ new Map();
   const store = {
     live: true,
+    at: seed.at,
+    runSource(slot, run) {
+      const asked = sourceRuns.get(slot);
+      if (asked) return asked;
+      const { source, missed } = seededDataSource(index);
+      const stale = typeof seed.at !== "number" || Date.now() - seed.at > SEED_FRESH_MS;
+      const outcome = Promise.resolve().then(() => run(source)).then(
+        (answer) => answer.ok && !missed() ? { seeded: true, data: answer.data, stale } : { seeded: false },
+        () => ({ seeded: false })
+      );
+      sourceRuns.set(slot, outcome);
+      return outcome;
+    },
     run(slot, run, config) {
       const asked = runs.get(slot);
       if (asked) return asked;
@@ -7876,6 +7890,12 @@ function useSeedStore() {
   const store = useContext2(SeedContext);
   return store && store.live ? store : null;
 }
+function useSeededSource(key, run) {
+  const store = useSeedStore();
+  if (!store || key === null) return void 0;
+  const outcome = use(store.runSource(key, run));
+  return outcome.seeded ? { data: outcome.data, at: store.at } : void 0;
+}
 
 // src/react/hold.tsx
 import { createContext as createContext3, createElement as createElement3, useContext as useContext3, useEffect as useEffect2 } from "react";
@@ -7929,7 +7949,7 @@ function useAsync(run, key, live) {
   entry.client = client;
   const seed = useSeedStore();
   if (seed) {
-    const outcome = use(seed.run(`${identityOf(client)}|${key}`, run, client.config));
+    const outcome = use2(seed.run(`${identityOf(client)}|${key}`, run, client.config));
     if (outcome.seeded && entry.snapshot.data === null && !entry.snapshot.error) seedEntry(entry, outcome.data, outcome.stale);
   }
   const snapshot = useSyncExternalStore(entry.subscribe, entry.getSnapshot, entry.getSnapshot);
@@ -7951,9 +7971,15 @@ function useSeededAnswer(key, run) {
   const client = useRecordsClient();
   const seed = useSeedStore();
   if (!seed || key === null) return void 0;
-  const outcome = use(seed.run(`${identityOf(client)}|own:${key}`, run, client.config));
+  const outcome = use2(seed.run(`${identityOf(client)}|own:${key}`, run, client.config));
   return outcome.seeded ? outcome.data : void 0;
 }
+function useSeededAggregate(tableId, spec) {
+  return useSeededAnswer(
+    tableId ? `aggregate:${tableId}:${JSON.stringify(spec)}` : null,
+    (client) => client.recordAggregate({ table_id: tableId, ...spec })
+  );
+}
 function serverEntry(run, client) {
   const entry = {
     key: "server",
@@ -10093,6 +10119,9 @@ function compileSort(sort, shape) {
   for (const s of sort ?? []) {
     const column = shape.columns.find((c) => c.key === s.column);
     if (!column) return { ok: false, error: noSuchColumn(s.column) };
+    if (column.type === "relation") {
+      return { ok: false, error: refusal2(`"${column.label}" is a link, so the store cannot sort by it.`, "Sort the rows on the page by each link's label. Nothing was read.") };
+    }
     const as = isNumberColumn(column.type) ? "number" : isDateColumn(column.type) ? "date" : "text";
     out.push({ field: column.key, direction: s.direction === "desc" ? "desc" : "asc", as });
   }
@@ -10136,6 +10165,11 @@ function relationIdsOf(value) {
   }
   return out;
 }
+var WORD_TYPES = /* @__PURE__ */ new Set(["text", "long_text", "rich_text", "email", "url", "phone", "markdown"]);
+function blankToNull(type, value) {
+  if (typeof value === "string" && value.trim() === "" && !WORD_TYPES.has(type)) return null;
+  return value;
+}
 function createTableDataPort({ client, aliases }) {
   const shapes = /* @__PURE__ */ new Map();
   let warnedNotLive2 = false;
@@ -10209,7 +10243,7 @@ function createTableDataPort({ client, aliases }) {
       if (!column) return refuse2("invalid_argument", `This table has no column "${key}".`, "Ask columns() for the keys this table has now. Nothing was saved.");
       if (column.readOnly) return refuse2("invalid_argument", `"${column.label}" is worked out by the table, so it cannot be written.`, "Nothing was saved.");
       const kinds = column.type === "relation" ? entityKindsOf(shape.fields.get(key)) : [];
-      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : value;
+      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : blankToNull(column.type, value);
     }
     return { ok: true, data: out };
   }
@@ -10716,7 +10750,7 @@ function useLive(alias, scope) {
     return acquireLive(qc, port, events, portKey, alias);
   }, [qc, port, events, portKey, alias]);
 }
-function useDataRows(alias, query = {}, scope) {
+function useDataRows(alias, query = {}, scope, seed) {
   const { port, portKey } = useDataPort(scope);
   const qc = useRecordsQueryClient();
   useLive(alias, scope);
@@ -10727,7 +10761,8 @@ function useDataRows(alias, query = {}, scope) {
       queryFn: async ({ pageParam }) => unwrap(await port.list(alias, query, pageParam ?? void 0)),
       initialPageParam: null,
       getNextPageParam: (last) => last.cursor ?? void 0,
-      retry: retryable
+      retry: retryable,
+      ...seed ? { initialData: { pages: [seed.data], pageParams: [null] }, initialDataUpdatedAt: seed.at } : {}
     },
     qc
   );
@@ -12588,7 +12623,9 @@ export {
   useReverseColumns,
   useReverseLinks,
   useRowActions,
+  useSeededAggregate,
   useSeededAnswer,
+  useSeededSource,
   useStoreTable,
   useTable,
   useTableArchive,