@pixerate/editor 0.25.0 → 0.26.1

package/README.md

@@ -139,6 +139,24 @@ getFindReplaceState(editor); // { open, mode, query, replacement, options, match
 - **Track changes**: tracked-deleted text is skipped (a match never spans a deletion, but word boundaries see the live text), and replacements made while tracking become tracked deletions and insertions.
 - Matches are decorated with `pixerate-find-match` and the current one also with `pixerate-find-match-current` (`matchClass` / `currentMatchClass`); style them in your CSS. `createFindReplaceCommands(editor)` returns command-registry specs (`findReplace.open`, `.next`, `.find`, `.replaceAll`, …).
 
+## Tables
+
+`createRichTextPreset()` includes tables by default (TipTap's `table`, `tableRow`, `tableHeader`, `tableCell`): resizable columns (`colwidth`), header rows, columns and cells, `colspan` / `rowspan` (kept from pasted HTML and from DOCX / PDF import), cell `align` and `backgroundColor`, and table node selection. Configure them with `table: { resizable, cellMinWidth, allowTableNodeSelection, HTMLAttributes, ... }`, or pass `table: false` to leave tables out of the schema (pasted and imported tables are then flattened into paragraphs, as before).
+
+```ts
+import { createTableCommands, getTableState, runTableAction, getTableActionState } from "@pixerate/editor";
+
+runTableAction(editor, "insertTable", { rows: 3, cols: 4, withHeaderRow: true });
+getTableActionState(editor, "mergeCells"); // true, or why not: "Select two or more adjacent cells to merge."
+getTableState(editor); // { inTable, rows, columns, row, column, headerRow, headerColumn, headerCell, cellAlignment, actions: { … } }
+registry.register(createTableCommands(editor)); // table.insertTable, table.addRowAfter, table.mergeCells, … (palette & agents)
+```
+
+- **Actions** (`TABLE_ACTIONS`): `insertTable` (no nesting), `addRowBefore` / `addRowAfter` / `deleteRow`, `addColumnBefore` / `addColumnAfter` / `deleteColumn`, `deleteTable`, `mergeCells` / `splitCell`, `toggleHeaderRow` / `toggleHeaderColumn` / `toggleHeaderCell`, `goToNextCell` / `goToPreviousCell` (Tab / Shift+Tab), `setCellAlignment` (`{ align }`) and `setCellBackground` (`{ color }`, sanitized). `createTableStore(editor)` is the external store the React and Svelte toolbars use; `DEFAULT_TABLE_TOOLBAR` lists their buttons. `createRichTextToolProvider` adds an `edit_table` agent tool when the schema has tables.
+- **Export**: `getEditorText` writes each row as a line of tab-separated cells. Markdown (`markdown: true`) writes a GFM pipe table (column alignment from the header cells, `|` escaped) when the first row is all header cells, nothing spans and every cell holds one paragraph; otherwise the table is written as HTML, which parses back. GFM tables in markdown input become tables.
+- **Track changes**: edits inside cells are tracked like any text. Inserting or deleting rows, columns (their cells) or a whole table is tracked as a whole-block change (`blockChange` with `operation`): rejecting an insertion or accepting a deletion removes the rows/cells/table; deleting rows you inserted yourself removes them. Header toggles are tracked as block changes (reject restores the cell type). Cell attributes (alignment, background, widths) are not tracked, and merging or splitting cells is refused while tracking. `compareDocuments` compares tables row by row and cell by cell.
+- Style the tables in your CSS (`.tableWrapper`, `table`, `th`, `td`, `.selectedCell`, `.column-resize-handle`; the table has the `pixerate-table` class).
+
 ## File import and rich clipboard
 
 An import adapter registry maps file types (MIME types and extensions) to converters. Built-in `document` adapters cover markdown (`.md`, `.markdown`, `.mdown`, `.mkdn`, `.mkd`, `.Rmd`, `.md.txt`), HTML (sanitized with the same allowlist as markdown), plain text (`.txt`), RTF (best-effort text extraction) and DOCX (`.docx`, `.docm`, `.dotx`). The longest matching extension wins, then exact MIME types, then `priority`, then the most recent registration.
@@ -354,6 +372,18 @@ sheet.findInvalidCells(); // "circle invalid data"
 
 `evaluateConditionalFormats(sheet, rules)` and `validateCellInput(sheet, rules, row, col, input)` also work on any grid through the small `ConditionalFormatSheet` / `DataValidationSheet` interfaces. Rule formulas are written for the top-left cell of the first range and shift for other cells; custom validation formulas see the value being entered. `setCellValue`, paste and import never validate (as in Excel); `commitEditing` and `commitCellInput` do.
 
+## Large spreadsheets: incremental recalculation and virtualised rendering
+
+The dependency graph stores each range a formula reads once, in an interval index per column (wide ranges in a per-sheet index), instead of one key per cell, so `=SUM(A1:A50000)` and `=SUM(A:A)` are one entry each. An edit finds the formulas reading the cell in O(log n + k), recalculates only that dirty subgraph in topological order (a range read by many formulas is resolved once per recalculation), and still detects cycles, re-spills dynamic arrays, follows sheet-qualified, 3-D and defined-name references and recalculates volatile functions (`NOW`, `TODAY`, `RAND`, `RANDBETWEEN`, `RANDARRAY`) on every edit. CSV import, `loadWorkbook` and large pastes register the cells and evaluate each formula once; a single-cell edit is undone without a whole-sheet snapshot. `SUM`, `PRODUCT`, `AVERAGE`, `COUNT`, `COUNTA`, `MIN` and `MAX` read their ranges without materialising blank cells.
+
+```ts
+sheet.setCellValue(rowId, colId, "42");
+sheet.getRecalculationStats(); // { evaluated: 1, planned: 2, passes: 1 }: deterministic work counts
+sheet.depGraph.getIndexStats(); // { formulas, cellEdges, rangeEntries, volatile }
+```
+
+`measureSpreadsheetView`, `getSpreadsheetViewWindow` and `getSpreadsheetScrollToCell` work out which displayed rows and columns to render for a scroll position (frozen rows and columns always, merges crossing the edge whole) and how far to scroll to show the active cell. The React and Svelte `SpreadsheetEditor` use them for sheets with more than 200 displayed rows or 60 columns (`virtualize` prop: `'auto'`, `true` or `false`). `packages/core/tests/spreadsheet-recalc.bench.test.ts` measures 50k-cell sheets (`SPREADSHEET_BENCH=1`).
+
 ## Other modules
 
 Each module is also available as a subpath import:

package/THIRD_PARTY_NOTICES.md

@@ -31,6 +31,9 @@ reproduced at the end of this file. Paths are relative to each source repository
 - `crates/doc/src/lib.rs` (`modes_for`: modes inherited down the tree) → `getEffectiveTokenModes` in `packages/core/src/canvas/tokenBindings.ts`
 - `crates/engine/src/variables_io_tests.rs` (behaviour of the variables JSON import / export: merging by name, junk and loop handling, CSS export per mode) → `packages/core/src/tokens/w3c.ts`, `packages/core/src/tokens/css.ts`
 - `crates/engine/src/{variable_tests.rs,variables_behaviour_tests.rs,variables_io_tests.rs}` (test cases re-expressed) → `packages/core/tests/tokens.test.ts`, `packages/core/tests/canvas-tokens.test.ts`
+- `crates/engine/src/components.rs` (instances rebuilt from their main keeping ids and overrides — `sync_instance`, `carry_overrides`, `path_map` matching, `variant_kept`, `diff_groups`, `sync_after_edit`, `rebuild_instances` ordering, `rebase_instance`, `unlink_layers`, `relink_copy`, component property chains, `default_variant`, `variant_props`, `variant_name`, `variant_options`, `find_variant`, `variant_conflicts`) → `packages/core/src/canvas/components.ts`
+- `crates/engine/src/cmd/component.rs` (create component, combine as variants, create / detach / swap instance, reset instance and overrides, push changes, restore main, set instance properties, add / edit / delete / bind component properties) → `packages/core/src/canvas/components.ts`, `packages/core/src/canvas/componentsController.ts`
+- `crates/engine/src/{components_tests.rs,components_behaviour_tests.rs,components_scale_tests.rs}` (test cases re-expressed) → `packages/core/tests/canvas-components.test.ts`, `packages/core/tests/canvas-components-controller.test.ts`
 
 ## filmcraft
 
@@ -44,6 +47,9 @@ reproduced at the end of this file. Paths are relative to each source repository
 - `apps/filmcraft-web/src/recovery_policy.rs` (`Policy`, `Action`, `tick` / `written` / `cleaned`: snapshot at most once per interval and revision, retry failed writes, retire only this session's snapshot) → `packages/core/src/persistence/recoveryPolicy.ts`
 - `apps/filmcraft-web/src/recovery.rs` (snapshot-then-dirty-meta writes, recovery check of a dirty meta) → `packages/core/src/persistence/autosave.ts`
 - `apps/filmcraft-web/tests/recovery_policy.rs` (test cases re-expressed) → `packages/core/tests/persistence-policy.test.ts`
+- `crates/project/src/keyframe.rs` (`Keyframe`, `Param::value_at` segment evaluation and hold, `set_at` inheriting the previous interpolation, `remove_keyframe_at` keeping the last value, `toggle_animation` keeping the value at a time, temporal influence easing, `cubic_bezier_y_for_x` Newton + bisection solver) → `packages/core/src/canvas/animation/{easing,model,evaluate,edit}.ts`
+- `crates/engine/src/keyframe_move.rs` (`move_many`: one common delta across lanes clamped to the movement range, remove-all-originals-then-insert, validation without partial edits, at most 4096 keys) → `moveKeyframes` / `scaleKeyframes` in `packages/core/src/canvas/animation/edit.ts`, keyframe drags in `packages/core/src/canvas/animation/controller.ts`
+- `crates/project/src/keyframe.rs` tests, `crates/engine/src/keyframe_move.rs` tests and `crates/ui-egui/tests/keyframes_ui.rs` (group move and undo as one step, snapping within a screen-space threshold, Escape cancelling a drag preview; test cases re-expressed) → `packages/core/tests/canvas-animation.test.ts`, `packages/react/tests/canvas-animation.test.tsx`, `packages/svelte/tests/canvas/canvas-animation.test.ts`
 
 ## gridcraft
 
@@ -62,6 +68,8 @@ reproduced at the end of this file. Paths are relative to each source repository
 - `crates/model/src/features.rs` (conditional formatting and data validation rule model, icon-set thresholds) and `crates/engine/src/cf.rs` (rule evaluation: priority, stop if true, colour scales, data bars, icon sets, top/bottom, averages, duplicates, text and date rules, relative rule formulas) → `packages/core/src/spreadsheet/conditional-format/`
 - `crates/engine/src/cmd/data.rs` (validation checks, list items, circle invalid data, removing rule cells) and `crates/engine/src/cmd/sheet.rs` (rule ranges following inserted / deleted rows and columns) → `packages/core/src/spreadsheet/validation/`, `packages/core/src/spreadsheet/rule-ranges.ts`
 - Test cases from `crates/engine/src/cf.rs` and `crates/engine/src/tests.rs` (icon-set thresholds, relative validation formulas), re-expressed → `packages/core/tests/spreadsheet-conditional-format.test.ts`, `packages/core/tests/spreadsheet-data-validation.test.ts`
+- `crates/calc/src/recalc.rs` (`Intervals`: row intervals sorted by start with an implicit max-end segment tree, pending insertions and dead entries merged lazily; ranges indexed per column with a per-sheet index for wide ranges; dependents of a cell in O(log n + k); dirty closure of an edit) → `packages/core/src/spreadsheet/formula/dependency-graph.ts`
+- `crates/calc/src/tests.rs` and `crates/calc/src/recalc.rs` (interval-index and incremental-recalculation cases, re-expressed) → `packages/core/tests/spreadsheet-recalc.test.ts`
 **Apache POI.** The rows of `packages/core/tests/fixtures/poi-number-format-approx.ts` (format, value and Excel's
 `TEXT()` result) come from Apache POI's `test-data/spreadsheet/NumberFormatApproxTests.xlsx`, as collected in
 GridCraft. Apache POI is © The Apache Software Foundation, licensed under the Apache License, Version 2.0
@@ -149,6 +157,9 @@ GridCraft. Apache POI is © The Apache Software Foundation, licensed under the A
 - Test cases from `crates/engine/src/cmd/moves.rs` (`a_tracked_cut_and_paste_of_a_paragraph_is_a_move`, `accepting_one_end_of_a_move_accepts_both`, `rejecting_a_move_puts_the_text_back`), re-expressed → `packages/core/tests/track-changes-moves.test.ts`
 - `crates/doc/src/styles.rs` (`Style` with `based_on` / `next` / `linked`, the built-in style set's shape, `gallery`, `chain` (bounded, cycle-safe), `find`, `upsert`, `remove` (rebasing dependants, dropping `next` / `linked` references), `new_id`) and `crates/doc/src/resolve.rs` (cascade: document defaults → paragraph style chain → character style chain → direct formatting) → `packages/core/src/extensions/paragraph-styles/registry.ts`
 - Test cases from `crates/doc/src/styles.rs` (`builtins_present`, `chain_is_cycle_safe`, `new_ids_unique`) and `crates/doc/src/resolve.rs` (`heading_resolves`, `char_style_then_direct`), re-expressed → `packages/core/tests/paragraph-styles.test.ts`
+- `crates/docx/src/write/mod.rs` (package assembly: `[Content_Types].xml` defaults and overrides, part relationships with reused ids, `comments.xml` + `commentsExtended.xml` with `w15:paraIdParent` / `w15:done`, `annotation_author` and anonymous initials for removed personal information, `core_xml` without creator / last modified by, `styles_xml` / `style_xml` with `basedOn` / `next` / `link` / `uiPriority` / `qFormat`, lower-case built-in style names, `numbering_xml`), `crates/docx/src/write/story.rs` (`rev_open` / `rev_close`, `rev_tag` moves as `w:moveFrom` / `w:moveTo`, `move_ranges` with named move ranges, `w:delText` only for deletions that are not moves, `rpr_change` / `w:pPrChange` last in their properties, comment range start / end / reference runs, `w:p` with `w14:paraId` for comments, tables with `w:tblGrid`, `w:gridSpan`, `w:vMerge`, inline `wp:inline` pictures), `crates/docx/src/write/props.rs` (run property order), `crates/docx/src/package.rs` (relationship types), `crates/docx/src/xml.rs` (`esc`, XML 1.0 character filter, writer) and `crates/docx/src/units.rs` (twips / EMU conversion) → `packages/core/src/export/docx.ts`, `packages/core/src/export/xml.ts`, `packages/core/src/export/units.ts`
+- `crates/docx/src/read/mod.rs` (`read_comments`: comments keyed by the `w14:paraId` of their last paragraph, `commentEx` parents and `done`) and `crates/docx/src/read/story.rs` (tracked insertions, deletions and named move ranges) → `packages/core/src/import/docx.ts`
+- Test cases from `crates/docx/tests/privacy.rs` (`remove_personal_information_and_dates_on_save`: the two-commenter fixture, no names or initials in any part, "Author" / "A"), `crates/docx/tests/roundtrip.rs` and `crates/docx/tests/fixtures.rs` (comments, replies, tracked changes and moves surviving a save and reload), re-expressed → `packages/core/tests/docx-export.test.ts`
 
 ## MIT License
 

package/dist/agent/index.cjs

@@ -5,14 +5,21 @@ var _chunkCPOKFNBGcjs = require('../chunk-CPOKFNBG.cjs');
 
 
 
-var _chunk7WISYZFOcjs = require('../chunk-7WISYZFO.cjs');
+
+
+var _chunkHDYMLS3Xcjs = require('../chunk-HDYMLS3X.cjs');
+
+
+
+
+var _chunk66IMF6ODcjs = require('../chunk-66IMF6OD.cjs');
 require('../chunk-BVP3TSLH.cjs');
-require('../chunk-X4N4WUKB.cjs');
+require('../chunk-IFHKKVXH.cjs');
 
 
 
 
-var _chunkC7P22VIPcjs = require('../chunk-C7P22VIP.cjs');
+var _chunkEWCOFSCQcjs = require('../chunk-EWCOFSCQ.cjs');
 
 
 
@@ -699,10 +706,11 @@ function createToolRegistry(options) {
 }
 
 // src/agent/providers.ts
+var _state = require('@tiptap/pm/state');
 var toEditor = (target) => "commands" in target ? target : target.editor;
 function replaceWithText(editor, from, to, text) {
   const { state, view } = editor;
-  const tr = /[\r\n]/.test(text) ? state.tr.replace(from, to, _chunk7WISYZFOcjs.plainTextToSlice.call(void 0, text, state.schema)) : text ? state.tr.insertText(text, from, to) : state.tr.delete(from, to);
+  const tr = /[\r\n]/.test(text) ? state.tr.replace(from, to, _chunk66IMF6ODcjs.plainTextToSlice.call(void 0, text, state.schema)) : text ? state.tr.insertText(text, from, to) : state.tr.delete(from, to);
   view.dispatch(tr.scrollIntoView());
 }
 function selectionInfo(editor) {
@@ -735,7 +743,7 @@ function createRichTextToolProvider(target, options) {
     },
     handler: ({ format = "text" }) => {
       const ed = editor();
-      const content = format === "html" ? ed.getHTML() : format === "markdown" ? _chunk7WISYZFOcjs.getEditorMarkdown.call(void 0, ed) : _chunk7WISYZFOcjs.getEditorText.call(void 0, ed);
+      const content = format === "html" ? ed.getHTML() : format === "markdown" ? _chunk66IMF6ODcjs.getEditorMarkdown.call(void 0, ed) : _chunk66IMF6ODcjs.getEditorText.call(void 0, ed);
       return { format, content, selection: selectionInfo(ed), size: ed.state.doc.content.size };
     }
   };
@@ -794,13 +802,62 @@ function createRichTextToolProvider(target, options) {
       return { replaced: { from, to }, selection: selectionInfo(ed) };
     }
   };
+  const editTable = {
+    name: "edit_table",
+    title: "Edit tables",
+    description: "Inserts a table or edits the table at the cursor (or at `at`): add/delete rows and columns, delete the table, merge/split cells, toggle header row/column/cell, move between cells, set cell alignment or background. Returns the table size and the cursor cell afterwards.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        operation: { type: "string", enum: _chunkHDYMLS3Xcjs.TABLE_ACTIONS.map((a) => a.action), description: "Table operation." },
+        at: { type: "integer", minimum: 0, description: "Document position to place the cursor first (e.g. inside a cell)." },
+        rows: { type: "integer", minimum: 1, maximum: 100, description: "insertTable: rows (default 3)." },
+        cols: { type: "integer", minimum: 1, maximum: 50, description: "insertTable: columns (default 3)." },
+        withHeaderRow: { type: "boolean", description: "insertTable: first row is a header row (default true)." },
+        align: {
+          type: ["string", "null"],
+          enum: ["left", "center", "right", "justify", null],
+          description: "setCellAlignment: alignment, or null to clear."
+        },
+        color: { type: ["string", "null"], description: "setCellBackground: CSS color, or null to clear." }
+      },
+      required: ["operation"],
+      additionalProperties: false
+    },
+    annotations: {
+      title: "Edit tables",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: false
+    },
+    handler: ({ operation, at, ...params }) => {
+      const ed = editor();
+      if (at !== void 0) {
+        const size = ed.state.doc.content.size;
+        if (at > size) throw new Error(`Position ${at} is outside the document (size ${size}).`);
+        ed.view.dispatch(ed.state.tr.setSelection(_state.TextSelection.near(ed.state.doc.resolve(at))));
+      }
+      const action = operation;
+      const state = _chunkHDYMLS3Xcjs.getTableActionState.call(void 0, ed, action, params);
+      if (state !== true) throw new Error(state);
+      _chunkHDYMLS3Xcjs.runTableAction.call(void 0, ed, action, params);
+      const table = _chunkHDYMLS3Xcjs.getTableState.call(void 0, ed);
+      return {
+        operation,
+        table: table.inTable ? { rows: table.rows, columns: table.columns, row: table.row, column: table.column } : null,
+        selection: selectionInfo(ed)
+      };
+    }
+  };
   return {
     id: options.id,
     namespace: options.namespace,
     tools: () => {
       const ed = editor();
       if (!ed || ed.isDestroyed) return [];
-      return ed.isEditable ? [getText, insertText, replaceSelection] : [getText];
+      if (!ed.isEditable) return [getText];
+      return _chunkHDYMLS3Xcjs.isTableEnabled.call(void 0, ed) ? [getText, insertText, replaceSelection, editTable] : [getText, insertText, replaceSelection];
     },
     subscribe: (notify) => {
       const ed = editor();
@@ -817,7 +874,7 @@ var CELL_REF_REGEX = /^\$?([A-Za-z]{1,3})\$?(\d{1,7})$/;
 function parseCell(ref) {
   const match = CELL_REF_REGEX.exec(ref.trim());
   if (!match) throw new Error(`Invalid cell reference "${ref}". Use A1 notation, e.g. "B3".`);
-  return { col: _chunkC7P22VIPcjs.colNameToIndex.call(void 0, match[1].toUpperCase()), row: parseInt(match[2], 10) - 1 };
+  return { col: _chunkEWCOFSCQcjs.colNameToIndex.call(void 0, match[1].toUpperCase()), row: parseInt(match[2], 10) - 1 };
 }
 function createSpreadsheetToolProvider(controller, options) {
   const lookup = (row, col) => {
@@ -865,14 +922,14 @@ function createSpreadsheetToolProvider(controller, options) {
           const cell = controller.getCell(found.rowDef.id, found.colDef.id);
           valueRow.push(_nullishCoalesce(cell.error, () => ( cell.value)));
           rawRow.push(cell.raw);
-          const error = _nullishCoalesce(cell.error, () => ( (_chunkC7P22VIPcjs.isFormulaError.call(void 0, cell.value) ? cell.value : void 0)));
-          if (error) errors.push({ cell: `${_chunkC7P22VIPcjs.indexToColName.call(void 0, c)}${r + 1}`, error });
+          const error = _nullishCoalesce(cell.error, () => ( (_chunkEWCOFSCQcjs.isFormulaError.call(void 0, cell.value) ? cell.value : void 0)));
+          if (error) errors.push({ cell: `${_chunkEWCOFSCQcjs.indexToColName.call(void 0, c)}${r + 1}`, error });
         }
         values.push(valueRow);
         raw.push(rawRow);
       }
       return {
-        range: values.length && values[0].length ? `${_chunkC7P22VIPcjs.indexToColName.call(void 0, c0)}${r0 + 1}:${_chunkC7P22VIPcjs.indexToColName.call(void 0, c1)}${r1 + 1}` : null,
+        range: values.length && values[0].length ? `${_chunkEWCOFSCQcjs.indexToColName.call(void 0, c0)}${r0 + 1}:${_chunkEWCOFSCQcjs.indexToColName.call(void 0, c1)}${r1 + 1}` : null,
         values,
         raw,
         errors,
@@ -951,6 +1008,112 @@ function createEditorMcpToolProvider(options) {
   return { id: options.id, namespace: options.namespace, tools };
 }
 
+// src/agent/componentTools.ts
+var IDS = { type: "array", items: { type: "string" }, description: "Node ids (default: the selection)." };
+var ID = { type: "string", description: "An instance, or a layer inside one (default: the first selected node)." };
+var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+var check = (result) => {
+  if (!result.ok) throw new Error(result.reason);
+  return { ids: result.ids };
+};
+function createCanvasComponentToolProvider(controller, options = { id: "canvas-components" }) {
+  const tool = (name, description, properties, handler, extra = {}) => ({
+    name,
+    description,
+    inputSchema: { type: "object", properties, ...extra.required ? { required: extra.required } : {}, additionalProperties: false },
+    annotations: extra.readOnly ? READ : WRITE,
+    handler
+  });
+  const tools = [
+    tool("list_components", "Lists components (id, name, variant values, instance count) and component sets with their variant options.", {}, () => controller.list(), {
+      readOnly: true
+    }),
+    tool(
+      "inspect_instance",
+      "Describes an instance: its main component, variant, component property values (with types) and the overrides of its layers.",
+      { id: ID },
+      ({ id }) => {
+        const info = controller.inspect(id);
+        if (!info) throw new Error("Not an instance (or a layer inside one).");
+        return info;
+      },
+      { readOnly: true }
+    ),
+    tool(
+      "create_component",
+      "Turns the given frame into a main component, or wraps the given layers in a new one.",
+      { ids: IDS },
+      ({ ids }) => check(controller.createComponent(ids))
+    ),
+    tool(
+      "combine_as_variants",
+      'Wraps sibling components in a component set (variants named "Property=Value, \u2026").',
+      { ids: IDS },
+      ({ ids }) => check(controller.combineAsVariants(ids))
+    ),
+    tool(
+      "create_instance",
+      "Places an instance of a component or component set, optionally inside a frame, at a position, with property values.",
+      {
+        componentId: { type: "string" },
+        parentId: { type: "string" },
+        x: { type: "number" },
+        y: { type: "number" },
+        properties: { type: "object", additionalProperties: true, description: "Variant and component property values." }
+      },
+      ({ componentId, parentId, x, y, properties }) => check(
+        controller.createInstance(componentId, {
+          ...parentId !== void 0 ? { parentId } : {},
+          ...x !== void 0 || y !== void 0 ? { position: { x: _nullishCoalesce(x, () => ( 0)), y: _nullishCoalesce(y, () => ( 0)) } } : {},
+          ...properties ? { properties } : {}
+        })
+      ),
+      { required: ["componentId"] }
+    ),
+    tool(
+      "set_instance_properties",
+      "Sets property values of instances: variant properties switch the variant (keeping compatible overrides), booleans toggle layers, text sets text, instance swap takes a component id.",
+      { properties: { type: "object", additionalProperties: true }, ids: IDS },
+      ({ properties, ids }) => check(controller.setInstanceProperties(properties, ids)),
+      { required: ["properties"] }
+    ),
+    tool(
+      "swap_instance",
+      "Makes instances show another component (or a set\u2019s default variant), keeping overrides of layers with matching names.",
+      { componentId: { type: "string" }, ids: IDS },
+      ({ componentId, ids }) => check(controller.swapInstance(componentId, ids)),
+      { required: ["componentId"] }
+    ),
+    tool(
+      "reset_overrides",
+      'Resets overrides: of a whole instance (default), of one layer, or one override group such as "data.label" or "shape.fill".',
+      { id: ID, group: { type: "string" } },
+      ({ id, group }) => check(controller.resetOverrides(id, group))
+    ),
+    tool(
+      "push_overrides",
+      "Copies an instance\u2019s overrides to its main component (and so to every other instance).",
+      { id: ID },
+      ({ id }) => check(controller.pushOverrides(id))
+    ),
+    tool("detach_instance", "Turns instances into plain frames that keep their current look.", { ids: IDS }, ({ ids }) => check(controller.detachInstance(ids))),
+    tool("go_to_main_component", "Selects the main component of an instance and returns its id.", { id: ID }, ({ id }) => {
+      const main = controller.goToMainComponent(id);
+      if (!main) throw new Error("The main component was not found.");
+      return { id: main };
+    }),
+    tool(
+      "restore_main_component",
+      "Turns an instance whose main component was deleted back into the main component.",
+      { id: ID },
+      ({ id }) => check(controller.restoreMainComponent(id))
+    )
+  ];
+  return { id: options.id, namespace: options.namespace, tools };
+}
+
+
 
 
 
@@ -970,5 +1133,5 @@ function createEditorMcpToolProvider(options) {
 
 
 
-exports.EDITOR_MCP_TOOLS = EDITOR_MCP_TOOLS; exports.EXPORT_EXCLUDED_SELECTORS = EXPORT_EXCLUDED_SELECTORS; exports.MCP_TOOL_EDIT_CANVAS = MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_VIEW_EDITOR = MCP_TOOL_VIEW_EDITOR; exports.TOOL_NAMESPACE_SEPARATOR = TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = ToolRegistry; exports.ToolRegistryError = ToolRegistryError; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = createToolRegistry; exports.normalizeSide = normalizeSide; exports.planAgentCommand = planAgentCommand; exports.planToolCall = planToolCall; exports.toToolResult = toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.validateJsonSchema = _chunkCPOKFNBGcjs.validateJsonSchema;
+exports.EDITOR_MCP_TOOLS = EDITOR_MCP_TOOLS; exports.EXPORT_EXCLUDED_SELECTORS = EXPORT_EXCLUDED_SELECTORS; exports.MCP_TOOL_EDIT_CANVAS = MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_VIEW_EDITOR = MCP_TOOL_VIEW_EDITOR; exports.TOOL_NAMESPACE_SEPARATOR = TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = ToolRegistry; exports.ToolRegistryError = ToolRegistryError; exports.createCanvasComponentToolProvider = createCanvasComponentToolProvider; exports.createEditorMcpToolProvider = createEditorMcpToolProvider; exports.createRichTextToolProvider = createRichTextToolProvider; exports.createSpreadsheetToolProvider = createSpreadsheetToolProvider; exports.createToolRegistry = createToolRegistry; exports.normalizeSide = normalizeSide; exports.planAgentCommand = planAgentCommand; exports.planToolCall = planToolCall; exports.toToolResult = toToolResult; exports.toolCallToAgentCommand = toolCallToAgentCommand; exports.validateJsonSchema = _chunkCPOKFNBGcjs.validateJsonSchema;
 //# sourceMappingURL=index.cjs.map