@downdraft/engine 0.1.2-alpha.5 → 0.3.0

package/dist/core/src/worker/sim-worker-base.js

@@ -38,7 +38,7 @@ import "../sab/sab-polyfill.js";
 import { usingRealSAB } from "../sab/sab-polyfill.js";
 import { mulberry32 } from "../math/rng.js";
 import { createLogger } from "../util/logger.js";
-import { expose, exposeEvents } from "./rpc.js";
+import { expose, exposeBatchedEvents } from "./rpc.js";
 const log = createLogger();
 /**
  * Detect deterministic/test mode inside a worker. `DOWNDRAFT_DETERMINISTIC`
@@ -158,7 +158,7 @@ export function createSimWorker(opts) {
     let tickInFlight = null;
     // Serializes withLoopStopped critical sections.
     let stopChain = Promise.resolve();
-    const events = exposeEvents();
+    const events = exposeBatchedEvents();
     // Deterministic RNG — reseedable via control.setSeed(); the stable `rng`
     // closure is what ctx.rng and the Math.random shim draw from.
     let rngImpl = mulberry32(opts.seed ?? 0x9e3779b9);
@@ -423,6 +423,9 @@ export function createSimWorker(opts) {
             syncWorker = null; // release sync worker reference
             saveStore = null;
             await opts.onShutdown?.();
+            // Drain any events queued during onShutdown so they aren't lost to
+            // a flush timer the terminating worker never runs.
+            events.flush();
         },
         async setSpeed(speed) {
             speedMultiplier = Math.min(opts.maxSpeed ?? Infinity, Math.max(opts.minSpeed ?? 0, speed));
@@ -550,7 +553,7 @@ export function createSimWorker(opts) {
             }
             : {}),
     };
-    const api = { ...standardApi, ...(opts.extraApi ?? {}) };
+    const api = { ...standardApi, ...opts.extraApi };
     // Optionally wrap the API before exposing (e.g. with exposeDevToolsApi
     // to add devtools + profiling RPC methods).
     expose(opts.wrapExpose ? opts.wrapExpose(api) : api);

package/dist/core/src/worker/task-pool.js

@@ -78,6 +78,11 @@ export class TaskPool {
             for (let i = 0; i < this.workerCount; i++) {
                 const worker = this.createWorker();
                 worker.onerror = (e) => {
+                    // Session teardown tags tracked workers __ddExpectTerminate and
+                    // fires synthetic error events to settle waiters — not faults
+                    // (see session-tracker.ts terminateTrackedWorker).
+                    if (worker.__ddExpectTerminate || this.destroyed)
+                        return;
                     if (this.onWorkerError)
                         this.onWorkerError(i, e);
                     else

package/dist/libraries/devtools/src/backend.js

@@ -44,6 +44,12 @@ export class DevtoolsBackend {
     providers = new Map();
     commandHandlers = new Map();
     globalCommandHandler = null;
+    /** Dynamically-allocated slots for provider names outside the fixed PANEL
+     *  table — panelSlot() alone collapsed every unknown name onto slot 0
+     *  ("console"), so a second game provider silently replaced the first. */
+    dynSlots = new Map();
+    dynSlotNames = new Map();
+    nextDynSlot = 100;
     lastProviderPush = new Map();
     providerIntervalMs = 1500;
     /** When non-null, the cadence loop only auto-refreshes this provider
@@ -178,37 +184,57 @@ export class DevtoolsBackend {
         this.emit("console.clear", {});
     }
     // ── Providers / commands ──
+    /** Resolve a panel id to its slot. Names outside the fixed PANEL table
+     *  get a stable dynamically-allocated slot so bespoke game providers can
+     *  coexist instead of colliding on slot 0. */
+    slotFor(panel) {
+        if (typeof panel === "number")
+            return panel;
+        const fixed = PANEL[panel];
+        if (fixed !== undefined)
+            return fixed;
+        let s = this.dynSlots.get(panel);
+        if (s === undefined) {
+            s = this.nextDynSlot++;
+            this.dynSlots.set(panel, s);
+            this.dynSlotNames.set(s, panel);
+        }
+        return s;
+    }
+    nameFor(slot) {
+        return this.dynSlotNames.get(slot) ?? slotName(slot);
+    }
     registerProvider(panel, collect) {
-        this.providers.set(panelSlot(panel), collect);
+        this.providers.set(this.slotFor(panel), collect);
     }
     registerCommandHandler(panel, handler) {
         if (panel === "*") {
             this.globalCommandHandler = handler;
         }
         else {
-            this.commandHandlers.set(panelSlot(panel), handler);
+            this.commandHandlers.set(this.slotFor(panel), handler);
         }
     }
     /** Registered provider slots — the dynamic tab list for frontends. */
     providerSlots() {
-        return [...this.providers.keys()].map((slot) => ({ slot, name: slotName(slot) }));
+        return [...this.providers.keys()].map((slot) => ({ slot, name: this.nameFor(slot) }));
     }
     /** Collect + emit one provider's snapshot immediately. */
     refreshPanel(panel) {
         const trace = [performance.now()];
-        const slot = panelSlot(panel);
+        const slot = this.slotFor(panel);
         trace.push(performance.now());
         const collect = this.providers.get(slot);
         if (!collect)
             return;
         const push = (snap) => {
             if (snap)
-                this.emit("snapshot", { panel: slotName(slot), slot, snap });
+                this.emit("snapshot", { panel: this.nameFor(slot), slot, snap });
             this.lastProviderPush.set(slot, performance.now());
         };
         const fail = (err) => {
             this.emit("snapshot", {
-                panel: slotName(slot), slot,
+                panel: this.nameFor(slot), slot,
                 snap: { status: "error", statusMsg: String(err), sections: [] },
             });
             this.lastProviderPush.set(slot, performance.now());
@@ -231,7 +257,7 @@ export class DevtoolsBackend {
         const total = trace[4] - trace[0];
         if (total > 10) {
             const seg = `pre=${(trace[2] - trace[0]).toFixed(1)} collect=${(trace[3] - trace[2]).toFixed(1)} emit=${(trace[4] - trace[3]).toFixed(1)}`;
-            this.diagWarn(`slow provider ${slotName(slot)}: ${total.toFixed(1)}ms [${seg}]`);
+            this.diagWarn(`slow provider ${this.nameFor(slot)}: ${total.toFixed(1)}ms [${seg}]`);
         }
     }
     dispatchCommand(cmd) {
@@ -374,7 +400,7 @@ export class DevtoolsBackend {
                 return collectThreads(this.ctx, [...this.threadEvals.keys()]);
             case "snapshot": {
                 const panel = params.panel;
-                const slot = typeof panel === "number" ? panel : panelSlot(panel);
+                const slot = typeof panel === "number" ? panel : this.slotFor(String(panel));
                 const collect = this.providers.get(slot);
                 if (!collect)
                     return { status: "unsupported", statusMsg: `no provider for ${String(panel)}`, sections: [] };
@@ -388,7 +414,7 @@ export class DevtoolsBackend {
             }
             case "command": {
                 const panel = params.panel;
-                const slot = typeof panel === "number" ? panel : panelSlot(panel ?? "console");
+                const slot = typeof panel === "number" ? panel : this.slotFor(String(panel ?? "console"));
                 this.dispatchCommand({ panel: slot, action: String(params.action ?? ""), payload: String(params.payload ?? "") });
                 return true;
             }

package/dist/libraries/devtools/src/collectors.js

@@ -72,31 +72,81 @@ export async function collectThreads(ctx, evalThreadIds) {
     });
     return threads;
 }
-/** Scene-graph tree (label + ctor + child counts). */
+function sceneInspectorApi() {
+    const g = globalThis;
+    return (g.window?.__sceneInspector ?? g.__sceneInspector ?? null);
+}
+/** Scene-graph tree (label + ctor + child counts). Prefers a live
+ *  `gameScene.stage` walk; falls back to the SceneInspector's scene store
+ *  (`__sceneInspector.getSceneTree`) so games without a DOM-like stage still
+ *  get a populated tree — with stable nodeIds for pick/details. */
 export function collectSceneTree(ctx) {
     const stage = ctx.gameScene?.stage;
-    if (!stage)
+    if (stage) {
+        const nodes = [];
+        let idCounter = 1;
+        const collect = (node, parentId, depth) => {
+            const id = idCounter++;
+            // Prefer `label` (some scene-graph hosts warn on `name` access); fall
+            // back to `name` for hosts that only set that.
+            const nodeLabel = typeof node.label === "string" ? node.label
+                : typeof node.name === "string" ? node.name : "";
+            const ctorName = node.constructor?.name ?? "Node";
+            nodes.push({
+                id, parentId, depth,
+                childCount: node.children?.length ?? 0,
+                kind: 0,
+                label: nodeLabel || ctorName,
+                detail: nodeLabel ? ctorName : "",
+                nodeId: typeof node.id === "string" ? node.id : undefined,
+            });
+            node.children?.forEach((child) => collect(child, id, depth + 1));
+        };
+        collect(stage, -1, 0);
+        return nodes;
+    }
+    // Scene-store fallback — the same snapshot the inspector's getSceneTree
+    // exposes. Nodes are flat with id/parentId links; walk roots → children.
+    try {
+        const snap = sceneInspectorApi()?.getSceneTree?.();
+        const storeNodes = snap?.nodes;
+        if (!Array.isArray(storeNodes) || !storeNodes.length)
+            return [];
+        const byId = new Map(storeNodes.map((n) => [n.id, n]));
+        const roots = storeNodes.filter((n) => n.parentId === null || !byId.has(n.parentId));
+        const rows = [];
+        const visited = new Set();
+        let idCounter = 1;
+        const walk = (n, parentId, depth) => {
+            if (visited.has(n.id))
+                return; // corrupted parent/child links — don't loop
+            visited.add(n.id);
+            const id = idCounter++;
+            const p = n.position;
+            rows.push({
+                id, parentId, depth,
+                childCount: n.children?.length ?? 0,
+                kind: 0,
+                label: String(n.name ?? n.id),
+                detail: `${n.type ?? "node"}${Array.isArray(p) ? ` (${p.map((v) => (+v).toFixed(1)).join(", ")})` : ""}`,
+                nodeId: String(n.id),
+            });
+            for (const cid of n.children ?? []) {
+                const c = byId.get(cid);
+                if (c)
+                    walk(c, id, depth + 1);
+            }
+        };
+        roots.forEach((n) => walk(n, -1, 0));
+        // Orphans (every node has a parent but no root resolves) — still show them.
+        for (const n of storeNodes)
+            if (!visited.has(n.id))
+                walk(n, -1, 0);
+        return rows;
+    }
+    catch {
         return [];
-    const nodes = [];
-    let idCounter = 1;
-    const collect = (node, parentId, depth) => {
-        const id = idCounter++;
-        // Prefer `label` (some scene-graph hosts warn on `name` access); fall
-        // back to `name` for hosts that only set that.
-        const nodeLabel = typeof node.label === "string" ? node.label
-            : typeof node.name === "string" ? node.name : "";
-        const ctorName = node.constructor?.name ?? "Node";
-        nodes.push({
-            id, parentId, depth,
-            childCount: node.children?.length ?? 0,
-            kind: 0,
-            label: nodeLabel || ctorName,
-            detail: nodeLabel ? ctorName : "",
-        });
-        node.children?.forEach((child) => collect(child, id, depth + 1));
-    };
-    collect(stage, -1, 0);
-    return nodes;
+    }
 }
 /** DOM tree: scene-graph stage or ECS entities depending on mode. */
 export function collectDomTree(ctx, mode) {
@@ -122,6 +172,7 @@ export function collectDomTree(ctx, mode) {
                 id, parentId: -1, depth: 0, childCount: 0, kind: 1,
                 label: `Entity ${ent.idx}`,
                 detail: `type=${entityType} pos=(${x.toFixed(1)},${y.toFixed(1)},${z.toFixed(1)})`,
+                nodeId: `ent-${ent.idx}`,
             });
         });
     }

package/dist/libraries/gamepad/src/feed-input.js

@@ -29,7 +29,7 @@ export function writePadToInput(writer, reader, playerIdx, deviceSlot, bindings,
         writer.setGamepadButton(playerIdx, b, (d.buttonsLo & (1 << b)) !== 0);
     }
     if (bindings) {
-        for (const bind of bindings) {
+        for (const bind of bindings.values()) {
             let active = false;
             if (bind.button !== undefined) {
                 active = (d.buttonsLo & (1 << bind.button)) !== 0;

package/dist/libraries/gamepad/src/hub.js

@@ -131,12 +131,12 @@ export class GamepadHub {
                     ffSupported: (s.flags & PAD_FLAG.FF_SUPPORTED) !== 0,
                 });
                 this.devices.set(slot, dev);
-                for (const cb of this.listeners.connect)
+                for (const cb of this.listeners.connect.values())
                     cb(dev);
             }
             else if (!connected && existing) {
                 this.devices.delete(slot);
-                for (const cb of this.listeners.disconnect)
+                for (const cb of this.listeners.disconnect.values())
                     cb(existing);
             }
         }

package/dist/libraries/gamepad/src/source-sab.js

@@ -44,11 +44,11 @@ export class SabGamepadSource {
             if (!(changed & (1 << i)))
                 continue;
             if (mask & (1 << i)) {
-                for (const cb of this.connectCbs)
+                for (const cb of this.connectCbs.values())
                     cb(i);
             }
             else {
-                for (const cb of this.disconnectCbs)
+                for (const cb of this.disconnectCbs.values())
                     cb(i);
             }
         }

package/dist/libraries/gamepad/src/sysfs-enrich.js

@@ -54,7 +54,7 @@ async function findBatteryLevel(macHint) {
         const psDir = "/sys/class/power_supply";
         if (!existsSync(psDir))
             return undefined;
-        for (const entry of await fs.readdir(psDir)) {
+        for (const entry of (await fs.readdir(psDir)).values()) {
             const macPath = join(psDir, entry, "mac");
             if (existsSync(macPath)) {
                 const mac = (await fs.readFile(macPath, "utf-8")).trim().toLowerCase();
@@ -84,7 +84,7 @@ export class SysfsGamepadEnricher {
         if (process.platform !== "linux")
             return [];
         const out = [];
-        for (const s of slots) {
+        for (const s of slots.values()) {
             if (s.eventNode < 0)
                 continue;
             const r = await this.enrichSlot(s);

package/dist/libraries/gpu-kernels/src/kernel.js

@@ -100,6 +100,7 @@ export class GpuKernel {
         const [, oy, oz] = this.outputSize;
         this.workgroupSize = opts.workgroupSize ?? (oy === 1 && oz === 1 ? [64, 1, 1] : [8, 8, 1]);
         const [wx, wy, wz] = this.workgroupSize;
+        this.label = opts.label ?? "gpu-kernel";
         const lim = this.device?.limits;
         if (lim) {
             const perDim = wx > (lim.maxComputeWorkgroupSizeX ?? wx)
@@ -110,7 +111,6 @@ export class GpuKernel {
                 throw new Error(`kernel "${this.label}": workgroupSize ${wx}×${wy}×${wz} exceeds device limits`);
             }
         }
-        this.label = opts.label ?? "gpu-kernel";
         this.memoryBudget = opts.memoryBudget;
         this.extraUsage = opts.outputUsage ?? 0;
         this.externalResult = opts.outputBuffer ?? null;

package/dist/libraries/gpu-kernels/src/transpile.js

@@ -659,7 +659,7 @@ class Emitter {
                 if (e.ty === "vec") {
                     throw new KernelSyntaxError(`arrays can't live in locals — return them directly`, d.init);
                 }
-                const widen = this.widened.has(name) && e.ty !== "f32" && e.ty !== "bool" && e.ty !== "vec";
+                const widen = this.widened.has(name) && e.ty !== "f32" && e.ty !== "bool";
                 this.declare(name, widen ? "f32" : e.ty);
                 if (node.kind === "const")
                     this.consts.add(name);

package/dist/libraries/html-ui-kit/src/nav/nav-controller.js

@@ -181,7 +181,7 @@ export class NavController {
         const sign = dir === "down" || dir === "right" ? 1 : -1;
         let best = null;
         let bestScore = Infinity;
-        for (const n of cands) {
+        for (const n of cands.values()) {
             if (n === cur || !n.rect)
                 continue;
             const r = n.rect;

package/dist/libraries/html-ui-kit/src/nav/nav-input.js

@@ -29,7 +29,7 @@ export class PadNavDriver {
             repeatDelayMs: opts.repeatDelayMs ?? 400,
             repeatIntervalMs: opts.repeatIntervalMs ?? 130,
         };
-        for (const d of ["up", "down", "left", "right"]) {
+        for (const d of ["up", "down", "left", "right"].values()) {
             this.dirs.set(d, { held: false, since: 0, lastFire: 0 });
         }
     }
@@ -67,7 +67,7 @@ export class PadNavDriver {
         this.prevDirAxis = stickDir;
         if (stickDir)
             pressed.add(stickDir);
-        for (const [dir, st] of this.dirs) {
+        for (const [dir, st] of this.dirs.entries()) {
             const isDown = pressed.has(dir);
             if (isDown && !st.held) {
                 st.held = true;

package/dist/libraries/networking/src/discovery.js

@@ -165,20 +165,20 @@ export class LanDiscovery {
         const peer = { ...pkt, host: rinfo.address, lastSeenMs: this.opts.now() };
         this.peers.set(pkt.id, peer);
         if (!existing)
-            for (const f of this.listeners.join)
+            for (const f of this.listeners.join.values())
                 f(peer);
         else if (existing.name !== peer.name || existing.port !== peer.port
             || JSON.stringify(existing.meta) !== JSON.stringify(peer.meta)) {
-            for (const f of this.listeners.update)
+            for (const f of this.listeners.update.values())
                 f(peer);
         }
     }
     expire() {
         const cutoff = this.opts.now() - this.opts.ttlMs;
-        for (const [id, p] of this.peers) {
+        for (const [id, p] of this.peers.entries()) {
             if (p.lastSeenMs < cutoff) {
                 this.peers.delete(id);
-                for (const f of this.listeners.leave)
+                for (const f of this.listeners.leave.values())
                     f(p);
             }
         }
@@ -227,7 +227,7 @@ export class MdnsBrowser {
         this.sendQuery(type);
     }
     requery() {
-        for (const t of this.watched)
+        for (const t of this.watched.values())
             this.sendQuery(t);
         this.expire();
     }
@@ -257,7 +257,7 @@ export class MdnsBrowser {
     }
     expire() {
         const now = this.opts.now();
-        for (const [k, s] of this.table) {
+        for (const [k, s] of this.table.entries()) {
             if (s.lastSeenMs + s.ttlMs < now)
                 this.table.delete(k);
         }
@@ -276,7 +276,7 @@ export class MdnsBrowser {
             .filter((r) => "data" in r);
         const now = this.opts.now();
         // PTR gives instance names; SRV/TXT/A for the same instance fill detail.
-        for (const r of recs) {
+        for (const r of recs.values()) {
             if (r.type !== "PTR" || !this.watched.has(r.name))
                 continue;
             const instance = r.data;
@@ -291,7 +291,7 @@ export class MdnsBrowser {
                 .map((x) => x.ttl ?? 120)));
             const txtMap = {};
             if (txt) {
-                for (const item of txt.data) {
+                for (const item of txt.data.values()) {
                     const s = item.toString("utf8");
                     const eq = s.indexOf("=");
                     txtMap[eq < 0 ? s : s.slice(0, eq)] = eq < 0 ? "" : s.slice(eq + 1);

package/dist/libraries/persistence/src/file-save-store.js

@@ -152,7 +152,7 @@ export class FileSaveStore {
                 await fs.mkdir(tmpBlobsDir, { recursive: true });
                 for (let _i = 0, _it = Object.entries(opts.blobs), _n = _it.length; _i < _n; _i++) {
                     const [key, buf] = _it[_i];
-                    const safeKey = key.replace(/[^a-zA-Z0-9_\-]/g, "_");
+                    const safeKey = key.replace(/[^a-zA-Z0-9_-]/g, "_");
                     await fs.writeFile(join(tmpBlobsDir, safeKey), new Uint8Array(buf));
                     blobBytes += buf.byteLength;
                 }
@@ -480,19 +480,19 @@ export class FileSaveStore {
     }
     slotPath(slot) {
         // Sanitize slot name to prevent path traversal
-        const safe = slot.replace(/[^a-zA-Z0-9_\-]/g, "_");
+        const safe = slot.replace(/[^a-zA-Z0-9_-]/g, "_");
         return join(this.saveDir, safe + SAVE_EXT);
     }
     blobsDirPath(slot) {
-        const safe = slot.replace(/[^a-zA-Z0-9_\-]/g, "_");
+        const safe = slot.replace(/[^a-zA-Z0-9_-]/g, "_");
         return join(this.saveDir, safe + BLOBS_DIR_SUFFIX);
     }
     thumbPath(slot) {
-        const safe = slot.replace(/[^a-zA-Z0-9_\-]/g, "_");
+        const safe = slot.replace(/[^a-zA-Z0-9_-]/g, "_");
         return join(this.saveDir, safe + THUMB_EXT);
     }
     propsPath(slot) {
-        const safe = slot.replace(/[^a-zA-Z0-9_\-]/g, "_");
+        const safe = slot.replace(/[^a-zA-Z0-9_-]/g, "_");
         return join(this.saveDir, safe + PROPS_EXT);
     }
     hashEqual(a, b) {

package/dist/libraries/persistence/src/opfs-save-store.js

@@ -147,7 +147,7 @@ export class OpfsSaveStore {
     }
     // ── Path helpers ────────────────────────────────────────────────────────
     sanitizeSlot(slot) {
-        return slot.replace(/[^a-zA-Z0-9_\-]/g, "_");
+        return slot.replace(/[^a-zA-Z0-9_-]/g, "_");
     }
     genDirName(gen) {
         return String(gen).padStart(4, "0");
@@ -239,7 +239,7 @@ export class OpfsSaveStore {
             if (opts?.blobs && Object.keys(opts.blobs).length > 0) {
                 const blobsDir = await this.getBlobsDir(genDir, true);
                 for (const [key, buf] of Object.entries(opts.blobs)) {
-                    const safeKey = key.replace(/[^a-zA-Z0-9_\-]/g, "_");
+                    const safeKey = key.replace(/[^a-zA-Z0-9_-]/g, "_");
                     await this.writeBinaryFile(blobsDir, safeKey, new Uint8Array(buf));
                     blobCount++;
                 }

package/dist/modules/controller-ui/src/index.js

@@ -125,7 +125,7 @@ export function createControllerUi() {
                 if (!p || !dev)
                     return;
                 const ops = [];
-                for (const [bit] of BTN_LABELS) {
+                for (const [bit] of BTN_LABELS.values()) {
                     ops.push({ op: "attr", sel: `#ctl-btn-${bit}`, name: "data-on",
                         value: dev.pressed(bit) ? "true" : "false" });
                 }

package/dist/modules/devtools/src/blitz/fonts.js

@@ -0,0 +1,75 @@
+// ============================================================================
+// fonts.ts — bind the host's real system fonts into the devtools dock doc.
+//
+// The OSR rasterizer ships a single embedded DejaVu Sans as the fallback for
+// every generic family — legible, but `monospace` resolves to it too, so the
+// console/REPL/tree read as proportional sans. Same fix as cruiser's
+// libraries/app-shell/fonts.ts: resolve the user's actual sans + mono faces
+// via fontconfig (fc-match -f %{file}), register them as `ui://` blobs on the
+// HtmlUiHost before mount, and emit @font-face rules the dock stylesheet
+// binds ahead of the generic fallbacks. Any failure (no fc-match, non-Linux
+// host, unreadable file) leaves the embedded fallback in place.
+// ============================================================================
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+// Blitz-dom only fetches a @font-face source whose format is detectable —
+// either an explicit format() hint or a file extension on the url — so the
+// urls carry the resolved file's real extension.
+const FACES = [
+    { family: "DevTools Sans", pattern: "sans-serif", urlName: "sans", weight: 400 },
+    { family: "DevTools Sans", pattern: "sans-serif:weight=bold", urlName: "sans-bold", weight: 700 },
+    { family: "DevTools Mono", pattern: "monospace", urlName: "mono", weight: 400 },
+    { family: "DevTools Mono", pattern: "monospace:weight=bold", urlName: "mono-bold", weight: 700 },
+];
+/** `fc-match -f %{file}` for a fontconfig pattern; null when fc-match is
+ *  absent or the match isn't a font file Blitz can load. */
+function fcFontFile(pattern) {
+    try {
+        const p = execFileSync("fc-match", ["-f", "%{file}", pattern], { timeout: 5000 }).toString().trim();
+        return /\.(ttf|otf|woff2?)$/i.test(p) ? p : null;
+    }
+    catch {
+        return null;
+    }
+}
+function fontExt(path) {
+    return path.match(/\.(ttf|otf|woff2?)$/i)?.[0] ?? ".ttf";
+}
+/**
+ * Register system sans + mono faces as `ui://` resources and return the
+ * @font-face CSS to prepend to the dock stylesheet. Returns "" when nothing
+ * registered — the stylesheet's named families then fail to resolve and the
+ * generic fallbacks (embedded DejaVu) apply.
+ *
+ * Call before mount — the doc backend applies resources synchronously and in
+ * order, so the first doc resolve sees them.
+ */
+export function registerDevtoolsFonts(sink) {
+    try {
+        // Both weights of a family are required: a 700 rule pointing at the
+        // regular file keeps bold text in-family instead of falling back.
+        const files = new Map();
+        for (const f of FACES)
+            files.set(f.urlName, fcFontFile(f.pattern) ?? "");
+        if (!files.get("sans"))
+            return "";
+        if (!files.get("mono"))
+            files.set("mono", files.get("sans"));
+        if (!files.get("sans-bold"))
+            files.set("sans-bold", files.get("sans"));
+        if (!files.get("mono-bold"))
+            files.set("mono-bold", files.get("mono"));
+        let css = "";
+        for (const f of FACES) {
+            const file = files.get(f.urlName);
+            const url = `ui://devtools-fonts/${f.urlName}${fontExt(file)}`;
+            sink.registerResource(url, readFileSync(file));
+            css += `@font-face { font-family:'${f.family}'; font-weight:${f.weight}; src:url('${url}'); }\n`;
+        }
+        return css;
+    }
+    catch {
+        // fc-match absent / unreadable font file — the embedded fallback applies.
+        return "";
+    }
+}