Add chart groups and faceting

.changeset/annotation-stacked-point.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(AnnotationPoint|AnnotationLine|AnnotationRange): Support `seriesKey` prop to associate an annotation with a series, positioning points and lines on its stacked segment

.changeset/bar-style-accessors.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Bar|Bars): Accept a per-row accessor for `fillOpacity`, `strokeWidth`, and `opacity`, matching `Rect` and `Circle`

.changeset/brush-component.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat: New Brush component to manually position, useful for multiple / independent brushes (ex. parallel coordinates). Also includes new `brushable` attachment and `brushGesture` handler for even more granular control of `BrushState`

.changeset/brush-context-dblclick-clear.md

@@ -0,0 +1,5 @@
+---
+'layerchart': patch
+---
+
+fix(BrushContext): Fix clearing on double-clicking the selection (root select-all was immediately undoing)

.changeset/chart-group.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(ChartGroup): Add `<ChartGroup>` and `ChartGroupState` to synchronize the tooltip/highlight, brush selection, zoom domain, and series highlight/visibility across charts

.changeset/chart-id.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Chart): Add `id` prop, applied to the root element and identifying the chart within a `ChartGroup`

.changeset/cscale-series-colors.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Chart): Default the color scale to the colors declared on `series`, so marks match their legend swatch

.changeset/facets.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Chart): Add `fx` / `fy` faceting, drawing the chart once per distinct value into a grid of panels that share the position scales

.changeset/legend-c-scale.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Legend): Support ordinal `c` scale similar to `series` including highlight and filter capability. An ordinal scale now draws labelled swatches rather than a color ramp — pass `variant="ramp"` for the old appearance

.changeset/pie-chart-grid.md

@@ -0,0 +1,5 @@
+---
+'layerchart': patch
+---
+
+fix(PieChart): Stop drawing a cartesian grid behind the arcs when using `series`

.changeset/rect-ref-pointerdown.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Rect): Support `ref` in html layers and forward `pointerdown` in canvas layers

.changeset/series-layout-auto.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Chart): Add `seriesLayout="auto"` (default) with automatic stacking when applicable (ex. Area, Bars). Can still pass explicit `seriesLayout` (ex. `overlap`, `group`, `stack`) when needed

.changeset/spline-area-class-prop.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Spline|Area): Resolve `stroke`, `fill`, `opacity`, and `class` per line/area (and segment). A string naming a data property now resolves through the chart's color scale, like other primitives (ex. `Circle`)

.changeset/spline-area-z.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Spline|Area): Add `z` accessor to draw one line/area per distinct value, defaulting to `stroke` / `fill` / `c`

.changeset/spline-stack.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Spline): Support `seriesKey` prop to follow that series' stacked top

.changeset/stack-groups.md

@@ -0,0 +1,5 @@
+---
+'layerchart': patch
+---
+
+fix(Chart): Stack each `x1` sub-band separately, so grouped-and-stacked bars no longer share one running total

.changeset/tooltip-show-value.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Tooltip): Add `tooltip.show({ point, value, data })` to control tooltip programmatically (buttons, keyboard events, etc.)

.changeset/transform-initial-domain.md

@@ -0,0 +1,5 @@
+---
+'layerchart': minor
+---
+
+feat(Chart): Add `transform.initialDomain` to open a chart zoomed to a range

.changeset/zoom-to-brush.md

@@ -0,0 +1,5 @@
+---
+'layerchart': patch
+---
+
+fix(Chart): Apply `zoomToBrush()` when called before the chart mounts or when the scale clamps to `scaleExtent`

.github/workflows/update-bundle-baseline.yml

@@ -3,7 +3,7 @@ name: Update Bundle Baseline
 on:
   push:
     branches:
-      - next
+      - main
     paths:
       - packages/layerchart/**
       - bundle-analyzer/**

.github/workflows/update-visual-baseline.yml

@@ -0,0 +1,80 @@
+name: Update Visual Baseline
+
+# Fingerprints depend on the rendering environment, so the baseline PRs compare against has to be
+# recorded on a runner rather than a contributor's machine. Runs on demand, and after any push to
+# main that could change what the examples draw.
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - packages/layerchart/**
+      - docs/src/examples/**
+      - docs/scripts/visual-snapshot.mjs
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  update-baseline:
+    name: Update Visual Baseline
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Install Chromium
+        run: pnpm --filter docs exec playwright install --with-deps chromium
+
+      - name: Build packages
+        run: pnpm build:packages
+
+      - name: Start the docs server
+        run: |
+          pnpm --filter docs exec vite dev --port 3002 > /tmp/server.log 2>&1 &
+          for i in $(seq 1 60); do
+            curl -sf -o /dev/null http://localhost:3002/ && exit 0
+            sleep 2
+          done
+          echo "docs server did not start"; cat /tmp/server.log; exit 1
+
+      # Two passes so examples that are still nondeterministic are recorded as such and skipped
+      # by later comparisons rather than reported as regressions
+      - name: Capture baseline
+        working-directory: docs
+        run: node scripts/visual-snapshot.mjs capture snapshots/baseline.json --repeat 2
+
+      - name: Create or update visual baseline PR
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: chore/update-visual-baseline
+          title: 'chore: update visual regression baseline'
+          body: |
+            ## Visual Baseline Update
+
+            Re-recorded `docs/snapshots/baseline.json` from `main` on a runner, so PR comparisons
+            have something to diff against in the same rendering environment.
+
+            ### How to review
+
+            The diff lists one line per example. Lines that changed mean the example draws
+            something different than the last baseline — check those were intended.
+          commit-message: 'chore: update visual regression baseline'
+          add-paths: docs/snapshots/baseline.json

.github/workflows/visual-regression.yml

@@ -0,0 +1,113 @@
+name: Visual Regression
+
+on:
+  pull_request:
+    paths:
+      - packages/layerchart/**
+      - docs/src/examples/**
+      - docs/scripts/visual-snapshot.mjs
+    types: [opened, synchronize, reopened]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.number }}
+  cancel-in-progress: true
+
+jobs:
+  visual-regression:
+    name: Example Rendering
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Install Chromium
+        run: pnpm --filter docs exec playwright install --with-deps chromium
+
+      - name: Build packages
+        run: pnpm build:packages
+
+      # Fingerprints depend on the rendering environment, so the baseline has to have been
+      # recorded on a runner too — see update-visual-baseline.yml
+      - name: Read the baseline from the target branch
+        id: baseline
+        run: |
+          mkdir -p /tmp/visual
+          if git show origin/${{ github.base_ref }}:docs/snapshots/baseline.json > /tmp/visual/baseline.json 2>/dev/null; then
+            echo "found=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "found=false" >> "$GITHUB_OUTPUT"
+            echo "No baseline on ${{ github.base_ref }} — run the Update Visual Baseline workflow." >> "$GITHUB_STEP_SUMMARY"
+          fi
+
+      - name: Start the docs server
+        if: steps.baseline.outputs.found == 'true'
+        run: |
+          pnpm --filter docs exec vite dev --port 3002 > /tmp/visual/server.log 2>&1 &
+          for i in $(seq 1 60); do
+            curl -sf -o /dev/null http://localhost:3002/ && exit 0
+            sleep 2
+          done
+          echo "docs server did not start"; cat /tmp/visual/server.log; exit 1
+
+      - name: Capture this branch
+        if: steps.baseline.outputs.found == 'true'
+        working-directory: docs
+        run: node scripts/visual-snapshot.mjs capture /tmp/visual/current.json --repeat 1
+
+      # No before/after images: rendering the base revision would mean building it too. The
+      # example names plus the element counts are enough to know what to open locally.
+      - name: Compare
+        if: steps.baseline.outputs.found == 'true'
+        id: compare
+        working-directory: docs
+        run: |
+          set +e
+          node scripts/visual-snapshot.mjs compare /tmp/visual/baseline.json /tmp/visual/current.json | tee /tmp/visual/report.txt
+          echo "exit=$?" >> "$GITHUB_OUTPUT"
+          set -e
+
+      - name: Summarize
+        if: steps.baseline.outputs.found == 'true'
+        run: |
+          {
+            echo "## Visual regression"
+            echo
+            echo "Examples whose rendered geometry differs from \`${{ github.base_ref }}\`."
+            echo "Open any of them locally with \`pnpm dev\` and compare, or run:"
+            echo
+            echo '```sh'
+            echo 'pnpm --filter docs exec node scripts/visual-snapshot.mjs diff <Component/example> --head http://localhost:3002'
+            echo '```'
+            echo
+            echo '```'
+            cat /tmp/visual/report.txt
+            echo '```'
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Upload snapshots
+        if: always() && steps.baseline.outputs.found == 'true'
+        uses: actions/upload-artifact@v4
+        with:
+          name: visual-snapshots
+          path: /tmp/visual/*.json
+          retention-days: 7
+
+      - name: Fail if anything changed
+        if: steps.baseline.outputs.found == 'true' && steps.compare.outputs.exit != '0'
+        run: |
+          echo "Rendered output changed — review the job summary."
+          echo "If the changes are intended, run the Update Visual Baseline workflow after merging."
+          exit 1

bundle-analyzer/bundle-analyzer.ts

@@ -302,6 +302,8 @@ const refs = [
 							"svelte/motion",
 							"svelte/transition",
 							"svelte/compiler",
+							"svelte/events",
+							"svelte/reactivity",
 						],
 						output: {
 							minifyInternalExports: true,