@engenty/wizards-runtime 0.7.8 → 0.7.10

package/bin/wizards.mjs

@@ -4,8 +4,8 @@
 //
 // The same file is two things. In the npm package `wizards` (`npx wizards`, `npm install -g
 // wizards`) it is the launcher, with nothing beside it but the installer (install.sh) and no
-// dependencies: on macOS and Linux it installs engenty wizards into ~/.engenty/wizards with that
-// installer (its own Node, the runtime @engenty/wizards-runtime, the `wizards` command), brings an
+// dependencies: it installs engenty wizards into ~/.engenty/wizards with that installer (on Windows
+// install.ps1: its own Node, the runtime @engenty/wizards-runtime, the `wizards` command), brings an
 // older install there up to its own version, and hands the command to it. In the runtime, which
 // the installer puts there, it is the command itself.
 //
@@ -27,17 +27,24 @@ const home = join(
   "wizards",
 );
 const runtime = join(home, "runtime");
-const wrapper = join(home, "bin", "wizards");
+const windows = process.platform === "win32";
+const wrapper = join(home, "bin", windows ? "wizards.cmd" : "wizards");
 /** The runtime's npm package. Up to 0.7.4 it was `wizards` itself; that name is the launcher now. */
 const RUNTIME = "@engenty/wizards-runtime";
 /** Whether this copy is the runtime, or the launcher without it. */
 const hasRuntime = existsSync(join(root, "apps", "runtime", "dist", "cli", "main.js"));
 /** The installer: beside the launcher, or in the runtime's built SPA. */
-const installer = [join(root, "install.sh"), join(root, "apps", "web", "dist", "install.sh")].find(
-  (file) => existsSync(file),
-);
+const installerName = windows ? "install.ps1" : "install.sh";
+const installer = [
+  join(root, installerName),
+  join(root, "apps", "web", "dist", installerName),
+].find((file) => existsSync(file));
 // uninstall: never installs or hands over first; the install it takes away may no longer run.
 const RUN_HERE = ["help", "validate", "mcp", "uninstall"];
+/** The installer's line, as a person types it here. */
+const installLine = windows
+  ? "  irm https://engenty.ai/install.ps1 | iex\n"
+  : "  curl -fsSL https://engenty.ai/install.sh | bash\n";
 const tilde = (path) =>
   path.startsWith(homedir() + sep) ? `~${path.slice(homedir().length)}` : path;
 
@@ -112,7 +119,12 @@ function isInstall() {
 function terminalEnv() {
   const env = {};
   for (const [key, value] of Object.entries(process.env)) {
-    if (!key.startsWith("npm_") && !["INIT_CWD", "NODE", "COLOR"].includes(key)) {
+    // PATH comes after, once: Windows calls it Path, and two of them would leave one to chance.
+    if (
+      !key.startsWith("npm_") &&
+      !["INIT_CWD", "NODE", "COLOR"].includes(key) &&
+      key.toUpperCase() !== "PATH"
+    ) {
       env[key] = value;
     }
   }
@@ -128,7 +140,10 @@ function install(version, quiet) {
   if (!installer) {
     return false;
   }
-  const result = spawnSync("bash", [installer, "--no-setup"], {
+  const [shell, ...shellArgs] = windows
+    ? ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", installer, "-NoSetup"]
+    : ["bash", installer, "--no-setup"];
+  const result = spawnSync(shell, shellArgs, {
     // A command whose output is read (validate --json, mcp) keeps its stdout to itself.
     stdio: ["ignore", quiet ? 2 : "inherit", "inherit"],
     env: {
@@ -161,10 +176,29 @@ function runs() {
   }
 }
 
+/**
+ * The installed command with these arguments. On Windows its Node and script, which is what
+ * wizards.cmd runs: a .cmd file starts only through cmd.exe, which would read the arguments again.
+ */
+function installedCommand(argv) {
+  if (!windows) {
+    return [wrapper, argv];
+  }
+  const script = join(runtime, "current", "node_modules", RUNTIME, "bin", "wizards.mjs");
+  return [join(home, "tools", "node", "node.exe"), [script, ...argv]];
+}
+
+/** Runs the installed command with these arguments, waiting for it. */
+function installedRun(argv, quiet) {
+  const [file, all] = installedCommand(argv);
+  spawnSync(file, all, { stdio: ["ignore", quiet ? 2 : "inherit", "inherit"], env: terminalEnv() });
+}
+
 /** Runs the installed command with these arguments; its exit code. */
 function handOver() {
   return new Promise((done) => {
-    const child = spawn(wrapper, args, { stdio: "inherit", env: terminalEnv() });
+    const [file, argv] = installedCommand(args);
+    const child = spawn(file, argv, { stdio: "inherit", env: terminalEnv() });
     // Ctrl-C reaches the installed command as well (same terminal); this one waits for it.
     process.on("SIGINT", () => undefined);
     process.on("SIGTERM", () => child.kill("SIGTERM"));
@@ -184,19 +218,6 @@ if (command === "version") {
 const own = versionOf(root) || "0.0.0";
 const quiet = RUN_HERE.includes(command);
 const checkout = existsSync(join(root, "pnpm-workspace.yaml"));
-// Windows has no installer yet, and the setup, the service and the AI clients are written for
-// macOS and Linux: it says so instead of half working. What needs no install still runs.
-if (process.platform === "win32" && !checkout && !(hasRuntime && RUN_HERE.includes(command))) {
-  console.error(
-    "engenty wizards for Windows is coming soon.\n\n" +
-      "Until then it runs in WSL (Windows Subsystem for Linux). In PowerShell:\n\n" +
-      "  wsl --install\n\n" +
-      "then, in the Ubuntu terminal that opens:\n\n" +
-      "  curl -fsSL https://engenty.ai/install.sh | bash\n\n" +
-      "https://engenty.ai/docs/user/install\n",
-  );
-  process.exit(1);
-}
 if (isInstall() && !hasRuntime) {
   // The launcher in the install's place: an update of 0.7.4 or older fetched `wizards`, the
   // runtime's name then, and its next start switched to it. The installer it carries brings the
@@ -217,7 +238,7 @@ if (isInstall() && !hasRuntime) {
   }
   process.exit(await handOver());
 }
-const fromNpm = process.platform !== "win32" && !checkout && !isInstall();
+const fromNpm = !checkout && !isInstall();
 if (fromNpm && command === "uninstall" && !hasRuntime) {
   // The install's own uninstall takes it away; it never updates first. An install the update
   // left without its runtime gets it back (above, in the installed command) and then uninstalls.
@@ -235,15 +256,18 @@ if (
   const installed = installedVersion();
   if (!installed || older(installed, own)) {
     const running = installed && runs();
-    if (install(own, quiet)) {
-      // What runs is still the old version: it starts again as the new one.
-      if (running) {
-        spawnSync(wrapper, ["restart"], {
-          stdio: ["ignore", quiet ? 2 : "inherit", "inherit"],
-          env: terminalEnv(),
-        });
-      }
-    } else if (hasRuntime && currentNode && !installed) {
+    // Windows keeps the files of a running program locked: the runtime stops for the update.
+    if (running && windows) {
+      installedRun(["stop"], quiet);
+    }
+    const done = install(own, quiet);
+    // What ran is still the old version: it starts again as the new one.
+    if (running && windows) {
+      installedRun(["start", "--background", "--no-open"], quiet);
+    } else if (running && done) {
+      installedRun(["restart"], quiet);
+    }
+    if (!done && hasRuntime && currentNode && !installed) {
       console.error(
         `The install into ${tilde(home)} failed; this time engenty wizards runs from npm.\n`,
       );
@@ -259,14 +283,14 @@ if (
   if (!hasRuntime) {
     console.error(
       `engenty wizards couldn’t be installed into ${tilde(home)}. The installer on its own:\n\n` +
-        "  curl -fsSL https://engenty.ai/install.sh | bash\n",
+        installLine,
     );
     process.exit(1);
   }
 }
 if (!currentNode && command === "uninstall") {
   // The install's own Node, if it is still there, runs this copy's uninstall.
-  const node = join(home, "tools", "node", "bin", "node");
+  const node = join(home, "tools", "node", windows ? "node.exe" : "bin/node");
   const result = existsSync(node)
     ? spawnSync(node, [fileURLToPath(import.meta.url), ...args], { stdio: "inherit" })
     : null;
@@ -276,7 +300,7 @@ if (!currentNode) {
   console.error(
     `engenty wizards needs Node.js 24.11 or newer. This is ${process.version}.\n` +
       "The installer brings its own and leaves yours alone:\n\n" +
-      "  curl -fsSL https://engenty.ai/install.sh | bash\n",
+      installLine,
   );
   process.exit(1);
 }

package/node_modules/@engenty/wizards/package.json

@@ -6,9 +6,6 @@
   "exports": {
     "./plugin": "./dist/plugin/index.js",
     "./plugin/studio": "./dist/plugin/studio.js",
-    "./plugin/thread": "./dist/plugin/thread.js",
-    "./openui": "./dist/openui/index.js",
-    "./openui/server": "./dist/openui/server.js",
-    "./openui/styles.css": "./src/openui/styles.css"
+    "./plugin/thread": "./dist/plugin/thread.js"
   }
 }

package/node_modules/@engenty-wizards/shared/dist/claude-plugin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The Claude Code plugin `wizards` comes from two marketplaces: `engenty`, the GitHub repository
+ * engenty/wizards, and one each deployment serves with its own server bundled. The served one is
+ * named after the deployment's host, so a person can add both: `wizards@engenty` and
+ * `wizards@wizards-example-com`.
+ */
+export declare const marketplaceNameOf: (appUrl: string) => string;

package/node_modules/@engenty-wizards/shared/dist/claude-plugin.js

@@ -0,0 +1,10 @@
+/**
+ * The Claude Code plugin `wizards` comes from two marketplaces: `engenty`, the GitHub repository
+ * engenty/wizards, and one each deployment serves with its own server bundled. The served one is
+ * named after the deployment's host, so a person can add both: `wizards@engenty` and
+ * `wizards@wizards-example-com`.
+ */
+export const marketplaceNameOf = (appUrl) => new URL(appUrl).host
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");

package/node_modules/@engenty-wizards/shared/dist/run.d.ts

@@ -243,6 +243,8 @@ declare const NOTES_EN: {
     readonly wizardLimit: "This wizard has reached its limit for today. Try again tomorrow.";
     readonly confirmHuman: "Confirm that you’re a person.";
     readonly tooManyRuns: "You’ve started a lot of runs just now. Try again in an hour.";
+    readonly clientRefused: "This app may not start runs here.";
+    readonly clientLimit: "This app has started a lot of runs just now. Try again later.";
     readonly runOver: "The run is over.";
     readonly runBusy: "The wizard is working right now.";
     readonly pageOutdated: "This page is out of date.";

package/node_modules/@engenty-wizards/shared/dist/run.js

@@ -76,6 +76,8 @@ const NOTES_EN = {
     wizardLimit: "This wizard has reached its limit for today. Try again tomorrow.",
     confirmHuman: "Confirm that you’re a person.",
     tooManyRuns: "You’ve started a lot of runs just now. Try again in an hour.",
+    clientRefused: "This app may not start runs here.",
+    clientLimit: "This app has started a lot of runs just now. Try again later.",
     runOver: "The run is over.",
     runBusy: "The wizard is working right now.",
     pageOutdated: "This page is out of date.",
@@ -367,6 +369,8 @@ const NOTES_DE = {
     wizardLimit: "Für heute ist das Limit dieses Wizards erreicht. Versuch es morgen wieder.",
     confirmHuman: "Bestätige kurz, dass du ein Mensch bist.",
     tooManyRuns: "Du hast gerade viele Läufe gestartet. Versuch es in einer Stunde wieder.",
+    clientRefused: "Diese App darf hier keine Läufe starten.",
+    clientLimit: "Diese App hat gerade viele Läufe gestartet. Versuch es später wieder.",
     runOver: "Der Lauf ist beendet.",
     runBusy: "Der Wizard arbeitet gerade.",
     pageOutdated: "Diese Seite ist nicht mehr aktuell.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engenty/wizards-runtime",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "description": "Make a wish. Get your wizard. It guides you step by step. Let AI do the work. Runs on your machine, on the AI subscription you already have. The runtime, which `npx wizards` installs.",
   "license": "FSL-1.1-MIT",
   "homepage": "https://engenty.ai",
@@ -15,10 +15,6 @@
   "engines": {
     "node": ">=24.11"
   },
-  "os": [
-    "darwin",
-    "linux"
-  ],
   "files": [
     "apps",
     "bin",
@@ -50,6 +46,7 @@
     "@turbodocx/html-to-docx": "1.23.1",
     "ai": "7.0.102",
     "aws4fetch": "1.0.20",
+    "cross-spawn": "7.0.6",
     "drizzle-orm": "0.45.3",
     "effect": "4.0.0-beta.59",
     "exceljs": "4.4.0",

package/plugin/.claude-plugin/plugin.json

@@ -1,9 +1,31 @@
 {
-  "name": "engenty-wizards",
+  "name": "wizards",
   "displayName": "engenty wizards",
-  "version": "{{VERSION}}",
-  "description": "Build page-by-page AI wizards that people open on a shared link — designed, tested and published from Claude Code — and run your published ones right in the chat.",
-  "author": { "name": "engenty" },
-  "homepage": "{{APP_URL}}",
-  "keywords": ["wizards", "forms", "ai-workflows", "mcp"]
+  "version": "0.7.10",
+  "description": "Build page-by-page AI wizards that people open on a shared link — designed, tested and published from Claude Code — run your published ones in the chat, and keep them in a pane beside it.",
+  "author": {
+    "name": "engenty"
+  },
+  "homepage": "https://engenty.ai",
+  "keywords": [
+    "wizards",
+    "forms",
+    "ai-workflows",
+    "mcp"
+  ],
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "server": {
+      "type": "string",
+      "title": "Wizards server",
+      "description": "The MCP server of the wizards runtime, as /mcp lists it. The plugin's own (engenty-wizards) when left as is.",
+      "default": "engenty-wizards"
+    },
+    "browser": {
+      "type": "string",
+      "title": "Browser pane",
+      "description": "The MCP server of the app's browser pane, whose navigate tool opens a wizard beside the chat.",
+      "default": "Claude_Browser"
+    }
+  }
 }

package/plugin/README.md

@@ -0,0 +1,58 @@
+# wizards, the Claude Code plugin
+
+The plugin a running engenty wizards serves at `<APP_URL>/api/claude-plugin/marketplace.json`,
+with its own address filled in. It holds:
+
+- **`/wizard <what it should do>`** builds a wizard from a description, with the `build-wizard`
+  skill: authoring guide, closest starter, issues fixed, one test run, the studio link.
+- **`use-wizard`**, the skill that runs one of your published wizards here in the chat.
+- **`/wizards`**, a pane beside the chat with your wizards: each one's engenty, name and
+  description. **Run** opens the wizard's own page in the app's browser pane, beside the chat,
+  where you fill it as any person would. **Edit** puts a change request into the chat for you to
+  finish. The pane opens by itself when the plugin loads; `/wizards close` closes it. A run the
+  model drives through the server's tools opens its page beside the chat once it waits for you.
+
+The pane is a mod: a hooks module in `hooks/register.tsx` drawing with the engine's elements,
+its state declared in `types/index.d.ts`. `claude plugin validate plugin` checks it,
+`claude plugin test plugin` runs `hooks/pane.test.tsx` against the engine.
+
+## Install
+
+From GitHub, for the `engenty-wizards` MCP server you already have (the local install writes it
+into your AI apps; `claude mcp add --transport http engenty-wizards <APP_URL>/api/mcp` adds a
+hosted one):
+
+```bash
+claude plugin marketplace add engenty/wizards
+claude plugin install wizards@engenty
+```
+
+From a running engenty wizards with a public https address, which bundles its own server:
+
+```bash
+claude plugin marketplace add <APP_URL>/api/claude-plugin/marketplace.json
+claude plugin install wizards@<host-with-dashes>   # wizards.example.com → wizards-example-com
+```
+
+`claude plugin update wizards` brings the next version.
+
+## Permissions in auto mode
+
+The pane calls the server itself, from a button press, not from a model request. In auto mode
+such a call has no classifier verdict and is refused unless an allow rule names the tool. Put
+these in `permissions.allow` of `.claude/settings.local.json` or your user settings:
+
+```json
+["mcp__plugin_wizards_engenty-wizards", "mcp__Claude_Browser__navigate"]
+```
+
+A server you configured yourself under the name `engenty-wizards` is `mcp__engenty-wizards`
+instead. The browser pane's `navigate` may still ask you; the pane then shows a plain link to
+the same page.
+
+## Options
+
+| Option    | Default           | What it names                                              |
+| --------- | ----------------- | ---------------------------------------------------------- |
+| `server`  | `engenty-wizards` | the wizards runtime's MCP server, as `/mcp` lists it        |
+| `browser` | `Claude_Browser`  | the app's browser pane, whose `navigate` opens a page       |

package/plugin/hooks/engenty.ts

@@ -0,0 +1,140 @@
+/**
+ * The flat engenties of the studio (apps/web/src/engenty/engenty.tsx) at rest, as one SVG
+ * string per kind: the same bodies, the one eye, no animation. The fills are the studio's
+ * defaults (ENGENTY_FILL in apps/web/src/engenty/colors.ts).
+ */
+
+const FILL = {
+  cobalt: "oklch(60% 0.23 262)",
+  amber: "oklch(82% 0.17 78)",
+  moss: "oklch(72% 0.22 145)",
+  rose: "oklch(64% 0.25 18)",
+  ember: "oklch(70% 0.21 42)",
+  teal: "oklch(74% 0.16 192)",
+  violet: "oklch(60% 0.25 300)",
+  magenta: "oklch(65% 0.28 345)",
+  citron: "oklch(89% 0.2 118)",
+  slate: "oklch(66% 0.13 235)",
+} as const;
+
+type Eye = { ex: number; ey: number; r: number; ink: string };
+
+type Kind = {
+  fill: string;
+  body: string;
+  eye: Eye;
+  shadow: { cy: number; rx: number };
+  /** Marks drawn before the body (a sprout's leaves). */
+  under?: string;
+  /** Marks drawn over the body, before the eye. */
+  over?: string;
+  /** Marks drawn after the eye (a mouth, a dot). */
+  after?: string;
+};
+
+const stroke = (d: string, color: string, width: number, opacity: number) =>
+  `<path d="${d}" fill="none" stroke="${color}" stroke-width="${width}" stroke-linecap="round" opacity="${opacity}"/>`;
+
+const KINDS: Record<string, Kind> = {
+  round: {
+    fill: FILL.cobalt,
+    body: "M60 22 Q96 26 96 62 Q96 96 60 100 Q24 96 24 62 Q24 26 60 22 Z",
+    over: `<circle cx="97" cy="34" r="6" fill="${FILL.cobalt}" opacity="0.5"/><circle cx="106" cy="24" r="3.5" fill="${FILL.cobalt}" opacity="0.35"/>`,
+    eye: { ex: 68, ey: 58, r: 8, ink: "oklch(18% 0.08 260)" },
+    shadow: { cy: 108, rx: 26 },
+  },
+  drop: {
+    fill: FILL.amber,
+    body: "M60 16 Q90 34 90 66 Q90 96 60 98 Q30 96 30 66 Q30 34 60 16 Z",
+    eye: { ex: 60, ey: 56, r: 8, ink: "oklch(30% 0.10 60)" },
+    after: stroke("M48 76 Q54 72 60 76 Q66 80 72 76", "oklch(30% 0.10 55)", 2.6, 1),
+    shadow: { cy: 106, rx: 24 },
+  },
+  dome: {
+    fill: FILL.moss,
+    body: "M60 20 Q92 30 92 70 Q92 96 60 96 Q28 96 28 70 Q28 30 60 20 Z",
+    over: `${stroke("M46 90 L46 80 M60 92 L60 82 M74 90 L74 80", "oklch(28% 0.10 155)", 2.4, 0.5)}<circle cx="60" cy="6" r="3" fill="${FILL.moss}"/>`,
+    eye: { ex: 60, ey: 54, r: 8.5, ink: "oklch(16% 0.08 160)" },
+    shadow: { cy: 104, rx: 27 },
+  },
+  flame: {
+    fill: FILL.rose,
+    body: "M60 14 Q84 44 80 76 Q78 98 60 98 Q42 98 40 76 Q36 44 60 14 Z",
+    over: stroke("M40 20 Q60 6 80 20", FILL.rose, 3, 0.55),
+    eye: { ex: 60, ey: 62, r: 8, ink: "oklch(22% 0.10 18)" },
+    after: '<circle cx="60" cy="82" r="2.6" fill="oklch(22% 0.10 18)"/>',
+    shadow: { cy: 106, rx: 22 },
+  },
+  oval: {
+    fill: FILL.ember,
+    body: "M60 34 Q100 38 100 64 Q100 92 60 94 Q20 92 20 64 Q20 38 60 34 Z",
+    over:
+      stroke("M28 54 Q60 48 92 54", "oklch(40% 0.16 30)", 2.2, 0.45) +
+      stroke("M26 70 Q60 64 94 70", "oklch(40% 0.16 30)", 2.2, 0.45),
+    eye: { ex: 66, ey: 58, r: 8, ink: "oklch(24% 0.10 30)" },
+    shadow: { cy: 102, rx: 32 },
+  },
+  bean: {
+    fill: FILL.teal,
+    body: "M48 96 Q24 92 26 68 Q28 44 52 38 Q78 32 88 50 Q98 66 84 84 Q70 100 48 96 Z",
+    over: `<circle cx="32" cy="94" r="4" fill="${FILL.teal}" opacity="0.4"/>`,
+    eye: { ex: 70, ey: 58, r: 8, ink: "oklch(18% 0.08 200)" },
+    shadow: { cy: 102, rx: 26 },
+  },
+  pebble: {
+    fill: FILL.slate,
+    body: "M60 96 Q20 96 18 78 Q16 60 46 56 Q78 52 98 62 Q110 72 104 86 Q98 96 60 96 Z",
+    over: '<g fill="oklch(30% 0.05 244)" opacity="0.32"><circle cx="42" cy="76" r="3"/><circle cx="56" cy="86" r="2.2"/><circle cx="86" cy="80" r="2.6"/></g>',
+    eye: { ex: 68, ey: 72, r: 7.5, ink: "oklch(20% 0.06 244)" },
+    shadow: { cy: 102, rx: 34 },
+  },
+  sprout: {
+    fill: FILL.citron,
+    under: `<g fill="${FILL.citron}"><ellipse cx="48" cy="34" rx="6" ry="10"/><ellipse cx="72" cy="32" rx="5.5" ry="9"/></g>`,
+    body: "M60 100 Q28 98 28 72 Q28 46 60 44 Q92 46 92 72 Q92 98 60 100 Z",
+    eye: { ex: 60, ey: 68, r: 8.5, ink: "oklch(24% 0.09 108)" },
+    shadow: { cy: 106, rx: 26 },
+  },
+  tower: {
+    fill: FILL.violet,
+    body: "M60 102 Q36 100 38 78 Q40 58 42 44 Q44 26 60 24 Q76 26 78 44 Q80 58 82 78 Q84 100 60 102 Z",
+    over:
+      stroke("M42 74 Q60 70 78 74", "oklch(28% 0.10 308)", 2.2, 0.4) +
+      stroke("M40 88 Q60 84 80 88", "oklch(28% 0.10 308)", 2.2, 0.4),
+    eye: { ex: 60, ey: 52, r: 8, ink: "oklch(20% 0.09 308)" },
+    shadow: { cy: 108, rx: 20 },
+  },
+  wedge: {
+    fill: FILL.magenta,
+    body: "M60 30 Q74 40 86 70 Q96 92 78 98 Q60 102 42 98 Q24 92 34 70 Q46 40 60 30 Z",
+    over: stroke("M52 22 Q60 14 68 22", FILL.magenta, 3, 0.5),
+    eye: { ex: 60, ey: 70, r: 8, ink: "oklch(22% 0.10 345)" },
+    shadow: { cy: 106, rx: 28 },
+  },
+};
+
+const kindOf = (kind: string | undefined): Kind => KINDS[kind ?? "round"] ?? KINDS.round!;
+
+/** The one eye: white, a pupil, a glint. */
+const eye = ({ ex, ey, r, ink }: Eye) =>
+  `<ellipse cx="${ex}" cy="${ey}" rx="${r}" ry="${r * 1.15}" fill="#fff"/>` +
+  `<circle cx="${ex}" cy="${ey + 1}" r="${r * 0.48}" fill="${ink}"/>` +
+  `<circle cx="${ex - r * 0.25}" cy="${ey - r * 0.3}" r="${r * 0.18}" fill="#fff"/>`;
+
+/** The engenty of a kind at rest, `size` pixels square. */
+export function engentySvg(kind: string | undefined, size: number): string {
+  const k = kindOf(kind);
+  return (
+    `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="${size}" height="${size}" overflow="visible">` +
+    `<ellipse cx="60" cy="${k.shadow.cy}" rx="${k.shadow.rx}" ry="4.5" fill="#000" opacity="0.14"/>` +
+    (k.under ?? "") +
+    `<path d="${k.body}" fill="${k.fill}"/>` +
+    (k.over ?? "") +
+    eye(k.eye) +
+    (k.after ?? "") +
+    "</svg>"
+  );
+}
+
+/** The body colour of a kind, for a surface that draws no SVG. */
+export const engentyColor = (kind: string | undefined) => kindOf(kind).fill;

package/plugin/hooks/hooks.json

@@ -0,0 +1 @@
+{ "modules": ["./register.tsx"] }