@xnetjs/react 0.12.0 → 2.0.0

package/dist/index.d.ts

@@ -1,15 +1,17 @@
 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-B2FrBnkV.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, 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, 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, c7 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, 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, c6 as useView, b$ as useViews, s as useVisibleComments } from './experimental-B2FrBnkV.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 } from '@xnetjs/data';
+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';
 export { ColumnConfig, ColumnDefinition, ColumnType, SavedViewFeedDensity, SavedViewFeedLayout, ViewConfig, ViewType } from '@xnetjs/data';
 import { QueryExecutionMode, QuerySourcePreference, QuerySearchFilter, QueryPageInfo, QueryMetadata } 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';
 export { u as useNodeStore } from './useNodeStore-DTCSBF51.js';
+import { ScopeTimelineEntry, PropertyDiff, HistoryHorizon, Frontier, RestoreResult, MergeDraftResult, RefreshDraftResult } from '@xnetjs/history';
+export { DraftMergeConflict, Frontier, FrontierEntry, HistoryHorizon, MergeDraftResult, PropertyDiff, RefreshDraftResult, RestoreResult, ScopeTimelineEntry } from '@xnetjs/history';
 export { BlobStoreForSync, ConnectionManager, ConnectionManagerConfig, ConnectionStatus, InitialSyncManager, InitialSyncMessage, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, MetaBridge, MultiHubConnectionManagerConfig, NodePool, NodePoolConfig, NodeStoreSyncProvider, NodeSyncResponse, OfflineQueue, OfflineQueueConfig, PoolEntryState, ProgressListener, QueueEntry, Registry, RegistryConfig, RegistryStorage, SerializedNodeChange, SyncManager, SyncManagerConfig, SyncStatus as SyncManagerStatus, SyncPhase, SyncProgress, SyncReconciliationOptions, SyncReconciliationReport, TrackedNode, WebSocketSyncProvider, WebSocketSyncProviderOptions, channelShareRoom, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager, workspaceShareRoom } from '@xnetjs/runtime';
 import { Subscription, Customer, Invoice, Payment } from '@xnetjs/billing';
 export { n as TRACE_STAGES, s as TracingAttributes, T as TracingContext, p as TracingHandle, o as TracingReporter, r as TracingRootKind, q as TracingSpanInput, f as XNetConfig, X as XNetContextValue, e as XNetProvider, g as XNetProviderProps, h as XNetRuntimeConfig, i as XNetRuntimeFallback, j as XNetRuntimeMode, k as XNetRuntimePhase, d as XNetRuntimeStatus, l as XNetRuntimeWorkerConfig, u as useDataBridge, m as useTracingReporter, a as useXNet } from './context-aeFzX2eW.js';
@@ -19,7 +21,6 @@ import '@xnetjs/core';
 import 'y-protocols/awareness';
 import 'yjs';
 import '@xnetjs/identity';
-import '@xnetjs/history';
 import 'react/jsx-runtime';
 import '@xnetjs/crypto';
 import '@xnetjs/plugins';
@@ -457,6 +458,45 @@ declare function createSavedViewVisualCanvasProjectionRequest(input: {
 }): SavedViewVisualCanvasProjectionRequest;
 declare function SavedViewResultTable({ query, columns, expandedRowId, onToggleRow, loadingLabel, emptyLabel, formatValue }: SavedViewResultTableProps): JSX.Element;
 
+/**
+ * Minimal Awareness surface (compatible with y-protocols/awareness).
+ * Duck-typed so tests and non-Yjs transports can provide their own.
+ */
+interface PresenceAwareness {
+    clientID: number;
+    getLocalState(): Record<string, unknown> | null;
+    setLocalState(state: Record<string, unknown> | null): void;
+    getStates(): Map<number, Record<string, unknown>>;
+    on(event: 'change', handler: () => void): void;
+    off(event: 'change', handler: () => void): void;
+}
+interface PresencePeer<T> {
+    /** Awareness client id (one per connected tab/device). */
+    clientId: number;
+    /** That peer's presence state. */
+    state: T;
+}
+interface UsePresenceOptions {
+    /**
+     * Minimum ms between broadcasts (default 33 ≈ 30fps). The hub rate-limits
+     * at 100 messages/sec/connection and closes the socket on repeated
+     * breaches — do not go below ~16ms.
+     */
+    throttleMs?: number;
+}
+interface UsePresenceResult<T> {
+    /** Remote peers only (local client excluded). Evicted on disconnect. */
+    peers: Array<PresencePeer<T>>;
+    /**
+     * Merge a partial patch into local presence. Patches within one throttle
+     * window coalesce into a single broadcast (leading + trailing edge).
+     */
+    setState: (patch: Partial<T>) => void;
+    /** Local awareness client id, or null before awareness attaches. */
+    clientId: number | null;
+}
+declare function usePresence<T extends Record<string, unknown>>(awareness: PresenceAwareness | null | undefined, initialState: T, options?: UsePresenceOptions): UsePresenceResult<T>;
+
 /**
  * useCanvasTaskSync - Reconcile canvas checklist items with Task nodes.
  *
@@ -599,6 +639,166 @@ interface UseGridDatabaseResult {
 }
 declare function useGridDatabase(databaseId: string, options?: UseGridDatabaseOptions): UseGridDatabaseResult;
 
+/**
+ * useTimeMachine — React binding for the Time Machine (exploration 0329 P1).
+ *
+ * Wraps the history engine's scrub stack (`ScopeTimeline` merged Lamport line,
+ * hash-anchored `Frontier` positions, named `Checkpoint` nodes, the prune
+ * horizon) into one hook a scrubber UI can bind to:
+ *
+ * - `timeline` is the merged, Lamport-ordered change line for the scope (the
+ *   node itself by default; pass `memberIds` to widen to a database's rows…).
+ * - `position` glides along that line (`setPosition`/`stepBack`/`stepForward`);
+ *   `preview` + `diffs` materialize the primary node there and compare it to
+ *   current state (before = at position, after = now).
+ * - `checkpoints` are named versions scoped to the node; `createNamedVersion`
+ *   captures-and-pins the current frontier (Google Docs' named versions).
+ * - `restore` applies one compensating transaction back to the scrubbed
+ *   frontier (new changes, no log rewriting — the restore is itself undoable).
+ * - `horizon` is non-null when older history was compacted on this device.
+ *
+ * @example
+ * ```tsx
+ * const tm = useTimeMachine(nodeId)
+ * <input type="range" max={tm.changeCount - 1} value={tm.position}
+ *        onChange={(e) => tm.setPosition(Number(e.target.value))} />
+ * ```
+ */
+
+interface UseTimeMachineOptions {
+    /**
+     * Scope membership beyond the node itself (e.g. a database's row ids).
+     * The primary node is always included.
+     */
+    memberIds?: readonly NodeId[];
+}
+interface UseTimeMachineResult {
+    /** Merged, Lamport-ordered change line for the scope. */
+    timeline: ScopeTimelineEntry[];
+    /** Total changes on the line. */
+    changeCount: number;
+    /** Current scrub index on the line (latest = changeCount - 1). */
+    position: number;
+    /** True when scrubbed to (following) the latest change. */
+    atLatest: boolean;
+    setPosition: (index: number) => void;
+    /** Step one change back / forward along the line. */
+    stepBack: () => void;
+    stepForward: () => void;
+    /** Jump back to (and follow) the latest change. */
+    goToLatest: () => void;
+    /** The primary node materialized at the scrub position. */
+    preview: NodeState | null;
+    /** Property diff position → current (what restore would change back). */
+    diffs: PropertyDiff[];
+    /** Non-null when older history was compacted on this device. */
+    horizon: HistoryHorizon | null;
+    /** Yjs document snapshots stored for the node; null when storage can't say. */
+    docSnapshotCount: number | null;
+    /** Named versions (Checkpoint nodes) scoped to this node, newest first. */
+    checkpoints: NodeState[];
+    /** Capture-and-pin the current frontier under a name. */
+    createNamedVersion: (name: string, note?: string) => Promise<NodeState | null>;
+    /** Timeline index a checkpoint pins the scope at, or null (below horizon). */
+    positionOfCheckpoint: (checkpoint: NodeState) => number | null;
+    /** The hash-anchored frontier at a timeline index. */
+    frontierAt: (index: number) => Frontier;
+    /** Restore the scope to the scrubbed frontier (one compensating batch). */
+    restore: () => Promise<RestoreResult | null>;
+    loading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+}
+declare function useTimeMachine(nodeId: NodeId | null, options?: UseTimeMachineOptions): UseTimeMachineResult;
+
+/**
+ * useDraft — React binding for drafts (exploration 0329 P2/P3).
+ *
+ * Given a host node id, wraps the draft engine (`@xnetjs/history` draft/merge
+ * modules) and the NodeStore checkout overlay into one hook the switcher and
+ * review surfaces bind to:
+ *
+ * - `drafts` lists open Draft nodes targeting the host, newest first.
+ * - `createDraft` opens an empty draft (Upwelling: a name that signals
+ *   intent); forking stays lazy — the first write through the overlay clones
+ *   the touched member (`onMissingMember` → `forkNodeIntoDraft`).
+ * - `checkout` installs the store overlay (content-swap reads, write
+ *   redirect); `returnToMain` clears it. The clones map is re-derived from
+ *   the draft's entries at checkout and kept fresh via
+ *   `subscribeToDraftOverlay` (the store self-updates it on lazy forks).
+ * - `merge` is the merger-signed three-way squash — it returns conflict
+ *   cards (applying nothing) when main and draft both changed a property.
+ * - `refresh` folds main's post-fork changes into the draft (floating
+ *   drafts); it pauses on the same conflict cards.
+ * - `computeReview` builds per-property review cards (base at fork vs main
+ *   now vs draft now) WITHOUT applying anything — the DraftReviewPanel's
+ *   data source.
+ *
+ * @example
+ * ```tsx
+ * const d = useDraft(nodeId)
+ * {d.checkedOut ? `Draft: ${d.checkedOut.properties.name}` : 'Main'}
+ * ```
+ */
+
+/** One reviewable property difference between main and the draft. */
+interface DraftReviewCard {
+    /** The original (main-side) node the property lives on. */
+    originalId: NodeId;
+    property: string;
+    /** Value at the fork point (the three-way merge base). */
+    base: unknown;
+    /** Main's value now. */
+    main: unknown;
+    /** The draft's value now. */
+    draft: unknown;
+    /** True when main and draft both changed the property differently. */
+    conflict: boolean;
+}
+/** One forked member's review summary. */
+interface DraftReviewMember {
+    originalId: NodeId;
+    cloneId: NodeId;
+    /** The member carries a Yjs document forked into the draft. */
+    hasDocument: boolean;
+    /**
+     * The member's document bytes differ between draft and main (no text diff
+     * yet — deferred; this powers the "document edited in draft" line).
+     */
+    documentDiffers: boolean;
+}
+/** Pending changes + conflicts for a draft, computed without applying. */
+interface DraftReview {
+    cards: DraftReviewCard[];
+    members: DraftReviewMember[];
+}
+interface UseDraftResult {
+    /** Open drafts targeting the host node, newest first. */
+    drafts: NodeState[];
+    /** The Draft node checked out for THIS host, or null (on main). */
+    checkedOut: NodeState | null;
+    /** Create (and check out) an open draft named for its intent. */
+    createDraft: (name: string) => Promise<NodeState | null>;
+    /** Install the checkout overlay for one of the host's drafts. */
+    checkout: (draftId: NodeId) => Promise<boolean>;
+    /** Clear the overlay — reads and writes hit main again. */
+    returnToMain: () => void;
+    /** Tombstone clones + release pins; checks out main first if needed. */
+    discard: (draftId: NodeId) => Promise<boolean>;
+    /** Merger-signed squash; `{status:'conflicts'}` applies nothing. */
+    merge: (draftId: NodeId) => Promise<MergeDraftResult | null>;
+    /** Fold main's post-fork changes into the draft (floating drafts). */
+    refresh: (draftId: NodeId) => Promise<RefreshDraftResult | null>;
+    /** P4: flag the draft for review in the Inbox/Requests surface. */
+    setReviewRequested: (draftId: NodeId, requested: boolean) => Promise<void>;
+    /** Per-property review cards + member doc indicators; applies nothing. */
+    computeReview: (draftId: NodeId) => Promise<DraftReview | null>;
+    loading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+}
+declare function useDraft(hostId: NodeId | null): UseDraftResult;
+
 /**
  * useGlobalUndo - app-wide Cmd+Z (exploration 0179)
  *
@@ -630,6 +830,31 @@ interface UseGlobalUndoResult {
 }
 declare function useGlobalUndo(): UseGlobalUndoResult;
 
+/**
+ * useCanCreate - Check whether the current user may create a node of a schema
+ * (exploration 0304).
+ *
+ * The check runs against a *draft* node built from `schemaId` + `properties`,
+ * so container relations in the draft (e.g. `space`, `channel`) resolve
+ * membership roles — pass the relation the composer is about to write into:
+ *
+ * ```tsx
+ * const { canCreate } = useCanCreate(CHAT_MESSAGE_SCHEMA_IRI, { channel: channelId })
+ * <SendButton disabled={!canCreate} />
+ * ```
+ *
+ * Schemas that declare no `create` expression fall back to their `write`
+ * policy, which includes the creator role in every preset — those schemas
+ * resolve to `canCreate: true`.
+ */
+
+type UseCanCreateResult = {
+    canCreate: boolean;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useCanCreate(schemaId: SchemaIRI, properties?: Record<string, unknown>): UseCanCreateResult;
+
 /**
  * useBilling — reactive billing state + checkout, the same shape as `useIdentity`.
  *
@@ -693,4 +918,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, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewModel, 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 UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UseSavedViewOptions, type UseSavedViewResult, UseTaskProjectionSyncResult, 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, useCanvasTaskSync, useEffectiveSchema, useGlobalUndo, useGridDatabase, useSavedView };
+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 };