@dxos/plugin-sheet 0.10.0 → 0.11.0

package/src/containers/SheetArticle/SheetArticle.tsx

@@ -4,28 +4,38 @@
 
 import React from 'react';
 
+import { useCapability } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
-import { type ComputeGraphRegistry } from '@dxos/compute-hyperformula';
-import { type Space } from '@dxos/react-client/echo';
+import { type Space, getSpace } from '@dxos/react-client/echo';
 import { Panel } from '@dxos/react-ui';
 
 import { ComputeGraphContextProvider, Sheet, useComputeGraph } from '#components';
-import { type Sheet as SheetType } from '#types';
+import { SheetCapabilities, type Sheet as SheetType } from '#types';
 
 export type SheetArticleProps = AppSurface.ObjectArticleProps<
   SheetType.Sheet,
   {
-    space: Space;
-    registry: ComputeGraphRegistry;
     ignoreAttention?: boolean;
   }
 >;
 
-export const SheetArticle = ({ registry, ...props }: SheetArticleProps) => (
-  <ComputeGraphContextProvider registry={registry}>
-    <SheetArticleInner {...props} />
-  </ComputeGraphContextProvider>
-);
+/**
+ * Resolves the compute-graph registry capability and the sheet's space, then scopes the article to
+ * that registry. A sheet outside a space has no graph to evaluate against.
+ */
+export const SheetArticle = ({ subject, ...props }: SheetArticleProps) => {
+  const registry = useCapability(SheetCapabilities.ComputeGraphRegistry);
+  const space = getSpace(subject);
+  if (!space) {
+    return null;
+  }
+
+  return (
+    <ComputeGraphContextProvider registry={registry}>
+      <SheetArticleInner {...props} subject={subject} space={space} />
+    </ComputeGraphContextProvider>
+  );
+};
 
 const SheetArticleInner = ({
   role,
@@ -33,7 +43,7 @@ const SheetArticleInner = ({
   attendableId,
   space,
   ignoreAttention,
-}: Omit<SheetArticleProps, 'registry'>) => {
+}: SheetArticleProps & { space: Space }) => {
   const graph = useComputeGraph(space);
   if (!graph) {
     return null;
@@ -55,3 +65,5 @@ const SheetArticleInner = ({
     </Sheet.Root>
   );
 };
+
+SheetArticle.displayName = 'SheetArticle';

package/src/extensions/editor/sheet-extension.ts

@@ -161,16 +161,20 @@ export const sheetExtension = ({ debug, functions = [] }: SheetExtensionOptions)
     }),
 
     syntaxHighlighting(highlightStyles),
+    anchorCompletionTooltip,
     autocompletion({
       aboveCursor: false,
       defaultKeymap: true,
       activateOnTyping: true,
       closeOnBlur: !debug,
       icons: false,
+      // Cosmetics only. The tooltip is `position: fixed` and CodeMirror computes its coordinates from
+      // the cursor, so overriding `left`/`top` here measures them against the viewport instead of the
+      // cell — which pinned the completion list to the top-left corner of the window.
       tooltipClass: () =>
         mx(
-          '!-left-[1px] !top-[33px] !-m-0 border border-h-0! [&>ul]:!min-w-[198px]',
-          '[&>ul>li[aria-selected]]:!bg-accent-bg',
+          '-m-0! border border-h-0! [&>ul]:min-w-[198px]!',
+          '[&>ul>li[aria-selected]]:bg-accent-bg!',
           'border-separator',
         ),
     }),
@@ -311,3 +315,58 @@ const visitTree = (node: SyntaxNode, callback: (node: SyntaxNode) => boolean): b
 
   return false;
 };
+
+/**
+ * Pins the completion tooltip to the editing cell rather than to the cursor.
+ *
+ * CodeMirror anchors it at the completion's start offset — a few pixels in from the cell's edge, and
+ * further in the longer the expression before the function name — overlapping the cell's lower
+ * border. In a grid the cell is the meaningful anchor.
+ *
+ * Driven by a DOM observer rather than the plugin's `update`: CodeMirror creates and positions the
+ * tooltip in its measure phase, which runs *after* the update, so an update-time correction either
+ * finds no tooltip or is immediately overwritten. Which side it opens on is still CodeMirror's call,
+ * so a tooltip near the bottom of the window still flips above the cell.
+ */
+const anchorCompletionTooltip = ViewPlugin.fromClass(
+  class {
+    private readonly _observer = new MutationObserver(() => this._pin());
+
+    constructor(private readonly _view: EditorView) {
+      this._observer.observe(_view.dom, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ['style', 'class'],
+      });
+    }
+
+    destroy(): void {
+      this._observer.disconnect();
+    }
+
+    /** Idempotent: writing values it already holds would retrigger the observer. */
+    private _pin(): void {
+      const tooltip = this._view.dom.querySelector<HTMLElement>('.cm-tooltip-autocomplete');
+      if (!tooltip) {
+        return;
+      }
+
+      // The cell editor's own box, not `view.dom` — the editor sits inset within it.
+      const cell = (this._view.dom.closest('.dx-grid__cell-editor') ?? this._view.dom).getBoundingClientRect();
+      const left = cell.left;
+      const top = tooltip.classList.contains('cm-tooltip-below')
+        ? cell.bottom
+        : cell.top - tooltip.getBoundingClientRect().height;
+      if (
+        Math.abs(Number.parseFloat(tooltip.style.left || '0') - left) < 0.5 &&
+        Math.abs(Number.parseFloat(tooltip.style.top || '0') - top) < 0.5
+      ) {
+        return;
+      }
+
+      tooltip.style.left = `${left}px`;
+      tooltip.style.top = `${top}px`;
+    }
+  },
+);

package/src/integrations/thread-ranges.ts

@@ -9,9 +9,9 @@ import { LayoutOperation } from '@dxos/app-toolkit';
 import { debounce } from '@dxos/async';
 import { type CellAddress, type CompleteCellRange, inRange } from '@dxos/compute-hyperformula';
 import { Filter, Obj, Query, Relation } from '@dxos/echo';
-import { CommentOperation } from '@dxos/plugin-comments/types';
-import { useQuery } from '@dxos/react-client/echo';
-import { linkedSegment } from '@dxos/react-ui-attention';
+import { useQuery } from '@dxos/echo-react';
+import { CommentOperation } from '@dxos/plugin-review/types';
+import { Attention } from '@dxos/react-ui-attention';
 import { AnchoredTo, Thread } from '@dxos/types';
 
 import { useSheetContext } from '#components';
@@ -60,7 +60,7 @@ export const useSelectThreadOnCellFocus = () => {
         void (async () => {
           await invokePromise(CommentOperation.Select, { current: Relation.getURI(closestThread) });
           await invokePromise(LayoutOperation.UpdateCompanion, {
-            subject: linkedSegment('comments'),
+            subject: Attention.linkedSegment('comments'),
           });
         })();
       }

package/src/operations/node.ts

@@ -0,0 +1,18 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/compute';
+
+// The operations `SheetPlugin.node` can serve, and only those. `scroll-to-anchor` drives a live
+// editor view, so it is browser-only — and `OperationHandlerSet.lazy` defers the import at runtime
+// without stopping a bundler walking into the React surface behind it.
+
+export const SheetOperationHandlerSet = OperationHandlerSet.lazy(
+  () => import('./create'),
+  () => import('./drop-axis'),
+  () => import('./get-values'),
+  () => import('./insert-axis'),
+  () => import('./restore-axis'),
+  () => import('./set-values'),
+);

package/src/operations/scroll-to-anchor.ts

@@ -12,13 +12,14 @@ import { SheetCapabilities, SheetOperation } from '../types';
 
 const handler: Operation.WithHandler<typeof SheetOperation.ScrollToAnchor> = SheetOperation.ScrollToAnchor.pipe(
   Operation.withHandler(
-    Effect.fnUntraced(function* ({ subject, cursor, ref }) {
+    Effect.fnUntraced(function* ({ subject, cursor, id }) {
       const gridInstances = yield* Capability.get(SheetCapabilities.GridInstances);
       const entry = gridInstances.get(subject);
       if (!entry) {
         return;
       }
-      entry.setActiveRefs(ref);
+
+      entry.setActiveRefs(id);
       const range = parseThreadAnchorAsCellRange(cursor);
       if (range) {
         entry.grid.setFocus({ ...range.to, plane: 'grid' }, true);

package/src/plugin.ts

@@ -8,4 +8,4 @@ import { meta } from './meta';
 
 export const SheetPlugin = Plugin.lazy(meta, () => import('#plugin'));
 
-export { SheetOperationHandlerSet } from './operations';
+export { SheetOperationHandlerSet } from '#operations';

package/src/testing/testing.tsx

@@ -26,14 +26,20 @@ export const useTestSheet = (space?: Space, graph?: ComputeGraph, options?: Shee
   return sheet;
 };
 
+/**
+ * Provides the compute-graph context. Pass `registry` when the story also contributes it as the
+ * `ComputeGraphRegistry` capability, so the context and the capability share one instance.
+ */
 export const withComputeGraphDecorator =
-  (options?: Partial<ComputeGraphOptions>): Decorator =>
+  (options?: Partial<ComputeGraphOptions> & { registry?: ComputeGraphRegistry }): Decorator =>
   (Story) => {
     const [registry] = useState(
-      new ComputeGraphRegistry({
-        ...options,
-        computeRuntime: options?.computeRuntime ?? createMockedComputeRuntimeProvider(),
-      }),
+      () =>
+        options?.registry ??
+        new ComputeGraphRegistry({
+          ...options,
+          computeRuntime: options?.computeRuntime ?? createMockedComputeRuntimeProvider(),
+        }),
     );
     return (
       <ComputeGraphContextProvider registry={registry}>

package/src/types/SheetOperation.ts

@@ -42,7 +42,11 @@ export const DropAxisOutput = Schema.Struct({
 export type DropAxisOutput = Schema.Schema.Type<typeof DropAxisOutput>;
 
 export const DropAxis = Operation.make({
-  meta: { key: makeKey('axisDrop'), name: 'Drop Axis', icon: 'ph--trash--regular' },
+  meta: {
+    key: makeKey('axisDrop'),
+    name: 'Drop Axis',
+    icon: 'ph--trash--regular',
+  },
   input: Schema.Struct({
     model: Schema.Any,
     axis: Axis,
@@ -61,7 +65,7 @@ export const ScrollToAnchor = Operation.make({
   input: Schema.Struct({
     subject: Schema.String.annotations({ description: 'Attendable ID of the sheet.' }),
     cursor: Schema.String.annotations({ description: 'Cell range coordinates.' }),
-    ref: Schema.optional(Schema.Any.annotations({ description: 'Active refs for highlighting.' })),
+    id: Schema.optional(Schema.Any.annotations({ description: 'Active refs for highlighting.' })),
   }),
   output: Schema.Void,
 });

package/dist/lib/neutral/RangeList-EIJTFS7P.mjs

@@ -1,53 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/RangeList/RangeList.tsx
-import * as Schema from "effect/Schema";
-import React, { useCallback } from "react";
-import { rangeToA1Notation } from "@dxos/compute-hyperformula";
-import { useObject } from "@dxos/echo-react";
-import { Input, Message, useTranslation } from "@dxos/react-ui";
-import { OrderedList } from "@dxos/react-ui-list";
-import { meta } from "#meta";
-import { rangeFromIndex } from "#types";
-import { Sheet } from "#types";
-var RangeList = ({ sheet: sheetProp }) => {
-  const { t } = useTranslation(meta.profile.key);
-  const [sheet, updateSheet] = useObject(sheetProp);
-  const handleSelectRange = (range) => {
-  };
-  const handleDeleteRange = useCallback((range) => {
-    const index = sheet.ranges.findIndex((sheetRange) => sheetRange === range);
-    updateSheet((sheet2) => {
-      sheet2.ranges.splice(index, 1);
-    });
-  }, [
-    sheet,
-    updateSheet
-  ]);
-  return /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(Input.Root, null, /* @__PURE__ */ React.createElement(Input.Label, null, t("range-list.heading"))), sheet.ranges.length === 0 ? /* @__PURE__ */ React.createElement(Message.Root, null, /* @__PURE__ */ React.createElement(Message.Title, null, t("no-ranges.message"))) : /* @__PURE__ */ React.createElement(OrderedList.Root, {
-    items: sheet.ranges,
-    isItem: Schema.is(Sheet.Range)
-  }, ({ items: ranges }) => /* @__PURE__ */ React.createElement(OrderedList.Content, null, ranges.map((range) => {
-    const id = range.range;
-    return /* @__PURE__ */ React.createElement(OrderedList.Item, {
-      key: id,
-      id,
-      item: range,
-      hover: true,
-      classNames: "flex items-center cursor-pointer",
-      onClick: () => handleSelectRange(range)
-    }, /* @__PURE__ */ React.createElement("div", {
-      className: "flex grow items-center truncate px-2"
-    }, t("range.title", {
-      position: rangeToA1Notation(rangeFromIndex(sheetProp, range.range)),
-      key: t(`range-key.${range.key}.label`),
-      value: t(`range-value.${range.value}.label`)
-    })), /* @__PURE__ */ React.createElement(OrderedList.DeleteButton, {
-      onClick: () => handleDeleteRange(range)
-    }));
-  }))));
-};
-export {
-  RangeList as default
-};
-//# sourceMappingURL=RangeList-EIJTFS7P.mjs.map

package/dist/lib/neutral/RangeList-EIJTFS7P.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/RangeList/RangeList.tsx"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport React, { useCallback } from 'react';\n\nimport { rangeToA1Notation } from '@dxos/compute-hyperformula';\nimport { useObject } from '@dxos/echo-react';\nimport { Input, Message, useTranslation } from '@dxos/react-ui';\nimport { OrderedList } from '@dxos/react-ui-list';\n\nimport { meta } from '#meta';\nimport { rangeFromIndex } from '#types';\nimport { Sheet } from '#types';\n\nexport type RangeListProps = {\n  sheet: Sheet.Sheet;\n};\n\nexport const RangeList = ({ sheet: sheetProp }: RangeListProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [sheet, updateSheet] = useObject(sheetProp);\n  // TODO(thure): Implement similar to comments, #8121\n  const handleSelectRange = (range: Sheet.Range) => {};\n  const handleDeleteRange = useCallback(\n    (range: Sheet.Range) => {\n      const index = sheet.ranges.findIndex((sheetRange) => sheetRange === range);\n      updateSheet((sheet) => {\n        sheet.ranges.splice(index, 1);\n      });\n    },\n    [sheet, updateSheet],\n  );\n  return (\n    <>\n      <Input.Root>\n        <Input.Label>{t('range-list.heading')}</Input.Label>\n      </Input.Root>\n      {sheet.ranges.length === 0 ? (\n        <Message.Root>\n          <Message.Title>{t('no-ranges.message')}</Message.Title>\n        </Message.Root>\n      ) : (\n        <OrderedList.Root<Sheet.Range> items={sheet.ranges} isItem={Schema.is(Sheet.Range)}>\n          {({ items: ranges }) => (\n            <OrderedList.Content>\n              {ranges.map((range) => {\n                // Use the range's underlying cell range string as the stable id so deletes /\n                // re-renders don't shift row identity by array position. Reorder is not\n                // wired (DX-8121); add `OrderedList.DragHandle` + a real id strategy when it\n                // lands. We avoid `OrderedList.Title` because there's no disclosure panel\n                // for it to control here.\n                const id = range.range;\n                return (\n                  <OrderedList.Item\n                    key={id}\n                    id={id}\n                    item={range}\n                    hover\n                    classNames='flex items-center cursor-pointer'\n                    onClick={() => handleSelectRange(range)}\n                  >\n                    <div className='flex grow items-center truncate px-2'>\n                      {t('range.title', {\n                        position: rangeToA1Notation(rangeFromIndex(sheetProp, range.range)),\n                        key: t(`range-key.${range.key}.label`),\n                        value: t(`range-value.${range.value}.label`),\n                      })}\n                    </div>\n                    <OrderedList.DeleteButton onClick={() => handleDeleteRange(range)} />\n                  </OrderedList.Item>\n                );\n              })}\n            </OrderedList.Content>\n          )}\n        </OrderedList.Root>\n      )}\n    </>\n  );\n};\n"],
-  "mappings": ";;;AAIA,YAAYA,YAAY;AACxB,OAAOC,SAASC,mBAAmB;AAEnC,SAASC,yBAAyB;AAClC,SAASC,iBAAiB;AAC1B,SAASC,OAAOC,SAASC,sBAAsB;AAC/C,SAASC,mBAAmB;AAE5B,SAASC,YAAY;AACrB,SAASC,sBAAsB;AAC/B,SAASC,aAAa;AAMf,IAAMC,YAAY,CAAC,EAAEC,OAAOC,UAAS,MAAkB;AAC5D,QAAM,EAAEC,EAAC,IAAKR,eAAeE,KAAKO,QAAQC,GAAG;AAC7C,QAAM,CAACJ,OAAOK,WAAAA,IAAed,UAAUU,SAAAA;AAEvC,QAAMK,oBAAoB,CAACC,UAAAA;EAAwB;AACnD,QAAMC,oBAAoBnB,YACxB,CAACkB,UAAAA;AACC,UAAME,QAAQT,MAAMU,OAAOC,UAAU,CAACC,eAAeA,eAAeL,KAAAA;AACpEF,gBAAY,CAACL,WAAAA;AACXA,MAAAA,OAAMU,OAAOG,OAAOJ,OAAO,CAAA;IAC7B,CAAA;EACF,GACA;IAACT;IAAOK;GAAY;AAEtB,SACE,sBAAA,cAAA,MAAA,UAAA,MACE,sBAAA,cAACb,MAAMsB,MAAI,MACT,sBAAA,cAACtB,MAAMuB,OAAK,MAAEb,EAAE,oBAAA,CAAA,CAAA,GAEjBF,MAAMU,OAAOM,WAAW,IACvB,sBAAA,cAACvB,QAAQqB,MAAI,MACX,sBAAA,cAACrB,QAAQwB,OAAK,MAAEf,EAAE,mBAAA,CAAA,CAAA,IAGpB,sBAAA,cAACP,YAAYmB,MAAI;IAAcI,OAAOlB,MAAMU;IAAQS,QAAeC,UAAGtB,MAAMuB,KAAK;KAC9E,CAAC,EAAEH,OAAOR,OAAM,MACf,sBAAA,cAACf,YAAY2B,SAAO,MACjBZ,OAAOa,IAAI,CAAChB,UAAAA;AAMX,UAAMiB,KAAKjB,MAAMA;AACjB,WACE,sBAAA,cAACZ,YAAY8B,MAAI;MACfrB,KAAKoB;MACLA;MACAE,MAAMnB;MACNoB,OAAAA;MACAC,YAAW;MACXC,SAAS,MAAMvB,kBAAkBC,KAAAA;OAEjC,sBAAA,cAACuB,OAAAA;MAAIC,WAAU;OACZ7B,EAAE,eAAe;MAChB8B,UAAU1C,kBAAkBO,eAAeI,WAAWM,MAAMA,KAAK,CAAA;MACjEH,KAAKF,EAAE,aAAaK,MAAMH,GAAG,QAAQ;MACrC6B,OAAO/B,EAAE,eAAeK,MAAM0B,KAAK,QAAQ;IAC7C,CAAA,CAAA,GAEF,sBAAA,cAACtC,YAAYuC,cAAY;MAACL,SAAS,MAAMrB,kBAAkBD,KAAAA;;EAGjE,CAAA,CAAA,CAAA,CAAA;AAOd;",
-  "names": ["Schema", "React", "useCallback", "rangeToA1Notation", "useObject", "Input", "Message", "useTranslation", "OrderedList", "meta", "rangeFromIndex", "Sheet", "RangeList", "sheet", "sheetProp", "t", "profile", "key", "updateSheet", "handleSelectRange", "range", "handleDeleteRange", "index", "ranges", "findIndex", "sheetRange", "splice", "Root", "Label", "length", "Title", "items", "isItem", "is", "Range", "Content", "map", "id", "Item", "item", "hover", "classNames", "onClick", "div", "className", "position", "value", "DeleteButton"]
-}

package/dist/lib/neutral/SheetArticle-IUPQYGUU.mjs

@@ -1,34 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/SheetArticle/SheetArticle.tsx
-import React from "react";
-import { AppSurface } from "@dxos/app-toolkit/ui";
-import { Panel } from "@dxos/react-ui";
-import { ComputeGraphContextProvider, Sheet, useComputeGraph } from "#components";
-var SheetArticle = ({ registry, ...props }) => /* @__PURE__ */ React.createElement(ComputeGraphContextProvider, {
-  registry
-}, /* @__PURE__ */ React.createElement(SheetArticleInner, props));
-var SheetArticleInner = ({ role, subject: sheet, attendableId, space, ignoreAttention }) => {
-  const graph = useComputeGraph(space);
-  if (!graph) {
-    return null;
-  }
-  return /* @__PURE__ */ React.createElement(Sheet.Root, {
-    graph,
-    sheet,
-    attendableId,
-    ignoreAttention
-  }, /* @__PURE__ */ React.createElement(Panel.Root, {
-    classNames: role === AppSurface.Section.role && "aspect-square"
-  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Sheet.Toolbar, null)), /* @__PURE__ */ React.createElement(Panel.Content, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Sheet.Content, null)), /* @__PURE__ */ React.createElement(Panel.Statusbar, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Sheet.Statusbar, null))));
-};
-export {
-  SheetArticle as default
-};
-//# sourceMappingURL=SheetArticle-IUPQYGUU.mjs.map

package/dist/lib/neutral/SheetArticle-IUPQYGUU.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/SheetArticle/SheetArticle.tsx"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { type ComputeGraphRegistry } from '@dxos/compute-hyperformula';\nimport { type Space } from '@dxos/react-client/echo';\nimport { Panel } from '@dxos/react-ui';\n\nimport { ComputeGraphContextProvider, Sheet, useComputeGraph } from '#components';\nimport { type Sheet as SheetType } from '#types';\n\nexport type SheetArticleProps = AppSurface.ObjectArticleProps<\n  SheetType.Sheet,\n  {\n    space: Space;\n    registry: ComputeGraphRegistry;\n    ignoreAttention?: boolean;\n  }\n>;\n\nexport const SheetArticle = ({ registry, ...props }: SheetArticleProps) => (\n  <ComputeGraphContextProvider registry={registry}>\n    <SheetArticleInner {...props} />\n  </ComputeGraphContextProvider>\n);\n\nconst SheetArticleInner = ({\n  role,\n  subject: sheet,\n  attendableId,\n  space,\n  ignoreAttention,\n}: Omit<SheetArticleProps, 'registry'>) => {\n  const graph = useComputeGraph(space);\n  if (!graph) {\n    return null;\n  }\n\n  return (\n    <Sheet.Root graph={graph} sheet={sheet} attendableId={attendableId!} ignoreAttention={ignoreAttention}>\n      <Panel.Root classNames={role === AppSurface.Section.role && 'aspect-square'}>\n        <Panel.Toolbar asChild>\n          <Sheet.Toolbar />\n        </Panel.Toolbar>\n        <Panel.Content asChild>\n          <Sheet.Content />\n        </Panel.Content>\n        <Panel.Statusbar asChild>\n          <Sheet.Statusbar />\n        </Panel.Statusbar>\n      </Panel.Root>\n    </Sheet.Root>\n  );\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,WAAW;AAElB,SAASC,kBAAkB;AAG3B,SAASC,aAAa;AAEtB,SAASC,6BAA6BC,OAAOC,uBAAuB;AAY7D,IAAMC,eAAe,CAAC,EAAEC,UAAU,GAAGC,MAAAA,MAC1C,sBAAA,cAACL,6BAAAA;EAA4BI;GAC3B,sBAAA,cAACE,mBAAsBD,KAAAA,CAAAA;AAI3B,IAAMC,oBAAoB,CAAC,EACzBC,MACAC,SAASC,OACTC,cACAC,OACAC,gBAAe,MACqB;AACpC,QAAMC,QAAQX,gBAAgBS,KAAAA;AAC9B,MAAI,CAACE,OAAO;AACV,WAAO;EACT;AAEA,SACE,sBAAA,cAACZ,MAAMa,MAAI;IAACD;IAAcJ;IAAcC;IAA6BE;KACnE,sBAAA,cAACb,MAAMe,MAAI;IAACC,YAAYR,SAAST,WAAWkB,QAAQT,QAAQ;KAC1D,sBAAA,cAACR,MAAMkB,SAAO;IAACC,SAAAA;KACb,sBAAA,cAACjB,MAAMgB,SAAO,IAAA,CAAA,GAEhB,sBAAA,cAAClB,MAAMoB,SAAO;IAACD,SAAAA;KACb,sBAAA,cAACjB,MAAMkB,SAAO,IAAA,CAAA,GAEhB,sBAAA,cAACpB,MAAMqB,WAAS;IAACF,SAAAA;KACf,sBAAA,cAACjB,MAAMmB,WAAS,IAAA,CAAA,CAAA,CAAA;AAK1B;",
-  "names": ["React", "AppSurface", "Panel", "ComputeGraphContextProvider", "Sheet", "useComputeGraph", "SheetArticle", "registry", "props", "SheetArticleInner", "role", "subject", "sheet", "attendableId", "space", "ignoreAttention", "graph", "Root", "classNames", "Section", "Toolbar", "asChild", "Content", "Statusbar"]
-}

package/dist/lib/neutral/SheetPlugin.mjs

@@ -1,61 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/SheetPlugin.tsx
-import { ActivationEvent, ActivationEvents, Plugin } from "@dxos/app-framework";
-import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
-import { ClientEvents } from "@dxos/plugin-client";
-import { MarkdownEvents } from "@dxos/plugin-markdown";
-import { AnchorSort, CommentConfig, ComputeGraphRegistry, CreateObject, Markdown, OperationHandler, ReactSurface, SheetState, SkillDefinition, UndoMappings } from "#capabilities";
-import { meta } from "#meta";
-import { translations } from "#translations";
-import { Sheet } from "#types";
-
-// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-sheet/PLUGIN.mdl
-var PLUGIN_default = '---\nid: org.dxos.plugin.sheet\nname: SheetPlugin\nversion: 0.1.0\n---\n\nSpreadsheet plugin for `DXOS` Composer \u2014 a full-featured grid backed by ECHO for local-first, real-time collaborative data entry, formula evaluation, and structured data display.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`        |\n| `feat`      | `org.dxos.mdl.feat@1.0`        |\n| `test`      | `org.dxos.mdl.test@1.0`        |\n| `component` | `org.dxos.mdl.component@1.0`   |\n| `op`        | `org.dxos.mdl.op@1.0`          |\n\n## Types\n\n```mdl\ntype CellValue\n  fields:\n    value: any                   # scalar: string | number | boolean | formula string\n```\n\n```mdl\ntype RowColumnMeta\n  fields:\n    size?: number                # pixel width/height; absent means default\n```\n\n```mdl\ntype Range\n  fields:\n    range: string                # A1-notation range (e.g. "A1:C3")\n    key: string                  # formatting key: alignment | comment | style\n    value: string                # formatting value (e.g. "center", "highlight")\n```\n\n```mdl\ntype Axis\n  literals: row | col\n```\n\n```mdl\ntype Sheet\n  typename: org.dxos.type.sheet\n  fields:\n    name?: string\n    cells: Map<string, CellValue>    # sparse map keyed by internal cell index\n    rows: string[]                   # ordered row indices\n    columns: string[]                # ordered column indices\n    rowMeta: Map<string, RowColumnMeta>\n    columnMeta: Map<string, RowColumnMeta>\n    ranges: Range[]                  # range-based formatting annotations\n```\n\n## Components\n\n```mdl\ncomponent SheetArticle\n  desc: Primary spreadsheet view rendered inside an article or section role surface.\n  props:\n    subject: Sheet\n    attendableId: string\n    space: Space\n    registry: ComputeGraphRegistry\n  state:\n    selected?: CellAddress\n    activeRefs?: GridContentProps[\'activeRefs\']\n  slots:\n    toolbar?: ReactNode\n  actions:\n    selectCell(address: CellAddress)\n    editCell(address: CellAddress, value: any)\n    insertRow(index: number)\n    insertColumn(index: number)\n    dropRow(axisIndex: string)\n    dropColumn(axisIndex: string)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]                    \u2502\n    \u251C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502   \u2502 A \u2502 B \u2502 C \u2502  \u2026  column header \u2502\n    \u251C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2524                   \u2502\n    \u2502 1 \u2502   \u2502   \u2502   \u2502   cell grid       \u2502\n    \u251C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2524                   \u2502\n    \u2502 2 \u2502   \u2502   \u2502   \u2502                   \u2502\n    \u2502 \u2026 \u2502   \u2502   \u2502   \u2502                   \u2502\n    \u2514\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent RangeList\n  desc: Object-properties panel listing named ranges and formatting annotations on a Sheet.\n  props:\n    sheet: Sheet\n  state:\n    selected?: Range\n  actions:\n    addRange(range: Range)\n    removeRange(range: Range)\n    updateRange(range: Range)\n```\n\n## Operations\n\n```mdl\nop insertAxis\n  desc: Inserts one or more rows or columns at the given index in the sheet model.\n  input:\n    model: SheetModel\n    axis: Axis\n    index: number\n    count?: number               # defaults to 1\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop dropAxis\n  desc: Removes a row or column by axis index, returning data needed to restore it (undo).\n  input:\n    model: SheetModel\n    axis: Axis\n    axisIndex: string\n  output: DropAxisOutput         # axis, axisIndex, index, axisMeta, values\n  effects: [echo:write]\n```\n\n```mdl\nop restoreAxis\n  desc: Restores a previously dropped row or column (undo of dropAxis).\n  input:\n    model: SheetModel\n    axis: Axis\n    axisIndex: string            # original axis index to restore\n    index: number                # original position\n    axisMeta: RowColumnMeta\n    values: any[]                # cell values to re-insert\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop scrollToAnchor\n  desc: Programmatically scrolls and highlights a cell range in an active grid instance.\n  input:\n    subject: string              # attendable ID of the target sheet\n    cursor: string               # A1-notation cell or range\n    ref?: any                    # active refs for highlight overlay\n  output: void\n  effects: [ui:scroll]\n```\n\n## Features\n\n```mdl\nfeat F-1: Sheet Object\n\n  req F-1.1: A Sheet is an ECHO object with typename org.dxos.type.sheet persisted in the user\'s space.\n  req F-1.2: Cells are stored in a sparse map keyed by internal row/column indices.\n  req F-1.3: Row and column order is maintained via ordered index arrays; insertion/deletion preserves existing cell references.\n  req F-1.4: Range-based formatting annotations are stored as a flat array on the Sheet object.\n```\n\n```mdl\nfeat F-2: Formula Evaluation\n\n  req F-2.1: Formulas are prefixed with "=" and evaluated by the HyperFormula engine via the ComputeGraph.\n  req F-2.2: Over 400 built-in functions are available (arithmetic, statistical, text, date/time, financial, logical).\n  req F-2.3:\n    when: a cell value changes\n    then: all dependent formula cells are recomputed reactively\n  req F-2.4: Cell references in stored formulas are translated to internal indices; A1-notation is converted on read/write.\n```\n\n```mdl\nfeat F-3: Row and Column Management\n\n  req F-3.1:\n    when: op:insertAxis is called\n    then: a new row or column is inserted at the specified index; existing cells shift accordingly\n\n  req F-3.2:\n    when: op:dropAxis is called\n    then: the row or column is removed and undo data returned; op:restoreAxis reverses the operation\n\n  req F-3.3: Row and column sizes are persisted in rowMeta/columnMeta; absent size means default grid size.\n```\n\n```mdl\nfeat F-4: Cell Formatting\n\n  req F-4.1: Ranges support alignment values: start | center | end.\n  req F-4.2: Ranges support comment annotations displayed as a visual overlay on the cell.\n  req F-4.3: Ranges support style values: highlight | softwrap.\n  req F-4.4: RangeList in the object-properties surface allows users to view and manage range annotations.\n```\n\n```mdl\nfeat F-5: Collaborative Editing\n\n  req F-5.1: All cell edits are written through ECHO and replicated to peers in real time.\n  req F-5.2:\n    when: a peer writes a cell value\n    then: the local grid re-renders with the updated value without full reload\n\n  req F-5.3: ComputeGraphRegistry manages per-space HyperFormula instances so all peers share the same formula graph.\n```\n\n```mdl\nfeat F-6: Markdown Integration\n\n  req F-6.1: SheetPlugin contributes a CodeMirror extension to plugin-markdown via MarkdownCapabilities.ExtensionProvider.\n  req F-6.2:\n    when: the extension is active in a document that belongs to a space\n    then: formula references inside Markdown fenced code blocks resolve against the space\'s ComputeGraph\n```\n\n```mdl\nfeat F-7: Anchor Navigation\n\n  req F-7.1:\n    when: op:scrollToAnchor is invoked with a sheet attendable ID and cursor\n    then: the corresponding SheetArticle scrolls to the target cell and applies the active-ref highlight\n\n  req F-7.2: AnchorSort contributes a sort comparator so sheet anchors appear in canonical order in navigation menus.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create sheet and enter a value\n  given: a new Sheet is created in a space\n  when: user types "42" into cell A1\n  then:\n    - Sheet.cells contains an entry for the A1 index with value 42\n    - grid displays "42" in the A1 cell\n```\n\n```mdl\ntest T-2: Formula evaluation\n  given: A1 = 10, A2 = 20\n  when: user enters "=A1+A2" in A3\n  then:\n    - A3 displays 30\n    - changing A1 to 15 causes A3 to update to 35\n```\n\n```mdl\ntest T-3: Insert and drop row\n  given: a Sheet with values in rows 1 and 2\n  when: op:insertAxis runs with axis=row, index=1\n  then:\n    - a blank row is inserted between existing rows 1 and 2\n    - existing cell references remain valid\n\n  when: op:dropAxis runs on the inserted row\n  then:\n    - the row is removed\n    - op:restoreAxis re-inserts the row with its original values\n```\n\n```mdl\ntest T-4: Range formatting\n  given: a Sheet open in SheetArticle\n  when: user applies "highlight" style to range B2:C4\n  then:\n    - Sheet.ranges contains an entry with range="B2:C4", key="style", value="highlight"\n    - cells in B2:C4 render with the highlight background class\n```\n\n```mdl\ntest T-5: Real-time collaboration\n  given: two peers have the same Sheet open\n  when: peer A sets cell D5 to "hello"\n  then:\n    - peer B\'s grid displays "hello" in D5 without reload\n```\n\n```mdl\ntest T-6: Scroll to anchor\n  given: a SheetArticle is mounted with attendableId "sheet-1"\n  when: op:scrollToAnchor runs with subject="sheet-1", cursor="E10"\n  then:\n    - the grid scrolls so that E10 is visible\n    - E10 is highlighted via activeRefs\n```\n\n---\n\n## Appendix: Extension Definitions\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n';
-
-// src/SheetPlugin.tsx
-var SheetPlugin = Plugin.define(meta).pipe(AppPlugin.addSkillDefinitionModule({
-  activate: SkillDefinition
-}), AppPlugin.addCommentConfigModule({
-  activate: CommentConfig
-}), AppPlugin.addCreateObjectModule({
-  activate: CreateObject
-}), AppPlugin.addOperationHandlerModule({
-  activate: OperationHandler
-}), AppPlugin.addUndoMappingsModule({
-  activate: UndoMappings
-}), AppPlugin.addSchemaModule({
-  schema: [
-    Sheet.Sheet
-  ]
-}), AppPlugin.addSurfaceModule({
-  activate: ReactSurface
-}), AppPlugin.addTranslationsModule({
-  translations
-}), Plugin.addModule({
-  activatesOn: AppActivationEvents.SetupSettings,
-  activate: SheetState
-}), Plugin.addModule({
-  activatesOn: ActivationEvent.allOf(ClientEvents.ClientReady, ActivationEvents.ProcessManagerReady),
-  activate: ComputeGraphRegistry
-}), Plugin.addModule({
-  activatesOn: MarkdownEvents.SetupExtensions,
-  activate: Markdown
-}), Plugin.addModule({
-  // TODO(wittjosiah): More relevant event?
-  activatesOn: AppActivationEvents.AppGraphReady,
-  activate: AnchorSort
-}), AppPlugin.addPluginAssetModule({
-  asset: {
-    pluginId: meta.profile.key,
-    path: "PLUGIN.mdl",
-    content: PLUGIN_default,
-    mimeType: "application/x-mdl"
-  }
-}), Plugin.make);
-var SheetPlugin_default = SheetPlugin;
-export {
-  SheetPlugin,
-  SheetPlugin_default as default
-};
-//# sourceMappingURL=SheetPlugin.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/SheetPlugin.tsx", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-sheet/PLUGIN.mdl"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { ActivationEvent, ActivationEvents, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { ClientEvents } from '@dxos/plugin-client';\nimport { MarkdownEvents } from '@dxos/plugin-markdown';\n\nimport {\n  AnchorSort,\n  CommentConfig,\n  ComputeGraphRegistry,\n  CreateObject,\n  Markdown,\n  OperationHandler,\n  ReactSurface,\n  SheetState,\n  SkillDefinition,\n  UndoMappings,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Sheet } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addCommentConfigModule({ activate: CommentConfig }),\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),\n  AppPlugin.addSchemaModule({ schema: [Sheet.Sheet] }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    activatesOn: AppActivationEvents.SetupSettings,\n    activate: SheetState,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ClientEvents.ClientReady, ActivationEvents.ProcessManagerReady),\n    activate: ComputeGraphRegistry,\n  }),\n  Plugin.addModule({\n    activatesOn: MarkdownEvents.SetupExtensions,\n    activate: Markdown,\n  }),\n  Plugin.addModule({\n    // TODO(wittjosiah): More relevant event?\n    activatesOn: AppActivationEvents.AppGraphReady,\n    activate: AnchorSort,\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n", "---\nid: org.dxos.plugin.sheet\nname: SheetPlugin\nversion: 0.1.0\n---\n\nSpreadsheet plugin for `DXOS` Composer \u2014 a full-featured grid backed by ECHO for local-first, real-time collaborative data entry, formula evaluation, and structured data display.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`        |\n| `feat`      | `org.dxos.mdl.feat@1.0`        |\n| `test`      | `org.dxos.mdl.test@1.0`        |\n| `component` | `org.dxos.mdl.component@1.0`   |\n| `op`        | `org.dxos.mdl.op@1.0`          |\n\n## Types\n\n```mdl\ntype CellValue\n  fields:\n    value: any                   # scalar: string | number | boolean | formula string\n```\n\n```mdl\ntype RowColumnMeta\n  fields:\n    size?: number                # pixel width/height; absent means default\n```\n\n```mdl\ntype Range\n  fields:\n    range: string                # A1-notation range (e.g. \"A1:C3\")\n    key: string                  # formatting key: alignment | comment | style\n    value: string                # formatting value (e.g. \"center\", \"highlight\")\n```\n\n```mdl\ntype Axis\n  literals: row | col\n```\n\n```mdl\ntype Sheet\n  typename: org.dxos.type.sheet\n  fields:\n    name?: string\n    cells: Map<string, CellValue>    # sparse map keyed by internal cell index\n    rows: string[]                   # ordered row indices\n    columns: string[]                # ordered column indices\n    rowMeta: Map<string, RowColumnMeta>\n    columnMeta: Map<string, RowColumnMeta>\n    ranges: Range[]                  # range-based formatting annotations\n```\n\n## Components\n\n```mdl\ncomponent SheetArticle\n  desc: Primary spreadsheet view rendered inside an article or section role surface.\n  props:\n    subject: Sheet\n    attendableId: string\n    space: Space\n    registry: ComputeGraphRegistry\n  state:\n    selected?: CellAddress\n    activeRefs?: GridContentProps['activeRefs']\n  slots:\n    toolbar?: ReactNode\n  actions:\n    selectCell(address: CellAddress)\n    editCell(address: CellAddress, value: any)\n    insertRow(index: number)\n    insertColumn(index: number)\n    dropRow(axisIndex: string)\n    dropColumn(axisIndex: string)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]                    \u2502\n    \u251C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502   \u2502 A \u2502 B \u2502 C \u2502  \u2026  column header \u2502\n    \u251C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2524                   \u2502\n    \u2502 1 \u2502   \u2502   \u2502   \u2502   cell grid       \u2502\n    \u251C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2524                   \u2502\n    \u2502 2 \u2502   \u2502   \u2502   \u2502                   \u2502\n    \u2502 \u2026 \u2502   \u2502   \u2502   \u2502                   \u2502\n    \u2514\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent RangeList\n  desc: Object-properties panel listing named ranges and formatting annotations on a Sheet.\n  props:\n    sheet: Sheet\n  state:\n    selected?: Range\n  actions:\n    addRange(range: Range)\n    removeRange(range: Range)\n    updateRange(range: Range)\n```\n\n## Operations\n\n```mdl\nop insertAxis\n  desc: Inserts one or more rows or columns at the given index in the sheet model.\n  input:\n    model: SheetModel\n    axis: Axis\n    index: number\n    count?: number               # defaults to 1\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop dropAxis\n  desc: Removes a row or column by axis index, returning data needed to restore it (undo).\n  input:\n    model: SheetModel\n    axis: Axis\n    axisIndex: string\n  output: DropAxisOutput         # axis, axisIndex, index, axisMeta, values\n  effects: [echo:write]\n```\n\n```mdl\nop restoreAxis\n  desc: Restores a previously dropped row or column (undo of dropAxis).\n  input:\n    model: SheetModel\n    axis: Axis\n    axisIndex: string            # original axis index to restore\n    index: number                # original position\n    axisMeta: RowColumnMeta\n    values: any[]                # cell values to re-insert\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop scrollToAnchor\n  desc: Programmatically scrolls and highlights a cell range in an active grid instance.\n  input:\n    subject: string              # attendable ID of the target sheet\n    cursor: string               # A1-notation cell or range\n    ref?: any                    # active refs for highlight overlay\n  output: void\n  effects: [ui:scroll]\n```\n\n## Features\n\n```mdl\nfeat F-1: Sheet Object\n\n  req F-1.1: A Sheet is an ECHO object with typename org.dxos.type.sheet persisted in the user's space.\n  req F-1.2: Cells are stored in a sparse map keyed by internal row/column indices.\n  req F-1.3: Row and column order is maintained via ordered index arrays; insertion/deletion preserves existing cell references.\n  req F-1.4: Range-based formatting annotations are stored as a flat array on the Sheet object.\n```\n\n```mdl\nfeat F-2: Formula Evaluation\n\n  req F-2.1: Formulas are prefixed with \"=\" and evaluated by the HyperFormula engine via the ComputeGraph.\n  req F-2.2: Over 400 built-in functions are available (arithmetic, statistical, text, date/time, financial, logical).\n  req F-2.3:\n    when: a cell value changes\n    then: all dependent formula cells are recomputed reactively\n  req F-2.4: Cell references in stored formulas are translated to internal indices; A1-notation is converted on read/write.\n```\n\n```mdl\nfeat F-3: Row and Column Management\n\n  req F-3.1:\n    when: op:insertAxis is called\n    then: a new row or column is inserted at the specified index; existing cells shift accordingly\n\n  req F-3.2:\n    when: op:dropAxis is called\n    then: the row or column is removed and undo data returned; op:restoreAxis reverses the operation\n\n  req F-3.3: Row and column sizes are persisted in rowMeta/columnMeta; absent size means default grid size.\n```\n\n```mdl\nfeat F-4: Cell Formatting\n\n  req F-4.1: Ranges support alignment values: start | center | end.\n  req F-4.2: Ranges support comment annotations displayed as a visual overlay on the cell.\n  req F-4.3: Ranges support style values: highlight | softwrap.\n  req F-4.4: RangeList in the object-properties surface allows users to view and manage range annotations.\n```\n\n```mdl\nfeat F-5: Collaborative Editing\n\n  req F-5.1: All cell edits are written through ECHO and replicated to peers in real time.\n  req F-5.2:\n    when: a peer writes a cell value\n    then: the local grid re-renders with the updated value without full reload\n\n  req F-5.3: ComputeGraphRegistry manages per-space HyperFormula instances so all peers share the same formula graph.\n```\n\n```mdl\nfeat F-6: Markdown Integration\n\n  req F-6.1: SheetPlugin contributes a CodeMirror extension to plugin-markdown via MarkdownCapabilities.ExtensionProvider.\n  req F-6.2:\n    when: the extension is active in a document that belongs to a space\n    then: formula references inside Markdown fenced code blocks resolve against the space's ComputeGraph\n```\n\n```mdl\nfeat F-7: Anchor Navigation\n\n  req F-7.1:\n    when: op:scrollToAnchor is invoked with a sheet attendable ID and cursor\n    then: the corresponding SheetArticle scrolls to the target cell and applies the active-ref highlight\n\n  req F-7.2: AnchorSort contributes a sort comparator so sheet anchors appear in canonical order in navigation menus.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create sheet and enter a value\n  given: a new Sheet is created in a space\n  when: user types \"42\" into cell A1\n  then:\n    - Sheet.cells contains an entry for the A1 index with value 42\n    - grid displays \"42\" in the A1 cell\n```\n\n```mdl\ntest T-2: Formula evaluation\n  given: A1 = 10, A2 = 20\n  when: user enters \"=A1+A2\" in A3\n  then:\n    - A3 displays 30\n    - changing A1 to 15 causes A3 to update to 35\n```\n\n```mdl\ntest T-3: Insert and drop row\n  given: a Sheet with values in rows 1 and 2\n  when: op:insertAxis runs with axis=row, index=1\n  then:\n    - a blank row is inserted between existing rows 1 and 2\n    - existing cell references remain valid\n\n  when: op:dropAxis runs on the inserted row\n  then:\n    - the row is removed\n    - op:restoreAxis re-inserts the row with its original values\n```\n\n```mdl\ntest T-4: Range formatting\n  given: a Sheet open in SheetArticle\n  when: user applies \"highlight\" style to range B2:C4\n  then:\n    - Sheet.ranges contains an entry with range=\"B2:C4\", key=\"style\", value=\"highlight\"\n    - cells in B2:C4 render with the highlight background class\n```\n\n```mdl\ntest T-5: Real-time collaboration\n  given: two peers have the same Sheet open\n  when: peer A sets cell D5 to \"hello\"\n  then:\n    - peer B's grid displays \"hello\" in D5 without reload\n```\n\n```mdl\ntest T-6: Scroll to anchor\n  given: a SheetArticle is mounted with attendableId \"sheet-1\"\n  when: op:scrollToAnchor runs with subject=\"sheet-1\", cursor=\"E10\"\n  then:\n    - the grid scrolls so that E10 is visible\n    - E10 is highlighted via activeRefs\n```\n\n---\n\n## Appendix: Extension Definitions\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n"],
-  "mappings": ";;;AAIA,SAASA,iBAAiBC,kBAAkBC,cAAc;AAC1D,SAASC,qBAAqBC,iBAAiB;AAC/C,SAASC,oBAAoB;AAC7B,SAASC,sBAAsB;AAE/B,SACEC,YACAC,eACAC,sBACAC,cACAC,UACAC,kBACAC,cACAC,YACAC,iBACAC,oBACK;AACP,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,aAAa;;;ACvBtB;;;AD4BO,IAAMC,cAAcC,OAAOC,OAAOC,IAAAA,EAAMC,KAC7CC,UAAUC,yBAAyB;EAAEC,UAAUC;AAAgB,CAAA,GAC/DH,UAAUI,uBAAuB;EAAEF,UAAUG;AAAc,CAAA,GAC3DL,UAAUM,sBAAsB;EAAEJ,UAAUK;AAAa,CAAA,GACzDP,UAAUQ,0BAA0B;EAAEN,UAAUO;AAAiB,CAAA,GACjET,UAAUU,sBAAsB;EAAER,UAAUS;AAAa,CAAA,GACzDX,UAAUY,gBAAgB;EAAEC,QAAQ;IAACC,MAAMA;;AAAO,CAAA,GAClDd,UAAUe,iBAAiB;EAAEb,UAAUc;AAAa,CAAA,GACpDhB,UAAUiB,sBAAsB;EAAEC;AAAa,CAAA,GAC/CtB,OAAOuB,UAAU;EACfC,aAAaC,oBAAoBC;EACjCpB,UAAUqB;AACZ,CAAA,GACA3B,OAAOuB,UAAU;EACfC,aAAaI,gBAAgBC,MAAMC,aAAaC,aAAaC,iBAAiBC,mBAAmB;EACjG3B,UAAU4B;AACZ,CAAA,GACAlC,OAAOuB,UAAU;EACfC,aAAaW,eAAeC;EAC5B9B,UAAU+B;AACZ,CAAA,GACArC,OAAOuB,UAAU;;EAEfC,aAAaC,oBAAoBa;EACjChC,UAAUiC;AACZ,CAAA,GACAnC,UAAUoC,qBAAqB;EAC7BC,OAAO;IAAEC,UAAUxC,KAAKyC,QAAQC;IAAKC,MAAM;IAAcC,SAASC;IAAYC,UAAU;EAAoB;AAC9G,CAAA,GACAhD,OAAOiD,IAAI;AAGb,IAAA,sBAAelD;",
-  "names": ["ActivationEvent", "ActivationEvents", "Plugin", "AppActivationEvents", "AppPlugin", "ClientEvents", "MarkdownEvents", "AnchorSort", "CommentConfig", "ComputeGraphRegistry", "CreateObject", "Markdown", "OperationHandler", "ReactSurface", "SheetState", "SkillDefinition", "UndoMappings", "meta", "translations", "Sheet", "SheetPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addSkillDefinitionModule", "activate", "SkillDefinition", "addCommentConfigModule", "CommentConfig", "addCreateObjectModule", "CreateObject", "addOperationHandlerModule", "OperationHandler", "addUndoMappingsModule", "UndoMappings", "addSchemaModule", "schema", "Sheet", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "addModule", "activatesOn", "AppActivationEvents", "SetupSettings", "SheetState", "ActivationEvent", "allOf", "ClientEvents", "ClientReady", "ActivationEvents", "ProcessManagerReady", "ComputeGraphRegistry", "MarkdownEvents", "SetupExtensions", "Markdown", "AppGraphReady", "AnchorSort", "addPluginAssetModule", "asset", "pluginId", "profile", "key", "path", "content", "pluginSpec", "mimeType", "make"]
-}

package/dist/lib/neutral/SheetPlugin.node.mjs

@@ -1,27 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/SheetPlugin.node.ts
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { CommentConfig, CreateObject, OperationHandler, UndoMappings } from "#capabilities";
-import { meta } from "#meta";
-import { Sheet } from "#types";
-var SheetPlugin = Plugin.define(meta).pipe(AppPlugin.addCommentConfigModule({
-  activate: CommentConfig
-}), AppPlugin.addCreateObjectModule({
-  activate: CreateObject
-}), AppPlugin.addOperationHandlerModule({
-  activate: OperationHandler
-}), AppPlugin.addUndoMappingsModule({
-  activate: UndoMappings
-}), AppPlugin.addSchemaModule({
-  schema: [
-    Sheet.Sheet
-  ]
-}), Plugin.make);
-var SheetPlugin_node_default = SheetPlugin;
-export {
-  SheetPlugin,
-  SheetPlugin_node_default as default
-};
-//# sourceMappingURL=SheetPlugin.node.mjs.map

package/dist/lib/neutral/SheetPlugin.node.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/SheetPlugin.node.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { CommentConfig, CreateObject, OperationHandler, UndoMappings } from '#capabilities';\nimport { meta } from '#meta';\nimport { Sheet } from '#types';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCommentConfigModule({ activate: CommentConfig }),\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addUndoMappingsModule({ activate: UndoMappings }),\n  AppPlugin.addSchemaModule({ schema: [Sheet.Sheet] }),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n"],
-  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,eAAeC,cAAcC,kBAAkBC,oBAAoB;AAC5E,SAASC,YAAY;AACrB,SAASC,aAAa;AAEf,IAAMC,cAAcR,OAAOS,OAAOH,IAAAA,EAAMI,KAC7CT,UAAUU,uBAAuB;EAAEC,UAAUV;AAAc,CAAA,GAC3DD,UAAUY,sBAAsB;EAAED,UAAUT;AAAa,CAAA,GACzDF,UAAUa,0BAA0B;EAAEF,UAAUR;AAAiB,CAAA,GACjEH,UAAUc,sBAAsB;EAAEH,UAAUP;AAAa,CAAA,GACzDJ,UAAUe,gBAAgB;EAAEC,QAAQ;IAACV,MAAMA;;AAAO,CAAA,GAClDP,OAAOkB,IAAI;AAGb,IAAA,2BAAeV;",
-  "names": ["Plugin", "AppPlugin", "CommentConfig", "CreateObject", "OperationHandler", "UndoMappings", "meta", "Sheet", "SheetPlugin", "define", "pipe", "addCommentConfigModule", "activate", "addCreateObjectModule", "addOperationHandlerModule", "addUndoMappingsModule", "addSchemaModule", "schema", "make"]
-}

package/dist/lib/neutral/SheetPlugin.workerd.mjs

@@ -1,21 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/SheetPlugin.workerd.ts
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { OperationHandler } from "#capabilities";
-import { meta } from "#meta";
-import { Sheet } from "#types";
-var SheetPlugin = Plugin.define(meta).pipe(AppPlugin.addOperationHandlerModule({
-  activate: OperationHandler
-}), AppPlugin.addSchemaModule({
-  schema: [
-    Sheet.Sheet
-  ]
-}), Plugin.make);
-var SheetPlugin_workerd_default = SheetPlugin;
-export {
-  SheetPlugin,
-  SheetPlugin_workerd_default as default
-};
-//# sourceMappingURL=SheetPlugin.workerd.mjs.map

package/dist/lib/neutral/SheetPlugin.workerd.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/SheetPlugin.workerd.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\nimport { Sheet } from '#types';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [Sheet.Sheet] }),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n"],
-  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,wBAAwB;AACjC,SAASC,YAAY;AACrB,SAASC,aAAa;AAEf,IAAMC,cAAcL,OAAOM,OAAOH,IAAAA,EAAMI,KAC7CN,UAAUO,0BAA0B;EAAEC,UAAUP;AAAiB,CAAA,GACjED,UAAUS,gBAAgB;EAAEC,QAAQ;IAACP,MAAMA;;AAAO,CAAA,GAClDJ,OAAOY,IAAI;AAGb,IAAA,8BAAeP;",
-  "names": ["Plugin", "AppPlugin", "OperationHandler", "meta", "Sheet", "SheetPlugin", "define", "pipe", "addOperationHandlerModule", "activate", "addSchemaModule", "schema", "make"]
-}

package/dist/lib/neutral/anchor-sort-2POWTKTD.mjs

@@ -1,22 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/capabilities/anchor-sort.ts
-import * as Effect from "effect/Effect";
-import { Capability } from "@dxos/app-framework";
-import { AppCapabilities } from "@dxos/app-toolkit";
-import { Relation, Type } from "@dxos/echo";
-import { Sheet, compareIndexPositions } from "#types";
-var anchor_sort_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(AppCapabilities.AnchorSort, {
-  key: Type.getTypename(Sheet.Sheet),
-  sort: (anchorA, anchorB) => {
-    const sheet = Relation.getTarget(anchorA);
-    if (sheet !== Relation.getTarget(anchorB)) {
-      return 0;
-    }
-    return !anchorA.anchor || !anchorB.anchor ? 0 : compareIndexPositions(sheet, anchorA.anchor, anchorB.anchor);
-  }
-})));
-export {
-  anchor_sort_default as default
-};
-//# sourceMappingURL=anchor-sort-2POWTKTD.mjs.map

package/dist/lib/neutral/anchor-sort-2POWTKTD.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/anchor-sort.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { Relation, Type } from '@dxos/echo';\n\nimport { Sheet, compareIndexPositions } from '#types';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contributes(AppCapabilities.AnchorSort, {\n      key: Type.getTypename(Sheet.Sheet),\n      sort: (anchorA, anchorB) => {\n        const sheet = Relation.getTarget(anchorA) as Sheet.Sheet;\n        if (sheet !== Relation.getTarget(anchorB)) {\n          return 0;\n        }\n\n        return !anchorA.anchor || !anchorB.anchor ? 0 : compareIndexPositions(sheet, anchorA.anchor, anchorB.anchor);\n      },\n    }),\n  ),\n);\n"],
-  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAC3B,SAASC,uBAAuB;AAChC,SAASC,UAAUC,YAAY;AAE/B,SAASC,OAAOC,6BAA6B;AAE7C,IAAA,sBAAeL,WAAWM,WAAW,MAC5BC,eACLP,WAAWQ,YAAYP,gBAAgBQ,YAAY;EACjDC,KAAKP,KAAKQ,YAAYP,MAAMA,KAAK;EACjCQ,MAAM,CAACC,SAASC,YAAAA;AACd,UAAMC,QAAQb,SAASc,UAAUH,OAAAA;AACjC,QAAIE,UAAUb,SAASc,UAAUF,OAAAA,GAAU;AACzC,aAAO;IACT;AAEA,WAAO,CAACD,QAAQI,UAAU,CAACH,QAAQG,SAAS,IAAIZ,sBAAsBU,OAAOF,QAAQI,QAAQH,QAAQG,MAAM;EAC7G;AACF,CAAA,CAAA,CAAA;",
-  "names": ["Effect", "Capability", "AppCapabilities", "Relation", "Type", "Sheet", "compareIndexPositions", "makeModule", "succeed", "contributes", "AnchorSort", "key", "getTypename", "sort", "anchorA", "anchorB", "sheet", "getTarget", "anchor"]
-}