@dxos/plugin-deck 0.8.4-main.72ec0f3 → 0.8.4-main.7996785055

package/dist/lib/node-esm/chunk-3QUPGLN4.mjs

@@ -0,0 +1,188 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  DECK_COMPANION_TYPE,
+  DeckCapabilities,
+  PLANK_COMPANION_TYPE
+} from "./chunk-J2AFCKMH.mjs";
+
+// 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";
+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/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";
+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 d = persistedState.decks[persistedState.activeDeck];
+    invariant(d, `Deck not found: ${persistedState.activeDeck}`, {
+      F: __dxlog_file,
+      L: 46,
+      S: void 0,
+      A: [
+        "d",
+        "`Deck not found: ${persistedState.activeDeck}`"
+      ]
+    });
+    return d;
+  }, [
+    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/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/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";
+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/useHoistStatusbar.ts
+import { useMemo as useMemo3 } from "react";
+import { useAtomCapability } from "@dxos/app-framework/ui";
+import { useThemeContext } from "@dxos/react-ui";
+var useHoistStatusbar = (breakpoint, layoutMode) => {
+  const { safeAreaPadding } = useThemeContext();
+  const enableStatusbar = useAtomCapability(DeckCapabilities.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 { getCompanionVariant } from "@dxos/app-toolkit";
+var useSelectedCompanion = (companions, preferredVariant) => {
+  return useMemo4(() => {
+    if (companions.length === 0) {
+      return {
+        companionId: void 0,
+        variant: void 0
+      };
+    }
+    if (preferredVariant) {
+      const preferred = companions.find((companion) => getCompanionVariant(companion.id) === preferredVariant);
+      if (preferred) {
+        return {
+          companionId: preferred.id,
+          variant: getCompanionVariant(preferred.id)
+        };
+      }
+    }
+    const first = companions[0];
+    return {
+      companionId: first.id,
+      variant: getCompanionVariant(first.id)
+    };
+  }, [
+    companions,
+    preferredVariant
+  ]);
+};
+
+export {
+  useBreakpoints,
+  useCompanions,
+  useDeckCompanions,
+  useDeckState,
+  useHoistStatusbar,
+  useMainSize,
+  useNodeActionExpander,
+  useSelectedCompanion
+};
+//# sourceMappingURL=chunk-3QUPGLN4.mjs.map

package/dist/lib/node-esm/chunk-3QUPGLN4.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useCompanions.ts", "../../../src/hooks/useDeckState.ts", "../../../src/hooks/useBreakpoints.ts", "../../../src/hooks/useDeckCompanions.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 { 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 { 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 DeckEphemeralStateProps,\n  type DeckPluginState,\n  type DeckState,\n  type DeckStateProps,\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: DeckStateProps) => DeckStateProps) => void;\n  /** Update ephemeral state. */\n  updateEphemeral: (fn: (current: DeckEphemeralStateProps) => DeckEphemeralStateProps) => 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\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 d = persistedState.decks[persistedState.activeDeck];\n    invariant(d, `Deck not found: ${persistedState.activeDeck}`);\n    return d;\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: DeckStateProps) => DeckStateProps) => {\n      registry.set(stateAtom, fn(registry.get(stateAtom)));\n    },\n    [registry, stateAtom],\n  );\n\n  const updateEphemeral = useCallback(\n    (fn: (current: DeckEphemeralStateProps) => DeckEphemeralStateProps) => {\n      registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));\n    },\n    [registry, ephemeralAtom],\n  );\n\n  return useMemo(\n    () => ({\n      state,\n      deck,\n      updateState,\n      updateEphemeral,\n    }),\n    [state, deck, updateState, updateEphemeral],\n  );\n};\n", "//\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 { 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';\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  }\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 { 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 { getCompanionVariant } from '@dxos/app-toolkit';\nimport { type Node } from '@dxos/plugin-graph';\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) => getCompanionVariant(companion.id) === preferredVariant);\n      if (preferred) {\n        return { companionId: preferred.id, variant: getCompanionVariant(preferred.id) };\n      }\n    }\n\n    // Fallback to first companion.\n    const first = companions[0];\n    return { companionId: first.id, variant: getCompanionVariant(first.id) };\n  }, [companions, preferredVariant]);\n};\n"],
+  "mappings": "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",
+  "names": ["useMemo", "useAppGraph", "useConnections", "byPosition", "useCompanions", "id", "graph", "useAppGraph", "nodes", "useConnections", "companions", "filter", "node", "type", "PLANK_COMPANION_TYPE", "useMemo", "toSorted", "a", "b", "byPosition", "properties", "useAtomValue", "useCallback", "useMemo", "Capabilities", "useCapability", "invariant", "useDeckState", "registry", "useCapability", "Capabilities", "AtomRegistry", "stateAtom", "DeckCapabilities", "State", "ephemeralAtom", "EphemeralState", "persistedState", "useAtomValue", "ephemeralState", "deck", "useMemo", "d", "decks", "activeDeck", "invariant", "state", "updateState", "useCallback", "fn", "set", "get", "updateEphemeral", "useMediaQuery", "useBreakpoints", "isNotMobile", "useMediaQuery", "isDesktop", "useAppGraph", "Node", "useConnections", "byPosition", "useDeckCompanions", "graph", "useAppGraph", "connections", "useConnections", "Node", "RootId", "companions", "filter", "node", "type", "DECK_COMPANION_TYPE", "toSorted", "a", "b", "byPosition", "properties", "useMemo", "useAtomCapability", "useThemeContext", "useHoistStatusbar", "breakpoint", "layoutMode", "safeAreaPadding", "useThemeContext", "enableStatusbar", "useAtomCapability", "DeckCapabilities", "Settings", "useMemo", "bottom", "useMainContext", "useMainSize", "navigationSidebarState", "complementarySidebarState", "useMainContext", "useEffect", "Graph", "useNodeActionExpander", "node", "useEffect", "frame", "requestAnimationFrame", "graph", "Graph", "getGraph", "expand", "id", "cancelAnimationFrame", "useMemo", "getCompanionVariant", "useSelectedCompanion", "companions", "preferredVariant", "useMemo", "length", "companionId", "undefined", "variant", "preferred", "find", "companion", "getCompanionVariant", "id", "first"]
+}

package/dist/lib/node-esm/chunk-4EIUXR64.mjs

@@ -0,0 +1,71 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// src/layout.ts
+import { produce } from "immer";
+var openEntry = (deck, entryId, options) => {
+  return produce(deck, (draft) => {
+    if (draft.find((id) => id === entryId)) {
+      return;
+    }
+    const key = options?.key;
+    const plankPositioning = options?.positioning ?? "start";
+    const pivotId = options?.pivotId;
+    if (key) {
+      const index = draft.findIndex((id) => id.split("+")[0] === key);
+      if (index !== -1) {
+        draft.splice(index, 1, entryId);
+        return;
+      }
+    }
+    if (pivotId) {
+      const pivotIndex = draft.findIndex((id) => id === pivotId);
+      if (pivotIndex !== -1) {
+        if (plankPositioning === "start") {
+          draft.splice(pivotIndex, 0, entryId);
+        } else {
+          draft.splice(pivotIndex + 1, 0, entryId);
+        }
+        return;
+      }
+    }
+    if (plankPositioning === "start") {
+      draft.unshift(entryId);
+    } else {
+      draft.push(entryId);
+    }
+  });
+};
+var closeEntry = (deck, entryId) => {
+  return produce(deck, (draft) => {
+    const index = draft.findIndex((id) => id === entryId);
+    if (index !== -1) {
+      draft.splice(index, 1);
+    }
+  });
+};
+var incrementPlank = (deck, adjustment) => {
+  return produce(deck, (draft) => {
+    const index = draft.findIndex((id) => id === adjustment.id);
+    if (index === -1 || adjustment.type === "increment-start" && index === 0 || adjustment.type === "increment-end" && index === draft.length - 1) {
+      return;
+    }
+    if (adjustment.type === "increment-start") {
+      [draft[index - 1], draft[index]] = [
+        draft[index],
+        draft[index - 1]
+      ];
+    } else if (adjustment.type === "increment-end") {
+      [draft[index], draft[index + 1]] = [
+        draft[index + 1],
+        draft[index]
+      ];
+    }
+  });
+};
+
+export {
+  openEntry,
+  closeEntry,
+  incrementPlank
+};
+//# sourceMappingURL=chunk-4EIUXR64.mjs.map

package/dist/lib/node-esm/chunk-4EIUXR64.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/layout.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { produce } from 'immer';\n\nimport { type DeckAction, type NewPlankPositioning } from './types';\n\ntype OpenLayoutEntryOptions = {\n  key?: string;\n  positioning?: NewPlankPositioning;\n  pivotId?: string;\n};\n\nexport const openEntry = (deck: string[], entryId: string, options?: OpenLayoutEntryOptions): string[] => {\n  return produce(deck, (draft) => {\n    // Check that the entry is not already in the part\n    if (draft.find((id) => id === entryId)) {\n      return;\n    }\n\n    const key = options?.key;\n    const plankPositioning = options?.positioning ?? 'start';\n    const pivotId = options?.pivotId;\n\n    if (key) {\n      const index = draft.findIndex((id) => id.split('+')[0] === key);\n      if (index !== -1) {\n        draft.splice(index, 1, entryId);\n        return;\n      }\n    }\n\n    if (pivotId) {\n      const pivotIndex = draft.findIndex((id) => id === pivotId);\n      if (pivotIndex !== -1) {\n        if (plankPositioning === 'start') {\n          draft.splice(pivotIndex, 0, entryId);\n        } else {\n          draft.splice(pivotIndex + 1, 0, entryId);\n        }\n        return;\n      }\n    }\n\n    // If no pivot found or provided, fall back to original behavior\n    if (plankPositioning === 'start') {\n      draft.unshift(entryId);\n    } else {\n      draft.push(entryId);\n    }\n  });\n};\n\nexport const closeEntry = (deck: string[], entryId: string): string[] => {\n  return produce(deck, (draft) => {\n    const index = draft.findIndex((id) => id === entryId);\n    if (index !== -1) {\n      draft.splice(index, 1);\n    }\n  });\n};\n\nexport const incrementPlank = (deck: string[], adjustment: DeckAction.Adjustment): string[] => {\n  return produce(deck, (draft) => {\n    const index = draft.findIndex((id) => id === adjustment.id);\n    if (\n      index === -1 ||\n      (adjustment.type === 'increment-start' && index === 0) ||\n      (adjustment.type === 'increment-end' && index === draft.length - 1)\n    ) {\n      return;\n    }\n\n    if (adjustment.type === 'increment-start') {\n      // Swap the current item with the previous item.\n      [draft[index - 1], draft[index]] = [draft[index], draft[index - 1]];\n    } else if (adjustment.type === 'increment-end') {\n      // Swap the current item with the next item.\n      [draft[index], draft[index + 1]] = [draft[index + 1], draft[index]];\n    }\n  });\n};\n"],
+  "mappings": ";;;AAIA,SAASA,eAAe;AAUjB,IAAMC,YAAY,CAACC,MAAgBC,SAAiBC,YAAAA;AACzD,SAAOC,QAAQH,MAAM,CAACI,UAAAA;AAEpB,QAAIA,MAAMC,KAAK,CAACC,OAAOA,OAAOL,OAAAA,GAAU;AACtC;IACF;AAEA,UAAMM,MAAML,SAASK;AACrB,UAAMC,mBAAmBN,SAASO,eAAe;AACjD,UAAMC,UAAUR,SAASQ;AAEzB,QAAIH,KAAK;AACP,YAAMI,QAAQP,MAAMQ,UAAU,CAACN,OAAOA,GAAGO,MAAM,GAAA,EAAK,CAAA,MAAON,GAAAA;AAC3D,UAAII,UAAU,IAAI;AAChBP,cAAMU,OAAOH,OAAO,GAAGV,OAAAA;AACvB;MACF;IACF;AAEA,QAAIS,SAAS;AACX,YAAMK,aAAaX,MAAMQ,UAAU,CAACN,OAAOA,OAAOI,OAAAA;AAClD,UAAIK,eAAe,IAAI;AACrB,YAAIP,qBAAqB,SAAS;AAChCJ,gBAAMU,OAAOC,YAAY,GAAGd,OAAAA;QAC9B,OAAO;AACLG,gBAAMU,OAAOC,aAAa,GAAG,GAAGd,OAAAA;QAClC;AACA;MACF;IACF;AAGA,QAAIO,qBAAqB,SAAS;AAChCJ,YAAMY,QAAQf,OAAAA;IAChB,OAAO;AACLG,YAAMa,KAAKhB,OAAAA;IACb;EACF,CAAA;AACF;AAEO,IAAMiB,aAAa,CAAClB,MAAgBC,YAAAA;AACzC,SAAOE,QAAQH,MAAM,CAACI,UAAAA;AACpB,UAAMO,QAAQP,MAAMQ,UAAU,CAACN,OAAOA,OAAOL,OAAAA;AAC7C,QAAIU,UAAU,IAAI;AAChBP,YAAMU,OAAOH,OAAO,CAAA;IACtB;EACF,CAAA;AACF;AAEO,IAAMQ,iBAAiB,CAACnB,MAAgBoB,eAAAA;AAC7C,SAAOjB,QAAQH,MAAM,CAACI,UAAAA;AACpB,UAAMO,QAAQP,MAAMQ,UAAU,CAACN,OAAOA,OAAOc,WAAWd,EAAE;AAC1D,QACEK,UAAU,MACTS,WAAWC,SAAS,qBAAqBV,UAAU,KACnDS,WAAWC,SAAS,mBAAmBV,UAAUP,MAAMkB,SAAS,GACjE;AACA;IACF;AAEA,QAAIF,WAAWC,SAAS,mBAAmB;AAEzC,OAACjB,MAAMO,QAAQ,CAAA,GAAIP,MAAMO,KAAAA,CAAM,IAAI;QAACP,MAAMO,KAAAA;QAAQP,MAAMO,QAAQ,CAAA;;IAClE,WAAWS,WAAWC,SAAS,iBAAiB;AAE9C,OAACjB,MAAMO,KAAAA,GAAQP,MAAMO,QAAQ,CAAA,CAAE,IAAI;QAACP,MAAMO,QAAQ,CAAA;QAAIP,MAAMO,KAAAA;;IAC9D;EACF,CAAA;AACF;",
+  "names": ["produce", "openEntry", "deck", "entryId", "options", "produce", "draft", "find", "id", "key", "plankPositioning", "positioning", "pivotId", "index", "findIndex", "split", "splice", "pivotIndex", "unshift", "push", "closeEntry", "incrementPlank", "adjustment", "type", "length"]
+}

package/dist/lib/node-esm/chunk-4NLQZESJ.mjs

@@ -0,0 +1,89 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  __export,
+  meta
+} from "./chunk-CMISPQAO.mjs";
+
+// src/operations/definitions.ts
+var definitions_exports = {};
+__export(definitions_exports, {
+  Adjust: () => Adjust,
+  ChangeCompanion: () => ChangeCompanion,
+  UpdatePlankSize: () => UpdatePlankSize
+});
+import * as Schema from "effect/Schema";
+import { Capability } from "@dxos/app-framework";
+import { Operation } from "@dxos/operation";
+var PartAdjustmentSchema = Schema.Union(Schema.Literal("close").annotations({
+  description: "Close the plank."
+}), Schema.Literal("companion").annotations({
+  description: "Open the companion plank."
+}), Schema.Literal("solo").annotations({
+  description: "Solo the plank."
+}), Schema.Literal("solo--fullscreen").annotations({
+  description: "Fullscreen the plank."
+}), Schema.Literal("increment-start").annotations({
+  description: "Move the plank towards the start of the deck."
+}), Schema.Literal("increment-end").annotations({
+  description: "Move the plank towards the end of the deck."
+}));
+var Adjust = Operation.make({
+  meta: {
+    key: `${meta.id}.operation.adjust`,
+    name: "Adjust",
+    description: "Adjust the layout of a plank."
+  },
+  services: [
+    Capability.Service
+  ],
+  input: Schema.Struct({
+    id: Schema.String.annotations({
+      description: "The id of the plank to adjust."
+    }),
+    type: PartAdjustmentSchema.annotations({
+      description: "The type of adjustment to make."
+    })
+  }),
+  output: Schema.Void
+});
+var UpdatePlankSize = Operation.make({
+  meta: {
+    key: `${meta.id}.operation.update-plank-size`,
+    name: "Update Plank Size",
+    description: "Update the size of a plank."
+  },
+  services: [
+    Capability.Service
+  ],
+  input: Schema.Struct({
+    id: Schema.String.annotations({
+      description: "The id of the plank to resize."
+    }),
+    size: Schema.Number.annotations({
+      description: "The new size of the plank."
+    })
+  }),
+  output: Schema.Void
+});
+var ChangeCompanion = Operation.make({
+  meta: {
+    key: `${meta.id}.operation.change-companion`,
+    name: "Change Companion",
+    description: "Change the companion plank for a primary plank."
+  },
+  services: [
+    Capability.Service
+  ],
+  input: Schema.Struct({
+    companion: Schema.Union(Schema.String, Schema.Null)
+  }),
+  output: Schema.Void
+});
+
+export {
+  Adjust,
+  UpdatePlankSize,
+  ChangeCompanion,
+  definitions_exports
+};
+//# sourceMappingURL=chunk-4NLQZESJ.mjs.map

package/dist/lib/node-esm/chunk-4NLQZESJ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/operations/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/operation';\n\nimport { meta } from '../meta';\n\nconst PartAdjustmentSchema = Schema.Union(\n  Schema.Literal('close').annotations({ description: 'Close the plank.' }),\n  Schema.Literal('companion').annotations({ description: 'Open the companion plank.' }),\n  Schema.Literal('solo').annotations({ description: 'Solo the plank.' }),\n  Schema.Literal('solo--fullscreen').annotations({ description: 'Fullscreen the plank.' }),\n  Schema.Literal('increment-start').annotations({ description: 'Move the plank towards the start of the deck.' }),\n  Schema.Literal('increment-end').annotations({ description: 'Move the plank towards the end of the deck.' }),\n);\nexport type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;\n\nexport const Adjust = Operation.make({\n  meta: {\n    key: `${meta.id}.operation.adjust`,\n    name: 'Adjust',\n    description: 'Adjust the layout of a plank.',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    id: Schema.String.annotations({ description: 'The id of the plank to adjust.' }),\n    type: PartAdjustmentSchema.annotations({ description: 'The type of adjustment to make.' }),\n  }),\n  output: Schema.Void,\n});\n\nexport const UpdatePlankSize = Operation.make({\n  meta: {\n    key: `${meta.id}.operation.update-plank-size`,\n    name: 'Update Plank Size',\n    description: 'Update the size of a plank.',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    id: Schema.String.annotations({ description: 'The id of the plank to resize.' }),\n    size: Schema.Number.annotations({ description: 'The new size of the plank.' }),\n  }),\n  output: Schema.Void,\n});\n\nexport const ChangeCompanion = Operation.make({\n  meta: {\n    key: `${meta.id}.operation.change-companion`,\n    name: 'Change Companion',\n    description: 'Change the companion plank for a primary plank.',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    companion: Schema.Union(Schema.String, Schema.Null),\n  }),\n  output: Schema.Void,\n});\n"],
+  "mappings": ";;;;;;;AAAA;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAC3B,SAASC,iBAAiB;AAI1B,IAAMC,uBAA8BC,aAC3BC,eAAQ,OAAA,EAASC,YAAY;EAAEC,aAAa;AAAmB,CAAA,GAC/DF,eAAQ,WAAA,EAAaC,YAAY;EAAEC,aAAa;AAA4B,CAAA,GAC5EF,eAAQ,MAAA,EAAQC,YAAY;EAAEC,aAAa;AAAkB,CAAA,GAC7DF,eAAQ,kBAAA,EAAoBC,YAAY;EAAEC,aAAa;AAAwB,CAAA,GAC/EF,eAAQ,iBAAA,EAAmBC,YAAY;EAAEC,aAAa;AAAgD,CAAA,GACtGF,eAAQ,eAAA,EAAiBC,YAAY;EAAEC,aAAa;AAA8C,CAAA,CAAA;AAIpG,IAAMC,SAASC,UAAUC,KAAK;EACnCC,MAAM;IACJC,KAAK,GAAGD,KAAKE,EAAE;IACfC,MAAM;IACNP,aAAa;EACf;EACAQ,UAAU;IAACC,WAAWC;;EACtBC,OAAcC,cAAO;IACnBN,IAAWO,cAAOd,YAAY;MAAEC,aAAa;IAAiC,CAAA;IAC9Ec,MAAMlB,qBAAqBG,YAAY;MAAEC,aAAa;IAAkC,CAAA;EAC1F,CAAA;EACAe,QAAeC;AACjB,CAAA;AAEO,IAAMC,kBAAkBf,UAAUC,KAAK;EAC5CC,MAAM;IACJC,KAAK,GAAGD,KAAKE,EAAE;IACfC,MAAM;IACNP,aAAa;EACf;EACAQ,UAAU;IAACC,WAAWC;;EACtBC,OAAcC,cAAO;IACnBN,IAAWO,cAAOd,YAAY;MAAEC,aAAa;IAAiC,CAAA;IAC9EkB,MAAaC,cAAOpB,YAAY;MAAEC,aAAa;IAA6B,CAAA;EAC9E,CAAA;EACAe,QAAeC;AACjB,CAAA;AAEO,IAAMI,kBAAkBlB,UAAUC,KAAK;EAC5CC,MAAM;IACJC,KAAK,GAAGD,KAAKE,EAAE;IACfC,MAAM;IACNP,aAAa;EACf;EACAQ,UAAU;IAACC,WAAWC;;EACtBC,OAAcC,cAAO;IACnBS,WAAkBxB,aAAagB,eAAeS,WAAI;EACpD,CAAA;EACAP,QAAeC;AACjB,CAAA;",
+  "names": ["Schema", "Capability", "Operation", "PartAdjustmentSchema", "Union", "Literal", "annotations", "description", "Adjust", "Operation", "make", "meta", "key", "id", "name", "services", "Capability", "Service", "input", "Struct", "String", "type", "output", "Void", "UpdatePlankSize", "size", "Number", "ChangeCompanion", "companion", "Null"]
+}

package/dist/lib/node-esm/chunk-CMISPQAO.mjs

@@ -0,0 +1,24 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/meta.ts
+import { trim } from "@dxos/util";
+var meta = {
+  id: "org.dxos.plugin.deck",
+  name: "Layout",
+  description: trim`
+    Flexible layout system for arranging workspace views in tabs, splits, and panels.
+    Customize your workspace organization with drag-and-drop layout management.
+  `,
+  icon: "ph--layout--regular"
+};
+
+export {
+  __export,
+  meta
+};
+//# sourceMappingURL=chunk-CMISPQAO.mjs.map

package/dist/lib/node-esm/chunk-CMISPQAO.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/meta.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.deck',\n  name: 'Layout',\n  description: trim`\n    Flexible layout system for arranging workspace views in tabs, splits, and panels.\n    Customize your workspace organization with drag-and-drop layout management.\n  `,\n  icon: 'ph--layout--regular',\n};\n"],
+  "mappings": ";;;;;;;;AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaC;;;;EAIbC,MAAM;AACR;",
+  "names": ["trim", "meta", "id", "name", "description", "trim", "icon"]
+}