react-native-layout-dnd 0.1.0-alpha.0

package/lib/typescript/src/components/dndTypes.d.ts

@@ -0,0 +1,94 @@
+import type { ReactNode, Ref } from 'react';
+import type { StyleProp, ViewProps, ViewStyle } from 'react-native';
+import type { AutoScrollOptions, DragAxis } from '../adapters/scroll.js';
+import type { ListVirtualizationOptions } from '../adapters/virtualizedList.js';
+import type { DndItem, GridPlacement } from '../contracts.js';
+import type { DndDragEndEvent, DndSessionOptions } from '../controller/dndSession.js';
+import type { HandleViewProps } from './handleViewProps.js';
+import type { GridMotionConfig } from '../pointer/motion.js';
+import type { GestureRelations, ZoneGeometry } from './gridTypes.js';
+export type DndMotionConfig = GridMotionConfig;
+export type ListItemRenderArgs<T> = {
+    item: DndItem<T>;
+    index: number;
+    zoneId: string;
+    isDragging: boolean;
+};
+export type GridItemRenderArgs<T> = ListItemRenderArgs<T> & {
+    position: GridPlacement['position'];
+    span: GridPlacement['span'];
+    placement?: GridPlacement['placement'];
+    width: number;
+    height: number;
+};
+/** Spatial grid under the shared provider; cells use the existing geometry contract. */
+export type SortableGridProps<T> = Omit<ViewProps, 'children'> & {
+    zoneId: string;
+    geometry: ZoneGeometry;
+    renderItem(args: GridItemRenderArgs<T>): ReactNode;
+    dropIndicatorStyle?: StyleProp<ViewStyle>;
+    children?: ReactNode;
+};
+export type DndPreviewArgs<T> = ListItemRenderArgs<T> & {
+    sessionId: string;
+    targetZoneId: string | null;
+    width: number;
+    height: number;
+    validity: 'pending' | 'valid' | 'invalid';
+    /** Call after the custom preview's drawable content has committed. Late sessions are ignored. */
+    onReady(): void;
+};
+export type DndProviderHandle = {
+    /** Cancel the current drag because zone geometry moved under it. */
+    invalidateGeometry(): void;
+};
+export type DndProviderProps<T> = Omit<ViewProps, 'children'> & DndSessionOptions<T> & {
+    children: ReactNode;
+    activation?: {
+        delayMs: number;
+    };
+    /** Independent of list orientation. Defaults to both screen axes. */
+    dragAxis?: DragAxis;
+    motion?: DndMotionConfig;
+    renderDragPreview?(args: DndPreviewArgs<T>): ReactNode;
+    /** Keep the original visible until the custom preview calls onReady. Defaults to false. */
+    waitForDragPreviewReady?: boolean;
+    dragPreviewStyle?: StyleProp<ViewStyle>;
+    /**
+     * The `onDragEnd` event again once the drag preview has finished settling
+     * into its cell, or right after `onDragEnd` when nothing animates.
+     * `GridController.onDragEnd` uses this timing.
+     */
+    onDragSettled?(event: DndDragEndEvent<T>): void;
+    ref?: Ref<DndProviderHandle>;
+};
+/** ScrollView by default; enable virtualization for FlatList. Sizes are logical pixels. */
+export type SortableListProps<T> = Omit<ViewProps, 'children'> & {
+    zoneId: string;
+    renderItem(args: ListItemRenderArgs<T>): ReactNode;
+    /** Main-axis estimate before a cell has been measured. Defaults to 48. */
+    estimatedItemSize?: number;
+    /** Optional authoritative main-axis size, constant or per item. */
+    itemSize?: number | ((itemId: string, index: number) => number);
+    gap?: number;
+    paddingStart?: number;
+    paddingEnd?: number;
+    autoScroll?: AutoScrollOptions;
+    scrollEnabled?: boolean;
+    showsScrollIndicator?: boolean;
+    onScrollOffsetChange?(offset: {
+        x: number;
+        y: number;
+    }): void;
+    /** Use FlatList windowing. True selects defaults; false is the default. */
+    virtualization?: boolean | ListVirtualizationOptions;
+};
+/** Accessibility and test attributes forwarded to the handle's native view. */
+export type DragHandleViewProps = HandleViewProps;
+export type DragHandleProps = DragHandleViewProps & {
+    children: ReactNode;
+    itemId?: string;
+    disabled?: boolean;
+    gestureRelations?: GestureRelations;
+};
+//# sourceMappingURL=dndTypes.d.ts.map

package/lib/typescript/src/components/dndTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dndTypes.d.ts","sourceRoot":"","sources":["../../../../src/components/dndTypes.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/gridTypes.d.ts

@@ -0,0 +1,84 @@
+import type { ReactNode, Ref } from 'react';
+import type { StyleProp, ViewProps, ViewStyle } from 'react-native';
+import type { PanGestureConfig } from 'react-native-gesture-handler';
+import type { GridMovementPolicy } from '../engine/movementPolicy.js';
+import type { HandleViewProps } from './handleViewProps.js';
+import type { GridMotionConfig } from '../pointer/motion.js';
+import type { CanDropArgs, DragEndEvent, DragStartEvent, DropDecision, GridChange, GridDiagnosticEvent, GridItem, GridValue, ValidationIssue } from '../types.js';
+export type GestureRelations = Pick<PanGestureConfig, 'block' | 'requireToFail' | 'simultaneousWith'>;
+export type GridInsets = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type ZoneGeometry = {
+    rowGap: number;
+    columnGap: number;
+    padding: GridInsets;
+} & ({
+    mode: 'fixed';
+    cellWidth: number;
+    cellHeight: number;
+} | {
+    mode: 'fit';
+});
+export type ItemRenderArgs<T> = {
+    item: GridItem<T>;
+    zoneId: string;
+    width: number;
+    height: number;
+    isDragging: boolean;
+};
+export type DragPreviewArgs<T> = Omit<ItemRenderArgs<T>, 'zoneId'> & {
+    sessionId: string;
+    /** Call after the custom preview's drawable content has committed. Late sessions are ignored. */
+    onReady(): void;
+    sourceZoneId: string;
+    targetZoneId: string | null;
+    validity: 'pending' | 'valid' | 'invalid';
+};
+export type GridControllerHandle = {
+    invalidateGeometry(): void;
+};
+export type GridControllerProps<T> = Omit<ViewProps, 'children'> & {
+    value: GridValue<T>;
+    onChange(nextValue: GridValue<T>, change: GridChange): void;
+    renderItem(args: ItemRenderArgs<T>): ReactNode;
+    renderDragPreview?(args: DragPreviewArgs<T>): ReactNode;
+    /** Keep the original visible until the custom preview calls onReady. Defaults to false. */
+    waitForDragPreviewReady?: boolean;
+    /** Optional preview surface styling (background, border, clipping, shadow). */
+    dragPreviewStyle?: StyleProp<ViewStyle>;
+    canDrop?(args: CanDropArgs<T>): DropDecision;
+    onDragStart?(event: DragStartEvent): void;
+    /** Fires once the drag preview has settled into its cell, or at once when nothing animates. */
+    onDragEnd?(event: DragEndEvent): void;
+    onValidationError?(issues: ValidationIssue[]): void;
+    /** Optional JS-only observation. Exceptions are ignored; omit to disable timing. */
+    onDiagnostic?(event: GridDiagnosticEvent): void;
+    /** Defaults to 10,000 bounded search steps. */
+    searchBudget?: number;
+    /** Defaults to a 250ms long press. */
+    activation?: {
+        delayMs: number;
+    };
+    /** Generic rules by default; opt into HOME_GRID_MOVEMENT_POLICY for home compatibility. */
+    movementPolicy?: GridMovementPolicy;
+    motion?: GridMotionConfig;
+    responseTimeoutMs?: number;
+    disabled?: boolean;
+    ref?: Ref<GridControllerHandle>;
+    children: ReactNode;
+};
+export type GridZoneViewProps = ViewProps & {
+    zoneId: string;
+    geometry: ZoneGeometry;
+};
+export type GridDragHandleProps = HandleViewProps & {
+    itemId: string;
+    gestureRelations?: GestureRelations;
+    disabled?: boolean;
+    children: ReactNode;
+};
+//# sourceMappingURL=gridTypes.d.ts.map

package/lib/typescript/src/components/gridTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridTypes.d.ts","sourceRoot":"","sources":["../../../../src/components/gridTypes.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/handleViewProps.d.ts

@@ -0,0 +1,6 @@
+import type { ViewProps } from 'react-native';
+/** Accessibility and test attributes forwarded to a handle's native view. */
+export type HandleViewProps = Pick<ViewProps, 'accessible' | 'accessibilityLabel' | 'accessibilityHint' | 'accessibilityRole' | 'accessibilityState' | 'accessibilityActions' | 'onAccessibilityAction' | 'importantForAccessibility' | 'testID'>;
+/** Copies only the defined view attributes so handle-specific props never reach the native view. */
+export declare function pickHandleViewProps(props: HandleViewProps): HandleViewProps;
+//# sourceMappingURL=handleViewProps.d.ts.map

package/lib/typescript/src/components/handleViewProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleViewProps.d.ts","sourceRoot":"","sources":["../../../../src/components/handleViewProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EACP,YAAY,GACZ,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,GAC3B,QAAQ,CACX,CAAC;AAcF,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAK3E"}

package/lib/typescript/src/contracts.d.ts

@@ -0,0 +1,145 @@
+import type { CellPosition, CellSpan, ItemPlacement, ValidationCode } from './types.js';
+export type ItemId = string;
+export type ZoneId = string;
+/** Application data has no layout meaning and remains owned by the caller. */
+export type DndItem<T> = {
+    id: ItemId;
+    data: T;
+};
+export type GridPlacement = {
+    itemId: ItemId;
+    position: CellPosition;
+    span: CellSpan;
+    placement?: ItemPlacement;
+};
+export type GridLayoutZone = {
+    id: ZoneId;
+    kind: 'grid';
+    rows: number;
+    columns: number;
+    placements: GridPlacement[];
+    /**
+     * Ordered packing (a dock, for example): every placement has this span,
+     * the array order is the item order and positions are the reading-order
+     * slots of that order. A move inserts at the slot the target addresses and
+     * re-packs; removing an item closes the gap; capacity is rows × columns
+     * in slots. Omitted for spatial grids.
+     */
+    itemSpan?: CellSpan;
+};
+/** A one-dimensional order, independent of item sizes and the drag axis. */
+export type ListLayoutZone = {
+    id: ZoneId;
+    kind: 'list';
+    orientation: 'vertical' | 'horizontal';
+    itemIds: ItemId[];
+};
+export type LayoutZone = GridLayoutZone | ListLayoutZone;
+/**
+ * Every item is referenced by exactly one zone. Revisions are nonnegative safe
+ * integers; the owner increments the revision for each accepted/external change.
+ * Shared by the list adapter and the grid conversion helpers.
+ */
+export type LayoutState<T> = {
+    revision: number;
+    items: DndItem<T>[];
+    zones: LayoutZone[];
+};
+export type GridLocation = {
+    kind: 'grid';
+    zoneId: ZoneId;
+    position: CellPosition;
+};
+export type ListLocation = {
+    kind: 'list';
+    zoneId: ZoneId;
+    index: number;
+};
+export type LayoutLocation = GridLocation | ListLocation;
+/** The completed candidate is approved atomically against baseRevision. */
+export type MoveProposal<State, Location = LayoutLocation> = {
+    sessionId: string;
+    itemId: ItemId;
+    baseRevision: number;
+    from: Location;
+    to: Location;
+    value: State;
+};
+/** A response applies only to the matching session AND base revision. */
+export type ProposalResponse = {
+    sessionId: string;
+    baseRevision: number;
+    accepted: boolean;
+};
+export type LayoutValidationCode = ValidationCode | 'invalid-revision' | 'unknown-item' | 'unplaced-item' | 'duplicate-reference' | 'invalid-orientation';
+export type LayoutValidationIssue = {
+    code: LayoutValidationCode;
+    zoneId?: ZoneId;
+    itemId?: ItemId;
+    message: string;
+};
+export type LayoutValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    issues: LayoutValidationIssue[];
+};
+export type LayoutConversionIssue = Omit<LayoutValidationIssue, 'code'> & {
+    code: LayoutValidationCode | 'unsupported-zone';
+};
+export type LayoutConversionResult<Value> = {
+    valid: true;
+    value: Value;
+} | {
+    valid: false;
+    issues: LayoutConversionIssue[];
+};
+/** Logical pixels in the coordinate space named by the containing contract. */
+export type LayoutPoint = {
+    x: number;
+    y: number;
+};
+export type LayoutRect = LayoutPoint & {
+    width: number;
+    height: number;
+};
+export type CoordinateSpace = 'screen' | 'content';
+type MeasurementBase<Space extends CoordinateSpace> = {
+    space: Space;
+    rect: LayoutRect;
+    revision: number;
+    /** Monotonic milliseconds in the same clock domain as MeasurementFreshness.nowMs. */
+    timestampMs: number;
+};
+export type MeasuredRect<Space extends CoordinateSpace = CoordinateSpace> = MeasurementBase<Space> & {
+    source: 'measured';
+};
+export type EstimatedRect<Space extends CoordinateSpace = CoordinateSpace> = MeasurementBase<Space> & {
+    source: 'estimated';
+};
+export type RectMeasurement<Space extends CoordinateSpace = CoordinateSpace> = MeasuredRect<Space> | EstimatedRect<Space>;
+export type MeasurementFreshness = {
+    revision: number;
+    /** Supply both nowMs and maxAgeMs to impose an age limit. */
+    nowMs?: number;
+    maxAgeMs?: number;
+};
+/**
+ * Viewport is the measured screen origin of content at scroll offset zero.
+ * Offset changes do not change layout revision. Negative offsets support bounce
+ * and insets. Padding is part of content coordinates, not another offset here.
+ */
+export type ZoneCoordinateContext = {
+    viewport: MeasuredRect<'screen'>;
+    scrollOffset: LayoutPoint;
+};
+export type CoordinateFailureReason = 'invalid-coordinate' | 'invalid-context' | 'invalid-measurement' | 'invalid-freshness' | 'stale-measurement';
+export type CoordinateResult<Value> = {
+    valid: true;
+    value: Value;
+} | {
+    valid: false;
+    reason: CoordinateFailureReason;
+};
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/lib/typescript/src/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/contracts.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/controller/approval.d.ts

@@ -0,0 +1,66 @@
+import type { MoveProposal, ProposalResponse } from '../contracts.js';
+/**
+ * Shared revisioned approval for both value shapes (`GridValue` and
+ * `LayoutState`). The adapter supplies the shape-specific checks; the order of
+ * checks, the stale rules and the response protocol are the same for both.
+ */
+export type ApprovalResult<Value, Issue> = {
+    status: 'accepted' | 'rejected' | 'stale';
+    value: Value;
+} | {
+    status: 'invalid';
+    value: Value;
+    issues: Issue[];
+};
+/** Legacy grid values may carry a response without a base revision. */
+type Revisioned = {
+    revision: number;
+    proposalResponse?: {
+        sessionId: string;
+        baseRevision?: number;
+        accepted: boolean;
+    };
+};
+export type ApprovalAdapter<Value extends Revisioned, Location, Issue> = {
+    /** Issues of the current value, or null when it is usable as a baseline. */
+    validateCurrent(current: Value): Issue[] | null;
+    /** Issues of the complete candidate, or null when it is valid. */
+    validateCandidate(candidate: Value): Issue[] | null;
+    issue(message: string): Issue;
+    isLocation(value: unknown): value is Location;
+    location(value: Value, itemId: string): Location | null;
+    sameLocation(first: Location, second: Location | null): boolean;
+    hasDestinationZone(value: Value, to: Location): boolean;
+    zonesPreserved(current: Value, candidate: Value): boolean;
+    itemsPreserved(current: Value, candidate: Value): boolean;
+    messages: {
+        zones: string;
+        items: string;
+        destination: string;
+    };
+    /** Attach the response (and any retained caller objects) to the candidate. */
+    accept(current: Value, candidate: Value, response: ProposalResponse): Value;
+};
+/** A response only changes the exact revision on which the complete proposal was based. */
+export declare function respondToProposal<Value extends Revisioned, Location, Issue>(adapter: ApprovalAdapter<Value, Location, Issue>, current: Value, proposal: MoveProposal<Value, Location>, accepted: boolean, checkCurrent: boolean): ApprovalResult<Value, Issue>;
+export type ApprovalStore<Value, Proposal, Issue> = {
+    getSnapshot(): Value;
+    subscribe(listener: () => void): () => void;
+    respond(proposal: Proposal, accepted: boolean): ApprovalResult<Value, Issue>;
+    /** Publish a value produced outside the reducer, such as an external edit. */
+    publish(next: Value): void;
+};
+/**
+ * Listeners, closed-session memory and publication shared by the grid and
+ * layout stores. Rejections leave the revision unchanged; every closed session
+ * is remembered until the next revision so a delayed response cannot reopen an
+ * earlier rejection.
+ */
+export declare function createApprovalStore<Value extends {
+    revision: number;
+}, Proposal extends {
+    sessionId: string;
+    baseRevision: number;
+}, Issue>(initial: Value, respond: (current: Value, proposal: Proposal, accepted: boolean) => ApprovalResult<Value, Issue>): ApprovalStore<Value, Proposal, Issue>;
+export {};
+//# sourceMappingURL=approval.d.ts.map

package/lib/typescript/src/controller/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../../src/controller/approval.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/controller/coordinatorBase.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Snapshot ownership shared by both session coordinators: subscribers,
+ * batched notification, shallow patching with `Object.is` change detection
+ * and the response deadline timer. The subclasses own their snapshot shapes,
+ * candidate calculation and lifecycle events.
+ */
+export declare abstract class CoordinatorBase<Snapshot extends object> {
+    protected snapshot: Snapshot;
+    protected changed: boolean;
+    private listeners;
+    private depth;
+    private responseTimer;
+    protected constructor(initial: Snapshot);
+    getSnapshot: () => Snapshot;
+    subscribe: (listener: () => void) => (() => void);
+    /** Nested batches notify subscribers once, after the outermost one ends. */
+    protected batch<R>(work: () => R): R;
+    protected batchStarted(): void;
+    /** Runs after subscribers were notified, even when one of them threw. */
+    protected batchFinished(): void;
+    protected get batchDepth(): number;
+    protected update(patch: Partial<Snapshot>): void;
+    /** Put back an earlier snapshot and its pending-notification flag. */
+    protected restore(snapshot: Snapshot, changed: boolean): void;
+    /**
+     * Wait for a proposal response until `deadline`. The timer re-arms while the
+     * clock has not reached the deadline (fake timers, long sleeps) and calls
+     * `onExpire` inside a batch once it has, unless `isPending` says the
+     * proposal was already settled.
+     */
+    protected armDeadline(deadline: number | undefined, isPending: () => boolean, onExpire: () => void): void;
+    protected clearDeadline(): void;
+}
+/** RN provides this monotonic clock; its generated ambient declarations omit it. */
+export declare function now(): number;
+export declare function reportCallbackError(scope: string, error: unknown): void;
+//# sourceMappingURL=coordinatorBase.d.ts.map

package/lib/typescript/src/controller/coordinatorBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinatorBase.d.ts","sourceRoot":"","sources":["../../../../src/controller/coordinatorBase.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,8BAAsB,eAAe,CAAC,QAAQ,SAAS,MAAM;IAC3D,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC7B,SAAS,CAAC,OAAO,UAAS;IAC1B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,aAAa,CAA4C;IAEjE,SAAS,aAAa,OAAO,EAAE,QAAQ;IAIvC,WAAW,QAAO,QAAQ,CAAkB;IAE5C,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK9C;IAEF,4EAA4E;IAC5E,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC;IAoBpC,SAAS,CAAC,YAAY,IAAI,IAAI;IAE9B,yEAAyE;IACzE,SAAS,CAAC,aAAa,IAAI,IAAI;IAE/B,SAAS,KAAK,UAAU,IAAI,MAAM,CAEjC;IAED,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI;IAehD,sEAAsE;IACtE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAK7D;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,OAAO,EACxB,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI;IAeP,SAAS,CAAC,aAAa,IAAI,IAAI;CAIhC;AAED,oFAAoF;AACpF,wBAAgB,GAAG,IAAI,MAAM,CAI5B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEvE"}

package/lib/typescript/src/controller/dndSession.d.ts

@@ -0,0 +1,152 @@
+import type { DndItem, GridLayoutZone, LayoutLocation, LayoutState, LayoutValidationIssue } from '../contracts.js';
+import { type GridItemLayout } from '../engine/layoutMove.js';
+import { type GridMovementPolicy, type ResolvedGridMovementPolicy } from '../engine/movementPolicy.js';
+import type { CancelReason, DragStartEvent, DropDecision, GridDiagnosticEvent } from '../types.js';
+import { type DndProposal, type DndValue } from './dndState.js';
+import { PreviewPath } from './previewPath.js';
+import { type CandidateResult, SessionCore } from './sessionCore.js';
+export type DndCancelReason = CancelReason;
+export type DndDropFailureReason = 'outside-zones' | 'invalid-target' | 'missing-grid-item-layout' | 'invalid-grid-item-layout' | 'unresolvable' | 'search-budget' | 'policy-rejected';
+export type GridItemLayoutResolverArgs<T> = {
+    item: DndItem<T>;
+    from: LayoutLocation;
+    target: GridLayoutZone;
+    value: LayoutState<T>;
+};
+export type DndDragEndEvent<T> = DragStartEvent & {
+    error?: unknown;
+} & ({
+    outcome: 'unchanged';
+} | {
+    outcome: 'cancelled';
+    reason: DndCancelReason;
+    targetZoneId?: string;
+    policyReason?: string;
+} | {
+    outcome: 'proposed';
+    proposal: DndProposal<T>;
+    targetZoneId: string;
+    response: 'accepted' | 'rejected' | 'expired' | 'mismatch';
+} | {
+    outcome: 'proposed';
+    proposal: DndProposal<T>;
+    targetZoneId: string;
+    response: 'interrupted';
+    reason: DndCancelReason | 'response-missing' | 'change-handler-error';
+});
+export type DndSessionSnapshot<T> = {
+    value: DndValue<T> | null;
+    displayValue: DndValue<T> | null;
+    candidate: LayoutState<T> | null;
+    phase: 'idle' | 'dragging' | 'awaiting-response';
+    sessionId: string | null;
+    itemId: string | null;
+    sourceZoneId: string | null;
+    targetZoneId: string | null;
+    target: LayoutLocation | null;
+    seq: number;
+    validity: 'pending' | 'valid' | 'invalid';
+    disabled: boolean;
+    /** Span and placement captured once for each grid target at activation. */
+    gridItemLayouts: ReadonlyMap<string, GridItemLayout>;
+    movementPolicy: ResolvedGridMovementPolicy;
+    failureReason: DndDropFailureReason | null;
+};
+export type DndSessionOptions<T> = {
+    value: DndValue<T>;
+    onChange(next: DndValue<T>, proposal: DndProposal<T>): void;
+    canDrop?(proposal: DndProposal<T>): DropDecision;
+    onDragStart?(event: DragStartEvent): void;
+    onDragEnd?(event: DndDragEndEvent<T>): void;
+    onValidationError?(issues: LayoutValidationIssue[]): void;
+    /** Optional JS-only observation. Exceptions are ignored; omit to disable timing. */
+    onDiagnostic?(event: GridDiagnosticEvent): void;
+    responseTimeoutMs?: number;
+    disabled?: boolean;
+    movementPolicy?: GridMovementPolicy;
+    searchBudget?: number;
+    /** Required for list-to-grid; returning null disables that target for this session. */
+    getGridItemLayout?(args: GridItemLayoutResolverArgs<T>): GridItemLayout | null;
+};
+type ActiveSession<T> = DragStartEvent & {
+    baseRevision: number;
+    seq: number;
+    target: LayoutLocation | null;
+    /** Same-zone grid previews the next candidate builds on. */
+    path: PreviewPath<LayoutLocation, LayoutState<T>>;
+    proposal?: DndProposal<T>;
+    proposalKey?: string;
+    deadline?: number;
+    gridItemLayouts: Map<string, GridItemLayout>;
+    gridItemLayoutErrors: Map<string, 'missing-grid-item-layout' | 'invalid-grid-item-layout'>;
+    movementPolicy: ResolvedGridMovementPolicy;
+    searchBudget: number;
+    responseTimeoutMs: number;
+    settingsKey: string;
+    getGridItemLayout: DndSessionOptions<T>['getGridItemLayout'];
+    resolving: boolean;
+    previewSeq: number | null;
+    previewInputVersion: number;
+};
+/** UI-independent normalized session; screen/scroll measurements stay in the adapter. */
+export declare class DndSessionCoordinator<T> extends SessionCore<DndValue<T>, LayoutLocation, DndSessionSnapshot<T>, ActiveSession<T>, DndProposal<T>> {
+    private readonly instanceId;
+    private sessionCounter;
+    private options;
+    private lastLayoutKey;
+    private validationNotification;
+    private previewInputVersion;
+    private operationVersion;
+    constructor(options: DndSessionOptions<T>);
+    /** Every batch is one operation; a refresh may only fold into its own. */
+    protected batchStarted(): void;
+    protected diagnosticObserver(): ((event: GridDiagnosticEvent) => void) | undefined;
+    /** Commit owner state after render; ordinary scroll updates do not enter this contract. */
+    commit(options: DndSessionOptions<T>): void;
+    start(itemId: string, baseRevision?: number): string | null;
+    requestTarget(sessionId: string, seq: number, to: LayoutLocation | null, options?: {
+        refresh?: boolean;
+    }): void;
+    release(sessionId: string, seq: number, to: LayoutLocation | null): void;
+    private calculate;
+    protected location(value: DndValue<T>, itemId: string): LayoutLocation | null;
+    protected isSpatial(target: LayoutLocation): target is import("../index.js").GridLocation;
+    /** Grid destinations need the span captured at activation. */
+    protected precheck(session: ActiveSession<T>, target: LayoutLocation): "invalid-target" | "missing-grid-item-layout" | "invalid-grid-item-layout" | null;
+    protected compute(session: ActiveSession<T>, target: LayoutLocation, baseline: {
+        base: DndValue<T>;
+        cumulative: boolean;
+    }, committed: DndValue<T>, from: LayoutLocation | null): CandidateResult<DndValue<T>, LayoutLocation>;
+    protected keepsPreview(session: ActiveSession<T>, target: LayoutLocation, status: 'impossible' | 'unresolved' | 'invalid'): boolean;
+    protected prepareProposal(session: ActiveSession<T>, result: {
+        value: DndValue<T>;
+        from: LayoutLocation;
+        to: LayoutLocation;
+    }): DndProposal<T>;
+    protected askPolicy(_session: ActiveSession<T>, _committed: DndValue<T>, proposal: DndProposal<T>): DropDecision;
+    protected policyFailed(session: ActiveSession<T>, seq: number, error: unknown): void;
+    protected revalidate(_session: ActiveSession<T>, committed: DndValue<T>, proposal: DndProposal<T>): boolean;
+    protected showCandidate(result: {
+        value: DndValue<T>;
+    }): void;
+    protected showFailure(committed: DndValue<T> | null, failure: string, keepPreview: boolean): void;
+    protected expectedPhase(): string;
+    protected sessionEnded(): boolean;
+    protected finishUnchanged(session: ActiveSession<T>): void;
+    protected registerProposal(session: ActiveSession<T>, proposal: DndProposal<T>, result: {
+        value: DndValue<T>;
+    }): void;
+    protected emitChange(proposal: DndProposal<T>, result: {
+        value: DndValue<T>;
+    }): void;
+    protected changeFailed(session: ActiveSession<T>, error: unknown): void;
+    private armTimer;
+    private settle;
+    private interrupt;
+    protected cancelWith(reason: DndCancelReason, error?: unknown, policyReason?: string): void;
+    cancel(reason: DndCancelReason): void;
+    private finish;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=dndSession.d.ts.map

package/lib/typescript/src/controller/dndSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dndSession.d.ts","sourceRoot":"","sources":["../../../../src/controller/dndSession.ts"],"names":[],"mappings":"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"}