quoin-editor 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 Every release of `quoin-editor` is listed here, newest first, in the spirit of [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). From 1.0.0 the package follows [semantic versioning](https://semver.org/): a breaking change waits for the next major version. Until then, Quoin was 0.x and a minor version could contain breaking changes; those known at release were marked "Breaking". The 0.x sections are kept as they were released, "Docs" headings included. Moving from 0.4 to 1.0 is covered step by step in [MIGRATION.md](MIGRATION.md). Review finding ids such as F-17 are those of the 0.4.0 review in [#73](https://github.com/AmineSeboui/quoin-editor/issues/73).
 
+## 1.1.0 (2026-10-29)
+
+### Added
+- A custom block's editor receives `blockId`, `index` (the block's index in the flat `blocks` array, counting from 0 with nested blocks included, kept current as blocks move; only a block whose index changed draws again) and `onRemove`, which removes the block as one undo step and puts the caret where deleting the selected block puts it. A preview receives `onChange` on an editable canvas, written like an editor's: writes to one block that each follow the last within the history's grouping window (500 ms by default) undo together, so it can hold a control such as a checkbox, and a write made while focus is on the block leaves it selected as a whole; a read-only canvas and `QuoinView` pass none. The canvas always passes all of these, and always passes a preview its `blockId`. They are optional in `BlockEditorProps` and `BlockPreviewProps`, so an editor rendered directly with only `data` and `onChange` still compiles.
+- A block definition takes an optional `parse`, which reads a block's stored `data` into the shape its `editor` and `preview` take, to fill required fields and migrate older shapes. The canvas, `QuoinView` and `QuoinDiff` hand its result to `editor` and `preview`; it runs when the block is drawn, once per stored data, and writes nothing, so the stored data changes only when the editor or preview calls `onChange`. A block inserted without `initialData` is seeded with `parse({})`, so `parse` should accept `{}`; when seeding throws, nothing is inserted and the error goes to the canvas's `onError`, or to a warning in development without one. When `parse` throws while drawing, the canvas draws the block's error fallback and reports the error to `onError`, and `QuoinView` and `QuoinDiff` draw the block without its preview and warn once per block type in development. `initialData` stays optional; the custom blocks page recommends `parse` for data with required fields and shows a versioned migration.
+- An image can be marked as deliberately decorative: its data takes `decorative: true` (stored only when true, kept by lossless markdown and `quoin-editor/yjs` like `alt`), and the alt text popover has a "Decorative image" checkbox that stores it and clears the alt text, and hides the hint that calls the alt text required while checked; typing alt text unchecks it. The popover closes, storing nothing, when the alt text or the flag changes under it. An editable canvas draws a "No alt text" badge, which opens the popover, on an image with an empty alt text that is not decorative; a read-only canvas, `QuoinView` and `toHTML` draw none. Output is unchanged: both cases are written with `alt=""`. As `decorative` is now a known key of image data, a value other than `true` is no longer kept, where 1.0 kept it as an extra field. New labels `decorativeImage` and `noAltBadge`.
+- The labels added in this release, `blockError`, `decorativeImage` and `noAltBadge`, are optional in `QuoinLabels` and read as English where missing, so a complete translation typed as `QuoinLabels` still compiles. `englishLabels` is typed `Required<QuoinLabels>`.
+
+### Changed
+- The default `--quoin-warning` and `--quoin-input` reach 3:1 where they did not. Light `--quoin-warning` goes from `oklch(0.65 0.16 65)` to `oklch(0.6 0.16 65)`, the rule of a warning callout against its wash from 2.84:1 to 3.40:1 (dark stays at 7.82:1). `--quoin-input`, the border of the outline button, goes from `oklch(0.922 0 0)` (1.26:1 on the page) to `oklch(0.62 0 0)` (3.64:1) in light, and from `oklch(1 0 0 / 15%)` to the opaque `oklch(0.56 0 0)` (4.25:1 on the page, 3.85:1 on a popover) in dark. A host that sets these tokens keeps its own values.
+- The coverage gate in CI now also covers the canvas and the `useQuoin` and `useLabels` hooks, with line thresholds of 95 percent on `src/view`, 97 on `src/blocks`, 98 on `src/ui`, 98 on `src/context.tsx` (`useQuoin`) and 98 on `src/i18n` (`useLabels`), next to the engine's 90.
+- The build runs each output chunk through Rollup's tree shaking after esbuild, which merges a chunk's imports and drops arguments no caller passes: the main entry goes from 155,039 to 152,741 B gzip and `quoin-editor/headless` from 70,129 to 69,824 B, and the main entry with any feature entry is about 2.2 KB smaller. The `'use client'` directive is on the same files as before, and the engine, view, diff, docx and yjs entries still carry none. The sourcemaps leave out a segment that maps to the same place as the one before it on its line, which keeps the place a greatest lower bound lookup finds, the one browsers and Node's `SourceMap.findEntry` make, and keeps the tarball about 1 MB packed; a least upper bound lookup or a list of every generated position for a source place can differ. The build fails on mappings that hold a character that is not a base64 digit.
+
+### Fixed
+- The attributes an extension's block decoration puts on its block's element are filtered to the names that start with `data-` or `aria-`: a decoration with `style`, `className`, an event handler or `dangerouslySetInnerHTML` no longer reaches the element, and can no longer make React throw.
+- A renderer that throws while drawing its block no longer unmounts the whole canvas: that block draws a fallback named by the new `blockError` label (`Block could not be drawn`) in its own element, the other blocks keep working, the error goes to `onError` when one is given, and React reports it as it does any caught error, and the block is drawn again when its data changes. `EditorView` takes `blockErrorLabel` and `onBlockError` for the same.
+- ArrowUp and ArrowDown pass over a text block whose renderer threw, rather than putting the caret in a block that has no text to hold it.
+
 ## 1.0.2 (2026-10-27)
 
 ### Fixed