@vanduo-oss/vd3-cbun 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -4,6 +4,127 @@ All notable changes to `@vanduo-oss/vd3-cbun` are documented here. This file
 tracks the PACKAGE only — never docs-site content. Per-component VERSION
 constants are listed alongside each bundle release.
 
+## 1.4.2 — 2026-09-13
+
+Patch release: resolves all 14 Kilo review findings on PR #13 plus two adjacent
+gesture-cancel bugs. The reviewed fixes include additive charts core `role` /
+Vue `svgRole` options and four strengthened tests. Additive and
+backward-compatible; **no
+per-component VERSION constant changes** (no serialization change, no new
+load-bearing default).
+
+### Fixed
+
+- **draw** — the rendered DOM paint order now always matches document order.
+  Reorders (`bringToFront` / `sendToBack` / `bringForward` / `sendBackward`),
+  undo/redo, and `load()` previously updated the model but could leave the SVG
+  element order stale, so the visually topmost shape could disagree with
+  `toJSON().shapes`. Paint order is normalized inside the incremental render pass.
+  A second pointer contacting the canvas now cancels the active gesture
+  coherently: an in-progress erase keeps the model intact and restores the shapes
+  it had hidden, an in-progress move/resize restores the pre-drag geometry in the
+  model and DOM, and an in-progress pan clears `.vd-draw-panning` (also cleared
+  when a pinch ends). `setReadonly(false)` rebuilds the toolbar/style panel only
+  when it was never built and now syncs their state. The select-mode move cursor
+  rule targets the real `.vd-draw-shapes` layer instead of the non-existent
+  `.vd-draw-shape-layer`. `VD_DRAW_VERSION` stays `1.1.0`.
+
+- **charts** — a visible data table no longer feeds back into responsive sizing.
+  The measured height and the `ResizeObserver` comparison now exclude the table's
+  layout contribution (hidden `.vd-chart-sr-only` tables contribute zero), so
+  growing the table no longer triggers a resize re-render loop, while genuine
+  container changes still resize. Multi-series line/area data tables now match
+  each row's x value by the same normalized key as the x scale (timestamp /
+  number / string) instead of strict reference equality, so per-series `Date` or
+  object x values no longer produce blank cells. Adds an additive core `role`
+  option and Vue `svgRole` prop (`string`, overrides the default
+  `graphics-document document`); the distinct Vue name preserves standard root
+  `role` attribute fallthrough. `dataTable`, `ariaRoleDescription`, and
+  `svgRole` react after mount. `VD_CHARTS_VERSION` stays `1.1.0`.
+
+- **hex-grid** — fast blit frames now report `total`, `visible`, and `drawn: 0`
+  in `getRenderStats()` instead of leaving the previous sharp frame's counts, so
+  stats stay consistent with the transform in effect during a gesture.
+  `VD_HEX_VERSION` stays `1.1.0`.
+
+- **tests** — the z-order test now asserts DOM order (and covers reorder,
+  undo/redo, send-to-back/forward/backward); the `canUndo` test builds real
+  history before disabling it; `autoClose: false` asserts the textarea is
+  unchanged with an `autoClose: true` pair-insert control; the pressure-default
+  smoothing test blends both missing directions at factor 0.5; the DPR test
+  rejects any transform carrying the device ratio; the fast-frame test pins
+  `visible` / `drawn`. New coverage: gesture cancellation, per-series `Date` data
+  tables, responsive table-growth, and Vue reactivity for `svgRole` /
+  `ariaRoleDescription` / `dataTable`.
+
+Component versions in this release: **charts 1.1.0, code-editor 1.1.0, draw
+1.1.0, flowchart 1.2.0, hex-grid 1.1.0, music-player 1.0.1**.
+
+## 1.4.1 — 2026-09-12
+
+Patch release: hex-grid adaptive rendering, draw vector polish, charts
+accessibility, and a code-editor wrap-mode caret fix. Additive and
+backward-compatible; only `VD_HEX_VERSION` takes a minor (`1.0.1 → 1.1.0`).
+`VD_CHARTS_VERSION`, `VD_CODE_EDITOR_VERSION`, and `VD_DRAW_VERSION` stay
+`1.1.0` (no serialization change).
+
+### Changed
+
+- **hex-grid** — adaptive, DPR-aware, culled rendering. New `pixelRatio`
+  (`number | 'auto'`, default `'auto'` = `min(devicePixelRatio, 2)`) sizes the
+  canvas backing store to `CSS size × ratio` with a seeded
+  `setTransform(ratio, …)` so world/CSS coordinates and hit-testing are
+  unchanged (`pixelRatio: 1` restores the old buffer). New `cull` (default
+  `true`) draws only cells intersecting the viewport via a spatial bucket index
+  rebuilt on grid regeneration; with culling on, `setCustomRender` now fires
+  only for visible cells (`cull: false` restores whole-grid iteration). Pan and
+  zoom rAF-coalesce to one frame; above 8000 visible cells a gesture blits the
+  last sharp frame and a sharp culled re-render follows when idle (~120 ms) or
+  on pointer up. Adds `getVisibleHexes()`, `getRenderStats()`,
+  `setPixelRatio()`, `setCull()`; `destroy()` now also cancels pending
+  rAF/timeouts and releases the frame canvas. Vue wrapper gains `pixelRatio` /
+  `cull` props. Takes `VD_HEX_VERSION` `1.0.1 → 1.1.0`.
+
+- **draw** — vector polish without a schema bump. Freehand input is EMA-smoothed
+  (`smoothPoint`) and progressively simplified (Ramer–Douglas–Peucker) so
+  strokes stay smooth without point bloat. SVG nodes are cached and dirtied
+  per-shape; renders rAF-batch. Two-finger pinch-to-zoom (midpoint-anchored)
+  and two-finger pan land for touch. Text wraps to the shape width via SVG
+  `<tspan>`s and is inline-editable on double-click in select mode; arrow
+  marker heads follow the stroke color (sanitized `<defs>` ids, including
+  `toSVG()`). Tool-aware canvas cursors, panning grab state, and compass
+  resize handles. O(1) `_shapesById` lookup. Vue option props (`readonly`,
+  `snap`, `history`, `historyLimit`) update through surgical setters
+  (`setReadonly`, `setSnap`, `setHistoryEnabled`, `setHistoryLimit`) instead
+  of destroying the editor. `fitView(padding?)` takes an optional padding
+  (default `40`). `VD_DRAW_VERSION` stays `1.1.0`.
+
+- **charts** — WAI-ARIA Graphics Module 1.0 on the SVG shell
+  (`role="graphics-document document"`, `graphics-object` / `graphics-symbol`
+  on marks, contextual `aria-roledescription`). Arrow-key navigation moves
+  focus between interactive marks with a roving tooltip. An accessible HTML
+  data table ships by default as `sr-only` (WCAG 1.1.1 / G73–G74);
+  `dataTable: false` suppresses it and `dataTable: 'visible'` shows it.
+  `ariaRoleDescription` overrides the SVG role description (default
+  `` `${kind} chart` ``). Dark-mode and `:focus-visible` chrome. Vue wrapper
+  forwards `dataTable` and `ariaRoleDescription`. `VD_CHARTS_VERSION` stays
+  `1.1.0`.
+
+- **code-editor** — wrap mode reserves a shared `scrollbar-gutter: stable` on
+  both the textarea and the highlight `<pre>` so a visible scrollbar no longer
+  shrinks only the editable layer and misaligns the caret on wrapped lines.
+  OpenSpec synced; standalone core / editing / tokenizer / Vue / Playwright
+  suites added. `VD_CODE_EDITOR_VERSION` stays `1.1.0`.
+
+- OpenSpec: archived `sync-shipped-cbun-specs`, `hex-grid-render-perf`, and
+  `draw-vector-polish-perf` — Catmull-Rom `line.smooth`, `VdDraw` template-ref
+  CRUD, flowchart `--vd-bg-*` chrome, corrected CI `test:types`-after-build
+  order, and real Purpose lines on all seven capabilities. No additional
+  component API or serialization change beyond the bullets above.
+
+Component versions in this release: **charts 1.1.0, code-editor 1.1.0, draw
+1.1.0, flowchart 1.2.0, hex-grid 1.1.0, music-player 1.0.1**.
+
 ## 1.4.0 — 2026-08-16
 
 **code-editor** — snippet-safe first-party highlighter so docs snippets can drop

package/README.md

@@ -8,12 +8,16 @@ tree-shakeable subpath exports. It replaces the four per-repo publishes
 (`@vanduo-oss/charts`, `@vanduo-oss/flowchart`, `@vanduo-oss/hex-grid`,
 `@vanduo-oss/music-player`) of the old line.
 
-**Status: 1.4.0.** Six Vue3-only component families — charts, code-editor, draw,
+**Status: 1.4.2.** Six Vue3-only component families — charts, code-editor, draw,
 flowchart, hex-grid, music-player — each on its own tree-shakeable subpath, with
-the esbuild metafile isolation guard in place. (1.4.0 adds a snippet-safe
-`./code-editor/highlight` tokenizer entry, Vue SFC highlighting, and richer
-JS/CSS tokens; 1.3.2 Catmull-Rom smooth lines and Vue shape CRUD on `VdDraw`;
-see the [changelog](./CHANGELOG.md).)
+the esbuild metafile isolation guard in place. (1.4.2 is a review-fix patch: draw
+paint-order and gesture-cancel correctness, charts responsive-table and
+per-series data-table fixes plus additive core `role` / Vue `svgRole` options,
+hex-grid fast-frame stats, and test hardening; 1.4.1 added hex-grid DPR/culling,
+draw vector polish
+and multi-touch, charts WAI-ARIA + keyboard + data table, and a wrap-mode
+scrollbar guard; 1.4.0 the snippet-safe `./code-editor/highlight` tokenizer; see
+the [changelog](./CHANGELOG.md).)
 
 ## Install
 
@@ -51,6 +55,14 @@ import { VdMusicPlayer } from '@vanduo-oss/vd3-cbun/music-player';
 import '@vanduo-oss/vd3-cbun/music-player/css';
 ```
 
+`VdHexGrid` / `VdHexGridCore` accept `pixelRatio` (`number | 'auto'`, default
+`'auto'` = `min(devicePixelRatio, 2)`) and `cull` (default `true`, viewport
+culling). Large grids coalesce pan/zoom into one frame and blit the last sharp
+frame while gesturing, then re-render sharply when idle. `getVisibleHexes()` and
+`getRenderStats()` expose the culled/render state; `setPixelRatio()` and
+`setCull()` update them in place. `pixelRatio: 1` and `cull: false` restore the
+pre-1.1 buffer size and whole-grid iteration.
+
 `highlight(source, lang, { trailingNewline? })` defaults `trailingNewline` to
 `false` (snippet-safe inside `<pre>`). `./code-editor/highlight` does not load
 the editor or Vue wrapper. First-party languages include `vue` (SFC);
@@ -91,7 +103,7 @@ The bundle's own semver (`package.json` version) is decoupled from the
 components inside it. Each component carries a VERSION constant tracked in
 `component-versions.json` at the repo root and asserted in tests against the
 exported `VD3_CBUN_VERSIONS` map. code-editor sits at `1.1.0`; charts at
-`1.1.0`; hex-grid and music-player at `1.0.1`; draw at `1.1.0`; **flowchart continues its
+`1.1.0`; hex-grid at `1.1.0`; music-player at `1.0.1`; draw at `1.1.0`; **flowchart continues its
 old-line lineage at `1.2.0`** because `VD_FLOWCHART_VERSION` is load-bearing —
 it is serialized into user documents via `toJSON().version`. A new component
 enters the manifest at `1.0.0` (`draw` did, in bundle 1.2.0).

package/SKILL.md

@@ -43,7 +43,12 @@ the scales (`scaleLinear`, `scaleTime`, `scaleBand`, `scalePoint`,
 `scaleOrdinal`), accessor/tick helpers (`createAccessor`, `ticks`,
 `niceDomain`), the path builders (`linePath`, `areaPath`, `arcPath`), and
 `resolveTheme`. No name collision, so the core factories keep their own names.
-CSS ships at `@vanduo-oss/vd3-cbun/charts/css`. `VD_CHARTS_VERSION` is `1.0.1`.
+CSS ships at `@vanduo-oss/vd3-cbun/charts/css`. Charts expose WAI-ARIA Graphics
+roles, arrow-key mark navigation, and an accessible data table (`dataTable`:
+`true` / `false` / `'visible'`; `ariaRoleDescription` overrides the SVG
+description; core `role` / Vue `svgRole` override the default
+`graphics-document document` role without consuming the Vue root `role`
+attribute). `VD_CHARTS_VERSION` is `1.1.0`.
 
 ## Code-editor
 
@@ -78,7 +83,8 @@ real SFC tokenizer (`<script>` / `<style>` embed, `{{ }}`, `v-*` / `@` / `:`).
 The main `./code-editor` subpath also re-exports those helpers plus
 `VD_CODE_EDITOR_VERSION`. Key props: `language`, `readOnly`, `lineNumbers`,
 `tabSize`, `wrap`, `placeholder`, `maxLength`; events: `update:modelValue`,
-`change`, `focus`, `blur`, `ready`. CSS ships at
+`change`, `focus`, `blur`, `ready`. Wrap mode shares `scrollbar-gutter: stable`
+on the textarea and highlight layer so the caret stays aligned. CSS ships at
 `@vanduo-oss/vd3-cbun/code-editor/css`. `VD_CODE_EDITOR_VERSION` is `1.1.0`.
 
 ## Draw
@@ -106,8 +112,12 @@ carry `brush` / `color` / `opacity` / per-point `pressure`) via a
 also re-exports `BRUSH_PRESETS`, `DRAW_TOOLS`, `DRAW_SHAPE_TYPES`, and
 `VD_DRAW_VERSION`. Key props: `data`, `tool`, `readonly`, `gridSize`, `snap`,
 `autoFit`, `history`, `historyLimit`; events: `change`, `select`, `viewport`,
-`ready`. CSS ships at `@vanduo-oss/vd3-cbun/draw/css`. `VD_DRAW_VERSION` is
-`1.1.0`.
+`ready`. Live EMA brush smoothing + RDP simplification, incremental SVG cache,
+two-finger pinch/pan, multi-line text wrap, double-click text edit, and surgical
+Vue setters (`setReadonly` / `setSnap` / `setHistoryEnabled` /
+`setHistoryLimit`) so option props do not recreate the editor.
+`fitView(padding?)` defaults padding to `40`. CSS ships at
+`@vanduo-oss/vd3-cbun/draw/css`. `VD_DRAW_VERSION` is `1.1.0`.
 
 ## Flowchart
 
@@ -149,7 +159,13 @@ subpath (coordinate transforms, rotation, distance, plus the terrain tables:
 and the `isPassable` / `getMovementCost` / `getTerrainYields` / `getTerrainColor`
 helpers). Hex-grid ships **no CSS** — it renders to a canvas and reads `--vd-*`
 theme tokens off the host element via `getComputedStyle`. `VD_HEX_VERSION` is
-`1.0.1`.
+`1.1.0`. The core accepts `pixelRatio` (`number | 'auto'`, default `'auto'` =
+`min(devicePixelRatio, 2)`) and `cull` (default `true`, viewport culling).
+Pan/zoom gestures rAF-coalesce to one frame and, above ~8000 visible cells,
+blit the last sharp frame before a sharp culled re-render when idle; data APIs
+stay synchronous. `getVisibleHexes()`, `getRenderStats()`, `setPixelRatio()`,
+and `setCull()` expose/update this state; `pixelRatio: 1` and `cull: false`
+restore the pre-1.1 behavior.
 
 ## Music-player
 

package/dist/charts/core.d.ts

@@ -105,6 +105,12 @@ export interface BaseChartOptions<T = Row> {
   legend?: boolean | LegendOptions;
   /** Draw value labels on each mark. */
   dataLabels?: boolean | DataLabelsOption;
+  /** Accessible data table fallback for screen readers (WCAG 1.1.1). Set `false` to disable or `'visible'` to display visually. Default is `true` (visually hidden). */
+  dataTable?: boolean | 'visible';
+  /** Custom ARIA role description override for the chart root (defaults to `${kind} chart`). */
+  ariaRoleDescription?: string;
+  /** Override the SVG WAI-ARIA graphics role (defaults to `graphics-document document`). */
+  role?: string;
 }
 
 export interface CartesianChartOptions<T = Row> extends BaseChartOptions<T> {