@dxos/react-ui-attention 0.7.5-labs.e27f9b9 → 0.7.5-labs.ea4b4c2

package/dist/lib/node-esm/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytes":16177,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":10623,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":20134,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"../attention"}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":644,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":597,"imports":[{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"./attention"},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytes":1386,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"../../components"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytes":534,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts","kind":"import-statement","original":"./withAttention"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytes":516,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/index.ts","kind":"import-statement","original":"./decorators"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ARQ2A5DK.mjs","kind":"import-statement"}],"exports":["ATTENABLE_ATTRIBUTE","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0}},"bytes":831},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":698},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ARQ2A5DK.mjs","kind":"import-statement"},{"path":"react","kind":"import-statement","external":true}],"exports":["withAttention"],"entryPoint":"packages/ui/react-ui-attention/src/testing/index.ts","inputs":{"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytesInOutput":164},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytesInOutput":0}},"bytes":459},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ARQ2A5DK.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":23358},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ARQ2A5DK.mjs":{"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"exports":["ATTENABLE_ATTRIBUTE","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath"],"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytesInOutput":3558},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":3212},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":3282},"packages/ui/react-ui-attention/src/components/index.ts":{"bytesInOutput":0}},"bytes":10720}}}
+{"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytes":16177,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":10623,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":20134,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"../attention"}],"format":"esm"},"packages/ui/react-ui-attention/src/selection.ts":{"bytes":5559,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytes":6312,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"../selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":757,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"},{"path":"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx","kind":"import-statement","original":"./SelectionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":690,"imports":[{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"./attention"},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"./selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytes":1386,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"../../components"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytes":534,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts","kind":"import-statement","original":"./withAttention"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytes":516,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/index.ts","kind":"import-statement","original":"./decorators"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-RUECHK2Y.mjs","kind":"import-statement"}],"exports":["ATTENABLE_ATTRIBUTE","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelectedItems","useSelectionActions"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0}},"bytes":999},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":698},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-RUECHK2Y.mjs","kind":"import-statement"},{"path":"react","kind":"import-statement","external":true}],"exports":["withAttention"],"entryPoint":"packages/ui/react-ui-attention/src/testing/index.ts","inputs":{"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytesInOutput":164},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytesInOutput":0}},"bytes":459},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-RUECHK2Y.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":29499},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-RUECHK2Y.mjs":{"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true}],"exports":["ATTENABLE_ATTRIBUTE","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelectedItems","useSelectionActions"],"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytesInOutput":3558},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":3212},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":3282},"packages/ui/react-ui-attention/src/selection.ts":{"bytesInOutput":1199},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytesInOutput":1491},"packages/ui/react-ui-attention/src/components/index.ts":{"bytesInOutput":0}},"bytes":13618}}}

package/dist/lib/node-esm/testing/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   RootAttentionProvider
-} from "../chunk-ARQ2A5DK.mjs";
+} from "../chunk-RUECHK2Y.mjs";
 
 // packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts
 import { createElement } from "react";

package/dist/types/src/components/SelectionProvider.d.ts

@@ -0,0 +1,13 @@
+import { type PropsWithChildren } from 'react';
+import React from 'react';
+import { SelectionManager } from '../selection';
+export declare const SelectionProvider: ({ children, selection: propsSelection, }: PropsWithChildren<{
+    selection?: SelectionManager;
+}>) => React.JSX.Element;
+export declare const useSelectedItems: (contextId: string) => Set<string>;
+export declare const useSelectionActions: (contextId?: string) => {
+    select: (ids: string[]) => Set<unknown> | undefined;
+    toggle: (id: string) => Set<unknown> | undefined;
+    clear: () => void;
+};
+//# sourceMappingURL=SelectionProvider.d.ts.map

package/dist/types/src/components/SelectionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/SelectionProvider.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAYhD,eAAO,MAAM,iBAAiB,6CAG3B,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,sBAGrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,cAAe,MAAM,KAAG,GAAG,CAAC,MAAM,CAG9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAAgB,MAAM;kBAI5C,MAAM,EAAE;iBAUT,MAAM;;CAiBd,CAAC"}

package/dist/types/src/components/index.d.ts

@@ -1,3 +1,4 @@
 export * from './AttentionGlyph';
 export * from './AttentionProvider';
+export * from './SelectionProvider';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,3 +1,4 @@
 export * from './attention';
 export * from './components';
+export * from './selection';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/src/selection.d.ts

@@ -0,0 +1,15 @@
+import { type ReactiveObject } from '@dxos/live-object';
+/**
+ * Manages selection state for different contexts.
+ * Each context maintains its own list of selected IDs.
+ */
+export declare class SelectionManager {
+    private readonly _state;
+    constructor(initial?: Record<string, Set<string>>);
+    get selections(): ReactiveObject<Record<string, Set<string>>>;
+    getSelection(contextId: string): Set<string>;
+    updateSelection(contextId: string, selectedIds: Set<string> | string[]): void;
+    clearSelection(contextId: string): void;
+    toggleSelection(contextId: string, id: string): void;
+}
+//# sourceMappingURL=selection.d.ts.map

package/dist/types/src/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/selection.ts"],"names":[],"mappings":"AAMA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2E;gBAEtF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAM;IAQrD,IAAI,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAE5D;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAS5C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAMtE,cAAc,CAAC,SAAS,EAAE,MAAM;IAMhC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAU9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/react-ui-attention",
-  "version": "0.7.5-labs.e27f9b9",
+  "version": "0.7.5-labs.ea4b4c2",
   "description": "Signifier components and providers for attention system.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -40,9 +40,9 @@
     "@radix-ui/react-primitive": "2.0.2",
     "@radix-ui/react-slot": "1.1.2",
     "@radix-ui/react-use-controllable-state": "1.1.0",
-    "@dxos/echo-schema": "0.7.5-labs.e27f9b9",
-    "@dxos/live-object": "0.7.5-labs.e27f9b9",
-    "@dxos/util": "0.7.5-labs.e27f9b9"
+    "@dxos/live-object": "0.7.5-labs.ea4b4c2",
+    "@dxos/echo-schema": "0.7.5-labs.ea4b4c2",
+    "@dxos/util": "0.7.5-labs.ea4b4c2"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -51,18 +51,18 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/app-graph": "0.7.5-labs.e27f9b9",
-    "@dxos/random": "0.7.5-labs.e27f9b9",
-    "@dxos/react-ui": "0.7.5-labs.e27f9b9",
-    "@dxos/react-ui-theme": "0.7.5-labs.e27f9b9",
-    "@dxos/storybook-utils": "0.7.5-labs.e27f9b9"
+    "@dxos/app-graph": "0.7.5-labs.ea4b4c2",
+    "@dxos/random": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-theme": "0.7.5-labs.ea4b4c2",
+    "@dxos/storybook-utils": "0.7.5-labs.ea4b4c2"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.5-labs.e27f9b9",
-    "@dxos/react-ui-theme": "0.7.5-labs.e27f9b9"
+    "@dxos/react-ui": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-theme": "0.7.5-labs.ea4b4c2"
   },
   "publishConfig": {
     "access": "public"

package/src/components/SelectionProvider.tsx

@@ -0,0 +1,67 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { createContext } from '@radix-ui/react-context';
+import { useCallback, type PropsWithChildren } from 'react';
+import React from 'react';
+
+import { useDefaultValue } from '@dxos/react-ui';
+
+import { SelectionManager } from '../selection';
+
+const SELECTION_NAME = 'Selection';
+
+type SelectionContextValue = {
+  selection: SelectionManager;
+};
+
+const [SelectionContextProvider, useSelectionContext] = createContext<SelectionContextValue>(SELECTION_NAME, {
+  selection: new SelectionManager(),
+});
+
+export const SelectionProvider = ({
+  children,
+  selection: propsSelection,
+}: PropsWithChildren<{ selection?: SelectionManager }>) => {
+  const selection = useDefaultValue(propsSelection, () => new SelectionManager());
+  return <SelectionContextProvider selection={selection}>{children}</SelectionContextProvider>;
+};
+
+export const useSelectedItems = (contextId: string): Set<string> => {
+  const { selection } = useSelectionContext(SELECTION_NAME);
+  return selection.getSelection(contextId);
+};
+
+export const useSelectionActions = (contextId?: string) => {
+  const { selection } = useSelectionContext(SELECTION_NAME);
+
+  const select = useCallback(
+    (ids: string[]) => {
+      if (!contextId) {
+        return new Set();
+      }
+      selection.updateSelection(contextId, ids);
+    },
+    [selection, contextId],
+  );
+
+  const toggle = useCallback(
+    (id: string) => {
+      if (!contextId) {
+        return new Set();
+      }
+      selection.toggleSelection(contextId, id);
+    },
+    [selection, contextId],
+  );
+
+  const clear = useCallback(() => {
+    if (!contextId) {
+      return;
+    }
+    selection.clearSelection(contextId);
+  }, [selection, contextId]);
+
+  return { select, toggle, clear };
+};

package/src/components/index.ts

@@ -4,3 +4,4 @@
 
 export * from './AttentionGlyph';
 export * from './AttentionProvider';
+export * from './SelectionProvider';

package/src/index.ts

@@ -4,3 +4,4 @@
 
 export * from './attention';
 export * from './components';
+export * from './selection';

package/src/selection.ts

@@ -0,0 +1,59 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { untracked } from '@preact/signals-core';
+
+import { create, type ReactiveObject } from '@dxos/live-object';
+
+/**
+ * Manages selection state for different contexts.
+ * Each context maintains its own list of selected IDs.
+ */
+export class SelectionManager {
+  private readonly _state = create<{ selections: Record<string, Set<string>> }>({ selections: {} });
+
+  constructor(initial: Record<string, Set<string>> = {}) {
+    if (Object.keys(initial).length > 0) {
+      untracked(() => {
+        this._state.selections = initial;
+      });
+    }
+  }
+
+  get selections(): ReactiveObject<Record<string, Set<string>>> {
+    return this._state.selections;
+  }
+
+  getSelection(contextId: string): Set<string> {
+    if (!this.selections[contextId]) {
+      untracked(() => {
+        this._state.selections[contextId] = new Set();
+      });
+    }
+    return this.selections[contextId];
+  }
+
+  updateSelection(contextId: string, selectedIds: Set<string> | string[]) {
+    untracked(() => {
+      this._state.selections[contextId] = selectedIds instanceof Set ? selectedIds : new Set(selectedIds);
+    });
+  }
+
+  clearSelection(contextId: string) {
+    untracked(() => {
+      this._state.selections[contextId] = new Set();
+    });
+  }
+
+  toggleSelection(contextId: string, id: string) {
+    untracked(() => {
+      const current = this.getSelection(contextId);
+      if (current.has(id)) {
+        current.delete(id);
+      } else {
+        current.add(id);
+      }
+    });
+  }
+}