@pixerate/editor 0.154.0 → 0.156.0

package/dist/vector/index.js

@@ -38,7 +38,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-UILRJQFD.js";
+} from "../chunk-WNAAWLZ5.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -507,8 +507,8 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-FLOGD3QB.js";
-import "../chunk-ORDXMBD4.js";
+} from "../chunk-6UPGM3JB.js";
+import "../chunk-A5UCR2TO.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";
@@ -545,7 +545,7 @@ import {
 import "../chunk-V2ZCJRDM.js";
 import {
   GRAIN_PATTERNS
-} from "../chunk-AGZ47XY2.js";
+} from "../chunk-2N2QPO3H.js";
 import "../chunk-ODBT55Q7.js";
 import {
   bytesToBase64,
@@ -560,8 +560,7 @@ import "../chunk-SIFAIGB3.js";
 import "../chunk-VDGBHYC7.js";
 import {
   defineEditorDocument
-} from "../chunk-GNV54DLO.js";
-import "../chunk-WHKNYFM2.js";
+} from "../chunk-NHLYK3AX.js";
 import "../chunk-HF5QZS7Z.js";
 import {
   HistoryManager

package/dist/video-editor/index.cjs

@@ -147,8 +147,7 @@ var _chunkRUZQMYXHcjs = require('../chunk-RUZQMYXH.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
-var _chunk5H2C3QSFcjs = require('../chunk-5H2C3QSF.cjs');
-require('../chunk-L5OWG2NA.cjs');
+var _chunkM4MIZPQIcjs = require('../chunk-M4MIZPQI.cjs');
 require('../chunk-2BSBFBOA.cjs');
 
 
@@ -4871,7 +4870,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
 
 // src/video-editor/editorDocument.ts
 function createVideoEditorDocument(controller) {
-  return _chunk5H2C3QSFcjs.defineEditorDocument.call(void 0, {
+  return _chunkM4MIZPQIcjs.defineEditorDocument.call(void 0, {
     kind: "video",
     get: () => controller.getProject(),
     load: (document2, { history }) => {

package/dist/video-editor/index.js

@@ -147,8 +147,7 @@ import {
 import "../chunk-V2ZCJRDM.js";
 import {
   defineEditorDocument
-} from "../chunk-GNV54DLO.js";
-import "../chunk-WHKNYFM2.js";
+} from "../chunk-NHLYK3AX.js";
 import "../chunk-HF5QZS7Z.js";
 import {
   HistoryManager

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.154.0",
+  "version": "0.156.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-image-editor/SKILL.md

@@ -96,30 +96,10 @@ batching.
 
 ### Smart objects
 
-1. **Convert before repeated or uncertain changes**: `convert_to_smart_object` (one pixel layer, or
-   several siblings that nest as a layer document). A converted pixel layer looks exactly the same
-   and keeps its id; its filters become smart filters. From then on every transform and filter is
-   re-rendered from the contents, so scaling down and back up, or rotating twelve times, loses
-   nothing.
-2. **Read it**: `get_smart_object` gives the contents (size, kind, instances), the placement
-   (corners, warp, and scale / rotate in percent and degrees of the contents' own size) and the
-   smart filters with their ids.
-3. **Transform**: `set_smart_object_transform` sets the transform absolutely (scale 100 = the
-   contents' own size, `x`, `y` = where its centre goes; or `corners`, `matrix`, and a `warp` in
-   contents pixels, `null` to remove). `transform_layer`, `warp_layer`, `flip_layer` and
-   `rotate_layer_90` also work on a smart object, relative to its current placement, and never
-   degrade it. `offset_layer` moves it by whole pixels.
-4. **Filter non-destructively**: `add_smart_filter` (`develop` or `blur`, each with its own
-   `blend` and `opacity`; kinds can repeat), then `update_smart_filter`, `move_smart_filter`,
-   `remove_smart_filter` and `set_smart_filters_enabled`. `set_smart_filter_mask` limits where the
-   filters show; paint it with `paint_stroke` / `fill_pixels` `channel: "filter-mask"`.
-5. **Contents**: `copy_smart_object` with `linked: true` shares the contents (edit once, both
-   change), `linked: false` makes them independent. `edit_smart_object_contents` opens the
-   contents as their own document: every tool then works inside them until
-   `close_smart_object_contents` (`save: false` discards). `replace_smart_object_contents` swaps
-   in a new image for every linked instance; `export_smart_object_contents` returns the file.
-6. **Finish**: `rasterize_smart_object` only when the user wants plain pixels to paint on; the
-   placement and filters are then gone.
+Convert a pixel layer with `convert_to_smart_object` before repeated or uncertain transforms and
+filters: from then on everything re-renders from the contents and nothing degrades. Read
+[references/smart-objects.md](references/smart-objects.md) for the steps (reading, transforming,
+smart filters, linked contents, rasterizing).
 
 ### Shapes and text
 
@@ -413,6 +393,18 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect at the document's size and bit depth (`values`, `time`, `name`, `aboveId` / `belowId`, `opacity`, `blend`). Returns the layer id. |
 | `apply_selection_as_mask` | Mask a layer with the current selection: pass `layerId` to mask an existing layer, or `kind` (plus optional `params`) to create a new masked layer in one step. `density` 0..1 and `feather` px soften the mask non-destructively. Returns `layerId`, kind, mask info and the selection summary. |
 
+### Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). An image document is the saved state (layers, adjustments, crop, selection...) with layer pixels, masks and patterns as asset references; the source image stays the host's.
+
+| Tool | Use |
+| --- | --- |
+| `get_image_document` | Take a copy of the whole image document as `{ kind, formatVersion, revision, document }` before a risky change, or to hand it on. Images in it are asset references (`pixerate-asset:...`), never pixel data, so it stays small. To look at the pixels use `render_preview` or `capture_view`. |
+| `load_image_document` | Put back a copy from `get_image_document` in this session (its `document`, or the whole result). Checked first: a document whose assets are not loaded, or from a newer build, is refused and nothing changes. One undo step (`undo_image` brings the previous document back). To change part of the image use the layer and adjustment tools. |
+| `save_image_document` | Save the image document and its assets under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_image_documents` | List saved image documents (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_image_document` | Replace the image document with a saved one by `key`; its assets are read from storage first. Ask before opening over changes the user has not saved. |
+
 ## Pitfalls
 
 - Agent playback (if on) opens each write's panel, then traces `points`, drags boxes or visits the layers and sliders named; results are unchanged.

package/skills/pixerate-image-editor/references/smart-objects.md

@@ -0,0 +1,28 @@
+# Smart objects
+
+How to work with smart objects in the image editor (see the main skill for the tool reference).
+
+1. **Convert before repeated or uncertain changes**: `convert_to_smart_object` (one pixel layer, or
+   several siblings that nest as a layer document). A converted pixel layer looks exactly the same
+   and keeps its id; its filters become smart filters. From then on every transform and filter is
+   re-rendered from the contents, so scaling down and back up, or rotating twelve times, loses
+   nothing.
+2. **Read it**: `get_smart_object` gives the contents (size, kind, instances), the placement
+   (corners, warp, and scale / rotate in percent and degrees of the contents' own size) and the
+   smart filters with their ids.
+3. **Transform**: `set_smart_object_transform` sets the transform absolutely (scale 100 = the
+   contents' own size, `x`, `y` = where its centre goes; or `corners`, `matrix`, and a `warp` in
+   contents pixels, `null` to remove). `transform_layer`, `warp_layer`, `flip_layer` and
+   `rotate_layer_90` also work on a smart object, relative to its current placement, and never
+   degrade it. `offset_layer` moves it by whole pixels.
+4. **Filter non-destructively**: `add_smart_filter` (`develop` or `blur`, each with its own
+   `blend` and `opacity`; kinds can repeat), then `update_smart_filter`, `move_smart_filter`,
+   `remove_smart_filter` and `set_smart_filters_enabled`. `set_smart_filter_mask` limits where the
+   filters show; paint it with `paint_stroke` / `fill_pixels` `channel: "filter-mask"`.
+5. **Contents**: `copy_smart_object` with `linked: true` shares the contents (edit once, both
+   change), `linked: false` makes them independent. `edit_smart_object_contents` opens the
+   contents as their own document: every tool then works inside them until
+   `close_smart_object_contents` (`save: false` discards). `replace_smart_object_contents` swaps
+   in a new image for every linked instance; `export_smart_object_contents` returns the file.
+6. **Finish**: `rasterize_smart_object` only when the user wants plain pixels to paint on; the
+   placement and filters are then gone.

package/skills/pixerate-paint-editor/SKILL.md

@@ -85,7 +85,7 @@ is never part of a layer. Coordinates are document pixels, (0, 0) top-left, y do
 9. **Watercolour** is its own way of working (see "Wet media" below): wet the paper or not,
    lay washes light to dark, let them flow (`advance_wet_paint`), dry them (`dry_paint`), glaze.
 10. **Deliver**: `export_image` (PNG, or JPEG / WebP in a browser), `export_psd` for Photoshop,
-   `save_document` to keep the painting with its strokes.
+   `save_paint_document` to keep the painting with its strokes (when the host has storage).
 
 ## Best practices
 
@@ -133,6 +133,13 @@ is never part of a layer. Coordinates are document pixels, (0, 0) top-left, y do
 
   PSD has none of them: `export_psd` writes the nearest standard mode (watercolor and shadow
   as Multiply, tint as Color, highlight as Screen) and warns; the merged image stays exact.
+- **Grow the canvas instead of starting big**: when the picture needs more room, call
+  `extend_canvas` with the pixels to add on each side (nothing painted moves relative to
+  anything else). Adding on the `left` or `top` shifts every coordinate you hold (stroke points,
+  guide and stencil positions, layer bounds) by (+left, +top); re-read with `list_layers` or use
+  the returned `rect` (the new canvas in the old coordinates). Wet paint dries first, so finish
+  or dry a wash (`dry_paint`) before extending. `set_canvas` only crops or grows at the
+  bottom-right and never moves the picture.
 - **Save brushes you build** (`set_brush` then `save_brush`), and share them with
   `export_brushes` / `import_brushes`.
 
@@ -264,9 +271,10 @@ for the controls and presets.
 
 | Tool | Use |
 | --- | --- |
-| `get_canvas_info` | Read the canvas size and dpi, paper (preset, colour, depth), active layer, layer count, active brush id, colours, view, hand, number of recorded strokes, undo / redo labels and the blend modes. Call first. |
+| `get_canvas_info` | Read the canvas size and dpi, its `origin` (moved by `extend_canvas`), paper (preset, colour, depth), active layer, layer count, active brush id, colours, view, hand, number of recorded strokes, undo / redo labels and the blend modes. Call first. |
 | `new_canvas` | Start over with a blank canvas: one empty layer over the paper. `width`, `height` (1..16384 px), `dpi`, `paper` preset id; missing ones keep the current values. Undo brings the old painting back. Returns the size, paper and layer id. |
 | `set_canvas` | Resize the canvas (pixels stay put, anchored top-left) or change its `dpi`. Returns the canvas. |
+| `extend_canvas` | Add pixels on any side (`left`, `top`, `right`, `bottom`, default 0) keeping everything painted, the paper grain and the guides in place relative to each other. `left` / `top` move all document coordinates by that much. Wet paint dries first; one undo step. Returns `canvas`, `rect` (the new canvas in the previous coordinates) and `origin` (also in `get_canvas_info`). |
 | `list_papers` | Read the paper library: id, name, family, grain pattern, colour, depth and the wet-media properties (absorption, permeability, roughness, stored for later wet media). Call before `set_paper`. |
 | `get_paper` | Read every setting of the current paper (pattern, seed, scale, tiling, depth, shading, dry and wet tuning). |
 | `set_paper` | Change the paper: `preset`, then any of `color`, `depth` (0..1), `scale` (0.25..8), `seed` (another sheet), `pattern`, `tiling`, `shading`, `dry` / `wet` tuning (`contrast` 0..3, `invert`). Affects new strokes' grain and how the paper shows; strokes already painted keep their pixels. Returns the paper. |
@@ -412,8 +420,20 @@ for the controls and presets.
 | `export_psd` | Export a PSD with every layer, the paper as a locked bottom layer, and the composite. Pigment and painterly modes are written as their nearest standard mode (`list_blend_modes` `psd`). Returns base64, size, `psb` and `warnings`. |
 | `export_time_lapse` | Repaint the painting from its recorded strokes and events as a time-lapse: `frames` (about how many), `fps`, `maxSide`, `wetStepsPerFrame` (frames while wet paint flows), `holdMs`. Returns a contact sheet image, the frame count, size, duration, a video project of the frames and the ffmpeg command that renders `timelapse.mp4`; `includeFrames` adds every frame as base64 PNG. Changes nothing. |
 | `export_high_res` | Repaint the painting from its strokes at `scale` 1..8 (brushes, grain, fills and wet events scaled): a PNG with real detail instead of upscaled pixels. Returns base64, size. Layers not painted with strokes come out empty. |
-| `save_document` | Get the document JSON (canvas, paper, layers as PNG data URLs, strokes unless `strokes: false`). |
-| `open_document` | Open a saved document JSON, replacing the painting and clearing the undo history. Returns the canvas, layers and any `problems`. |
+| `save_document` | Deprecated, kept for one minor version: use `get_paint_document` or `save_paint_document`. Returns the document JSON with PNG data URLs inline (large). |
+| `open_document` | Deprecated, kept for one minor version: use `load_paint_document` or `open_saved_paint_document`. Opens a document JSON from `save_document`, clearing the undo history. |
+
+### Save and open
+
+The host may add the shared document tools (see `pixerate-agent-tools`). A paint document is the saved painting (canvas, paper, layers, thick paint, guides, swatches, mixing pad and recorded strokes) with every image as an asset reference; wet paint is saved dry.
+
+| Tool | Use |
+| --- | --- |
+| `get_paint_document` | Take a copy of the whole painting as `{ kind, formatVersion, revision, document }` before a risky change, or to hand it on. Images in it are asset references (`pixerate-asset:...`), never pixel data, so it stays small. To look at the pixels use `render_preview` or `export_image`. |
+| `load_paint_document` | Put back a copy from `get_paint_document` in this session (its `document`, or the whole result). Checked first: a document whose assets are not loaded, or from a newer build, is refused and nothing changes. Opening clears the undo history (`undoable: false`), so get a copy first if the user may want the current painting back. Refused while a stroke or a wet-paint step is in progress. To change part of the painting use the layer and painting tools. |
+| `save_paint_document` | Save the painting and its assets under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |
+| `list_saved_paint_documents` | List saved paintings (`key`, `name`, `savedAt`), newest first. |
+| `open_saved_paint_document` | Replace the painting with a saved one by `key`; its assets are read from storage first. Ask before opening over changes the user has not saved. |
 
 ## Pitfalls
 
@@ -458,5 +478,5 @@ for the controls and presets.
 - **Effects are pixels in replays.** Effect paper, effect layers, effect fills and baked light
   need the provider when they are made; replays and time-lapses do not repeat them. Add them
   after the painting, or keep the effect layer and redraw it.
-- **Recorded strokes are kept in saved documents**; `save_document` with `strokes: false` when
-  only the pixels matter (smaller JSON).
+- **Recorded strokes are kept in saved documents** (`save_paint_document`, `get_paint_document`),
+  so a painting can be replayed and repainted at a higher resolution.

package/dist/chunk-5H2C3QSF.cjs

@@ -1,134 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-
-var _chunkL5OWG2NAcjs = require('./chunk-L5OWG2NA.cjs');
-
-
-var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
-
-// src/persistence/editorDocument.ts
-var EditorDocumentLoadError = class extends Error {
-  /** The `LoadReport` when the input was a file that could not be migrated. */
-  
-  constructor(message, report) {
-    super(message);
-    this.name = "EditorDocumentLoadError";
-    this.report = report;
-  }
-};
-var EDITOR_DOCUMENT_FORMAT = "pixerate.editor-document";
-var KIND = /^[a-z][a-z0-9_]*$/;
-function isEditorDocumentFile(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  const v = value;
-  return v.format === EDITOR_DOCUMENT_FORMAT && typeof v.kind === "string" && typeof v.formatVersion === "number" && "document" in v;
-}
-function toEditorDocumentFile(doc, name) {
-  return {
-    format: EDITOR_DOCUMENT_FORMAT,
-    kind: doc.kind,
-    formatVersion: doc.formatVersion,
-    ...name ? { name } : {},
-    document: doc.getDocument()
-  };
-}
-function serializeEditorDocument(doc, options = {}) {
-  return JSON.stringify(toEditorDocumentFile(doc, options.name), null, options.space);
-}
-function parseEditorDocument(text, options = {}) {
-  let value;
-  try {
-    value = _chunk2BSBFBOAcjs.stripPrototypeKeys.call(void 0, JSON.parse(text));
-  } catch (error) {
-    throw new EditorDocumentLoadError(`The file is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  if (!isEditorDocumentFile(value)) {
-    throw new EditorDocumentLoadError(`The file is not a saved editor document (expected "format": "${EDITOR_DOCUMENT_FORMAT}").`);
-  }
-  if (options.kind && value.kind !== options.kind) {
-    throw new EditorDocumentLoadError(`The file is a ${value.kind} document, not a ${options.kind} document.`);
-  }
-  return value;
-}
-function defineEditorDocument(spec) {
-  if (!KIND.test(spec.kind)) throw new Error(`Editor document kind "${spec.kind}" must match ${KIND}.`);
-  const formatVersion = _nullishCoalesce(spec.formatVersion, () => ( 1));
-  const listeners = /* @__PURE__ */ new Set();
-  let revision = 0;
-  let unsubscribe = null;
-  let connected = false;
-  const connect = () => {
-    if (unsubscribe) return;
-    if (connected) revision++;
-    connected = true;
-    unsubscribe = spec.subscribe(() => {
-      revision++;
-      listeners.forEach((listener) => {
-        try {
-          listener();
-        } catch (error) {
-          console.error(`[${spec.kind} document] Error in change listener:`, error);
-        }
-      });
-    });
-  };
-  connect();
-  const unwrap = (input) => {
-    if (!isEditorDocumentFile(input)) return { document: input, report: _chunkL5OWG2NAcjs.createLoadReport.call(void 0, { version: formatVersion }) };
-    if (input.kind !== spec.kind) throw new EditorDocumentLoadError(`This is a ${input.kind} document; it cannot be opened in the ${spec.kind} editor.`);
-    const steps = Object.fromEntries(
-      Object.entries(_nullishCoalesce(spec.migrations, () => ( {}))).map(([v, step]) => [v, (w) => ({ ...w, document: step(w.document) })])
-    );
-    const { doc, report } = _chunkL5OWG2NAcjs.migrateDocument.call(void 0, 
-      { formatVersion: input.formatVersion, document: input.document },
-      { currentVersion: formatVersion, versionKey: "formatVersion", steps }
-    );
-    if (report.readOnly) throw new EditorDocumentLoadError(`Cannot open the ${spec.kind} document: ${report.readOnly.message}.`, report);
-    return { document: doc.document, report };
-  };
-  return {
-    kind: spec.kind,
-    formatVersion,
-    recordsLoads: spec.recordsLoads !== false,
-    getDocument: () => spec.get(),
-    loadDocument(input, options = {}) {
-      const { document, report } = unwrap(input);
-      if (document === void 0 || document === null) throw new EditorDocumentLoadError(`No ${spec.kind} document was given.`);
-      try {
-        const result = spec.load(document, { history: _nullishCoalesce(options.history, () => ( "reset")) });
-        if (_optionalChain([result, 'optionalAccess', _ => _.problems, 'optionalAccess', _2 => _2.length])) report.problems.push(...result.problems);
-      } catch (error) {
-        if (error instanceof EditorDocumentLoadError) throw error;
-        throw new EditorDocumentLoadError(error instanceof Error ? error.message : String(error));
-      }
-      return report;
-    },
-    revision: () => {
-      connect();
-      return revision;
-    },
-    subscribe(listener) {
-      connect();
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    history: spec.history,
-    readOnly: () => _nullishCoalesce(_optionalChain([spec, 'access', _3 => _3.readOnly, 'optionalCall', _4 => _4()]), () => ( false)),
-    destroy() {
-      _optionalChain([unsubscribe, 'optionalCall', _5 => _5()]);
-      unsubscribe = null;
-    }
-  };
-}
-
-
-
-
-
-
-
-
-
-exports.EditorDocumentLoadError = EditorDocumentLoadError; exports.EDITOR_DOCUMENT_FORMAT = EDITOR_DOCUMENT_FORMAT; exports.isEditorDocumentFile = isEditorDocumentFile; exports.toEditorDocumentFile = toEditorDocumentFile; exports.serializeEditorDocument = serializeEditorDocument; exports.parseEditorDocument = parseEditorDocument; exports.defineEditorDocument = defineEditorDocument;

package/dist/chunk-GNV54DLO.js

@@ -1,134 +0,0 @@
-import {
-  createLoadReport,
-  migrateDocument
-} from "./chunk-WHKNYFM2.js";
-import {
-  stripPrototypeKeys
-} from "./chunk-HF5QZS7Z.js";
-
-// src/persistence/editorDocument.ts
-var EditorDocumentLoadError = class extends Error {
-  /** The `LoadReport` when the input was a file that could not be migrated. */
-  report;
-  constructor(message, report) {
-    super(message);
-    this.name = "EditorDocumentLoadError";
-    this.report = report;
-  }
-};
-var EDITOR_DOCUMENT_FORMAT = "pixerate.editor-document";
-var KIND = /^[a-z][a-z0-9_]*$/;
-function isEditorDocumentFile(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  const v = value;
-  return v.format === EDITOR_DOCUMENT_FORMAT && typeof v.kind === "string" && typeof v.formatVersion === "number" && "document" in v;
-}
-function toEditorDocumentFile(doc, name) {
-  return {
-    format: EDITOR_DOCUMENT_FORMAT,
-    kind: doc.kind,
-    formatVersion: doc.formatVersion,
-    ...name ? { name } : {},
-    document: doc.getDocument()
-  };
-}
-function serializeEditorDocument(doc, options = {}) {
-  return JSON.stringify(toEditorDocumentFile(doc, options.name), null, options.space);
-}
-function parseEditorDocument(text, options = {}) {
-  let value;
-  try {
-    value = stripPrototypeKeys(JSON.parse(text));
-  } catch (error) {
-    throw new EditorDocumentLoadError(`The file is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  if (!isEditorDocumentFile(value)) {
-    throw new EditorDocumentLoadError(`The file is not a saved editor document (expected "format": "${EDITOR_DOCUMENT_FORMAT}").`);
-  }
-  if (options.kind && value.kind !== options.kind) {
-    throw new EditorDocumentLoadError(`The file is a ${value.kind} document, not a ${options.kind} document.`);
-  }
-  return value;
-}
-function defineEditorDocument(spec) {
-  if (!KIND.test(spec.kind)) throw new Error(`Editor document kind "${spec.kind}" must match ${KIND}.`);
-  const formatVersion = spec.formatVersion ?? 1;
-  const listeners = /* @__PURE__ */ new Set();
-  let revision = 0;
-  let unsubscribe = null;
-  let connected = false;
-  const connect = () => {
-    if (unsubscribe) return;
-    if (connected) revision++;
-    connected = true;
-    unsubscribe = spec.subscribe(() => {
-      revision++;
-      listeners.forEach((listener) => {
-        try {
-          listener();
-        } catch (error) {
-          console.error(`[${spec.kind} document] Error in change listener:`, error);
-        }
-      });
-    });
-  };
-  connect();
-  const unwrap = (input) => {
-    if (!isEditorDocumentFile(input)) return { document: input, report: createLoadReport({ version: formatVersion }) };
-    if (input.kind !== spec.kind) throw new EditorDocumentLoadError(`This is a ${input.kind} document; it cannot be opened in the ${spec.kind} editor.`);
-    const steps = Object.fromEntries(
-      Object.entries(spec.migrations ?? {}).map(([v, step]) => [v, (w) => ({ ...w, document: step(w.document) })])
-    );
-    const { doc, report } = migrateDocument(
-      { formatVersion: input.formatVersion, document: input.document },
-      { currentVersion: formatVersion, versionKey: "formatVersion", steps }
-    );
-    if (report.readOnly) throw new EditorDocumentLoadError(`Cannot open the ${spec.kind} document: ${report.readOnly.message}.`, report);
-    return { document: doc.document, report };
-  };
-  return {
-    kind: spec.kind,
-    formatVersion,
-    recordsLoads: spec.recordsLoads !== false,
-    getDocument: () => spec.get(),
-    loadDocument(input, options = {}) {
-      const { document, report } = unwrap(input);
-      if (document === void 0 || document === null) throw new EditorDocumentLoadError(`No ${spec.kind} document was given.`);
-      try {
-        const result = spec.load(document, { history: options.history ?? "reset" });
-        if (result?.problems?.length) report.problems.push(...result.problems);
-      } catch (error) {
-        if (error instanceof EditorDocumentLoadError) throw error;
-        throw new EditorDocumentLoadError(error instanceof Error ? error.message : String(error));
-      }
-      return report;
-    },
-    revision: () => {
-      connect();
-      return revision;
-    },
-    subscribe(listener) {
-      connect();
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    history: spec.history,
-    readOnly: () => spec.readOnly?.() ?? false,
-    destroy() {
-      unsubscribe?.();
-      unsubscribe = null;
-    }
-  };
-}
-
-export {
-  EditorDocumentLoadError,
-  EDITOR_DOCUMENT_FORMAT,
-  isEditorDocumentFile,
-  toEditorDocumentFile,
-  serializeEditorDocument,
-  parseEditorDocument,
-  defineEditorDocument
-};

package/dist/chunk-L5OWG2NA.cjs

@@ -1,135 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-
-var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
-
-// src/persistence/migrate.ts
-function hasLoadProblems(report) {
-  return report.problems.length > 0 || report.readOnly !== null;
-}
-function createLoadReport(partial = {}) {
-  return {
-    migratedFrom: null,
-    version: null,
-    problems: [],
-    readOnly: null,
-    unknownKeys: [],
-    ...partial
-  };
-}
-var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var deepClone = (value) => typeof structuredClone === "function" ? structuredClone(value) : JSON.parse(JSON.stringify(value));
-function toObject(json) {
-  let value = json;
-  if (typeof json === "string") {
-    try {
-      value = JSON.parse(json);
-    } catch (e) {
-      return void 0;
-    }
-  }
-  return isObject(value) ? _chunk2BSBFBOAcjs.stripPrototypeKeys.call(void 0, deepClone(value)) : void 0;
-}
-function migrateDocument(json, options) {
-  const versionKey = _nullishCoalesce(options.versionKey, () => ( "version"));
-  const target = options.currentVersion;
-  const original = toObject(json);
-  if (!original) {
-    return {
-      doc: { [versionKey]: target },
-      report: createLoadReport({
-        readOnly: { kind: "invalid", message: "document is not a JSON object" }
-      })
-    };
-  }
-  const raw = original[versionKey];
-  const found = typeof raw === "number" && Number.isInteger(raw) && raw >= 0 ? raw : null;
-  const from = _nullishCoalesce(_nullishCoalesce(found, () => ( options.missingVersion)), () => ( target));
-  const report = createLoadReport({ version: found });
-  if (from > target) {
-    report.readOnly = {
-      kind: "newerVersion",
-      version: from,
-      supported: target,
-      message: `document has version ${from}, newer than the supported ${target}`
-    };
-    return { doc: original, report };
-  }
-  if (from === target) {
-    original[versionKey] = target;
-    return { doc: original, report };
-  }
-  let doc = deepClone(original);
-  for (let step = from; step < target; step++) {
-    const fn = _optionalChain([options, 'access', _ => _.steps, 'optionalAccess', _2 => _2[step]]);
-    if (!fn) {
-      report.readOnly = {
-        kind: "migrationFailed",
-        from: step,
-        message: `no migration step from version ${step}`
-      };
-      return { doc: original, report };
-    }
-    try {
-      doc = _nullishCoalesce(fn(doc), () => ( doc));
-    } catch (error) {
-      report.readOnly = {
-        kind: "migrationFailed",
-        from: step,
-        message: `migration from version ${step} failed: ${error instanceof Error ? error.message : String(error)}`
-      };
-      return { doc: original, report };
-    }
-    doc[versionKey] = step + 1;
-  }
-  report.migratedFrom = from;
-  return { doc, report };
-}
-function loadSections(doc, sections, options = {}) {
-  const source = isObject(doc) ? doc : {};
-  const ignore = new Set(_nullishCoalesce(options.ignore, () => ( ["version"])));
-  const value = {};
-  const problems = [];
-  for (const key of Object.keys(sections)) {
-    const spec = sections[key];
-    const fallback = () => typeof spec.defaults === "function" ? spec.defaults() : spec.defaults;
-    if (!Object.prototype.hasOwnProperty.call(source, key)) {
-      value[key] = fallback();
-      continue;
-    }
-    try {
-      const parsed = spec.parse(source[key]);
-      if (parsed === void 0) throw new Error("invalid value");
-      value[key] = parsed;
-    } catch (error) {
-      problems.push({
-        section: key,
-        message: error instanceof Error ? error.message : String(error)
-      });
-      value[key] = fallback();
-    }
-  }
-  const unknown = {};
-  for (const key of Object.keys(source)) {
-    if (!(key in sections) && !ignore.has(key) && !_chunk2BSBFBOAcjs.isUnsafeJsonKey.call(void 0, key)) unknown[key] = source[key];
-  }
-  return { value, problems, unknown };
-}
-function loadDocument(json, sections, options) {
-  const { doc, report } = migrateDocument(json, options);
-  const ignore = _nullishCoalesce(options.ignore, () => ( [_nullishCoalesce(options.versionKey, () => ( "version"))]));
-  const result = loadSections(_optionalChain([report, 'access', _3 => _3.readOnly, 'optionalAccess', _4 => _4.kind]) === "invalid" ? {} : doc, sections, {
-    ignore
-  });
-  report.problems = result.problems;
-  report.unknownKeys = Object.keys(result.unknown);
-  return { ...result, report };
-}
-
-
-
-
-
-
-
-exports.hasLoadProblems = hasLoadProblems; exports.createLoadReport = createLoadReport; exports.migrateDocument = migrateDocument; exports.loadSections = loadSections; exports.loadDocument = loadDocument;