Skip to content

Self-improving AI Employees for everyone

fix(theme): silent audio + node visuals not rendering + asset gaps (Waves 20-25)

trohitg152f60ba9d34
diff --git a/CLAUDE.md b/CLAUDE.md
index e6a2355c..06ca1d2c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -11,7 +11,7 @@ This is a React Flow-based workflow automation platform implementing n8n-inspire
|----------|-------------|
| **[Frontend Architecture](./docs-internal/frontend_architecture.md)** | Current frontend stack (React 19 + Vite + Tailwind v4 + shadcn/ui + Radix + RHF/zod + TanStack Query + Zustand). Tokens, primitives, forms, credentials exemplar, ownership boundary, `uiHints` catalogue. |
| **[UI Migration Plan](./docs-internal/ui_migration_plan.md)** | antd → shadcn/ui migration plan + completion log. Waves 1–10 done. Full frontend is schema-driven (backend SSOT); remaining DIY widget registry (ex-Phase 6) is the one deferred item. |
-| **[Theme System](./docs-internal/theme_system.md)** | 10-way visual theme system — 5 utopian (light, dark, renaissance, greek, edo, steampunk, atomic) + 5 dystopian (cyber, wasteland, rot, plague, surveillance) — driven by `<html data-theme>` + per-theme CSS files in `client/src/themes/` (3,749 LOC across 13 files). Token taxonomy (surface / fg / border / accent / typography / motion), shadcn HSL-triplet bridge, action role tokens, decorative-layer wrappers (`.app-frame` / `.canvas-host` / `.modal-frame`), per-component decorative ornaments (panel textures + canvas decorations + node pseudo-element overlays + 6 keyframes: `cyber-flicker` / `cyber-roll` / `cyber-blink` / `cyber-glitch` / `ren-flicker` / `surv-blink`), 9-event WebAudio sound system (10 packs via `--sound-pack` token + `useSound()` hook + global hover delegate + sonner toast monkey-patch + `withSound()` HOC), `@media (prefers-reduced-motion: reduce)` accessibility, 30 ms throttle on `type` / `hover`, migration recipe, anti-patterns. Read this before adding a new theme or migrating a component to the new contract. |
+| **[Theme System](./docs-internal/theme_system.md)** | 10-way visual theme system — 5 utopian (light, dark, renaissance, greek, edo, steampunk, atomic) + 5 dystopian (cyber, wasteland, rot, plague, surveillance) — driven by `<html data-theme>` + per-theme CSS files in `client/src/themes/` (~3,750 LOC across 13 files). Token taxonomy (surface / fg / border / accent / typography / motion), shadcn HSL-triplet bridge, action role tokens, decorative-layer wrappers (`.app-frame` / `.canvas-host` / `.modal-frame`), per-component decorative ornaments (panel textures + canvas decorations + node pseudo-element overlays + 6 keyframes: `cyber-flicker` / `cyber-roll` / `cyber-blink` / `cyber-glitch` / `ren-flicker` / `surv-blink`), **canvas-node visual contract via `--node-color` CSS custom property** (no inline `background` / `border` on node components — base.css + per-theme CSS owns visuals; `NodeStyle` helper type at [types/NodeTypes.ts](./client/src/types/NodeTypes.ts) makes the inline custom-prop typecheck-clean), **per-theme icon glyph system** (290 SVGs across 29 keys × 10 themes via [themedGlyphs.ts](./client/src/assets/icons/themedGlyphs.ts) + theme-aware [NodeIcon.tsx](./client/src/assets/icons/NodeIcon.tsx)), **per-theme canvas-grid + custom cursors** via `--canvas-grid` / `--cursor-default` slots, **decorative HTML primitives** (`<SvgFilterDefs>` mounting `#ink-blot` / `#noise` / `#crt` filter IDs at app root, `<DropCap>` wrapper for Renaissance ornament rule), 9-event WebAudio sound system (10 packs via `--sound-pack` token + `useSound()` hook + global hover delegate + sonner toast monkey-patch + `withSound()` HOC + `Sounds.unlock()` gesture-unlock for AudioContext autoplay-policy compliance), `@media (prefers-reduced-motion: reduce)` accessibility, 30 ms throttle on `type` / `hover`, migration recipe, anti-patterns. Read this before adding a new theme, migrating a component to the new contract, or adding a canvas-node component. |
| **[Schema Source of Truth RFC](./docs-internal/schema_source_of_truth_rfc.md)** | Backend is SSOT for node schemas, visual metadata, handlers, palette metadata, icons. Plugin pattern: one `BaseNode` subclass in `server/nodes/<group>/<name>.py`. Wire format: `asset:<key>` / `<lib>:<brand>` / URL / emoji. Endpoint: `/api/schemas/nodes/{type}/spec.json`. 124 pytest invariants lock the contract. |
| **[Plugin System (Wave 11)](./docs-internal/plugin_system.md)** | Class-based plugin-first architecture. `BaseNode` / `ActionNode` / `TriggerNode` / `ToolNode` + `@Operation` decorator. Pydantic `Params`/`Output`. Declarative `Routing` DSL + `Connection` facade (Nango pattern). 18 `Credential` subclasses live in each node folder's `_credentials.py` (or inline for single-use). `TaskQueue` constants route to Temporal worker pools. 111 plugins live across 9 queues; handler bodies fully inlined (`services/handlers/` shrank 12.8K → 1.1K LOC across 16 → 4 files; only cross-cutting orchestration remains: `tools.py` AI-tool dispatch + agent delegation, `google_auth.py`, `triggers.py`). **Wave 11.H added "self-contained plugin folders"** — five generic registries (`ws_handler_registry`, `event_waiter.{register_filter_builder,register_trigger_precheck}`, `status_broadcaster.register_service_refresh`, `node_output_schemas.register_output_schema`) so rich plugins like telegram own their entire surface area without core-services edits. |
| **[Nodes Cookbook](./server/nodes/README.md)** | 5-minute recipe + folder map + shared helpers (`_base.py` / `_inline.py` per domain) + shared credentials + **self-contained plugin folder pattern (telegram reference)** + contract invariants + common pitfalls. Lives next to the plugin files. |
diff --git a/client/src/App.tsx b/client/src/App.tsx
index f0ffc8ae..6ddaa343 100644
--- a/client/src/App.tsx
+++ b/client/src/App.tsx
@@ -1,6 +1,7 @@
import React, { useEffect } from 'react';
import Dashboard from './Dashboard';
import ProtectedRoute from './components/auth/ProtectedRoute';
+import SvgFilterDefs from './components/SvgFilterDefs';
import { useTheme } from './contexts/ThemeContext';
import { Toaster } from '@/components/ui/sonner';
@@ -18,6 +19,7 @@ const App: React.FC = () => {
return (
<>
+ <SvgFilterDefs />
<ProtectedRoute>
<div className="flex h-screen w-screen">
<Dashboard />
diff --git a/client/src/assets/icons/NodeIcon.tsx b/client/src/assets/icons/NodeIcon.tsx
index ed12582f..df9e2efc 100644
--- a/client/src/assets/icons/NodeIcon.tsx
+++ b/client/src/assets/icons/NodeIcon.tsx
@@ -27,6 +27,8 @@ import * as React from 'react';
import { cn } from '@/lib/utils';
import { resolveIcon, resolveLibraryIcon, isImageIcon } from '.';
+import { useTheme } from '../../contexts/ThemeContext';
+import { THEMED_GLYPHS, ICON_KEYS, type IconKey } from './themedGlyphs';
export interface NodeIconProps {
/** Backend-declared icon string. May be undefined while the spec
@@ -44,7 +46,37 @@ export const NodeIcon: React.FC<NodeIconProps> = ({
className,
fallback = null,
}) => {
+ const { theme } = useTheme();
let inner: React.ReactNode;
+
+ // 1. Per-theme glyph override. Activates only when the icon prop is one
+ // of the conceptual `IconKey`s (`agent`, `trigger`, `tool`, …) AND
+ // the active theme declares an entry for it. Anything else (URLs,
+ // `asset:foo`, `lobehub:Brand`, `lucide:Bot`, emoji) skips this
+ // branch and falls through to the existing dispatch chain below.
+ // The SVG strings come from `themedGlyphs.ts` — author-trusted
+ // markup committed to the repo, never user input — so injecting
+ // via `dangerouslySetInnerHTML` is safe here. Do not extend this
+ // branch with values built from runtime input.
+ if (icon && ICON_KEYS.has(icon as IconKey)) {
+ const themedSvg = THEMED_GLYPHS[theme]?.[icon as IconKey];
+ if (themedSvg) {
+ // SAFE: `themedSvg` is an author-trusted constant from
+ // `themedGlyphs.ts` — committed-to-repo markup, never user input.
+ // The repo's ESLint config does not enable `react/no-danger`, so
+ // no eslint-disable is needed; this comment documents the trust
+ // boundary so future reviewers don't second-guess it.
+ return (
+ <span
+ className={cn('inline-flex items-center justify-center', className)}
+ dangerouslySetInnerHTML={{ __html: themedSvg }}
+ />
+ );
+ }
+ // No entry for this theme/key — fall through to the default chain so
+ // the consumer's existing icon (lucide / asset / emoji) still renders.
+ }
+
const LibIcon = resolveLibraryIcon(icon);
if (LibIcon) {
// LibIcon is a runtime-resolved component reference; using it as a JSX
diff --git a/client/src/assets/icons/themedGlyphs.ts b/client/src/assets/icons/themedGlyphs.ts
new file mode 100644
index 00000000..4f057fcf
--- /dev/null
+++ b/client/src/assets/icons/themedGlyphs.ts
@@ -0,0 +1,404 @@
+/**
+ * themedGlyphs — per-theme SVG glyph set ported from
+ * `design_handoff_machinaos_themes/app/icons.js`.
+ *
+ * Ten themes (renaissance, cyber, greek, edo, steampunk, atomic,
+ * wasteland, rot, plague, surveillance) declare their own glyph
+ * language for the same 29 conceptual keys (agent, trigger, tool,
+ * memory, output, send, file, folder, settings, credentials, run,
+ * save, stop, plus, close, search, chevron, check, warning, error,
+ * info, sidebar, upload, download, copy, moon, deploy, grid, shield).
+ *
+ * Each value is a complete `<svg>` string (the upstream `_wrap`
+ * function has been baked in per theme). The renaissance wrap adds
+ * a heraldic shield cartouche behind the inner glyph; the cyber
+ * wrap adds a `drop-shadow` filter for the neon glow; the rest use
+ * a plain 32x32 viewBox.
+ *
+ * `width="100%" height="100%"` lets the SVG fill the wrapper that
+ * `<NodeIcon>` puts around it, so Tailwind sizing classes on the
+ * wrapper (`h-6 w-6`, etc.) stay authoritative.
+ *
+ * Themes that omit a key (`Partial<Record<IconKey, string>>`) fall
+ * through to the existing `<NodeIcon>` dispatch (lucide / lobehub /
+ * asset / emoji).
+ *
+ * SECURITY: every value here is author-trusted markup committed to
+ * the repo, never user input. `<NodeIcon>` injects via
+ * `dangerouslySetInnerHTML`; that's safe for this constant set
+ * because nothing in this file is reachable from network or user
+ * state. Do NOT extend `THEMED_GLYPHS` with values built from
+ * runtime input.
+ */
+
+import type { ThemeName } from '../../contexts/ThemeContext';
+
+/** The 29 conceptual icon keys. Any of these may be passed as the
+ * `icon` prop to `<NodeIcon>` to opt into per-theme glyph dispatch. */
+export type IconKey =
+ | 'agent' | 'trigger' | 'tool' | 'memory' | 'output' | 'send'
+ | 'file' | 'folder' | 'settings' | 'credentials'
+ | 'run' | 'save' | 'stop'
+ | 'plus' | 'close' | 'search' | 'chevron' | 'check'
+ | 'warning' | 'error' | 'info'
+ | 'sidebar' | 'upload' | 'download' | 'copy'
+ | 'moon' | 'deploy' | 'grid' | 'shield';
+
+/** Set of all valid `IconKey` strings, exposed for fast `.has()`
+ * membership checks at the resolver call site. */
+export const ICON_KEYS: ReadonlySet<IconKey> = new Set<IconKey>([
+ 'agent', 'trigger', 'tool', 'memory', 'output', 'send',
+ 'file', 'folder', 'settings', 'credentials',
+ 'run', 'save', 'stop',
+ 'plus', 'close', 'search', 'chevron', 'check',
+ 'warning', 'error', 'info',
+ 'sidebar', 'upload', 'download', 'copy',
+ 'moon', 'deploy', 'grid', 'shield',
+]);
+
+/** Outer wrappers, baked into each entry below. Kept here as a
+ * reference for future theme additions:
+ * - renaissance: viewBox + heraldic shield cartouche behind the glyph.
+ * - cyber: viewBox + `drop-shadow(currentColor)` filter (neon glow).
+ * - all others: plain `viewBox="0 0 32 32" fill="none"`.
+ */
+
+const SVG_OPEN = '<svg viewBox="0 0 32 32" fill="none" width="100%" height="100%" xmlns="http://www.w3.org/2000/svg">';
+const SVG_OPEN_CYBER = '<svg viewBox="0 0 32 32" fill="none" width="100%" height="100%" xmlns="http://www.w3.org/2000/svg" style="filter:drop-shadow(0 0 3px currentColor)">';
+const RENAISSANCE_CARTOUCHE = '<path d="M4 4 H28 V22 Q28 28, 16 30 Q4 28, 4 22 Z" fill="#fbf3dc" stroke="#5a3a14" stroke-width="1.5"/><path d="M5 5 H27 V22 Q27 27, 16 29 Q5 27, 5 22 Z" fill="none" stroke="#d4a030" stroke-width="0.8"/>';
+
+const wrap = (inner: string): string => `${SVG_OPEN}${inner}</svg>`;
+const wrapCyber = (inner: string): string => `${SVG_OPEN_CYBER}${inner}</svg>`;
+const wrapRenaissance = (inner: string): string => `${SVG_OPEN}${RENAISSANCE_CARTOUCHE}${inner}</svg>`;
+
+export const THEMED_GLYPHS: Partial<Record<ThemeName, Partial<Record<IconKey, string>>>> = {
+ // ─────────── Renaissance — illuminated heraldic ───────────
+ renaissance: {
+ agent: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030" stroke-linejoin="round"><circle cx="16" cy="13" r="4"/><path d="M9 22 Q16 17, 23 22 L23 25 Q16 27, 9 25 Z"/><path d="M14 12 L13 9 M18 12 L19 9" stroke-width="1"/></g>`),
+ trigger: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M16 8 L12 18 L16 18 L14 24 L20 14 L16 14 Z"/></g>`),
+ tool: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M10 22 L18 14 M22 12 L24 14 M22 12 L20 10 M22 12 Q26 8, 20 8 L18 10 Z"/><circle cx="11" cy="22" r="1.5" fill="#5a3a14"/></g>`),
+ memory: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#fbf3dc"><rect x="9" y="10" width="14" height="14"/><path d="M9 14 L23 14 M9 18 L23 18 M13 10 L13 24 M19 10 L19 24" stroke-width="0.8"/></g>`),
+ output: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M9 16 L21 16 M17 12 L21 16 L17 20"/></g>`),
+ send: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M9 22 L24 14 L11 13 L13 17 L9 22 Z"/></g>`),
+ file: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#fbf3dc"><path d="M11 9 L19 9 L23 13 L23 24 L11 24 Z"/><path d="M19 9 L19 13 L23 13" fill="#d4a030"/></g>`),
+ folder: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M9 12 L13 12 L15 14 L23 14 L23 23 L9 23 Z"/></g>`),
+ settings: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><circle cx="16" cy="16" r="3"/><path d="M16 9 L16 12 M16 20 L16 23 M9 16 L12 16 M20 16 L23 16 M11 11 L13 13 M19 19 L21 21 M11 21 L13 19 M19 13 L21 11"/></g>`),
+ credentials: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><circle cx="14" cy="16" r="4"/><path d="M18 16 L24 16 L24 18 M22 16 L22 19"/></g>`),
+ run: wrapRenaissance(`<g stroke="#2a5a18" stroke-width="1.4" fill="#4a8230"><path d="M12 10 L22 16 L12 22 Z"/></g>`),
+ save: wrapRenaissance(`<g stroke="#5a0a08" stroke-width="1.2" fill="#8a1410"><circle cx="16" cy="16" r="6"/><path d="M14 14 L18 18 M18 14 L14 18" stroke="#fbf3dc" stroke-width="1"/></g>`),
+ stop: wrapRenaissance(`<g stroke="#5a1a08" stroke-width="1.4" fill="#8a3a14"><rect x="11" y="11" width="10" height="10"/></g>`),
+ plus: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="2"><path d="M16 10 L16 22 M10 16 L22 16"/></g>`),
+ close: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="2"><path d="M11 11 L21 21 M21 11 L11 21"/></g>`),
+ search: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="none"><circle cx="14" cy="14" r="4"/><path d="M17 17 L22 22"/></g>`),
+ chevron: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.6" fill="none"><path d="M13 12 L19 16 L13 20"/></g>`),
+ check: wrapRenaissance(`<g stroke="#2a5a18" stroke-width="2" fill="none"><path d="M10 16 L14 20 L22 12"/></g>`),
+ warning: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M16 9 L24 22 L8 22 Z"/><path d="M16 14 L16 18 M16 20 L16 20.5" stroke="#5a0a08" stroke-width="1.6"/></g>`),
+ error: wrapRenaissance(`<g stroke="#5a0a08" stroke-width="1.4" fill="#8a1410"><circle cx="16" cy="16" r="6"/><path d="M13 13 L19 19 M19 13 L13 19" stroke="#fbf3dc" stroke-width="1.4"/></g>`),
+ info: wrapRenaissance(`<g stroke="#1a3a5a" stroke-width="1.4" fill="#fbf3dc"><circle cx="16" cy="16" r="6"/><path d="M16 14 L16 19 M16 12 L16 12.5" stroke="#1a3a5a" stroke-width="1.6"/></g>`),
+ sidebar: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#fbf3dc"><rect x="7" y="8" width="18" height="16"/><path d="M13 8 L13 24" stroke-width="1.4"/><rect x="8" y="9" width="4" height="14" fill="#d4a030" stroke="none"/></g>`),
+ upload: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M16 22 L16 10 M11 15 L16 10 L21 15"/><path d="M9 22 L23 22"/></g>`),
+ download: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M16 10 L16 22 M11 17 L16 22 L21 17"/><path d="M9 10 L23 10"/></g>`),
+ copy: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#fbf3dc"><rect x="11" y="11" width="11" height="13"/><path d="M14 11 L14 8 L25 8 L25 21 L22 21" fill="#d4a030"/></g>`),
+ moon: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M22 18 Q22 23, 17 23 Q11 23, 11 16 Q11 10, 17 10 Q14 13, 14 16 Q14 20, 18 20 Q21 20, 22 18 Z"/><circle cx="22" cy="11" r="0.8" fill="#5a3a14"/><circle cx="24" cy="14" r="0.6" fill="#5a3a14"/></g>`),
+ deploy: wrapRenaissance(`<g stroke="#2a5a18" stroke-width="1.4" fill="#4a8230"><path d="M16 8 L20 14 L20 20 L18 22 L18 25 L14 25 L14 22 L12 20 L12 14 Z"/><circle cx="16" cy="14" r="1.5" fill="#fbf3dc" stroke="none"/><path d="M12 22 L8 26 M20 22 L24 26" stroke-width="1"/></g>`),
+ grid: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><rect x="9" y="9" width="6" height="6"/><rect x="17" y="9" width="6" height="6"/><rect x="9" y="17" width="6" height="6"/><rect x="17" y="17" width="6" height="6"/></g>`),
+ shield: wrapRenaissance(`<g stroke="#5a3a14" stroke-width="1.4" fill="#d4a030"><path d="M16 8 L23 11 L23 17 Q23 22, 16 25 Q9 22, 9 17 L9 11 Z"/><path d="M13 16 L15 18 L19 14" stroke="#5a0a08" stroke-width="1.6" fill="none"/></g>`),
+ },
+
+ // ─────────── Cyber — wireframe / glitch ───────────
+ cyber: {
+ agent: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="9" y="6" width="14" height="20"/><rect x="12" y="11" width="2" height="2" fill="currentColor"/><rect x="18" y="11" width="2" height="2" fill="currentColor"/><path d="M12 18 L20 18 M14 22 L18 22"/><path d="M16 6 L16 4 M16 26 L16 28" stroke-dasharray="1 1"/></g>`),
+ trigger: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M16 4 L11 16 L16 16 L13 28 L21 14 L16 14 Z" fill="currentColor" fill-opacity="0.3"/></g>`),
+ tool: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="6" y="14" width="20" height="4"/><path d="M10 14 L10 12 L14 12 L14 14 M18 18 L18 20 L22 20 L22 18"/></g>`),
+ memory: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="7" y="9" width="18" height="14"/><path d="M7 13 L25 13 M7 17 L25 17 M7 21 L25 21 M11 9 L11 23 M16 9 L16 23 M21 9 L21 23"/></g>`),
+ output: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><path d="M6 16 L24 16 M18 10 L24 16 L18 22"/></g>`),
+ send: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M5 16 L27 6 L20 27 L17 18 L8 16 Z" fill="currentColor" fill-opacity="0.2"/></g>`),
+ file: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M9 4 L19 4 L24 9 L24 28 L9 28 Z"/><path d="M19 4 L19 9 L24 9"/><path d="M12 14 L21 14 M12 18 L21 18 M12 22 L17 22"/></g>`),
+ folder: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M5 10 L13 10 L15 12 L27 12 L27 24 L5 24 Z"/></g>`),
+ settings: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><circle cx="16" cy="16" r="3"/><circle cx="16" cy="16" r="8"/><path d="M16 4 L16 8 M16 24 L16 28 M4 16 L8 16 M24 16 L28 16"/></g>`),
+ credentials: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><circle cx="12" cy="16" r="4"/><path d="M16 16 L28 16 L28 19 M24 16 L24 20 M20 16 L20 18"/></g>`),
+ run: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="currentColor" fill-opacity="0.4"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="6" y="6" width="20" height="20"/><rect x="10" y="6" width="12" height="6" fill="currentColor" fill-opacity="0.3"/><rect x="11" y="18" width="10" height="8"/></g>`),
+ stop: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="currentColor" fill-opacity="0.4"><rect x="9" y="9" width="14" height="14"/></g>`),
+ plus: wrapCyber(`<g stroke="currentColor" stroke-width="1.6"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrapCyber(`<g stroke="currentColor" stroke-width="1.6"><path d="M7 7 L25 25 M25 7 L7 25"/></g>`),
+ search: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><circle cx="14" cy="14" r="6"/><path d="M19 19 L26 26"/></g>`),
+ chevron: wrapCyber(`<g stroke="currentColor" stroke-width="1.6" fill="none"><path d="M11 8 L21 16 L11 24"/></g>`),
+ check: wrapCyber(`<g stroke="currentColor" stroke-width="1.8" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><path d="M16 4 L28 26 L4 26 Z"/><path d="M16 12 L16 20 M16 23 L16 24" stroke-width="1.8"/></g>`),
+ error: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="10"/><path d="M11 11 L21 21 M21 11 L11 21" stroke-width="1.8"/></g>`),
+ info: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="10"/><path d="M16 14 L16 22 M16 10 L16 11" stroke-width="1.8"/></g>`),
+ sidebar: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/><rect x="6" y="7" width="5" height="18" fill="currentColor" fill-opacity="0.25"/></g>`),
+ upload: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/><path d="M6 26 L26 26"/></g>`),
+ download: wrapCyber(`<g stroke="currentColor" stroke-width="1.4" fill="none"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/><path d="M6 6 L26 6"/></g>`),
+ copy: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M16 4 L22 12 L22 22 L18 26 L14 26 L10 22 L10 12 Z"/><circle cx="16" cy="13" r="2.5" fill="currentColor" fill-opacity="0.4"/><path d="M10 22 L4 28 M22 22 L28 28" stroke-dasharray="2 1"/></g>`),
+ grid: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrapCyber(`<g stroke="currentColor" stroke-width="1.2" fill="none"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke-width="1.6"/></g>`),
+ },
+
+ // ─────────── Greek — engraved on marble, lapis-blue glyphs ───────────
+ greek: {
+ agent: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#284b82"><circle cx="16" cy="11" r="3.5" fill="none"/><path d="M9 23 Q9 17, 16 17 Q23 17, 23 23 Z" fill="none"/><path d="M14 9 L13 7 L19 7 L18 9" stroke-width="1"/></g>`),
+ trigger: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M16 5 L8 17 L14 17 L12 27 L24 13 L18 13 L20 5 Z"/></g>`),
+ tool: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="none"><path d="M6 22 L18 10 M22 6 L26 10 M24 8 Q28 4, 22 4 L18 8 Z" fill="#c8a040"/><circle cx="7" cy="22" r="1.5" fill="#284b82"/></g>`),
+ memory: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="none"><rect x="6" y="8" width="20" height="16"/><path d="M6 13 L26 13 M6 18 L26 18 M11 8 L11 24 M21 8 L21 24"/></g>`),
+ output: wrap(`<g stroke="#284b82" stroke-width="1.6" fill="none"><path d="M6 16 L24 16 L20 12 M24 16 L20 20"/></g>`),
+ send: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M5 27 L27 5 L19 13 L13 11 L11 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#faf6e9"><path d="M9 5 L19 5 L23 9 L23 27 L9 27 Z"/><path d="M19 5 L19 9 L23 9" fill="#c8a040"/><path d="M12 14 L20 14 M12 18 L20 18 M12 22 L17 22"/></g>`),
+ folder: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M5 10 L13 10 L15 12 L27 12 L27 24 L5 24 Z"/><path d="M5 14 L27 14"/></g>`),
+ settings: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="3"/><circle cx="16" cy="16" r="8"/><path d="M16 4 L16 8 M16 24 L16 28 M4 16 L8 16 M24 16 L28 16 M8 8 L11 11 M21 21 L24 24 M8 24 L11 21 M21 11 L24 8"/></g>`),
+ credentials: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><circle cx="12" cy="16" r="4" fill="none"/><path d="M16 16 L28 16 L28 19 M24 16 L24 20 M20 16 L20 18"/></g>`),
+ run: wrap(`<g stroke="#6a7a32" stroke-width="1.4" fill="#6a7a32"><path d="M9 7 L25 16 L9 25 Z"/></g>`),
+ save: wrap(`<g stroke="#7a1a18" stroke-width="1.4" fill="#7a1a18"><path d="M16 5 L19 13 L27 13 L21 18 L23 26 L16 22 L9 26 L11 18 L5 13 L13 13 Z"/></g>`),
+ stop: wrap(`<g stroke="#7a1a18" stroke-width="1.4" fill="#7a1a18"><rect x="8" y="8" width="16" height="16"/></g>`),
+ plus: wrap(`<g stroke="#284b82" stroke-width="2.4"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrap(`<g stroke="#284b82" stroke-width="2.4"><path d="M7 7 L25 25 M25 7 L7 25"/></g>`),
+ search: wrap(`<g stroke="#284b82" stroke-width="1.6" fill="none"><circle cx="13" cy="13" r="6"/><path d="M18 18 L26 26"/></g>`),
+ chevron: wrap(`<g stroke="#284b82" stroke-width="2" fill="none"><path d="M11 8 L21 16 L11 24"/></g>`),
+ check: wrap(`<g stroke="#6a7a32" stroke-width="2.4" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M16 5 L28 26 L4 26 Z"/><path d="M16 13 L16 20 M16 23 L16 23.5" stroke="#7a1a18" stroke-width="2"/></g>`),
+ error: wrap(`<g stroke="#7a1a18" stroke-width="1.4" fill="#7a1a18"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke="#faf6e9" stroke-width="2"/></g>`),
+ info: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#284b82"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke="#faf6e9" stroke-width="2"/></g>`),
+ sidebar: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#faf6e9"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/><rect x="6" y="7" width="5" height="18" fill="#c8a040" stroke="none"/></g>`),
+ upload: wrap(`<g stroke="#284b82" stroke-width="1.6" fill="none"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/><path d="M6 27 L26 27"/></g>`),
+ download: wrap(`<g stroke="#284b82" stroke-width="1.6" fill="none"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/><path d="M6 5 L26 5"/></g>`),
+ copy: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#faf6e9"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20" fill="#c8a040"/></g>`),
+ moon: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M16 4 L23 9 L23 18 L19 24 L13 24 L9 18 L9 9 Z"/><circle cx="16" cy="13" r="2.5" fill="#284b82" stroke="none"/></g>`),
+ grid: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#284b82" stroke-width="1.4" fill="#c8a040"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke="#7a1a18" stroke-width="1.8" fill="none"/></g>`),
+ },
+
+ // ─────────── Edo — single ink-brush stroke, vermillion seal ───────────
+ edo: {
+ agent: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none" stroke-linecap="round"><circle cx="16" cy="11" r="3.5"/><path d="M9 24 Q9 18, 16 18 Q23 18, 23 24"/></g>`),
+ trigger: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M17 4 L10 17 L15 17 L13 28 L22 14 L17 14 Z" fill="#b41e1e" fill-opacity="0.15"/></g>`),
+ tool: wrap(`<g stroke="#1a1410" stroke-width="1.8" fill="none" stroke-linecap="round"><path d="M6 24 L20 10 M22 8 L24 10 M22 8 Q26 4, 22 4 L20 6"/></g>`),
+ memory: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><rect x="6" y="9" width="20" height="14"/><path d="M6 13 L26 13 M6 18 L26 18 M13 9 L13 23 M19 9 L19 23"/></g>`),
+ output: wrap(`<g stroke="#1a1410" stroke-width="1.8" fill="none" stroke-linecap="round"><path d="M5 16 L25 16 L20 11 M25 16 L20 21"/></g>`),
+ send: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#b41e1e" stroke-linejoin="round"><path d="M5 27 L27 5 L17 13 L13 11 L13 17 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><path d="M19 5 L19 10 L24 10"/></g>`),
+ folder: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/></g>`),
+ settings: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><circle cx="16" cy="16" r="3"/><path d="M16 5 L16 9 M16 23 L16 27 M5 16 L9 16 M23 16 L27 16 M8 8 L11 11 M21 21 L24 24 M8 24 L11 21 M21 11 L24 8"/></g>`),
+ credentials: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><circle cx="12" cy="16" r="4"/><path d="M16 16 L27 16 L27 19 M24 16 L24 20 M20 16 L20 18"/></g>`),
+ run: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#4a6a3a" stroke-linejoin="round"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g fill="#b41e1e"><rect x="9" y="9" width="14" height="14" transform="rotate(6 16 16)"/></g>`),
+ stop: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#1a1410"><rect x="9" y="9" width="14" height="14"/></g>`),
+ plus: wrap(`<g stroke="#1a1410" stroke-width="2" stroke-linecap="round"><path d="M16 7 L16 25 M7 16 L25 16"/></g>`),
+ close: wrap(`<g stroke="#1a1410" stroke-width="2" stroke-linecap="round"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none" stroke-linecap="round"><circle cx="13" cy="13" r="6"/><path d="M18 18 L25 25"/></g>`),
+ chevron: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none" stroke-linecap="round"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#4a6a3a" stroke-width="2.4" fill="none" stroke-linecap="round"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#c89832" stroke-linejoin="round"><path d="M16 5 L27 25 L5 25 Z"/><path d="M16 13 L16 20 M16 22.5 L16 23" stroke="#1a1410" stroke-width="2"/></g>`),
+ error: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#b41e1e"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke="#fdf8ea" stroke-width="2"/></g>`),
+ info: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke-width="2"/></g>`),
+ sidebar: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/></g>`),
+ upload: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none" stroke-linecap="round"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/></g>`),
+ download: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none" stroke-linecap="round"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/></g>`),
+ copy: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none" stroke-linecap="round"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><path d="M16 5 L22 11 L22 22 L18 26 L14 26 L10 22 L10 11 Z"/><circle cx="16" cy="13" r="2"/></g>`),
+ grid: wrap(`<g stroke="#1a1410" stroke-width="1.4" fill="none"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="none"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/></g>`),
+ },
+
+ // ─────────── Steampunk — riveted brass plates with bolts ───────────
+ steampunk: {
+ agent: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><circle cx="16" cy="11" r="3.5"/><path d="M9 24 Q9 18, 16 18 Q23 18, 23 24 Z"/><circle cx="16" cy="11" r="1" fill="#4a2818"/></g>`),
+ trigger: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><circle cx="16" cy="16" r="9"/><path d="M16 8 L16 16 L20 19" stroke-width="1.6"/><circle cx="16" cy="16" r="1.5" fill="#4a2818"/></g>`),
+ tool: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><circle cx="16" cy="16" r="6"/><path d="M16 8 L16 12 M16 20 L16 24 M8 16 L12 16 M20 16 L24 16 M11 11 L13 13 M19 19 L21 21 M11 21 L13 19 M19 13 L21 11"/><circle cx="16" cy="16" r="2" fill="#b8602a"/></g>`),
+ memory: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#b8602a"><rect x="6" y="9" width="20" height="14"/><path d="M6 14 L26 14 M6 19 L26 19" stroke="#d8a848"/><circle cx="9" cy="11" r="0.8" fill="#4a2818"/><circle cx="23" cy="11" r="0.8" fill="#4a2818"/><circle cx="9" cy="21" r="0.8" fill="#4a2818"/><circle cx="23" cy="21" r="0.8" fill="#4a2818"/></g>`),
+ output: wrap(`<g stroke="#4a2818" stroke-width="1.6" fill="#d8a848"><path d="M5 16 L23 16 L19 12 L19 20 Z"/></g>`),
+ send: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M5 27 L27 5 L19 13 L13 11 L13 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><circle cx="11" cy="7" r="0.8" fill="#4a2818"/><circle cx="22" cy="25" r="0.8" fill="#4a2818"/></g>`),
+ folder: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#b8602a"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/><circle cx="7" cy="22" r="0.8" fill="#4a2818"/><circle cx="25" cy="22" r="0.8" fill="#4a2818"/></g>`),
+ settings: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M16 4 L18 8 L22 6 L22 11 L26 13 L24 16 L26 19 L22 21 L22 26 L18 24 L16 28 L14 24 L10 26 L10 21 L6 19 L8 16 L6 13 L10 11 L10 6 L14 8 Z"/><circle cx="16" cy="16" r="3" fill="#b8602a"/></g>`),
+ credentials: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><circle cx="12" cy="16" r="4"/><circle cx="12" cy="16" r="1.5" fill="#4a2818"/><path d="M16 16 L27 16 L27 20 M23 16 L23 20 M19 16 L19 18"/></g>`),
+ run: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#6a8a3a"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><circle cx="16" cy="16" r="9"/><path d="M16 7 L16 25 M7 16 L25 16" stroke-width="1"/><circle cx="16" cy="16" r="3" fill="#b8602a"/></g>`),
+ stop: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#8a3a1a"><rect x="8" y="8" width="16" height="16"/><circle cx="10" cy="10" r="0.8" fill="#4a2818"/><circle cx="22" cy="10" r="0.8" fill="#4a2818"/><circle cx="10" cy="22" r="0.8" fill="#4a2818"/><circle cx="22" cy="22" r="0.8" fill="#4a2818"/></g>`),
+ plus: wrap(`<g stroke="#4a2818" stroke-width="2.4"><path d="M16 7 L16 25 M7 16 L25 16"/></g>`),
+ close: wrap(`<g stroke="#4a2818" stroke-width="2.4"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#4a2818" stroke-width="1.5" fill="none"><circle cx="13" cy="13" r="6"/><path d="M18 18 L25 25" stroke-width="2"/></g>`),
+ chevron: wrap(`<g stroke="#4a2818" stroke-width="2" fill="none"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#6a8a3a" stroke-width="2.4" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M16 5 L27 25 L5 25 Z"/><path d="M16 13 L16 20" stroke-width="2"/><circle cx="16" cy="22.5" r="0.8" fill="#4a2818"/></g>`),
+ error: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#8a3a1a"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke="#d8a848" stroke-width="2"/></g>`),
+ info: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#4a8aa8"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke="#d8a848" stroke-width="2"/></g>`),
+ sidebar: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/><circle cx="7" cy="8" r="0.6" fill="#4a2818"/><circle cx="25" cy="24" r="0.6" fill="#4a2818"/></g>`),
+ upload: wrap(`<g stroke="#4a2818" stroke-width="1.6" fill="#d8a848"><path d="M16 23 L16 8 L11 13 M16 8 L21 13"/></g>`),
+ download: wrap(`<g stroke="#4a2818" stroke-width="1.6" fill="#d8a848"><path d="M16 8 L16 23 L11 18 M16 23 L21 18"/></g>`),
+ copy: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M16 4 L23 11 L23 22 L18 27 L14 27 L9 22 L9 11 Z"/><circle cx="16" cy="14" r="3" fill="#b8602a"/></g>`),
+ grid: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#4a2818" stroke-width="1.3" fill="#d8a848"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke="#8a3a1a" stroke-width="2"/></g>`),
+ },
+
+ // ─────────── Atomic Modern — boomerang & starburst, Eames cartoon ───────────
+ atomic: {
+ agent: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26" stroke-linejoin="round"><circle cx="16" cy="11" r="4"/><path d="M8 25 Q8 18, 16 18 Q24 18, 24 25"/></g>`),
+ trigger: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838" stroke-linejoin="round"><path d="M16 3 L11 16 L16 16 L13 29 L23 13 L17 13 L21 3 Z"/></g>`),
+ tool: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0" stroke-linejoin="round"><path d="M5 25 L18 12 M22 8 L26 12 M22 8 Q28 2, 22 4 L18 8 Z"/></g>`),
+ memory: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0"><rect x="5" y="9" width="22" height="14" rx="3"/><path d="M5 14 L27 14 M5 19 L27 19" stroke="#2a3a4a"/></g>`),
+ output: wrap(`<g stroke="#2a3a4a" stroke-width="2.4" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M5 16 L23 16 L18 11 M23 16 L18 21"/></g>`),
+ send: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26" stroke-linejoin="round"><path d="M4 28 L28 4 L18 14 L12 11 L11 19 Z"/></g>`),
+ file: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#ffffff" stroke-linejoin="round"><path d="M9 4 L20 4 L24 8 L24 28 L9 28 Z"/><path d="M20 4 L20 8 L24 8" fill="#d8a838"/></g>`),
+ folder: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838" stroke-linejoin="round"><path d="M4 11 L13 11 L15 13 L28 13 L28 25 L4 25 Z"/></g>`),
+ settings: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0"><circle cx="16" cy="16" r="4"/><path d="M16 3 L16 8 M16 24 L16 29 M3 16 L8 16 M24 16 L29 16" stroke-linecap="round"/></g>`),
+ credentials: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838"><circle cx="12" cy="16" r="4"/><path d="M16 16 L28 16 L28 20 M23 16 L23 21 M19 16 L19 19"/></g>`),
+ run: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#5a8a5a" stroke-linejoin="round"><path d="M9 5 L26 16 L9 27 Z"/></g>`),
+ save: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26" stroke-linejoin="round"><path d="M16 4 L20 13 L29 14 L22 20 L24 29 L16 25 L8 29 L10 20 L3 14 L12 13 Z"/></g>`),
+ stop: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26"><rect x="7" y="7" width="18" height="18" rx="2"/></g>`),
+ plus: wrap(`<g stroke="#2a3a4a" stroke-width="3" stroke-linecap="round"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrap(`<g stroke="#2a3a4a" stroke-width="3" stroke-linecap="round"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#2a3a4a" stroke-width="2.4" fill="#d8a838" stroke-linecap="round"><circle cx="13" cy="13" r="6"/><path d="M18 18 L26 26"/></g>`),
+ chevron: wrap(`<g stroke="#2a3a4a" stroke-width="2.4" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#5a8a5a" stroke-width="3" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838" stroke-linejoin="round"><path d="M16 4 L28 26 L4 26 Z"/><path d="M16 13 L16 20" stroke-linecap="round"/></g>`),
+ error: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26"><circle cx="16" cy="16" r="10"/><path d="M11 11 L21 21 M21 11 L11 21" stroke="#ffffff" stroke-linecap="round"/></g>`),
+ info: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0"><circle cx="16" cy="16" r="10"/><path d="M16 14 L16 22 M16 10 L16 11" stroke="#ffffff" stroke-linecap="round"/></g>`),
+ sidebar: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0"><rect x="5" y="6" width="22" height="20" rx="2"/><path d="M12 6 L12 26"/></g>`),
+ upload: wrap(`<g stroke="#2a3a4a" stroke-width="2.4" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M16 24 L16 7 M9 14 L16 7 L23 14"/></g>`),
+ download: wrap(`<g stroke="#2a3a4a" stroke-width="2.4" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M16 8 L16 25 M9 18 L16 25 L23 18"/></g>`),
+ copy: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838" stroke-linejoin="round"><rect x="8" y="8" width="13" height="16" rx="1"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838" stroke-linejoin="round"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#e85a26" stroke-linejoin="round"><path d="M16 3 L23 11 L23 23 L18 28 L14 28 L9 23 L9 11 Z"/><circle cx="16" cy="13" r="2.5" fill="#ffffff"/></g>`),
+ grid: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#d8a838"><rect x="6" y="6" width="8" height="8" rx="1"/><rect x="18" y="6" width="8" height="8" rx="1"/><rect x="6" y="18" width="8" height="8" rx="1"/><rect x="18" y="18" width="8" height="8" rx="1"/></g>`),
+ shield: wrap(`<g stroke="#2a3a4a" stroke-width="2" fill="#3a9aa0" stroke-linejoin="round"><path d="M16 3 L26 7 L26 16 Q26 24, 16 29 Q6 24, 6 16 L6 7 Z"/><path d="M11 16 L14 19 L21 12" stroke="#ffffff" stroke-linecap="round"/></g>`),
+ },
+
+ // ─────────── Wasteland — stenciled / spray-painted, jagged ───────────
+ wasteland: {
+ agent: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linejoin="round"><path d="M12 7 L20 7 L20 14 L23 14 L23 24 L9 24 L9 14 L12 14 Z"/><rect x="13" y="10" width="2" height="2" fill="#e88a28"/><rect x="17" y="10" width="2" height="2" fill="#e88a28"/></g>`),
+ trigger: wrap(`<g stroke="#c8d038" stroke-width="2" fill="#c8d038" fill-opacity="0.3" stroke-linejoin="round"><path d="M16 4 L9 18 L15 18 L12 28 L23 13 L17 13 L19 4 Z"/></g>`),
+ tool: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linejoin="round"><path d="M5 25 L17 13 M19 11 L21 13 M19 11 Q25 5, 21 7 L17 11 Z"/><path d="M5 25 L7 27"/></g>`),
+ memory: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><rect x="6" y="9" width="20" height="14"/><path d="M6 13 L26 13 M6 18 L26 18 M11 9 L11 23 M21 9 L21 23"/></g>`),
+ output: wrap(`<g stroke="#e88a28" stroke-width="2.4" fill="none" stroke-linecap="square"><path d="M5 16 L24 16 L19 11 M24 16 L19 21"/></g>`),
+ send: wrap(`<g stroke="#e88a28" stroke-width="2" fill="#e88a28" fill-opacity="0.3" stroke-linejoin="round"><path d="M5 27 L27 5 L19 13 L13 11 L13 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linejoin="round"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><path d="M19 5 L19 10 L24 10"/><path d="M12 14 L20 14 M12 18 L20 18 M12 22 L17 22"/></g>`),
+ folder: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linejoin="round"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/></g>`),
+ settings: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><circle cx="16" cy="16" r="3"/><path d="M16 4 L16 9 M16 23 L16 28 M4 16 L9 16 M23 16 L28 16 M8 8 L11 11 M21 21 L24 24 M8 24 L11 21 M21 11 L24 8"/></g>`),
+ credentials: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><circle cx="12" cy="16" r="4"/><path d="M16 16 L27 16 L27 20 M23 16 L23 20"/></g>`),
+ run: wrap(`<g stroke="#8a9028" stroke-width="2" fill="#8a9028" fill-opacity="0.4" stroke-linejoin="round"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g stroke="#c8d038" stroke-width="2" fill="none"><circle cx="16" cy="16" r="9"/><path d="M16 11 L16 16 L19 18" stroke-linecap="square"/></g>`),
+ stop: wrap(`<g stroke="#b8281a" stroke-width="2" fill="#b8281a" fill-opacity="0.4"><rect x="8" y="8" width="16" height="16"/></g>`),
+ plus: wrap(`<g stroke="#e88a28" stroke-width="3" stroke-linecap="square"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrap(`<g stroke="#e88a28" stroke-width="3" stroke-linecap="square"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linecap="square"><circle cx="13" cy="13" r="6"/><path d="M18 18 L25 25"/></g>`),
+ chevron: wrap(`<g stroke="#e88a28" stroke-width="2.4" fill="none" stroke-linecap="square"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#8a9028" stroke-width="3" fill="none" stroke-linecap="square"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#c8d038" stroke-width="2" fill="#c8d038" fill-opacity="0.3"><path d="M16 4 L28 26 L4 26 Z"/><path d="M16 13 L16 20" stroke-linecap="square"/></g>`),
+ error: wrap(`<g stroke="#b8281a" stroke-width="2" fill="#b8281a" fill-opacity="0.4"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke-linecap="square"/></g>`),
+ info: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke-linecap="square"/></g>`),
+ sidebar: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/></g>`),
+ upload: wrap(`<g stroke="#e88a28" stroke-width="2.4" fill="none" stroke-linecap="square"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/></g>`),
+ download: wrap(`<g stroke="#e88a28" stroke-width="2.4" fill="none" stroke-linecap="square"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/></g>`),
+ copy: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none" stroke-linejoin="round"><path d="M16 5 L22 11 L22 22 L18 26 L14 26 L10 22 L10 11 Z"/><circle cx="16" cy="14" r="2.5" fill="#e88a28" fill-opacity="0.4"/></g>`),
+ grid: wrap(`<g stroke="#e88a28" stroke-width="2" fill="none"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#c8d038" stroke-width="2" fill="none"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke-width="2.4" stroke-linecap="square"/></g>`),
+ },
+
+ // ─────────── Rot — bone-pale fragile lines, drips ───────────
+ rot: {
+ agent: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><circle cx="16" cy="11" r="3.5"/><path d="M9 24 Q9 18, 16 18 Q23 18, 23 24"/><path d="M14 13 L14 16 M18 13 L18 16" stroke="#78c878" stroke-width="0.8"/></g>`),
+ trigger: wrap(`<g stroke="#78c878" stroke-width="1.6" fill="none" stroke-linecap="round"><path d="M16 5 L11 17 L16 17 L13 27 L21 14 L16 14 Z" fill="#78c878" fill-opacity="0.2"/></g>`),
+ tool: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><path d="M6 25 L18 13 M22 9 L24 11 M22 9 Q26 5, 22 5 L18 9 Z" fill="#78c878" fill-opacity="0.3"/></g>`),
+ memory: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><rect x="6" y="9" width="20" height="14"/><path d="M6 13 L26 13 M6 18 L26 18 M11 9 L11 23 M21 9 L21 23"/></g>`),
+ output: wrap(`<g stroke="#78c878" stroke-width="1.6" fill="none" stroke-linecap="round"><path d="M5 16 L23 16 L18 11 M23 16 L18 21"/></g>`),
+ send: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="#78c878" fill-opacity="0.2" stroke-linejoin="round"><path d="M5 27 L27 5 L19 13 L13 11 L13 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><path d="M19 5 L19 10 L24 10"/><path d="M12 14 L20 14 M12 18 L20 18 M12 22 L17 22"/></g>`),
+ folder: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/></g>`),
+ settings: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="3"/><path d="M16 4 L16 9 M16 23 L16 28 M4 16 L9 16 M23 16 L28 16 M8 8 L11 11 M21 21 L24 24 M8 24 L11 21 M21 11 L24 8"/></g>`),
+ credentials: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><circle cx="12" cy="16" r="4"/><path d="M16 16 L27 16 L27 20 M23 16 L23 20"/></g>`),
+ run: wrap(`<g stroke="#78c878" stroke-width="1.4" fill="#78c878" fill-opacity="0.4" stroke-linejoin="round"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g stroke="#e8a838" stroke-width="1.4" fill="#e8a838" fill-opacity="0.3"><path d="M16 5 L18 11 L25 11 L19 15 L22 22 L16 18 L10 22 L13 15 L7 11 L14 11 Z"/></g>`),
+ stop: wrap(`<g stroke="#a83838" stroke-width="1.4" fill="#a83838" fill-opacity="0.4"><rect x="9" y="9" width="14" height="14"/></g>`),
+ plus: wrap(`<g stroke="#d8d0b8" stroke-width="2"><path d="M16 7 L16 25 M7 16 L25 16"/></g>`),
+ close: wrap(`<g stroke="#d8d0b8" stroke-width="2"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><circle cx="13" cy="13" r="6"/><path d="M18 18 L25 25"/></g>`),
+ chevron: wrap(`<g stroke="#d8d0b8" stroke-width="1.8" fill="none"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#78c878" stroke-width="2" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#e8a838" stroke-width="1.4" fill="#e8a838" fill-opacity="0.3"><path d="M16 5 L27 25 L5 25 Z"/><path d="M16 13 L16 20"/></g>`),
+ error: wrap(`<g stroke="#a83838" stroke-width="1.4" fill="#a83838" fill-opacity="0.4"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21"/></g>`),
+ info: wrap(`<g stroke="#5898b8" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11"/></g>`),
+ sidebar: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/></g>`),
+ upload: wrap(`<g stroke="#d8d0b8" stroke-width="1.6" fill="none"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/></g>`),
+ download: wrap(`<g stroke="#d8d0b8" stroke-width="1.6" fill="none"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/></g>`),
+ copy: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#e8a838" stroke-width="1.4" fill="#e8a838" fill-opacity="0.2"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#78c878" stroke-width="1.4" fill="none"><path d="M16 5 L22 11 L22 22 L18 26 L14 26 L10 22 L10 11 Z"/><circle cx="16" cy="14" r="2.5" fill="#78c878" fill-opacity="0.3"/></g>`),
+ grid: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#d8d0b8" stroke-width="1.4" fill="none"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke="#78c878" stroke-width="1.8"/></g>`),
+ },
+
+ // ─────────── Plague — woodcut, hatched shadows ───────────
+ plague: {
+ agent: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><circle cx="16" cy="11" r="3.5"/><path d="M9 24 Q9 18, 16 18 Q23 18, 23 24 Z"/><path d="M14 22 L14 24 M16 22 L16 24 M18 22 L18 24" stroke-width="0.8"/></g>`),
+ trigger: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><path d="M16 4 L10 16 L15 16 L12 28 L22 13 L17 13 L20 4 Z"/></g>`),
+ tool: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><path d="M6 25 L18 13 M22 9 L24 11 M22 9 Q26 5, 22 5 L18 9 Z"/></g>`),
+ memory: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><rect x="6" y="9" width="20" height="14"/><path d="M6 13 L26 13 M6 18 L26 18" stroke-width="1"/></g>`),
+ output: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none"><path d="M5 16 L23 16 L18 11 M23 16 L18 21"/></g>`),
+ send: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><path d="M5 27 L27 5 L19 13 L13 11 L13 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><path d="M19 5 L19 10 L24 10"/><path d="M12 14 L20 14 M12 18 L20 18 M12 22 L16 22"/></g>`),
+ folder: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/></g>`),
+ settings: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><circle cx="16" cy="16" r="3"/><circle cx="16" cy="16" r="8"/><path d="M16 4 L16 8 M16 24 L16 28 M4 16 L8 16 M24 16 L28 16"/></g>`),
+ credentials: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><circle cx="12" cy="16" r="4" fill="#efeacf"/><path d="M16 16 L27 16 L27 20 M23 16 L23 20"/></g>`),
+ run: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#5a7028"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><circle cx="16" cy="16" r="8"/><path d="M14 14 L18 14 L18 18 L14 18 Z M12 12 L20 20 M20 12 L12 20" stroke="#efeacf" stroke-width="1.2"/></g>`),
+ stop: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><rect x="8" y="8" width="16" height="16"/></g>`),
+ plus: wrap(`<g stroke="#1a1410" stroke-width="2.4"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrap(`<g stroke="#1a1410" stroke-width="2.4"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#1a1410" stroke-width="1.8" fill="none"><circle cx="13" cy="13" r="6"/><path d="M18 18 L25 25"/></g>`),
+ chevron: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#5a7028" stroke-width="2.4" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#98a838"><path d="M16 4 L28 26 L4 26 Z"/><path d="M16 13 L16 20" stroke-width="2"/><circle cx="16" cy="23" r="0.8" fill="#1a1410"/></g>`),
+ error: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke="#efeacf" stroke-width="2"/></g>`),
+ info: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke-width="2"/></g>`),
+ sidebar: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/></g>`),
+ upload: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/></g>`),
+ download: wrap(`<g stroke="#1a1410" stroke-width="2" fill="none"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/></g>`),
+ copy: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><path d="M16 5 L22 11 L22 22 L18 26 L14 26 L10 22 L10 11 Z"/><circle cx="16" cy="14" r="2.5" fill="#efeacf"/></g>`),
+ grid: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#efeacf"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#1a1410" stroke-width="1.6" fill="#783c28"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke="#efeacf" stroke-width="2"/></g>`),
+ },
+
+ // ─────────── Surveillance — terminal monospace, corner brackets ───────────
+ surveillance: {
+ agent: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="9" y="6" width="14" height="20"/><circle cx="13" cy="12" r="1" fill="#e82626"/><circle cx="19" cy="12" r="1" fill="#c8ccd0"/><path d="M12 18 L20 18 M12 21 L20 21" stroke-width="0.8"/></g>`),
+ trigger: wrap(`<g stroke="#e82626" stroke-width="1.4" fill="#e82626" fill-opacity="0.3"><path d="M16 4 L10 16 L15 16 L12 28 L22 13 L17 13 L20 4 Z"/></g>`),
+ tool: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="6" y="14" width="20" height="4"/><path d="M10 14 L10 12 L14 12 L14 14 M18 18 L18 20 L22 20 L22 18"/></g>`),
+ memory: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="6" y="9" width="20" height="14"/><path d="M6 13 L26 13 M6 17 L26 17 M6 21 L26 21 M11 9 L11 23 M21 9 L21 23"/></g>`),
+ output: wrap(`<g stroke="#6acc6a" stroke-width="1.4" fill="none"><path d="M5 16 L24 16 M19 11 L24 16 L19 21"/></g>`),
+ send: wrap(`<g stroke="#e82626" stroke-width="1.2" fill="#e82626" fill-opacity="0.3"><path d="M5 27 L27 5 L19 13 L13 11 L13 19 L5 27 Z"/></g>`),
+ file: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><path d="M9 5 L19 5 L24 10 L24 27 L9 27 Z"/><path d="M19 5 L19 10 L24 10"/><path d="M12 14 L20 14 M12 18 L20 18 M12 22 L17 22" stroke="#6acc6a"/></g>`),
+ folder: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><path d="M5 11 L13 11 L15 13 L27 13 L27 24 L5 24 Z"/></g>`),
+ settings: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="13" y="13" width="6" height="6"/><path d="M16 4 L16 9 M16 23 L16 28 M4 16 L9 16 M23 16 L28 16 M8 8 L12 12 M20 20 L24 24 M8 24 L12 20 M20 12 L24 8"/></g>`),
+ credentials: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><circle cx="12" cy="16" r="4"/><path d="M16 16 L27 16 L27 20 M23 16 L23 20 M19 16 L19 18"/></g>`),
+ run: wrap(`<g stroke="#6acc6a" stroke-width="1.4" fill="#6acc6a" fill-opacity="0.4"><path d="M10 6 L26 16 L10 26 Z"/></g>`),
+ save: wrap(`<g stroke="#d8a020" stroke-width="1.2" fill="none"><rect x="6" y="6" width="20" height="20"/><rect x="10" y="6" width="12" height="6" fill="#d8a020" fill-opacity="0.3"/><rect x="11" y="18" width="10" height="8"/></g>`),
+ stop: wrap(`<g stroke="#e82626" stroke-width="1.4" fill="#e82626" fill-opacity="0.5"><rect x="9" y="9" width="14" height="14"/></g>`),
+ plus: wrap(`<g stroke="#c8ccd0" stroke-width="1.6" stroke-linecap="square"><path d="M16 6 L16 26 M6 16 L26 16"/></g>`),
+ close: wrap(`<g stroke="#e82626" stroke-width="1.6" stroke-linecap="square"><path d="M8 8 L24 24 M24 8 L8 24"/></g>`),
+ search: wrap(`<g stroke="#c8ccd0" stroke-width="1.4" fill="none"><circle cx="13" cy="13" r="6"/><path d="M18 18 L26 26"/></g>`),
+ chevron: wrap(`<g stroke="#c8ccd0" stroke-width="1.6" fill="none"><path d="M11 9 L20 16 L11 23"/></g>`),
+ check: wrap(`<g stroke="#6acc6a" stroke-width="1.8" fill="none"><path d="M6 16 L13 23 L26 8"/></g>`),
+ warning: wrap(`<g stroke="#d8a020" stroke-width="1.4" fill="none"><path d="M16 4 L28 26 L4 26 Z"/><path d="M16 13 L16 20 M16 23 L16 23.5" stroke-width="1.8"/></g>`),
+ error: wrap(`<g stroke="#e82626" stroke-width="1.4" fill="#e82626" fill-opacity="0.3"><circle cx="16" cy="16" r="9"/><path d="M11 11 L21 21 M21 11 L11 21" stroke-width="1.8"/></g>`),
+ info: wrap(`<g stroke="#5a8cc8" stroke-width="1.4" fill="none"><circle cx="16" cy="16" r="9"/><path d="M16 14 L16 22 M16 10 L16 11" stroke-width="1.8"/></g>`),
+ sidebar: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="5" y="6" width="22" height="20"/><path d="M12 6 L12 26"/><rect x="6" y="7" width="5" height="18" fill="#e82626" fill-opacity="0.3" stroke="none"/></g>`),
+ upload: wrap(`<g stroke="#c8ccd0" stroke-width="1.4" fill="none" stroke-linecap="square"><path d="M16 24 L16 8 M9 15 L16 8 L23 15"/></g>`),
+ download: wrap(`<g stroke="#c8ccd0" stroke-width="1.4" fill="none" stroke-linecap="square"><path d="M16 8 L16 24 M9 17 L16 24 L23 17"/></g>`),
+ copy: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="8" y="8" width="13" height="16"/><path d="M12 4 L25 4 L25 20 L21 20"/></g>`),
+ moon: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><path d="M24 18 Q24 25, 16 25 Q8 25, 8 16 Q8 8, 16 8 Q12 12, 12 16 Q12 22, 18 22 Q22 22, 24 18 Z"/></g>`),
+ deploy: wrap(`<g stroke="#e82626" stroke-width="1.2" fill="none"><path d="M16 4 L22 11 L22 22 L18 26 L14 26 L10 22 L10 11 Z"/><circle cx="16" cy="13" r="2.5" fill="#e82626" fill-opacity="0.4"/></g>`),
+ grid: wrap(`<g stroke="#c8ccd0" stroke-width="1.2" fill="none"><rect x="6" y="6" width="8" height="8"/><rect x="18" y="6" width="8" height="8"/><rect x="6" y="18" width="8" height="8"/><rect x="18" y="18" width="8" height="8"/></g>`),
+ shield: wrap(`<g stroke="#e82626" stroke-width="1.2" fill="none"><path d="M16 4 L26 8 L26 16 Q26 23, 16 28 Q6 23, 6 16 L6 8 Z"/><path d="M11 16 L14 19 L21 12" stroke-width="1.6"/></g>`),
+ },
+};
diff --git a/client/src/components/AIAgentNode.tsx b/client/src/components/AIAgentNode.tsx
index d5424a8c..7ca93243 100644
--- a/client/src/components/AIAgentNode.tsx
+++ b/client/src/components/AIAgentNode.tsx
@@ -1,7 +1,7 @@
import React, { memo, useState, useEffect, useMemo } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import AIAgentExecutionService from '../services/execution/aiAgentExecutionService';
import { useAppTheme } from '../hooks/useAppTheme';
@@ -91,28 +91,6 @@ const AIAgentNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
setSelectedNode({ id, type, data, position: { x: 0, y: 0 } });
};
- const getBorderColor = () => {
- if (isExecuting) {
- if (theme.isDarkMode && phaseConfig) return phaseConfig.color;
- return accentColor;
- }
- if (selected) return theme.colors.focus;
- return theme.colors.border;
- };
-
- const getBoxShadow = () => {
- if (isExecuting) {
- if (theme.isDarkMode && phaseConfig) {
- return `0 0 20px ${phaseConfig.color}80, 0 0 40px ${phaseConfig.color}40`;
- }
- return `0 0 0 3px ${accentColor}80, 0 4px 16px ${accentColor}60`;
- }
- if (selected) {
- return `0 4px 12px ${theme.colors.focusRing}, 0 0 0 1px ${theme.colors.focusRing}`;
- }
- return `0 2px 4px ${theme.colors.shadow}`;
- };
-
const hasRightOutputs = rightOutputs.length > 0;
const hasLeftLabels = hasMainInput || leftInputs.length > 0;
@@ -123,32 +101,26 @@ const AIAgentNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
<div
className={`node node-agent ${selected ? 'selected' : ''}`}
style={{
+ '--node-color': accentColor,
position: 'relative',
padding: theme.spacing.lg,
paddingLeft: hasLeftLabels ? '72px' : theme.spacing.lg,
paddingRight: hasRightOutputs ? '72px' : theme.spacing.lg,
minWidth: `${width}px`,
minHeight: `${height}px`,
- borderRadius: theme.borderRadius.lg,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${accentColor}20 0%, ${theme.colors.backgroundAlt} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${accentColor}08 100%)`,
- border: `2px solid ${getBorderColor()}`,
color: theme.colors.text,
fontSize: theme.fontSize.sm,
fontWeight: theme.fontWeight.medium,
textAlign: 'center',
cursor: 'pointer',
transition: 'all 0.3s ease',
- boxShadow: getBoxShadow(),
overflow: 'visible',
display: 'flex',
flexDirection: 'column',
alignItems: 'center',
justifyContent: 'center',
gap: theme.spacing.sm,
- animation: isExecuting ? 'pulse 1.5s ease-in-out infinite' : 'none',
- }}
+ } as NodeStyle}
>
{/* Main input (left, top area) — shown when the spec declares a main input */}
{hasMainInput && (
diff --git a/client/src/components/GenericNode.tsx b/client/src/components/GenericNode.tsx
index a37e4662..53480894 100644
--- a/client/src/components/GenericNode.tsx
+++ b/client/src/components/GenericNode.tsx
@@ -4,25 +4,24 @@ import { Handle, Position, NodeProps } from 'reactflow';
import { resolveNodeDescription } from '../lib/nodeSpec';
import { NodeIcon } from '../assets/icons';
import { useNodeSpec } from '../lib/nodeSpec';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { INodeInputDefinition, INodeOutputDefinition, NodeConnectionType } from '../types/INodeProperties';
import { useAppStore } from '../store/useAppStore';
-import { useAppTheme } from '../hooks/useAppTheme';
import { useNodeStatus } from '../contexts/WebSocketContext';
import EditableNodeLabel from './ui/EditableNodeLabel';
const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectable, selected }) => {
- const theme = useAppTheme();
const setSelectedNode = useAppStore((s) => s.setSelectedNode);
const setRenamingNodeId = useAppStore((s) => s.setRenamingNodeId);
const updateNodeData = useAppStore((s) => s.updateNodeData);
const isDisabled = data?.disabled === true;
- // Per-id slice subscription so an unrelated node's status update
- // does not re-render this generic node.
- const nodeStatus = useNodeStatus(id);
- const executionStatus = nodeStatus?.status || 'idle';
- const isExecuting = executionStatus === 'executing' || executionStatus === 'waiting';
+ // Per-id slice subscription so an unrelated node's status update does
+ // not re-render this generic node. Wave 21: visual execution state
+ // moved to per-theme CSS via the `.executing` class on the wrapper —
+ // we keep the subscription so future state-driven CSS toggles can
+ // read it without refactoring.
+ useNodeStatus(id);
// Wave 6 Phase 3e: backend NodeSpec -> legacy fallback
const definition = type ? resolveNodeDescription(type) : null;
@@ -119,17 +118,11 @@ const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
<div
className={`node ${selected ? 'selected' : ''}`}
style={{
+ '--node-color': getNodeColor(),
position: 'relative',
padding: '12px 32px 12px 16px',
minWidth: '160px',
minHeight: '60px',
- borderRadius: '12px',
- background: `linear-gradient(135deg, ${getNodeColor()} 0%, ${getBorderColor()} 100%)`,
- border: `2px solid ${isExecuting
- ? (theme.isDarkMode ? theme.dracula.cyan : '#2563eb')
- : selected
- ? '#3b82f6'
- : getBorderColor()}`,
color: 'white',
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: '14px',
@@ -137,19 +130,9 @@ const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
textAlign: 'center',
cursor: 'pointer',
transition: 'all 0.2s ease',
- boxShadow: isExecuting
- ? theme.isDarkMode
- ? `0 4px 12px ${theme.dracula.cyan}66, 0 0 0 3px ${theme.dracula.cyan}4D`
- : `0 0 0 3px rgba(37, 99, 235, 0.5), 0 4px 16px rgba(37, 99, 235, 0.35)`
- : selected
- ? `0 8px 25px ${getNodeColor()}40, 0 0 0 2px ${theme.colors.focus}`
- : theme.isDarkMode
- ? `0 4px 12px ${getNodeColor()}40`
- : `0 2px 8px ${getNodeColor()}25, 0 4px 16px rgba(0, 0, 0, 0.08)`,
overflow: 'visible',
opacity: isDisabled ? 0.5 : 1,
- animation: isExecuting ? 'pulse 1.5s ease-in-out infinite' : 'none',
- }}
+ } as NodeStyle}
>
{/* Disabled Overlay */}
{isDisabled && (
diff --git a/client/src/components/SquareNode.tsx b/client/src/components/SquareNode.tsx
index c7055a5f..7e49780c 100644
--- a/client/src/components/SquareNode.tsx
+++ b/client/src/components/SquareNode.tsx
@@ -1,7 +1,7 @@
import React, { memo, useState, useEffect, useRef, useCallback, useMemo } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { useAppTheme } from '../hooks/useAppTheme';
import EditableNodeLabel from './ui/EditableNodeLabel';
@@ -266,7 +266,9 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
// Renaissance, neon underglow on Cyber, etc.).
<div
className={`sq-node ${selected ? 'selected' : ''}`}
+ data-executing={isExecuting ? '' : undefined}
style={{
+ '--node-color': nodeColor,
position: 'relative',
display: 'flex',
flexDirection: 'column',
@@ -274,24 +276,16 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: '11px',
cursor: 'pointer',
- }}
+ } as NodeStyle}
>
{/* Main Square Node */}
<div
className="sq-node-box"
style={{
+ '--node-color': nodeColor,
position: 'relative',
width: theme.nodeSize.square,
height: theme.nodeSize.square,
- borderRadius: theme.borderRadius.lg,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${nodeColor}25 0%, ${theme.colors.background} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${nodeColor}08 100%)`,
- border: `2px solid ${isExecuting
- ? (theme.isDarkMode ? theme.dracula.cyan : '#2563eb')
- : selected
- ? theme.colors.focus
- : theme.isDarkMode ? nodeColor + '80' : `${nodeColor}40`}`,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
@@ -299,18 +293,8 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
fontSize: theme.nodeSize.squareIcon,
fontWeight: '600',
transition: 'all 0.2s ease',
- boxShadow: isExecuting
- ? theme.isDarkMode
- ? `0 4px 12px ${theme.dracula.cyan}66, 0 0 0 3px ${theme.dracula.cyan}4D`
- : `0 0 0 3px rgba(37, 99, 235, 0.5), 0 4px 16px rgba(37, 99, 235, 0.35)`
- : selected
- ? `0 4px 12px ${theme.colors.focusRing}, 0 0 0 1px ${theme.colors.focusRing}`
- : theme.isDarkMode
- ? `0 2px 8px ${nodeColor}40`
- : `0 2px 8px ${nodeColor}20, 0 4px 12px rgba(0,0,0,0.06)`,
- animation: isExecuting ? 'pulse 1.5s ease-in-out infinite' : 'none',
opacity: isDisabled ? 0.5 : 1,
- }}
+ } as NodeStyle}
>
{/* Disabled Overlay */}
{isDisabled && (
@@ -345,21 +329,14 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
right: '-8px',
width: theme.nodeSize.paramButton,
height: theme.nodeSize.paramButton,
- borderRadius: theme.borderRadius.sm,
- backgroundColor: theme.isDarkMode ? theme.colors.backgroundAlt : '#ffffff',
- border: `1px solid ${theme.isDarkMode ? theme.colors.border : '#d1d5db'}`,
cursor: 'pointer',
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
fontSize: theme.fontSize.xs,
- color: theme.colors.textSecondary,
fontWeight: '400',
transition: theme.transitions.fast,
zIndex: 30,
- boxShadow: theme.isDarkMode
- ? `0 1px 3px ${theme.colors.shadow}`
- : '0 1px 4px rgba(0,0,0,0.1)'
}}
title="Edit Service Parameters"
className="sq-node-gear"
@@ -371,24 +348,14 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
<div
className="sq-node-pip"
style={{
+ '--node-color': getStatusIndicatorColor(),
position: 'absolute',
top: '-4px',
left: '-4px',
width: theme.nodeSize.statusIndicator,
height: theme.nodeSize.statusIndicator,
- borderRadius: '50%',
- backgroundColor: getStatusIndicatorColor(),
- border: `2px solid ${theme.isDarkMode ? theme.colors.background : '#ffffff'}`,
- boxShadow: isExecuting
- ? theme.isDarkMode
- ? `0 0 6px ${theme.dracula.cyan}80`
- : '0 0 4px rgba(37, 99, 235, 0.5)'
- : theme.isDarkMode
- ? `0 1px 2px ${theme.colors.shadow}`
- : '0 1px 3px rgba(0,0,0,0.15)',
zIndex: 30,
- animation: isExecuting ? 'pulse 1s ease-in-out infinite' : 'none',
- }}
+ } as NodeStyle}
title={getStatusTitle()}
/>
@@ -409,9 +376,6 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
transform: 'translateY(-50%)',
width: theme.nodeSize.handle,
height: theme.nodeSize.handle,
- backgroundColor: theme.isDarkMode ? theme.colors.background : '#ffffff',
- border: `2px solid ${theme.isDarkMode ? theme.colors.textSecondary : '#6b7280'}`,
- borderRadius: '50%',
zIndex: 20
}}
title="Service Input"
@@ -428,17 +392,15 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
isConnectable={isConnectable}
className="sq-node-handle out"
style={{
+ '--node-color': isConfigured ? nodeColor : theme.colors.textSecondary,
position: 'absolute',
right: '-6px',
top: '50%',
transform: 'translateY(-50%)',
width: theme.nodeSize.handle,
height: theme.nodeSize.handle,
- backgroundColor: isConfigured ? nodeColor : theme.colors.textSecondary,
- border: `2px solid ${theme.isDarkMode ? theme.colors.background : '#ffffff'}`,
- borderRadius: '50%',
zIndex: 20
- }}
+ } as NodeStyle}
title="Service Output"
/>
)}
diff --git a/client/src/components/StartNode.tsx b/client/src/components/StartNode.tsx
index edc911b8..b927e407 100644
--- a/client/src/components/StartNode.tsx
+++ b/client/src/components/StartNode.tsx
@@ -1,7 +1,7 @@
import React, { memo, useCallback } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { useAppTheme } from '../hooks/useAppTheme';
import { PlayCircle } from 'lucide-react';
@@ -34,9 +34,13 @@ const StartNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectabl
return (
// `node` + `selected` co-classes activate per-theme node decorations.
+ // Visual styling (background, border, radius, shadow) lives in
+ // base.css `.node { ... }` defaults + per-theme `.node` overrides
+ // and reads `var(--node-color)` for the per-definition accent.
<div
className={`node ${selected ? 'selected' : ''}`}
style={{
+ '--node-color': nodeColor,
position: 'relative',
display: 'flex',
flexDirection: 'column',
@@ -44,21 +48,14 @@ const StartNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectabl
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: '11px',
cursor: 'pointer',
- }}
+ } as NodeStyle}
>
- {/* Main Square Node */}
+ {/* Main Square Node — layout only; visuals live in CSS. */}
<div
style={{
position: 'relative',
width: '60px',
height: '60px',
- borderRadius: '8px',
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${nodeColor}20 0%, ${theme.colors.background} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${nodeColor}10 100%)`,
- border: `2px solid ${selected
- ? theme.colors.focus
- : theme.isDarkMode ? `${nodeColor}60` : `${nodeColor}50`}`,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
@@ -66,11 +63,6 @@ const StartNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectabl
fontSize: '28px',
fontWeight: '600',
transition: 'all 0.2s ease',
- boxShadow: selected
- ? `0 4px 12px ${theme.colors.focusRing}, 0 0 0 1px ${theme.colors.focusRing}`
- : theme.isDarkMode
- ? `0 2px 8px ${nodeColor}30`
- : `0 2px 8px ${nodeColor}25, 0 4px 12px rgba(0,0,0,0.06)`,
}}
>
{/* Play Icon */}
diff --git a/client/src/components/SvgFilterDefs.tsx b/client/src/components/SvgFilterDefs.tsx
new file mode 100644
index 00000000..a92355ef
--- /dev/null
+++ b/client/src/components/SvgFilterDefs.tsx
@@ -0,0 +1,54 @@
+/**
+ * Mounts a hidden inline <svg><defs> block once at the app root so per-
+ * theme CSS rules like `filter: url(#ink-blot)` resolve. The SVG itself
+ * has zero pixel footprint (width=0 height=0); the filter definitions
+ * inside <defs> are document-wide referenceable by ID.
+ *
+ * Filter IDs declared:
+ * #ink-blot - Renaissance edge warble (turbulence + displacement map)
+ * #noise - Wasteland paper-grain turbulence
+ * #crt - Cyber chromatic aberration / scanline
+ *
+ * Audit: only `#ink-blot` is currently referenced in the upstream design
+ * handoff CSS (renaissance.css line 271). `#noise` and `#crt` are shipped
+ * preemptively so per-theme CSS can adopt them without a second wave.
+ */
+import React from 'react';
+
+export const SvgFilterDefs: React.FC = () => (
+ <svg
+ width={0}
+ height={0}
+ aria-hidden="true"
+ style={{ position: 'absolute', overflow: 'hidden' }}
+ >
+ <defs>
+ <filter id="ink-blot">
+ <feTurbulence
+ type="fractalNoise"
+ baseFrequency="0.02 0.04"
+ numOctaves="2"
+ seed="3"
+ />
+ <feDisplacementMap in="SourceGraphic" scale="2" />
+ </filter>
+ <filter id="noise">
+ <feTurbulence
+ type="fractalNoise"
+ baseFrequency="0.9"
+ numOctaves="2"
+ stitchTiles="stitch"
+ />
+ <feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.15 0" />
+ </filter>
+ <filter id="crt">
+ <feColorMatrix values="1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0" />
+ <feOffset in="SourceGraphic" dx="-1" dy="0" result="r" />
+ <feOffset in="SourceGraphic" dx="1" dy="0" result="b" />
+ <feBlend in="r" in2="b" mode="screen" />
+ </filter>
+ </defs>
+ </svg>
+);
+
+export default SvgFilterDefs;
diff --git a/client/src/components/TeamMonitorNode.tsx b/client/src/components/TeamMonitorNode.tsx
index 25a08473..e73a9843 100644
--- a/client/src/components/TeamMonitorNode.tsx
+++ b/client/src/components/TeamMonitorNode.tsx
@@ -1,7 +1,7 @@
import React, { memo, useState, useEffect, useCallback, useMemo } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps, useEdges, useNodes } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { resolveNodeDescription } from '../lib/nodeSpec';
import { useAppTheme } from '../hooks/useAppTheme';
@@ -123,21 +123,19 @@ const TeamMonitorNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConn
};
return (
+ // Visual styling (background, border, radius) lives in base.css `.node`
+ // defaults + per-theme overrides; reads `var(--node-color)` for accent.
<div
className={`node ${selected ? 'selected' : ''}`}
onClick={handleClick}
style={{
+ '--node-color': nodeColor,
width: 200,
minHeight: 120,
- borderRadius: 8,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${nodeColor}15 0%, ${theme.colors.background} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${nodeColor}08 100%)`,
- border: `2px solid ${selected ? theme.colors.focus : nodeColor + '60'}`,
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: 10,
overflow: 'hidden',
- }}
+ } as NodeStyle}
>
{/* Header */}
<div style={{
diff --git a/client/src/components/ToolkitNode.tsx b/client/src/components/ToolkitNode.tsx
index c74bf465..edb50a92 100644
--- a/client/src/components/ToolkitNode.tsx
+++ b/client/src/components/ToolkitNode.tsx
@@ -13,7 +13,7 @@
import React, { memo, useCallback } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { resolveNodeDescription } from '../lib/nodeSpec';
import { NodeIcon } from '../assets/icons';
@@ -78,9 +78,14 @@ const ToolkitNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
};
return (
+ // Visual styling (background, border, radius, shadow, executing pulse)
+ // lives in base.css `.node` defaults + per-theme overrides; reads
+ // `var(--node-color)` for the per-definition accent. The
+ // `react-flow__node.executing .node` rule binds the pulse.
<div
className={`node ${selected ? 'selected' : ''}`}
style={{
+ '--node-color': nodeColor,
position: 'relative',
display: 'flex',
flexDirection: 'column',
@@ -88,23 +93,15 @@ const ToolkitNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: '11px',
cursor: 'pointer',
- }}
+ } as NodeStyle}
>
- {/* Main Node - rectangular for toolkit, square for skills */}
+ {/* Main Node - rectangular for toolkit, square for skills.
+ Layout only; visuals live in CSS. */}
<div
style={{
position: 'relative',
width: isToolkitNode ? theme.nodeSize.toolkitWidth : theme.nodeSize.square,
height: isToolkitNode ? theme.nodeSize.toolkitHeight : theme.nodeSize.square,
- borderRadius: theme.borderRadius.lg,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${nodeColor}25 0%, ${theme.colors.background} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${nodeColor}08 100%)`,
- border: `2px solid ${isExecuting
- ? (theme.isDarkMode ? theme.dracula.cyan : '#2563eb')
- : selected
- ? theme.colors.focus
- : theme.isDarkMode ? nodeColor + '80' : `${nodeColor}40`}`,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
@@ -112,16 +109,6 @@ const ToolkitNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
fontSize: theme.nodeSize.squareIcon,
fontWeight: '600',
transition: 'all 0.2s ease',
- boxShadow: isExecuting
- ? theme.isDarkMode
- ? `0 4px 12px ${theme.dracula.cyan}66, 0 0 0 3px ${theme.dracula.cyan}4D`
- : `0 0 0 3px rgba(37, 99, 235, 0.5), 0 4px 16px rgba(37, 99, 235, 0.35)`
- : selected
- ? `0 4px 12px ${theme.colors.focusRing}, 0 0 0 1px ${theme.colors.focusRing}`
- : theme.isDarkMode
- ? `0 2px 8px ${nodeColor}40`
- : `0 2px 8px ${nodeColor}20, 0 4px 12px rgba(0,0,0,0.06)`,
- animation: isExecuting ? 'pulse 1.5s ease-in-out infinite' : 'none',
}}
>
{/* Service Icon */}
diff --git a/client/src/components/TriggerNode.tsx b/client/src/components/TriggerNode.tsx
index 61dd015f..eeec82be 100644
--- a/client/src/components/TriggerNode.tsx
+++ b/client/src/components/TriggerNode.tsx
@@ -9,7 +9,7 @@
import React, { memo, useState, useEffect, useCallback } from 'react';
import { nodePropsEqual } from './nodeMemoEquality';
import { Handle, Position, NodeProps } from 'reactflow';
-import { NodeData } from '../types/NodeTypes';
+import { NodeData, NodeStyle } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { resolveNodeDescription, useNodeSpec } from '../lib/nodeSpec';
import { NodeIcon } from '../assets/icons';
@@ -127,6 +127,7 @@ const TriggerNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
<div
className={`node node-trigger ${selected ? 'selected' : ''}`}
style={{
+ '--node-color': nodeColor,
position: 'relative',
display: 'flex',
flexDirection: 'column',
@@ -134,26 +135,17 @@ const TriggerNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
fontFamily: 'system-ui, -apple-system, sans-serif',
fontSize: '11px',
cursor: 'pointer',
- }}
+ } as NodeStyle}
>
- {/* Main Trigger Node */}
- {/* Show glow animation for both executing and waiting states */}
+ {/* Main Trigger Node — visual styling lives in base.css + per-theme
+ CSS targeting `.node.node-trigger`. Inner box keeps only layout
+ (size, flex), and per-theme decorations like Cyber neon glow,
+ Renaissance wax seal, and Steampunk rivets reach the pixels. */}
<div
style={{
position: 'relative',
width: theme.nodeSize.square,
height: theme.nodeSize.square,
- borderRadius: theme.borderRadius.lg,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${nodeColor}25 0%, ${theme.colors.background} 100%)`
- : `linear-gradient(145deg, #ffffff 0%, ${nodeColor}08 100%)`,
- border: `2px solid ${
- isExecuting
- ? (theme.isDarkMode ? theme.dracula.purple : '#2563eb')
- : selected
- ? theme.colors.focus
- : theme.isDarkMode ? nodeColor + '80' : `${nodeColor}40`
- }`,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
@@ -161,17 +153,6 @@ const TriggerNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
fontSize: theme.nodeSize.squareIcon,
fontWeight: '600',
transition: 'all 0.2s ease',
- boxShadow: isExecuting
- ? theme.isDarkMode
- ? `0 4px 12px ${theme.dracula.purple}66, 0 0 0 3px ${theme.dracula.purple}4D`
- : `0 0 0 3px rgba(37, 99, 235, 0.5), 0 4px 16px rgba(37, 99, 235, 0.35)`
- : selected
- ? `0 4px 12px ${theme.colors.focusRing}, 0 0 0 1px ${theme.colors.focusRing}`
- : theme.isDarkMode
- ? `0 2px 8px ${nodeColor}40`
- : `0 2px 8px ${nodeColor}20, 0 4px 12px rgba(0,0,0,0.06)`,
- // Subtle animation for both modes
- animation: isExecuting ? 'pulse 1.5s ease-in-out infinite' : 'none',
opacity: isDisabled ? 0.5 : 1,
}}
>
diff --git a/client/src/components/ui/DropCap.tsx b/client/src/components/ui/DropCap.tsx
new file mode 100644
index 00000000..0e12cac8
--- /dev/null
+++ b/client/src/components/ui/DropCap.tsx
@@ -0,0 +1,28 @@
+/**
+ * Wraps content (typically a heading or first paragraph) with the
+ * `v-display drop-cap` className so theme CSS rules like the
+ * Renaissance `.v-display.drop-cap::first-letter` rule fire on the
+ * first letter. Under themes that don't define a drop-cap rule it's a
+ * no-op (just two extra class names on the wrapper).
+ */
+import React from 'react';
+
+export interface DropCapProps {
+ as?: 'h1' | 'h2' | 'h3' | 'p' | 'span' | 'div';
+ className?: string;
+ children: React.ReactNode;
+}
+
+export const DropCap: React.FC<DropCapProps> = ({
+ as: Tag = 'span',
+ className = '',
+ children,
+}) => {
+ return (
+ <Tag className={`v-display drop-cap ${className}`.trim()}>
+ {children}
+ </Tag>
+ );
+};
+
+export default DropCap;
diff --git a/client/src/hooks/useSound.ts b/client/src/hooks/useSound.ts
index d583ba20..a0fd7c1d 100644
--- a/client/src/hooks/useSound.ts
+++ b/client/src/hooks/useSound.ts
@@ -130,6 +130,25 @@ export function useSoundSync(): void {
document.removeEventListener('touchstart', handleHover, true);
};
}, []);
+
+ // One-shot AudioContext unlock on the first user gesture. Modern
+ // browsers (Chrome / Safari) keep the AudioContext suspended until a
+ // resume() call originates from a gesture handler — without this, the
+ // first play() can land microseconds after the gesture frame and the
+ // sound is silently dropped. `Sounds.unlock()` is idempotent so the
+ // `{ once: true }` listeners cover the lifetime fine.
+ useEffect(() => {
+ const handler = () => { Sounds.unlock(); };
+ const opts: AddEventListenerOptions = { once: true, capture: true, passive: true };
+ window.addEventListener('pointerdown', handler, opts);
+ window.addEventListener('keydown', handler, opts);
+ window.addEventListener('touchstart', handler, opts);
+ return () => {
+ window.removeEventListener('pointerdown', handler, true);
+ window.removeEventListener('keydown', handler, true);
+ window.removeEventListener('touchstart', handler, true);
+ };
+ }, []);
}
/** Play handle. Returns the same `Sounds.play` reference each render. */
diff --git a/client/src/lib/sound.ts b/client/src/lib/sound.ts
index 57070038..a8e36db2 100644
--- a/client/src/lib/sound.ts
+++ b/client/src/lib/sound.ts
@@ -288,6 +288,24 @@ export const Sounds = {
pack(): SoundPackName {
return activePackName;
},
+ /**
+ * Idempotent gesture-time unlock. Constructs the AudioContext (if not
+ * already constructed) and resumes it if the browser autoplay policy
+ * left it `suspended`. Safe to call repeatedly — `resume()` on a
+ * running context is a no-op.
+ *
+ * Modern Chrome / Safari require the resume() call to occur inside
+ * the same task as a user gesture (pointerdown / keydown / touchstart).
+ * `Sounds.play()` defensively calls resume() too, but state-change-
+ * driven plays (e.g. modal open from an effect) can land microseconds
+ * after the gesture frame and lose the very first sound. Calling
+ * `unlock()` from a once-listener on the gesture path closes that gap.
+ */
+ unlock(): void {
+ const ac = ensureCtx();
+ if (!ac) return;
+ if (ac.state === 'suspended') void ac.resume();
+ },
play(event: SoundEvent): void {
const throttle = THROTTLE_MS[event];
if (throttle !== undefined) {
diff --git a/client/src/themes/atomic.css b/client/src/themes/atomic.css
index 01677dbc..aba417d4 100644
--- a/client/src/themes/atomic.css
+++ b/client/src/themes/atomic.css
@@ -117,6 +117,11 @@
--tint-soft: 14%;
--tint-border: 35%;
+
+ /* Canvas backplane — mid-century starburst on 160x160 tile */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='160' height='160'><g stroke='%232a3a4a' stroke-width='0.6' fill='none' opacity='0.18'><path d='M40 80 L120 80 M80 40 L80 120 M50 50 L110 110 M110 50 L50 110'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* Body — clean cardstock; starburst lives on canvas in W2 wrapper */
@@ -166,7 +171,7 @@
}
:root[data-theme="atomic"] .sq-node.selected .sq-node-box {
background: hsl(var(--accent)); color: var(--bg-elevated);
- box-shadow: 4px 4px 0 var(--slate), 0 0 0 4px hsl(var(--warning-soft));
+ box-shadow: 4px 4px 0 var(--slate), 0 0 0 4px hsl(var(--warning) / 0.25);
}
:root[data-theme="atomic"] .sq-node-pip { border: 1.5px solid var(--slate); }
:root[data-theme="atomic"] .sq-node-gear { background: var(--turquoise); color: var(--bg-elevated); border: 1px solid var(--slate); }
diff --git a/client/src/themes/base.css b/client/src/themes/base.css
index 1377f136..38e0c9ea 100644
--- a/client/src/themes/base.css
+++ b/client/src/themes/base.css
@@ -42,6 +42,11 @@
/* Cursor + scrollbar */
--cursor-default: auto;
--cursor-pointer: pointer;
+
+ /* Canvas-host background pattern slot — themes override with a CSS
+ * gradient or SVG data-url. Default: no pattern. */
+ --canvas-grid: none;
+ --canvas-grid-opacity: 0.4;
}
/* ============================================================================
@@ -77,8 +82,124 @@
/* Renaissance */
:root[data-theme="renaissance"] .canvas .ornament,
/* Generic Tailwind animate-pulse used by node execution pip */
- .animate-pulse {
+ .animate-pulse,
+ /* Wave 21 default node pulse */
+ .react-flow__node.executing .node {
animation: none !important;
transition: none !important;
}
}
+
+/* ============================================================================
+ * Default canvas-node visuals (Wave 21).
+ *
+ * Each node component sets `--node-color` inline from its plugin's
+ * accent hex (visuals.json). These rules consume that custom property
+ * to draw a sensible default border / gradient / shadow so light, dark,
+ * and any theme that doesn't define its own `.node` rule still renders
+ * correctly. Per-theme CSS in client/src/themes/<theme>.css overrides
+ * these with material-specific decorations (vellum, neon, marble, etc.).
+ * ============================================================================ */
+
+.node {
+ position: relative;
+ border-radius: 12px;
+ border: 2px solid color-mix(in srgb, var(--node-color, hsl(var(--border))) 60%, transparent);
+ background:
+ linear-gradient(
+ 135deg,
+ color-mix(in srgb, var(--node-color, hsl(var(--card))) 14%, hsl(var(--card))) 0%,
+ hsl(var(--card)) 100%
+ );
+ box-shadow: 0 2px 8px color-mix(in srgb, var(--node-color, #000) 18%, transparent);
+ transition:
+ transform 0.15s ease,
+ border-color 0.15s ease,
+ box-shadow 0.15s ease;
+}
+
+.node:hover {
+ transform: translateY(-1px);
+ box-shadow: 0 4px 14px color-mix(in srgb, var(--node-color, #000) 28%, transparent);
+}
+
+.node.selected {
+ border-color: var(--node-color, hsl(var(--ring)));
+ box-shadow:
+ 0 0 0 1px var(--node-color, hsl(var(--ring))),
+ 0 4px 14px color-mix(in srgb, var(--node-color, #000) 32%, transparent);
+}
+
+/* Pulse during execution — react-flow toggles `.executing` on the wrapper
+ via canvasAnimations.ts (`.react-flow__node.executing`). */
+.react-flow__node.executing .node {
+ animation: node-pulse 1.5s ease-in-out infinite;
+}
+
+@keyframes node-pulse {
+ 0%,
+ 100% {
+ box-shadow: 0 0 0 0 color-mix(in srgb, var(--node-color, hsl(var(--ring))) 60%, transparent);
+ }
+ 50% {
+ box-shadow: 0 0 0 6px color-mix(in srgb, var(--node-color, hsl(var(--ring))) 0%, transparent);
+ }
+}
+
+/* Square-node default visuals — outer wrapper is layout-only, the inner
+ `.sq-node-box` carries the bordered icon-square. Per-theme CSS
+ already in `client/src/themes/*.css` overrides these for material
+ identity. */
+.sq-node {
+ position: relative;
+}
+
+.sq-node-box {
+ border-radius: 10px;
+ border: 2px solid color-mix(in srgb, var(--node-color, hsl(var(--border))) 60%, transparent);
+ background:
+ linear-gradient(
+ 135deg,
+ color-mix(in srgb, var(--node-color, hsl(var(--card))) 18%, hsl(var(--card))) 0%,
+ hsl(var(--card)) 100%
+ );
+ box-shadow: 0 2px 8px color-mix(in srgb, var(--node-color, #000) 18%, transparent);
+ transition:
+ transform 0.15s ease,
+ border-color 0.15s ease,
+ box-shadow 0.15s ease;
+}
+
+.sq-node-box:hover {
+ transform: translateY(-1px);
+ box-shadow: 0 4px 14px color-mix(in srgb, var(--node-color, #000) 28%, transparent);
+}
+
+.sq-node.selected .sq-node-box {
+ border-color: var(--node-color, hsl(var(--ring)));
+ box-shadow:
+ 0 0 0 1px var(--node-color, hsl(var(--ring))),
+ 0 4px 14px color-mix(in srgb, var(--node-color, #000) 32%, transparent);
+}
+
+.react-flow__node.executing .sq-node-box,
+.sq-node[data-executing] .sq-node-box {
+ animation: node-pulse 1.5s ease-in-out infinite;
+}
+
+/* ============================================================================
+ * Canvas-host background pattern + cursor (Wave 24).
+ *
+ * Themes provide per-theme decorative backgrounds via the `--canvas-grid`
+ * custom property (CSS gradient or SVG data-url) and per-theme cursors
+ * via `--cursor-default`. Both fall back to neutral defaults from `:root`.
+ *
+ * The pattern is layered on top of React Flow's own background — themes
+ * keep their canvas surface colour via shadcn `--background` tokens and
+ * this rule adds the decorative grid on top.
+ * ============================================================================ */
+
+.canvas-host {
+ background-image: var(--canvas-grid, none);
+ cursor: var(--cursor-default, auto);
+}
diff --git a/client/src/themes/cyber.css b/client/src/themes/cyber.css
index 997e17db..b08830e1 100644
--- a/client/src/themes/cyber.css
+++ b/client/src/themes/cyber.css
@@ -71,9 +71,16 @@
--motion-style: glitch;
--sound-pack: terminal;
- /* Cursor + scrollbar */
- --cursor-default: auto;
- --cursor-pointer: pointer;
+ /* Cursor — crosshair targeting reticle (upstream design handoff) */
+ --cursor-default: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><g stroke='%23f51eb6' stroke-width='1.2' fill='none'><path d='M12 2 L12 8 M12 16 L12 22 M2 12 L8 12 M16 12 L22 12'/><circle cx='12' cy='12' r='3'/><circle cx='12' cy='12' r='1' fill='%231dd9e5'/></g></svg>") 12 12, crosshair;
+ --cursor-pointer: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><g stroke='%23f51eb6' stroke-width='1.5' fill='none'><rect x='3' y='3' width='18' height='18'/><rect x='8' y='8' width='8' height='8' fill='%231dd9e5'/></g></svg>") 12 12, pointer;
+
+ /* Canvas backplane — magnetic-tape grid (24px cells, neon magenta + cyan) */
+ --canvas-grid:
+ repeating-linear-gradient(0deg, transparent 0 23px, rgba(245, 30, 182, 0.10) 23px 24px),
+ repeating-linear-gradient(90deg, transparent 0 23px, rgba(29, 217, 229, 0.10) 23px 24px);
+ --canvas-grid-opacity: 1;
+
--scrollbar-track: #0a0420;
--scrollbar-thumb: #f51eb6;
diff --git a/client/src/themes/dark.css b/client/src/themes/dark.css
index 0fc81f7d..499da327 100644
--- a/client/src/themes/dark.css
+++ b/client/src/themes/dark.css
@@ -60,7 +60,7 @@
--ease-default: cubic-bezier(0.2, 0.7, 0.3, 1);
--ease-emphasis: cubic-bezier(0.6, -0.05, 0.3, 1.4);
--motion-style: smooth;
- --sound-pack: chime;
+ --sound-pack: terminal;
/* Cursor + scrollbar */
--cursor-default: auto;
diff --git a/client/src/themes/greek.css b/client/src/themes/greek.css
index e3396507..adbcffb9 100644
--- a/client/src/themes/greek.css
+++ b/client/src/themes/greek.css
@@ -129,6 +129,11 @@
--tint-soft: 14%;
--tint-border: 35%;
+
+ /* Canvas backplane — temple-floor key meander (80x80 tile, faint ink) */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='80' height='80'><g fill='none' stroke='%234a3818' stroke-width='0.4' opacity='0.18'><path d='M0 40 H10 V20 H30 V60 H50 V20 H70 V40 H80'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* ── Body marble texture ──────────────────────────────────────────────── */
@@ -197,7 +202,7 @@
color: hsl(var(--accent));
}
:root[data-theme="greek"] .sq-node.selected .sq-node-box {
- border-color: hsl(var(--accent)); box-shadow: 0 0 0 3px hsl(var(--info-soft)), 0 3px 0 var(--border-strong), inset 0 0 0 1px var(--gold);
+ border-color: hsl(var(--accent)); box-shadow: 0 0 0 3px hsl(var(--info) / 0.25), 0 3px 0 var(--border-strong), inset 0 0 0 1px var(--gold);
}
:root[data-theme="greek"] .sq-node-pip { border-radius: 0; box-shadow: 0 0 0 1px var(--border-strong); }
:root[data-theme="greek"] .sq-node-gear { background: var(--gold); color: var(--border-strong); border: 1px solid var(--border-strong); border-radius: 0; }
diff --git a/client/src/themes/light.css b/client/src/themes/light.css
index df557312..74f09eb0 100644
--- a/client/src/themes/light.css
+++ b/client/src/themes/light.css
@@ -68,7 +68,7 @@
--ease-default: cubic-bezier(0.2, 0.7, 0.3, 1);
--ease-emphasis: cubic-bezier(0.6, -0.05, 0.3, 1.4);
--motion-style: smooth;
- --sound-pack: chime;
+ --sound-pack: parchment;
/* Cursor + scrollbar */
--cursor-default: auto;
diff --git a/client/src/themes/plague.css b/client/src/themes/plague.css
index 36cafa60..20c43444 100644
--- a/client/src/themes/plague.css
+++ b/client/src/themes/plague.css
@@ -119,6 +119,11 @@
--tint-soft: 16%;
--tint-border: 40%;
+
+ /* Canvas backplane — broadsheet red X marks on 240x240 tile */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='240' height='240'><g stroke='%23783c28' stroke-width='1.6' fill='none' opacity='0.10' stroke-linecap='square'><path d='M40 40 L60 60 M60 40 L40 60'/><path d='M180 80 L200 100 M200 80 L180 100'/><path d='M80 180 L100 200 M100 180 L80 200'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* Body — weathered parchment */
@@ -170,7 +175,7 @@
content: ''; position: absolute; top: -3px; left: 50%; width: 6px; height: 6px;
background: var(--crow); transform: translateX(-50%);
}
-:root[data-theme="plague"] .sq-node.selected .sq-node-box { border-color: hsl(var(--accent)); background: hsl(var(--danger-soft)); }
+:root[data-theme="plague"] .sq-node.selected .sq-node-box { border-color: hsl(var(--accent)); background: hsl(var(--destructive) / 0.2); }
:root[data-theme="plague"] .sq-node-gear { background: hsl(var(--accent)); color: var(--linen); border: none; border-radius: 0; }
:root[data-theme="plague"] .sq-node-handle { border-radius: 0; }
:root[data-theme="plague"] .sq-node-handle.out { background: hsl(var(--accent)); }
diff --git a/client/src/themes/renaissance.css b/client/src/themes/renaissance.css
index 85c8842c..19a452f5 100644
--- a/client/src/themes/renaissance.css
+++ b/client/src/themes/renaissance.css
@@ -75,9 +75,16 @@
--motion-style: organic;
--sound-pack: parchment;
- /* Cursor + scrollbar */
- --cursor-default: auto;
- --cursor-pointer: pointer;
+ /* Cursor — quill pen with gold-leaf nib (upstream design handoff) */
+ --cursor-default: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='28' height='28' viewBox='0 0 28 28'><path d='M3 25 L10 17 L13 20 L6 27 Z' fill='%235a3a14'/><path d='M10 17 L20 5 L24 9 L13 20 Z' fill='%23d4a030' stroke='%235a3a14' stroke-width='1'/><path d='M14 9 L18 13 M12 11 L16 15 M10 13 L14 17' stroke='%235a3a14' stroke-width='0.5' fill='none'/></svg>") 3 25, auto;
+ --cursor-pointer: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='28' height='28' viewBox='0 0 28 28'><path d='M5 5 L20 12 L13 14 L11 22 Z' fill='%23d4a030' stroke='%235a3a14' stroke-width='1.5'/></svg>") 5 5, pointer;
+
+ /* Canvas backplane — faint cartography ornament (fleur-de-lis on
+ * 80x80 tile, light gold ink) */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='80' height='80' viewBox='0 0 80 80'><g fill='none' stroke='%238a5e1c' stroke-width='0.4' opacity='0.35'><path d='M40 22 Q35 32, 30 32 Q26 32, 28 28 Q32 26, 40 28 Q48 26, 52 28 Q54 32, 50 32 Q45 32, 40 22 Z'/><path d='M40 28 L40 40 M36 36 L44 36'/><circle cx='40' cy='42' r='2'/></g></svg>");
+ --canvas-grid-opacity: 1;
+
--scrollbar-track: #e8d09a;
--scrollbar-thumb: #8a5e1c;
diff --git a/client/src/themes/rot.css b/client/src/themes/rot.css
index aa727b9c..0f7946e4 100644
--- a/client/src/themes/rot.css
+++ b/client/src/themes/rot.css
@@ -118,6 +118,11 @@
--tint-soft: 16%;
--tint-border: 40%;
+
+ /* Canvas backplane — flagstone crypt floor on 80x80 tile */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='80' height='80'><g stroke='%234a6a4a' stroke-width='0.4' fill='none' opacity='0.25'><path d='M0 30 H80 M30 0 V80 M0 60 H80 M60 0 V80'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* Body — moss + damp stone */
diff --git a/client/src/themes/steampunk.css b/client/src/themes/steampunk.css
index 1f4623b4..6f13aee4 100644
--- a/client/src/themes/steampunk.css
+++ b/client/src/themes/steampunk.css
@@ -118,6 +118,11 @@
--tint-soft: 16%;
--tint-border: 40%;
+
+ /* Canvas backplane — engine-room brass bolts on 80x80 tile */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='80' height='80'><g fill='%23b88838' opacity='0.10'><circle cx='40' cy='40' r='1.5'/><circle cx='10' cy='10' r='1'/><circle cx='70' cy='70' r='1'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* Body — riveted leather grain */
diff --git a/client/src/themes/surveillance.css b/client/src/themes/surveillance.css
index 8a5d89eb..221fad1a 100644
--- a/client/src/themes/surveillance.css
+++ b/client/src/themes/surveillance.css
@@ -54,8 +54,17 @@
--motion-style: scanline;
--sound-pack: telex;
- --cursor-default: auto;
+ /* Cursor — CCTV snooper reticle (REC-red crosshair with center dot) */
+ --cursor-default: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><g stroke='%23e82626' stroke-width='1' fill='none'><circle cx='12' cy='12' r='8'/><path d='M12 1 L12 6 M12 18 L12 23 M1 12 L6 12 M18 12 L23 12'/><circle cx='12' cy='12' r='1.5' fill='%23e82626'/></g></svg>") 12 12, crosshair;
--cursor-pointer: pointer;
+
+ /* Canvas backplane — CCTV crosshair + corner brackets + 40px grain grid */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='1920' height='1080'><g stroke='%23e82626' stroke-width='1' fill='none' opacity='0.18'><path d='M40 40 H120 M40 40 V120 M1880 40 H1800 M1880 40 V120 M40 1040 H120 M40 1040 V960 M1880 1040 H1800 M1880 1040 V960'/><circle cx='960' cy='540' r='40' opacity='0.2'/><path d='M960 480 V600 M900 540 H1020' opacity='0.25'/></g></svg>"),
+ repeating-linear-gradient(0deg, transparent 0 3px, rgba(106,204,106,0.04) 3px 4px),
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='40' height='40'><g stroke='%23888c90' stroke-width='0.4' fill='none' opacity='0.12'><path d='M0 20 H40 M20 0 V40'/></g></svg>");
+ --canvas-grid-opacity: 1;
+
--scrollbar-track: #1a1c1e;
--scrollbar-thumb: #5a5e62;
diff --git a/client/src/themes/wasteland.css b/client/src/themes/wasteland.css
index 30fa45e5..6bf5b91e 100644
--- a/client/src/themes/wasteland.css
+++ b/client/src/themes/wasteland.css
@@ -117,6 +117,11 @@
--tint-soft: 18%;
--tint-border: 45%;
+
+ /* Canvas backplane — cracked-earth fissures on 200x200 tile */
+ --canvas-grid:
+ url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='200' height='200'><g stroke='%23e88a28' stroke-width='0.4' fill='none' opacity='0.10'><path d='M40 10 Q60 60 30 100 Q10 140 50 180 M120 0 Q140 80 100 140 M180 30 Q160 80 190 130'/></g></svg>");
+ --canvas-grid-opacity: 1;
}
/* Body — dust + grit texture */
@@ -176,7 +181,7 @@
background: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='100' height='100'><filter id='s'><feTurbulence baseFrequency='2' numOctaves='1'/><feColorMatrix values='0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.18 0'/></filter><rect width='100' height='100' filter='url(%23s)'/></svg>");
pointer-events: none;
}
-:root[data-theme="wasteland"] .sq-node.selected .sq-node-box { border-color: hsl(var(--accent)); box-shadow: 0 0 0 2px hsl(var(--info-soft)), 2px 2px 0 var(--rust); }
+:root[data-theme="wasteland"] .sq-node.selected .sq-node-box { border-color: hsl(var(--accent)); box-shadow: 0 0 0 2px hsl(var(--info) / 0.25), 2px 2px 0 var(--rust); }
:root[data-theme="wasteland"] .sq-node-gear { background: var(--rust); color: hsl(var(--accent)); border: 1px solid hsl(var(--accent)); border-radius: 0; }
:root[data-theme="wasteland"] .sq-node-handle.out { background: hsl(var(--accent)); }
:root[data-theme="wasteland"] .sq-node-label { font-family: var(--font-display); letter-spacing: 0.10em; }
diff --git a/client/src/types/NodeTypes.ts b/client/src/types/NodeTypes.ts
index 30d19958..f33ccf82 100644
--- a/client/src/types/NodeTypes.ts
+++ b/client/src/types/NodeTypes.ts
@@ -25,4 +25,14 @@ export interface NodeData {
disabled?: boolean; // Skip execution when true (n8n-style disable)
customIcon?: string; // Custom icon: emoji, text, or image URL (http://, https://, data:, or /)
[key: string]: any;
-}
\ No newline at end of file
+}
+
+/**
+ * CSSProperties extended to accept arbitrary CSS custom properties (e.g.
+ * `--node-color`). React's CSSProperties type rejects custom-property keys
+ * by default; this NodeStyle alias lets canvas-node components pass the
+ * per-definition node accent through to per-theme decorative CSS via a
+ * `--node-color` variable.
+ */
+import type { CSSProperties } from 'react';
+export type NodeStyle = CSSProperties & Record<`--${string}`, string | number>;
\ No newline at end of file
diff --git a/docs-internal/theme_system.md b/docs-internal/theme_system.md
index 8202ac14..76da5c57 100644
--- a/docs-internal/theme_system.md
+++ b/docs-internal/theme_system.md
@@ -217,7 +217,12 @@ Result by theme (display font / tracking / case):
## What's done vs deferred
### Done
-- **Token contract**: all 10 themes ported in [client/src/themes/](../client/src/themes) (5 utopian + 5 dystopian). 13 CSS files, 3,749 LOC total.
+- **Audio fix** (W20) — `--sound-pack: chime` typo in `light.css` + `dark.css` was silently falling through to `'none'` (`chime` not in the engine's pack registry), making sound silent for the most-used themes. Renamed `light` → `parchment`, `dark` → `terminal`. Added `Sounds.unlock()` exported from [lib/sound.ts](../client/src/lib/sound.ts) plus a one-shot `pointerdown / keydown / touchstart` capture-phase listener in `useSoundSync()` ([hooks/useSound.ts](../client/src/hooks/useSound.ts)) so the AudioContext resumes on the user's first gesture (Chrome / Safari autoplay policy compliance).
+- **Canvas-node visual contract** (W21) — every node component (`AIAgentNode`, `SquareNode`, `GenericNode`, `TriggerNode`, `StartNode`, `ToolkitNode`, `TeamMonitorNode`) stripped its inline `background` / `border` / `borderRadius` / `boxShadow` / `animation` props. Each now exposes the per-definition accent hex via `style={{ '--node-color': accentColor }}` on its outer wrapper. Visual styling lives in [base.css](../client/src/themes/base.css) defaults + per-theme overrides; `var(--node-color)` carries the plugin's `visuals.json` accent through CSS without fighting specificity. New `NodeStyle` helper type in [client/src/types/NodeTypes.ts](../client/src/types/NodeTypes.ts) (`React.CSSProperties & Record<\`--${string}\`, string | number>`) makes the inline custom-prop typecheck-clean.
+- **Per-theme icons** (W23) — [client/src/assets/icons/themedGlyphs.ts](../client/src/assets/icons/themedGlyphs.ts) ports all 290 SVG glyphs from `design_handoff_machinaos_themes/app/icons.js` (29 keys × 10 themes). [NodeIcon.tsx](../client/src/assets/icons/NodeIcon.tsx) consults `THEMED_GLYPHS[activeTheme][key]` first; falls through to `lucide-react` / `lobehub:` / `asset:` dispatch on miss. Renaissance gets heraldic shields, Cyber wireframe + glow, Plague woodcut hatching, etc. Light + dark themes have no entries — they fall through to existing dispatch.
+- **Canvas grid + cursors** (W24) — `--canvas-grid` and `--cursor-default` slots declared in [base.css](../client/src/themes/base.css) and bound to `.canvas-host`. Per-theme grids: Cyber 24px magenta+cyan grid, Surveillance CCTV crosshair + REC overlay, Renaissance fleur-de-lis cartography, Greek key meander, Steampunk brass bolt grid, Atomic mid-century starburst, Wasteland cracked-earth fissures, Rot flagstone, Plague broadsheet red-X. Custom cursors: Cyber crosshair reticle, Surveillance snooper reticle, Renaissance gold-leaf quill.
+- **Decorative HTML primitives** (W25) — [client/src/components/SvgFilterDefs.tsx](../client/src/components/SvgFilterDefs.tsx) mounts a hidden inline `<svg><defs>` at app root exposing `#ink-blot` (Renaissance edge warble), `#noise` (Wasteland turbulence), `#crt` (Cyber chromatic aberration) so per-theme `filter: url(#...)` rules resolve. [client/src/components/ui/DropCap.tsx](../client/src/components/ui/DropCap.tsx) wraps content with `v-display drop-cap` className so the Renaissance `::first-letter` ornament rule fires.
+- **Token contract**: all 10 themes ported in [client/src/themes/](../client/src/themes) (5 utopian + 5 dystopian). 13 CSS files, ~3,750 LOC total.
- **ThemeProvider** ([client/src/contexts/ThemeContext.tsx](../client/src/contexts/ThemeContext.tsx)) — 10-way `ThemeName`, `DARK_FAMILY` ⊃ `{dark, cyber, wasteland, rot, surveillance, steampunk}`, legacy `darkMode` localStorage migration on first load
- **ThemeSwitcher** — DropdownMenu grouped into System / Utopian / Dystopian sections, all 10 themes
- **Tailwind v4 `@theme inline`** exposing new-contract utilities (`bg-bg-app`, `text-fg-default`, `border-border-default`, `font-display`, `font-body`, `rounded-pill`)
@@ -235,10 +240,8 @@ Result by theme (display font / tracking / case):
- **Canvas overlay packs** — [client/src/hooks/useAppTheme.ts](../client/src/hooks/useAppTheme.ts) extended from 2-way (`{light, dark}`) to 10-way: a `THEME_OVERRIDES` map applies a small overlay (primary, focus, focusRing, action colours, edge palette) on top of `lightColors` / `darkColors`. Existing call sites continue to read `theme.colors.X` and `theme.isDarkMode` unchanged; canvas selection rings, action buttons, and edge strokes pick up the active theme's accents under any of the 10 themes.
### Deferred (future PRs)
-- **Per-theme icon sets** — the upstream [`app/icons.js`](../design_handoff_machinaos_themes/app/icons.js) ships 28-key glyph sets per theme (heraldic shields under Renaissance, wireframe + glow under Cyber, woodcut hatching under Plague, etc.). The current shell uses `lucide-react` icons under all themes via `currentColor`, which retints correctly via the bridge but doesn't carry per-theme glyph language. Migration recipe: build `client/src/icons/` with an `<Icon name>` component that reads the active theme via `useTheme()` and resolves to one of 10 SVG-string sets. Lucide stays as a fallback for missing keys.
-- **Drop-cap `::first-letter`** — Renaissance `.v-display.drop-cap` selector ports verbatim but needs an HTML wrapper component before the rule resolves. Add a `<DisplayHeading dropCap>` primitive when next touching the chrome.
-- **Edge SVG filters** — Renaissance `.edge path { filter: url(#ink-blot) }` needs an inline `<svg><defs>` injected into the React tree.
-- **Cursor SVG reticles** — Cyber crosshair, Renaissance quill, Surveillance reticle: `cursor: url(...)` rules in per-theme CSS, low ROI.
+- **`--*-soft` token family** — `--info-soft`, `--warning-soft`, `--danger-soft`, `--success-soft` are referenced across multiple theme rules (greek, atomic, wasteland, plague, action-deploy, chat-msg-user, wf-card.selected, cmdk-item.active, action-run) but never declared. W22 patched the four `.sq-node.selected .sq-node-box` references to inline alpha composition (`hsl(var(--info) / 0.25)` etc.); the broader pattern is tech debt. Centralise the family as alpha-composed pairs alongside their base tokens (e.g. `--info-soft: <hsl-triplet> / 0.18`) in [client/src/index.css](../client/src/index.css).
+- **Edo / Steampunk / Atomic canvas-host pseudo-element decorations** — these themes' richer canvas overlays (Edo radial-gradient ink-wash mountain, Steampunk corner radial accents, Atomic dot constellation) are pseudo-element decorations rather than tileable `--canvas-grid` patterns; W24 ported the tileable layer only. Wire via `.canvas::before/::after` rules in a future pass if needed.
- **Parameter panel internals** — `MiddleSection`, `MasterSkillEditor`, `ParameterRenderer` consume shadcn tokens through the bridge so they retint correctly, but their interior section headers don't yet carry the display-typography triplet. Apply the recipe (`font-display tracking-[var(--type-tracking-display)] text-fg-default [text-transform:var(--type-uppercase)]`) when next touched.
- **Credentials modal sub-panels** — `OAuthPanel`, `EmailPanel`, `ApiKeyPanel`, `QrPairingPanel` headers same pattern.
@@ -289,6 +292,32 @@ The `.selected` co-class is bound to React Flow's `selected` prop on every canva
`var(--accent)` etc. handoff reads were wrapped to `hsl(var(--accent))` for shadcn-bridged tokens; theme-specific spot colours (`--gold`, `--crimson`, `--neon-magenta`, `--rec-red`) port verbatim as hex.
+## Canvas-node visual contract (W21)
+
+Every canvas-node React component renders against pure CSS for visual styling. The component is responsible for:
+
+1. **Setting `--node-color` inline** on its outer wrapper:
+ ```tsx
+ <div
+ className={`node node-agent ${selected ? 'selected' : ''}`}
+ style={{ '--node-color': accentColor, /* layout only */ } as NodeStyle}
+ >
+ ```
+ `accentColor` comes from the plugin's `visuals.json` accent hex via `useNodeSpec(type)`.
+
+2. **Keeping ONLY layout inline** — `position`, `padding`, `display`, `flex*`, `gap`, `width`, `height`, `transition`, `cursor`, `fontFamily`, `fontSize`. React Flow `<Handle>` positioning (`position: absolute; left/top/right/bottom`) MUST stay inline.
+
+3. **Letting CSS own everything visual** — `background`, `border`, `borderRadius`, `boxShadow`, `animation` live in [base.css](../client/src/themes/base.css) defaults + per-theme overrides. Both consume `var(--node-color)` for accent surfaces.
+
+`NodeStyle` ([types/NodeTypes.ts](../client/src/types/NodeTypes.ts)) is the helper type for inline custom-prop typecheck-cleanliness:
+```ts
+export type NodeStyle = React.CSSProperties & Record<`--${string}`, string | number>;
+```
+
+The `selected` co-class (driven by React Flow's `selected` prop) and the `data-executing` attribute (driven by SquareNode's `isGlowing` minimum-glow timer) toggle execution / selection visuals via CSS. The wider `.react-flow__node.executing .node` selector is bound by `client/src/styles/canvasAnimations.ts` for the standard pulse animation.
+
+**Anti-pattern:** never set `background` / `border` / `borderRadius` / `boxShadow` inline on canvas-node components. Inline styles win specificity and block per-theme decorations from rendering.
+
## Sound system
Each theme declares `--sound-pack: "<pack>"` in its `:root[data-theme="..."]` block. Pack names map to event tables in [client/src/lib/sound.ts](../client/src/lib/sound.ts):
@@ -431,6 +460,12 @@ cd client && npx eslint <files>
| [client/src/components/ui/CommandPaletteHost.tsx](../client/src/components/ui/CommandPaletteHost.tsx) | Registered command set |
| [client/src/components/ui/action-button.tsx](../client/src/components/ui/action-button.tsx) | CVA action role primitive (fires `play('click')`) |
| [client/src/components/ui/Modal.tsx](../client/src/components/ui/Modal.tsx) | Shared modal layout (fires `play('modalOpen'/'modalClose')`) |
+| [client/src/assets/icons/themedGlyphs.ts](../client/src/assets/icons/themedGlyphs.ts) | Per-theme SVG glyph map (29 keys × 10 themes) — Wave 23 |
+| [client/src/assets/icons/NodeIcon.tsx](../client/src/assets/icons/NodeIcon.tsx) | Theme-aware icon resolver (consults THEMED_GLYPHS first) |
+| [client/src/components/SvgFilterDefs.tsx](../client/src/components/SvgFilterDefs.tsx) | Inline `<svg><defs>` carrying `#ink-blot` / `#noise` / `#crt` filter IDs — Wave 25 |
+| [client/src/components/ui/DropCap.tsx](../client/src/components/ui/DropCap.tsx) | `v-display drop-cap` wrapper for Renaissance ornament rule — Wave 25 |
+| [client/src/types/NodeTypes.ts](../client/src/types/NodeTypes.ts) | `NodeStyle` helper type for inline `--*` custom props — Wave 21 |
| [client/index.html](../client/index.html) | Google Fonts loading (all 10 themes' typefaces) |
| [design_handoff_machinaos_themes/](../design_handoff_machinaos_themes/) | Reference HTML mocks + token spec |
-| [design_handoff_machinaos_themes/MIGRATION_PLAYBOOK.md](../design_handoff_machinaos_themes/MIGRATION_PLAYBOOK.md) | Upstream recipe for the 4 deferred items (canvas, headers, decorative wrapper, sound) — all now landed |
+| [design_handoff_machinaos_themes/app/icons.js](../design_handoff_machinaos_themes/app/icons.js) | Upstream icon source (ported by Wave 23) |
+| [design_handoff_machinaos_themes/MIGRATION_PLAYBOOK.md](../design_handoff_machinaos_themes/MIGRATION_PLAYBOOK.md) | Upstream recipe — all originally-deferred items now landed (W14–W25) |