@xnetjs/react 2.1.0 → 2.3.0

package/dist/{chunk-SZQNGRTO.js → chunk-KK6VADMZ.js}

@@ -1,6 +1,6 @@
 import {
   useNodeStore
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/hooks/useUndoScope.ts
 import { UndoManager } from "@xnetjs/history";

package/dist/{chunk-HTFAHJQK.js → chunk-QSJJNEFY.js}

@@ -1,6 +1,6 @@
 import {
   useNodeStore
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/hooks/useDatabaseDoc.ts
 import {

package/dist/{chunk-ZGP56IIJ.js → chunk-RW3DSDKO.js}

@@ -7,7 +7,7 @@ import {
   useDataBridge,
   useTelemetryReporter,
   useTracingReporter
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/utils/flattenNode.ts
 function flattenNode(node, options) {

package/dist/{chunk-VZMZQTR7.js → chunk-UVJJN33U.js}

@@ -2,7 +2,7 @@ import {
   flattenNode,
   useQuery,
   useSyncManager
-} from "./chunk-ZGP56IIJ.js";
+} from "./chunk-RW3DSDKO.js";
 import {
   useInstrumentation
 } from "./chunk-JCOFKBOB.js";
@@ -11,7 +11,7 @@ import {
   useNodeStore,
   useXNet,
   useXNetInternal
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/hooks/useInfiniteQuery.ts
 import { createQueryDescriptor, serializeQueryDescriptor } from "@xnetjs/data-bridge";

package/dist/core.js

@@ -5,16 +5,16 @@ import {
   useInfiniteQuery,
   useIsOffline,
   useNode
-} from "./chunk-VZMZQTR7.js";
+} from "./chunk-UVJJN33U.js";
 import {
   useMutate,
   useQuery
-} from "./chunk-ZGP56IIJ.js";
+} from "./chunk-RW3DSDKO.js";
 import "./chunk-JCOFKBOB.js";
 import {
   XNetProvider,
   useXNet
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 export {
   ErrorBoundary,
   OfflineIndicator,

package/dist/database.js

@@ -6,8 +6,8 @@ import {
   useDatabaseSchema,
   useRelatedRows,
   useReverseRelations
-} from "./chunk-HTFAHJQK.js";
-import "./chunk-H44ZSIH4.js";
+} from "./chunk-QSJJNEFY.js";
+import "./chunk-5ILJMPKO.js";
 export {
   useCell,
   useDatabase,

package/dist/{experimental-DyPoZcJT.d.ts → experimental-Dv0MIlsc.d.ts}

@@ -1100,7 +1100,7 @@ declare function useSyncManager(): SyncManager | null;
  *   welcome → import-identity → qr-scan/recovery-phrase → connecting-hub
  */
 
-type OnboardingState = 'welcome' | 'authenticating' | 'auth-error' | 'unsupported-browser' | 'import-identity' | 'qr-scan' | 'recovery-phrase' | 'guardian-recovery' | 'creating-recoverable' | 'show-recovery-phrase' | 'connecting-hub' | 'ready' | 'complete';
+type OnboardingState = 'welcome' | 'authenticating' | 'auth-error' | 'unsupported-browser' | 'import-identity' | 'qr-scan' | 'recovery-phrase' | 'guardian-recovery' | 'atproto-ceremony' | 'creating-recoverable' | 'show-recovery-phrase' | 'connecting-hub' | 'ready' | 'complete';
 type OnboardingEvent = {
     type: 'AUTHENTICATE';
 } | {
@@ -1157,6 +1157,16 @@ type OnboardingEvent = {
     phrase: string;
 } | {
     type: 'PHRASE_SAVED';
+} | {
+    type: 'CONTINUE_WITH_ATPROTO';
+} | {
+    type: 'ATPROTO_LINKED';
+    atprotoDid: string;
+    atprotoHandle: string;
+    displayName?: string;
+} | {
+    type: 'ATPROTO_CEREMONY_FAILED';
+    error: Error;
 };
 type OnboardingMachineContext = {
     identity: Identity | null;
@@ -1166,6 +1176,11 @@ type OnboardingMachineContext = {
     isDemo: boolean;
     /** The recovery phrase to show once, after creating a recoverable identity (0243). */
     recoveryPhrase: string | null;
+    /** Linked ATProto identity from the login-door ceremony (0322/0338), if any. */
+    atprotoDid: string | null;
+    atprotoHandle: string | null;
+    /** Display name pulled from the ATProto profile, to pre-fill the xNet profile. */
+    atprotoDisplayName: string | null;
 };
 type OnboardingReducerState = {
     state: OnboardingState;
@@ -1174,6 +1189,39 @@ type OnboardingReducerState = {
 declare function onboardingReducer(current: OnboardingReducerState, event: OnboardingEvent): OnboardingReducerState;
 declare function createInitialState(hubUrl?: string): OnboardingReducerState;
 
+/**
+ * @xnetjs/react/onboarding - ATProto login-door ceremony contract (0322/0338).
+ *
+ * The actual OAuth 2.1 / PKCE / DPoP dance lives in `@atproto/oauth-client-*`,
+ * which is heavy and browser/redirect-bound. To keep `@xnetjs/react`
+ * dependency-light and unit-testable, the ceremony is *injected*: the host app
+ * (apps/web, apps/electron) provides a `runAtprotoCeremony` that resolves to
+ * the linked identity, and — after the xNet passkey identity is created — a
+ * `writeBinding` that puts the signed `net.x.identity.binding` record into the
+ * user's repo. The onboarding machine wires the two around the existing
+ * passkey-create step.
+ */
+interface AtprotoCeremonyResult {
+    /** The proven ATProto DID (`did:plc:…` / `did:web:…`). */
+    atprotoDid: string;
+    /** The handle the user authenticated with (e.g. `alice.bsky.social`). */
+    atprotoHandle: string;
+    /** Optional display name pulled from the ATProto profile, to pre-fill xNet. */
+    displayName?: string;
+    /**
+     * Finish the binding once the xNet identity exists: sign
+     * `net.x.identity.binding` with the new xNet key and `putRecord` it. Called
+     * with the freshly created xNet DID + signing key. Optional — a login-only
+     * flow may skip writing the binding record.
+     */
+    writeBinding?: (xnetDid: string, signingKey: Uint8Array) => Promise<void>;
+}
+/** Start the ATProto OAuth ceremony for a handle/PDS the user typed. */
+type RunAtprotoCeremony = (input: {
+    /** Handle or PDS host the user entered, e.g. `alice.bsky.social`. */
+    handleOrPds: string;
+}) => Promise<AtprotoCeremonyResult>;
+
 /**
  * @xnetjs/react/onboarding - React context provider for the onboarding flow
  */
@@ -1182,6 +1230,14 @@ type OnboardingContextValue = {
     state: OnboardingState;
     context: OnboardingMachineContext;
     send: (event: OnboardingEvent) => void;
+    /** Whether the ATProto login door is available (host supplied a ceremony). */
+    atprotoEnabled: boolean;
+    /**
+     * Run the ATProto login door for a typed handle/PDS (0322/0338): OAuth
+     * ceremony → existing passkey-create → write the binding record. No-op when
+     * the ceremony was not provided.
+     */
+    startAtprotoCeremony: (handleOrPds: string) => void;
 };
 type OnboardingProviderProps = {
     children: ReactNode;
@@ -1189,8 +1245,14 @@ type OnboardingProviderProps = {
     defaultHubUrl?: string;
     /** Called when onboarding completes */
     onComplete?: (identity: Identity, keyBundle: KeyBundle) => void;
+    /**
+     * ATProto login-door ceremony (0322/0338). When provided, the "Continue with
+     * Bluesky (or any PDS)" door is offered; the host app supplies the OAuth
+     * implementation. When omitted, the door is hidden.
+     */
+    runAtprotoCeremony?: RunAtprotoCeremony;
 };
-declare function OnboardingProvider({ children, defaultHubUrl, onComplete }: OnboardingProviderProps): JSX.Element;
+declare function OnboardingProvider({ children, defaultHubUrl, onComplete, runAtprotoCeremony }: OnboardingProviderProps): JSX.Element;
 /**
  * Access the onboarding state machine from within an OnboardingProvider.
  */
@@ -1619,4 +1681,4 @@ declare function useView(type: string): ViewContribution | undefined;
  */
 declare function useCommand(id: string): CommandContribution | undefined;
 
-export { summarizeReactionNode as $, type AddCommentOptions as A, selectPublicInteractionMode as B, type CommentThread as C, summarizeModerationLabel as D, summarizePublicInteractionPolicy as E, type CommentVisibility as F, type FirstContactMode as G, type ModeratedCommentThread as H, type InteractionPermission as I, type ModerationFilterOptions as J, type ModerationLabelSummary as K, type PublicInteractionMode as L, type ModeratedCommentNode as M, type PublicInteractionPolicySnapshot as N, type PublicInteractionSurface as O, type PageTaskInput as P, type PublicModerationMode as Q, type ReplyContext as R, type UseModeratedThreadOptions as S, type TaskProjectionInput as T, type UseTaskProjectionSyncResult as U, type UseVisibleCommentsOptions as V, type UseVisibleCommentsResult as W, usePolicyFilteredReactionCounters as X, createReactionCounterSnapshot as Y, dedupeReactions as Z, isReactionVisible as _, type TaskTreeItem as a, type RemoteSchemaDefinition as a$, type AddReactionOptions as a0, type ReactionCounterSnapshot as a1, type ReactionNode as a2, type ReactionType as a3, type UsePolicyFilteredReactionCountersOptions as a4, type UsePolicyFilteredReactionCountersResult as a5, useMessageRequests as a6, createConversationKey as a7, createMessageRequestProperties as a8, evaluateFirstContactDecision as a9, type UseBlameResult as aA, useVerification as aB, type UseVerificationResult as aC, useHubStatus as aD, useCan as aE, type UseCanResult as aF, useCanEdit as aG, type UseCanEditResult as aH, describeGrantConsent as aI, useGrants as aJ, type GrantConsentSummary as aK, type GrantInput as aL, type UseGrantsResult as aM, summarizeAuthTrace as aN, useAuthTrace as aO, type AuthTraceSummary as aP, type UseAuthTraceResult as aQ, useBackup as aR, type UseBackupReturn as aS, useFileUpload as aT, type FileRef as aU, type UseFileUploadReturn as aV, useHubSearch as aW, type HubSearchOptions as aX, type HubSearchResult as aY, type HubSearchState as aZ, useRemoteSchema as a_, findLatestMessageRequest as aa, hasAcceptedContact as ab, summarizeMessageRequest as ac, type CreateMessageRequestOptions as ad, type FirstContactAdmission as ae, type FirstContactDecision as af, type FirstContactDecisionInput as ag, type FirstContactVisibility as ah, type MessageRequestNode as ai, type MessageRequestProperties as aj, type MessageRequestStatus as ak, type UseMessageRequestsOptions as al, type UseMessageRequestsResult as am, useCommentCount as an, useCommentCounts as ao, useHistory as ap, type UseHistoryResult as aq, useUndo as ar, type UseUndoResult as as, type UseUndoOptions as at, useAudit as au, type UseAuditResult as av, type UseAuditOptions as aw, useDiff as ax, type UseDiffResult as ay, useBlame as az, type UseFindOptions as b, useViews as b$, type RemoteSchemaState as b0, usePeerDiscovery as b1, type DiscoveredPeer as b2, HubStatusIndicator as b3, Skeleton as b4, injectSkeletonStyles as b5, type SkeletonProps as b6, DemoBanner as b7, type DemoBannerProps as b8, DemoQuotaIndicator as b9, type OnboardingContextValue as bA, type OnboardingFlowProps as bB, type OnboardingState as bC, type OnboardingEvent as bD, type OnboardingMachineContext as bE, type OnboardingReducerState as bF, type QuickStartTemplate as bG, type SyncProgressOverlayProps as bH, PageTasksPanel as bI, type PageTasksPanelProps as bJ, TaskCollectionEmbed as bK, type TaskCollectionEmbedProps as bL, SecurityProvider as bM, useSecurityContext as bN, useSecurityContextOptional as bO, type SecurityContextState as bP, type SecurityContextActions as bQ, type SecurityContextValue as bR, type SecurityProviderProps as bS, useSecurity as bT, type UseSecurityOptions as bU, type UseSecurityResult as bV, PluginRegistryContext as bW, usePluginRegistry as bX, usePluginRegistryOptional as bY, usePlugins as bZ, useContributions as b_, type DemoQuotaIndicatorProps as ba, DemoDataExpiredScreen as bb, useDemoMode as bc, type DemoModeState as bd, type DemoLimits as be, type DemoUsage as bf, useSyncManager as bg, OnboardingProvider as bh, useOnboarding as bi, OnboardingFlow as bj, WelcomeScreen as bk, AuthenticatingScreen as bl, AuthErrorScreen as bm, UnsupportedBrowserScreen as bn, ImportIdentityScreen as bo, HubConnectScreen as bp, ReadyScreen as bq, SmartWelcome as br, SyncProgressOverlay as bs, onboardingReducer as bt, createInitialState as bu, QUICK_START_TEMPLATES as bv, getPlatformAuthName as bw, truncateDid as bx, copyToClipboard as by, type OnboardingProviderProps as bz, type UseFindResult as c, useCommands as c0, useSlashCommands as c1, useSidebarItems as c2, useImporters as c3, useEditorExtensions as c4, useEditorExtensionsSafe as c5, useMergedEditorContributions as c6, mergeEditorContributions as c7, type MergedEditorContributions as c8, useView as c9, useCommand as ca, usePageTaskSync as d, type PageTaskReferenceInput as e, type UsePageTaskSyncOptions as f, type UsePageTaskSyncResult as g, useTaskProjectionSync as h, type TaskProjectionReferenceInput as i, type TaskProjectionHost as j, type UseTaskProjectionSyncOptions as k, useTasks as l, type UseTasksOptions as m, type UseTasksResult as n, useComments as o, type UseCommentsOptions as p, type UseCommentsResult as q, type CommentNode as r, useVisibleComments as s, useModeratedThread as t, useFind as u, createModerationLabelIndex as v, evaluateCommentModeration as w, evaluateInteractionPermission as x, moderateThread as y, selectActiveInteractionPolicy as z };
+export { summarizeReactionNode as $, type AddCommentOptions as A, selectPublicInteractionMode as B, type CommentThread as C, summarizeModerationLabel as D, summarizePublicInteractionPolicy as E, type CommentVisibility as F, type FirstContactMode as G, type ModeratedCommentThread as H, type InteractionPermission as I, type ModerationFilterOptions as J, type ModerationLabelSummary as K, type PublicInteractionMode as L, type ModeratedCommentNode as M, type PublicInteractionPolicySnapshot as N, type PublicInteractionSurface as O, type PageTaskInput as P, type PublicModerationMode as Q, type ReplyContext as R, type UseModeratedThreadOptions as S, type TaskProjectionInput as T, type UseTaskProjectionSyncResult as U, type UseVisibleCommentsOptions as V, type UseVisibleCommentsResult as W, usePolicyFilteredReactionCounters as X, createReactionCounterSnapshot as Y, dedupeReactions as Z, isReactionVisible as _, type TaskTreeItem as a, type RemoteSchemaDefinition as a$, type AddReactionOptions as a0, type ReactionCounterSnapshot as a1, type ReactionNode as a2, type ReactionType as a3, type UsePolicyFilteredReactionCountersOptions as a4, type UsePolicyFilteredReactionCountersResult as a5, useMessageRequests as a6, createConversationKey as a7, createMessageRequestProperties as a8, evaluateFirstContactDecision as a9, type UseBlameResult as aA, useVerification as aB, type UseVerificationResult as aC, useHubStatus as aD, useCan as aE, type UseCanResult as aF, useCanEdit as aG, type UseCanEditResult as aH, describeGrantConsent as aI, useGrants as aJ, type GrantConsentSummary as aK, type GrantInput as aL, type UseGrantsResult as aM, summarizeAuthTrace as aN, useAuthTrace as aO, type AuthTraceSummary as aP, type UseAuthTraceResult as aQ, useBackup as aR, type UseBackupReturn as aS, useFileUpload as aT, type FileRef as aU, type UseFileUploadReturn as aV, useHubSearch as aW, type HubSearchOptions as aX, type HubSearchResult as aY, type HubSearchState as aZ, useRemoteSchema as a_, findLatestMessageRequest as aa, hasAcceptedContact as ab, summarizeMessageRequest as ac, type CreateMessageRequestOptions as ad, type FirstContactAdmission as ae, type FirstContactDecision as af, type FirstContactDecisionInput as ag, type FirstContactVisibility as ah, type MessageRequestNode as ai, type MessageRequestProperties as aj, type MessageRequestStatus as ak, type UseMessageRequestsOptions as al, type UseMessageRequestsResult as am, useCommentCount as an, useCommentCounts as ao, useHistory as ap, type UseHistoryResult as aq, useUndo as ar, type UseUndoResult as as, type UseUndoOptions as at, useAudit as au, type UseAuditResult as av, type UseAuditOptions as aw, useDiff as ax, type UseDiffResult as ay, useBlame as az, type UseFindOptions as b, usePlugins as b$, type RemoteSchemaState as b0, usePeerDiscovery as b1, type DiscoveredPeer as b2, HubStatusIndicator as b3, Skeleton as b4, injectSkeletonStyles as b5, type SkeletonProps as b6, DemoBanner as b7, type DemoBannerProps as b8, DemoQuotaIndicator as b9, type OnboardingContextValue as bA, type OnboardingFlowProps as bB, type OnboardingState as bC, type OnboardingEvent as bD, type OnboardingMachineContext as bE, type OnboardingReducerState as bF, type QuickStartTemplate as bG, type SyncProgressOverlayProps as bH, type RunAtprotoCeremony as bI, type AtprotoCeremonyResult as bJ, PageTasksPanel as bK, type PageTasksPanelProps as bL, TaskCollectionEmbed as bM, type TaskCollectionEmbedProps as bN, SecurityProvider as bO, useSecurityContext as bP, useSecurityContextOptional as bQ, type SecurityContextState as bR, type SecurityContextActions as bS, type SecurityContextValue as bT, type SecurityProviderProps as bU, useSecurity as bV, type UseSecurityOptions as bW, type UseSecurityResult as bX, PluginRegistryContext as bY, usePluginRegistry as bZ, usePluginRegistryOptional as b_, type DemoQuotaIndicatorProps as ba, DemoDataExpiredScreen as bb, useDemoMode as bc, type DemoModeState as bd, type DemoLimits as be, type DemoUsage as bf, useSyncManager as bg, OnboardingProvider as bh, useOnboarding as bi, OnboardingFlow as bj, WelcomeScreen as bk, AuthenticatingScreen as bl, AuthErrorScreen as bm, UnsupportedBrowserScreen as bn, ImportIdentityScreen as bo, HubConnectScreen as bp, ReadyScreen as bq, SmartWelcome as br, SyncProgressOverlay as bs, onboardingReducer as bt, createInitialState as bu, QUICK_START_TEMPLATES as bv, getPlatformAuthName as bw, truncateDid as bx, copyToClipboard as by, type OnboardingProviderProps as bz, type UseFindResult as c, useContributions as c0, useViews as c1, useCommands as c2, useSlashCommands as c3, useSidebarItems as c4, useImporters as c5, useEditorExtensions as c6, useEditorExtensionsSafe as c7, useMergedEditorContributions as c8, mergeEditorContributions as c9, type MergedEditorContributions as ca, useView as cb, useCommand as cc, usePageTaskSync as d, type PageTaskReferenceInput as e, type UsePageTaskSyncOptions as f, type UsePageTaskSyncResult as g, useTaskProjectionSync as h, type TaskProjectionReferenceInput as i, type TaskProjectionHost as j, type UseTaskProjectionSyncOptions as k, useTasks as l, type UseTasksOptions as m, type UseTasksResult as n, useComments as o, type UseCommentsOptions as p, type UseCommentsResult as q, type CommentNode as r, useVisibleComments as s, useModeratedThread as t, useFind as u, createModerationLabelIndex as v, evaluateCommentModeration as w, evaluateInteractionPermission as x, moderateThread as y, selectActiveInteractionPolicy as z };

package/dist/experimental.d.ts

@@ -1,4 +1,4 @@
-export { A as AddCommentOptions, a0 as AddReactionOptions, bm as AuthErrorScreen, aP as AuthTraceSummary, bl as AuthenticatingScreen, r as CommentNode, C as CommentThread, F as CommentVisibility, ad as CreateMessageRequestOptions, b7 as DemoBanner, b8 as DemoBannerProps, bb as DemoDataExpiredScreen, be as DemoLimits, bd as DemoModeState, b9 as DemoQuotaIndicator, ba as DemoQuotaIndicatorProps, bf as DemoUsage, b2 as DiscoveredPeer, aU as FileRef, ae as FirstContactAdmission, af as FirstContactDecision, ag as FirstContactDecisionInput, G as FirstContactMode, ah as FirstContactVisibility, aK as GrantConsentSummary, aL as GrantInput, bp as HubConnectScreen, aX as HubSearchOptions, aY as HubSearchResult, aZ as HubSearchState, b3 as HubStatusIndicator, bo as ImportIdentityScreen, I as InteractionPermission, c8 as MergedEditorContributions, ai as MessageRequestNode, aj as MessageRequestProperties, ak as MessageRequestStatus, M as ModeratedCommentNode, H as ModeratedCommentThread, J as ModerationFilterOptions, K as ModerationLabelSummary, bA as OnboardingContextValue, bD as OnboardingEvent, bj as OnboardingFlow, bB as OnboardingFlowProps, bE as OnboardingMachineContext, bh as OnboardingProvider, bz as OnboardingProviderProps, bF as OnboardingReducerState, bC as OnboardingState, P as PageTaskInput, e as PageTaskReferenceInput, bI as PageTasksPanel, bJ as PageTasksPanelProps, bW as PluginRegistryContext, L as PublicInteractionMode, N as PublicInteractionPolicySnapshot, O as PublicInteractionSurface, Q as PublicModerationMode, bv as QUICK_START_TEMPLATES, bG as QuickStartTemplate, a1 as ReactionCounterSnapshot, a2 as ReactionNode, a3 as ReactionType, bq as ReadyScreen, a$ as RemoteSchemaDefinition, b0 as RemoteSchemaState, R as ReplyContext, bQ as SecurityContextActions, bP as SecurityContextState, bR as SecurityContextValue, bM as SecurityProvider, bS as SecurityProviderProps, b4 as Skeleton, b6 as SkeletonProps, br as SmartWelcome, bs as SyncProgressOverlay, bH as SyncProgressOverlayProps, bK as TaskCollectionEmbed, bL as TaskCollectionEmbedProps, a as TaskTreeItem, bn as UnsupportedBrowserScreen, aw as UseAuditOptions, av as UseAuditResult, aQ as UseAuthTraceResult, aS as UseBackupReturn, aA as UseBlameResult, aH as UseCanEditResult, aF as UseCanResult, p as UseCommentsOptions, q as UseCommentsResult, ay as UseDiffResult, aV as UseFileUploadReturn, b as UseFindOptions, c as UseFindResult, aM as UseGrantsResult, aq as UseHistoryResult, al as UseMessageRequestsOptions, am as UseMessageRequestsResult, S as UseModeratedThreadOptions, f as UsePageTaskSyncOptions, g as UsePageTaskSyncResult, a4 as UsePolicyFilteredReactionCountersOptions, a5 as UsePolicyFilteredReactionCountersResult, bU as UseSecurityOptions, bV as UseSecurityResult, m as UseTasksOptions, n as UseTasksResult, at as UseUndoOptions, as as UseUndoResult, aC as UseVerificationResult, V as UseVisibleCommentsOptions, W as UseVisibleCommentsResult, bk as WelcomeScreen, by as copyToClipboard, a7 as createConversationKey, bu as createInitialState, a8 as createMessageRequestProperties, v as createModerationLabelIndex, Y as createReactionCounterSnapshot, Z as dedupeReactions, aI as describeGrantConsent, w as evaluateCommentModeration, a9 as evaluateFirstContactDecision, x as evaluateInteractionPermission, aa as findLatestMessageRequest, bw as getPlatformAuthName, ab as hasAcceptedContact, b5 as injectSkeletonStyles, _ as isReactionVisible, c7 as mergeEditorContributions, y as moderateThread, bt as onboardingReducer, z as selectActiveInteractionPolicy, B as selectPublicInteractionMode, aN as summarizeAuthTrace, ac as summarizeMessageRequest, D as summarizeModerationLabel, E as summarizePublicInteractionPolicy, $ as summarizeReactionNode, bx as truncateDid, au as useAudit, aO as useAuthTrace, aR as useBackup, az as useBlame, aE as useCan, aG as useCanEdit, ca as useCommand, c0 as useCommands, an as useCommentCount, ao as useCommentCounts, o as useComments, b_ as useContributions, bc as useDemoMode, ax as useDiff, c4 as useEditorExtensions, c5 as useEditorExtensionsSafe, aT as useFileUpload, u as useFind, aJ as useGrants, ap as useHistory, aW as useHubSearch, aD as useHubStatus, c6 as useMergedEditorContributions, a6 as useMessageRequests, t as useModeratedThread, bi as useOnboarding, d as usePageTaskSync, b1 as usePeerDiscovery, bX as usePluginRegistry, bY as usePluginRegistryOptional, bZ as usePlugins, X as usePolicyFilteredReactionCounters, a_ as useRemoteSchema, bT as useSecurity, bN as useSecurityContext, bO as useSecurityContextOptional, c2 as useSidebarItems, c1 as useSlashCommands, bg as useSyncManager, l as useTasks, ar as useUndo, aB as useVerification, c9 as useView, b$ as useViews, s as useVisibleComments } from './experimental-DyPoZcJT.js';
+export { A as AddCommentOptions, a0 as AddReactionOptions, bm as AuthErrorScreen, aP as AuthTraceSummary, bl as AuthenticatingScreen, r as CommentNode, C as CommentThread, F as CommentVisibility, ad as CreateMessageRequestOptions, b7 as DemoBanner, b8 as DemoBannerProps, bb as DemoDataExpiredScreen, be as DemoLimits, bd as DemoModeState, b9 as DemoQuotaIndicator, ba as DemoQuotaIndicatorProps, bf as DemoUsage, b2 as DiscoveredPeer, aU as FileRef, ae as FirstContactAdmission, af as FirstContactDecision, ag as FirstContactDecisionInput, G as FirstContactMode, ah as FirstContactVisibility, aK as GrantConsentSummary, aL as GrantInput, bp as HubConnectScreen, aX as HubSearchOptions, aY as HubSearchResult, aZ as HubSearchState, b3 as HubStatusIndicator, bo as ImportIdentityScreen, I as InteractionPermission, ca as MergedEditorContributions, ai as MessageRequestNode, aj as MessageRequestProperties, ak as MessageRequestStatus, M as ModeratedCommentNode, H as ModeratedCommentThread, J as ModerationFilterOptions, K as ModerationLabelSummary, bA as OnboardingContextValue, bD as OnboardingEvent, bj as OnboardingFlow, bB as OnboardingFlowProps, bE as OnboardingMachineContext, bh as OnboardingProvider, bz as OnboardingProviderProps, bF as OnboardingReducerState, bC as OnboardingState, P as PageTaskInput, e as PageTaskReferenceInput, bK as PageTasksPanel, bL as PageTasksPanelProps, bY as PluginRegistryContext, L as PublicInteractionMode, N as PublicInteractionPolicySnapshot, O as PublicInteractionSurface, Q as PublicModerationMode, bv as QUICK_START_TEMPLATES, bG as QuickStartTemplate, a1 as ReactionCounterSnapshot, a2 as ReactionNode, a3 as ReactionType, bq as ReadyScreen, a$ as RemoteSchemaDefinition, b0 as RemoteSchemaState, R as ReplyContext, bS as SecurityContextActions, bR as SecurityContextState, bT as SecurityContextValue, bO as SecurityProvider, bU as SecurityProviderProps, b4 as Skeleton, b6 as SkeletonProps, br as SmartWelcome, bs as SyncProgressOverlay, bH as SyncProgressOverlayProps, bM as TaskCollectionEmbed, bN as TaskCollectionEmbedProps, a as TaskTreeItem, bn as UnsupportedBrowserScreen, aw as UseAuditOptions, av as UseAuditResult, aQ as UseAuthTraceResult, aS as UseBackupReturn, aA as UseBlameResult, aH as UseCanEditResult, aF as UseCanResult, p as UseCommentsOptions, q as UseCommentsResult, ay as UseDiffResult, aV as UseFileUploadReturn, b as UseFindOptions, c as UseFindResult, aM as UseGrantsResult, aq as UseHistoryResult, al as UseMessageRequestsOptions, am as UseMessageRequestsResult, S as UseModeratedThreadOptions, f as UsePageTaskSyncOptions, g as UsePageTaskSyncResult, a4 as UsePolicyFilteredReactionCountersOptions, a5 as UsePolicyFilteredReactionCountersResult, bW as UseSecurityOptions, bX as UseSecurityResult, m as UseTasksOptions, n as UseTasksResult, at as UseUndoOptions, as as UseUndoResult, aC as UseVerificationResult, V as UseVisibleCommentsOptions, W as UseVisibleCommentsResult, bk as WelcomeScreen, by as copyToClipboard, a7 as createConversationKey, bu as createInitialState, a8 as createMessageRequestProperties, v as createModerationLabelIndex, Y as createReactionCounterSnapshot, Z as dedupeReactions, aI as describeGrantConsent, w as evaluateCommentModeration, a9 as evaluateFirstContactDecision, x as evaluateInteractionPermission, aa as findLatestMessageRequest, bw as getPlatformAuthName, ab as hasAcceptedContact, b5 as injectSkeletonStyles, _ as isReactionVisible, c9 as mergeEditorContributions, y as moderateThread, bt as onboardingReducer, z as selectActiveInteractionPolicy, B as selectPublicInteractionMode, aN as summarizeAuthTrace, ac as summarizeMessageRequest, D as summarizeModerationLabel, E as summarizePublicInteractionPolicy, $ as summarizeReactionNode, bx as truncateDid, au as useAudit, aO as useAuthTrace, aR as useBackup, az as useBlame, aE as useCan, aG as useCanEdit, cc as useCommand, c2 as useCommands, an as useCommentCount, ao as useCommentCounts, o as useComments, c0 as useContributions, bc as useDemoMode, ax as useDiff, c6 as useEditorExtensions, c7 as useEditorExtensionsSafe, aT as useFileUpload, u as useFind, aJ as useGrants, ap as useHistory, aW as useHubSearch, aD as useHubStatus, c8 as useMergedEditorContributions, a6 as useMessageRequests, t as useModeratedThread, bi as useOnboarding, d as usePageTaskSync, b1 as usePeerDiscovery, bZ as usePluginRegistry, b_ as usePluginRegistryOptional, b$ as usePlugins, X as usePolicyFilteredReactionCounters, a_ as useRemoteSchema, bV as useSecurity, bP as useSecurityContext, bQ as useSecurityContextOptional, c4 as useSidebarItems, c3 as useSlashCommands, bg as useSyncManager, l as useTasks, ar as useUndo, aB as useVerification, cb as useView, c1 as useViews, s as useVisibleComments } from './experimental-Dv0MIlsc.js';
 export { i as FlattenNodeOptions, f as flattenNode, e as flattenNodes, h as flattenNodesWithSchemaCheck, g as flattenUnknownSchemaNode } from './useQuery-D7ajycrc.js';
 export { BlobStoreForSync, ConnectionManager, ConnectionManagerConfig, ConnectionStatus, InitialSyncManager, InitialSyncMessage, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, MetaBridge, NodePool, NodePoolConfig, NodeStoreSyncProvider, NodeSyncResponse, OfflineQueue, OfflineQueueConfig, PoolEntryState, ProgressListener, QueueEntry, Registry, RegistryConfig, RegistryStorage, SerializedNodeChange, SyncLifecyclePhase, SyncLifecycleState, SyncManager, SyncManagerConfig, SyncStatus as SyncManagerStatus, SyncPhase, SyncProgress, TrackedNode, WebSocketSyncProvider, WebSocketSyncProviderOptions, createConnectionManager, createInitialSyncManager, createMetaBridge, createNodePool, createOfflineQueue, createRegistry, createSyncManager } from '@xnetjs/runtime';
 export { I as InstrumentationContext, a as InstrumentationContextValue, Q as QueryTrackerLike, Y as YDocRegistryLike, u as useInstrumentation } from './instrumentation-CpIuG2y5.js';

package/dist/experimental.js

@@ -73,14 +73,14 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-ANCTAEML.js";
+} from "./chunk-CZUUWSJ7.js";
 import {
   flattenNode,
   flattenNodes,
   flattenNodesWithSchemaCheck,
   flattenUnknownSchemaNode,
   useSyncManager
-} from "./chunk-ZGP56IIJ.js";
+} from "./chunk-RW3DSDKO.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -106,7 +106,7 @@ import {
   useTelemetryReporter,
   useView,
   useViews
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/experimental.ts
 import { WebSocketSyncProvider } from "@xnetjs/runtime";

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { Q as QueryFilter, a as QueryStatus, F as FlatNode, b as QueryPlanSummary } from './useQuery-D7ajycrc.js';
 export { i as FlattenNodeOptions, M as MigrationWarning, c as QueryListResult, d as QuerySingleResult, S as SortDirection, f as flattenNode, e as flattenNodes, h as flattenNodesWithSchemaCheck, g as flattenUnknownSchemaNode, u as useQuery } from './useQuery-D7ajycrc.js';
 export { ErrorBoundary, ErrorBoundaryProps, InfiniteQueryFilter, InfiniteQueryPage, InfiniteQueryResult, MutateCreate, MutateDelete, MutateOp, MutateRestore, MutateUpdate, OfflineIndicator, OfflineIndicatorProps, PresenceUser, SyncStatus, UseIdentityResult, UseMutateResult, UseNodeOptions, UseNodeResult, useIdentity, useInfiniteQuery, useIsOffline, useMutate, useNode } from './core.js';
-import { U as UseTaskProjectionSyncResult, T as TaskProjectionInput, a as TaskTreeItem } from './experimental-DyPoZcJT.js';
-export { A as AddCommentOptions, a0 as AddReactionOptions, bm as AuthErrorScreen, aP as AuthTraceSummary, bl as AuthenticatingScreen, r as CommentNode, C as CommentThread, F as CommentVisibility, ad as CreateMessageRequestOptions, b7 as DemoBanner, b8 as DemoBannerProps, bb as DemoDataExpiredScreen, be as DemoLimits, bd as DemoModeState, b9 as DemoQuotaIndicator, ba as DemoQuotaIndicatorProps, bf as DemoUsage, b2 as DiscoveredPeer, aU as FileRef, ae as FirstContactAdmission, af as FirstContactDecision, ag as FirstContactDecisionInput, G as FirstContactMode, ah as FirstContactVisibility, aK as GrantConsentSummary, aL as GrantInput, bp as HubConnectScreen, aX as HubSearchOptions, aY as HubSearchResult, aZ as HubSearchState, b3 as HubStatusIndicator, bo as ImportIdentityScreen, I as InteractionPermission, c8 as MergedEditorContributions, ai as MessageRequestNode, aj as MessageRequestProperties, ak as MessageRequestStatus, M as ModeratedCommentNode, H as ModeratedCommentThread, J as ModerationFilterOptions, K as ModerationLabelSummary, bA as OnboardingContextValue, bD as OnboardingEvent, bj as OnboardingFlow, bB as OnboardingFlowProps, bE as OnboardingMachineContext, bh as OnboardingProvider, bz as OnboardingProviderProps, bF as OnboardingReducerState, bC as OnboardingState, P as PageTaskInput, e as PageTaskReferenceInput, bI as PageTasksPanel, bJ as PageTasksPanelProps, bW as PluginRegistryContext, L as PublicInteractionMode, N as PublicInteractionPolicySnapshot, O as PublicInteractionSurface, Q as PublicModerationMode, bv as QUICK_START_TEMPLATES, bG as QuickStartTemplate, a1 as ReactionCounterSnapshot, a2 as ReactionNode, a3 as ReactionType, bq as ReadyScreen, a$ as RemoteSchemaDefinition, b0 as RemoteSchemaState, R as ReplyContext, bQ as SecurityContextActions, bP as SecurityContextState, bR as SecurityContextValue, bM as SecurityProvider, bS as SecurityProviderProps, b4 as Skeleton, b6 as SkeletonProps, br as SmartWelcome, bs as SyncProgressOverlay, bH as SyncProgressOverlayProps, bK as TaskCollectionEmbed, bL as TaskCollectionEmbedProps, j as TaskProjectionHost, i as TaskProjectionReferenceInput, bn as UnsupportedBrowserScreen, aw as UseAuditOptions, av as UseAuditResult, aQ as UseAuthTraceResult, aS as UseBackupReturn, aA as UseBlameResult, aH as UseCanEditResult, aF as UseCanResult, p as UseCommentsOptions, q as UseCommentsResult, ay as UseDiffResult, aV as UseFileUploadReturn, b as UseFindOptions, c as UseFindResult, aM as UseGrantsResult, aq as UseHistoryResult, al as UseMessageRequestsOptions, am as UseMessageRequestsResult, S as UseModeratedThreadOptions, f as UsePageTaskSyncOptions, g as UsePageTaskSyncResult, a4 as UsePolicyFilteredReactionCountersOptions, a5 as UsePolicyFilteredReactionCountersResult, bU as UseSecurityOptions, bV as UseSecurityResult, k as UseTaskProjectionSyncOptions, m as UseTasksOptions, n as UseTasksResult, at as UseUndoOptions, as as UseUndoResult, aC as UseVerificationResult, V as UseVisibleCommentsOptions, W as UseVisibleCommentsResult, bk as WelcomeScreen, by as copyToClipboard, a7 as createConversationKey, bu as createInitialState, a8 as createMessageRequestProperties, v as createModerationLabelIndex, Y as createReactionCounterSnapshot, Z as dedupeReactions, aI as describeGrantConsent, w as evaluateCommentModeration, a9 as evaluateFirstContactDecision, x as evaluateInteractionPermission, aa as findLatestMessageRequest, bw as getPlatformAuthName, ab as hasAcceptedContact, b5 as injectSkeletonStyles, _ as isReactionVisible, c7 as mergeEditorContributions, y as moderateThread, bt as onboardingReducer, z as selectActiveInteractionPolicy, B as selectPublicInteractionMode, aN as summarizeAuthTrace, ac as summarizeMessageRequest, D as summarizeModerationLabel, E as summarizePublicInteractionPolicy, $ as summarizeReactionNode, bx as truncateDid, au as useAudit, aO as useAuthTrace, aR as useBackup, az as useBlame, aE as useCan, aG as useCanEdit, ca as useCommand, c0 as useCommands, an as useCommentCount, ao as useCommentCounts, o as useComments, b_ as useContributions, bc as useDemoMode, ax as useDiff, c4 as useEditorExtensions, c5 as useEditorExtensionsSafe, aT as useFileUpload, u as useFind, aJ as useGrants, ap as useHistory, aW as useHubSearch, aD as useHubStatus, c3 as useImporters, c6 as useMergedEditorContributions, a6 as useMessageRequests, t as useModeratedThread, bi as useOnboarding, d as usePageTaskSync, b1 as usePeerDiscovery, bX as usePluginRegistry, bY as usePluginRegistryOptional, bZ as usePlugins, X as usePolicyFilteredReactionCounters, a_ as useRemoteSchema, bT as useSecurity, bN as useSecurityContext, bO as useSecurityContextOptional, c2 as useSidebarItems, c1 as useSlashCommands, bg as useSyncManager, h as useTaskProjectionSync, l as useTasks, ar as useUndo, aB as useVerification, c9 as useView, b$ as useViews, s as useVisibleComments } from './experimental-DyPoZcJT.js';
-import { SchemaIRI, Schema, SavedViewDescriptor, DefinedSchema, PropertyBuilder, QueryASTOrderBy, QueryASTPage, QueryASTValidationResult, QueryASTPlannerGate, QueryASTAggregateExecution, ExternalReferenceProvider, SavedViewFeedLayout, SavedViewFeedDensity, FieldType, FieldConfig, ViewType, FilterGroup, SortConfig, RowHeight, SummaryFunction, FormViewConfig, FormFieldRule, CellValue, FormSubmissionMeta, NodeId, NodeState } from '@xnetjs/data';
+import { U as UseTaskProjectionSyncResult, T as TaskProjectionInput, a as TaskTreeItem } from './experimental-Dv0MIlsc.js';
+export { A as AddCommentOptions, a0 as AddReactionOptions, bJ as AtprotoCeremonyResult, bm as AuthErrorScreen, aP as AuthTraceSummary, bl as AuthenticatingScreen, r as CommentNode, C as CommentThread, F as CommentVisibility, ad as CreateMessageRequestOptions, b7 as DemoBanner, b8 as DemoBannerProps, bb as DemoDataExpiredScreen, be as DemoLimits, bd as DemoModeState, b9 as DemoQuotaIndicator, ba as DemoQuotaIndicatorProps, bf as DemoUsage, b2 as DiscoveredPeer, aU as FileRef, ae as FirstContactAdmission, af as FirstContactDecision, ag as FirstContactDecisionInput, G as FirstContactMode, ah as FirstContactVisibility, aK as GrantConsentSummary, aL as GrantInput, bp as HubConnectScreen, aX as HubSearchOptions, aY as HubSearchResult, aZ as HubSearchState, b3 as HubStatusIndicator, bo as ImportIdentityScreen, I as InteractionPermission, ca as MergedEditorContributions, ai as MessageRequestNode, aj as MessageRequestProperties, ak as MessageRequestStatus, M as ModeratedCommentNode, H as ModeratedCommentThread, J as ModerationFilterOptions, K as ModerationLabelSummary, bA as OnboardingContextValue, bD as OnboardingEvent, bj as OnboardingFlow, bB as OnboardingFlowProps, bE as OnboardingMachineContext, bh as OnboardingProvider, bz as OnboardingProviderProps, bF as OnboardingReducerState, bC as OnboardingState, P as PageTaskInput, e as PageTaskReferenceInput, bK as PageTasksPanel, bL as PageTasksPanelProps, bY as PluginRegistryContext, L as PublicInteractionMode, N as PublicInteractionPolicySnapshot, O as PublicInteractionSurface, Q as PublicModerationMode, bv as QUICK_START_TEMPLATES, bG as QuickStartTemplate, a1 as ReactionCounterSnapshot, a2 as ReactionNode, a3 as ReactionType, bq as ReadyScreen, a$ as RemoteSchemaDefinition, b0 as RemoteSchemaState, R as ReplyContext, bI as RunAtprotoCeremony, bS as SecurityContextActions, bR as SecurityContextState, bT as SecurityContextValue, bO as SecurityProvider, bU as SecurityProviderProps, b4 as Skeleton, b6 as SkeletonProps, br as SmartWelcome, bs as SyncProgressOverlay, bH as SyncProgressOverlayProps, bM as TaskCollectionEmbed, bN as TaskCollectionEmbedProps, j as TaskProjectionHost, i as TaskProjectionReferenceInput, bn as UnsupportedBrowserScreen, aw as UseAuditOptions, av as UseAuditResult, aQ as UseAuthTraceResult, aS as UseBackupReturn, aA as UseBlameResult, aH as UseCanEditResult, aF as UseCanResult, p as UseCommentsOptions, q as UseCommentsResult, ay as UseDiffResult, aV as UseFileUploadReturn, b as UseFindOptions, c as UseFindResult, aM as UseGrantsResult, aq as UseHistoryResult, al as UseMessageRequestsOptions, am as UseMessageRequestsResult, S as UseModeratedThreadOptions, f as UsePageTaskSyncOptions, g as UsePageTaskSyncResult, a4 as UsePolicyFilteredReactionCountersOptions, a5 as UsePolicyFilteredReactionCountersResult, bW as UseSecurityOptions, bX as UseSecurityResult, k as UseTaskProjectionSyncOptions, m as UseTasksOptions, n as UseTasksResult, at as UseUndoOptions, as as UseUndoResult, aC as UseVerificationResult, V as UseVisibleCommentsOptions, W as UseVisibleCommentsResult, bk as WelcomeScreen, by as copyToClipboard, a7 as createConversationKey, bu as createInitialState, a8 as createMessageRequestProperties, v as createModerationLabelIndex, Y as createReactionCounterSnapshot, Z as dedupeReactions, aI as describeGrantConsent, w as evaluateCommentModeration, a9 as evaluateFirstContactDecision, x as evaluateInteractionPermission, aa as findLatestMessageRequest, bw as getPlatformAuthName, ab as hasAcceptedContact, b5 as injectSkeletonStyles, _ as isReactionVisible, c9 as mergeEditorContributions, y as moderateThread, bt as onboardingReducer, z as selectActiveInteractionPolicy, B as selectPublicInteractionMode, aN as summarizeAuthTrace, ac as summarizeMessageRequest, D as summarizeModerationLabel, E as summarizePublicInteractionPolicy, $ as summarizeReactionNode, bx as truncateDid, au as useAudit, aO as useAuthTrace, aR as useBackup, az as useBlame, aE as useCan, aG as useCanEdit, cc as useCommand, c2 as useCommands, an as useCommentCount, ao as useCommentCounts, o as useComments, c0 as useContributions, bc as useDemoMode, ax as useDiff, c6 as useEditorExtensions, c7 as useEditorExtensionsSafe, aT as useFileUpload, u as useFind, aJ as useGrants, ap as useHistory, aW as useHubSearch, aD as useHubStatus, c5 as useImporters, c8 as useMergedEditorContributions, a6 as useMessageRequests, t as useModeratedThread, bi as useOnboarding, d as usePageTaskSync, b1 as usePeerDiscovery, bZ as usePluginRegistry, b_ as usePluginRegistryOptional, b$ as usePlugins, X as usePolicyFilteredReactionCounters, a_ as useRemoteSchema, bV as useSecurity, bP as useSecurityContext, bQ as useSecurityContextOptional, c4 as useSidebarItems, c3 as useSlashCommands, bg as useSyncManager, h as useTaskProjectionSync, l as useTasks, ar as useUndo, aB as useVerification, cb as useView, c1 as useViews, s as useVisibleComments } from './experimental-Dv0MIlsc.js';
+import { SchemaIRI, Schema, SavedViewDescriptor, DefinedSchema, PropertyBuilder, QueryASTOrderBy, QueryASTPage, QueryASTValidationResult, QueryASTPlannerGate, QueryASTAggregateExecution, ExternalReferenceProvider, SavedViewFeedLayout, SavedViewFeedDensity, FieldType, FieldConfig, ViewType, FilterGroup, SortConfig, RowHeight, SummaryFunction, FormViewConfig, FormFieldRule, ViewGroupMeta, MapViewport, CellValue, FormSubmissionMeta, NodeId, NodeState } from '@xnetjs/data';
 export { ColumnConfig, ColumnDefinition, ColumnType, SavedViewFeedDensity, SavedViewFeedLayout, ViewConfig, ViewType } from '@xnetjs/data';
-import { QueryExecutionMode, QuerySourcePreference, QuerySearchFilter, QueryPageInfo, QueryMetadata } from '@xnetjs/data-bridge';
+import { QueryExecutionMode, QuerySourcePreference, QuerySearchFilter, QueryPageInfo, QueryMetadata, QuerySpatialFilter } from '@xnetjs/data-bridge';
 import { LucideIcon } from 'lucide-react';
 import { ReactNode, JSX } from 'react';
 export { DatabaseRow, DatabaseRowData, ReverseRelation, UseCellOptions, UseCellResult, UseDatabaseDocResult, UseDatabaseOptions, UseDatabaseResult, UseDatabaseRowResult, UseDatabaseSchemaResult, UseRelatedRowsResult, UseReverseRelationsResult, useCell, useDatabase, useDatabaseDoc, useDatabaseRow, useDatabaseSchema, useRelatedRows, useReverseRelations } from './database.js';
@@ -563,6 +563,35 @@ interface GridViewModel {
     formConfig: FormViewConfig | null;
     formRules: Record<string, FormFieldRule>;
     formAccepting: boolean;
+    coverField: string | null;
+    cardSize: string | null;
+    coverFit: string | null;
+    colorBy: string | null;
+    groupMeta: Record<string, ViewGroupMeta>;
+    dateField: string | null;
+    endDateField: string | null;
+    latField: string | null;
+    lngField: string | null;
+    mapViewport: MapViewport | null;
+}
+/**
+ * The per-view presentation config a view component may patch through
+ * `setViewConfig` (exploration 0339). One node write per patch — each
+ * property merges independently (LWW) with other clients' edits.
+ */
+interface GridViewConfigPatch {
+    groupBy?: string | null;
+    collapsedGroups?: string[];
+    coverField?: string | null;
+    cardSize?: string | null;
+    coverFit?: string | null;
+    colorBy?: string | null;
+    groupMeta?: Record<string, ViewGroupMeta>;
+    dateField?: string | null;
+    endDateField?: string | null;
+    latField?: string | null;
+    lngField?: string | null;
+    mapViewport?: MapViewport | null;
 }
 interface GridRowModel {
     id: string;
@@ -590,6 +619,12 @@ interface UseGridDatabaseOptions {
      * bounded (exploration 0340).
      */
     maxLoaded?: number;
+    /**
+     * Spatial window over two cell properties (map views, exploration
+     * 0339): only rows inside the rect are fetched. Bypasses the
+     * materialized-view cache (the rect varies per pan).
+     */
+    spatial?: QuerySpatialFilter;
 }
 interface UseGridDatabaseResult {
     /** Database node (flattened) */
@@ -607,6 +642,15 @@ interface UseGridDatabaseResult {
     activeView: GridViewModel | null;
     /** Rows: view filters + sorts applied to the fetched window */
     rows: GridRowModel[];
+    /**
+     * The fetch window (exploration 0339): `size` is the row cap, `total`
+     * the full match count when the bridge reports one. Views use this to
+     * label truncation honestly instead of silently clipping.
+     */
+    rowWindow: {
+        size: number;
+        total: number | null;
+    };
     loading: boolean;
     /** Exact matching row count for the whole database (null while unknown). */
     totalRowCount: number | null;
@@ -617,6 +661,14 @@ interface UseGridDatabaseResult {
     /** Grow the row window by `pageSize` (bounded by `maxLoaded`). */
     fetchMoreRows: () => Promise<void>;
     updateCell: (rowId: string, fieldId: string, value: CellValue) => Promise<void>;
+    /**
+     * Write several cells (and optionally the row's sortKey) as ONE node
+     * update — a kanban card move is exactly one write carrying the group
+     * cell + the fractional position (exploration 0339).
+     */
+    updateRowCells: (rowId: string, cells: Record<string, CellValue>, opts?: {
+        sortKey?: string;
+    }) => Promise<void>;
     clearCells: (cells: Array<{
         rowId: string;
         fieldId: string;
@@ -639,6 +691,10 @@ interface UseGridDatabaseResult {
     toggleSort: (fieldId: string) => Promise<void>;
     setFilters: (filters: FilterGroup | null) => Promise<void>;
     setGroupBy: (fieldId: string | null) => Promise<void>;
+    /** Patch the active view's presentation config (exploration 0339) */
+    setViewConfig: (patch: GridViewConfigPatch) => Promise<void>;
+    /** Persist a group's collapsed state on the active view */
+    setGroupCollapsed: (groupKey: string, collapsed: boolean) => Promise<void>;
     setRowHeight: (rowHeight: RowHeight) => Promise<void>;
     setColumnSummary: (fieldId: string, fn: SummaryFunction) => Promise<void>;
     setFormConfig: (config: FormViewConfig) => Promise<void>;
@@ -933,4 +989,4 @@ declare function flattenTaskTree(items: TaskTreeItem[], depth?: number): Rendera
 declare function formatTaskDueDate(timestamp: number | undefined): string | null;
 declare function isTaskOverdue(timestamp: number | undefined, completed: boolean): boolean;
 
-export { type AddRowOptions, type CanvasTaskInput, type CheckoutOptions, type DraftReview, type DraftReviewCard, type DraftReviewMember, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewModel, type PresenceAwareness, type PresencePeer, QueryFilter, type RenderableTaskRow, type SavedViewCanvasProjectionNode, type SavedViewDateBrushSelection, type SavedViewDateBucketFieldSummary, type SavedViewDateBucketInterval, type SavedViewDateBucketSummary, type SavedViewFacetSelection, type SavedViewFacetSummary, type SavedViewFacetValueSummary, type SavedViewFeedEnrichmentAdapter, type SavedViewFeedEnrichmentEntry, type SavedViewInspectorItem, type SavedViewInspectorItemKind, type SavedViewLensDraft, type SavedViewPresentationMode, type SavedViewPrivacyChip, type SavedViewPrivacyChipTone, type SavedViewPrivacySummary, type SavedViewQueryOverride, type SavedViewQueryResult, SavedViewResultTable, type SavedViewResultTableProps, type SavedViewRowInspectorModel, SavedViewRunner, type SavedViewRunnerProps, type SavedViewSchemaRegistry, type SavedViewSortDirection, type SavedViewVisualCanvasProjectionRequest, SavedViewVisualFeed, type SavedViewVisualLayoutId, type SavedViewVisualLayoutOption, type SavedViewVisualPreviewCreator, type SavedViewVisualPreviewKind, type SavedViewVisualPreviewModel, type SavedViewVisualPreviewPrivacy, type SavedViewVisualPreviewRelationship, type SavedViewVisualTimelineBucket, type SavedViewVisualWorkspaceLayout, TaskProjectionInput, TaskTreeItem, type UseBillingResult, type UseCanCreateResult, type UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseDraftResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UsePresenceOptions, type UsePresenceResult, type UseSavedViewOptions, type UseSavedViewResult, UseTaskProjectionSyncResult, type UseTimeMachineOptions, type UseTimeMachineResult, createSavedViewCanvasProjectionNodes, createSavedViewLensDraft, createSavedViewVisualCanvasProjectionRequest, createSavedViewVisualPreviewFingerprint, deriveCachedSavedViewVisualPreviews, deriveSavedViewColumns, deriveSavedViewDateBucketSummaries, deriveSavedViewFacetSummaries, deriveSavedViewPrivacyChips, deriveSavedViewRowInspector, deriveSavedViewTimelineBuckets, deriveSavedViewVisualPreview, deriveSavedViewVisualPreviews, filterSavedViewRowsByDateBrush, filterSavedViewRowsByFacets, flattenTaskTree, formatSavedViewCellValue, formatTaskDueDate, getSavedViewSensitiveResultWarning, hasSavedViewVisualPreviewSensitiveData, isSavedViewVisualPreviewEmbeddable, isTaskOverdue, mergeSavedViewFeedEnrichment, savedViewVisualPreviewIsSelfActor, useBilling, useCanCreate, useCanvasTaskSync, useDraft, useEffectiveSchema, useGlobalUndo, useGridDatabase, usePresence, useSavedView, useTimeMachine };
+export { type AddRowOptions, type CanvasTaskInput, type CheckoutOptions, type DraftReview, type DraftReviewCard, type DraftReviewMember, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewConfigPatch, type GridViewModel, type PresenceAwareness, type PresencePeer, QueryFilter, type RenderableTaskRow, type SavedViewCanvasProjectionNode, type SavedViewDateBrushSelection, type SavedViewDateBucketFieldSummary, type SavedViewDateBucketInterval, type SavedViewDateBucketSummary, type SavedViewFacetSelection, type SavedViewFacetSummary, type SavedViewFacetValueSummary, type SavedViewFeedEnrichmentAdapter, type SavedViewFeedEnrichmentEntry, type SavedViewInspectorItem, type SavedViewInspectorItemKind, type SavedViewLensDraft, type SavedViewPresentationMode, type SavedViewPrivacyChip, type SavedViewPrivacyChipTone, type SavedViewPrivacySummary, type SavedViewQueryOverride, type SavedViewQueryResult, SavedViewResultTable, type SavedViewResultTableProps, type SavedViewRowInspectorModel, SavedViewRunner, type SavedViewRunnerProps, type SavedViewSchemaRegistry, type SavedViewSortDirection, type SavedViewVisualCanvasProjectionRequest, SavedViewVisualFeed, type SavedViewVisualLayoutId, type SavedViewVisualLayoutOption, type SavedViewVisualPreviewCreator, type SavedViewVisualPreviewKind, type SavedViewVisualPreviewModel, type SavedViewVisualPreviewPrivacy, type SavedViewVisualPreviewRelationship, type SavedViewVisualTimelineBucket, type SavedViewVisualWorkspaceLayout, TaskProjectionInput, TaskTreeItem, type UseBillingResult, type UseCanCreateResult, type UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseDraftResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UsePresenceOptions, type UsePresenceResult, type UseSavedViewOptions, type UseSavedViewResult, UseTaskProjectionSyncResult, type UseTimeMachineOptions, type UseTimeMachineResult, createSavedViewCanvasProjectionNodes, createSavedViewLensDraft, createSavedViewVisualCanvasProjectionRequest, createSavedViewVisualPreviewFingerprint, deriveCachedSavedViewVisualPreviews, deriveSavedViewColumns, deriveSavedViewDateBucketSummaries, deriveSavedViewFacetSummaries, deriveSavedViewPrivacyChips, deriveSavedViewRowInspector, deriveSavedViewTimelineBuckets, deriveSavedViewVisualPreview, deriveSavedViewVisualPreviews, filterSavedViewRowsByDateBrush, filterSavedViewRowsByFacets, flattenTaskTree, formatSavedViewCellValue, formatTaskDueDate, getSavedViewSensitiveResultWarning, hasSavedViewVisualPreviewSensitiveData, isSavedViewVisualPreviewEmbeddable, isTaskOverdue, mergeSavedViewFeedEnrichment, savedViewVisualPreviewIsSelfActor, useBilling, useCanCreate, useCanvasTaskSync, useDraft, useEffectiveSchema, useGlobalUndo, useGridDatabase, usePresence, useSavedView, useTimeMachine };

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   useInfiniteQuery,
   useIsOffline,
   useNode
-} from "./chunk-VZMZQTR7.js";
+} from "./chunk-UVJJN33U.js";
 import {
   useCell,
   useDatabase,
@@ -14,7 +14,7 @@ import {
   useDatabaseSchema,
   useRelatedRows,
   useReverseRelations
-} from "./chunk-HTFAHJQK.js";
+} from "./chunk-QSJJNEFY.js";
 import {
   AuthErrorScreen,
   AuthenticatingScreen,
@@ -94,7 +94,7 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-ANCTAEML.js";
+} from "./chunk-CZUUWSJ7.js";
 import {
   EMPTY_PAGE_INFO,
   computeFallbackPageInfo,
@@ -106,10 +106,10 @@ import {
   useMutate,
   useQuery,
   useSyncManager
-} from "./chunk-ZGP56IIJ.js";
+} from "./chunk-RW3DSDKO.js";
 import {
   useUndoScope
-} from "./chunk-SZQNGRTO.js";
+} from "./chunk-KK6VADMZ.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -144,7 +144,7 @@ import {
   useView,
   useViews,
   useXNet
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 
 // src/hooks/useEffectiveSchema.ts
 import {
@@ -4355,7 +4355,17 @@ function toViewModel(node) {
     sortKey: node.sortKey ?? "",
     formConfig: node.formConfig ?? null,
     formRules: node.formRules ?? {},
-    formAccepting: node.formAccepting ?? true
+    formAccepting: node.formAccepting ?? true,
+    coverField: node.coverField ?? null,
+    cardSize: node.cardSize ?? null,
+    coverFit: node.coverFit ?? null,
+    colorBy: node.colorBy ?? null,
+    groupMeta: node.groupMeta ?? {},
+    dateField: node.dateField ?? null,
+    endDateField: node.endDateField ?? null,
+    latField: node.latField ?? null,
+    lngField: node.lngField ?? null,
+    mapViewport: node.mapViewport ?? null
   };
 }
 function fieldsToColumnDefinitions(fields) {
@@ -4377,21 +4387,21 @@ function dropSortKey(ordered, movedId, targetIndex) {
 }
 var formulaService = new FormulaService();
 function useGridDatabase(databaseId, options = {}) {
-  const { viewId, search, pageSize = 500, maxLoaded = 2e3 } = options;
+  const { viewId, search, pageSize = 500, maxLoaded = 2e3, spatial } = options;
   const mutate = useMutate();
   const { did } = useIdentity();
   const { data: database, status: dbStatus } = useQuery(DatabaseSchema, databaseId);
   const { data: fieldNodes, status: fieldStatus } = useQuery(DatabaseFieldSchema, {
     where: { database: databaseId },
-    orderBy: { sortKey: "asc" }
+    orderBy: { createdAt: "asc" }
   });
   const { data: viewNodes, status: viewStatus } = useQuery(DatabaseViewSchema, {
     where: { database: databaseId },
-    orderBy: { sortKey: "asc" }
+    orderBy: { createdAt: "asc" }
   });
   const { data: optionNodes } = useQuery(DatabaseSelectOptionSchema, {
     where: { database: databaseId },
-    orderBy: { sortKey: "asc" }
+    orderBy: { createdAt: "asc" }
   });
   const {
     data: rowNodes,
@@ -4409,7 +4419,7 @@ function useGridDatabase(databaseId, options = {}) {
     pageSize,
     maxLoaded,
     page: { count: "exact" },
-    materializedView: `db:${databaseId}${viewId ? `:view:${viewId}` : ""}`,
+    ...spatial ? { spatial } : { materializedView: `db:${databaseId}${viewId ? `:view:${viewId}` : ""}` },
     ...search ? { search } : {}
   });
   const optionsByField = useMemo5(() => {
@@ -4630,6 +4640,17 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [updateRowProps]
   );
+  const updateRowCells = useCallback3(
+    async (rowId, cells, opts) => {
+      const props = {};
+      for (const [fieldId, value] of Object.entries(cells)) {
+        props[cellKey(fieldId)] = value;
+      }
+      if (opts?.sortKey !== void 0) props.sortKey = opts.sortKey;
+      await updateRowProps(rowId, props);
+    },
+    [updateRowProps]
+  );
   const clearCells = useCallback3(
     async (cells) => {
       const byRow = /* @__PURE__ */ new Map();
@@ -4848,6 +4869,28 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
+  const setViewConfig = useCallback3(
+    async (patch) => {
+      if (!activeView) return;
+      const props = {};
+      for (const [key, value] of Object.entries(patch)) {
+        if (value !== void 0) props[key] = value;
+      }
+      if (Object.keys(props).length === 0) return;
+      await mutate.update(DatabaseViewSchema, activeView.id, props);
+    },
+    [mutate, activeView]
+  );
+  const setGroupCollapsed = useCallback3(
+    async (groupKey, collapsed) => {
+      if (!activeView) return;
+      const set = new Set(activeView.collapsedGroups);
+      if (collapsed) set.add(groupKey);
+      else set.delete(groupKey);
+      await mutate.update(DatabaseViewSchema, activeView.id, { collapsedGroups: [...set] });
+    },
+    [mutate, activeView]
+  );
   const setRowHeight = useCallback3(
     async (rowHeight) => {
       if (!activeView) return;
@@ -4917,12 +4960,14 @@ function useGridDatabase(databaseId, options = {}) {
     views,
     activeView,
     rows,
+    rowWindow: { size: (rowNodes ?? []).length, total: totalRowCount ?? null },
     loading,
     totalRowCount,
     hasMoreRows,
     isFetchingMoreRows,
     fetchMoreRows,
     updateCell,
+    updateRowCells,
     clearCells,
     addRow,
     deleteRows,
@@ -4939,6 +4984,8 @@ function useGridDatabase(databaseId, options = {}) {
     toggleSort,
     setFilters,
     setGroupBy,
+    setViewConfig,
+    setGroupCollapsed,
     setRowHeight,
     setColumnSummary,
     setFormConfig,

package/dist/internal.js

@@ -1,6 +1,6 @@
 import {
   useUndoScope
-} from "./chunk-SZQNGRTO.js";
+} from "./chunk-KK6VADMZ.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -10,7 +10,7 @@ import {
   useNodeStore,
   useXNet,
   useXNetInternal
-} from "./chunk-H44ZSIH4.js";
+} from "./chunk-5ILJMPKO.js";
 export {
   InstrumentationContext,
   useDataBridge,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/react",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -46,15 +46,15 @@
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
     "@xnetjs/billing": "0.0.2",
-    "@xnetjs/core": "2.1.0",
-    "@xnetjs/crypto": "2.1.0",
-    "@xnetjs/data": "2.1.0",
-    "@xnetjs/data-bridge": "2.1.0",
-    "@xnetjs/history": "2.1.0",
-    "@xnetjs/identity": "2.1.0",
-    "@xnetjs/plugins": "2.1.0",
-    "@xnetjs/runtime": "0.5.1",
-    "@xnetjs/sync": "2.1.0"
+    "@xnetjs/core": "2.3.0",
+    "@xnetjs/crypto": "2.3.0",
+    "@xnetjs/data": "2.3.0",
+    "@xnetjs/data-bridge": "2.3.0",
+    "@xnetjs/history": "2.3.0",
+    "@xnetjs/identity": "2.3.0",
+    "@xnetjs/plugins": "2.3.0",
+    "@xnetjs/runtime": "0.5.3",
+    "@xnetjs/sync": "2.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"