@dumiflex/wp-kit 0.5.0 → 0.7.0

package/src/WorkingLine.vue

@@ -0,0 +1,234 @@
+<script setup lang="ts">
+/**
+ * WorkingLine: "the model is working", in one line like Claude Code's. A
+ * small mark drawn from the logo's sparkles, a word that crossfades when it
+ * changes, and the time so far. It only draws: the app decides the word,
+ * the time and the tempo (the extension's AiWorking cycles playful words
+ * and the real status, and reads the request's phase).
+ *
+ *   <WorkingLine word="Thinking" time="12s" tempo="mid" />
+ *   <WorkingLine :word="word" :word-key="phase" variant="orbit" inline />
+ *
+ * Marks (`variant`): typing (three stars hop in turn), shuffle (the small
+ * stars swap places round the big one), orbit (the logo's four nodes circle
+ * the stars) or burst (the small stars fly out of the big one and back).
+ * `tempo` sets their speed: slow while the model reads, mid while it thinks,
+ * fast while it writes.
+ *
+ * The word crossfades in place when `wordKey` changes (default: the word),
+ * so a token count ticking up can keep its key and not flicker. Its box is
+ * never narrower than the word: it widens at once and narrows smoothly once
+ * the old word has mostly faded.
+ *
+ * The marks move on a canvas over the still SVG, so they stay sharp and
+ * glide in every browser (`canvas-motion.ts` says why); the SVG is the first
+ * paint and stays under reduced motion, where it only breathes.
+ */
+import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from "vue";
+import { BRAND_COLOURS, STAR_A, STAR_B, STAR_BIG, type LogoBrand } from "./logo-paths";
+import { canvasBox, useCanvasMotion } from "./canvas-motion";
+import { TEMPO_MS, TYPING_X, drawWorking, orbitNodes, type WorkingVariant } from "./working-line-motion";
+
+export type { WorkingVariant } from "./working-line-motion";
+
+const props = withDefaults(defineProps<{
+  /** What is shown, without the "…" (the line adds it). */
+  word: string;
+  /** What the crossfade keys on; defaults to the word. */
+  wordKey?: string | undefined;
+  /** Time so far, already formatted ("42s"). Left out, no time shows. */
+  time?: string | undefined;
+  variant?: WorkingVariant | undefined;
+  tempo?: "slow" | "mid" | "fast" | undefined;
+  /** The mark's size in px. */
+  size?: number | undefined;
+  /** Smaller text and a capped word width, for a top bar. */
+  inline?: boolean | undefined;
+  /** The whole status, for screen readers and the tooltip; defaults to the word. */
+  label?: string | undefined;
+  brand?: LogoBrand | undefined;
+}>(), { variant: "typing", tempo: "slow", size: 22, inline: false, brand: "extension" });
+
+const key = computed(() => props.wordKey ?? props.word);
+const name = computed(() => props.label ?? props.word);
+
+const colours = computed(() => BRAND_COLOURS[props.brand]);
+const BIG = computed(() => colours.value[0]);
+const A = computed(() => colours.value[1]);
+const B = computed(() => colours.value[2]);
+/** The logo's four nodes for the orbit, with steps between the colours. */
+const nodes = computed(() => orbitNodes(colours.value));
+/** Typing stars: the big sparkle drawn small three times in a row. */
+const typing = computed(() => TYPING_X.map((x, i) => [x, [A.value, BIG.value, B.value][i] ?? BIG.value] as const));
+
+const canvas = ref<HTMLCanvasElement | null>(null);
+const canvasStyle = computed(() => canvasBox(props.size));
+const { live, drawn } = useCanvasMotion(canvas, (ctx, width, ms) =>
+  drawWorking(ctx, width, ms, props.variant, TEMPO_MS[props.tempo], colours.value));
+
+const measure = ref<HTMLElement | null>(null);
+const boxWidth = ref<number | null>(null);
+const growing = ref(false);
+async function fit(): Promise<void> {
+  await nextTick();
+  // Rounded up, plus a pixel to spare: one pixel short is enough for the
+  // browser to swap the word's end for its own "…", which Firefox draws
+  // invisibly on this gradient text.
+  const raw = measure.value?.getBoundingClientRect().width ?? 0;
+  const w = raw ? Math.ceil(raw) + 1 : 0;
+  if (!w || w === boxWidth.value) return;
+  growing.value = boxWidth.value === null || w > boxWidth.value;
+  boxWidth.value = w;
+}
+watch(() => props.word, () => { void fit(); });
+
+// The word's width can also change on its own, when the font loads late.
+let resized: ResizeObserver | null = null;
+onMounted(() => {
+  void fit();
+  if (typeof ResizeObserver !== "undefined" && measure.value) {
+    resized = new ResizeObserver(() => { void fit(); });
+    resized.observe(measure.value);
+  }
+});
+onBeforeUnmount(() => resized?.disconnect());
+</script>
+
+<template>
+  <div
+    class="wp-wl"
+    :data-tempo="tempo"
+    :data-variant="variant"
+    :data-inline="inline ? 'true' : undefined"
+    :data-drawn="drawn ? 'true' : undefined"
+    role="status"
+    :aria-label="name"
+    :title="name"
+    :style="{ '--wp-wl-big': BIG, '--wp-wl-a': A, '--wp-wl-b': B }"
+  >
+    <span class="wp-wl__art" :style="{ width: `${size}px`, height: `${size}px` }">
+    <svg class="wp-wl__logo" viewBox="0 0 1024 1024" :width="size" :height="size" aria-hidden="true">
+      <template v-if="variant === 'typing'">
+        <path
+          v-for="([x, c], i) in typing" :key="i" :style="{ fill: c }"
+          :transform="`translate(${x - 256} 256) scale(.5)`" :d="STAR_BIG"
+        />
+      </template>
+      <g v-else-if="variant === 'shuffle'" transform="translate(512 512) scale(1.45) translate(-512 -512)">
+        <path :style="{ fill: BIG }" :d="STAR_BIG" />
+        <path :style="{ fill: A }" :d="STAR_A" />
+        <path :style="{ fill: B }" :d="STAR_B" />
+      </g>
+      <template v-else-if="variant === 'orbit'">
+        <circle v-for="([x, y, c], i) in nodes" :key="i" :style="{ fill: c }" :cx="x" :cy="y" r="70" />
+        <path :style="{ fill: BIG }" :d="STAR_BIG" />
+        <path :style="{ fill: A }" :d="STAR_A" />
+        <path :style="{ fill: B }" :d="STAR_B" />
+      </template>
+      <g v-else transform="translate(512 512) scale(1.3) translate(-512 -512)">
+        <path :style="{ fill: BIG }" :d="STAR_BIG" />
+        <path :style="{ fill: A }" :d="STAR_A" />
+        <path :style="{ fill: B }" :d="STAR_B" />
+      </g>
+    </svg>
+    <canvas v-if="live" ref="canvas" class="wp-wl__canvas" :style="canvasStyle" aria-hidden="true" />
+    </span>
+    <span
+      class="wp-wl__words"
+      :data-grow="growing ? 'true' : undefined"
+      :style="boxWidth ? { width: `${boxWidth}px` } : undefined"
+    >
+      <Transition name="wp-wl-word" type="transition">
+        <span :key="key" class="wp-wl__word" data-test="working-line-word">{{ word }}…</span>
+      </Transition>
+      <span ref="measure" class="wp-wl__word wp-wl__measure" aria-hidden="true">{{ word }}…</span>
+    </span>
+    <span v-if="time !== undefined" class="wp-wl__time" data-test="working-line-time">{{ time }}</span>
+  </div>
+</template>
+
+<style scoped>
+.wp-wl {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  color: var(--wp-text-muted);
+  font-size: 13px;
+  white-space: nowrap;
+}
+.wp-wl__logo { overflow: visible; }
+.wp-wl__words {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  min-width: 0;
+  max-width: 100%;
+  overflow: hidden;
+  /* Narrows once the old word has mostly faded; widens at once. */
+  transition: width 0.35s cubic-bezier(0.25, 0.8, 0.25, 1) 0.3s;
+}
+.wp-wl__words[data-grow="true"] { transition: none; }
+.wp-wl__word {
+  display: inline-block;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-weight: 500;
+  /* A light band sweeps over the gradient text, like Claude's own line.
+     The band is a fixed white, like the logo's brand colours. */
+  background:
+    linear-gradient(100deg, transparent 35%, rgba(255, 255, 255, 0.75) 50%, transparent 65%) no-repeat,
+    linear-gradient(90deg, var(--wp-wl-big), var(--wp-wl-a) 45%, var(--wp-wl-b));
+  background-size: 250% 100%, 100% 100%;
+  background-position: 150% 0, 0 0;
+  -webkit-background-clip: text; background-clip: text; color: transparent;
+  animation: wp-wl-shimmer 2.6s linear infinite;
+}
+@keyframes wp-wl-shimmer {
+  0% { background-position: 150% 0, 0 0; }
+  70%, 100% { background-position: -50% 0, 0 0; }
+}
+/* Sized like the word, never seen: what the box grows or shrinks to. */
+.wp-wl__measure {
+  position: absolute; left: 0; top: 0;
+  visibility: hidden; pointer-events: none; animation: none;
+  max-width: none; overflow: visible;
+}
+.wp-wl__time { flex-shrink: 0; font-variant-numeric: tabular-nums; color: var(--wp-text-dim); }
+.wp-wl[data-inline="true"] { font-size: 12px; }
+.wp-wl[data-inline="true"] .wp-wl__words { max-width: 240px; }
+/* Crossfade in place: the old word fades out on top of the new one. The
+ * fade and blur run through registered custom properties (see the marks
+ * below for why): an `opacity` / `filter` transition lifts the word onto a
+ * compositor layer, which re-rasterises the text and snaps it to whole
+ * pixels as the fade begins. The leaving word keeps its exact spot (top 0,
+ * the box is one word tall), with no -50% translate to land between pixels. */
+.wp-wl-word-enter-active, .wp-wl-word-leave-active {
+  opacity: var(--wp-wl-wo);
+  filter: blur(var(--wp-wl-wb));
+  transition: --wp-wl-wo 0.45s ease, --wp-wl-wb 0.45s ease;
+}
+.wp-wl-word-leave-active { position: absolute; left: 0; top: 0; }
+.wp-wl-word-enter-from, .wp-wl-word-leave-to { --wp-wl-wo: 0; --wp-wl-wb: 2px; }
+@media (prefers-reduced-motion: reduce) {
+  .wp-wl__word { animation: none; }
+  .wp-wl__words { transition: none; }
+  .wp-wl-word-enter-from, .wp-wl-word-leave-to { --wp-wl-wb: 0px; }
+}
+
+/* The marks move on the canvas; the SVG is the still mark under it. */
+.wp-wl__art { position: relative; display: inline-block; flex-shrink: 0; line-height: 0; }
+.wp-wl__logo { display: block; }
+.wp-wl__canvas { position: absolute; pointer-events: none; }
+.wp-wl[data-drawn="true"] .wp-wl__logo { visibility: hidden; }
+
+@property --wp-wl-o { syntax: "<number>"; inherits: false; initial-value: 1; }
+@property --wp-wl-wo { syntax: "<number>"; inherits: false; initial-value: 1; }
+@property --wp-wl-wb { syntax: "<length>"; inherits: false; initial-value: 0px; }
+
+@media (prefers-reduced-motion: reduce) {
+  .wp-wl__logo { opacity: var(--wp-wl-o); animation: wp-wl-fade 2.4s ease-in-out infinite; }
+  @keyframes wp-wl-fade { 0%, 100% { --wp-wl-o: 1; } 50% { --wp-wl-o: 0.55; } }
+}
+</style>

package/src/WpIconButton.vue

@@ -2,7 +2,7 @@
 /**
  * WpIconButton: the 20 px square icon button inside a canvas row (module,
  * injector, bundle and model rows, the Context toolbar). Rows are too tight
- * for the 24 px `WpButton size="sm"`, so this is the one smaller control on
+ * for the 24 px `Button size="sm"`, so this is the one smaller control on
  * the canvas, still at the 20 px hit-target floor.
  *
  *   <WpIconButton icon="pi-trash" label="Remove module" tone="danger" @click="remove" />
@@ -75,7 +75,8 @@ const emit = defineEmits<{ click: [evt: MouseEvent] }>();
 .wp-icon-btn[data-tone="accent"] { --tone: var(--wp-accent); }
 .wp-icon-btn[data-tone="warn"] { --tone: var(--wp-warn); }
 .wp-icon-btn[data-tone="danger"] { --tone: var(--wp-danger); }
-.wp-icon-btn .pi { font-size: 11px; }
+/* Even icon in the 18px inside of the box: an odd size sits half a pixel off. */
+.wp-icon-btn .pi { font-size: 12px; }
 .wp-icon-btn__glyph { font: 600 11px/1 var(--wp-font-mono); }
 .wp-icon-btn:hover:not(:disabled) { background: var(--wp-bg-4); color: var(--tone); }
 .wp-icon-btn:focus-visible { outline: none; box-shadow: 0 0 0 2px var(--wp-border-focus); }

package/src/WpImageZoom.vue

@@ -25,7 +25,7 @@
  *   <WpImageZoom v-model:zoom="zoom" :src="url" alt="Frame 3" />
  */
 import { computed, onBeforeUnmount, ref, watch } from "vue";
-import WpButton from "./WpButton.vue";
+import Button from "./Button.vue";
 import {
   centreOf, clampView, fitScale, percent, stepScale, viewAround, visibleRect, zoomAt, IDLE_MS, type Size, type View,
 } from "./image-zoom";
@@ -298,13 +298,13 @@ const at = (s: number): boolean => !isFit.value && Math.abs(view.value.scale - s
       @focusout="chromeLeave"
     >
       <slot name="bar-start" />
-      <WpButton variant="ghost" :size="size" icon="pi-minus" aria-label="Zoom out" kbd="−" data-test="imgzoom-out" @click="zoomOut" />
-      <WpButton :variant="isFit ? 'secondary' : 'ghost'" :size="size" kbd="0" hint="Show the whole picture" :aria-pressed="isFit" data-test="imgzoom-fit" @click="setZoom(null)">Fit</WpButton>
-      <WpButton :variant="at(1) ? 'secondary' : 'ghost'" :size="size" kbd="1" hint="Real size: one image pixel per screen pixel" :aria-pressed="at(1)" data-test="imgzoom-100" @click="setZoom(1)">100%</WpButton>
-      <WpButton :variant="at(2) ? 'secondary' : 'ghost'" :size="size" kbd="2" hint="Twice the real size" :aria-pressed="at(2)" data-test="imgzoom-200" @click="setZoom(2)">200%</WpButton>
-      <WpButton variant="ghost" :size="size" icon="pi-plus" aria-label="Zoom in" kbd="+" data-test="imgzoom-in" @click="zoomIn" />
+      <Button variant="ghost" :size="size" icon="pi-minus" aria-label="Zoom out" kbd="−" data-test="imgzoom-out" @click="zoomOut" />
+      <Button :variant="isFit ? 'secondary' : 'ghost'" :size="size" kbd="0" hint="Show the whole picture" :aria-pressed="isFit" data-test="imgzoom-fit" @click="setZoom(null)">Fit</Button>
+      <Button :variant="at(1) ? 'secondary' : 'ghost'" :size="size" kbd="1" hint="Real size: one image pixel per screen pixel" :aria-pressed="at(1)" data-test="imgzoom-100" @click="setZoom(1)">100%</Button>
+      <Button :variant="at(2) ? 'secondary' : 'ghost'" :size="size" kbd="2" hint="Twice the real size" :aria-pressed="at(2)" data-test="imgzoom-200" @click="setZoom(2)">200%</Button>
+      <Button variant="ghost" :size="size" icon="pi-plus" aria-label="Zoom in" kbd="+" data-test="imgzoom-in" @click="zoomIn" />
       <span class="wp-imgzoom__level" aria-live="polite" data-test="imgzoom-level">{{ level }}</span>
-      <WpButton
+      <Button
         v-if="canFull"
         variant="ghost"
         :size="size"

package/src/WpSegmented.vue

@@ -168,7 +168,9 @@ function onKeydown(ev: KeyboardEvent): void {
 .wp-segmented__opt[data-active="true"] .pi { color: var(--wp-accent-text); }
 .wp-segmented__opt:focus-visible { outline: none; box-shadow: 0 0 0 2px var(--wp-border-focus); }
 .wp-segmented__opt:disabled { opacity: 0.45; cursor: not-allowed; }
-.wp-segmented__opt .pi { font-size: 0.95em; }
+/* Even sizes: an icon-only option is a square, and an odd icon sits half a pixel off in it. */
+.wp-segmented__opt .pi { font-size: 12px; }
+.wp-segmented[data-size="lg"] .wp-segmented__opt .pi { font-size: 14px; }
 @media (prefers-reduced-motion: reduce) {
   .wp-segmented__opt { transition: none; }
 }

package/src/WpSwitch.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 /**
- * The on/off switch for canvas widgets and the manager (Toggle.vue wraps it).
+ * The one on/off switch, for canvas widgets and the manager (size="md" there).
  *
  *   <WpSwitch v-model="held" label="Hold across run" />                  track
  *   <WpSwitch v-model="held" variant="chip" icon="pi-link" label="Hold across run" />

package/src/WpTabs.vue

@@ -165,7 +165,7 @@ function onKeydown(ev: KeyboardEvent): void {
 .wp-tabset__tab[data-active="true"] { color: var(--wp-text); border-bottom-color: var(--wp-accent-400); }
 .wp-tabset__tab:focus-visible { outline: none; box-shadow: inset 0 0 0 2px var(--wp-border-focus); border-radius: var(--wp-radius-sm); }
 .wp-tabset__tab:disabled { opacity: 0.45; cursor: not-allowed; }
-.wp-tabset__tab .pi { font-size: 0.95em; }
+.wp-tabset__tab .pi { font-size: 12px; }
 .wp-tabset__count {
   min-width: 16px;
   padding: 1px 5px;

package/src/_modal-motion.css

@@ -6,7 +6,7 @@
  *               the dialog grows into place.
  *
  * Selector for the panel is `> *` (immediate child of the overlay
- * element). Works for ModalShell's `.wp-modal-wrapper`, ConfirmDialog's
+ * element). Works for ModalShell's `.wp-modal-wrapper` (Modal, ConfirmModal), the old
  * `.wp-confirm`, InjectorBindingModal's `.ibm`, and any future modal
  * that follows the overlay-with-one-child layout.
  *

package/src/button.css

@@ -1,13 +1,12 @@
-/* Button — the one .wp-btn stylesheet, shared by the manager Button
- * (manager/components/ui/Button.vue, loaded globally by manager/main.ts) and
- * the canvas twin WpButton (components/shared/WpButton.vue, component
- * standard rule 8), which pulls it in scoped. It reads only the
+/* Button — the one .wp-btn stylesheet. Button.vue pulls it in scoped (so it
+ * works on the canvas), and the manager and the community site also load it
+ * globally for the few plain elements styled as buttons (a router-link). It reads only the
  * SHARED_TOKENS names, so it wears the manager colours on a page and the
  * canvas colours in a node.
  *
  * Unlayered on purpose: the manager loads it beside tokens.css, where an
  * unlayered reset would otherwise beat it. The canvas never loads it
- * globally: WpButton pulls in a scoped copy, so its classes never meet
+ * globally: Button pulls in a scoped copy, so its classes never meet
  * another extension's `.wp-btn`.
  *
  * Heights follow the control scale: sm 24 / md 32 / lg 40.
@@ -21,6 +20,8 @@
  */
 
 .wp-btn {
+  /* A link drawn as a button (<a class="wp-btn">, Button as="a") loses the browser's underline; the link variant adds its own on hover. */
+  text-decoration: none;
   height: var(--wp-control-h-md);
   padding: 0 12px;
   border-radius: min(7px, var(--wp-radius-cap, 999px));
@@ -46,7 +47,8 @@
   outline: none;
   box-shadow: var(--wp-focus-ring);
 }
-.wp-btn .pi, .wp-btn svg { font-size: 13px; }
+/* Even icon sizes in the even control heights: an odd one sits half a pixel off. */
+.wp-btn .pi, .wp-btn svg { font-size: 14px; }
 /* The label box (not on a link, which has no fixed height) is trimmed to
  * the cap height where the browser can, so the
  * flex centring puts the capitals, not the ascender-to-descender box, on the

package/src/canvas-motion.ts

@@ -0,0 +1,251 @@
+/**
+ * Looping marks drawn on a canvas (LoadingMark, WorkingLine).
+ *
+ * A keyframed `transform` / `opacity` on an SVG path goes to the compositor,
+ * which blurs the path and snaps it to whole pixels as it starts. Animating
+ * registered custom properties fixed that in Chromium, but Firefox still lays
+ * each frame of an SVG transform on the pixel grid, so small marks stepped
+ * and twitched as they moved. A canvas puts every shape at its exact
+ * fractional position each frame, sharp and smooth in both.
+ *
+ * One `requestAnimationFrame` loop draws every mark on the page. Each mark
+ * keeps its own clock, so a host can slow or pause the marks inside it with
+ * `data-wp-motion-speed` (a number) and `data-wp-motion-paused` on an
+ * ancestor, as the kit site's Animations section does.
+ *
+ * A mark keeps its still SVG for the first paint, under reduced motion and
+ * in a test DOM; `useCanvasMotion` puts the canvas over it once it can draw.
+ */
+import { nextTick, onBeforeUnmount, onMounted, ref, type Ref } from "vue";
+
+/** Room around the 1024 box for parts that move past its edge, and for
+ *  anti-aliasing there. */
+export const PAD = 82;
+export const BOX = 1024 + 2 * PAD;
+
+/** CSS `cubic-bezier(x1, y1, x2, y2)` as a function of progress. */
+export function cubicBezier(x1: number, y1: number, x2: number, y2: number): (x: number) => number {
+  return (x) => {
+    if (x <= 0) return 0;
+    if (x >= 1) return 1;
+    let lo = 0;
+    let hi = 1;
+    let t = x;
+    for (let k = 0; k < 30; k++) {
+      t = (lo + hi) / 2;
+      const cx = 3 * x1 * t * (1 - t) ** 2 + 3 * x2 * t * t * (1 - t) + t ** 3;
+      if (cx < x) lo = t;
+      else hi = t;
+    }
+    return 3 * y1 * t * (1 - t) ** 2 + 3 * y2 * t * t * (1 - t) + t ** 3;
+  };
+}
+
+export const EASE = cubicBezier(0.25, 0.1, 0.25, 1);
+export const EASE_IN_OUT = cubicBezier(0.42, 0, 0.58, 1);
+export const SMOOTH = cubicBezier(0.65, 0, 0.35, 1);
+
+export type Stop = readonly [at: number, values: readonly number[]];
+
+/** Value of a keyframe track at progress `p` (0..1), eased per segment the
+ *  way CSS eases between two keyframes. */
+export function track(stops: readonly Stop[], p: number, ease: (x: number) => number): number[] {
+  for (let k = 0; k < stops.length - 1; k++) {
+    const a = stops[k];
+    const b = stops[k + 1];
+    if (!a || !b) break;
+    if (p >= a[0] && p <= b[0]) {
+      if (b[0] === a[0]) return [...b[1]];
+      const e = ease((p - a[0]) / (b[0] - a[0]));
+      return a[1].map((v, j) => v + ((b[1][j] ?? v) - v) * e);
+    }
+  }
+  return [...(stops[stops.length - 1]?.[1] ?? [])];
+}
+
+/** Progress (0..1) through a loop of `period` ms, `ms` into the animation.
+ *  A positive `delay` holds the start pose until it has passed, like CSS. */
+export function loop(ms: number, period: number, delay = 0): number {
+  const t = ms - delay;
+  if (t < 0) return 0;
+  return (t % period) / period;
+}
+
+/** Mixes two `#rrggbb` colours in sRGB, like `color-mix(in srgb, a w%, b)`. */
+export function mix(a: string, b: string, weightA: number): string {
+  const ch = (hex: string, i: number): number => parseInt(hex.slice(1 + 2 * i, 3 + 2 * i), 16);
+  const out = [0, 1, 2].map((i) => Math.round(ch(a, i) * weightA + ch(b, i) * (1 - weightA)));
+  return `#${out.map((v) => v.toString(16).padStart(2, "0")).join("")}`;
+}
+
+/** Fills `path` scaled and turned around `[x, y]`. */
+export function fillAround(
+  ctx: CanvasRenderingContext2D,
+  [x, y]: readonly [number, number],
+  scale: number,
+  turn: number,
+  path: Path2D,
+  fill: string | CanvasGradient,
+  alpha = 1,
+): void {
+  ctx.save();
+  ctx.translate(x, y);
+  ctx.rotate((turn * Math.PI) / 180);
+  ctx.scale(scale, scale);
+  ctx.translate(-x, -y);
+  ctx.globalAlpha = alpha;
+  ctx.fillStyle = fill;
+  ctx.fill(path);
+  ctx.restore();
+}
+
+/** Clears the canvas and sets it up to draw in the 1024 box. */
+export function begin(ctx: CanvasRenderingContext2D, width: number): void {
+  const k = width / BOX;
+  ctx.setTransform(1, 0, 0, 1, 0, 0);
+  ctx.clearRect(0, 0, width, width);
+  ctx.setTransform(k, 0, 0, k, PAD * k, PAD * k);
+}
+
+/** Draws one frame `ms` into the animation on a square canvas `width` px wide. */
+export type Draw = (ctx: CanvasRenderingContext2D, width: number, ms: number) => void;
+
+/** A mark the loop draws. */
+export interface Animated {
+  canvas: HTMLCanvasElement;
+  draw: Draw;
+  /** ms of animation shown so far, advanced by the loop. */
+  clock: number;
+  /** False while off screen: the clock still runs, nothing is drawn. */
+  visible: boolean;
+}
+
+const marks = new Set<Animated>();
+let frame = 0;
+let last = 0;
+
+/** Speed and pause from the nearest host that sets them. */
+export function motionOf(el: Element): { speed: number; paused: boolean } {
+  const paused = el.closest("[data-wp-motion-paused]") !== null;
+  const speedHost = el.closest("[data-wp-motion-speed]");
+  const speed = Number(speedHost?.getAttribute("data-wp-motion-speed") ?? "1");
+  return { speed: Number.isFinite(speed) && speed >= 0 ? speed : 1, paused };
+}
+
+function fit(c: HTMLCanvasElement): void {
+  const want = Math.max(1, Math.round(c.clientWidth * (window.devicePixelRatio || 1)));
+  if (c.width !== want) {
+    c.width = want;
+    c.height = want;
+  }
+}
+
+function paint(m: Animated): boolean {
+  const ctx = m.canvas.getContext("2d");
+  if (!ctx) return false;
+  fit(m.canvas);
+  m.draw(ctx, m.canvas.width, m.clock);
+  return true;
+}
+
+function tick(now: number): void {
+  const dt = last ? Math.min(now - last, 100) : 0;
+  last = now;
+  for (const m of marks) {
+    const { speed, paused } = motionOf(m.canvas);
+    if (!paused) m.clock += dt * speed;
+    if (m.visible) paint(m);
+  }
+  frame = marks.size ? requestAnimationFrame(tick) : 0;
+}
+
+/** Starts drawing a mark; returns the function that stops it. */
+export function animate(mark: Animated): () => void {
+  marks.add(mark);
+  if (!frame) {
+    last = 0;
+    frame = requestAnimationFrame(tick);
+  }
+  return () => {
+    marks.delete(mark);
+    if (!marks.size && frame) {
+      cancelAnimationFrame(frame);
+      frame = 0;
+    }
+  };
+}
+
+/** Draws one frame right away (before the loop runs, so the mark never
+ *  shows blank). False when there is no 2D canvas. */
+export function drawNow(mark: Animated): boolean {
+  return paint(mark);
+}
+
+/** Inline style for a canvas over a `px`-wide mark, reaching PAD past it. */
+export function canvasBox(px: number): Record<string, string> {
+  const side = (px * BOX) / 1024;
+  const off = (px * PAD) / 1024;
+  return { width: `${side}px`, height: `${side}px`, top: `${-off}px`, left: `${-off}px` };
+}
+
+/**
+ * Runs a mark's canvas while motion is allowed. Render
+ * `<canvas v-if="live" ref="canvas">` over the still SVG, and hide the SVG
+ * while `drawn`.
+ */
+export function useCanvasMotion(canvas: Ref<HTMLCanvasElement | null>, draw: Draw): { live: Ref<boolean>; drawn: Ref<boolean> } {
+  const live = ref(false);
+  const drawn = ref(false);
+  let stop: (() => void) | null = null;
+  let observer: IntersectionObserver | null = null;
+  let motion: MediaQueryList | null = null;
+
+  async function start(): Promise<void> {
+    if (stop) return;
+    live.value = true;
+    await nextTick();
+    const el = canvas.value;
+    if (!el || !live.value) return;
+    const mark: Animated = { canvas: el, draw, clock: 0, visible: true };
+    if (!drawNow(mark)) {
+      live.value = false;
+      return;
+    }
+    drawn.value = true;
+    stop = animate(mark);
+    if (typeof IntersectionObserver === "function") {
+      observer = new IntersectionObserver((entries) => {
+        for (const e of entries) mark.visible = e.isIntersecting;
+      });
+      observer.observe(el);
+    }
+  }
+  function halt(): void {
+    stop?.();
+    stop = null;
+    observer?.disconnect();
+    observer = null;
+    live.value = false;
+    drawn.value = false;
+  }
+  function onMotionChange(): void {
+    if (motion?.matches) halt();
+    else void start();
+  }
+
+  onMounted(() => {
+    // No matchMedia means no way to honour reduced motion, and a test DOM
+    // (jsdom) has no canvas and logs an error for every attempt: keep the
+    // still SVG in both.
+    if (typeof window.matchMedia !== "function" || typeof requestAnimationFrame !== "function") return;
+    if (navigator.userAgent.includes("jsdom")) return;
+    motion = window.matchMedia("(prefers-reduced-motion: reduce)");
+    motion.addEventListener?.("change", onMotionChange);
+    if (!motion.matches) void start();
+  });
+  onBeforeUnmount(() => {
+    motion?.removeEventListener?.("change", onMotionChange);
+    halt();
+  });
+  return { live, drawn };
+}

package/src/floating.ts

@@ -53,6 +53,11 @@ function room(side: Side, a: Rect, view: Size, gap: number, margin: number): num
   }
 }
 
+/** Space on one side of the anchor for a panel, after the gap and margin. */
+export function roomOn(side: Side, anchor: Rect, view: Size, opts: Pick<PlaceOptions, "gap" | "margin"> = {}): number {
+  return room(side, anchor, view, opts.gap ?? 6, opts.margin ?? 8);
+}
+
 function clamp(v: number, min: number, max: number): number {
   return max < min ? min : Math.min(Math.max(v, min), max);
 }

package/src/hsv.ts

@@ -5,7 +5,7 @@
  * lowercase. Functions are tolerant of out-of-range input — they clamp
  * rather than throw, which keeps the picker UI robust under fast drags.
  *
- * Lives in shared/ so both the manager-side ColorPicker / TweaksPanel
+ * Lives in shared/ so both the ColorField / TweaksPanel
  * AND the canvas-side bundle modal can drive the same HsvPicker
  * without a cross-package import.
  */

package/src/kind-colour.ts

@@ -1,7 +1,8 @@
 /**
  * The colour of each module type, for a Chip (or anything else) that names
  * one: the `--wp-kind-*` colour the extension uses for that type, bundles
- * slate. There is no kind chip: a kind is a Chip with this colour.
+ * slate, and its icon (`kindIcon`). There is no kind chip: a kind is a Chip
+ * with this colour.
  *
  *   <Chip :color="kindColour(itemType(post.kind, post.subtype))">{{ itemType(post.kind, post.subtype) }}</Chip>
  */
@@ -26,3 +27,25 @@ export function itemType(kind: "module" | "bundle", subtype?: ItemType | null):
 export function kindColour(type: ItemType): string {
   return COLOURS[type];
 }
+
+/** The PrimeIcons name (for Icon / ListRow `icon`) of each item type: the
+ *  same icons the extension's kind-icons map uses. */
+const ICONS: Record<ItemType, string> = {
+  wildcard: "sparkles",
+  fixed_values: "tag",
+  combine: "link",
+  derivation: "arrow-right-arrow-left",
+  constraint: "filter",
+  bundle: "box",
+};
+
+/** The icon of a type read from a payload (any string): `circle` for a type
+ *  the kit doesn't know. */
+export function kindIcon(type: string): string {
+  return (ICONS as Record<string, string>)[type] ?? "circle";
+}
+
+/** A payload's type string as a module subtype, or null when it isn't one. */
+export function moduleSubtype(type: string): ModuleSubtype | null {
+  return type === "fixed_values" || type === "combine" || type === "wildcard" || type === "constraint" || type === "derivation" ? type : null;
+}