@oh-just-another/editor 0.59.0 → 0.60.0

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @oh-just-another/editor
 
+## 0.60.0
+
+### Minor Changes
+
+- 179bad8: Add a built-in `minimap` prop to `<Diagram>`/`<Editor>`. When set, the minimap docks bottom-right above the zoom controls and is hidden in zen mode along with the rest of the chrome (it reads the editor from context). Previously hosts had to mount `<Minimap>` themselves, which sat outside the zen-gated chrome and overlapped the zoom pill. Off by default.
+- 1c4941e: New `<DrawingPanel>` — a floating tool-options panel that appears while the brush or eraser is active. It edits `editor.brushSettings` (via the new `useBrushSettings` hook): line colour, enclosed-fill colour, opacity and width for the brush; only the width (which doubles as the eraser radius) for the eraser. `<Diagram>` mounts it automatically top-right, hidden in zen mode; opt out with the new `hideDrawingPanel` prop. This is a functional scaffold intended for restyling.
+- 6d184ad: Add `defineShape()` — one-call facade for registering a custom shape type (bounder, renderer, optional interactive hit-tester and rotate anchor). Re-export `registerInteractiveHitTester` / `registerRotateAnchor` and plugin types (`ElementBase`, `ElementBounder`, `ElementRenderer`, `RenderTarget`, `InteractiveHitTester`, `AnchorRef`).
+- 2fbc079: Add editor file operations as registry actions + hotkeys: Save as JSON (`⌘S`), Open… (`⌘O`), Export PNG (`⌘⇧E`) and Copy as image to the system clipboard (`⇧⌥C`, PNG blob via the async Clipboard API). Exposed via `registerFileActions()` / `fileActions` and the `downloadScene` / `openSceneFile` / `downloadPng` / `downloadSvg` / `copySceneAsImage` helpers (`setFileActionNotifier` routes errors to a host toast). `<Editor>` registers them on mount and adds a "Copy as image" File-menu item with shortcut hints. All built on the existing serialization + exporter pipelines.
+- bdc847e: Add four editor tools:
+  - **Eyedropper** — new `eyedropper` mode (toolbar button, `Alt+I`). Click a
+    shape to sample its fill/stroke and apply it to the selection.
+    `Editor.pickColorAt` / `applyEyedropperAt` + pure `pickColorAt`.
+  - **Convert element type** — `Editor.convertSelection(target)` and pure
+    `computeConvertType` switch rectangle ↔ ellipse ↔ diamond (polygon) in place,
+    preserving position/size/style. New "Shape type" property-panel control.
+  - **Image crop** — optional normalised `crop` rect on `ImageElement` (additive,
+    serialised). New `crop` mode entered by double-clicking an image or the
+    property-panel Crop button: drag a frame, `Enter` to apply, `Esc` to cancel.
+    Canvas2D renders the cropped source region (`RenderTarget.drawImage` gains an
+    optional `crop` arg). `Editor.beginImageCrop` / `commitImageCrop` /
+    `cancelImageCrop` + pure `computeSetImageCrop` / `cropRectFromWorldDrag`.
+  - **Flowchart auto-generate** — `Cmd/Ctrl+Alt+Arrow` spawns a connected node
+    from the selected node in that direction. `Editor.spawnConnectedNode` + pure
+    `computeSpawnConnectedNode`.
+
+  Also exposes `worldToLocal` from `@oh-just-another/scene`.
+
+- a9558d9: Reworked flowchart keyboard model. Arrow-key bindings are reworked and disambiguated by modifier: `Arrow` nudges (unchanged); `Cmd/Ctrl+Arrow` grows a flowchart CREATE session (each press adds a pending connected sibling, previewed on the overlay, committed as one undo step when Cmd/Ctrl is released, cancelled on Escape); `Alt+Arrow` navigates to the adjacent node (graph neighbour, else spatially nearest); `Cmd/Ctrl+Shift+Arrow` aligns (moved off the old plain `Alt+Arrow`). The old `Cmd/Ctrl+Alt+Arrow` spawn binding is retired.
+
+  New API: `editor.growFlowchart` / `commitFlowchart` / `cancelFlowchart` / `navigateFlowchart` / `flowchartPreview`, the pure `computeSpawnConnectedNodes`, and `endpointElementId` (scene). `<Diagram>` wires the keyup-commit / Escape-cancel lifecycle for you.
+
+### Patch Changes
+
+- Updated dependencies [783749e]
+- Updated dependencies [c189261]
+- Updated dependencies [c189261]
+- Updated dependencies [c189261]
+- Updated dependencies [641842b]
+- Updated dependencies [c189261]
+- Updated dependencies [c58054b]
+- Updated dependencies [b156869]
+- Updated dependencies [0d3934e]
+- Updated dependencies [1c4941e]
+- Updated dependencies [0d3934e]
+- Updated dependencies [b0a9f3b]
+- Updated dependencies [571f13b]
+- Updated dependencies [ca48e8a]
+- Updated dependencies [1975a9b]
+- Updated dependencies [1975a9b]
+- Updated dependencies [bdc847e]
+- Updated dependencies [511a22a]
+- Updated dependencies [a9558d9]
+- Updated dependencies [22b90f9]
+- Updated dependencies [99b5bee]
+- Updated dependencies [dda2e56]
+- Updated dependencies [34ddb22]
+- Updated dependencies [f381039]
+- Updated dependencies [394d3ce]
+- Updated dependencies [295f38b]
+- Updated dependencies [70a08d8]
+- Updated dependencies [bd2e26c]
+- Updated dependencies [97de2fd]
+- Updated dependencies [407f203]
+- Updated dependencies [744f4b8]
+- Updated dependencies [5d8a282]
+- Updated dependencies [71a6c8b]
+- Updated dependencies [71a6c8b]
+- Updated dependencies [7f69f29]
+- Updated dependencies [672b557]
+- Updated dependencies [dde8279]
+- Updated dependencies [cec8f83]
+- Updated dependencies [1975a9b]
+- Updated dependencies [1975a9b]
+- Updated dependencies [1975a9b]
+- Updated dependencies [1975a9b]
+- Updated dependencies [cf8b735]
+- Updated dependencies [571f13b]
+- Updated dependencies [f8302c3]
+  - @oh-just-another/scene@0.60.0
+  - @oh-just-another/serialization@0.59.0
+  - @oh-just-another/state@0.60.0
+  - @oh-just-another/renderer-core@0.59.0
+  - @oh-just-another/react-ui@0.59.0
+  - @oh-just-another/renderer-canvas@0.60.0
+  - @oh-just-another/renderer-svg@0.57.3
+  - @oh-just-another/raster-wasm@0.57.3
+  - @oh-just-another/templates@0.57.3
+  - @oh-just-another/text-wasm@0.57.3
+
 ## 0.59.0
 
 ### Minor Changes

package/README.md

@@ -1,5 +1,7 @@
 # @oh-just-another/editor
 
+[![npm version](https://img.shields.io/npm/v/@oh-just-another/editor.svg)](https://www.npmjs.com/package/@oh-just-another/editor)
+
 Drop-in diagram editor as a single React component. Auto-detects the best
 renderer (WebGL2 / Canvas2D / OffscreenCanvas), opt-in WASM text-shaping and
 rasterisation, and worker offloading — then exposes one `<Editor>` component
@@ -124,6 +126,36 @@ bundlers that don't (esbuild, Parcel, no bundler), either:
 
 The worker is an optimisation; the editor renders fine without it.
 
+## Custom shapes
+
+`defineShape` registers a custom element type in one call — bounds (spatial
+index / hit-test / culling), rendering (all backends), and optional
+interaction hooks. Serialization is automatic (unknown types pass through).
+
+```ts
+import { defineShape, type ElementBase } from "@oh-just-another/editor";
+
+interface Sticker extends ElementBase {
+  readonly type: "sticker";
+  readonly size: number;
+}
+
+defineShape<Sticker>({
+  type: "sticker",
+  bounds: (s) => ({ x: 0, y: 0, width: s.size, height: s.size }),
+  render: (s, target) => {
+    target.setFill(s.style.fill ?? "#facc15");
+    target.beginPath();
+    target.rect(0, 0, s.size, s.size);
+    target.fill();
+  },
+  // Optional: interactiveHitTest, rotateAnchor.
+});
+```
+
+Returns `{ dispose() }` — currently a no-op (registries are append-only),
+reserved for future deregistration.
+
 ## Plug-in points
 
 These registries are re-exported from this package, so the editor is the single
@@ -133,6 +165,8 @@ import for extending the kernel without forking:
 import { registerBounder, registerElementRenderer } from "@oh-just-another/editor";
 ```
 
+- `defineShape` — one-call custom shape (wraps the two registries below plus
+  `registerInteractiveHitTester` / `registerRotateAnchor`).
 - `registerBounder` (AABB) + `registerElementRenderer` (draw) — custom element types.
 - `registerMigration` — wire-format migrations.
 - `registerLayoutKind` / `registerAnimationAdapter` — or pass via the