@dxos/plugin-sheet 0.11.0 → 0.12.0-next-bbabc02363f18d7643ea4160e3a7a7809870fd0d

package/dist/lib/Sheet.mjs

@@ -0,0 +1,70 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { addressToIndex, initialize, mapFormulaRefsToIndices } from "./SheetUtil.mjs";
+import * as Schema from "effect/Schema";
+import * as AppAnnotation from "@dxos/app-toolkit/AppAnnotation";
+import { addressFromA1Notation, isFormula } from "@dxos/compute-hyperformula/types";
+import { Annotation, DXN, Obj, Type } from "@dxos/echo";
+import { FormInputAnnotation } from "@dxos/echo/Annotation";
+import { CollectionItemAnnotation } from "@dxos/schema";
+//#region src/types/Sheet.ts
+var Sheet_exports = /* @__PURE__ */ __exportAll({
+	CellValue: () => CellValue,
+	Range: () => Range,
+	RowColumnMeta: () => RowColumnMeta,
+	SKILL_KEY: () => SKILL_KEY,
+	Sheet: () => Sheet,
+	make: () => make
+});
+var SKILL_KEY = "org.dxos.skill.sheet";
+var CellValue = Schema.Struct({ value: Schema.Any });
+var Range = Schema.Struct({
+	range: Schema.String,
+	key: Schema.String,
+	value: Schema.String
+});
+var RowColumnMeta = Schema.Struct({ size: Schema.optional(Schema.Number) });
+var Sheet = class extends Type.makeObject(DXN.make("org.dxos.type.sheet", "0.1.0"))(Schema.Struct({
+	name: Schema.optional(Schema.String),
+	cells: Schema.Record({
+		key: Schema.String,
+		value: CellValue
+	}).pipe(FormInputAnnotation.set(false)),
+	rows: Schema.Array(Schema.String).pipe(FormInputAnnotation.set(false)),
+	columns: Schema.Array(Schema.String).pipe(FormInputAnnotation.set(false)),
+	rowMeta: Schema.Record({
+		key: Schema.String,
+		value: RowColumnMeta
+	}).pipe(FormInputAnnotation.set(false)),
+	columnMeta: Schema.Record({
+		key: Schema.String,
+		value: RowColumnMeta
+	}).pipe(FormInputAnnotation.set(false)),
+	ranges: Schema.Array(Range).pipe(FormInputAnnotation.set(false))
+}).pipe(Annotation.IconAnnotation.set({
+	icon: "ph--grid-nine--regular",
+	hue: "indigo"
+}), AppAnnotation.SkillsAnnotation.set([SKILL_KEY]), CollectionItemAnnotation.set(true))) {};
+var make = ({ name, cells = {}, ...size } = {}) => {
+	const sheet = Obj.make(Sheet, {
+		name,
+		cells: {},
+		rows: [],
+		columns: [],
+		rowMeta: {},
+		columnMeta: {},
+		ranges: []
+	});
+	Obj.update(sheet, (sheet) => {
+		initialize(sheet, size);
+		if (cells) Object.entries(cells).forEach(([key, { value }]) => {
+			const idx = addressToIndex(sheet, addressFromA1Notation(key));
+			if (isFormula(value)) value = mapFormulaRefsToIndices(sheet, value);
+			sheet.cells[idx] = { value };
+		});
+	});
+	return sheet;
+};
+//#endregion
+export { CellValue, Range, RowColumnMeta, SKILL_KEY, Sheet, make, Sheet_exports as t };
+
+//# sourceMappingURL=Sheet.mjs.map

package/dist/lib/Sheet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sheet.mjs","names":[],"sources":["../../src/types/Sheet.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as AppAnnotation from '@dxos/app-toolkit/AppAnnotation';\nimport { addressFromA1Notation, isFormula } from '@dxos/compute-hyperformula/types';\nimport { Annotation, DXN, Obj, Type } from '@dxos/echo';\nimport { FormInputAnnotation } from '@dxos/echo/Annotation';\nimport { CollectionItemAnnotation } from '@dxos/schema';\n\nimport { addressToIndex, initialize, mapFormulaRefsToIndices } from './SheetUtil';\n\nexport const SKILL_KEY = 'org.dxos.skill.sheet';\n\nexport type SheetSize = {\n  rows: number;\n  columns: number;\n};\n\nexport const CellValue = Schema.Struct({\n  // TODO(burdon): How to store dates (datetime, date, time), percentages, etc.\n  //  Consider import/export; natural access for other plugins. Special handling for currency (precision).\n  // TODO(burdon): Automerge (long string) or short string or number.\n  value: Schema.Any,\n});\n\nexport type CellValue = Schema.Schema.Type<typeof CellValue>;\n\n// TODO(burdon): IMPORTANT: Reconcile with Field definition.\nexport const Range = Schema.Struct({\n  range: Schema.String,\n  key: Schema.String,\n  value: Schema.String,\n});\n\nexport type Range = Schema.Schema.Type<typeof Range>;\n\n// TODO(burdon): Visibility, locked, frozen, etc.\nexport const RowColumnMeta = Schema.Struct({\n  size: Schema.optional(Schema.Number),\n});\n\n// TODO(burdon): Reconcile col/column (across packages).\n// TODO(burdon): Index to all updates when rows/columns are inserted/deleted.\nexport class Sheet extends Type.makeObject<Sheet>(DXN.make('org.dxos.type.sheet', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n\n    // Sparse map of cells referenced by index.\n    cells: Schema.Record({ key: Schema.String, value: CellValue }).pipe(FormInputAnnotation.set(false)),\n\n    // Ordered row indices.\n    rows: Schema.Array(Schema.String).pipe(FormInputAnnotation.set(false)),\n\n    // Ordered column indices.\n    columns: Schema.Array(Schema.String).pipe(FormInputAnnotation.set(false)),\n\n    // Row metadata referenced by index.\n    rowMeta: Schema.Record({ key: Schema.String, value: RowColumnMeta }).pipe(FormInputAnnotation.set(false)),\n\n    // Column metadata referenced by index.\n    columnMeta: Schema.Record({ key: Schema.String, value: RowColumnMeta }).pipe(FormInputAnnotation.set(false)),\n\n    // Cell formatting referenced by indexed range.\n    ranges: Schema.Array(Range).pipe(FormInputAnnotation.set(false)),\n  }).pipe(\n    Annotation.IconAnnotation.set({ icon: 'ph--grid-nine--regular', hue: 'indigo' }),\n    AppAnnotation.SkillsAnnotation.set([SKILL_KEY]),\n    CollectionItemAnnotation.set(true),\n  ),\n) {}\n\nexport type SheetProps = {\n  name?: string;\n  cells?: Record<string, CellValue>;\n} & Partial<SheetSize>;\n\nexport const make = ({ name, cells = {}, ...size }: SheetProps = {}) => {\n  const sheet = Obj.make(Sheet, { name, cells: {}, rows: [], columns: [], rowMeta: {}, columnMeta: {}, ranges: [] });\n\n  // Initialize and set cells within Obj.update to satisfy change context requirements.\n  Obj.update(sheet, (sheet) => {\n    initialize(sheet, size);\n\n    if (cells) {\n      Object.entries(cells).forEach(([key, { value }]) => {\n        const idx = addressToIndex(sheet, addressFromA1Notation(key));\n        if (isFormula(value)) {\n          value = mapFormulaRefsToIndices(sheet, value);\n        }\n\n        sheet.cells[idx] = { value };\n      });\n    }\n  });\n\n  return sheet;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,YAAY;AAOzB,IAAa,YAAY,OAAO,OAAO,EAIrC,OAAO,OAAO,IAChB,CAAC;AAKD,IAAa,QAAQ,OAAO,OAAO;CACjC,OAAO,OAAO;CACd,KAAK,OAAO;CACZ,OAAO,OAAO;AAChB,CAAC;AAKD,IAAa,gBAAgB,OAAO,OAAO,EACzC,MAAM,OAAO,SAAS,OAAO,MAAM,EACrC,CAAC;AAID,IAAa,QAAb,cAA2B,KAAK,WAAkB,IAAI,KAAK,uBAAuB,OAAO,CAAC,CAAC,CACzF,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CAGnC,OAAO,OAAO,OAAO;EAAE,KAAK,OAAO;EAAQ,OAAO;CAAU,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;CAGlG,MAAM,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;CAGrE,SAAS,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;CAGxE,SAAS,OAAO,OAAO;EAAE,KAAK,OAAO;EAAQ,OAAO;CAAc,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;CAGxG,YAAY,OAAO,OAAO;EAAE,KAAK,OAAO;EAAQ,OAAO;CAAc,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;CAG3G,QAAQ,OAAO,MAAM,KAAK,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,CAAC;AACjE,CAAC,CAAC,CAAC,KACD,WAAW,eAAe,IAAI;CAAE,MAAM;CAA0B,KAAK;AAAS,CAAC,GAC/E,cAAc,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAC9C,yBAAyB,IAAI,IAAI,CACnC,CACF,CAAC,CAAC,CAAC;AAOH,IAAa,QAAQ,EAAE,MAAM,QAAQ,CAAC,GAAG,GAAG,SAAqB,CAAC,MAAM;CACtE,MAAM,QAAQ,IAAI,KAAK,OAAO;EAAE;EAAM,OAAO,CAAC;EAAG,MAAM,CAAC;EAAG,SAAS,CAAC;EAAG,SAAS,CAAC;EAAG,YAAY,CAAC;EAAG,QAAQ,CAAC;CAAE,CAAC;CAGjH,IAAI,OAAO,QAAQ,UAAU;EAC3B,WAAW,OAAO,IAAI;EAEtB,IAAI,OACF,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa;GAClD,MAAM,MAAM,eAAe,OAAO,sBAAsB,GAAG,CAAC;GAC5D,IAAI,UAAU,KAAK,GACjB,QAAQ,wBAAwB,OAAO,KAAK;GAG9C,MAAM,MAAM,OAAO,EAAE,MAAM;EAC7B,CAAC;CAEL,CAAC;CAED,OAAO;AACT"}

package/dist/lib/SheetCapabilities.mjs

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { RowColumnMeta } from "./Sheet.mjs";
+import * as Schema from "effect/Schema";
+import * as Capability from "@dxos/app-framework/Capability";
+import { meta } from "#meta";
+//#region src/types/SheetCapabilities.ts
+var SheetCapabilities_exports = /* @__PURE__ */ __exportAll({
+	ComputeGraphRegistry: () => ComputeGraphRegistry,
+	GridInstances: () => GridInstances,
+	SheetAction: () => SheetAction
+});
+var ComputeGraphRegistry = Capability.makeSingleton()(`${meta.profile.key}.capability.computeGraphRegistry`);
+/** Registry of active grid instances keyed by attendable ID. */
+var GridInstances = Capability.makeSingleton()(`${meta.profile.key}.capability.gridInstances`);
+var ActionAxis = Schema.Union(Schema.Literal("row"), Schema.Literal("col"));
+var SheetAction;
+(function(_SheetAction) {
+	_SheetAction.RestoreAxis = Schema.Struct({
+		axis: ActionAxis,
+		axisIndex: Schema.String,
+		index: Schema.Number,
+		axisMeta: RowColumnMeta,
+		values: Schema.Array(Schema.Any)
+	});
+})(SheetAction || (SheetAction = {}));
+//#endregion
+export { ComputeGraphRegistry, GridInstances, SheetAction, SheetCapabilities_exports as t };
+
+//# sourceMappingURL=SheetCapabilities.mjs.map

package/dist/lib/SheetCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetCapabilities.mjs","names":[],"sources":["../../src/types/SheetCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { type ComputeGraphRegistry as ComputeGraphRegistryType } from '@dxos/compute-hyperformula';\nimport { type DxGridElement, type GridContentProps } from '@dxos/react-ui-grid';\n\nimport { meta } from '#meta';\n\nimport * as Sheet from './Sheet';\n\nexport type GridEntry = { grid: DxGridElement; setActiveRefs: (refs: GridContentProps['activeRefs']) => void };\n\nexport type GridRegistry = {\n  register: (attendableId: string, grid: DxGridElement, setActiveRefs: GridEntry['setActiveRefs']) => void;\n  unregister: (attendableId: string) => void;\n  get: (attendableId: string) => GridEntry | undefined;\n};\n\nexport const ComputeGraphRegistry = Capability.makeSingleton<ComputeGraphRegistryType>()(\n  `${meta.profile.key}.capability.computeGraphRegistry`,\n);\n\n/** Registry of active grid instances keyed by attendable ID. */\nexport const GridInstances = Capability.makeSingleton<GridRegistry>()(`${meta.profile.key}.capability.gridInstances`);\n\n// TODO(wittjosiah): Factor out. This is `DxGridAxis` from `@dxos/react-ui-grid`.\nconst ActionAxis = Schema.Union(Schema.Literal('row'), Schema.Literal('col'));\n\nexport namespace SheetAction {\n  export const RestoreAxis = Schema.Struct({\n    axis: ActionAxis,\n    axisIndex: Schema.String,\n    index: Schema.Number,\n    axisMeta: Sheet.RowColumnMeta,\n    values: Schema.Array(Schema.Any),\n  });\n\n  export type RestoreAxis = Schema.Schema.Type<typeof RestoreAxis>;\n}\n"],"mappings":";;;;;;;;;;;AAsBA,IAAa,uBAAuB,WAAW,cAAwC,CAAC,CACtF,GAAG,KAAK,QAAQ,IAAI,iCACtB;;AAGA,IAAa,gBAAgB,WAAW,cAA4B,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,0BAA0B;AAGpH,IAAM,aAAa,OAAO,MAAM,OAAO,QAAQ,KAAK,GAAG,OAAO,QAAQ,KAAK,CAAC;AAErE,IAAA;;CACQ,aAAA,cAAc,OAAO,OAAO;EACvC,MAAM;EACN,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,UAAU;EACV,QAAQ,OAAO,MAAM,OAAO,GAAG;CACjC,CAAC;GAGH,gBAAA,cAAA,CAAA,EAAA"}

package/dist/lib/SheetEvents.mjs

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta } from "#meta";
+import * as ActivationEvent from "@dxos/app-framework/ActivationEvent";
+//#region src/types/SheetEvents.ts
+var SheetEvents_exports = /* @__PURE__ */ __exportAll({ Start: () => Start });
+/**
+* The feature's start event: the plugin's start-gated modules (and cross-plugin
+* contributions consumed by this feature) activate here. Fired on demand and by the
+* host's idle trickle.
+*/
+var Start = ActivationEvent.pluginStart(meta.profile.key);
+//#endregion
+export { Start, SheetEvents_exports as t };
+
+//# sourceMappingURL=SheetEvents.mjs.map

package/dist/lib/SheetEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetEvents.mjs","names":[],"sources":["../../src/types/SheetEvents.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/**\n * The feature's start event: the plugin's start-gated modules (and cross-plugin\n * contributions consumed by this feature) activate here. Fired on demand and by the\n * host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/SheetOperation.mjs

@@ -0,0 +1,141 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Sheet } from "./Sheet.mjs";
+import * as Schema from "effect/Schema";
+import { Database, Ref } from "@dxos/echo";
+import * as Capability from "@dxos/app-framework/Capability";
+import { meta } from "#meta";
+import * as Operation from "@dxos/compute/Operation";
+import { DXN as DXN$1 } from "@dxos/keys";
+//#region src/types/SheetOperation.ts
+var SheetOperation_exports = /* @__PURE__ */ __exportAll({
+	Create: () => Create,
+	DropAxis: () => DropAxis,
+	DropAxisOutput: () => DropAxisOutput,
+	GetValues: () => GetValues,
+	InsertAxis: () => InsertAxis,
+	RestoreAxis: () => RestoreAxis,
+	ScrollToAnchor: () => ScrollToAnchor,
+	SetValues: () => SetValues
+});
+var makeKey = (name) => DXN$1.make(`${meta.profile.key}.operation.${name}`);
+var Axis = Schema.Union(Schema.Literal("row"), Schema.Literal("col"));
+var InsertAxis = Operation.make({
+	meta: {
+		key: makeKey("axisInsert"),
+		name: "Insert Axis",
+		icon: "ph--plus--regular"
+	},
+	input: Schema.Struct({
+		model: Schema.Any,
+		axis: Axis,
+		index: Schema.Number,
+		count: Schema.optional(Schema.Number)
+	}),
+	output: Schema.Void
+});
+var DropAxisOutput = Schema.Struct({
+	axis: Axis.annotations({ description: "The axis type (row or col)." }),
+	axisIndex: Schema.String.annotations({ description: "The dropped axis index." }),
+	index: Schema.Number.annotations({ description: "The position the axis was at." }),
+	axisMeta: Schema.Any.annotations({ description: "The row/column metadata." }),
+	values: Schema.Array(Schema.Any).annotations({ description: "The cell values that were dropped." })
+});
+var DropAxis = Operation.make({
+	meta: {
+		key: makeKey("axisDrop"),
+		name: "Drop Axis",
+		icon: "ph--trash--regular"
+	},
+	input: Schema.Struct({
+		model: Schema.Any,
+		axis: Axis,
+		axisIndex: Schema.String
+	}),
+	output: DropAxisOutput
+});
+var ScrollToAnchor = Operation.make({
+	meta: {
+		key: makeKey("scrollToAnchor"),
+		name: "Scroll To Anchor",
+		icon: "ph--anchor-simple--regular"
+	},
+	services: [Capability.Service],
+	input: Schema.Struct({
+		subject: Schema.String.annotations({ description: "Attendable ID of the sheet." }),
+		cursor: Schema.String.annotations({ description: "Cell range coordinates." }),
+		id: Schema.optional(Schema.Any.annotations({ description: "Active refs for highlighting." }))
+	}),
+	output: Schema.Void
+});
+var Create = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.sheet.create"),
+		name: "Create",
+		description: "Creates a new sheet and adds it to the space.",
+		icon: "ph--grid-nine--regular"
+	},
+	input: Schema.Struct({
+		name: Schema.optional(Schema.String).annotations({ description: "Display name for the sheet." }),
+		rows: Schema.optional(Schema.Number).annotations({ description: "Initial number of rows (default 50)." }),
+		columns: Schema.optional(Schema.Number).annotations({ description: "Initial number of columns (default 26)." })
+	}),
+	output: Schema.Struct({ id: Schema.String.annotations({ description: "The DXN of the created sheet." }) }),
+	services: [Database.Service]
+});
+var GetValues = Operation.make({
+	meta: {
+		key: makeKey("rangeGet"),
+		name: "Get Range Values",
+		description: "Returns cell values from a sheet as a 2D array. Defaults to the entire occupied area.",
+		icon: "ph--table--regular"
+	},
+	input: Schema.Struct({
+		sheet: Ref.Ref(Sheet).annotations({ description: "The sheet to read from." }),
+		range: Schema.optional(Schema.String).annotations({ description: "Range in A1 notation (e.g. \"A1:C5\"). Omit to return the entire occupied area." })
+	}),
+	output: Schema.Struct({
+		values: Schema.Array(Schema.Array(Schema.Any)).annotations({ description: "2D array of cell values indexed [row][col]. Empty cells are null. Formulas are shown in A1 notation." }),
+		range: Schema.String.annotations({ description: "The A1 range actually returned (e.g. \"A1:E5\")." })
+	}),
+	services: [Database.Service]
+});
+var SetValues = Operation.make({
+	meta: {
+		key: makeKey("rangeSet"),
+		name: "Set Range Values",
+		description: "Sets multiple cell values in a sheet at once.",
+		icon: "ph--pencil--regular"
+	},
+	input: Schema.Struct({
+		sheet: Ref.Ref(Sheet).annotations({ description: "The sheet to write to." }),
+		cells: Schema.Record({
+			key: Schema.String,
+			value: Schema.Any
+		}).annotations({ description: "Map of A1 address to value (e.g. { \"A1\": \"Name\", \"B1\": 42, \"C1\": \"=A1+B1\" })." })
+	}),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+/**
+* Restore a dropped axis (inverse of DropAxis).
+*/
+var RestoreAxis = Operation.make({
+	meta: {
+		key: makeKey("restoreAxis"),
+		name: "Restore Axis",
+		icon: "ph--clock-counter-clockwise--regular"
+	},
+	input: Schema.Struct({
+		model: Schema.Any.annotations({ description: "The sheet model." }),
+		axis: Axis.annotations({ description: "The axis type (row or col)." }),
+		axisIndex: Schema.String.annotations({ description: "The axis index to restore." }),
+		index: Schema.Number.annotations({ description: "The position to restore at." }),
+		axisMeta: Schema.Any.annotations({ description: "The row/column metadata." }),
+		values: Schema.Array(Schema.Any).annotations({ description: "The cell values to restore." })
+	}),
+	output: Schema.Void
+});
+//#endregion
+export { Create, DropAxis, DropAxisOutput, GetValues, InsertAxis, RestoreAxis, ScrollToAnchor, SetValues, SheetOperation_exports as t };
+
+//# sourceMappingURL=SheetOperation.mjs.map

package/dist/lib/SheetOperation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetOperation.mjs","names":[],"sources":["../../src/types/SheetOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport { meta } from '#meta';\n\nimport * as Sheet from './Sheet';\n\nconst makeKey = (name: string) => DXN.make(`${meta.profile.key}.operation.${name}`);\n\n// TODO(wittjosiah): Factor out. This is `DxGridAxis` from `@dxos/react-ui-grid`.\nconst Axis = Schema.Union(Schema.Literal('row'), Schema.Literal('col'));\n\nexport const InsertAxis = Operation.make({\n  meta: { key: makeKey('axisInsert'), name: 'Insert Axis', icon: 'ph--plus--regular' },\n  input: Schema.Struct({\n    model: Schema.Any,\n    axis: Axis,\n    index: Schema.Number,\n    count: Schema.optional(Schema.Number),\n  }),\n  output: Schema.Void,\n});\n\nexport const DropAxisOutput = Schema.Struct({\n  axis: Axis.annotations({ description: 'The axis type (row or col).' }),\n  axisIndex: Schema.String.annotations({ description: 'The dropped axis index.' }),\n  index: Schema.Number.annotations({ description: 'The position the axis was at.' }),\n  axisMeta: Schema.Any.annotations({ description: 'The row/column metadata.' }),\n  values: Schema.Array(Schema.Any).annotations({ description: 'The cell values that were dropped.' }),\n});\n\nexport type DropAxisOutput = Schema.Schema.Type<typeof DropAxisOutput>;\n\nexport const DropAxis = Operation.make({\n  meta: {\n    key: makeKey('axisDrop'),\n    name: 'Drop Axis',\n    icon: 'ph--trash--regular',\n  },\n  input: Schema.Struct({\n    model: Schema.Any,\n    axis: Axis,\n    axisIndex: Schema.String,\n  }),\n  output: DropAxisOutput,\n});\n\nexport const ScrollToAnchor = Operation.make({\n  meta: {\n    key: makeKey('scrollToAnchor'),\n    name: 'Scroll To Anchor',\n    icon: 'ph--anchor-simple--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    subject: Schema.String.annotations({ description: 'Attendable ID of the sheet.' }),\n    cursor: Schema.String.annotations({ description: 'Cell range coordinates.' }),\n    id: Schema.optional(Schema.Any.annotations({ description: 'Active refs for highlighting.' })),\n  }),\n  output: Schema.Void,\n});\n\nexport const Create = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.sheet.create'),\n    name: 'Create',\n    description: 'Creates a new sheet and adds it to the space.',\n    icon: 'ph--grid-nine--regular',\n  },\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String).annotations({ description: 'Display name for the sheet.' }),\n    rows: Schema.optional(Schema.Number).annotations({ description: 'Initial number of rows (default 50).' }),\n    columns: Schema.optional(Schema.Number).annotations({ description: 'Initial number of columns (default 26).' }),\n  }),\n  output: Schema.Struct({\n    id: Schema.String.annotations({ description: 'The DXN of the created sheet.' }),\n  }),\n  services: [Database.Service],\n});\n\nexport const GetValues = Operation.make({\n  meta: {\n    key: makeKey('rangeGet'),\n    name: 'Get Range Values',\n    description: 'Returns cell values from a sheet as a 2D array. Defaults to the entire occupied area.',\n    icon: 'ph--table--regular',\n  },\n  input: Schema.Struct({\n    sheet: Ref.Ref(Sheet.Sheet).annotations({ description: 'The sheet to read from.' }),\n    range: Schema.optional(Schema.String).annotations({\n      description: 'Range in A1 notation (e.g. \"A1:C5\"). Omit to return the entire occupied area.',\n    }),\n  }),\n  output: Schema.Struct({\n    values: Schema.Array(Schema.Array(Schema.Any)).annotations({\n      description:\n        '2D array of cell values indexed [row][col]. Empty cells are null. Formulas are shown in A1 notation.',\n    }),\n    range: Schema.String.annotations({ description: 'The A1 range actually returned (e.g. \"A1:E5\").' }),\n  }),\n  services: [Database.Service],\n});\n\nexport const SetValues = Operation.make({\n  meta: {\n    key: makeKey('rangeSet'),\n    name: 'Set Range Values',\n    description: 'Sets multiple cell values in a sheet at once.',\n    icon: 'ph--pencil--regular',\n  },\n  input: Schema.Struct({\n    sheet: Ref.Ref(Sheet.Sheet).annotations({ description: 'The sheet to write to.' }),\n    cells: Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({\n      description: 'Map of A1 address to value (e.g. { \"A1\": \"Name\", \"B1\": 42, \"C1\": \"=A1+B1\" }).',\n    }),\n  }),\n  output: Schema.Void,\n  services: [Database.Service],\n});\n\n/**\n * Restore a dropped axis (inverse of DropAxis).\n */\nexport const RestoreAxis = Operation.make({\n  meta: {\n    key: makeKey('restoreAxis'),\n    name: 'Restore Axis',\n    icon: 'ph--clock-counter-clockwise--regular',\n  },\n  input: Schema.Struct({\n    model: Schema.Any.annotations({ description: 'The sheet model.' }),\n    axis: Axis.annotations({ description: 'The axis type (row or col).' }),\n    axisIndex: Schema.String.annotations({ description: 'The axis index to restore.' }),\n    index: Schema.Number.annotations({ description: 'The position to restore at.' }),\n    axisMeta: Schema.Any.annotations({ description: 'The row/column metadata.' }),\n    values: Schema.Array(Schema.Any).annotations({ description: 'The cell values to restore.' }),\n  }),\n  output: Schema.Void,\n});\n"],"mappings":"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"}

package/dist/lib/SheetPlugin.mjs

@@ -1,31 +1,17 @@
-import { ActivationEvent, ActivationEvents, Plugin } from "@dxos/app-framework";
-import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
+import { Sheet } from "./Sheet.mjs";
 import { meta } from "#meta";
-import { ClientEvents } from "@dxos/plugin-client";
-import { MarkdownEvents } from "@dxos/plugin-markdown";
+import * as Plugin from "@dxos/app-framework/Plugin";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import { AnchorSort, CommentConfig, ComputeGraphRegistry, CreateObject, Markdown, OperationHandler, ReactSurface, SheetState, SkillDefinition, UndoMappings } from "#capabilities";
 import { translations } from "#translations";
-import { Sheet } from "#types";
 //#endregion
 //#region 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({
-	activatesOn: AppActivationEvents.AppGraphReady,
-	activate: AnchorSort
-}), AppPlugin.addPluginAssetModule({ asset: {
+var SheetPlugin = Plugin.define(meta).pipe(Plugin.addModule(SkillDefinition), Plugin.addModule(CommentConfig), Plugin.addModule(CreateObject), Plugin.addModule(OperationHandler), Plugin.addModule(UndoMappings), Plugin.addModule(AppCapability.schema([Sheet])), Plugin.addModule(ReactSurface), Plugin.addModule(AppCapability.translations(translations)), Plugin.addModule(SheetState), Plugin.addModule(ComputeGraphRegistry), Plugin.addModule(Markdown), Plugin.addModule(AnchorSort), Plugin.addModule(AppCapability.pluginAsset({
 	pluginId: meta.profile.key,
 	path: "PLUGIN.mdl",
 	content: "---\nid: org.dxos.plugin.sheet\nname: SheetPlugin\nversion: 0.1.0\n---\n\nSpreadsheet plugin for `DXOS` Composer — 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    ┌───────────────────────────────────┐\n    │ [toolbar slot]                    │\n    ├───┬───┬───┬───┬───────────────────┤\n    │   │ A │ B │ C │  …  column header │\n    ├───┼───┼───┼───┤                   │\n    │ 1 │   │   │   │   cell grid       │\n    ├───┼───┼───┼───┤                   │\n    │ 2 │   │   │   │                   │\n    │ … │   │   │   │                   │\n    └───┴───┴───┴───┴───────────────────┘\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",
 	mimeType: "application/x-mdl"
-} }), Plugin.make);
+})), Plugin.make);
 //#endregion
 export { SheetPlugin, SheetPlugin as default };
 

package/dist/lib/SheetPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"SheetPlugin.mjs","names":[],"sources":["../../src/SheetPlugin.tsx"],"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"],"mappings":";;;;;;;;;;AA4BA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,uBAAuB,EAAE,UAAU,cAAc,CAAC,GAC5D,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,gBAAgB,EAAE,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,GACnD,UAAU,iBAAiB,EAAE,UAAU,aAAa,CAAC,GACrD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,aAAa,oBAAoB;CACjC,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,aAAa,gBAAgB,MAAM,aAAa,aAAa,iBAAiB,mBAAmB;CACjG,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,aAAa,eAAe;CAC5B,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CAEf,aAAa,oBAAoB;CACjC,UAAU;AACZ,CAAC,GACD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT"}
+{"version":3,"file":"SheetPlugin.mjs","names":[],"sources":["../../src/SheetPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\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';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\nimport * as Sheet from './types/Sheet';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(SkillDefinition),\n  Plugin.addModule(CommentConfig),\n  Plugin.addModule(CreateObject),\n  Plugin.addModule(OperationHandler),\n  Plugin.addModule(UndoMappings),\n  Plugin.addModule(AppCapability.schema([Sheet.Sheet])),\n  Plugin.addModule(ReactSurface),\n  Plugin.addModule(AppCapability.translations(translations)),\n  Plugin.addModule(SheetState),\n  Plugin.addModule(ComputeGraphRegistry),\n  Plugin.addModule(Markdown),\n  Plugin.addModule(AnchorSort),\n  Plugin.addModule(\n    AppCapability.pluginAsset({\n      pluginId: meta.profile.key,\n      path: 'PLUGIN.mdl',\n      content: pluginSpec,\n      mimeType: 'application/x-mdl',\n    }),\n  ),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n"],"mappings":";;;;;;;;AA0BA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,eAAe,GAChC,OAAO,UAAU,aAAa,GAC9B,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,gBAAgB,GACjC,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,OAAO,CAAC,KAAW,CAAC,CAAC,GACpD,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,aAAa,YAAY,CAAC,GACzD,OAAO,UAAU,UAAU,GAC3B,OAAO,UAAU,oBAAoB,GACrC,OAAO,UAAU,QAAQ,GACzB,OAAO,UAAU,UAAU,GAC3B,OAAO,UACL,cAAc,YAAY;CACxB,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC,CACH,GACA,OAAO,IACT"}

package/dist/lib/SheetPlugin.node.mjs

@@ -1,10 +1,10 @@
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
+import { Sheet } from "./Sheet.mjs";
 import { meta } from "#meta";
-import { CommentConfig, CreateObject, OperationHandler, UndoMappings } from "#capabilities";
-import { Sheet } from "#types";
+import * as Plugin from "@dxos/app-framework/Plugin";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { CommentConfig, CreateObject, OperationHandler, SkillDefinition, UndoMappings } from "#capabilities";
 //#region src/SheetPlugin.node.ts
-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 = Plugin.define(meta).pipe(Plugin.addModule(CommentConfig), Plugin.addModule(CreateObject), Plugin.addModule(OperationHandler), Plugin.addModule(SkillDefinition), Plugin.addModule(UndoMappings), Plugin.addModule(AppCapability.schema([Sheet])), Plugin.make);
 //#endregion
 export { SheetPlugin, SheetPlugin as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"SheetPlugin.node.mjs","names":[],"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":";;;;;;AAWA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,UAAU,uBAAuB,EAAE,UAAU,cAAc,CAAC,GAC5D,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,gBAAgB,EAAE,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,GACnD,OAAO,IACT"}
+{"version":3,"file":"SheetPlugin.node.mjs","names":[],"sources":["../../src/SheetPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { CommentConfig, CreateObject, OperationHandler, SkillDefinition, UndoMappings } from '#capabilities';\nimport { meta } from '#meta';\n\nimport * as Sheet from './types/Sheet';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(CommentConfig),\n  Plugin.addModule(CreateObject),\n  Plugin.addModule(OperationHandler),\n  Plugin.addModule(SkillDefinition),\n  Plugin.addModule(UndoMappings),\n  Plugin.addModule(AppCapability.schema([Sheet.Sheet])),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n"],"mappings":";;;;;;AAYA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,aAAa,GAC9B,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,gBAAgB,GACjC,OAAO,UAAU,eAAe,GAChC,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,OAAO,CAAC,KAAW,CAAC,CAAC,GACpD,OAAO,IACT"}

package/dist/lib/SheetPlugin.workerd.mjs

@@ -1,10 +1,10 @@
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
+import { Sheet } from "./Sheet.mjs";
 import { meta } from "#meta";
+import * as Plugin from "@dxos/app-framework/Plugin";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import { OperationHandler } from "#capabilities";
-import { Sheet } from "#types";
 //#region src/SheetPlugin.workerd.ts
-var SheetPlugin = Plugin.define(meta).pipe(AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [Sheet.Sheet] }), Plugin.make);
+var SheetPlugin = Plugin.define(meta).pipe(Plugin.addModule(OperationHandler), Plugin.addModule(AppCapability.schema([Sheet])), Plugin.make);
 //#endregion
 export { SheetPlugin, SheetPlugin as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"SheetPlugin.workerd.mjs","names":[],"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":";;;;;;AAWA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,GACnD,OAAO,IACT"}
+{"version":3,"file":"SheetPlugin.workerd.mjs","names":[],"sources":["../../src/SheetPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\n\nimport * as Sheet from './types/Sheet';\n\nexport const SheetPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(OperationHandler),\n  Plugin.addModule(AppCapability.schema([Sheet.Sheet])),\n  Plugin.make,\n);\n\nexport default SheetPlugin;\n"],"mappings":";;;;;;AAYA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAC7C,OAAO,UAAU,gBAAgB,GACjC,OAAO,UAAU,cAAc,OAAO,CAAC,KAAW,CAAC,CAAC,GACpD,OAAO,IACT"}

package/dist/lib/SheetRange.mjs

@@ -0,0 +1,32 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+//#region src/types/SheetRange.ts
+var SheetRange_exports = /* @__PURE__ */ __exportAll({
+	alignKey: () => alignKey,
+	cellClassNameForRange: () => cellClassNameForRange,
+	commentKey: () => commentKey,
+	styleKey: () => styleKey
+});
+var alignKey = "alignment";
+var commentKey = "comment";
+var styleKey = "style";
+var cellClassNameForRange = ({ key, value }) => {
+	switch (key) {
+		case alignKey: switch (value) {
+			case "start": return "text-start";
+			case "center": return "text-center";
+			case "end": return "text-end";
+			default: return;
+		}
+		case commentKey: return "bg-grid-comment";
+		case styleKey: switch (value) {
+			case "highlight": return "bg-grid-highlight!";
+			case "softwrap": return "whitespace-normal!";
+			default: return;
+		}
+		default: return;
+	}
+};
+//#endregion
+export { alignKey, cellClassNameForRange, commentKey, styleKey, SheetRange_exports as t };
+
+//# sourceMappingURL=SheetRange.mjs.map

package/dist/lib/SheetRange.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetRange.mjs","names":[],"sources":["../../src/types/SheetRange.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type ClassNameValue } from '@dxos/react-ui';\n\nimport type * as Sheet from '../types/Sheet';\n\nexport const alignKey = 'alignment';\nexport type AlignKey = typeof alignKey;\nexport type AlignValue = 'start' | 'center' | 'end';\n\nexport const commentKey = 'comment';\nexport type CommentKey = typeof commentKey;\nexport type CommentValue = string;\n\nexport const styleKey = 'style';\nexport type StyleKey = typeof styleKey;\nexport type StyleValue = 'highlight' | 'softwrap';\n\n// TODO(burdon): Reconcile with plugin-table.\nexport const cellClassNameForRange = ({ key, value }: Sheet.Sheet['ranges'][number]): ClassNameValue => {\n  switch (key) {\n    case alignKey:\n      switch (value) {\n        case 'start':\n          return 'text-start';\n        case 'center':\n          return 'text-center';\n        case 'end':\n          return 'text-end';\n        default:\n          return undefined;\n      }\n\n    case commentKey:\n      return 'bg-grid-comment';\n\n    case styleKey:\n      switch (value) {\n        case 'highlight':\n          return 'bg-grid-highlight!';\n        case 'softwrap':\n          return 'whitespace-normal!';\n        default:\n          return undefined;\n      }\n\n    default:\n      return undefined;\n  }\n};\n"],"mappings":";;;;;;;;AAQA,IAAa,WAAW;AAIxB,IAAa,aAAa;AAI1B,IAAa,WAAW;AAKxB,IAAa,yBAAyB,EAAE,KAAK,YAA2D;CACtG,QAAQ,KAAR;EACE,KAAK,UACH,QAAQ,OAAR;GACE,KAAK,SACH,OAAO;GACT,KAAK,UACH,OAAO;GACT,KAAK,OACH,OAAO;GACT,SACE;EACJ;EAEF,KAAK,YACH,OAAO;EAET,KAAK,UACH,QAAQ,OAAR;GACE,KAAK,aACH,OAAO;GACT,KAAK,YACH,OAAO;GACT,SACE;EACJ;EAEF,SACE;CACJ;AACF"}

package/dist/lib/SheetUtil.mjs

@@ -0,0 +1,122 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { addressFromA1Notation, addressToA1Notation, isFormula } from "@dxos/compute-hyperformula/types";
+import { randomBytes } from "@dxos/crypto/random";
+import { assertArgument } from "@dxos/invariant";
+//#region src/types/SheetUtil.ts
+var SheetUtil_exports = /* @__PURE__ */ __exportAll({
+	ApiError: () => ApiError,
+	DEFAULT_COLS: () => 26,
+	DEFAULT_ROWS: () => 50,
+	MAX_COLS: () => 676,
+	MAX_ROWS: () => 500,
+	RangeException: () => RangeException,
+	ReadonlyException: () => ReadonlyException,
+	addressFromIndex: () => addressFromIndex,
+	addressToIndex: () => addressToIndex,
+	compareIndexPositions: () => compareIndexPositions,
+	createIndex: () => createIndex,
+	createIndices: () => createIndices,
+	initialize: () => initialize,
+	insertIndices: () => insertIndices,
+	mapFormulaIndicesToRefs: () => mapFormulaIndicesToRefs,
+	mapFormulaRefsToIndices: () => mapFormulaRefsToIndices,
+	rangeFromIndex: () => rangeFromIndex,
+	rangeToIndex: () => rangeToIndex
+});
+var MAX_ROWS = 500;
+var MAX_COLS = 676;
+var DEFAULT_ROWS = 50;
+var DEFAULT_COLS = 26;
+var ApiError = class extends Error {};
+var ReadonlyException = class extends ApiError {};
+var RangeException = class extends ApiError {
+	constructor(n) {
+		super();
+	}
+};
+/**
+* With a string length of 8, the chance of a collision is 0.02% for a sheet with 10,000 strings.
+*/
+var createIndex = (length = 8) => {
+	const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+	const charactersLength = 62;
+	const randomBuffer = randomBytes(length);
+	return Array.from(randomBuffer, (byte) => characters[byte % charactersLength]).join("");
+};
+var createIndices = (length) => Array.from({ length }).map(() => createIndex());
+var insertIndices = (indices, i, n, max) => {
+	if (i + n > max) throw new RangeException(i + n);
+	const idx = createIndices(n);
+	indices.splice(i, 0, ...idx);
+	return idx;
+};
+var initialize = (sheet, { rows = 50, columns = 26 } = {}) => {
+	if (!sheet.rows.length) insertIndices(sheet.rows, 0, rows, 500);
+	if (!sheet.columns.length) insertIndices(sheet.columns, 0, columns, 676);
+};
+/**
+* E.g., "A1" => "CA2@CB3".
+*/
+var addressToIndex = (sheet, cell) => {
+	return `${sheet.columns[cell.col]}@${sheet.rows[cell.row]}`;
+};
+/**
+* E.g., "CA2@CB3" => "A1".
+*/
+var addressFromIndex = (sheet, idx) => {
+	const [column, row] = idx.split("@");
+	return {
+		col: sheet.columns.indexOf(column),
+		row: sheet.rows.indexOf(row)
+	};
+};
+/**
+* E.g., "A1:B2" => "CA2@CB3:CC4@CD5".
+*/
+var rangeToIndex = (sheet, range) => {
+	return [range.from, range.to ?? range.from].map((cell) => addressToIndex(sheet, cell)).join(":");
+};
+/**
+* E.g., "CA2@CB3:CC4@CD5" => "A1:B2".
+*/
+var rangeFromIndex = (sheet, idx) => {
+	const [from, to] = idx.split(":").map((index) => addressFromIndex(sheet, index));
+	return {
+		from,
+		to
+	};
+};
+/**
+* Compares the positions of two cell indexes in a sheet.
+* Sorts primarily by row, then by column if rows are equal.
+*/
+var compareIndexPositions = (sheet, indexA, indexB) => {
+	const { row: rowA, col: columnA } = addressFromIndex(sheet, indexA);
+	const { row: rowB, col: columnB } = addressFromIndex(sheet, indexB);
+	if (rowA !== rowB) return rowA - rowB;
+	else return columnA - columnB;
+};
+/**
+* Map from A1 notation to indices.
+*/
+var mapFormulaRefsToIndices = (sheet, formula) => {
+	assertArgument(isFormula(formula), "formula");
+	return formula.replace(/([a-zA-Z]+)([0-9]+)/g, (match) => {
+		const cell = addressFromA1Notation(match);
+		if (cell.col < 0 || cell.row < 0 || cell.col >= sheet.columns.length || cell.row >= sheet.rows.length) return match;
+		return addressToIndex(sheet, cell);
+	});
+};
+/**
+* Map from indices to A1 notation.
+*/
+var mapFormulaIndicesToRefs = (sheet, formula) => {
+	assertArgument(isFormula(formula), "formula");
+	return formula.replace(/([a-zA-Z0-9]+)@([a-zA-Z0-9]+)/g, (idx) => {
+		return addressToA1Notation(addressFromIndex(sheet, idx));
+	});
+};
+//#endregion
+export { ApiError, DEFAULT_COLS, DEFAULT_ROWS, MAX_COLS, MAX_ROWS, RangeException, ReadonlyException, addressFromIndex, addressToIndex, compareIndexPositions, createIndex, createIndices, initialize, insertIndices, mapFormulaIndicesToRefs, mapFormulaRefsToIndices, rangeFromIndex, rangeToIndex, SheetUtil_exports as t };
+
+//# sourceMappingURL=SheetUtil.mjs.map

package/dist/lib/SheetUtil.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetUtil.mjs","names":[],"sources":["../../src/types/SheetUtil.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport {\n  type CellAddress,\n  type CellRange,\n  type CompleteCellRange,\n  addressFromA1Notation,\n  addressToA1Notation,\n  isFormula,\n} from '@dxos/compute-hyperformula/types';\nimport { randomBytes } from '@dxos/crypto/random';\nimport { type Obj } from '@dxos/echo';\nimport { assertArgument } from '@dxos/invariant';\n\nimport type * as Sheet from '../types/Sheet';\n\nexport const MAX_ROWS = 500;\nexport const MAX_COLS = 676; // 26^2;\n\nexport const DEFAULT_ROWS = 50;\nexport const DEFAULT_COLS = 26;\n\n// TODO(burdon): Factor out from dxos/protocols to new common package.\nexport class ApiError extends Error {}\n\nexport class ReadonlyException extends ApiError {}\n\nexport class RangeException extends ApiError {\n  constructor(n: number) {\n    super();\n  }\n}\n\n/**\n * With a string length of 8, the chance of a collision is 0.02% for a sheet with 10,000 strings.\n */\nexport const createIndex = (length = 8): string => {\n  const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  const charactersLength = characters.length;\n  const randomBuffer = randomBytes(length);\n  return Array.from(randomBuffer, (byte) => characters[byte % charactersLength]).join('');\n};\n\nexport const createIndices = (length: number): string[] => Array.from({ length }).map(() => createIndex());\n\nexport const insertIndices = (indices: string[], i: number, n: number, max: number) => {\n  if (i + n > max) {\n    throw new RangeException(i + n);\n  }\n\n  const idx = createIndices(n);\n  indices.splice(i, 0, ...idx);\n  return idx;\n};\n\nexport const initialize = (\n  sheet: Obj.Mutable<Sheet.Sheet>,\n  { rows = DEFAULT_ROWS, columns = DEFAULT_COLS }: Partial<Sheet.SheetSize> = {},\n) => {\n  if (!sheet.rows.length) {\n    insertIndices(sheet.rows, 0, rows, MAX_ROWS);\n  }\n  if (!sheet.columns.length) {\n    insertIndices(sheet.columns, 0, columns, MAX_COLS);\n  }\n};\n\n/**\n * E.g., \"A1\" => \"CA2@CB3\".\n */\nexport const addressToIndex = (sheet: Sheet.Sheet, cell: CellAddress): string => {\n  return `${sheet.columns[cell.col]}@${sheet.rows[cell.row]}`;\n};\n\n/**\n * E.g., \"CA2@CB3\" => \"A1\".\n */\nexport const addressFromIndex = (sheet: Sheet.Sheet, idx: string): CellAddress => {\n  const [column, row] = idx.split('@');\n  return {\n    col: sheet.columns.indexOf(column),\n    row: sheet.rows.indexOf(row),\n  };\n};\n\n/**\n * E.g., \"A1:B2\" => \"CA2@CB3:CC4@CD5\".\n */\nexport const rangeToIndex = (sheet: Sheet.Sheet, range: CellRange): string => {\n  return [range.from, range.to ?? range.from].map((cell) => addressToIndex(sheet, cell)).join(':');\n};\n\n/**\n * E.g., \"CA2@CB3:CC4@CD5\" => \"A1:B2\".\n */\nexport const rangeFromIndex = (sheet: Sheet.Sheet, idx: string): CompleteCellRange => {\n  const [from, to] = idx.split(':').map((index) => addressFromIndex(sheet, index));\n  return { from, to };\n};\n\n/**\n * Compares the positions of two cell indexes in a sheet.\n * Sorts primarily by row, then by column if rows are equal.\n */\nexport const compareIndexPositions = (sheet: Sheet.Sheet, indexA: string, indexB: string): number => {\n  const { row: rowA, col: columnA } = addressFromIndex(sheet, indexA);\n  const { row: rowB, col: columnB } = addressFromIndex(sheet, indexB);\n\n  // Sort by row first, then by column.\n  if (rowA !== rowB) {\n    return rowA - rowB;\n  } else {\n    return columnA - columnB;\n  }\n};\n\n// TODO(burdon): Tests.\n\n/**\n * Map from A1 notation to indices.\n */\nexport const mapFormulaRefsToIndices = (sheet: Sheet.Sheet, formula: string): string => {\n  assertArgument(isFormula(formula), 'formula');\n  return formula.replace(/([a-zA-Z]+)([0-9]+)/g, (match) => {\n    const cell = addressFromA1Notation(match);\n    // Skip tokens whose parsed address falls outside the sheet bounds or is negative — they are\n    // function names (e.g. LOG10, ATAN2) or malformed refs (e.g. A0 → row -1) rather than valid\n    // cell references.\n    if (cell.col < 0 || cell.row < 0 || cell.col >= sheet.columns.length || cell.row >= sheet.rows.length) {\n      return match;\n    }\n    return addressToIndex(sheet, cell);\n  });\n};\n\n/**\n * Map from indices to A1 notation.\n */\nexport const mapFormulaIndicesToRefs = (sheet: Sheet.Sheet, formula: string): string => {\n  assertArgument(isFormula(formula), 'formula');\n  return formula.replace(/([a-zA-Z0-9]+)@([a-zA-Z0-9]+)/g, (idx) => {\n    return addressToA1Notation(addressFromIndex(sheet, idx));\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,IAAa,WAAW;AACxB,IAAa,WAAW;AAExB,IAAa,eAAe;AAC5B,IAAa,eAAe;AAG5B,IAAa,WAAb,cAA8B,MAAM,CAAC;AAErC,IAAa,oBAAb,cAAuC,SAAS,CAAC;AAEjD,IAAa,iBAAb,cAAoC,SAAS;CAC3C,YAAY,GAAW;EACrB,MAAM;CACR;AACF;;;;AAKA,IAAa,eAAe,SAAS,MAAc;CACjD,MAAM,aAAa;CACnB,MAAM,mBAAmB;CACzB,MAAM,eAAe,YAAY,MAAM;CACvC,OAAO,MAAM,KAAK,eAAe,SAAS,WAAW,OAAO,iBAAiB,CAAC,CAAC,KAAK,EAAE;AACxF;AAEA,IAAa,iBAAiB,WAA6B,MAAM,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,YAAY,CAAC;AAEzG,IAAa,iBAAiB,SAAmB,GAAW,GAAW,QAAgB;CACrF,IAAI,IAAI,IAAI,KACV,MAAM,IAAI,eAAe,IAAI,CAAC;CAGhC,MAAM,MAAM,cAAc,CAAC;CAC3B,QAAQ,OAAO,GAAG,GAAG,GAAG,GAAG;CAC3B,OAAO;AACT;AAEA,IAAa,cACX,OACA,EAAE,OAAA,IAAqB,UAAA,OAAqD,CAAC,MAC1E;CACH,IAAI,CAAC,MAAM,KAAK,QACd,cAAc,MAAM,MAAM,GAAG,MAAA,GAAc;CAE7C,IAAI,CAAC,MAAM,QAAQ,QACjB,cAAc,MAAM,SAAS,GAAG,SAAA,GAAiB;AAErD;;;;AAKA,IAAa,kBAAkB,OAAoB,SAA8B;CAC/E,OAAO,GAAG,MAAM,QAAQ,KAAK,KAAK,GAAG,MAAM,KAAK,KAAK;AACvD;;;;AAKA,IAAa,oBAAoB,OAAoB,QAA6B;CAChF,MAAM,CAAC,QAAQ,OAAO,IAAI,MAAM,GAAG;CACnC,OAAO;EACL,KAAK,MAAM,QAAQ,QAAQ,MAAM;EACjC,KAAK,MAAM,KAAK,QAAQ,GAAG;CAC7B;AACF;;;;AAKA,IAAa,gBAAgB,OAAoB,UAA6B;CAC5E,OAAO,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,KAAK,SAAS,eAAe,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;AACjG;;;;AAKA,IAAa,kBAAkB,OAAoB,QAAmC;CACpF,MAAM,CAAC,MAAM,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,KAAK,UAAU,iBAAiB,OAAO,KAAK,CAAC;CAC/E,OAAO;EAAE;EAAM;CAAG;AACpB;;;;;AAMA,IAAa,yBAAyB,OAAoB,QAAgB,WAA2B;CACnG,MAAM,EAAE,KAAK,MAAM,KAAK,YAAY,iBAAiB,OAAO,MAAM;CAClE,MAAM,EAAE,KAAK,MAAM,KAAK,YAAY,iBAAiB,OAAO,MAAM;CAGlE,IAAI,SAAS,MACX,OAAO,OAAO;MAEd,OAAO,UAAU;AAErB;;;;AAOA,IAAa,2BAA2B,OAAoB,YAA4B;CACtF,eAAe,UAAU,OAAO,GAAG,SAAS;CAC5C,OAAO,QAAQ,QAAQ,yBAAyB,UAAU;EACxD,MAAM,OAAO,sBAAsB,KAAK;EAIxC,IAAI,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,KAAK,OAAO,MAAM,QAAQ,UAAU,KAAK,OAAO,MAAM,KAAK,QAC7F,OAAO;EAET,OAAO,eAAe,OAAO,IAAI;CACnC,CAAC;AACH;;;;AAKA,IAAa,2BAA2B,OAAoB,YAA4B;CACtF,eAAe,UAAU,OAAO,GAAG,SAAS;CAC5C,OAAO,QAAQ,QAAQ,mCAAmC,QAAQ;EAChE,OAAO,oBAAoB,iBAAiB,OAAO,GAAG,CAAC;CACzD,CAAC;AACH"}