@dxos/plugin-deck 0.8.3-staging.0fa589b → 0.8.4-main.03d5cd7b56

package/dist/lib/neutral/components/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/index.ts", "../../../../src/components/Matrix/Matrix.tsx"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const DeckSettings: ComponentType<any> = lazy(() => import('./DeckSettings'));\n\nexport { Matrix } from './Matrix';\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { useFocusFinders } from '@fluentui/react-tabster';\nimport { createContext } from '@radix-ui/react-context';\nimport React, { forwardRef, type PropsWithChildren, useCallback, useEffect, useImperativeHandle, useRef } from 'react';\n\nimport { Obj } from '@dxos/echo';\nimport { ScrollArea } from '@dxos/react-ui';\nimport { useAttended } from '@dxos/react-ui-attention';\nimport { type MosaicStackTileComponent, Mosaic } from '@dxos/react-ui-mosaic';\nimport { composable, composableProps } from '@dxos/ui-theme';\nimport { type ComposableProps } from '@dxos/ui-types';\n\n//\n// Context\n//\n\nconst MATRIX_NAME = 'Matrix';\n\ntype MatrixContextValue = {\n  /** Items to render. */\n  items: Obj.Any[];\n  /** Tile component to render for each item. */\n  Tile: MosaicStackTileComponent<Obj.Any>;\n  /** Currently attended tile ID. */\n  current?: Obj.ID;\n  /** Callback when the attended tile changes. */\n  onCurrentChange?: (id: Obj.ID | undefined) => void;\n  /** Register the viewport element for scroll operations. */\n  registerViewport: (element: HTMLElement | null) => void;\n};\n\nconst [MatrixProvider, useMatrixContext] = createContext<MatrixContextValue>(MATRIX_NAME);\n\n//\n// Controller\n//\n\ninterface MatrixController {\n  scrollTo: (id: Obj.ID) => void;\n}\n\n//\n// Root\n//\n\nconst MATRIX_ROOT_NAME = 'Matrix.Root';\n\ntype MatrixRootProps = PropsWithChildren<{\n  /** Items to render. */\n  items?: Obj.Any[];\n  /** Tile component to render for each item. */\n  Tile: MosaicStackTileComponent<Obj.Any>;\n  /** Currently attended tile ID. */\n  current?: Obj.ID;\n  /** Callback when the attended tile changes. */\n  onCurrentChange?: (id: Obj.ID | undefined) => void;\n}>;\n\n/**\n * Headless root that provides matrix context.\n * Syncs the attention system with `onCurrentChange` — when a tile gains attention, the callback fires.\n */\nconst MatrixRoot = forwardRef<MatrixController, MatrixRootProps>(\n  ({ children, items = [], Tile, current, onCurrentChange }, forwardedRef) => {\n    const viewportRef = useRef<HTMLElement | null>(null);\n    const registerViewport = useCallback((element: HTMLElement | null) => {\n      viewportRef.current = element;\n    }, []);\n\n    const { findFirstFocusable } = useFocusFinders();\n    const findFirstFocusableRef = useRef(findFirstFocusable);\n    findFirstFocusableRef.current = findFirstFocusable;\n\n    // Sync attention system with current tile.\n    const attended = useAttended();\n    const itemIds = useRef(new Set<string>());\n    useEffect(() => {\n      itemIds.current = new Set(items.map((item) => item.id));\n    }, [items]);\n\n    useEffect(() => {\n      // Find the first attended ID that matches an item.\n      const matchedId = attended.find((id) => itemIds.current.has(id));\n      if (matchedId !== current) {\n        onCurrentChange?.(matchedId);\n      }\n    }, [attended, current, onCurrentChange]);\n\n    useImperativeHandle(forwardedRef, () => ({\n      scrollTo: (id) => {\n        const viewport = viewportRef.current;\n        if (!viewport) {\n          return;\n        }\n\n        const tile = viewport.querySelector<HTMLElement>(`[data-object-id=\"${CSS.escape(id)}\"]`);\n        if (!tile) {\n          return;\n        }\n\n        // Focus first focusable element so attention updates immediately, then scroll.\n        const focusable = findFirstFocusableRef.current(tile);\n        (focusable ?? tile).focus({ preventScroll: true });\n\n        const tileRect = tile.getBoundingClientRect();\n        const viewportRect = viewport.getBoundingClientRect();\n        const offset = tileRect.left - viewportRect.left + viewport.scrollLeft;\n        if (Math.abs(offset - viewport.scrollLeft) > 1) {\n          viewport.scrollTo({ left: offset, behavior: 'smooth' });\n        }\n      },\n    }));\n\n    return (\n      <MatrixProvider\n        items={items}\n        Tile={Tile}\n        current={current}\n        onCurrentChange={onCurrentChange}\n        registerViewport={registerViewport}\n      >\n        {children}\n      </MatrixProvider>\n    );\n  },\n);\n\nMatrixRoot.displayName = MATRIX_ROOT_NAME;\n\n//\n// Content\n//\n\nconst MATRIX_CONTENT_NAME = 'Matrix.Content';\n\ntype MatrixContentProps = ComposableProps;\n\n/**\n * Styled container wrapping Mosaic.Container for drag-and-drop support.\n */\nconst MatrixContent = composable<HTMLDivElement>(({ children, ...props }, forwardedRef) => {\n  const { className, ...rest } = composableProps(props);\n  return (\n    <Mosaic.Container ref={forwardedRef} classNames={className} orientation='horizontal' {...rest}>\n      {children}\n    </Mosaic.Container>\n  );\n});\n\nMatrixContent.displayName = MATRIX_CONTENT_NAME;\n\n//\n// Viewport\n//\n\nconst MATRIX_VIEWPORT_NAME = 'Matrix.Viewport';\n\ntype MatrixViewportProps = ComposableProps;\n\nconst getId = (item: Obj.Any) => item.id;\n\n/**\n * Horizontally scrollable viewport that renders tiles from context.\n */\nconst MatrixViewport = composable<HTMLDivElement>(({ ...props }, forwardedRef) => {\n  const { items, Tile, registerViewport } = useMatrixContext(MATRIX_VIEWPORT_NAME);\n  const viewportRef = useCallback(\n    (element: HTMLElement | null) => {\n      registerViewport(element);\n    },\n    [registerViewport],\n  );\n\n  return (\n    <ScrollArea.Root orientation='horizontal' padding snap {...composableProps(props)} ref={forwardedRef}>\n      <ScrollArea.Viewport ref={viewportRef}>\n        <Mosaic.Stack\n          orientation='horizontal'\n          classNames='snap-x snap-mandatory gap-2'\n          getId={getId}\n          items={items}\n          Tile={Tile}\n          draggable={false}\n        />\n      </ScrollArea.Viewport>\n    </ScrollArea.Root>\n  );\n});\n\nMatrixViewport.displayName = MATRIX_VIEWPORT_NAME;\n\n//\n// Matrix\n//\n\nexport const Matrix = {\n  Root: MatrixRoot,\n  Content: MatrixContent,\n  Viewport: MatrixViewport,\n};\n\nexport type { MatrixController, MatrixRootProps, MatrixContentProps, MatrixViewportProps };\n"],
+  "mappings": "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",
+  "names": ["lazy", "useFocusFinders", "createContext", "React", "forwardRef", "useCallback", "useEffect", "useImperativeHandle", "useRef", "ScrollArea", "useAttended", "Mosaic", "composable", "composableProps", "MATRIX_NAME", "MatrixProvider", "useMatrixContext", "MATRIX_ROOT_NAME", "MatrixRoot", "children", "items", "Tile", "current", "onCurrentChange", "forwardedRef", "viewportRef", "registerViewport", "element", "findFirstFocusable", "findFirstFocusableRef", "attended", "itemIds", "Set", "map", "item", "id", "matchedId", "find", "has", "scrollTo", "viewport", "tile", "querySelector", "CSS", "escape", "focusable", "focus", "preventScroll", "tileRect", "getBoundingClientRect", "viewportRect", "offset", "left", "scrollLeft", "Math", "abs", "behavior", "displayName", "MATRIX_CONTENT_NAME", "MatrixContent", "props", "className", "rest", "Container", "ref", "classNames", "orientation", "MATRIX_VIEWPORT_NAME", "getId", "MatrixViewport", "Root", "padding", "snap", "Viewport", "Stack", "draggable", "Matrix", "Content", "DeckSettings", "lazy"]
+}

package/dist/lib/neutral/containers/index.mjs

@@ -0,0 +1,32 @@
+import {
+  CloseSidebarButton,
+  ComplementarySidebar,
+  Deck,
+  Plank,
+  PlankError,
+  PlankErrorFallback,
+  PlankLoading,
+  Sidebar,
+  ToggleComplementarySidebarButton,
+  ToggleSidebarButton
+} from "../chunk-4MYX2NT3.mjs";
+import "../chunk-GBIGQKYW.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/containers/index.ts
+import { lazy } from "react";
+var DeckLayout = lazy(() => import("../DeckLayout-6SICSSUF.mjs"));
+export {
+  CloseSidebarButton,
+  ComplementarySidebar,
+  Deck,
+  DeckLayout,
+  Plank,
+  PlankError,
+  PlankErrorFallback,
+  PlankLoading,
+  Sidebar,
+  ToggleComplementarySidebarButton,
+  ToggleSidebarButton
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/containers/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/containers/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport * from './Deck';\nexport * from './Plank';\nexport * from './Sidebar';\n\nexport const DeckLayout: ComponentType<any> = lazy(() => import('./DeckLayout'));\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAIA,SAA6BA,YAAY;AAMlC,IAAMC,aAAiCD,KAAK,MAAM,OAAO,4BAAA,CAAA;",
+  "names": ["lazy", "DeckLayout"]
+}

package/dist/lib/neutral/hooks/index.mjs

@@ -0,0 +1,178 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/hooks/useBreakpoints.ts
+import { useMediaQuery } from "@dxos/react-ui";
+var useBreakpoints = () => {
+  const [isNotMobile] = useMediaQuery("md");
+  const [isDesktop] = useMediaQuery("lg");
+  return isDesktop ? "desktop" : isNotMobile ? "tablet" : "mobile";
+};
+
+// src/hooks/useCompanions.ts
+import { useMemo } from "react";
+import { useAppGraph } from "@dxos/app-toolkit/ui";
+import { useConnections } from "@dxos/plugin-graph";
+import { byPosition } from "@dxos/util";
+import { PLANK_COMPANION_TYPE } from "#types";
+var useCompanions = (id) => {
+  const { graph } = useAppGraph();
+  const nodes = useConnections(graph, id, "child");
+  const companions = nodes.filter((node) => node.type === PLANK_COMPANION_TYPE);
+  return useMemo(() => companions.toSorted((a, b) => byPosition(a.properties, b.properties)), [
+    companions
+  ]);
+};
+
+// src/hooks/useDeckCompanions.ts
+import { useAppGraph as useAppGraph2 } from "@dxos/app-toolkit/ui";
+import { Node } from "@dxos/plugin-graph";
+import { useConnections as useConnections2 } from "@dxos/plugin-graph";
+import { byPosition as byPosition2 } from "@dxos/util";
+import { DECK_COMPANION_TYPE } from "#types";
+var useDeckCompanions = () => {
+  const { graph } = useAppGraph2();
+  const connections = useConnections2(graph, Node.RootId, "child");
+  const companions = connections.filter((node) => node.type === DECK_COMPANION_TYPE);
+  return companions.toSorted((a, b) => byPosition2(a.properties, b.properties));
+};
+
+// src/hooks/useDeckState.ts
+import { useAtomValue } from "@effect-atom/atom-react";
+import { useCallback, useMemo as useMemo2 } from "react";
+import { Capabilities } from "@dxos/app-framework";
+import { useCapability } from "@dxos/app-framework/ui";
+import { invariant } from "@dxos/invariant";
+import { DeckCapabilities } from "#types";
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-deck/src/hooks/useDeckState.ts";
+var useDeckState = () => {
+  const registry = useCapability(Capabilities.AtomRegistry);
+  const stateAtom = useCapability(DeckCapabilities.State);
+  const ephemeralAtom = useCapability(DeckCapabilities.EphemeralState);
+  const persistedState = useAtomValue(stateAtom);
+  const ephemeralState = useAtomValue(ephemeralAtom);
+  const deck = useMemo2(() => {
+    const deck2 = persistedState.decks[persistedState.activeDeck];
+    invariant(deck2, `Deck not found: ${persistedState.activeDeck}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 22, S: void 0, A: ["deck", "`Deck not found: ${persistedState.activeDeck}`"] });
+    return deck2;
+  }, [
+    persistedState.decks,
+    persistedState.activeDeck
+  ]);
+  const state = useMemo2(() => ({
+    ...persistedState,
+    ...ephemeralState
+  }), [
+    persistedState,
+    ephemeralState
+  ]);
+  const updateState = useCallback((fn) => {
+    registry.set(stateAtom, fn(registry.get(stateAtom)));
+  }, [
+    registry,
+    stateAtom
+  ]);
+  const updateEphemeral = useCallback((fn) => {
+    registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));
+  }, [
+    registry,
+    ephemeralAtom
+  ]);
+  return useMemo2(() => ({
+    state,
+    deck,
+    updateState,
+    updateEphemeral
+  }), [
+    state,
+    deck,
+    updateState,
+    updateEphemeral
+  ]);
+};
+
+// src/hooks/useHoistStatusbar.ts
+import { useMemo as useMemo3 } from "react";
+import { useAtomCapability } from "@dxos/app-framework/ui";
+import { useThemeContext } from "@dxos/react-ui";
+import { DeckCapabilities as DeckCapabilities2 } from "#types";
+var useHoistStatusbar = (breakpoint, layoutMode) => {
+  const { safeAreaPadding } = useThemeContext();
+  const enableStatusbar = useAtomCapability(DeckCapabilities2.Settings).enableStatusbar;
+  return useMemo3(() => {
+    return breakpoint === "desktop" && layoutMode !== "solo--fullscreen" && !!enableStatusbar && safeAreaPadding?.bottom === 0;
+  }, [
+    enableStatusbar,
+    breakpoint,
+    safeAreaPadding?.bottom,
+    layoutMode
+  ]);
+};
+
+// src/hooks/useMainSize.ts
+import { useMainContext } from "@dxos/react-ui";
+var useMainSize = () => {
+  const { navigationSidebarState, complementarySidebarState } = useMainContext("DeckPluginPlank");
+  return {
+    "data-sidebar-left-state": navigationSidebarState,
+    "data-sidebar-right-state": complementarySidebarState
+  };
+};
+
+// src/hooks/useNodeActionExpander.ts
+import { useEffect } from "react";
+import { Graph } from "@dxos/plugin-graph";
+var useNodeActionExpander = (node) => {
+  useEffect(() => {
+    if (node) {
+      const frame = requestAnimationFrame(() => {
+        const graph = Graph.getGraph(node);
+        void Graph.expand(graph, node.id, "action");
+      });
+      return () => cancelAnimationFrame(frame);
+    }
+  }, [
+    node
+  ]);
+};
+
+// src/hooks/useSelectedCompanion.ts
+import { useMemo as useMemo4 } from "react";
+import { getLinkedVariant } from "@dxos/react-ui-attention";
+var useSelectedCompanion = (companions, preferredVariant) => {
+  return useMemo4(() => {
+    if (companions.length === 0) {
+      return {
+        companionId: void 0,
+        variant: void 0
+      };
+    }
+    if (preferredVariant) {
+      const preferred = companions.find((companion) => getLinkedVariant(companion.id) === preferredVariant);
+      if (preferred) {
+        return {
+          companionId: preferred.id,
+          variant: getLinkedVariant(preferred.id)
+        };
+      }
+    }
+    const first = companions[0];
+    return {
+      companionId: first.id,
+      variant: getLinkedVariant(first.id)
+    };
+  }, [
+    companions,
+    preferredVariant
+  ]);
+};
+export {
+  useBreakpoints,
+  useCompanions,
+  useDeckCompanions,
+  useDeckState,
+  useHoistStatusbar,
+  useMainSize,
+  useNodeActionExpander,
+  useSelectedCompanion
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/hooks/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/hooks/useBreakpoints.ts", "../../../../src/hooks/useCompanions.ts", "../../../../src/hooks/useDeckCompanions.ts", "../../../../src/hooks/useDeckState.ts", "../../../../src/hooks/useHoistStatusbar.ts", "../../../../src/hooks/useMainSize.ts", "../../../../src/hooks/useNodeActionExpander.ts", "../../../../src/hooks/useSelectedCompanion.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMediaQuery } from '@dxos/react-ui';\n\nexport const useBreakpoints = () => {\n  const [isNotMobile] = useMediaQuery('md');\n  const [isDesktop] = useMediaQuery('lg');\n  return isDesktop ? 'desktop' : isNotMobile ? 'tablet' : 'mobile';\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { useAppGraph } from '@dxos/app-toolkit/ui';\nimport { useConnections } from '@dxos/plugin-graph';\nimport { byPosition } from '@dxos/util';\n\nimport { PLANK_COMPANION_TYPE } from '#types';\n\nexport const useCompanions = (id?: string) => {\n  const { graph } = useAppGraph();\n  const nodes = useConnections(graph, id, 'child');\n  const companions = nodes.filter((node) => node.type === PLANK_COMPANION_TYPE);\n  return useMemo(() => companions.toSorted((a, b) => byPosition(a.properties, b.properties)), [companions]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useAppGraph } from '@dxos/app-toolkit/ui';\nimport { Node, type Node as NodeType } from '@dxos/plugin-graph';\nimport { useConnections } from '@dxos/plugin-graph';\nimport { type Label } from '@dxos/ui-types/translations';\nimport { type Position, byPosition } from '@dxos/util';\n\nimport { DECK_COMPANION_TYPE } from '#types';\n\nexport type DeckCompanion = NodeType.Node<\n  any,\n  {\n    label: Label;\n    icon: string;\n    // TODO(burdon): Scroll area should be controlled by surface.\n    /** If true, the panel will not be wrapped in a scroll area. */\n    fixed?: boolean;\n    position?: Position;\n    joyride?: string;\n  }\n>;\n\nexport const useDeckCompanions = (): DeckCompanion[] => {\n  const { graph } = useAppGraph();\n  const connections = useConnections(graph, Node.RootId, 'child');\n  const companions = connections.filter((node) => node.type === DECK_COMPANION_TYPE) as DeckCompanion[];\n  return companions.toSorted((a, b) => byPosition(a.properties, b.properties));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useMemo } from 'react';\n\nimport { Capabilities } from '@dxos/app-framework';\nimport { useCapability } from '@dxos/app-framework/ui';\nimport { invariant } from '@dxos/invariant';\n\nimport {\n  DeckCapabilities,\n  type EphemeralDeckState,\n  type DeckPluginState,\n  type DeckState,\n  type StoredDeckState,\n} from '#types';\n\nexport type DeckStateHook = {\n  /** Combined state value (reactive). Includes both persisted and ephemeral state. */\n  state: DeckPluginState;\n  /** The active deck, computed from decks[activeDeck]. */\n  deck: DeckState;\n  /** Update persisted state. */\n  updateState: (fn: (current: StoredDeckState) => StoredDeckState) => void;\n  /** Update ephemeral state. */\n  updateEphemeral: (fn: (current: EphemeralDeckState) => EphemeralDeckState) => void;\n};\n\n/**\n * Hook to access the deck plugin state reactively.\n * Returns the combined state, the active deck, and update functions for each atom.\n */\nexport const useDeckState = (): DeckStateHook => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const stateAtom = useCapability(DeckCapabilities.State);\n  const ephemeralAtom = useCapability(DeckCapabilities.EphemeralState);\n  const persistedState = useAtomValue(stateAtom);\n  const ephemeralState = useAtomValue(ephemeralAtom);\n\n  // Compute deck from decks[activeDeck] to ensure it's always current.\n  const deck = useMemo(() => {\n    const deck = persistedState.decks[persistedState.activeDeck];\n    invariant(deck, `Deck not found: ${persistedState.activeDeck}`);\n    return deck;\n  }, [persistedState.decks, persistedState.activeDeck]);\n\n  // Combine persisted and ephemeral state into a unified view.\n  const state = useMemo(\n    (): DeckPluginState => ({\n      ...persistedState,\n      ...ephemeralState,\n    }),\n    [persistedState, ephemeralState],\n  );\n\n  const updateState = useCallback(\n    (fn: (current: StoredDeckState) => StoredDeckState) => {\n      registry.set(stateAtom, fn(registry.get(stateAtom)));\n    },\n    [registry, stateAtom],\n  );\n\n  const updateEphemeral = useCallback(\n    (fn: (current: EphemeralDeckState) => EphemeralDeckState) => {\n      registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));\n    },\n    [registry, ephemeralAtom],\n  );\n\n  return useMemo(() => ({ state, deck, updateState, updateEphemeral }), [state, deck, updateState, updateEphemeral]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { useAtomCapability } from '@dxos/app-framework/ui';\nimport { useThemeContext } from '@dxos/react-ui';\n\nimport { DeckCapabilities, type LayoutMode } from '#types';\n\nexport const useHoistStatusbar = (breakpoint: string, layoutMode?: LayoutMode): boolean => {\n  const { safeAreaPadding } = useThemeContext();\n  const enableStatusbar = useAtomCapability(DeckCapabilities.Settings).enableStatusbar;\n\n  return useMemo(() => {\n    return (\n      breakpoint === 'desktop' &&\n      layoutMode !== 'solo--fullscreen' &&\n      !!enableStatusbar &&\n      safeAreaPadding?.bottom === 0\n    );\n  }, [enableStatusbar, breakpoint, safeAreaPadding?.bottom, layoutMode]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useMainContext } from '@dxos/react-ui';\n\nexport const useMainSize = () => {\n  const { navigationSidebarState, complementarySidebarState } = useMainContext('DeckPluginPlank');\n  return {\n    'data-sidebar-left-state': navigationSidebarState,\n    'data-sidebar-right-state': complementarySidebarState,\n  };\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect } from 'react';\n\nimport { Graph, type Node } from '@dxos/plugin-graph';\n\nexport const useNodeActionExpander = (node?: Node.Node) => {\n  useEffect(() => {\n    if (node) {\n      const frame = requestAnimationFrame(() => {\n        const graph = Graph.getGraph(node);\n        void Graph.expand(graph, node.id, 'action');\n      });\n      return () => cancelAnimationFrame(frame);\n    }\n  }, [node]);\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { type Node } from '@dxos/plugin-graph';\nimport { getLinkedVariant } from '@dxos/react-ui-attention';\n\n/**\n * Resolves which companion to show based on variant preference.\n * Falls back to first available if preferred variant not found.\n */\nexport const useSelectedCompanion = (companions: Node.Node[], preferredVariant?: string) => {\n  return useMemo(() => {\n    if (companions.length === 0) {\n      return { companionId: undefined, variant: undefined };\n    }\n\n    // Try to find companion matching the preferred variant.\n    if (preferredVariant) {\n      const preferred = companions.find((companion) => getLinkedVariant(companion.id) === preferredVariant);\n      if (preferred) {\n        return { companionId: preferred.id, variant: getLinkedVariant(preferred.id) };\n      }\n    }\n\n    // Fallback to first companion.\n    const first = companions[0];\n    return { companionId: first.id, variant: getLinkedVariant(first.id) };\n  }, [companions, preferredVariant]);\n};\n"],
+  "mappings": "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",
+  "names": ["useMediaQuery", "useBreakpoints", "isNotMobile", "isDesktop", "useMemo", "useAppGraph", "useConnections", "byPosition", "PLANK_COMPANION_TYPE", "useCompanions", "id", "graph", "nodes", "companions", "filter", "node", "type", "toSorted", "a", "b", "properties", "useAppGraph", "Node", "useConnections", "byPosition", "DECK_COMPANION_TYPE", "useDeckCompanions", "graph", "connections", "RootId", "companions", "filter", "node", "type", "toSorted", "a", "b", "properties", "useAtomValue", "useCallback", "useMemo", "Capabilities", "useCapability", "invariant", "DeckCapabilities", "stateAtom", "ephemeralAtom", "EphemeralState", "persistedState", "ephemeralState", "deck", "registry", "updateState", "updateEphemeral", "state", "useMemo", "useAtomCapability", "useThemeContext", "DeckCapabilities", "useHoistStatusbar", "breakpoint", "layoutMode", "safeAreaPadding", "enableStatusbar", "Settings", "bottom", "useMainContext", "useMainSize", "navigationSidebarState", "complementarySidebarState", "useEffect", "Graph", "useNodeActionExpander", "node", "frame", "requestAnimationFrame", "graph", "getGraph", "expand", "id", "cancelAnimationFrame", "useMemo", "getLinkedVariant", "useSelectedCompanion", "companions", "preferredVariant", "length", "companionId", "undefined", "variant", "preferred", "find", "companion", "id", "first"]
+}

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,38 @@
+import {
+  DECK_COMPANION_TYPE,
+  DeckAction,
+  DeckCapabilities_exports,
+  DeckEvents_exports,
+  DeckOperation_exports,
+  DeckState,
+  EphemeralDeckState,
+  PLANK_COMPANION_TYPE,
+  PlankSizing,
+  Settings_exports,
+  StoredDeckState,
+  defaultDeck,
+  getMode,
+  isLayoutMode
+} from "./chunk-64ODQD6S.mjs";
+import {
+  meta
+} from "./chunk-JMYWDX4I.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  DECK_COMPANION_TYPE,
+  DeckAction,
+  DeckCapabilities_exports as DeckCapabilities,
+  DeckEvents_exports as DeckEvents,
+  DeckOperation_exports as DeckOperation,
+  DeckState,
+  EphemeralDeckState,
+  PLANK_COMPANION_TYPE,
+  PlankSizing,
+  Settings_exports as Settings,
+  StoredDeckState,
+  defaultDeck,
+  getMode,
+  isLayoutMode,
+  meta
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}