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

package/lib/typescript/src/pointer/layoutTarget.d.ts

@@ -0,0 +1,43 @@
+import type { LayoutLocation } from '../contracts.js';
+import type { GridItemLayout } from '../engine/layoutMove.js';
+import type { GridMovementPolicy } from '../engine/movementPolicy.js';
+import type { GridZone } from '../types.js';
+import type { DndMotion, GridRegistration, ListViewport, ZoneRegistration } from '../runtime/dndRuntime.js';
+import type { MeasuredZone } from '../runtime/gridRuntime.js';
+type RegisteredZone = ZoneRegistration & {
+    layoutVersion: number;
+};
+type Registrations = ReadonlyMap<string, RegisteredZone>;
+/** Geometry-only immutable input for UI pointer targeting; no refs or renderers. */
+export type PreparedGridTarget = Omit<MeasuredZone, 'rect' | 'zone'> & {
+    /** Ordered grids keep their `itemSpan` so slot targeting applies. */
+    zone: GridZone<undefined>;
+    zoneId: string;
+    revision: number;
+    layoutVersion: number;
+};
+/** Prepare on registration, then reuse the result on the UI runtime. */
+export declare function prepareGridTarget(registration: GridRegistration & {
+    layoutVersion: number;
+}): PreparedGridTarget;
+/** Attach current viewport coordinates without rebuilding baseline placements. */
+export declare function measurePreparedGrid(prepared: PreparedGridTarget, measured: ListViewport): MeasuredZone | null;
+/**
+ * Use committed list geometry and the existing grid pointer policy in one
+ * measured coordinate space. Grid recipes are captured by destination zone ID.
+ */
+type LayoutTargetResolution = {
+    target: LayoutLocation | null;
+    /**
+     * The pointer is over a zone whose UI measurement predates the layout
+     * version registered on JS. The packet carries no new position; callers
+     * keep their current target until the UI publishes the new version.
+     */
+    stale: boolean;
+};
+export declare function layoutTarget(state: DndMotion, registrations: Registrations, gridItemLayouts: ReadonlyMap<string, GridItemLayout>, movementPolicy?: GridMovementPolicy, previousTarget?: LayoutLocation | null): LayoutLocation | null;
+export declare function resolveLayoutTarget(state: DndMotion, registrations: Registrations, gridItemLayouts: ReadonlyMap<string, GridItemLayout>, movementPolicy?: GridMovementPolicy, previousTarget?: LayoutLocation | null): LayoutTargetResolution;
+/** Recheck a resolved grid footprint after an exchange changes its position. */
+export declare function isLayoutTargetVisible(state: DndMotion, registrations: Registrations, target: LayoutLocation, gridItemLayouts: ReadonlyMap<string, GridItemLayout>): boolean;
+export {};
+//# sourceMappingURL=layoutTarget.d.ts.map

package/lib/typescript/src/pointer/layoutTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutTarget.d.ts","sourceRoot":"","sources":["../../../../src/pointer/layoutTarget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAc,CAAC;AAMnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA0B,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAgC,MAAM,aAAU,CAAC;AACvE,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EACjB,MAAM,0BAAuB,CAAC;AAU/B,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,2BAAwB,CAAC;AAErE,KAAK,cAAc,GAAG,gBAAgB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IACrE,qEAAqE;IACrE,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAgEF,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,gBAAgB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzD,kBAAkB,CAkFpB;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,YAAY,GACrB,YAAY,GAAG,IAAI,CAgCrB;AAsDD;;;GAGG;AACH,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EACpD,cAAc,CAAC,EAAE,kBAAkB,EACnC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,GACrC,cAAc,GAAG,IAAI,CAQvB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EACpD,cAAc,CAAC,EAAE,kBAAkB,EACnC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,GACrC,sBAAsB,CAgIxB;AAoBD,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GACnD,OAAO,CA6CT"}

package/lib/typescript/src/pointer/listCellMotion.d.ts

@@ -0,0 +1,43 @@
+import { type SharedValue } from 'react-native-reanimated';
+import { type DndPresentation } from '../runtime/dndPresentation.js';
+import type { DndRuntime } from '../runtime/dndRuntime.js';
+type ListCellMotionArgs = {
+    zoneId: string;
+    itemId: string;
+    vertical: boolean;
+    fixed: boolean;
+    /** Committed main-axis start used when no validated candidate rect exists. */
+    start: number | SharedValue<number>;
+    /** Committed main-axis size used when no validated candidate rect exists. */
+    size: number;
+    presentation: DndRuntime['presentation'];
+    revision: number | SharedValue<number>;
+    hiddenItemId: SharedValue<string | null>;
+    animation: DndRuntime['animation'];
+    /**
+     * JS view of the geometry the Provider has already scheduled for the UI
+     * runtime. It is read once at mount for the initial style; the UI mapper
+     * adopts the actual UI geometry on its first run without animating.
+     */
+    initial: {
+        presentation: DndPresentation | undefined;
+        revision: number;
+        start: number;
+    };
+};
+type ListCellMotion = {
+    /** Animated main-axis content start in list content coordinates. */
+    animatedStart: SharedValue<number>;
+    /** Validated main-axis size for authoritative (fixed) item sizes. */
+    targetSize: SharedValue<number>;
+};
+/**
+ * One UI mapper per cell selects the validated candidate rect and animates the
+ * content start. Mount reads no UI state: a synchronous shared-value read from
+ * JS blocks on the UI runtime and copies the whole presentation table. The
+ * first UI evaluation snaps to the UI geometry so a stale estimate never
+ * becomes the start of a timing animation.
+ */
+export declare function useListCellMotion(args: ListCellMotionArgs): ListCellMotion;
+export {};
+//# sourceMappingURL=listCellMotion.d.ts.map

package/lib/typescript/src/pointer/listCellMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listCellMotion.d.ts","sourceRoot":"","sources":["../../../../src/pointer/listCellMotion.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAAuB,CAAC;AAExD,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC;;;;OAIG;IACH,OAAO,EAAE;QACP,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;QAC1C,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,oEAAoE;IACpE,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,qEAAqE;IACrE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAyBF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA+F1E"}

package/lib/typescript/src/pointer/listTarget.d.ts

@@ -0,0 +1,7 @@
+import type { ListLocation } from '../contracts.js';
+import type { DndMotion, ListRegistration } from '../runtime/dndRuntime.js';
+/** Target from committed order; candidate reflow must not move its own thresholds. */
+export declare function listTarget(state: DndMotion, registrations: ReadonlyMap<string, ListRegistration & {
+    layoutVersion: number;
+}>): ListLocation | null;
+//# sourceMappingURL=listTarget.d.ts.map

package/lib/typescript/src/pointer/listTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTarget.d.ts","sourceRoot":"","sources":["../../../../src/pointer/listTarget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAc,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAAuB,CAAC;AAGzE,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,WAAW,CACxB,MAAM,EACN,gBAAgB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAC7C,GACA,YAAY,GAAG,IAAI,CAyCrB"}

package/lib/typescript/src/pointer/motion.d.ts

@@ -0,0 +1,20 @@
+import type { ValidationIssue } from '../types.js';
+export type GridMotionConfig = {
+    /** Duration in milliseconds for item movement and preview settling. Defaults to 180. */
+    durationMs?: number;
+    /** Respect the device accessibility setting by default. */
+    reduceMotion?: 'system' | 'always' | 'never';
+};
+type ResolvedGridMotionConfig = Required<GridMotionConfig>;
+export declare const DEFAULT_GRID_MOTION: Readonly<ResolvedGridMotionConfig>;
+type GridMotionResult = {
+    valid: true;
+    motion: ResolvedGridMotionConfig;
+} | {
+    valid: false;
+    issues: ValidationIssue[];
+};
+/** Validate before sharing animation settings with the UI runtime. */
+export declare function resolveGridMotion(value: unknown): GridMotionResult;
+export {};
+//# sourceMappingURL=motion.d.ts.map

package/lib/typescript/src/pointer/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../../src/pointer/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC9C,CAAC;AAEF,KAAK,wBAAwB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAE3D,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,wBAAwB,CACP,CAAC;AAE7D,KAAK,gBAAgB,GACjB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,GACjD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAEhD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA8ClE"}

package/lib/typescript/src/runtime/dndPresentation.d.ts

@@ -0,0 +1,37 @@
+import type { LayoutLocation, LayoutRect } from '../contracts.js';
+/**
+ * Only validated numeric geometry crosses into the UI runtime. Coordinates
+ * form one typed array so a zone table crosses runtimes as a single buffer;
+ * the slot map is reused while a zone keeps the same items, so repeated
+ * candidates serialize only the coordinates.
+ */
+export type DndZonePresentation = {
+    /** Prefixed item ID → slot; four coordinates per slot in `rects`. */
+    slots: Readonly<Record<string, number>>;
+    /** x, y, width and height of each slot, in zone content coordinates. */
+    rects: Float64Array;
+};
+export type DndPresentation = {
+    token: number;
+    revision: number;
+    zones: Record<string, DndZonePresentation>;
+    /** Last policy-approved preview, usable for motion before JS acknowledges release. */
+    releaseTarget?: {
+        target: LayoutLocation;
+        policyRevision: number;
+        /** Final pointer already validated by JS; controlled state may still be pending. */
+        releasedSeq?: number;
+    };
+};
+export declare const EMPTY_DND_PRESENTATION: DndPresentation;
+export declare function presentationRect(presentation: DndPresentation | undefined, zoneId: string, itemId: string): LayoutRect | undefined;
+/**
+ * Build a zone table from item rects. The previous table's slot map is kept
+ * when it lists exactly these items, so unchanged maps keep their identity.
+ */
+export declare function createZonePresentation(entries: ReadonlyArray<readonly [itemId: string, rect: LayoutRect]>, previous?: DndZonePresentation | null): DndZonePresentation;
+/** Build a zone table from a `#itemId` keyed rect record. */
+export declare function zonePresentationFromRects(rects: Readonly<Record<string, LayoutRect>>): DndZonePresentation;
+/** Read a zone table back as a `#itemId` keyed rect record. */
+export declare function zonePresentationRects(zone: DndZonePresentation | undefined): Record<string, LayoutRect>;
+//# sourceMappingURL=dndPresentation.d.ts.map

package/lib/typescript/src/runtime/dndPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dndPresentation.d.ts","sourceRoot":"","sources":["../../../../src/runtime/dndPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qEAAqE;IACrE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,wEAAwE;IACxE,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,sFAAsF;IACtF,aAAa,CAAC,EAAE;QACd,MAAM,EAAE,cAAc,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,oFAAoF;QACpF,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAIpC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,eAAe,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAaxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,EACnE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACpC,mBAAmB,CAyBrB;AAED,6DAA6D;AAC7D,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAC1C,mBAAmB,CAIrB;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAa5B"}

package/lib/typescript/src/runtime/dndRenderStore.d.ts

@@ -0,0 +1,46 @@
+import type { DndItem, LayoutZone } from '../contracts.js';
+import type { DndSessionSnapshot } from '../controller/dndSession.js';
+type DndSnapshotSource<T = unknown> = {
+    getSnapshot(): DndSessionSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+};
+export type DndZoneSnapshot = {
+    zone: LayoutZone | undefined;
+    display: LayoutZone | undefined;
+    items: readonly DndItem<unknown>[] | undefined;
+    revision: number;
+    displayRevision: number;
+    activeItemId: string | null;
+    scrollEnabled: boolean;
+};
+type DndItemSnapshot = {
+    index: number;
+    row?: number;
+    col?: number;
+};
+/**
+ * Answers once per drag session whether a zone keeps its native slots in
+ * committed order while `activeItemId` is dragged. Adapters whose mounted set
+ * depends on slot order (windowed lists) answer from their render window.
+ */
+export type RetainSlotsRule = (activeItemId: string) => boolean;
+/** Separate React subscriptions from frame-by-frame approved presentation. */
+export declare class DndRenderStore<T = unknown> {
+    private readonly source;
+    private provider;
+    private zones;
+    private itemIndices;
+    private items;
+    private retainDecisions;
+    constructor(source: DndSnapshotSource<T>);
+    getSnapshot: () => DndSessionSnapshot<T>;
+    getProviderSnapshot: () => DndSessionSnapshot<T>;
+    getZoneSnapshot: (zoneId: string, preserveSlots?: boolean | RetainSlotsRule) => DndZoneSnapshot;
+    /** A rule is consulted once per drag session so its answer cannot flip mid-drag. */
+    private retainSlots;
+    getItemSnapshot: (zoneId: string, itemId: string) => DndItemSnapshot | undefined;
+    subscribeSelection<Selection>(get: () => Selection, listener: () => void): () => void;
+    subscribeProvider: (listener: () => void) => (() => void);
+}
+export {};
+//# sourceMappingURL=dndRenderStore.d.ts.map

package/lib/typescript/src/runtime/dndRenderStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dndRenderStore.d.ts","sourceRoot":"","sources":["../../../../src/runtime/dndRenderStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA0B,CAAC;AAEnE,KAAK,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI;IACpC,WAAW,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACrC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;AA2ChE,8EAA8E;AAC9E,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IAUzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAA2D;IAC9E,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,eAAe,CAGnB;gBAEyB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEzD,WAAW,QAAO,kBAAkB,CAAC,CAAC,CAAC,CAA8B;IAErE,mBAAmB,QAAO,kBAAkB,CAAC,CAAC,CAAC,CAgB7C;IAEF,eAAe,GACb,QAAQ,MAAM,EACd,gBAAe,OAAO,GAAG,eAAsB,KAC9C,eAAe,CAiDhB;IAEF,oFAAoF;IACpF,OAAO,CAAC,WAAW;IAuBnB,eAAe,GACb,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,eAAe,GAAG,SAAS,CA0C5B;IAEF,kBAAkB,CAAC,SAAS,EAC1B,GAAG,EAAE,MAAM,SAAS,EACpB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI;IAUb,iBAAiB,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CACM;CAC/D"}

package/lib/typescript/src/runtime/dndRuntime.d.ts

@@ -0,0 +1,138 @@
+import { type ReactNode } from 'react';
+import type { HostInstance } from 'react-native';
+import { type AnimatedRef, type SharedValue } from 'react-native-reanimated';
+import type { AutoScrollOptions, DragAxis } from '../adapters/scroll.js';
+import type { GridLayoutZone, DndItem, LayoutPoint, LayoutRect, ListLayoutZone, MeasuredRect } from '../contracts.js';
+import type { DndSessionSnapshot } from '../controller/dndSession.js';
+import type { ListLayout } from '../engine/list.js';
+import type { ListTargetIndex } from '../engine/listIndex.js';
+import type { PreparedGridTarget } from '../pointer/layoutTarget.js';
+import type { DndPresentation, DndZonePresentation } from './dndPresentation.js';
+import type { LayoutValidationIssue } from '../contracts.js';
+import type { CancelReason } from '../types.js';
+import type { GridMotionConfig } from '../pointer/motion.js';
+import type { ListItemRenderArgs } from '../components/dndTypes.js';
+import type { GestureRelations, ZoneGeometry } from '../components/gridTypes.js';
+import type { CellGeometry } from './gridRuntime.js';
+import { DndRenderStore, type DndZoneSnapshot, type RetainSlotsRule } from './dndRenderStore.js';
+type UiListRegistration = {
+    kind: 'list';
+    zoneId: string;
+    orientation: 'vertical' | 'horizontal';
+    revision: number;
+    layoutVersion: number;
+    ref: AnimatedRef<HostInstance>;
+    offset: SharedValue<number>;
+    contentSize: number;
+    autoScroll?: AutoScrollOptions;
+    targetIndex?: ListTargetIndex;
+};
+type UiGridRegistration = {
+    kind: 'grid';
+    zoneId: string;
+    revision: number;
+    layoutVersion: number;
+    ref: AnimatedRef<HostInstance>;
+    targetGrid?: PreparedGridTarget;
+};
+export type UiZoneRegistration = UiListRegistration | UiGridRegistration;
+export type ListRegistration = Omit<UiListRegistration, 'layoutVersion'> & {
+    layout: ListLayout;
+    dataIdentity?: readonly DndItem<unknown>[];
+    prepareDisplay?(zone: ListLayoutZone, revision: number): DndZonePresentation | null;
+    renderItem(args: ListItemRenderArgs<unknown>): ReactNode;
+};
+export type GridRegistration = Omit<UiGridRegistration, 'layoutVersion'> & {
+    layout: GridLayoutZone;
+    geometry: ZoneGeometry;
+    cells: CellGeometry;
+    pixelRatio: number;
+    renderItem(args: ListItemRenderArgs<unknown>): ReactNode;
+};
+export type ZoneRegistration = ListRegistration | GridRegistration;
+export type ListViewport = {
+    zoneId: string;
+    viewport: MeasuredRect<'screen'>;
+    offset: number;
+    layoutVersion: number;
+};
+export type DndMotion = {
+    token: number;
+    /** Provider-owned native recognizer; independent of virtual cell lifetime. */
+    handleId: number | null;
+    seq: number;
+    phase: 'idle' | 'dragging' | 'released';
+    itemId: string | null;
+    sourceZoneId: string | null;
+    revision: number;
+    pointer: LayoutPoint;
+    origin: LayoutPoint;
+    axis: DragAxis;
+    activationDelayMs: number;
+    configRevision: number;
+    grip: LayoutPoint;
+    width: number;
+    height: number;
+    root: LayoutRect;
+    zones: ListViewport[];
+    visible: boolean;
+};
+export declare const EMPTY_DND_MOTION: DndMotion;
+export type DndRuntime = {
+    snapshot: DndSessionSnapshot<unknown>;
+    renderStore?: DndRenderStore;
+    motion: SharedValue<DndMotion>;
+    presentation?: SharedValue<DndPresentation>;
+    /** JS view of the presentation most recently scheduled for the UI runtime. */
+    presentationSnapshot?(): DndPresentation;
+    /** Shared committed revision keeps unchanged cell worklets stable on approval. */
+    committedRevision?: SharedValue<number>;
+    /** Provider frame owns measurements and semantic dispatch when enabled. */
+    frameDriven?: boolean;
+    zones: SharedValue<UiZoneRegistration[]>;
+    disabled: SharedValue<boolean>;
+    token: SharedValue<number>;
+    rootRef: AnimatedRef<HostInstance>;
+    dragAxis: DragAxis;
+    activationDelayMs: number;
+    gestureConfigRevision: number;
+    animation: Required<GridMotionConfig>;
+    begin(state: DndMotion): void;
+    move(state: DndMotion): void;
+    release(state: DndMotion, cancelled: boolean | CancelReason): void;
+    cancel(reason: CancelReason): void;
+    registerZone(registration: ZoneRegistration, identity: object): void;
+    unregisterZone(zoneId: string, identity: object): void;
+    registerHandle(registration: DndHandleRegistration, identity: object): void;
+    unregisterHandle(identity: object): void;
+    reportIssues(owner: string, issues: LayoutValidationIssue[]): void;
+};
+export type DndHandleRegistration = {
+    itemId: string;
+    zoneId: string;
+    ref: AnimatedRef<HostInstance>;
+    sourceRef: AnimatedRef<HostInstance>;
+    disabled: boolean;
+    gestureRelations?: GestureRelations;
+};
+export declare const DndRuntimeContext: import("react").Context<DndRuntime | null>;
+export declare const DndItemContext: import("react").Context<{
+    itemId: string;
+    zoneId: string;
+    ref: AnimatedRef<HostInstance>;
+    preview?: boolean;
+} | null>;
+export declare function useDndRuntime(): DndRuntime;
+export declare function useDndZoneSnapshot(runtime: DndRuntime, zoneId: string, preserveSlots?: boolean | RetainSlotsRule): DndZoneSnapshot;
+export declare function useDndHandleActive(runtime: DndRuntime, itemId: string | undefined, disabled: boolean): boolean;
+/** Public render arguments follow approved previews independently of native slots. */
+export declare function useDndItemSnapshot(runtime: DndRuntime, zoneId: string, itemId: string): {
+    index: number;
+    row?: number;
+    col?: number;
+} | undefined;
+export declare function measureDndRect(ref: AnimatedRef<HostInstance>): LayoutRect | null;
+export declare function readListViewports(zones: readonly UiZoneRegistration[]): ListViewport[];
+export declare function pointInRect(point: LayoutPoint, rect: LayoutRect): boolean;
+export {};
+//# sourceMappingURL=dndRuntime.d.ts.map

package/lib/typescript/src/runtime/dndRuntime.d.ts.map

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

package/lib/typescript/src/runtime/dndSettlement.d.ts

@@ -0,0 +1,18 @@
+import type { LayoutPoint, LayoutRect } from '../contracts.js';
+type SettlementGeometry = {
+    /** Root and viewport use screen coordinates; contentRect excludes scrolling. */
+    root: LayoutRect;
+    viewport: LayoutRect;
+    contentRect: LayoutRect;
+    nativeRect: LayoutRect | null;
+    scrollOffset: LayoutPoint;
+    pixelRatio?: number;
+};
+/** Resolve the committed logical slot without waiting for a native cell. */
+export declare function settlementTarget({ root, viewport, contentRect, scrollOffset, pixelRatio, }: Omit<SettlementGeometry, 'nativeRect'>): LayoutRect | null;
+/** Native alignment gates only the final handoff, not the overlay animation. */
+export declare function settlementDestination({ root, viewport, contentRect, nativeRect, scrollOffset, pixelRatio, }: SettlementGeometry): LayoutRect | null;
+/** Both rectangles use root coordinates; progress is the native animation value. */
+export declare function interpolateSettlementRect(from: LayoutRect, to: LayoutRect, progress: number): LayoutRect | null;
+export {};
+//# sourceMappingURL=dndSettlement.d.ts.map

package/lib/typescript/src/runtime/dndSettlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dndSettlement.d.ts","sourceRoot":"","sources":["../../../../src/runtime/dndSettlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAI5D,KAAK,kBAAkB,GAAG;IACxB,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAkBF,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAc,GACf,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GAAG,UAAU,GAAG,IAAI,CAyB5D;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAc,GACf,EAAE,kBAAkB,GAAG,UAAU,GAAG,IAAI,CA0BxC;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,IAAI,CAWnB"}

package/lib/typescript/src/runtime/gridRuntime.d.ts

@@ -0,0 +1,54 @@
+import type { HostInstance } from 'react-native';
+import type { AnimatedRef } from 'react-native-reanimated';
+import type { GridMovementPolicy } from '../engine/movementPolicy.js';
+import type { CellSpan, GridZone, ItemLocation } from '../types.js';
+import type { ZoneGeometry } from '../components/gridTypes.js';
+/**
+ * Geometry vocabulary of the grid pointer policy (`pointer/geometry.ts`),
+ * shared by the provider's layout targeting. The React runtime of the former
+ * grid controller no longer lives here.
+ */
+export type WindowRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type CellGeometry = {
+    cellWidth: number;
+    cellHeight: number;
+};
+export type ZoneRegistration = {
+    zone: GridZone<undefined>;
+    geometry: ZoneGeometry;
+    pixelRatio: number;
+    ref: AnimatedRef<HostInstance>;
+};
+export type MeasuredZone = Omit<ZoneRegistration, 'ref'> & {
+    rect: WindowRect;
+    cells: CellGeometry;
+};
+export type UiMotion = {
+    movementPolicy?: GridMovementPolicy;
+    baseRevision?: number;
+    token: number;
+    phase: 'idle' | 'dragging' | 'finalizing' | 'settling' | 'handoff';
+    itemId: string | null;
+    sourceZoneId: string | null;
+    seq: number;
+    target: ItemLocation | null;
+    span: CellSpan;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    gripX: number;
+    gripY: number;
+    zones: MeasuredZone[];
+    outlet: WindowRect;
+    validity: 'pending' | 'valid' | 'invalid';
+    visible: boolean;
+    destination: WindowRect | null;
+};
+export declare const EMPTY_MOTION: UiMotion;
+//# sourceMappingURL=gridRuntime.d.ts.map

package/lib/typescript/src/runtime/gridRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridRuntime.d.ts","sourceRoot":"","sources":["../../../../src/runtime/gridRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAU,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAAyB,CAAC;AAE5D;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,GAAG;IACzD,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG;IACrB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,QAmB1B,CAAC"}

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

@@ -0,0 +1,180 @@
+import type { MoveProposal, ProposalResponse } from './contracts.js';
+import type { GridMovementPolicy } from './engine/movementPolicy.js';
+export type CellPosition = {
+    row: number;
+    col: number;
+};
+export type CellSpan = {
+    rows: number;
+    cols: number;
+};
+/** Optional JS diagnostics; durations are not native rendering or GPU timings. */
+export type GridDiagnosticEvent = {
+    type: 'timing';
+    name: 'compute-move' | 'input-validation' | 'candidate-validation' | 'policy';
+    durationMs: number;
+    sessionId?: string;
+    attempts?: number;
+    status?: string;
+} | {
+    type: 'lifecycle';
+    name: 'request' | 'request-coalesced' | 'release' | 'proposal' | 'response' | 'settling' | 'end';
+    timestampMs: number;
+    sessionId: string;
+};
+export type ItemPlacement = 'insert' | 'exchange';
+export type GridItem<T> = {
+    id: string;
+    span: CellSpan;
+    /** Caller-selected spatial behavior. Omitted means exchange, regardless of size. */
+    placement?: ItemPlacement;
+    data: T;
+};
+export type PositionedItem<T> = GridItem<T> & {
+    position: CellPosition;
+};
+export type SpatialZone<T> = {
+    id: string;
+    rows: number;
+    columns: number;
+    strategy: 'spatial';
+    items: PositionedItem<T>[];
+};
+export type OrderedZone<T> = {
+    id: string;
+    rows: number;
+    columns: number;
+    strategy: 'ordered';
+    itemSpan: CellSpan;
+    items: GridItem<T>[];
+};
+export type GridZone<T> = SpatialZone<T> | OrderedZone<T>;
+export type GridValue<T> = {
+    zones: GridZone<T>[];
+    /** Increment on every external data/layout edit. Omit only for legacy control. */
+    revision?: number;
+    proposalResponse?: Omit<ProposalResponse, 'baseRevision'> & {
+        baseRevision?: number;
+    };
+};
+export type RevisionedGridValue<T> = GridValue<T> & {
+    revision: number;
+};
+export type GridProposal<T> = MoveProposal<RevisionedGridValue<T>, ItemLocation>;
+export type ValidationCode = 'invalid-structure' | 'duplicate-id' | 'invalid-dimension' | 'invalid-span' | 'invalid-placement' | 'missing-item-span' | 'span-mismatch' | 'invalid-position' | 'out-of-bounds' | 'overlap' | 'capacity-exceeded' | 'invalid-budget' | 'invalid-geometry' | 'invalid-configuration';
+export type ValidationIssue = {
+    code: ValidationCode;
+    zoneId?: string;
+    itemId?: string;
+    message: string;
+};
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    issues: ValidationIssue[];
+};
+export type ZoneLayoutResult<T> = {
+    valid: true;
+    items: PositionedItem<T>[];
+} | {
+    valid: false;
+    issues: ValidationIssue[];
+};
+export type PackInput<T> = {
+    items: readonly GridItem<T>[];
+    rows: number;
+    columns: number;
+    searchBudget: number;
+};
+export type PackResult<T> = {
+    status: 'ok';
+    placements: PositionedItem<T>[];
+} | {
+    status: 'impossible';
+} | {
+    status: 'unresolved';
+} | {
+    status: 'invalid';
+    issues: ValidationIssue[];
+};
+export type ItemLocation = {
+    zoneId: string;
+    strategy: 'spatial';
+    position: CellPosition;
+} | {
+    zoneId: string;
+    strategy: 'ordered';
+    index: number;
+};
+/** A logical target, after pointer conversion and hysteresis in the controller. */
+export type MoveInput<T> = {
+    movementPolicy?: GridMovementPolicy;
+    value: GridValue<T>;
+    itemId: string;
+    to: ItemLocation;
+    searchBudget?: number;
+};
+export type MoveResult<T> = {
+    status: 'ok';
+    value: GridValue<T>;
+    from: ItemLocation;
+    to: ItemLocation;
+    changed: boolean;
+    attempts: number;
+} | {
+    status: 'impossible' | 'unresolved';
+    attempts: number;
+} | {
+    status: 'invalid';
+    issues: ValidationIssue[];
+};
+export type GridChange = {
+    sessionId: string;
+    /** Present when the input GridValue supplies a revision (including useGridState). */
+    baseRevision?: number;
+    itemId: string;
+    from: ItemLocation;
+    to: ItemLocation;
+};
+export type DragStartEvent = {
+    sessionId: string;
+    itemId: string;
+    sourceZoneId: string;
+};
+export type CanDropArgs<T> = {
+    item: GridItem<T>;
+    change: GridChange;
+    proposedValue: GridValue<T>;
+};
+export type DropDecision = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason?: string;
+};
+export type CleanupReason = 'input-changed' | 'geometry-changed' | 'zone-removed' | 'disabled' | 'unmounted';
+/** Interruptions include every cancel reason a proposal can meet while it awaits a response. */
+export type ProposalInterruptReason = CancelReason | 'response-missing' | 'change-handler-error';
+export type CancelReason = CleanupReason | 'outside-zones' | 'invalid-target' | 'measure-failed' | 'policy-rejected' | 'search-budget' | 'unresolvable' | 'gesture-interrupted' | 'policy-error' | 'start-handler-error';
+export type DragEndEvent = DragStartEvent & {
+    cleanupReason?: CleanupReason;
+    error?: unknown;
+} & ({
+    outcome: 'unchanged';
+} | {
+    outcome: 'cancelled';
+    targetZoneId?: string;
+    reason: CancelReason;
+    policyReason?: string;
+} | ({
+    outcome: 'proposed';
+    change: GridChange;
+    targetZoneId: string;
+} & ({
+    response: 'accepted' | 'rejected' | 'expired' | 'mismatch';
+} | {
+    response: 'interrupted';
+    reason: ProposalInterruptReason;
+})));
+//# sourceMappingURL=types.d.ts.map