@flighthq/selection 0.4.1-edge.28.7f8e221

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) 2013-2026 Joshua Granick and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @flighthq/selection
+
+Ordered scene-graph selection state and geometric selection queries
+
+## Install
+
+```sh
+npm install @flighthq/selection
+```
+
+Import the supported application-facing API from `@flighthq/selection`. The `@flighthq/selection/contract` export is the wider package-to-package contract used to compose Flight itself.
+
+This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
+
+- [Flight project](https://github.com/flighthq/flight)
+- [Source for @flighthq/selection@0.4.1-edge.28.7f8e221](https://github.com/flighthq/flight/tree/7f8e221c72f4afa55c07bf31862b2e3d60e1c81f/packages/selection)
+- [License](https://github.com/flighthq/flight/blob/7f8e221c72f4afa55c07bf31862b2e3d60e1c81f/LICENSE.md)

package/dist/contract.d.ts

@@ -0,0 +1,5 @@
+export * from './lassoSelection';
+export * from './marqueeSelection';
+export * from './pointerSelectionPolicy';
+export * from './selectionState';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,5 @@
+export * from './lassoSelection';
+export * from './marqueeSelection';
+export * from './pointerSelectionPolicy';
+export * from './selectionState';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { addLassoSelectionPoint, addNodeToSelection, applyPointerSelectionPolicy, applyPointerUpSelectionPolicy, beginLassoSelection, beginMarqueeSelection, clearSelection, createLassoSelection, createMarqueeSelection, createSelectionState, endLassoSelection, endMarqueeSelection, findNodesInLassoSelection, findNodesInMarqueeSelection, getActiveNode, getLassoSelectionPath, getMarqueeRectangle, getSelectedNodes, getSelectionCount, getSelectionSignals, hasSelection, isNodeSelected, removeNodeFromSelection, selectAllNodes, selectNode, toggleNodeSelection, updateMarqueeSelection, } from './contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { addLassoSelectionPoint, addNodeToSelection, applyPointerSelectionPolicy, applyPointerUpSelectionPolicy, beginLassoSelection, beginMarqueeSelection, clearSelection, createLassoSelection, createMarqueeSelection, createSelectionState, endLassoSelection, endMarqueeSelection, findNodesInLassoSelection, findNodesInMarqueeSelection, getActiveNode, getLassoSelectionPath, getMarqueeRectangle, getSelectedNodes, getSelectionCount, getSelectionSignals, hasSelection, isNodeSelected, removeNodeFromSelection, selectAllNodes, selectNode, toggleNodeSelection, updateMarqueeSelection, } from './contract';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/lassoSelection.d.ts

@@ -0,0 +1,8 @@
+import type { BoundsNodeAny, LassoSelection, Path } from '@flighthq/types/contract';
+export declare function addLassoSelectionPoint(selection: LassoSelection, x: number, y: number): void;
+export declare function beginLassoSelection(selection: LassoSelection, startX: number, startY: number): void;
+export declare function createLassoSelection(): LassoSelection;
+export declare function endLassoSelection(selection: LassoSelection): Path;
+export declare function findNodesInLassoSelection<NodeType extends BoundsNodeAny>(selection: Readonly<LassoSelection>, candidates: readonly NodeType[]): NodeType[];
+export declare function getLassoSelectionPath(selection: Readonly<LassoSelection>): Readonly<Path>;
+//# sourceMappingURL=lassoSelection.d.ts.map

package/dist/lassoSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lassoSelection.d.ts","sourceRoot":"","sources":["../src/lassoSelection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAyB,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAG3G,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAK5F;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOnG;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CASrD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAKjE;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,aAAa,EACtE,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,EACnC,UAAU,EAAE,SAAS,QAAQ,EAAE,GAC9B,QAAQ,EAAE,CAaZ;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAEzF"}

package/dist/lassoSelection.js

@@ -0,0 +1,84 @@
+import { getNodeLocalBoundsRectangle } from '@flighthq/node/contract';
+import { EntityRuntimeKey, PathCommand } from '@flighthq/types/contract';
+export function addLassoSelectionPoint(selection, x, y) {
+    const runtime = getLassoSelectionRuntime(selection);
+    if (!runtime.active)
+        return;
+    runtime.path.commands.push(PathCommand.LINE_TO);
+    runtime.path.data.push(x, y);
+}
+export function beginLassoSelection(selection, startX, startY) {
+    const runtime = getLassoSelectionRuntime(selection);
+    runtime.active = true;
+    runtime.path.commands.length = 0;
+    runtime.path.data.length = 0;
+    runtime.path.commands.push(PathCommand.MOVE_TO);
+    runtime.path.data.push(startX, startY);
+}
+export function createLassoSelection() {
+    const selection = { [EntityRuntimeKey]: undefined };
+    const runtime = {
+        active: false,
+        binding: null,
+        path: { commands: [], data: [], winding: 'evenOdd' },
+    };
+    selection[EntityRuntimeKey] = runtime;
+    return selection;
+}
+export function endLassoSelection(selection) {
+    const runtime = getLassoSelectionRuntime(selection);
+    if (runtime.active)
+        runtime.path.commands.push(PathCommand.CLOSE);
+    runtime.active = false;
+    return runtime.path;
+}
+export function findNodesInLassoSelection(selection, candidates) {
+    const path = getLassoSelectionRuntime(selection).path;
+    if (path.data.length < 6)
+        return [];
+    const matches = [];
+    for (let i = 0; i < candidates.length; i++) {
+        const candidate = candidates[i];
+        const bounds = getNodeLocalBoundsRectangle(candidate);
+        if (isPointInPolygon(path.data, bounds.x + bounds.width / 2, bounds.y + bounds.height / 2)) {
+            matches.push(candidate);
+        }
+    }
+    return matches;
+}
+export function getLassoSelectionPath(selection) {
+    return getLassoSelectionRuntime(selection).path;
+}
+function getLassoSelectionRuntime(selection) {
+    return selection[EntityRuntimeKey];
+}
+function isPointInPolygon(points, x, y) {
+    let inside = false;
+    const pointCount = points.length / 2;
+    let previousIndex = pointCount - 1;
+    for (let currentIndex = 0; currentIndex < pointCount; currentIndex++) {
+        const currentX = points[currentIndex * 2];
+        const currentY = points[currentIndex * 2 + 1];
+        const previousX = points[previousIndex * 2];
+        const previousY = points[previousIndex * 2 + 1];
+        if (isPointOnSegment(x, y, previousX, previousY, currentX, currentY))
+            return true;
+        if (currentY > y !== previousY > y &&
+            x < ((previousX - currentX) * (y - currentY)) / (previousY - currentY) + currentX) {
+            inside = !inside;
+        }
+        previousIndex = currentIndex;
+    }
+    return inside;
+}
+function isPointOnSegment(x, y, startX, startY, endX, endY) {
+    const cross = (x - startX) * (endY - startY) - (y - startY) * (endX - startX);
+    const scale = Math.max(1, Math.abs(endX - startX), Math.abs(endY - startY));
+    if (Math.abs(cross) > Number.EPSILON * scale * 16)
+        return false;
+    return (x >= Math.min(startX, endX) &&
+        x <= Math.max(startX, endX) &&
+        y >= Math.min(startY, endY) &&
+        y <= Math.max(startY, endY));
+}
+//# sourceMappingURL=lassoSelection.js.map

package/dist/lassoSelection.js.map

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

package/dist/marqueeSelection.d.ts

@@ -0,0 +1,8 @@
+import type { BoundsNodeAny, MarqueeSelection, MarqueeSelectionMode, Rectangle } from '@flighthq/types/contract';
+export declare function beginMarqueeSelection(selection: MarqueeSelection, startX: number, startY: number): void;
+export declare function createMarqueeSelection(): MarqueeSelection;
+export declare function endMarqueeSelection(selection: MarqueeSelection): Rectangle;
+export declare function findNodesInMarqueeSelection<NodeType extends BoundsNodeAny>(selection: Readonly<MarqueeSelection>, candidates: readonly NodeType[], mode?: MarqueeSelectionMode): NodeType[];
+export declare function getMarqueeRectangle(selection: Readonly<MarqueeSelection>): Readonly<Rectangle>;
+export declare function updateMarqueeSelection(selection: MarqueeSelection, currentX: number, currentY: number): void;
+//# sourceMappingURL=marqueeSelection.d.ts.map

package/dist/marqueeSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marqueeSelection.d.ts","sourceRoot":"","sources":["../src/marqueeSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EAEpB,SAAS,EACV,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMvG;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAWzD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAI1E;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,aAAa,EACxE,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACrC,UAAU,EAAE,SAAS,QAAQ,EAAE,EAC/B,IAAI,GAAE,oBAAkC,GACvC,QAAQ,EAAE,CAWZ;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAE9F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI5G"}

package/dist/marqueeSelection.js

@@ -0,0 +1,58 @@
+import { createRectangle, enclosesRectangle, intersectsRectangle } from '@flighthq/geometry/contract';
+import { getNodeLocalBoundsRectangle } from '@flighthq/node/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+export function beginMarqueeSelection(selection, startX, startY) {
+    const runtime = getMarqueeSelectionRuntime(selection);
+    runtime.active = true;
+    runtime.startX = startX;
+    runtime.startY = startY;
+    setMarqueeRectangle(runtime.rectangle, startX, startY, startX, startY);
+}
+export function createMarqueeSelection() {
+    const selection = { [EntityRuntimeKey]: undefined };
+    const runtime = {
+        active: false,
+        binding: null,
+        rectangle: createRectangle(),
+        startX: 0,
+        startY: 0,
+    };
+    selection[EntityRuntimeKey] = runtime;
+    return selection;
+}
+export function endMarqueeSelection(selection) {
+    const runtime = getMarqueeSelectionRuntime(selection);
+    runtime.active = false;
+    return runtime.rectangle;
+}
+export function findNodesInMarqueeSelection(selection, candidates, mode = 'intersect') {
+    const rectangle = getMarqueeSelectionRuntime(selection).rectangle;
+    const matches = [];
+    for (let i = 0; i < candidates.length; i++) {
+        const candidate = candidates[i];
+        const bounds = getNodeLocalBoundsRectangle(candidate);
+        if (mode === 'contain' ? enclosesRectangle(rectangle, bounds) : intersectsRectangle(rectangle, bounds)) {
+            matches.push(candidate);
+        }
+    }
+    return matches;
+}
+export function getMarqueeRectangle(selection) {
+    return getMarqueeSelectionRuntime(selection).rectangle;
+}
+export function updateMarqueeSelection(selection, currentX, currentY) {
+    const runtime = getMarqueeSelectionRuntime(selection);
+    if (!runtime.active)
+        return;
+    setMarqueeRectangle(runtime.rectangle, runtime.startX, runtime.startY, currentX, currentY);
+}
+function getMarqueeSelectionRuntime(selection) {
+    return selection[EntityRuntimeKey];
+}
+function setMarqueeRectangle(rectangle, startX, startY, endX, endY) {
+    rectangle.x = Math.min(startX, endX);
+    rectangle.y = Math.min(startY, endY);
+    rectangle.width = Math.abs(endX - startX);
+    rectangle.height = Math.abs(endY - startY);
+}
+//# sourceMappingURL=marqueeSelection.js.map

package/dist/marqueeSelection.js.map

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

package/dist/pointerSelectionPolicy.d.ts

@@ -0,0 +1,4 @@
+import type { HierarchyNodeAny, SelectionModifierState, SelectionState } from '@flighthq/types/contract';
+export declare function applyPointerSelectionPolicy<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, hit: NodeType | null, modifiers: Readonly<SelectionModifierState>): void;
+export declare function applyPointerUpSelectionPolicy<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, hit: NodeType | null, modifiers: Readonly<SelectionModifierState>, didDrag: boolean): void;
+//# sourceMappingURL=pointerSelectionPolicy.d.ts.map

package/dist/pointerSelectionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointerSelectionPolicy.d.ts","sourceRoot":"","sources":["../src/pointerSelectionPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAIzG,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,gBAAgB,EAC3E,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,GAAG,EAAE,QAAQ,GAAG,IAAI,EACpB,SAAS,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAC1C,IAAI,CAoBN;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,SAAS,gBAAgB,EAC7E,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,GAAG,EAAE,QAAQ,GAAG,IAAI,EACpB,SAAS,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAC3C,OAAO,EAAE,OAAO,GACf,IAAI,CAGN"}

package/dist/pointerSelectionPolicy.js

@@ -0,0 +1,35 @@
+import { addNodeToSelection, clearSelection, isNodeSelected, selectNode, toggleNodeSelection } from './selectionState';
+export function applyPointerSelectionPolicy(state, hit, modifiers) {
+    // Alt is carried so callers can layer an alternate-pick policy on top. The base selection policy
+    // does not give it an implicit mutation that the caller cannot distinguish from an ordinary click.
+    if (modifiers.altKey)
+        return;
+    if (hit === null) {
+        if (!hasToggleModifier(modifiers))
+            clearSelection(state);
+        return;
+    }
+    if (hasToggleModifier(modifiers)) {
+        if (modifiers.shiftKey && !isNodeSelected(state, hit)) {
+            addNodeToSelection(state, hit);
+        }
+        else {
+            toggleNodeSelection(state, hit);
+        }
+        return;
+    }
+    if (!isNodeSelected(state, hit))
+        selectNode(state, hit);
+}
+export function applyPointerUpSelectionPolicy(state, hit, modifiers, didDrag) {
+    if (didDrag || hit === null || hasAnyModifier(modifiers) || !isNodeSelected(state, hit))
+        return;
+    selectNode(state, hit);
+}
+function hasAnyModifier(modifiers) {
+    return modifiers.altKey || hasToggleModifier(modifiers);
+}
+function hasToggleModifier(modifiers) {
+    return modifiers.ctrlKey || modifiers.metaKey || modifiers.shiftKey;
+}
+//# sourceMappingURL=pointerSelectionPolicy.js.map

package/dist/pointerSelectionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointerSelectionPolicy.js","sourceRoot":"","sources":["../src/pointerSelectionPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvH,MAAM,UAAU,2BAA2B,CACzC,KAA+B,EAC/B,GAAoB,EACpB,SAA2C;IAE3C,iGAAiG;IACjG,mGAAmG;IACnG,IAAI,SAAS,CAAC,MAAM;QAAE,OAAO;IAE7B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACtD,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;QAAE,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAA+B,EAC/B,GAAoB,EACpB,SAA2C,EAC3C,OAAgB;IAEhB,IAAI,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;QAAE,OAAO;IAChG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CAAC,SAA2C;IACjE,OAAO,SAAS,CAAC,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,iBAAiB,CAAC,SAA2C;IACpE,OAAO,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC;AACtE,CAAC"}

package/dist/selectionState.d.ts

@@ -0,0 +1,15 @@
+import type { HierarchyNodeAny, SelectionSignals, SelectionState } from '@flighthq/types/contract';
+export declare function addNodeToSelection<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, node: NodeType): void;
+export declare function clearSelection<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): void;
+export declare function createSelectionState<NodeType extends HierarchyNodeAny = HierarchyNodeAny>(): SelectionState<NodeType>;
+export declare function getActiveNode<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): NodeType | null;
+export declare function getSelectedNodes<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): readonly NodeType[];
+export declare function getSelectionCount<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): number;
+export declare function getSelectionSignals<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): Readonly<SelectionSignals<NodeType>>;
+export declare function hasSelection<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>): boolean;
+export declare function isNodeSelected<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, node: NodeType): boolean;
+export declare function removeNodeFromSelection<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, node: NodeType): void;
+export declare function selectAllNodes<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, candidates: readonly NodeType[]): void;
+export declare function selectNode<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, node: NodeType): void;
+export declare function toggleNodeSelection<NodeType extends HierarchyNodeAny>(state: SelectionState<NodeType>, node: NodeType): void;
+//# sourceMappingURL=selectionState.d.ts.map

package/dist/selectionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionState.d.ts","sourceRoot":"","sources":["../src/selectionState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,gBAAgB,EAClE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,QAAQ,GACb,IAAI,CASN;AAED,wBAAgB,cAAc,CAAC,QAAQ,SAAS,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CASvG;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,KAAK,cAAc,CAAC,QAAQ,CAAC,CAcrH;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAS,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAEjH;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,gBAAgB,EAChE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAC9B,SAAS,QAAQ,EAAE,CAErB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,MAAM,CAE5G;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,gBAAgB,EACnE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAC9B,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAEtC;AAED,wBAAgB,YAAY,CAAC,QAAQ,SAAS,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,CAExG;AAED,wBAAgB,cAAc,CAAC,QAAQ,SAAS,gBAAgB,EAC9D,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,QAAQ,GACb,OAAO,CAET;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,SAAS,gBAAgB,EACvE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,QAAQ,GACb,IAAI,CAWN;AAED,wBAAgB,cAAc,CAAC,QAAQ,SAAS,gBAAgB,EAC9D,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,UAAU,EAAE,SAAS,QAAQ,EAAE,GAC9B,IAAI,CA2BN;AAED,wBAAgB,UAAU,CAAC,QAAQ,SAAS,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CASnH;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,gBAAgB,EACnE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,QAAQ,GACb,IAAI,CAMN"}

package/dist/selectionState.js

@@ -0,0 +1,125 @@
+import { createSignal, emitSignal } from '@flighthq/signals/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+export function addNodeToSelection(state, node) {
+    const runtime = getSelectionStateRuntime(state);
+    if (runtime.selectedNodeSet.has(node))
+        return;
+    const previousActiveNode = runtime.activeNode;
+    runtime.selectedNodes.push(node);
+    runtime.selectedNodeSet.add(node);
+    runtime.activeNode = node;
+    emitSelectionChanges(runtime, true, previousActiveNode);
+}
+export function clearSelection(state) {
+    const runtime = getSelectionStateRuntime(state);
+    if (runtime.selectedNodes.length === 0)
+        return;
+    const previousActiveNode = runtime.activeNode;
+    runtime.selectedNodes = [];
+    runtime.selectedNodeSet = new Set();
+    runtime.activeNode = null;
+    emitSelectionChanges(runtime, true, previousActiveNode);
+}
+export function createSelectionState() {
+    const state = { [EntityRuntimeKey]: undefined };
+    const runtime = {
+        activeNode: null,
+        binding: null,
+        selectedNodeSet: new Set(),
+        selectedNodes: [],
+        signals: {
+            onActiveChange: createSignal(),
+            onChange: createSignal(),
+        },
+    };
+    state[EntityRuntimeKey] = runtime;
+    return state;
+}
+export function getActiveNode(state) {
+    return getSelectionStateRuntime(state).activeNode;
+}
+export function getSelectedNodes(state) {
+    return getSelectionStateRuntime(state).selectedNodes;
+}
+export function getSelectionCount(state) {
+    return getSelectionStateRuntime(state).selectedNodes.length;
+}
+export function getSelectionSignals(state) {
+    return getSelectionStateRuntime(state).signals;
+}
+export function hasSelection(state) {
+    return getSelectionStateRuntime(state).selectedNodes.length !== 0;
+}
+export function isNodeSelected(state, node) {
+    return getSelectionStateRuntime(state).selectedNodeSet.has(node);
+}
+export function removeNodeFromSelection(state, node) {
+    const runtime = getSelectionStateRuntime(state);
+    if (!runtime.selectedNodeSet.has(node))
+        return;
+    const previousActiveNode = runtime.activeNode;
+    runtime.selectedNodeSet.delete(node);
+    runtime.selectedNodes.splice(runtime.selectedNodes.indexOf(node), 1);
+    if (runtime.activeNode === node) {
+        runtime.activeNode = runtime.selectedNodes[runtime.selectedNodes.length - 1] ?? null;
+    }
+    emitSelectionChanges(runtime, true, previousActiveNode);
+}
+export function selectAllNodes(state, candidates) {
+    const runtime = getSelectionStateRuntime(state);
+    const selectedNodeSet = new Set();
+    const selectedNodes = [];
+    for (let i = 0; i < candidates.length; i++) {
+        const candidate = candidates[i];
+        if (selectedNodeSet.has(candidate))
+            continue;
+        selectedNodeSet.add(candidate);
+        selectedNodes.push(candidate);
+    }
+    let selectionChanged = runtime.selectedNodes.length !== selectedNodes.length;
+    if (!selectionChanged) {
+        for (let i = 0; i < selectedNodes.length; i++) {
+            if (runtime.selectedNodes[i] !== selectedNodes[i]) {
+                selectionChanged = true;
+                break;
+            }
+        }
+    }
+    if (!selectionChanged)
+        return;
+    const previousActiveNode = runtime.activeNode;
+    runtime.selectedNodeSet = selectedNodeSet;
+    runtime.selectedNodes = selectedNodes;
+    runtime.activeNode = selectedNodes[selectedNodes.length - 1] ?? null;
+    emitSelectionChanges(runtime, true, previousActiveNode);
+}
+export function selectNode(state, node) {
+    const runtime = getSelectionStateRuntime(state);
+    if (runtime.selectedNodes.length === 1 && runtime.selectedNodes[0] === node)
+        return;
+    const previousActiveNode = runtime.activeNode;
+    runtime.selectedNodeSet = new Set([node]);
+    runtime.selectedNodes = [node];
+    runtime.activeNode = node;
+    emitSelectionChanges(runtime, true, previousActiveNode);
+}
+export function toggleNodeSelection(state, node) {
+    if (isNodeSelected(state, node)) {
+        removeNodeFromSelection(state, node);
+    }
+    else {
+        addNodeToSelection(state, node);
+    }
+}
+function emitSelectionChanges(runtime, selectionChanged, previousActiveNode) {
+    if (selectionChanged && runtime.signals.onChange.data !== null) {
+        emitSignal(runtime.signals.onChange, runtime.selectedNodes.slice());
+    }
+    if (previousActiveNode !== runtime.activeNode) {
+        emitSignal(runtime.signals.onActiveChange, runtime.activeNode);
+    }
+}
+function getSelectionStateRuntime(state) {
+    return state[EntityRuntimeKey];
+}
+//# sourceMappingURL=selectionState.js.map

package/dist/selectionState.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@flighthq/selection",
+  "version": "0.4.1-edge.28.7f8e221",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/selection"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/geometry": "0.4.1-edge.28.7f8e221",
+    "@flighthq/node": "0.4.1-edge.28.7f8e221",
+    "@flighthq/signals": "0.4.1-edge.28.7f8e221",
+    "@flighthq/types": "0.4.1-edge.28.7f8e221"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Ordered scene-graph selection state and geometric selection queries",
+  "sideEffects": false
+}

package/src/lassoSelection.test.ts

@@ -0,0 +1,114 @@
+import { createNode, createNodeRuntime, initBoundsRectangleRuntimeTrait } from '@flighthq/node/contract';
+import type { BoundsNodeAny, HasBoundsRectangleRuntime, NodeRuntime, RectangleLike } from '@flighthq/types/contract';
+import { PathCommand } from '@flighthq/types/contract';
+
+import {
+  addLassoSelectionPoint,
+  beginLassoSelection,
+  createLassoSelection,
+  endLassoSelection,
+  findNodesInLassoSelection,
+  getLassoSelectionPath,
+} from './index';
+
+describe('addLassoSelectionPoint', () => {
+  it('appends line points only during an active gesture', () => {
+    const lasso = createLassoSelection();
+    addLassoSelectionPoint(lasso, 99, 99);
+    beginLassoSelection(lasso, 1, 2);
+    addLassoSelectionPoint(lasso, 3, 4);
+    endLassoSelection(lasso);
+    addLassoSelectionPoint(lasso, 5, 6);
+
+    expect(getLassoSelectionPath(lasso).data).toEqual([1, 2, 3, 4]);
+  });
+});
+
+describe('beginLassoSelection', () => {
+  it('resets the reused path and starts it with a move command', () => {
+    const lasso = createLassoSelection();
+    beginLassoSelection(lasso, 1, 2);
+    addLassoSelectionPoint(lasso, 3, 4);
+    endLassoSelection(lasso);
+
+    beginLassoSelection(lasso, 10, 11);
+
+    expect(getLassoSelectionPath(lasso).commands).toEqual([PathCommand.MOVE_TO]);
+    expect(getLassoSelectionPath(lasso).data).toEqual([10, 11]);
+  });
+});
+
+describe('createLassoSelection', () => {
+  it('creates an empty even-odd path', () => {
+    const path = getLassoSelectionPath(createLassoSelection());
+
+    expect(path).toMatchObject({ commands: [], data: [], winding: 'evenOdd' });
+  });
+});
+
+describe('endLassoSelection', () => {
+  it('closes an active path once and returns the live path object', () => {
+    const lasso = createLassoSelection();
+    beginLassoSelection(lasso, 1, 2);
+    addLassoSelectionPoint(lasso, 3, 4);
+
+    const path = endLassoSelection(lasso);
+    endLassoSelection(lasso);
+
+    expect(path).toBe(getLassoSelectionPath(lasso));
+    expect(path.commands).toEqual([PathCommand.MOVE_TO, PathCommand.LINE_TO, PathCommand.CLOSE]);
+  });
+});
+
+describe('findNodesInLassoSelection', () => {
+  it('selects bounds centers inside or on the lasso boundary in caller order', () => {
+    const lasso = createLassoSelection();
+    beginLassoSelection(lasso, 0, 0);
+    addLassoSelectionPoint(lasso, 10, 0);
+    addLassoSelectionPoint(lasso, 10, 10);
+    addLassoSelectionPoint(lasso, 0, 10);
+    endLassoSelection(lasso);
+    const inside = createBoundedNode('inside', { x: 4, y: 4, width: 2, height: 2 });
+    const boundary = createBoundedNode('boundary', { x: 9, y: 4, width: 2, height: 2 });
+    const outside = createBoundedNode('outside', { x: 11, y: 11, width: 2, height: 2 });
+
+    expect(findNodesInLassoSelection(lasso, [outside, boundary, inside])).toEqual([boundary, inside]);
+  });
+
+  it('returns no candidates for a path with fewer than three points', () => {
+    const lasso = createLassoSelection();
+    beginLassoSelection(lasso, 0, 0);
+    addLassoSelectionPoint(lasso, 10, 0);
+    endLassoSelection(lasso);
+
+    expect(findNodesInLassoSelection(lasso, [createBoundedNode('node', { x: 0, y: 0, width: 1, height: 1 })])).toEqual(
+      [],
+    );
+  });
+});
+
+describe('getLassoSelectionPath', () => {
+  it('exposes the same path throughout a gesture', () => {
+    const lasso = createLassoSelection();
+    const path = getLassoSelectionPath(lasso);
+
+    beginLassoSelection(lasso, 1, 2);
+
+    expect(getLassoSelectionPath(lasso)).toBe(path);
+  });
+});
+
+function createBoundedNode(name: string, rectangle: Readonly<RectangleLike>): BoundsNodeAny {
+  return createNode('SelectionBoundsTestNode', { name }, undefined, () => {
+    const runtime = createNodeRuntime() as NodeRuntime & HasBoundsRectangleRuntime;
+    initBoundsRectangleRuntimeTrait(runtime, {
+      computeLocalBoundsRectangle(out) {
+        out.x = rectangle.x;
+        out.y = rectangle.y;
+        out.width = rectangle.width;
+        out.height = rectangle.height;
+      },
+    });
+    return runtime;
+  }) as BoundsNodeAny;
+}

package/src/marqueeSelection.test.ts

@@ -0,0 +1,94 @@
+import { createNode, createNodeRuntime, initBoundsRectangleRuntimeTrait } from '@flighthq/node/contract';
+import type { BoundsNodeAny, HasBoundsRectangleRuntime, NodeRuntime, RectangleLike } from '@flighthq/types/contract';
+
+import {
+  beginMarqueeSelection,
+  createMarqueeSelection,
+  endMarqueeSelection,
+  findNodesInMarqueeSelection,
+  getMarqueeRectangle,
+  updateMarqueeSelection,
+} from './index';
+
+describe('beginMarqueeSelection', () => {
+  it('starts a new zero-area rectangle at the pointer location', () => {
+    const marquee = createMarqueeSelection();
+    beginMarqueeSelection(marquee, 10, 20);
+
+    expect(getMarqueeRectangle(marquee)).toMatchObject({ x: 10, y: 20, width: 0, height: 0 });
+  });
+});
+
+describe('createMarqueeSelection', () => {
+  it('creates an inactive marquee with an empty rectangle', () => {
+    const marquee = createMarqueeSelection();
+
+    updateMarqueeSelection(marquee, 100, 100);
+    expect(getMarqueeRectangle(marquee)).toMatchObject({ x: 0, y: 0, width: 0, height: 0 });
+  });
+});
+
+describe('endMarqueeSelection', () => {
+  it('returns the live rectangle and makes later updates inert', () => {
+    const marquee = createMarqueeSelection();
+    beginMarqueeSelection(marquee, 1, 2);
+    updateMarqueeSelection(marquee, 3, 4);
+
+    const rectangle = endMarqueeSelection(marquee);
+    updateMarqueeSelection(marquee, 50, 50);
+
+    expect(rectangle).toBe(getMarqueeRectangle(marquee));
+    expect(rectangle).toMatchObject({ x: 1, y: 2, width: 2, height: 2 });
+  });
+});
+
+describe('findNodesInMarqueeSelection', () => {
+  it('finds intersecting or fully contained bounds in caller order', () => {
+    const marquee = createMarqueeSelection();
+    beginMarqueeSelection(marquee, 0, 0);
+    updateMarqueeSelection(marquee, 10, 10);
+    const contained = createBoundedNode('contained', { x: 2, y: 2, width: 2, height: 2 });
+    const overlapping = createBoundedNode('overlapping', { x: 8, y: 8, width: 5, height: 5 });
+    const outside = createBoundedNode('outside', { x: 20, y: 20, width: 1, height: 1 });
+
+    expect(findNodesInMarqueeSelection(marquee, [overlapping, outside, contained])).toEqual([overlapping, contained]);
+    expect(findNodesInMarqueeSelection(marquee, [overlapping, outside, contained], 'contain')).toEqual([contained]);
+  });
+});
+
+describe('getMarqueeRectangle', () => {
+  it('exposes the same rectangle throughout a gesture', () => {
+    const marquee = createMarqueeSelection();
+    const rectangle = getMarqueeRectangle(marquee);
+
+    beginMarqueeSelection(marquee, 4, 5);
+
+    expect(getMarqueeRectangle(marquee)).toBe(rectangle);
+  });
+});
+
+describe('updateMarqueeSelection', () => {
+  it('normalizes a reverse drag into positive rectangle dimensions', () => {
+    const marquee = createMarqueeSelection();
+    beginMarqueeSelection(marquee, 10, 20);
+
+    updateMarqueeSelection(marquee, 2, 5);
+
+    expect(getMarqueeRectangle(marquee)).toMatchObject({ x: 2, y: 5, width: 8, height: 15 });
+  });
+});
+
+function createBoundedNode(name: string, rectangle: Readonly<RectangleLike>): BoundsNodeAny {
+  return createNode('SelectionBoundsTestNode', { name }, undefined, () => {
+    const runtime = createNodeRuntime() as NodeRuntime & HasBoundsRectangleRuntime;
+    initBoundsRectangleRuntimeTrait(runtime, {
+      computeLocalBoundsRectangle(out) {
+        out.x = rectangle.x;
+        out.y = rectangle.y;
+        out.width = rectangle.width;
+        out.height = rectangle.height;
+      },
+    });
+    return runtime;
+  }) as BoundsNodeAny;
+}

package/src/pointerSelectionPolicy.test.ts

@@ -0,0 +1,86 @@
+import { createNode } from '@flighthq/node/contract';
+import type { HierarchyNodeAny, SelectionModifierState } from '@flighthq/types/contract';
+import { describe, expect, it } from 'vitest';
+
+import {
+  applyPointerSelectionPolicy,
+  applyPointerUpSelectionPolicy,
+  createSelectionState,
+  getSelectedNodes,
+  selectAllNodes,
+} from './index';
+
+describe('applyPointerSelectionPolicy', () => {
+  it('applies unmodified hit and empty-space behavior', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [first, second]);
+
+    applyPointerSelectionPolicy(selection, first, modifiers());
+    expect(getSelectedNodes(selection)).toEqual([first, second]);
+
+    const third = createTestNode('third');
+    applyPointerSelectionPolicy(selection, third, modifiers());
+    expect(getSelectedNodes(selection)).toEqual([third]);
+
+    applyPointerSelectionPolicy(selection, null, modifiers());
+    expect(getSelectedNodes(selection)).toEqual([]);
+  });
+
+  it('adds or removes with Shift and toggles with Ctrl or Command', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+
+    applyPointerSelectionPolicy(selection, first, modifiers({ shiftKey: true }));
+    expect(getSelectedNodes(selection)).toEqual([first]);
+    applyPointerSelectionPolicy(selection, first, modifiers({ shiftKey: true }));
+    expect(getSelectedNodes(selection)).toEqual([]);
+
+    applyPointerSelectionPolicy(selection, first, modifiers({ ctrlKey: true }));
+    applyPointerSelectionPolicy(selection, second, modifiers({ metaKey: true }));
+    expect(getSelectedNodes(selection)).toEqual([first, second]);
+    applyPointerSelectionPolicy(selection, first, modifiers({ metaKey: true }));
+    expect(getSelectedNodes(selection)).toEqual([second]);
+
+    applyPointerSelectionPolicy(selection, null, modifiers({ ctrlKey: true }));
+    expect(getSelectedNodes(selection)).toEqual([second]);
+  });
+
+  it('leaves Alt gestures available for caller-defined alternate-pick behavior', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [first]);
+
+    applyPointerSelectionPolicy(selection, second, modifiers({ altKey: true }));
+    applyPointerSelectionPolicy(selection, null, modifiers({ altKey: true }));
+
+    expect(getSelectedNodes(selection)).toEqual([first]);
+  });
+});
+
+describe('applyPointerUpSelectionPolicy', () => {
+  it('narrows an already-selected hit only on an unmodified pointer-up without a drag', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [first, second]);
+
+    applyPointerUpSelectionPolicy(selection, first, modifiers(), true);
+    applyPointerUpSelectionPolicy(selection, first, modifiers({ shiftKey: true }), false);
+    expect(getSelectedNodes(selection)).toEqual([first, second]);
+
+    applyPointerUpSelectionPolicy(selection, first, modifiers(), false);
+    expect(getSelectedNodes(selection)).toEqual([first]);
+  });
+});
+
+function createTestNode(name: string): HierarchyNodeAny {
+  return createNode('SelectionTestNode', { name });
+}
+
+function modifiers(overrides?: Partial<SelectionModifierState>): SelectionModifierState {
+  return { altKey: false, ctrlKey: false, metaKey: false, shiftKey: false, ...overrides };
+}

package/src/selectionState.test.ts

@@ -0,0 +1,199 @@
+import { addNodeChild, createNode } from '@flighthq/node/contract';
+import { connectSignal } from '@flighthq/signals/contract';
+import type { HierarchyNodeAny, Node3D, SelectionState } from '@flighthq/types/contract';
+
+import {
+  addNodeToSelection,
+  clearSelection,
+  createSelectionState,
+  getActiveNode,
+  getSelectedNodes,
+  getSelectionCount,
+  getSelectionSignals,
+  hasSelection,
+  isNodeSelected,
+  removeNodeFromSelection,
+  selectAllNodes,
+  selectNode,
+  toggleNodeSelection,
+} from './index';
+
+describe('addNodeToSelection', () => {
+  it('adds in order, makes the new node active, and ignores duplicates', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+
+    addNodeToSelection(selection, first);
+    addNodeToSelection(selection, second);
+    addNodeToSelection(selection, first);
+
+    expect(getSelectedNodes(selection)).toEqual([first, second]);
+    expect(getActiveNode(selection)).toBe(second);
+  });
+});
+
+describe('clearSelection', () => {
+  it('empties the selected set and clears the active node', () => {
+    const selection = createSelectionState();
+    selectNode(selection, createTestNode('node'));
+
+    clearSelection(selection);
+
+    expect(getSelectedNodes(selection)).toEqual([]);
+    expect(getActiveNode(selection)).toBeNull();
+  });
+});
+
+describe('createSelectionState', () => {
+  it('creates empty state that accepts any hierarchy graph family', () => {
+    const selection = createSelectionState();
+
+    expect(getSelectedNodes(selection)).toEqual([]);
+    expectTypeOf(createSelectionState<Node3D>()).toMatchTypeOf<SelectionState<Node3D>>();
+  });
+});
+
+describe('getActiveNode', () => {
+  it('returns the most recently selected remaining node', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [first, second]);
+
+    removeNodeFromSelection(selection, second);
+
+    expect(getActiveNode(selection)).toBe(first);
+  });
+});
+
+describe('getSelectedNodes', () => {
+  it('returns the ordered selected identities', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [second, first]);
+
+    expect(getSelectedNodes(selection)).toEqual([second, first]);
+  });
+});
+
+describe('getSelectionCount', () => {
+  it('returns the selected identity count', () => {
+    const selection = createSelectionState();
+    selectAllNodes(selection, [createTestNode('first'), createTestNode('second')]);
+
+    expect(getSelectionCount(selection)).toBe(2);
+  });
+});
+
+describe('getSelectionSignals', () => {
+  it('emits snapshots after finalizing state and suppresses no-op emissions', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+    const changes: (readonly HierarchyNodeAny[])[] = [];
+    const onChange = vi.fn((selected: readonly HierarchyNodeAny[]) => {
+      changes.push(selected);
+      expect(getSelectedNodes(selection)).toEqual(selected);
+    });
+    const onActiveChange = vi.fn();
+    const signals = getSelectionSignals(selection);
+    connectSignal(signals.onChange, onChange);
+    connectSignal(signals.onActiveChange, onActiveChange);
+
+    addNodeToSelection(selection, first);
+    addNodeToSelection(selection, first);
+    addNodeToSelection(selection, second);
+    removeNodeFromSelection(selection, first);
+    clearSelection(selection);
+    clearSelection(selection);
+
+    expect(onChange).toHaveBeenCalledTimes(4);
+    expect(onActiveChange).toHaveBeenCalledTimes(3);
+    expect(changes).toEqual([[first], [first, second], [second], []]);
+    expect(changes[1]).not.toBe(getSelectedNodes(selection));
+  });
+});
+
+describe('hasSelection', () => {
+  it('reports whether any identity is selected', () => {
+    const selection = createSelectionState();
+    expect(hasSelection(selection)).toBe(false);
+
+    selectNode(selection, createTestNode('node'));
+    expect(hasSelection(selection)).toBe(true);
+  });
+});
+
+describe('isNodeSelected', () => {
+  it('checks selection by node identity', () => {
+    const selected = createTestNode('selected');
+    const unselected = createTestNode('unselected');
+    const selection = createSelectionState();
+    selectNode(selection, selected);
+
+    expect(isNodeSelected(selection, selected)).toBe(true);
+    expect(isNodeSelected(selection, unselected)).toBe(false);
+  });
+});
+
+describe('removeNodeFromSelection', () => {
+  it('preserves an unrelated active node and ignores absent identities', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const absent = createTestNode('absent');
+    const selection = createSelectionState();
+    selectAllNodes(selection, [first, second]);
+
+    removeNodeFromSelection(selection, first);
+    removeNodeFromSelection(selection, absent);
+
+    expect(getSelectedNodes(selection)).toEqual([second]);
+    expect(getActiveNode(selection)).toBe(second);
+  });
+});
+
+describe('selectAllNodes', () => {
+  it('de-duplicates candidates in caller order and makes the last unique node active', () => {
+    const first = createTestNode('first');
+    const second = createTestNode('second');
+    const selection = createSelectionState();
+
+    selectAllNodes(selection, [second, first, second]);
+
+    expect(getSelectedNodes(selection)).toEqual([second, first]);
+    expect(getActiveNode(selection)).toBe(first);
+  });
+});
+
+describe('selectNode', () => {
+  it('replaces selection without recursively selecting descendants', () => {
+    const group = createTestNode('group');
+    const child = createTestNode('child');
+    addNodeChild(group, child);
+    const selection = createSelectionState();
+    selectNode(selection, child);
+
+    selectNode(selection, group);
+
+    expect(getSelectedNodes(selection)).toEqual([group]);
+    expect(isNodeSelected(selection, child)).toBe(false);
+  });
+});
+
+describe('toggleNodeSelection', () => {
+  it('adds an absent identity and removes a selected identity', () => {
+    const node = createTestNode('node');
+    const selection = createSelectionState();
+
+    toggleNodeSelection(selection, node);
+    expect(isNodeSelected(selection, node)).toBe(true);
+    toggleNodeSelection(selection, node);
+    expect(isNodeSelected(selection, node)).toBe(false);
+  });
+});
+
+function createTestNode(name: string): HierarchyNodeAny {
+  return createNode('SelectionTestNode', { name });
+}