@oh-just-another/state 0.61.0 → 0.63.0

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @oh-just-another/state
 
+## 0.63.0
+
+### Minor Changes
+
+- f12caa8: "Back to content" jumps to the element nearest the camera instead of fitting the whole scene: new `Editor.revealNearestContent(padding = 80)` (pure `computeRevealNearest` / `nearestElementBounds` in `zoom-pan`) centres that element at the current zoom, zooming out only when it does not fit — a lone small shape is no longer blown up to full screen and a large board is no longer shrunk to a speck. `ResetToContentButton` calls it.
+- 76463dd: Sticky reaction pills and the "+" add-reaction button are now painted by the canvas renderer (single visual source that tracks the shape 1:1 while dragging; pills also reach PNG / SVG exports); the DOM overlay only lays transparent click zones over the same rects (`stickyReactionLayout`) and hosts the emoji picker. Pills keep a constant on-screen size across zoom (low-zoom clamp `STICKY_REACTION_MIN_ZOOM`) and wrap onto new rows inline-block style instead of being dropped. The "+" button is hover-only chrome: shown for the sticky under the idle cursor (`Editor.hoveredStickyId` → `RenderSceneOptions.hoveredElement`), excluded from exports and read-only views. Static exports gained content switches (`RenderSceneOptions.content`, defaults in `EXPORT_CONTENT_DEFAULTS`) toggling sticky reactions / tags / author, wired to "Include in export" checkboxes in the Export… menu and to `downloadPng` / `downloadSvg` / `exportSceneToPng`.
+- e202058: Drop any importable diagram file onto the canvas. `@oh-just-another/importers` now owns the formats table (`DIAGRAM_FORMATS`, `IMPORT_FORMATS`, `EXPORT_FORMATS`, `importSceneFrom`, `exportSceneAs`, `importFormatForFile`) and ships `diagramFileDropHandler` — native JSON, Excalidraw, Mermaid, JSON Canvas, Graphviz DOT and draw.io files are parsed and inserted at the drop point; the `Editor` component registers it by default (listed as "Diagrams" in the drop overlay). New `Editor.insertScene(fragment, worldPoint)` merges a scene fragment — elements, links and binary files, ids remapped, one undo step — into the current scene without replacing it.
+- e66a8a5: Canvas-menu backing APIs. `Editor.preferences` / `setPreferences` (`snapObjects`, `showObjectSize`, `suggestObjectSize`, `wheelMode`) seeded via `EditorOptions.preferences`; `wheelMode` (`auto` / `mouse` / `trackpad`) routes plain wheel events to zoom or pan. `Editor.unlockAll()`, `Editor.createStickyAt(point)`. Saved start view: `Viewport.startView` (exported with the scene, applied when a document loads), `Editor.setCurrentViewAsStart()` / `goToStartView()` / `clearStartView()` / `startView`.
+- 10eac46: Drop overlay: while an OS file is dragged over the canvas the editor shows a dashed frame, a drop glyph with "DROP" and a chip per accepted file kind. `FileDropHandler` gains presentation metadata — `label`, `kind` (`image` · `video` · `scene` · `text` · `data` · `file`) and `formats` — the built-in image and video handlers ship theirs; `Editor.getFileDropHandlers()` lists the registry. New `FileDropOverlay` component and `usePalettePlacement({ onFileDrag })` for hosts composing their own canvas.
+- a6fe14d: Frame size presets. The frame toolbar gained a size-preset dropdown (A4, Letter, 16:9, 4:3, 1:1, Phone, Tablet, Browser — `FRAME_SIZE_PRESETS`, applied via the new `Editor.applyFramePreset`).
+- e2ff8df: Image file tools. The image toolbar (single selection) gained a file-name input (renames the backing `BinaryFile`, undoable), Replace image (swaps the bytes while keeping position / size / crop), Download (original bytes with stored name / mime) and an Alt-text editor backed by the new `ImageElement.alt` field (serialized; surfaced to hosts for accessibility). New editor APIs: `renameBinaryFile`, `setImageAlt`, `replaceImageFile`.
+- 5f08d13: Image shape masks: `ImageElement.mask` clips the drawn box to an ellipse, rounded rect (normalised `radius`) or arbitrary normalised polygon (presets in `IMAGE_MASK_POLYGON_PRESETS`), applied after `crop` and reaching every backend and PNG / SVG exports through the new `RenderTarget.clip`. `Editor.setImageMask(ids, mask | null)` sets/clears it (undoable); the image toolbar gained a mask picker next to Crop: aspect presets (Custom / Original / Circle / Square / Portrait / Landscape / Wide via `Editor.setImageAspectPreset` — centre-crop to the ratio, box refit, Circle adds an ellipse mask) plus shape tiles with a corner-radius slider.
+- 350c6d3: Locked elements are now click-through: the pointer hit-test skips locked (and hidden) shapes and picks whatever lies beneath, instead of letting them shadow the shapes below. Locking a selection drops it. Unlocking moved to the right-click context menu ("Unlock", backed by the new `Editor.lockedElementAt` / `Editor.unlockElement`), and the selection toolbar gained a Lock button plus a "Lock" context-menu entry. `getElementAt` / `getElementAtIndexed` accept an optional `accept` predicate that skips rejected shapes and keeps scanning beneath them.
+- 518a6d1: Object snapping and size assists. Move / resize gestures snap to the edges and centres of nearby shapes (alignment guides on the overlay, `snapObjects` preference), resizing can snap to a nearby shape's width / height with that shape highlighted (`suggestObjectSize`), and a `W × H` readout shows under the shape being resized (`showObjectSize`). `Editor.snapGuides` / `sizeReadout` / `sizeMatch` expose the per-tick state; `snapMoveDeltaToObjects` / `snapResizeDeltaToObjects` are the pure helpers. Guides use the reference look: a dashed alignment line overshooting both shapes, plus ticked distance segments (labelled when `showObjectSize` is on) for the gap between the shapes and for a matched width / height. `buildRoundedRectPath` is exported from `@oh-just-another/renderer-core`. Participation follows the reference: brush strokes never snap (as targets or movers), targets must sit on the 90° grid and be at least `OBJECT_SNAP_MIN_SIZE_PX` on screen, moves pair edge-to-edge / centre-to-centre only, and a multi-selection snaps by its frame edges.
+- b1e08de: "Replace image" is now "Replace media": `Editor.replaceImageFile` accepts GIFs and videos in addition to static images. The shape keeps its position and width (height refits to the new aspect — videos measure via a hidden looping `<video>`, same as the drop handler); animation fields (`animationKind` / `animationData` / `metadata.animated`) are rewritten to match the new media kind, and the crop resets when the media kind changes. The toolbar control's file picker accepts `image/*,video/*`.
+- e6057d1: Double-clicking the rotate grip resets the selection's rotation to 0 (each element about its own centre, one undo step). New `Editor.resetSelectionRotation()`.
+- 2cd199e: Level of detail is decided per element from its size on screen, not from the zoom level. `LodOptions` is now `{ placeholderMaxScreenPx, minTextScreenPx }` (the zoom thresholds `placeholder` / `hideText` are gone): a shape whose longer side is below `placeholderMaxScreenPx` (default 8 px) on screen becomes a flat AABB fill; text — standalone and embedded shape labels, on the resolved font size — below `minTextScreenPx` (default 6 px) is skipped. A huge shape or a giant heading therefore stays fully drawn at 1 % while small ones degrade first. Helpers `screenSizeOf` / `isTextBelowLod` and the `LOD_*_SCREEN_PX` constants are exported. `MIN_ZOOM` drops from 5 % to 1 %.
+- 745d7a9: Embedded shape labels and grouped style controls. Rectangles, ellipses, polygons and block arrows can now carry text inside their body (`ElementBase.label` — full text stack: wrapping, styled runs, lists, highlight; centered by default with `textAlign` / `textBaseline` overrides). Double-click opens the same inline editor text elements use (typing, caret, selection, Tab-nesting all work; an emptied label is stripped on commit). Labels render on every backend and serialize. The wire schema also gained the element-level `locked` / `hidden` flags that previously failed strict validation. The shape toolbar now groups border editing (color / width / dash / corners) and fill (color / opacity) into two popovers.
+- 67b98bb: "Shapes and lines" toolbar button (reference behaviour): replaces the separate rectangle / ellipse / connector buttons with one trigger opening a flyout beside the toolbar — Line / Arrow / Elbow arrow (connector presets: routing + arrowhead, applied to new links AND the live preview via `Editor.armLineTool`), Rectangle / Oval / Rhombus / Triangle (`Editor.armShapeTool` — diamond and triangle draw as inscribed polygons through the same rubber-band gesture), and "More shapes" opening the template library (the standalone library toggle is gone from the dock — "More shapes" is now its only toolbar entry point; `hideLibraryButton` removes that row). Hotkeys R / O / L keep arming the stock tools; any tool switch resets the armed variant.
+- 586b7ed: Sticky auto-fit text. New stickies start in Auto mode (`ShapeLabel.autoFit`): the rendered font size is derived — binary search over the shared text layout, memoized — so the text fills the card and scales with it. Picking an explicit size in the toolbar leaves Auto (reference behaviour); the "Auto" button in the font-size popover returns to it (`Editor.setLabelAutoFit`). The sticky toolbar branch also gained the label text controls (font family, size, style, alignment).
+- d4c2c2f: Sticky notes and emoji elements. New plugin-style scene types: `sticky` (rounded card, background from `style.fill`, text via the shared embedded label with double-click editing, optional author-name strip) and `emoji` (single glyph at a given size). Both render on every backend, serialize through the custom-element schema, and are created from the shape library ("Sticky note" now produces a real sticky; new "Emoji" entry). The selection toolbar gained dedicated branches: sticky — S/M/L size presets, background color/opacity, Show-author toggle; emoji — a glyph picker. New editor APIs: `setStickySize`, `toggleStickyAuthor`, `setEmojiGlyph`.
+- 24c33b3: Switch type now covers the full matrix: shape kinds (rectangle / ellipse / diamond) ↔ text ↔ sticky, any to any, bulk on multi-selection. The user text transplants between carriers (`TextElement.text` ↔ embedded `label`); converting INTO a sticky snaps the fill to the nearest colour of the new `STICKY_PALETTE` (a text's font colour never becomes the card colour); converting FROM a sticky drops its reactions / tags / author. The toolbar's type control gained Text and Sticky targets and now also appears for text and sticky selections.
+- ef7388f: Text lists. Text elements gained per-paragraph attributes (`paragraphs`: bulleted / numbered kind + nesting level) that survive serialization. The layout engine indents list paragraphs, shrinks their wrap budget and keeps caret / click / selection geometry in lockstep; renderers draw derived markers ("•", auto-numbering per nesting level) on every backend. New editor APIs `setParagraphList` / `indentParagraphs` target the inline-edit selection's paragraphs while editing (whole element otherwise); typing keeps attributes aligned (Enter continues a list, deleting a line drops its attrs); Tab / Shift+Tab change nesting during editing. The text toolbar gained a two-row List dropdown (bulleted / ordered + indent ±).
+- d8bf8c1: Zoom menu: clicking the zoom percentage in the bottom bar opens a view menu — Enter / Exit full screen, Hide / Show minimap (`M`), Grid › (None / Dot grid / Line grid), an Object dimensions switch, Fit to screen and zoom presets (50 % … 2000 %). `Editor.setZoom(level)` sets an absolute zoom about the viewport centre. react-ui adds the `Switch` primitive, the `useFullscreen` hook, and `MainMenu` options `ariaLabel` / `placement` / `triggerClassName` / `triggerStyle` plus `MainMenu.Item` `trailing`. The `minimap` prop now seeds the runtime-toggleable minimap.
+
+### Patch Changes
+
+- 98070d8: Multi-element commands treat a selected group as one unit: Arrange as grid, Stack, Align, Distribute, Flip and Rotate move / mirror / turn a group's whole subtree together (its footprint is the union of its members) instead of scattering the children or ignoring them. New `ARRANGE_LAYOUT_GAP` constant.
+- 2942fb9: Clicking a link-start dot now spawns a clone with only the source's base look (kind, size, style): the embedded label and sticky reactions / tags / author no longer carry over into the new shape (the hover ghost matches).
+- d0eb799: A right-click / touch long-press now routes the selection before `onLongPress` listeners fire: on empty canvas it clears the selection (the menu is the canvas menu), on an unselected element or link it selects that one, and on a selected element it keeps the current selection.
+- e0e4ea9: Stop rendering after dispose. Async completions (image decode, font load) resolving after a runtime backend switch could schedule a frame onto disposed targets; on WebGL2 the lazy pipeline rebuild then recompiled shaders on the lost context and threw "Ellipse shader compile failed: null" from a promise chain. `Editor` no longer schedules renders once disposed, and `WebGL2Target` draw calls become no-ops after `dispose()`.
+
+  Also make the "skipped a non-drawable image source" warning signal-only: the image element renderer now silently skips shapes whose handle is dead but rehydratable (`fileId` present — the transient first paint after a scene restore), and rehydration itself reports missing `Scene.files` bytes or decode failures. The renderer warning now fires only when an image really will stay blank.
+
+- d658680: Selected shapes no longer get a translucent contour halo under the body — the selection frame + handles are the only selection chrome. `paintElementSelectionHalo` / `ElementHalo` are removed (links keep their halo).
+- 3e5d81f: Floating chrome appears in place, instantly: `floatPanel` keeps a panel invisible until its first position resolves (menus, submenus, popovers no longer paint at the corner and jump), and the selection toolbar reveals with `visibility` instead of a fade. A library drag-to-place is now an element gesture — `Editor.placementId` is set from `beginPlacement` until commit / cancel — so the selection toolbar stays hidden and the minimap defers its repaint while the shape is being dragged in.
+- 06a0625: Recover media dropped with a generic MIME. A file handed over with an empty `File.type` (some drag sources / extension-less downloads) was stored as `application/octet-stream`, and rehydration — which routes image-vs-video decoding by mime — sent it to the wrong decoder, so the shape reloaded blank. Persistence now infers the mime from the filename extension (`inferFileMime`), and rehydration falls back to magic-byte sniffing (`sniffBinaryFileMime` in scene: mp4/webm/ogg/png/jpeg/gif/webp/svg) for already-stored generic entries.
+- 09bc11a: Resize handles are now centred exactly on the selection frame's corners and edge midpoints (`HANDLE_OUTSET` defaults to 0). Group resize / rotate chrome is no longer hit-testable or drawn when nothing in the selection is manipulable (e.g. a locked group).
+- 3019bc7: Inline label editing behaves like a proper text box. The label's visible line window now scrolls to follow the caret (transient `metadata.labelScrollLines`, stripped on commit/cancel and on save), so arrowing to the end of a long label keeps the edited line on screen; selection highlight and the caret are clipped to the shape body. Double-click places a collapsed caret without arming a drag-select (no more accidental part-selection). Emoji now survive the WebGL2 backend: strings containing pictographs take the rasterised-bitmap text path instead of the monochrome MSDF atlas that cannot shape them.
+- 2e2a9e7: Second review pass on shape labels and stickies. Label text is now strictly contained: when not even one line fits the padded body nothing paints outside the shape (no more tile artifacts after growing the font). Double-click places the caret at the click point instead of jumping to the (possibly clipped) text end. Cmd/Ctrl+A inside the inline editor is handled explicitly, removing a race with the selection mirror that made select-all intermittently need a second press. Labels are real rich text: styling with an active selection applies to just that range (styled runs) rather than the whole label. Stickies lost the folded corner (plain sheet with the bottom drop shadow), and emoji reactions became per-user toggles — your own click adds and then removes YOUR reaction (`toggleStickyReaction`, `reactions[].users`), so counters only grow through other collaborators.
+- f46e3da: Rubber-band (lasso) selection picks whole groups: a grouped child inside the marquee selects its group root (respecting an entered group), like a click does — so Arrange / Align / Distribute and friends never scatter a group's children.
+- 58c944b: The minimap's viewport frame follows a drag-pan: `Editor.endPanGesture` now notifies subscribers, so idle-gated observers that skip every notify while `panGesture` is set get the trailing change and repaint once the gesture ends.
+- 7d15a0c: The Shapes and lines flyout marks the armed tool: the row matching the current shape kind or line preset is `menuitemradio` + `aria-checked` with the tonal selected style (stock `draw-edge` reads as Elbow arrow). `armShapeTool` / `armLineTool` notify subscribers once more after the variant is set, so listeners never observe the reset value.
+- 59695d7: Snap the live draw preview to the grid. The rubber-band shown while drawing a rect / ellipse / frame followed the raw cursor and only the final shape snapped on release, so drawing looked like grid snapping was off. The preview now goes through the same snap helper as the final CREATE, matching how move / resize snap live during the gesture.
+
+  Also restore the live preview for the frame tool: `isDrawingPhase` didn't include `draw-frame`, so no rubber-band appeared while drawing a frame. The frame preview renders as the real frame element (auto-numbered name included), WYSIWYG like rect / ellipse.
+
+- 8f8846b: The selection toolbar shows the text controls for every shape type that can carry text (rectangle, ellipse, polygon, block arrow, sticky) even before it has any — they display the defaults the first text will take. `updateLabelStyle` / `updateLabelProps` / `setLabelAutoFit` seed the label on a labelable shape that has none (create-on-write); the inline editor and the style APIs share one `seedLabel`.
+- 22c0f48: Caret and selection highlight now rotate with a rotated text element (or label) while editing, and canvas clicks map to the right glyph through the element rotation. `editingTextOverlay()` exposes the new `EditingTextOverlay` type with `rotation` + `pivot`.
+- e15fa56: Empty text elements show a grey placeholder prompt while being written ("Type something", "Place for text", …): `TEXT_PLACEHOLDERS` (weighted list, a few jokes at low odds) and `pickTextPlaceholder(id)` (deterministic per element id, so the prompt never changes under the caret) live in `@oh-just-another/scene`; the text bounder sizes an empty element by its prompt, so the selection box wraps it and the dirty rect covers it. `TEXT_PLACEHOLDER_COLOR` is exported from renderer-core. Drawn only when `RenderSceneOptions.textPlaceholders` / `ElementRenderContext.textPlaceholders` is set — the editor sets it outside view mode; exports and headless rendering keep empty text blank.
+- 22ecd4b: Switching to a drawing, ink, eraser or laser tool clears the selection (so the selection toolbar goes away with it); `select`, `hand` and `crop` keep it. Leaving crop for another tool abandons the pending crop box.
+- 8163681: First review pass on the toolbar redesign. Locked elements are no longer captured by marquee selection. Embedded shape labels clip to the shape's padded body (extra lines aren't painted), the inline-edit caret sits exactly on its line, and shapes with a label show the full set of text controls (font, size, style, alignment, color, highlight) writing through the new `updateLabelStyle` / `updateLabelProps`. Replacing an image refits the shape's height to the new file's aspect ratio, image resize never mirrors on overshoot, and the crop button matches the toolbar style. Sticky notes look like paper (drop shadow, folded corner), support tags (toolbar editor + on-card pills) and emoji reactions with counters via a bottom-left reaction bar (`StickyReactions` overlay, `setStickyTags` / `addStickyReaction`). The hide-frame feature was removed.
+- Updated dependencies [76463dd]
+- Updated dependencies [e0e4ea9]
+- Updated dependencies [e66a8a5]
+- Updated dependencies [06a0625]
+- Updated dependencies [e2ff8df]
+- Updated dependencies [5f08d13]
+- Updated dependencies [3019bc7]
+- Updated dependencies [2e2a9e7]
+- Updated dependencies [350c6d3]
+- Updated dependencies [518a6d1]
+- Updated dependencies [3f45f83]
+- Updated dependencies [3543dc7]
+- Updated dependencies [2cd199e]
+- Updated dependencies [745d7a9]
+- Updated dependencies [586b7ed]
+- Updated dependencies [d4c2c2f]
+- Updated dependencies [993b46a]
+- Updated dependencies [ef7388f]
+- Updated dependencies [e15fa56]
+- Updated dependencies [8163681]
+  - @oh-just-another/renderer-core@0.61.0
+  - @oh-just-another/scene@0.62.0
+  - @oh-just-another/tokens@0.58.1
+  - @oh-just-another/history@0.57.5
+
+## 0.62.0
+
+### Minor Changes
+
+- ac128db: Dark theme now restyles the chrome only — the canvas always stays light. Scene colors are raw hex authored against light paper, so a dark canvas silently broke user content; `UI_SURFACE.dark.canvas` and `--du-canvas-bg` are light in every theme, and the bundled color picker always offers the light element palette. Canvas-drawn chrome (selection, handles, anchors, marquee, badges, minimap frame) is unified on the iris accent (`CANVAS_CHROME_ACCENT`, iris9 — the same accent the DOM chrome uses) instead of the ad-hoc `#1a73e8`/`#2563eb` blues. Undeclared CSS variables and stale accent fallbacks in the stylesheet now resolve to the real theme tokens, so the affected popovers follow the active theme.
+
+### Patch Changes
+
+- Updated dependencies [ac128db]
+  - @oh-just-another/tokens@0.58.0
+  - @oh-just-another/renderer-core@0.60.1
+
 ## 0.61.0
 
 ### Minor Changes