@oh-just-another/state 0.60.0 → 0.61.0

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # @oh-just-another/state
 
+## 0.61.0
+
+### Minor Changes
+
+- 0548ab3: Unify the active tool into a single `editor.activeTool` value object (breaking).
+  - `state`: `editor.activeTool: ActiveTool` (`{ type, locked, lastActiveTool }`)
+    replaces `editor.mode` and `editor.toolLocked`; `setActiveTool(type)` replaces
+    `setMode`. `EditorOptions.initialMode` → `initialTool`. The typed `mode` event
+    is now `tool` and fires with the `ActiveTool` object on a type switch or a
+    lock flip. The action category `"mode"` is now `"tool"`. The vestigial
+    `"eyedropper"` mode is removed from `Mode` — colour sampling is armed from
+    the colour picker (`beginEyedropperPick`) and never was a toolbar tool.
+  - `react-ui`: `useMode()` → `useActiveTool(): ActiveTool`;
+    `DiagramRoot`/`DiagramCanvas` prop `initialMode` → `initialTool`.
+  - `editor`: `EditorAPI.getMode/setMode` → `getActiveTool/setActiveTool`;
+    `initialMode` prop → `initialTool`; re-exports `ActiveTool`.
+  - `diagram` (+ vue/svelte/angular wrappers): element methods and controller
+    `getMode/setMode` → `getActiveTool/setActiveTool`.
+
+  Tool ids are unchanged (`"select"`, `"draw-rect"`, …). There are no visible
+  behaviour changes — this is an API refactor establishing one source of truth
+  for "which tool is active".
+
+- 762dd8a: Brush capture pipeline upgrade: input streamlining (low-pass with commit-time catch-up), speed-simulated pressure for mouse/touch (slow = thick, fast = thin) with rate-limited pen pressure, sample decimation with a soft point cap, and end tapering. `BrushElement` gains an optional regeneration payload (`pressures`, `simulatePressure`, `baseWidth`) carried through serialization; `Editor.beginBrushStroke` accepts a `pointerType` argument to pick the pressure source. The live preview runs the same pipeline as the commit.
+- 4722388: Editable width for committed brush strokes. `style.strokeWidth` never
+  affected brushes (their widths are baked per point), so the property panel's
+  Thin/Medium/Thick control silently did nothing for them. A brush-only
+  selection now gets a popover range slider driving the new
+  `Editor.setBrushWidth(ids, width)`, which scales every baked point width by
+  `newWidth / baseWidth` — the stroke keeps its exact pressure profile at the
+  new thickness — and records the new `baseWidth`. Legacy strokes without a
+  recorded base fall back to their widest point. One undo step.
+- 05707ed: Drag the caption pill along its link. With the link selected, dragging the
+  pill slides the label along the drawn path (the cursor is projected back onto
+  the polyline — new `projectPointToPathT` in scene); within a few pixels of
+  the arc-length middle it snaps back to the default placement
+  (`label.position` removed, so elbow links regain longest-segment
+  auto-placement). One undo step, Escape reverts, double-click still opens the
+  inline text editor, and handle dots keep pointer priority over the pill.
+  Tunable snap radius: `LINK_LABEL_DRAG_SNAP_PX`.
+- 84450bc: Link captions: measured rounded pill, multiline, correct placement and hit-testing.
+  - `scene`: new shared label geometry (`linkLabelAnchor`, `estimateLinkLabelBox`,
+    `linkLabelBounds`, `pointAlongPath`) — one source of truth for the renderer,
+    hit-testing and culling. `findLinkAt` now also hits inside the caption pill.
+    Elbow links place an unpositioned label on the longest segment's midpoint;
+    explicit `label.position` is clamped away from the arrowheads. Tunables in
+    `constants.ts` (`LINK_LABEL_MAX_WIDTH`, paddings, clearance).
+  - `renderer-core`: the caption is a rounded pill sized by real `measureText`
+    word-wrap (multiline, `\n` breaks) instead of a square estimated box; it
+    rides the drawn geometry (flattened curve for bezier, not the chord), and
+    `computeLinkWorldBounds` unions the pill so dirty-rect / viewport culling
+    never clip it. `LABEL_POSITION` / `LABEL_FONT_SIZE` constants moved to
+    `scene` as `LINK_LABEL_DEFAULT_POSITION` / `LINK_LABEL_DEFAULT_FONT_SIZE`.
+  - `state`: `linkLabelWorld` uses the shared anchor, so the inline editor opens
+    exactly over the pill (including bezier and elbow links).
+  - `react-ui`: the inline caption editor is a multiline textarea — Enter
+    commits, Shift+Enter inserts a newline, Escape cancels.
+
+### Patch Changes
+
+- 50a2bd4: Fix: with a creation tool active (draw-edge, draw-rect, …) a press on a
+  selected shape's edge no longer grabs the shape's resize/rotate handle — it
+  starts the new link / element as expected. Selection chrome (resize, rotate,
+  group and selected-link endpoint handles) is now pressable only under the
+  select tool, and the overlay stops drawing the handles while a creation tool
+  is active (outlines stay; the hand tool keeps the chrome visible).
+- 20af638: Fix: the caption pill no longer fights the bend/segment handles. The
+  "add waypoint" and elbow segment handles slide out from under the label pill
+  along their own span (`getLinkWaypointMidpoints` is label-aware; new shared
+  `getElbowSegmentHandles` keeps the drawn dot and the grab point identical), so
+  a click on the pill selects the link and a double-click opens the inline
+  caption editor. Visible handle dots keep pointer priority — an existing
+  waypoint dot sitting inside the pill is still grabbable (dots draw above the
+  pill).
+- 3c50ef1: Tile cache honours per-element hide (B12, hide half). `renderViaTiles` accepts
+  `hideElements`: tiles bake with the set applied, and an element entering or
+  leaving the set invalidates only the tiles it touches — so the stroke-eraser
+  preview and per-element visibility no longer drop very large scenes off the
+  tile-cache path into a full re-render every frame. Group-isolation dim still
+  takes the full path (dimming almost everything would re-rasterise most tiles
+  anyway).
+- f960332: Fix: mp4 shapes survive a page reload. The video file-drop handler never
+  persisted the bytes into `Scene.files`, so a restored scene had only a dead
+  `blob:` URL and nothing to rehydrate from (the "dead-blob-url" renderer
+  warning) on every backend. The handler now stores the file (`fileId` on the
+  shape), and scene rehydration grew a video branch: it rebuilds the hidden,
+  muted, looping `<video>` element from the persisted bytes (shared
+  `createHiddenLoopingVideo` factory with the drop handler) and resumes
+  playback best-effort. Videos dropped BEFORE this fix have no stored bytes and
+  still won't restore — re-add them once.
+- Updated dependencies [762dd8a]
+- Updated dependencies [05707ed]
+- Updated dependencies [20af638]
+- Updated dependencies [84450bc]
+  - @oh-just-another/scene@0.61.0
+  - @oh-just-another/renderer-core@0.60.0
+  - @oh-just-another/history@0.57.4
+
 ## 0.60.0
 
 ### Minor Changes

package/README.md

@@ -23,11 +23,11 @@ const editor = new Editor({
   mainTarget: layered.get("main"),
   overlayTarget: layered.get("overlay"),
   initialScene: emptyScene(),
-  initialMode: "select",
+  initialTool: "select",
 });
 
 editor.subscribe(() => render());
-editor.setMode("draw-rect");
+editor.setActiveTool("draw-rect");
 ```
 
 ## Concepts
@@ -36,7 +36,7 @@ editor.setMode("draw-rect");
 
 The centerpiece controller (`Editor`, `EditorOptions`, `LoadSceneOptions`). It owns the scene, selection, and viewport, and exposes a high-level API spanning:
 
-- **Tools / modes** — `mode`, `setMode`, `toolLocked` / `setToolLocked` (sticky tool).
+- **Tools** — `activeTool` (`{ type, locked, lastActiveTool }`, the single source of truth), `setActiveTool`, `setToolLocked` (sticky tool).
 - **Selection** — `selection`, `selectAll`, `deleteSelected`, `moveSelectionBy`, `focusCycle`, plus link selection (`selectedLinks`, `selectedLink`).
 - **History** — `undo`, `redo`, `canUndo`, `canRedo`, `history` (backed by `@oh-just-another/history`).
 - **Hit-testing** — `hitTest(worldPoint)` returns a `PressTarget`; `hitAnnotation`.
@@ -48,7 +48,7 @@ The centerpiece controller (`Editor`, `EditorOptions`, `LoadSceneOptions`). It o
 - **Text editing** — inline caret/selection model: `beginTextEdit`, `commitTextEdit`, `cancelTextEdit`, `setEditingText`, `setTextCaretFromPoint`, `extendTextSelectionToPoint`, `caretIndexAtWorldPoint`, `editingTextOverlay`, plus `createTextAt`.
 - **Image / file insert** — `insertImage`, `addElement`, `beginPlacement`, and a `FileDropRegistry` (see below).
 - **GIF / animation playback** — `togglePlayback`, `hoverAnimatedElement`, `isPlaybackPaused`.
-- **Brush strokes** — `beginBrushStroke`, `extendBrushStroke`, `commitBrushStroke`, `cancelBrushStroke`, `pendingBrushStroke`.
+- **Brush strokes** — `beginBrushStroke` (a `pointerType` argument picks the pressure source: real pen pressure, or speed-simulated for mouse/touch), `extendBrushStroke`, `commitBrushStroke`, `cancelBrushStroke`, `pendingBrushStroke`. Capture streamlines input, decimates samples, and tapers stroke ends on commit; the live preview matches the committed result.
 - **Annotations / comments** — `addAnnotation`, `removeAnnotation`, `toggleAnnotationResolved`, `addComment`, `removeComment`, `setSelectedAnnotation`, `setCommentAuthor`.
 - **Scene lifecycle** — `scene`, `loadScene`.