@omniaura/solid-pulse 0.1.0

package/dist/chunk-C72EYM65.js

@@ -0,0 +1,462 @@
+// src/core/ring-buffer.ts
+var RingBuffer = class {
+  constructor(capacity) {
+    this.capacity = capacity;
+    if (!Number.isInteger(capacity) || capacity <= 0) {
+      throw new RangeError(`RingBuffer capacity must be a positive integer, got ${capacity}`);
+    }
+    this.items = new Array(capacity);
+  }
+  capacity;
+  items;
+  head = 0;
+  count = 0;
+  /** Total number of pushes since creation (dropped + retained). */
+  pushed = 0;
+  get size() {
+    return this.count;
+  }
+  get dropped() {
+    return this.pushed - this.count;
+  }
+  push(item) {
+    const idx = (this.head + this.count) % this.capacity;
+    if (this.count === this.capacity) {
+      this.items[this.head] = item;
+      this.head = (this.head + 1) % this.capacity;
+    } else {
+      this.items[idx] = item;
+      this.count++;
+    }
+    this.pushed++;
+  }
+  /** Oldest → newest. */
+  toArray() {
+    const out = new Array(this.count);
+    for (let i = 0; i < this.count; i++) {
+      out[i] = this.items[(this.head + i) % this.capacity];
+    }
+    return out;
+  }
+  clear() {
+    this.items = new Array(this.capacity);
+    this.head = 0;
+    this.count = 0;
+  }
+};
+
+// src/core/bus.ts
+var EventBus = class {
+  buffer;
+  listeners = /* @__PURE__ */ new Set();
+  seq = 0;
+  recording = null;
+  recordings = /* @__PURE__ */ new Map();
+  /** Kinds that are muted at the source (never buffered). */
+  muted = /* @__PURE__ */ new Set();
+  paused = false;
+  constructor(capacity = 2e3) {
+    this.buffer = new RingBuffer(capacity);
+  }
+  get nextSeq() {
+    return this.seq + 1;
+  }
+  emit(kind, data, extra = {}) {
+    if (this.paused || this.muted.has(kind)) return null;
+    const event = {
+      seq: ++this.seq,
+      t: typeof performance !== "undefined" ? performance.now() : Date.now(),
+      wall: Date.now(),
+      kind,
+      data,
+      ...extra
+    };
+    this.buffer.push(event);
+    const rec = this.recording;
+    if (rec) {
+      rec.events.push(event);
+      if (rec.events.length >= rec.limit) this.stopRecording();
+    }
+    for (const l of this.listeners) {
+      try {
+        l(event);
+      } catch (err) {
+        if (typeof console !== "undefined") console.warn("[solid-pulse] listener failed", err);
+      }
+    }
+    return event;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  /** Events with seq > since (oldest first), optionally filtered by kind. */
+  list(opts = {}) {
+    const { since = 0, kinds = null, limit = 500 } = opts;
+    const all = this.buffer.toArray();
+    const out = [];
+    for (const e of all) {
+      if (e.seq <= since) continue;
+      if (kinds && kinds.size > 0 && !kinds.has(e.kind)) continue;
+      out.push(e);
+    }
+    return out.length > limit ? out.slice(out.length - limit) : out;
+  }
+  clear() {
+    this.buffer.clear();
+  }
+  startRecording(id, limit = 2e4) {
+    if (this.recording) this.stopRecording();
+    const rec = {
+      id: id ?? `rec-${Date.now().toString(36)}-${this.seq.toString(36)}`,
+      startedAt: typeof performance !== "undefined" ? performance.now() : Date.now(),
+      startedWall: Date.now(),
+      stoppedAt: null,
+      events: [],
+      limit
+    };
+    this.recording = rec;
+    this.recordings.set(rec.id, rec);
+    while (this.recordings.size > 5) {
+      const oldest = this.recordings.keys().next().value;
+      if (oldest === void 0) break;
+      this.recordings.delete(oldest);
+    }
+    return rec;
+  }
+  stopRecording() {
+    const rec = this.recording;
+    if (!rec) return null;
+    rec.stoppedAt = typeof performance !== "undefined" ? performance.now() : Date.now();
+    this.recording = null;
+    return rec;
+  }
+  currentRecording() {
+    return this.recording;
+  }
+  getRecording(id) {
+    return this.recordings.get(id) ?? null;
+  }
+  listRecordings() {
+    return [...this.recordings.values()].map((r) => ({
+      id: r.id,
+      startedWall: r.startedWall,
+      stoppedAt: r.stoppedAt,
+      events: r.events.length,
+      active: r === this.recording
+    }));
+  }
+};
+
+// src/core/events.ts
+var KIND_GROUPS = {
+  solid: [
+    "solid.flush",
+    "solid.computation",
+    "solid.component.mount",
+    "solid.component.dispose",
+    "solid.component.remount",
+    "solid.root"
+  ],
+  dom: ["dom.mutation", "dom.detach", "dom.reattach", "focus.lost"],
+  net: [
+    "net.fetch.start",
+    "net.fetch.end",
+    "net.fetch.error",
+    "net.ws.open",
+    "net.ws.message",
+    "net.ws.close",
+    "net.ws.error",
+    "net.sse.open",
+    "net.sse.message",
+    "net.sse.error",
+    "net.sse.close"
+  ],
+  query: [
+    "query.added",
+    "query.removed",
+    "query.observe",
+    "query.unobserve",
+    "query.fetch.start",
+    "query.fetch.success",
+    "query.fetch.error",
+    "query.invalidate",
+    "query.update",
+    "mutation.start",
+    "mutation.success",
+    "mutation.error"
+  ],
+  pulse: ["pulse.note"]
+};
+var ALL_KINDS = Object.values(KIND_GROUPS).flat();
+function expandKinds(filters) {
+  const out = /* @__PURE__ */ new Set();
+  for (const raw of filters) {
+    const f = raw.trim();
+    if (!f) continue;
+    if (f === "*" || f === "all") {
+      for (const k of ALL_KINDS) out.add(k);
+      continue;
+    }
+    const group = KIND_GROUPS[f];
+    if (group) {
+      for (const k of group) out.add(k);
+      continue;
+    }
+    if (f.endsWith("*")) {
+      const prefix = f.slice(0, -1);
+      for (const k of ALL_KINDS) if (k.startsWith(prefix)) out.add(k);
+      continue;
+    }
+    if (ALL_KINDS.includes(f)) out.add(f);
+  }
+  return out;
+}
+
+// src/core/controller.ts
+var FEATURES = [
+  "solid",
+  "dom",
+  "flash",
+  "network",
+  "query",
+  "queryOverlay",
+  "verboseComputations",
+  "captureBodies"
+];
+var PulseController = class {
+  bus;
+  commands = /* @__PURE__ */ new Map();
+  features;
+  featureListeners = /* @__PURE__ */ new Set();
+  filters = { kinds: [], component: "", text: "" };
+  filterListeners = /* @__PURE__ */ new Set();
+  startedWall = Date.now();
+  constructor(bus = new EventBus(), initial = {}) {
+    this.bus = bus;
+    this.features = {
+      solid: true,
+      dom: true,
+      flash: true,
+      network: true,
+      query: true,
+      queryOverlay: true,
+      verboseComputations: false,
+      captureBodies: false,
+      ...initial
+    };
+    this.registerCore();
+  }
+  // ── features ─────────────────────────────────────────────────────
+  isOn(feature) {
+    return this.features[feature];
+  }
+  setFeature(feature, on) {
+    if (!FEATURES.includes(feature)) throw new Error(`unknown feature: ${feature}`);
+    if (this.features[feature] === on) return;
+    this.features[feature] = on;
+    for (const l of this.featureListeners) l(feature, on);
+    this.bus.emit("pulse.note", { note: `feature ${feature} ${on ? "on" : "off"}` });
+  }
+  onFeature(listener) {
+    this.featureListeners.add(listener);
+    return () => this.featureListeners.delete(listener);
+  }
+  snapshotFeatures() {
+    return { ...this.features };
+  }
+  // ── filters ──────────────────────────────────────────────────────
+  setFilters(next) {
+    this.filters = { ...this.filters, ...next };
+    for (const l of this.filterListeners) l(this.filters);
+  }
+  onFilters(listener) {
+    this.filterListeners.add(listener);
+    return () => this.filterListeners.delete(listener);
+  }
+  matchesFilters(e, f = this.filters) {
+    if (f.kinds.length) {
+      const kinds = expandKinds(f.kinds);
+      if (kinds.size && !kinds.has(e.kind)) return false;
+    }
+    if (f.component) {
+      const name = e.component?.name ?? "";
+      const chain = e.component?.chain?.join(" ") ?? "";
+      const needle = f.component.toLowerCase();
+      if (!name.toLowerCase().includes(needle) && !chain.toLowerCase().includes(needle)) return false;
+    }
+    if (f.text) {
+      const needle = f.text.toLowerCase();
+      if (!JSON.stringify(e.data).toLowerCase().includes(needle)) return false;
+    }
+    return true;
+  }
+  /** Buffered events after `since`, through the active filters. */
+  events(opts = {}) {
+    const kinds = opts.kinds ? expandKinds(opts.kinds) : null;
+    const list = this.bus.list({ since: opts.since, limit: opts.raw ? opts.limit : 5e3, kinds });
+    const filtered = opts.raw ? list : list.filter((e) => this.matchesFilters(e));
+    const limit = opts.limit ?? 500;
+    return filtered.length > limit ? filtered.slice(filtered.length - limit) : filtered;
+  }
+  // ── commands ─────────────────────────────────────────────────────
+  register(spec, handler) {
+    if (this.commands.has(spec.name)) throw new Error(`command already registered: ${spec.name}`);
+    this.commands.set(spec.name, { spec, handler });
+  }
+  unregister(name) {
+    this.commands.delete(name);
+  }
+  has(name) {
+    return this.commands.has(name);
+  }
+  describe() {
+    return [...this.commands.values()].map((c) => c.spec).sort((a, b) => a.name.localeCompare(b.name));
+  }
+  async run(name, args = {}) {
+    const cmd = this.commands.get(name);
+    if (!cmd) return { ok: false, error: `unknown command: ${name}` };
+    try {
+      const value = await cmd.handler(args ?? {});
+      return { ok: true, value: value === void 0 ? null : value };
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+  }
+  registerCore() {
+    this.register(
+      { name: "status", summary: "Runtime status: features, filters, buffer stats, recording.", ui: "panel header" },
+      () => ({
+        startedWall: this.startedWall,
+        features: this.snapshotFeatures(),
+        filters: this.filters,
+        buffer: { size: this.bus.buffer.size, capacity: this.bus.buffer.capacity, dropped: this.bus.buffer.dropped, seq: this.bus.nextSeq - 1 },
+        paused: this.bus.paused,
+        recording: this.bus.currentRecording()?.id ?? null,
+        commands: this.commands.size
+      })
+    );
+    this.register(
+      { name: "commands", summary: "List every command with its panel equivalent (the parity contract)." },
+      () => this.describe()
+    );
+    this.register(
+      { name: "features.list", summary: "Feature flags and their current state.", ui: "Pulse tab \u203A toggles" },
+      () => this.snapshotFeatures()
+    );
+    this.register(
+      {
+        name: "features.set",
+        summary: "Turn a feature on/off.",
+        args: { name: FEATURES.join("|"), on: "true|false (default true)" },
+        ui: "Pulse tab \u203A toggles"
+      },
+      (a) => {
+        const name = String(a.name ?? "");
+        const on = a.on === void 0 ? true : a.on === true || a.on === "true" || a.on === "on" || a.on === 1;
+        this.setFeature(name, on);
+        return this.snapshotFeatures();
+      }
+    );
+    this.register(
+      {
+        name: "filters.set",
+        summary: "Set event filters (kinds list, component substring, text substring). Empty string clears.",
+        args: { kinds: "comma list: solid,dom,net,query or kinds/globs", component: "substring", text: "substring" },
+        ui: "Pulse tab \u203A filter bar"
+      },
+      (a) => {
+        const next = {};
+        if (a.kinds !== void 0) {
+          next.kinds = Array.isArray(a.kinds) ? a.kinds.map(String) : String(a.kinds).split(",").map((s) => s.trim()).filter(Boolean);
+        }
+        if (a.component !== void 0) next.component = String(a.component);
+        if (a.text !== void 0) next.text = String(a.text);
+        this.setFilters(next);
+        return this.filters;
+      }
+    );
+    this.register({ name: "filters.get", summary: "Current filters.", ui: "Pulse tab \u203A filter bar" }, () => this.filters);
+    this.register(
+      {
+        name: "events.list",
+        summary: "Buffered events (oldest first) through the active filters.",
+        args: { since: "seq to start after", limit: "max rows (default 200)", kinds: "override kind filter", raw: "true = ignore filters" },
+        ui: "Pulse tab \u203A event list"
+      },
+      (a) => {
+        const kinds = a.kinds === void 0 ? void 0 : String(a.kinds).split(",").map((s) => s.trim()).filter(Boolean);
+        return this.events({
+          since: a.since === void 0 ? void 0 : Number(a.since),
+          limit: a.limit === void 0 ? 200 : Number(a.limit),
+          kinds,
+          raw: a.raw === true || a.raw === "true"
+        });
+      }
+    );
+    this.register({ name: "events.clear", summary: "Clear the event buffer.", ui: "Pulse tab \u203A Clear" }, () => {
+      this.bus.clear();
+      return { cleared: true };
+    });
+    this.register({ name: "events.pause", summary: "Stop capturing new events (buffer kept).", ui: "Pulse tab \u203A Pause" }, () => {
+      this.bus.paused = true;
+      return { paused: true };
+    });
+    this.register({ name: "events.resume", summary: "Resume capturing.", ui: "Pulse tab \u203A Pause" }, () => {
+      this.bus.paused = false;
+      return { paused: false };
+    });
+    this.register(
+      { name: "note", summary: "Append a marker note to the timeline (agents: label a QA step).", args: { text: "note text" }, ui: "Record tab \u203A Note" },
+      (a) => this.bus.emit("pulse.note", { note: String(a.text ?? "") })
+    );
+    this.register(
+      { name: "record.start", summary: "Start a recording (stops any active one).", args: { id: "optional id", limit: "max events (default 20000)" }, ui: "Record tab \u203A Start" },
+      (a) => {
+        const rec = this.bus.startRecording(a.id === void 0 ? void 0 : String(a.id), a.limit === void 0 ? void 0 : Number(a.limit));
+        return { id: rec.id, startedWall: rec.startedWall };
+      }
+    );
+    this.register({ name: "record.stop", summary: "Stop the active recording.", ui: "Record tab \u203A Stop" }, () => {
+      const rec = this.bus.stopRecording();
+      return rec ? { id: rec.id, events: rec.events.length } : null;
+    });
+    this.register({ name: "record.list", summary: "Recordings kept in memory (last 5).", ui: "Record tab \u203A list" }, () => this.bus.listRecordings());
+    this.register(
+      {
+        name: "export",
+        summary: "Export a recording (or the live buffer) as JSON: {meta, events}.",
+        args: { recording: "recording id; omit for the live buffer", filtered: "true = apply filters to the live buffer" },
+        ui: "Record tab \u203A Export"
+      },
+      (a) => {
+        const id = a.recording === void 0 ? null : String(a.recording);
+        const rec = id ? this.bus.getRecording(id) : null;
+        if (id && !rec) throw new Error(`unknown recording: ${id}`);
+        const events = rec ? rec.events : a.filtered === true || a.filtered === "true" ? this.events({ limit: 1e5 }) : this.bus.list({ limit: 1e5 });
+        return {
+          meta: {
+            tool: "@omniaura/solid-pulse",
+            exportedWall: Date.now(),
+            recording: rec ? { id: rec.id, startedWall: rec.startedWall, stoppedAt: rec.stoppedAt } : null,
+            features: this.snapshotFeatures(),
+            filters: this.filters,
+            count: events.length
+          },
+          events
+        };
+      }
+    );
+  }
+};
+
+export {
+  RingBuffer,
+  EventBus,
+  KIND_GROUPS,
+  ALL_KINDS,
+  expandKinds,
+  FEATURES,
+  PulseController
+};
+//# sourceMappingURL=chunk-C72EYM65.js.map

package/dist/chunk-C72EYM65.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/ring-buffer.ts","../src/core/bus.ts","../src/core/events.ts","../src/core/controller.ts"],"sourcesContent":["/** Fixed-capacity FIFO. Overwrites the oldest entry; never grows. */\nexport class RingBuffer<T> {\n  private items: (T | undefined)[];\n  private head = 0;\n  private count = 0;\n  /** Total number of pushes since creation (dropped + retained). */\n  pushed = 0;\n\n  constructor(public readonly capacity: number) {\n    if (!Number.isInteger(capacity) || capacity <= 0) {\n      throw new RangeError(`RingBuffer capacity must be a positive integer, got ${capacity}`);\n    }\n    this.items = new Array(capacity);\n  }\n\n  get size() {\n    return this.count;\n  }\n\n  get dropped() {\n    return this.pushed - this.count;\n  }\n\n  push(item: T) {\n    const idx = (this.head + this.count) % this.capacity;\n    if (this.count === this.capacity) {\n      this.items[this.head] = item;\n      this.head = (this.head + 1) % this.capacity;\n    } else {\n      this.items[idx] = item;\n      this.count++;\n    }\n    this.pushed++;\n  }\n\n  /** Oldest → newest. */\n  toArray(): T[] {\n    const out: T[] = new Array(this.count);\n    for (let i = 0; i < this.count; i++) {\n      out[i] = this.items[(this.head + i) % this.capacity] as T;\n    }\n    return out;\n  }\n\n  clear() {\n    this.items = new Array(this.capacity);\n    this.head = 0;\n    this.count = 0;\n  }\n}\n","import { RingBuffer } from \"./ring-buffer.js\";\nimport type { PulseEvent, PulseEventKind } from \"./events.js\";\n\nexport type Listener = (event: PulseEvent) => void;\n\nexport interface Recording {\n  id: string;\n  startedAt: number;\n  startedWall: number;\n  stoppedAt: number | null;\n  events: PulseEvent[];\n  /** Hard cap; the recording stops itself when reached. */\n  limit: number;\n}\n\n/**\n * Bounded event bus. Emission is synchronous and cheap: one ring-buffer push,\n * one optional recording push, then listeners. Filters are applied by\n * consumers (panel/bridge), not here, so the buffer stays a faithful log.\n */\nexport class EventBus {\n  readonly buffer: RingBuffer<PulseEvent>;\n  private listeners = new Set<Listener>();\n  private seq = 0;\n  private recording: Recording | null = null;\n  private recordings = new Map<string, Recording>();\n  /** Kinds that are muted at the source (never buffered). */\n  muted = new Set<PulseEventKind>();\n  paused = false;\n\n  constructor(capacity = 2000) {\n    this.buffer = new RingBuffer<PulseEvent>(capacity);\n  }\n\n  get nextSeq() {\n    return this.seq + 1;\n  }\n\n  emit(kind: PulseEventKind, data: Record<string, unknown>, extra: Partial<PulseEvent> = {}): PulseEvent | null {\n    if (this.paused || this.muted.has(kind)) return null;\n    const event: PulseEvent = {\n      seq: ++this.seq,\n      t: typeof performance !== \"undefined\" ? performance.now() : Date.now(),\n      wall: Date.now(),\n      kind,\n      data,\n      ...extra,\n    };\n    this.buffer.push(event);\n    const rec = this.recording;\n    if (rec) {\n      rec.events.push(event);\n      if (rec.events.length >= rec.limit) this.stopRecording();\n    }\n    for (const l of this.listeners) {\n      try {\n        l(event);\n      } catch (err) {\n        // A misbehaving listener must never break the app being observed.\n        if (typeof console !== \"undefined\") console.warn(\"[solid-pulse] listener failed\", err);\n      }\n    }\n    return event;\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /** Events with seq > since (oldest first), optionally filtered by kind. */\n  list(opts: { since?: number; kinds?: Set<PulseEventKind> | null; limit?: number } = {}): PulseEvent[] {\n    const { since = 0, kinds = null, limit = 500 } = opts;\n    const all = this.buffer.toArray();\n    const out: PulseEvent[] = [];\n    for (const e of all) {\n      if (e.seq <= since) continue;\n      if (kinds && kinds.size > 0 && !kinds.has(e.kind)) continue;\n      out.push(e);\n    }\n    return out.length > limit ? out.slice(out.length - limit) : out;\n  }\n\n  clear() {\n    this.buffer.clear();\n  }\n\n  startRecording(id?: string, limit = 20_000): Recording {\n    if (this.recording) this.stopRecording();\n    const rec: Recording = {\n      id: id ?? `rec-${Date.now().toString(36)}-${(this.seq).toString(36)}`,\n      startedAt: typeof performance !== \"undefined\" ? performance.now() : Date.now(),\n      startedWall: Date.now(),\n      stoppedAt: null,\n      events: [],\n      limit,\n    };\n    this.recording = rec;\n    this.recordings.set(rec.id, rec);\n    // Keep only the 5 most recent recordings to bound memory.\n    while (this.recordings.size > 5) {\n      const oldest = this.recordings.keys().next().value;\n      if (oldest === undefined) break;\n      this.recordings.delete(oldest);\n    }\n    return rec;\n  }\n\n  stopRecording(): Recording | null {\n    const rec = this.recording;\n    if (!rec) return null;\n    rec.stoppedAt = typeof performance !== \"undefined\" ? performance.now() : Date.now();\n    this.recording = null;\n    return rec;\n  }\n\n  currentRecording() {\n    return this.recording;\n  }\n\n  getRecording(id: string) {\n    return this.recordings.get(id) ?? null;\n  }\n\n  listRecordings() {\n    return [...this.recordings.values()].map((r) => ({\n      id: r.id,\n      startedWall: r.startedWall,\n      stoppedAt: r.stoppedAt,\n      events: r.events.length,\n      active: r === this.recording,\n    }));\n  }\n}\n","/**\n * Event model. Every observation the runtime makes is one PulseEvent with a\n * precise `kind`. Kinds are deliberately specific: Solid has no \"rerender\", so\n * we never report one. What actually happens is one of:\n *\n *   solid.flush            a reactive flush completed (n computations re-ran)\n *   solid.computation      one memo/effect/render-effect re-ran (verbose mode)\n *   solid.component.mount  a component function ran (fresh mount, or hydrate)\n *   solid.component.dispose\n *   solid.component.remount same-named component disposed + mounted in one flush\n *   solid.root             a reactive root was created (multiple roots are fine)\n *   dom.mutation           the DOM actually changed (childList/attr/text)\n *   dom.detach             a subtree left the document (with scroll/focus state)\n *   dom.reattach           the same node instance came back (Suspense flip etc.)\n *   focus.lost             the focused element vanished from the document\n *   net.fetch.*            fetch lifecycle (start/end/error), SSE-aware\n *   net.ws.*               WebSocket lifecycle (open/message/close/error)\n *   net.sse.*              EventSource lifecycle\n *   query.*                Solid Query cache/observer events (adapter)\n *   mutation.*             Solid Query mutation cache events (adapter)\n *   pulse.*                runtime lifecycle / control-plane notes\n */\n\nexport type PulseEventKind =\n  | \"solid.flush\"\n  | \"solid.computation\"\n  | \"solid.component.mount\"\n  | \"solid.component.dispose\"\n  | \"solid.component.remount\"\n  | \"solid.root\"\n  | \"dom.mutation\"\n  | \"dom.detach\"\n  | \"dom.reattach\"\n  | \"focus.lost\"\n  | \"net.fetch.start\"\n  | \"net.fetch.end\"\n  | \"net.fetch.error\"\n  | \"net.ws.open\"\n  | \"net.ws.message\"\n  | \"net.ws.close\"\n  | \"net.ws.error\"\n  | \"net.sse.open\"\n  | \"net.sse.message\"\n  | \"net.sse.error\"\n  | \"net.sse.close\"\n  | \"query.added\"\n  | \"query.removed\"\n  | \"query.observe\"\n  | \"query.unobserve\"\n  | \"query.fetch.start\"\n  | \"query.fetch.success\"\n  | \"query.fetch.error\"\n  | \"query.invalidate\"\n  | \"query.update\"\n  | \"mutation.start\"\n  | \"mutation.success\"\n  | \"mutation.error\"\n  | \"pulse.note\";\n\nexport interface Rect {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\nexport interface ComponentRef {\n  id: number;\n  name: string;\n  /** Component ancestry, innermost first (names only). */\n  chain?: string[];\n  /** Source location if solid-grab's data-solid-source attribute was found. */\n  source?: string | null;\n}\n\nexport interface ElementRef {\n  tag: string;\n  id?: string;\n  testId?: string;\n  classes?: string;\n  /** Nearest `data-solid-component` ancestor name, if any. */\n  component?: string | null;\n  /** Nearest `data-solid-source` value, if any. */\n  source?: string | null;\n  rect?: Rect;\n}\n\nexport interface PulseEventBase {\n  /** Monotonic per-runtime sequence. */\n  seq: number;\n  /** performance.now() at capture. */\n  t: number;\n  /** Date.now() at capture (for cross-process correlation). */\n  wall: number;\n  kind: PulseEventKind;\n  /** Flush group the event belongs to, when attributable. */\n  flush?: number;\n  /** Component attribution, when known. */\n  component?: ComponentRef | null;\n  /** Free-form structured payload; shape depends on `kind`. */\n  data: Record<string, unknown>;\n}\n\nexport type PulseEvent = PulseEventBase;\n\nexport const KIND_GROUPS: Record<string, PulseEventKind[]> = {\n  solid: [\n    \"solid.flush\",\n    \"solid.computation\",\n    \"solid.component.mount\",\n    \"solid.component.dispose\",\n    \"solid.component.remount\",\n    \"solid.root\",\n  ],\n  dom: [\"dom.mutation\", \"dom.detach\", \"dom.reattach\", \"focus.lost\"],\n  net: [\n    \"net.fetch.start\",\n    \"net.fetch.end\",\n    \"net.fetch.error\",\n    \"net.ws.open\",\n    \"net.ws.message\",\n    \"net.ws.close\",\n    \"net.ws.error\",\n    \"net.sse.open\",\n    \"net.sse.message\",\n    \"net.sse.error\",\n    \"net.sse.close\",\n  ],\n  query: [\n    \"query.added\",\n    \"query.removed\",\n    \"query.observe\",\n    \"query.unobserve\",\n    \"query.fetch.start\",\n    \"query.fetch.success\",\n    \"query.fetch.error\",\n    \"query.invalidate\",\n    \"query.update\",\n    \"mutation.start\",\n    \"mutation.success\",\n    \"mutation.error\",\n  ],\n  pulse: [\"pulse.note\"],\n};\n\nexport const ALL_KINDS: PulseEventKind[] = Object.values(KIND_GROUPS).flat();\n\n/** Expand a kind filter: exact kinds, `group` names, or `prefix.*` globs. */\nexport function expandKinds(filters: readonly string[]): Set<PulseEventKind> {\n  const out = new Set<PulseEventKind>();\n  for (const raw of filters) {\n    const f = raw.trim();\n    if (!f) continue;\n    if (f === \"*\" || f === \"all\") {\n      for (const k of ALL_KINDS) out.add(k);\n      continue;\n    }\n    const group = KIND_GROUPS[f];\n    if (group) {\n      for (const k of group) out.add(k);\n      continue;\n    }\n    if (f.endsWith(\"*\")) {\n      const prefix = f.slice(0, -1);\n      for (const k of ALL_KINDS) if (k.startsWith(prefix)) out.add(k);\n      continue;\n    }\n    if ((ALL_KINDS as string[]).includes(f)) out.add(f as PulseEventKind);\n  }\n  return out;\n}\n","import { EventBus } from \"./bus.js\";\nimport { expandKinds, type PulseEvent, type PulseEventKind } from \"./events.js\";\n\n/** Runtime features that can be toggled by humans (panel) and agents (CLI) alike. */\nexport type Feature =\n  | \"solid\"\n  | \"dom\"\n  | \"flash\"\n  | \"network\"\n  | \"query\"\n  | \"queryOverlay\"\n  | \"verboseComputations\"\n  | \"captureBodies\";\n\nexport const FEATURES: Feature[] = [\n  \"solid\",\n  \"dom\",\n  \"flash\",\n  \"network\",\n  \"query\",\n  \"queryOverlay\",\n  \"verboseComputations\",\n  \"captureBodies\",\n];\n\nexport interface CommandSpec {\n  /** Dotted command name, e.g. `features.set`. Also the CLI verb. */\n  name: string;\n  summary: string;\n  /** Argument name → short description. */\n  args?: Record<string, string>;\n  /** Where the equivalent human control lives in the panel (parity doc). */\n  ui?: string;\n}\n\nexport type CommandHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;\n\nexport type CommandResult =\n  | { ok: true; value: unknown }\n  | { ok: false; error: string };\n\nexport interface Filters {\n  /** Kind filters (exact kinds, groups, or `prefix.*`); empty = all. */\n  kinds: string[];\n  /** Case-insensitive substring on component name. */\n  component: string;\n  /** Case-insensitive substring on any string in `data` (URLs, keys). */\n  text: string;\n}\n\nexport type FeatureListener = (feature: Feature, on: boolean) => void;\n\n/**\n * The single command surface. The panel's buttons, the bridge's HTTP API and\n * the CLI all call `run()`, so parity between human and agent control is a\n * property of the design rather than a checklist. `describe()` is the\n * machine-readable contract the CLI prints and the parity test asserts on.\n */\nexport class PulseController {\n  readonly bus: EventBus;\n  private commands = new Map<string, { spec: CommandSpec; handler: CommandHandler }>();\n  private features: Record<Feature, boolean>;\n  private featureListeners = new Set<FeatureListener>();\n  filters: Filters = { kinds: [], component: \"\", text: \"\" };\n  private filterListeners = new Set<(f: Filters) => void>();\n  readonly startedWall = Date.now();\n\n  constructor(bus = new EventBus(), initial: Partial<Record<Feature, boolean>> = {}) {\n    this.bus = bus;\n    this.features = {\n      solid: true,\n      dom: true,\n      flash: true,\n      network: true,\n      query: true,\n      queryOverlay: true,\n      verboseComputations: false,\n      captureBodies: false,\n      ...initial,\n    };\n    this.registerCore();\n  }\n\n  // ── features ─────────────────────────────────────────────────────\n\n  isOn(feature: Feature) {\n    return this.features[feature];\n  }\n\n  setFeature(feature: Feature, on: boolean) {\n    if (!FEATURES.includes(feature)) throw new Error(`unknown feature: ${feature}`);\n    if (this.features[feature] === on) return;\n    this.features[feature] = on;\n    for (const l of this.featureListeners) l(feature, on);\n    this.bus.emit(\"pulse.note\", { note: `feature ${feature} ${on ? \"on\" : \"off\"}` });\n  }\n\n  onFeature(listener: FeatureListener) {\n    this.featureListeners.add(listener);\n    return () => this.featureListeners.delete(listener);\n  }\n\n  snapshotFeatures() {\n    return { ...this.features };\n  }\n\n  // ── filters ──────────────────────────────────────────────────────\n\n  setFilters(next: Partial<Filters>) {\n    this.filters = { ...this.filters, ...next };\n    for (const l of this.filterListeners) l(this.filters);\n  }\n\n  onFilters(listener: (f: Filters) => void) {\n    this.filterListeners.add(listener);\n    return () => this.filterListeners.delete(listener);\n  }\n\n  matchesFilters(e: PulseEvent, f: Filters = this.filters): boolean {\n    if (f.kinds.length) {\n      const kinds = expandKinds(f.kinds);\n      if (kinds.size && !kinds.has(e.kind)) return false;\n    }\n    if (f.component) {\n      const name = e.component?.name ?? \"\";\n      const chain = e.component?.chain?.join(\" \") ?? \"\";\n      const needle = f.component.toLowerCase();\n      if (!name.toLowerCase().includes(needle) && !chain.toLowerCase().includes(needle)) return false;\n    }\n    if (f.text) {\n      const needle = f.text.toLowerCase();\n      if (!JSON.stringify(e.data).toLowerCase().includes(needle)) return false;\n    }\n    return true;\n  }\n\n  /** Buffered events after `since`, through the active filters. */\n  events(opts: { since?: number; limit?: number; kinds?: string[]; raw?: boolean } = {}) {\n    const kinds = opts.kinds ? expandKinds(opts.kinds) : null;\n    const list = this.bus.list({ since: opts.since, limit: opts.raw ? opts.limit : 5000, kinds });\n    const filtered = opts.raw ? list : list.filter((e) => this.matchesFilters(e));\n    const limit = opts.limit ?? 500;\n    return filtered.length > limit ? filtered.slice(filtered.length - limit) : filtered;\n  }\n\n  // ── commands ─────────────────────────────────────────────────────\n\n  register(spec: CommandSpec, handler: CommandHandler) {\n    if (this.commands.has(spec.name)) throw new Error(`command already registered: ${spec.name}`);\n    this.commands.set(spec.name, { spec, handler });\n  }\n\n  unregister(name: string) {\n    this.commands.delete(name);\n  }\n\n  has(name: string) {\n    return this.commands.has(name);\n  }\n\n  describe(): CommandSpec[] {\n    return [...this.commands.values()].map((c) => c.spec).sort((a, b) => a.name.localeCompare(b.name));\n  }\n\n  async run(name: string, args: Record<string, unknown> = {}): Promise<CommandResult> {\n    const cmd = this.commands.get(name);\n    if (!cmd) return { ok: false, error: `unknown command: ${name}` };\n    try {\n      const value = await cmd.handler(args ?? {});\n      return { ok: true, value: value === undefined ? null : value };\n    } catch (err) {\n      return { ok: false, error: err instanceof Error ? err.message : String(err) };\n    }\n  }\n\n  private registerCore() {\n    this.register(\n      { name: \"status\", summary: \"Runtime status: features, filters, buffer stats, recording.\", ui: \"panel header\" },\n      () => ({\n        startedWall: this.startedWall,\n        features: this.snapshotFeatures(),\n        filters: this.filters,\n        buffer: { size: this.bus.buffer.size, capacity: this.bus.buffer.capacity, dropped: this.bus.buffer.dropped, seq: this.bus.nextSeq - 1 },\n        paused: this.bus.paused,\n        recording: this.bus.currentRecording()?.id ?? null,\n        commands: this.commands.size,\n      }),\n    );\n    this.register(\n      { name: \"commands\", summary: \"List every command with its panel equivalent (the parity contract).\" },\n      () => this.describe(),\n    );\n    this.register(\n      { name: \"features.list\", summary: \"Feature flags and their current state.\", ui: \"Pulse tab › toggles\" },\n      () => this.snapshotFeatures(),\n    );\n    this.register(\n      {\n        name: \"features.set\",\n        summary: \"Turn a feature on/off.\",\n        args: { name: FEATURES.join(\"|\"), on: \"true|false (default true)\" },\n        ui: \"Pulse tab › toggles\",\n      },\n      (a) => {\n        const name = String(a.name ?? \"\") as Feature;\n        const on = a.on === undefined ? true : a.on === true || a.on === \"true\" || a.on === \"on\" || a.on === 1;\n        this.setFeature(name, on);\n        return this.snapshotFeatures();\n      },\n    );\n    this.register(\n      {\n        name: \"filters.set\",\n        summary: \"Set event filters (kinds list, component substring, text substring). Empty string clears.\",\n        args: { kinds: \"comma list: solid,dom,net,query or kinds/globs\", component: \"substring\", text: \"substring\" },\n        ui: \"Pulse tab › filter bar\",\n      },\n      (a) => {\n        const next: Partial<Filters> = {};\n        if (a.kinds !== undefined) {\n          next.kinds = Array.isArray(a.kinds)\n            ? (a.kinds as unknown[]).map(String)\n            : String(a.kinds).split(\",\").map((s) => s.trim()).filter(Boolean);\n        }\n        if (a.component !== undefined) next.component = String(a.component);\n        if (a.text !== undefined) next.text = String(a.text);\n        this.setFilters(next);\n        return this.filters;\n      },\n    );\n    this.register({ name: \"filters.get\", summary: \"Current filters.\", ui: \"Pulse tab › filter bar\" }, () => this.filters);\n    this.register(\n      {\n        name: \"events.list\",\n        summary: \"Buffered events (oldest first) through the active filters.\",\n        args: { since: \"seq to start after\", limit: \"max rows (default 200)\", kinds: \"override kind filter\", raw: \"true = ignore filters\" },\n        ui: \"Pulse tab › event list\",\n      },\n      (a) => {\n        const kinds = a.kinds === undefined ? undefined : String(a.kinds).split(\",\").map((s) => s.trim()).filter(Boolean);\n        return this.events({\n          since: a.since === undefined ? undefined : Number(a.since),\n          limit: a.limit === undefined ? 200 : Number(a.limit),\n          kinds,\n          raw: a.raw === true || a.raw === \"true\",\n        });\n      },\n    );\n    this.register({ name: \"events.clear\", summary: \"Clear the event buffer.\", ui: \"Pulse tab › Clear\" }, () => {\n      this.bus.clear();\n      return { cleared: true };\n    });\n    this.register({ name: \"events.pause\", summary: \"Stop capturing new events (buffer kept).\", ui: \"Pulse tab › Pause\" }, () => {\n      this.bus.paused = true;\n      return { paused: true };\n    });\n    this.register({ name: \"events.resume\", summary: \"Resume capturing.\", ui: \"Pulse tab › Pause\" }, () => {\n      this.bus.paused = false;\n      return { paused: false };\n    });\n    this.register(\n      { name: \"note\", summary: \"Append a marker note to the timeline (agents: label a QA step).\", args: { text: \"note text\" }, ui: \"Record tab › Note\" },\n      (a) => this.bus.emit(\"pulse.note\", { note: String(a.text ?? \"\") }),\n    );\n    this.register(\n      { name: \"record.start\", summary: \"Start a recording (stops any active one).\", args: { id: \"optional id\", limit: \"max events (default 20000)\" }, ui: \"Record tab › Start\" },\n      (a) => {\n        const rec = this.bus.startRecording(a.id === undefined ? undefined : String(a.id), a.limit === undefined ? undefined : Number(a.limit));\n        return { id: rec.id, startedWall: rec.startedWall };\n      },\n    );\n    this.register({ name: \"record.stop\", summary: \"Stop the active recording.\", ui: \"Record tab › Stop\" }, () => {\n      const rec = this.bus.stopRecording();\n      return rec ? { id: rec.id, events: rec.events.length } : null;\n    });\n    this.register({ name: \"record.list\", summary: \"Recordings kept in memory (last 5).\", ui: \"Record tab › list\" }, () => this.bus.listRecordings());\n    this.register(\n      {\n        name: \"export\",\n        summary: \"Export a recording (or the live buffer) as JSON: {meta, events}.\",\n        args: { recording: \"recording id; omit for the live buffer\", filtered: \"true = apply filters to the live buffer\" },\n        ui: \"Record tab › Export\",\n      },\n      (a) => {\n        const id = a.recording === undefined ? null : String(a.recording);\n        const rec = id ? this.bus.getRecording(id) : null;\n        if (id && !rec) throw new Error(`unknown recording: ${id}`);\n        const events = rec ? rec.events : a.filtered === true || a.filtered === \"true\" ? this.events({ limit: 100_000 }) : this.bus.list({ limit: 100_000 });\n        return {\n          meta: {\n            tool: \"@omniaura/solid-pulse\",\n            exportedWall: Date.now(),\n            recording: rec ? { id: rec.id, startedWall: rec.startedWall, stoppedAt: rec.stoppedAt } : null,\n            features: this.snapshotFeatures(),\n            filters: this.filters,\n            count: events.length,\n          },\n          events,\n        };\n      },\n    );\n  }\n}\n\nexport type { PulseEvent, PulseEventKind };\n"],"mappings":"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","names":[]}

package/dist/chunk-IXNWEUNF.js

@@ -0,0 +1,114 @@
+// src/overlay/flash.ts
+var COLORS = {
+  dom: "245,158,11",
+  mount: "34,197,94",
+  reattach: "239,68,68",
+  query: "59,130,246",
+  highlight: "168,85,247"
+};
+var OWN_ATTR = "data-solid-pulse";
+var MAX_LIVE_RECTS = 48;
+var MAX_LIVE_BADGES = 4;
+var FlashOverlay = class {
+  root = null;
+  live = 0;
+  badges = 0;
+  reduced = false;
+  mount() {
+    if (this.root || typeof document === "undefined") return;
+    const root = document.createElement("div");
+    root.setAttribute(OWN_ATTR, "overlay");
+    root.setAttribute("aria-hidden", "true");
+    root.style.cssText = "position:fixed;inset:0;pointer-events:none;z-index:2147483646;contain:strict;overflow:hidden;font:12px/1.3 ui-monospace,SFMono-Regular,Menlo,monospace;";
+    const style = document.createElement("style");
+    style.textContent = `
+@keyframes sp-flash{0%{opacity:.85}100%{opacity:0}}
+@keyframes sp-badge{0%{opacity:0;transform:translate(-50%,-50%) scale(.96)}12%{opacity:1;transform:translate(-50%,-50%) scale(1)}75%{opacity:1}100%{opacity:0}}
+[${OWN_ATTR}="rect"]{position:absolute;box-sizing:border-box;border-radius:3px;animation:sp-flash var(--ms,600ms) ease-out forwards}
+[${OWN_ATTR}="badge"]{position:absolute;max-width:min(60vw,560px);padding:6px 10px;border-radius:8px;color:#fff;background:rgba(17,24,39,.92);box-shadow:0 4px 18px rgba(0,0,0,.35);white-space:pre-wrap;word-break:break-all;animation:sp-badge var(--ms,1200ms) ease-out forwards}
+[${OWN_ATTR}="badge"] b{font-weight:600}
+`;
+    root.appendChild(style);
+    (document.body ?? document.documentElement).appendChild(root);
+    this.root = root;
+    try {
+      this.reduced = window.matchMedia?.("(prefers-reduced-motion: reduce)").matches ?? false;
+    } catch {
+      this.reduced = false;
+    }
+  }
+  unmount() {
+    this.root?.remove();
+    this.root = null;
+    this.live = 0;
+    this.badges = 0;
+  }
+  get mounted() {
+    return this.root !== null;
+  }
+  /** Flash rectangles in viewport coordinates. Drops extras beyond the live cap. */
+  flash(rects, kind, opts = {}) {
+    if (!this.root) return 0;
+    const ms = this.reduced ? Math.min(opts.ms ?? 600, 250) : opts.ms ?? 600;
+    const color = COLORS[kind];
+    let drawn = 0;
+    for (const r of rects) {
+      if (this.live >= MAX_LIVE_RECTS) break;
+      if (r.w <= 0 || r.h <= 0) continue;
+      const el = document.createElement("div");
+      el.setAttribute(OWN_ATTR, "rect");
+      el.style.cssText = `left:${r.x}px;top:${r.y}px;width:${r.w}px;height:${r.h}px;background:rgba(${color},.18);border:2px solid rgba(${color},.9);--ms:${ms}ms`;
+      if (opts.label && drawn === 0) {
+        const tag = document.createElement("span");
+        tag.textContent = opts.label;
+        tag.style.cssText = `position:absolute;left:-2px;top:-18px;padding:1px 5px;border-radius:3px;color:#fff;background:rgba(${color},.95);font-size:10px;white-space:nowrap`;
+        el.appendChild(tag);
+      }
+      this.root.appendChild(el);
+      this.live++;
+      drawn++;
+      setTimeout(() => {
+        el.remove();
+        this.live--;
+      }, ms + 20);
+    }
+    return drawn;
+  }
+  /**
+   * Transient badge centred on `at` (or the viewport when null). Used for the
+   * Solid Query overlay: "<Component> observing ['todos', 1]".
+   */
+  badge(html, at, opts = {}) {
+    if (!this.root) return false;
+    if (this.badges >= MAX_LIVE_BADGES) return false;
+    const ms = this.reduced ? Math.min(opts.ms ?? 1200, 600) : opts.ms ?? 1200;
+    const color = COLORS[opts.kind ?? "query"];
+    const vw = window.innerWidth;
+    const vh = window.innerHeight;
+    const cx = at ? Math.min(Math.max(at.x + at.w / 2, 80), vw - 80) : vw / 2;
+    const cy = at ? Math.min(Math.max(at.y + at.h / 2, 30), vh - 30) : vh / 2;
+    const el = document.createElement("div");
+    el.setAttribute(OWN_ATTR, "badge");
+    el.style.cssText = `left:${cx}px;top:${cy + this.badges * 34}px;border-left:4px solid rgb(${color});--ms:${ms}ms`;
+    const b = document.createElement("b");
+    b.textContent = html.title;
+    el.appendChild(b);
+    if (html.body) {
+      el.appendChild(document.createElement("br"));
+      el.appendChild(document.createTextNode(html.body));
+    }
+    this.root.appendChild(el);
+    this.badges++;
+    setTimeout(() => {
+      el.remove();
+      this.badges--;
+    }, ms + 20);
+    return true;
+  }
+};
+
+export {
+  OWN_ATTR,
+  FlashOverlay
+};
+//# sourceMappingURL=chunk-IXNWEUNF.js.map

package/dist/chunk-IXNWEUNF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/overlay/flash.ts"],"sourcesContent":["/**\n * Visual layer. One fixed, pointer-events:none container holds every flash\n * rectangle and badge, so the overlay can never shift layout, take focus or\n * intercept input. Everything is plain DOM (no Solid) so it produces no\n * reactive events of its own and works with any Solid version.\n */\n\nimport type { Rect } from \"../core/events.js\";\n\nexport type FlashKind = \"dom\" | \"mount\" | \"reattach\" | \"query\" | \"highlight\";\n\nconst COLORS: Record<FlashKind, string> = {\n  dom: \"245,158,11\",\n  mount: \"34,197,94\",\n  reattach: \"239,68,68\",\n  query: \"59,130,246\",\n  highlight: \"168,85,247\",\n};\n\nexport const OWN_ATTR = \"data-solid-pulse\";\n\nconst MAX_LIVE_RECTS = 48;\nconst MAX_LIVE_BADGES = 4;\n\nexport class FlashOverlay {\n  private root: HTMLDivElement | null = null;\n  private live = 0;\n  private badges = 0;\n  private reduced = false;\n\n  mount() {\n    if (this.root || typeof document === \"undefined\") return;\n    const root = document.createElement(\"div\");\n    root.setAttribute(OWN_ATTR, \"overlay\");\n    root.setAttribute(\"aria-hidden\", \"true\");\n    root.style.cssText =\n      \"position:fixed;inset:0;pointer-events:none;z-index:2147483646;contain:strict;overflow:hidden;font:12px/1.3 ui-monospace,SFMono-Regular,Menlo,monospace;\";\n    const style = document.createElement(\"style\");\n    style.textContent = `\n@keyframes sp-flash{0%{opacity:.85}100%{opacity:0}}\n@keyframes sp-badge{0%{opacity:0;transform:translate(-50%,-50%) scale(.96)}12%{opacity:1;transform:translate(-50%,-50%) scale(1)}75%{opacity:1}100%{opacity:0}}\n[${OWN_ATTR}=\"rect\"]{position:absolute;box-sizing:border-box;border-radius:3px;animation:sp-flash var(--ms,600ms) ease-out forwards}\n[${OWN_ATTR}=\"badge\"]{position:absolute;max-width:min(60vw,560px);padding:6px 10px;border-radius:8px;color:#fff;background:rgba(17,24,39,.92);box-shadow:0 4px 18px rgba(0,0,0,.35);white-space:pre-wrap;word-break:break-all;animation:sp-badge var(--ms,1200ms) ease-out forwards}\n[${OWN_ATTR}=\"badge\"] b{font-weight:600}\n`;\n    root.appendChild(style);\n    (document.body ?? document.documentElement).appendChild(root);\n    this.root = root;\n    try {\n      this.reduced = window.matchMedia?.(\"(prefers-reduced-motion: reduce)\").matches ?? false;\n    } catch {\n      this.reduced = false;\n    }\n  }\n\n  unmount() {\n    this.root?.remove();\n    this.root = null;\n    this.live = 0;\n    this.badges = 0;\n  }\n\n  get mounted() {\n    return this.root !== null;\n  }\n\n  /** Flash rectangles in viewport coordinates. Drops extras beyond the live cap. */\n  flash(rects: readonly Rect[], kind: FlashKind, opts: { ms?: number; label?: string } = {}) {\n    if (!this.root) return 0;\n    const ms = this.reduced ? Math.min(opts.ms ?? 600, 250) : (opts.ms ?? 600);\n    const color = COLORS[kind];\n    let drawn = 0;\n    for (const r of rects) {\n      if (this.live >= MAX_LIVE_RECTS) break;\n      if (r.w <= 0 || r.h <= 0) continue;\n      const el = document.createElement(\"div\");\n      el.setAttribute(OWN_ATTR, \"rect\");\n      el.style.cssText = `left:${r.x}px;top:${r.y}px;width:${r.w}px;height:${r.h}px;background:rgba(${color},.18);border:2px solid rgba(${color},.9);--ms:${ms}ms`;\n      if (opts.label && drawn === 0) {\n        const tag = document.createElement(\"span\");\n        tag.textContent = opts.label;\n        tag.style.cssText = `position:absolute;left:-2px;top:-18px;padding:1px 5px;border-radius:3px;color:#fff;background:rgba(${color},.95);font-size:10px;white-space:nowrap`;\n        el.appendChild(tag);\n      }\n      this.root.appendChild(el);\n      this.live++;\n      drawn++;\n      setTimeout(() => {\n        el.remove();\n        this.live--;\n      }, ms + 20);\n    }\n    return drawn;\n  }\n\n  /**\n   * Transient badge centred on `at` (or the viewport when null). Used for the\n   * Solid Query overlay: \"<Component> observing ['todos', 1]\".\n   */\n  badge(html: { title: string; body?: string }, at: Rect | null, opts: { ms?: number; kind?: FlashKind } = {}) {\n    if (!this.root) return false;\n    if (this.badges >= MAX_LIVE_BADGES) return false;\n    const ms = this.reduced ? Math.min(opts.ms ?? 1200, 600) : (opts.ms ?? 1200);\n    const color = COLORS[opts.kind ?? \"query\"];\n    const vw = window.innerWidth;\n    const vh = window.innerHeight;\n    const cx = at ? Math.min(Math.max(at.x + at.w / 2, 80), vw - 80) : vw / 2;\n    const cy = at ? Math.min(Math.max(at.y + at.h / 2, 30), vh - 30) : vh / 2;\n    const el = document.createElement(\"div\");\n    el.setAttribute(OWN_ATTR, \"badge\");\n    el.style.cssText = `left:${cx}px;top:${cy + this.badges * 34}px;border-left:4px solid rgb(${color});--ms:${ms}ms`;\n    const b = document.createElement(\"b\");\n    b.textContent = html.title;\n    el.appendChild(b);\n    if (html.body) {\n      el.appendChild(document.createElement(\"br\"));\n      el.appendChild(document.createTextNode(html.body));\n    }\n    this.root.appendChild(el);\n    this.badges++;\n    setTimeout(() => {\n      el.remove();\n      this.badges--;\n    }, ms + 20);\n    return true;\n  }\n}\n"],"mappings":"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","names":[]}