@echojs-ecosystem/devtools 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+<div align="center">
+
+# @echojs-ecosystem/devtools
+
+**Runtime registry and event timeline for EchoJS DevTools — no UI, zero overhead when disabled.**
+
+[![npm](https://img.shields.io/npm/v/@echojs-ecosystem/devtools)](https://www.npmjs.com/package/@echojs-ecosystem/devtools)
+[![docs](https://img.shields.io/badge/docs-echojs.dev-blue)](https://echojs.dev/docs/packages/devtools)
+
+</div>
+
+---
+
+Infrastructure layer for EchoJS DevTools. Provides a **global bridge**, **node registry**, and **FIFO event timeline**. Integrating packages (store, query, router, …) register automatically — end users rarely call these APIs directly.
+
+## Features
+
+- **Registry** — nodes with `type`, `id`, `name`, optional `getSnapshot()`
+- **Timeline** — event log (default max 500 events) with subscribe API
+- **Global bridge** — `globalThis.__ECHOJS_DEVTOOLS__`
+- **Production-safe** — `setDevtoolsEnabled(false)` makes all APIs no-ops
+- **Zero dependencies** — `sideEffects: false`, tree-shakeable
+
+## Install
+
+```bash
+npm install @echojs-ecosystem/devtools
+```
+
+Or via the meta-package:
+
+```bash
+npm install @echojs-ecosystem/framework
+```
+
+```ts
+import { setDevtoolsEnabled } from "@echojs-ecosystem/framework/devtools";
+```
+
+## Quick start
+
+```ts
+import {
+  registerDevtoolsNode,
+  emitDevtoolsEvent,
+  subscribeTimeline,
+  setDevtoolsEnabled,
+} from "@echojs-ecosystem/devtools";
+
+setDevtoolsEnabled(import.meta.env.DEV);
+
+const node = registerDevtoolsNode({
+  type: "store",
+  id: "auth",
+  name: "authStore",
+  getSnapshot: () => ({ token: authStore.value() }),
+});
+
+emitDevtoolsEvent({
+  source: "store",
+  type: "changed",
+  nodeId: "auth",
+  payload: { value, prevValue },
+});
+
+subscribeTimeline((event) => console.log(event));
+node.unregister();
+```
+
+## Node types
+
+`store` · `query` · `mutation` · `router` · `persist` · `url-state` · `ui-provider` · `signal` · `custom`
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `registerDevtoolsNode` | Register inspectable node |
+| `emitDevtoolsEvent` | Append timeline event |
+| `getNodeSnapshot` / `getAllSnapshots` | Read current state |
+| `subscribeTimeline` | Listen to events |
+| `getDevtoolsBridge` | Full bridge access |
+| `setDevtoolsEnabled` | Toggle all DevTools APIs |
+| `createDevtoolsId`, `safeSerialize` | Utilities |
+
+## Documentation
+
+[echojs.dev/docs/packages/devtools](https://echojs.dev/docs/packages/devtools)

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+type DevtoolsNodeType = 'store' | 'query' | 'mutation' | 'router' | 'persist' | 'url-state' | 'ui-provider' | 'signal' | 'custom';
+type DevtoolsEventSource = 'store' | 'query' | 'mutation' | 'router' | 'persist' | 'url-state' | 'ui' | 'custom';
+type DevtoolsNode = {
+    id: string;
+    type: DevtoolsNodeType;
+    name?: string;
+    getSnapshot?: () => unknown;
+};
+type RegisterDevtoolsNodeInput = {
+    id?: string;
+    type: DevtoolsNodeType;
+    name?: string;
+    getSnapshot?: () => unknown;
+};
+type RegisteredNode = {
+    unregister(): void;
+};
+type DevtoolsSnapshot = {
+    id: string;
+    type: DevtoolsNodeType;
+    name?: string;
+    state: unknown;
+    timestamp: number;
+};
+type DevtoolsEvent = {
+    id: string;
+    timestamp: number;
+    source: DevtoolsEventSource;
+    type: string;
+    nodeId?: string;
+    payload?: unknown;
+};
+type EmitDevtoolsEventInput = {
+    id?: string;
+    timestamp?: number;
+    source: DevtoolsEventSource;
+    type: string;
+    nodeId?: string;
+    payload?: unknown;
+};
+type TimelineListener = (event: DevtoolsEvent) => void;
+type DevtoolsRegistryAPI = {
+    register(input: RegisterDevtoolsNodeInput): RegisteredNode;
+    unregister(nodeId: string): boolean;
+    get(nodeId: string): DevtoolsNode | undefined;
+    getSnapshot(nodeId: string): DevtoolsSnapshot | undefined;
+    getAllSnapshots(): DevtoolsSnapshot[];
+    list(): DevtoolsNode[];
+};
+type DevtoolsTimelineAPI = {
+    emit(input: EmitDevtoolsEventInput): DevtoolsEvent | null;
+    getEvents(): readonly DevtoolsEvent[];
+    subscribe(listener: TimelineListener): () => void;
+    setMaxEvents(max: number): void;
+    clear(): void;
+};
+type EchoJSDevtoolsBridge = {
+    registry: DevtoolsRegistryAPI;
+    timeline: DevtoolsTimelineAPI;
+};
+declare const DEVTOOLS_GLOBAL_HOOK_KEY: "__ECHOJS_DEVTOOLS__";
+declare global {
+    var __ECHOJS_DEVTOOLS__: EchoJSDevtoolsBridge | undefined;
+}
+
+declare const setDevtoolsEnabled: (enabled: boolean) => void;
+declare const isDevtoolsEnabled: () => boolean;
+declare const createDevtoolsBridge: () => EchoJSDevtoolsBridge;
+declare const getOrCreateDevtoolsBridge: () => EchoJSDevtoolsBridge;
+declare const getDevtoolsBridge: () => EchoJSDevtoolsBridge | null;
+/** @internal Resets bridge state — tests only */
+declare const __resetDevtoolsCoreForTests: () => void;
+
+declare const createDevtoolsId: (prefix?: string) => string;
+/** @internal Test helper */
+declare const resetDevtoolsIds: () => void;
+
+type SafeSerializeOptions = {
+    maxDepth?: number;
+};
+declare const safeSerialize: (value: unknown, options?: SafeSerializeOptions) => unknown;
+
+declare class DevtoolsRegistry implements DevtoolsRegistryAPI {
+    #private;
+    register(input: RegisterDevtoolsNodeInput): RegisteredNode;
+    unregister(nodeId: string): boolean;
+    get(nodeId: string): DevtoolsNode | undefined;
+    getSnapshot(nodeId: string): DevtoolsSnapshot | undefined;
+    getAllSnapshots(): DevtoolsSnapshot[];
+    list(): DevtoolsNode[];
+    clear(): void;
+}
+
+declare class DevtoolsTimeline implements DevtoolsTimelineAPI {
+    #private;
+    emit(input: EmitDevtoolsEventInput): DevtoolsEvent;
+    getEvents(): readonly DevtoolsEvent[];
+    subscribe(listener: TimelineListener): () => void;
+    setMaxEvents(max: number): void;
+    clear(): void;
+}
+
+declare const registerDevtoolsNode: (input: RegisterDevtoolsNodeInput) => RegisteredNode;
+declare const unregisterDevtoolsNode: (nodeId: string) => boolean;
+declare const emitDevtoolsEvent: (input: EmitDevtoolsEventInput) => DevtoolsEvent | null;
+declare const getNodeSnapshot: (nodeId: string) => DevtoolsSnapshot | undefined;
+declare const getAllSnapshots: () => DevtoolsSnapshot[];
+declare const getTimelineEvents: () => readonly DevtoolsEvent[];
+declare const subscribeTimeline: (listener: TimelineListener) => (() => void);
+
+export { DEVTOOLS_GLOBAL_HOOK_KEY, type DevtoolsEvent, type DevtoolsEventSource, type DevtoolsNode, type DevtoolsNodeType, DevtoolsRegistry, type DevtoolsRegistryAPI, type DevtoolsSnapshot, DevtoolsTimeline, type DevtoolsTimelineAPI, type EchoJSDevtoolsBridge, type EmitDevtoolsEventInput, type RegisterDevtoolsNodeInput, type RegisteredNode, type TimelineListener, __resetDevtoolsCoreForTests, createDevtoolsBridge, createDevtoolsId, emitDevtoolsEvent, getAllSnapshots, getDevtoolsBridge, getNodeSnapshot, getOrCreateDevtoolsBridge, getTimelineEvents, isDevtoolsEnabled, registerDevtoolsNode, resetDevtoolsIds, safeSerialize, setDevtoolsEnabled, subscribeTimeline, unregisterDevtoolsNode };

package/dist/index.js

@@ -0,0 +1,260 @@
+// src/utils/serialize.ts
+var DEFAULT_MAX_DEPTH = 12;
+var safeSerialize = (value, options = {}) => {
+  const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+  const seen = /* @__PURE__ */ new WeakSet();
+  const walk = (current, depth) => {
+    if (depth > maxDepth) return "[MaxDepth]";
+    if (current === void 0) return void 0;
+    if (current === null) return null;
+    const valueType = typeof current;
+    if (valueType === "bigint") return `${current.toString()}n`;
+    if (valueType === "symbol") return current.toString();
+    if (valueType === "function") {
+      const fn = current;
+      return `[Function ${fn.name || "anonymous"}]`;
+    }
+    if (valueType !== "object") return current;
+    if (seen.has(current)) return "[Circular]";
+    if (current instanceof Date) return current.toISOString();
+    if (current instanceof RegExp) return current.toString();
+    if (current instanceof Map) {
+      seen.add(current);
+      return {
+        __type: "Map",
+        entries: [...current.entries()].map(([key, val]) => [walk(key, depth + 1), walk(val, depth + 1)])
+      };
+    }
+    if (current instanceof Set) {
+      seen.add(current);
+      return {
+        __type: "Set",
+        values: [...current.values()].map((val) => walk(val, depth + 1))
+      };
+    }
+    seen.add(current);
+    if (Array.isArray(current)) {
+      return current.map((item) => walk(item, depth + 1));
+    }
+    const record = current;
+    const output = {};
+    for (const key of Object.keys(record)) {
+      try {
+        output[key] = walk(record[key], depth + 1);
+      } catch {
+        output[key] = "[Unserializable]";
+      }
+    }
+    return output;
+  };
+  try {
+    return walk(value, 0);
+  } catch {
+    return "[Unserializable]";
+  }
+};
+
+// src/registry/snapshot.ts
+var captureNodeSnapshot = (node) => {
+  let state = null;
+  if (node.getSnapshot) {
+    try {
+      state = safeSerialize(node.getSnapshot());
+    } catch {
+      state = "[SnapshotError]";
+    }
+  }
+  return {
+    id: node.id,
+    type: node.type,
+    name: node.name,
+    state,
+    timestamp: Date.now()
+  };
+};
+
+// src/utils/id.ts
+var counters = /* @__PURE__ */ new Map();
+var createDevtoolsId = (prefix = "node") => {
+  const next = (counters.get(prefix) ?? 0) + 1;
+  counters.set(prefix, next);
+  return `${prefix}_${next}`;
+};
+var resetDevtoolsIds = () => {
+  counters.clear();
+};
+
+// src/registry/node.ts
+var normalizeDevtoolsNode = (input) => ({
+  id: input.id ?? createDevtoolsId(input.type),
+  type: input.type,
+  name: input.name,
+  getSnapshot: input.getSnapshot
+});
+
+// src/registry/registry.ts
+var DevtoolsRegistry = class {
+  #nodes = /* @__PURE__ */ new Map();
+  register(input) {
+    const node = normalizeDevtoolsNode(input);
+    if (this.#nodes.has(node.id)) {
+      throw new Error(`@echojs-ecosystem/devtools: node "${node.id}" is already registered`);
+    }
+    this.#nodes.set(node.id, node);
+    return {
+      unregister: () => {
+        this.unregister(node.id);
+      }
+    };
+  }
+  unregister(nodeId) {
+    return this.#nodes.delete(nodeId);
+  }
+  get(nodeId) {
+    return this.#nodes.get(nodeId);
+  }
+  getSnapshot(nodeId) {
+    const node = this.#nodes.get(nodeId);
+    if (!node) return void 0;
+    return captureNodeSnapshot(node);
+  }
+  getAllSnapshots() {
+    return [...this.#nodes.values()].map((node) => captureNodeSnapshot(node));
+  }
+  list() {
+    return [...this.#nodes.values()];
+  }
+  clear() {
+    this.#nodes.clear();
+  }
+};
+
+// src/timeline/event.ts
+var createDevtoolsEvent = (input) => ({
+  id: input.id ?? createDevtoolsId("event"),
+  timestamp: input.timestamp ?? Date.now(),
+  source: input.source,
+  type: input.type,
+  nodeId: input.nodeId,
+  payload: input.payload === void 0 ? void 0 : safeSerialize(input.payload)
+});
+
+// src/timeline/timeline.ts
+var DEFAULT_MAX_EVENTS = 500;
+var DevtoolsTimeline = class {
+  #events = [];
+  #maxEvents = DEFAULT_MAX_EVENTS;
+  #listeners = /* @__PURE__ */ new Set();
+  emit(input) {
+    const event = createDevtoolsEvent(input);
+    this.#events.push(event);
+    if (this.#events.length > this.#maxEvents) {
+      this.#events.splice(0, this.#events.length - this.#maxEvents);
+    }
+    for (const listener of this.#listeners) {
+      listener(event);
+    }
+    return event;
+  }
+  getEvents() {
+    return this.#events;
+  }
+  subscribe(listener) {
+    this.#listeners.add(listener);
+    return () => {
+      this.#listeners.delete(listener);
+    };
+  }
+  setMaxEvents(max) {
+    this.#maxEvents = Math.max(1, max);
+    if (this.#events.length > this.#maxEvents) {
+      this.#events.splice(0, this.#events.length - this.#maxEvents);
+    }
+  }
+  clear() {
+    this.#events.length = 0;
+  }
+};
+
+// src/types.ts
+var DEVTOOLS_GLOBAL_HOOK_KEY = "__ECHOJS_DEVTOOLS__";
+
+// src/bridge/global-hook.ts
+var readGlobalDevtoolsHook = () => globalThis[DEVTOOLS_GLOBAL_HOOK_KEY];
+var writeGlobalDevtoolsHook = (bridge) => {
+  const host = globalThis;
+  if (host[DEVTOOLS_GLOBAL_HOOK_KEY]) return;
+  host[DEVTOOLS_GLOBAL_HOOK_KEY] = bridge;
+};
+var clearGlobalDevtoolsHook = () => {
+  delete globalThis[DEVTOOLS_GLOBAL_HOOK_KEY];
+};
+
+// src/bridge/bridge.ts
+var devtoolsEnabled = true;
+var noopRegisteredNode = { unregister: () => {
+} };
+var setDevtoolsEnabled = (enabled) => {
+  devtoolsEnabled = enabled;
+};
+var isDevtoolsEnabled = () => devtoolsEnabled;
+var createDevtoolsBridge = () => ({
+  registry: new DevtoolsRegistry(),
+  timeline: new DevtoolsTimeline()
+});
+var getOrCreateDevtoolsBridge = () => {
+  const existing = readGlobalDevtoolsHook();
+  if (existing) return existing;
+  const bridge = createDevtoolsBridge();
+  writeGlobalDevtoolsHook(bridge);
+  return bridge;
+};
+var getDevtoolsBridge = () => {
+  if (!devtoolsEnabled) return null;
+  return readGlobalDevtoolsHook() ?? getOrCreateDevtoolsBridge();
+};
+var whenDevtoolsEnabled = (run) => {
+  if (!devtoolsEnabled) return null;
+  return run(getOrCreateDevtoolsBridge());
+};
+var disabledRegisteredNode = () => noopRegisteredNode;
+var __resetDevtoolsCoreForTests = () => {
+  devtoolsEnabled = true;
+  clearGlobalDevtoolsHook();
+};
+
+// src/index.ts
+var registerDevtoolsNode = (input) => {
+  if (!isDevtoolsEnabled()) return disabledRegisteredNode();
+  return whenDevtoolsEnabled((bridge) => bridge.registry.register(input));
+};
+var unregisterDevtoolsNode = (nodeId) => {
+  if (!isDevtoolsEnabled()) return false;
+  return whenDevtoolsEnabled((bridge) => bridge.registry.unregister(nodeId)) ?? false;
+};
+var emitDevtoolsEvent = (input) => {
+  if (!isDevtoolsEnabled()) return null;
+  return whenDevtoolsEnabled((bridge) => bridge.timeline.emit(input));
+};
+var getNodeSnapshot = (nodeId) => {
+  if (!isDevtoolsEnabled()) return void 0;
+  return whenDevtoolsEnabled((bridge) => bridge.registry.getSnapshot(nodeId)) ?? void 0;
+};
+var getAllSnapshots = () => {
+  if (!isDevtoolsEnabled()) return [];
+  return whenDevtoolsEnabled((bridge) => bridge.registry.getAllSnapshots()) ?? [];
+};
+var getTimelineEvents = () => {
+  if (!isDevtoolsEnabled()) return [];
+  return whenDevtoolsEnabled((bridge) => bridge.timeline.getEvents()) ?? [];
+};
+var subscribeTimeline = (listener) => {
+  if (!isDevtoolsEnabled()) return () => {
+  };
+  return whenDevtoolsEnabled((bridge) => bridge.timeline.subscribe(listener)) ?? (() => {
+  });
+};
+
+export { DEVTOOLS_GLOBAL_HOOK_KEY, DevtoolsRegistry, DevtoolsTimeline, __resetDevtoolsCoreForTests, createDevtoolsBridge, createDevtoolsId, emitDevtoolsEvent, getAllSnapshots, getDevtoolsBridge, getNodeSnapshot, getOrCreateDevtoolsBridge, getTimelineEvents, isDevtoolsEnabled, registerDevtoolsNode, resetDevtoolsIds, safeSerialize, setDevtoolsEnabled, subscribeTimeline, unregisterDevtoolsNode };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/serialize.ts","../src/registry/snapshot.ts","../src/utils/id.ts","../src/registry/node.ts","../src/registry/registry.ts","../src/timeline/event.ts","../src/timeline/timeline.ts","../src/types.ts","../src/bridge/global-hook.ts","../src/bridge/bridge.ts","../src/index.ts"],"names":[],"mappings":";AAIA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,aAAA,GAAgB,CAAC,KAAA,EAAgB,OAAA,GAAgC,EAAC,KAAe;AAC5F,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,iBAAA;AACrC,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AAEjC,EAAA,MAAM,IAAA,GAAO,CAAC,OAAA,EAAkB,KAAA,KAA2B;AACzD,IAAA,IAAI,KAAA,GAAQ,UAAU,OAAO,YAAA;AAE7B,IAAA,IAAI,OAAA,KAAY,QAAW,OAAO,MAAA;AAClC,IAAA,IAAI,OAAA,KAAY,MAAM,OAAO,IAAA;AAE7B,IAAA,MAAM,YAAY,OAAO,OAAA;AAEzB,IAAA,IAAI,cAAc,QAAA,EAAU,OAAO,CAAA,EAAG,OAAA,CAAQ,UAAU,CAAA,CAAA,CAAA;AACxD,IAAA,IAAI,SAAA,KAAc,QAAA,EAAU,OAAO,OAAA,CAAQ,QAAA,EAAS;AACpD,IAAA,IAAI,cAAc,UAAA,EAAY;AAC5B,MAAA,MAAM,EAAA,GAAK,OAAA;AACX,MAAA,OAAO,CAAA,UAAA,EAAa,EAAA,CAAG,IAAA,IAAQ,WAAW,CAAA,CAAA,CAAA;AAAA,IAC5C;AACA,IAAA,IAAI,SAAA,KAAc,UAAU,OAAO,OAAA;AAEnC,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,OAAiB,CAAA,EAAG,OAAO,YAAA;AAExC,IAAA,IAAI,OAAA,YAAmB,IAAA,EAAM,OAAO,OAAA,CAAQ,WAAA,EAAY;AACxD,IAAA,IAAI,OAAA,YAAmB,MAAA,EAAQ,OAAO,OAAA,CAAQ,QAAA,EAAS;AACvD,IAAA,IAAI,mBAAmB,GAAA,EAAK;AAC1B,MAAA,IAAA,CAAK,IAAI,OAAO,CAAA;AAChB,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS,CAAC,GAAG,OAAA,CAAQ,OAAA,EAAS,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,GAAG,MAAM,CAAC,IAAA,CAAK,GAAA,EAAK,KAAA,GAAQ,CAAC,CAAA,EAAG,KAAK,GAAA,EAAK,KAAA,GAAQ,CAAC,CAAC,CAAC;AAAA,OAClG;AAAA,IACF;AACA,IAAA,IAAI,mBAAmB,GAAA,EAAK;AAC1B,MAAA,IAAA,CAAK,IAAI,OAAO,CAAA;AAChB,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ,KAAA;AAAA,QACR,MAAA,EAAQ,CAAC,GAAG,OAAA,CAAQ,QAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,GAAA,KAAQ,IAAA,CAAK,GAAA,EAAK,KAAA,GAAQ,CAAC,CAAC;AAAA,OACjE;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,IAAI,OAAiB,CAAA;AAE1B,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AAC1B,MAAA,OAAO,OAAA,CAAQ,IAAI,CAAC,IAAA,KAAS,KAAK,IAAA,EAAM,KAAA,GAAQ,CAAC,CAAC,CAAA;AAAA,IACpD;AAEA,IAAA,MAAM,MAAA,GAAS,OAAA;AACf,IAAA,MAAM,SAAkC,EAAC;AAEzC,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AACrC,MAAA,IAAI;AACF,QAAA,MAAA,CAAO,GAAG,CAAA,GAAI,IAAA,CAAK,OAAO,GAAG,CAAA,EAAG,QAAQ,CAAC,CAAA;AAAA,MAC3C,CAAA,CAAA,MAAQ;AACN,QAAA,MAAA,CAAO,GAAG,CAAA,GAAI,kBAAA;AAAA,MAChB;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,EACtB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,kBAAA;AAAA,EACT;AACF;;;ACnEO,IAAM,mBAAA,GAAsB,CAAC,IAAA,KAAyC;AAC3E,EAAA,IAAI,KAAA,GAAiB,IAAA;AAErB,EAAA,IAAI,KAAK,WAAA,EAAa;AACpB,IAAA,IAAI;AACF,MAAA,KAAA,GAAQ,aAAA,CAAc,IAAA,CAAK,WAAA,EAAa,CAAA;AAAA,IAC1C,CAAA,CAAA,MAAQ;AACN,MAAA,KAAA,GAAQ,iBAAA;AAAA,IACV;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,IAAA,CAAK,EAAA;AAAA,IACT,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,KAAA;AAAA,IACA,SAAA,EAAW,KAAK,GAAA;AAAI,GACtB;AACF,CAAA;;;ACrBA,IAAM,QAAA,uBAAe,GAAA,EAAoB;AAElC,IAAM,gBAAA,GAAmB,CAAC,MAAA,GAAS,MAAA,KAAmB;AAC3D,EAAA,MAAM,IAAA,GAAA,CAAQ,QAAA,CAAS,GAAA,CAAI,MAAM,KAAK,CAAA,IAAK,CAAA;AAC3C,EAAA,QAAA,CAAS,GAAA,CAAI,QAAQ,IAAI,CAAA;AACzB,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA;AAC1B;AAGO,IAAM,mBAAmB,MAAY;AAC1C,EAAA,QAAA,CAAS,KAAA,EAAM;AACjB;;;ACRO,IAAM,qBAAA,GAAwB,CAAC,KAAA,MAAoD;AAAA,EACxF,EAAA,EAAI,KAAA,CAAM,EAAA,IAAM,gBAAA,CAAiB,MAAM,IAAI,CAAA;AAAA,EAC3C,MAAM,KAAA,CAAM,IAAA;AAAA,EACZ,MAAM,KAAA,CAAM,IAAA;AAAA,EACZ,aAAa,KAAA,CAAM;AACrB,CAAA,CAAA;;;ACEO,IAAM,mBAAN,MAAsD;AAAA,EAClD,MAAA,uBAAa,GAAA,EAA0B;AAAA,EAEhD,SAAS,KAAA,EAAkD;AACzD,IAAA,MAAM,IAAA,GAAO,sBAAsB,KAAK,CAAA;AAExC,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,EAAE,CAAA,EAAG;AAC5B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,IAAA,CAAK,EAAE,CAAA,uBAAA,CAAyB,CAAA;AAAA,IACvF;AAEA,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,IAAI,CAAA;AAE7B,IAAA,OAAO;AAAA,MACL,YAAY,MAAM;AAChB,QAAA,IAAA,CAAK,UAAA,CAAW,KAAK,EAAE,CAAA;AAAA,MACzB;AAAA,KACF;AAAA,EACF;AAAA,EAEA,WAAW,MAAA,EAAyB;AAClC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAAA,EAClC;AAAA,EAEA,IAAI,MAAA,EAA0C;AAC5C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA;AAAA,EAC/B;AAAA,EAEA,YAAY,MAAA,EAA8C;AACxD,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA;AACnC,IAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,IAAA,OAAO,oBAAoB,IAAI,CAAA;AAAA,EACjC;AAAA,EAEA,eAAA,GAAsC;AACpC,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,MAAA,CAAO,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,mBAAA,CAAoB,IAAI,CAAC,CAAA;AAAA,EAC1E;AAAA,EAEA,IAAA,GAAuB;AACrB,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA;AAAA,EACjC;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAO,KAAA,EAAM;AAAA,EACpB;AACF;;;AClDO,IAAM,mBAAA,GAAsB,CAAC,KAAA,MAAkD;AAAA,EACpF,EAAA,EAAI,KAAA,CAAM,EAAA,IAAM,gBAAA,CAAiB,OAAO,CAAA;AAAA,EACxC,SAAA,EAAW,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI;AAAA,EACvC,QAAQ,KAAA,CAAM,MAAA;AAAA,EACd,MAAM,KAAA,CAAM,IAAA;AAAA,EACZ,QAAQ,KAAA,CAAM,MAAA;AAAA,EACd,SACE,KAAA,CAAM,OAAA,KAAY,SAAY,MAAA,GAAY,aAAA,CAAc,MAAM,OAAO;AACzE,CAAA,CAAA;;;ACJA,IAAM,kBAAA,GAAqB,GAAA;AAEpB,IAAM,mBAAN,MAAsD;AAAA,EAC3D,UAA2B,EAAC;AAAA,EAC5B,UAAA,GAAa,kBAAA;AAAA,EACJ,UAAA,uBAAiB,GAAA,EAAsB;AAAA,EAEhD,KAAK,KAAA,EAA8C;AACjD,IAAA,MAAM,KAAA,GAAQ,oBAAoB,KAAK,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,KAAK,CAAA;AAEvB,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,UAAA,EAAY;AACzC,MAAA,IAAA,CAAK,QAAQ,MAAA,CAAO,CAAA,EAAG,KAAK,OAAA,CAAQ,MAAA,GAAS,KAAK,UAAU,CAAA;AAAA,IAC9D;AAEA,IAAA,KAAA,MAAW,QAAA,IAAY,KAAK,UAAA,EAAY;AACtC,MAAA,QAAA,CAAS,KAAK,CAAA;AAAA,IAChB;AAEA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,SAAA,GAAsC;AACpC,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,UAAU,QAAA,EAAwC;AAChD,IAAA,IAAA,CAAK,UAAA,CAAW,IAAI,QAAQ,CAAA;AAC5B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,UAAA,CAAW,OAAO,QAAQ,CAAA;AAAA,IACjC,CAAA;AAAA,EACF;AAAA,EAEA,aAAa,GAAA,EAAmB;AAC9B,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,GAAG,CAAA;AACjC,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,UAAA,EAAY;AACzC,MAAA,IAAA,CAAK,QAAQ,MAAA,CAAO,CAAA,EAAG,KAAK,OAAA,CAAQ,MAAA,GAAS,KAAK,UAAU,CAAA;AAAA,IAC9D;AAAA,EACF;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAQ,MAAA,GAAS,CAAA;AAAA,EACxB;AACF;;;ACsCO,IAAM,wBAAA,GAA2B;;;AClFjC,IAAM,sBAAA,GAAyB,MACnC,UAAA,CAA8B,wBAAwB,CAAA;AAElD,IAAM,uBAAA,GAA0B,CAAC,MAAA,KAAuC;AAC7E,EAAA,MAAM,IAAA,GAAO,UAAA;AACb,EAAA,IAAI,IAAA,CAAK,wBAAwB,CAAA,EAAG;AACpC,EAAA,IAAA,CAAK,wBAAwB,CAAA,GAAI,MAAA;AACnC,CAAA;AAEO,IAAM,0BAA0B,MAAY;AACjD,EAAA,OAAQ,WAA8B,wBAAwB,CAAA;AAChE,CAAA;;;ACTA,IAAI,eAAA,GAAkB,IAAA;AAEtB,IAAM,kBAAA,GAAqB,EAAE,UAAA,EAAY,MAAM;AAAC,CAAA,EAAE;AAE3C,IAAM,kBAAA,GAAqB,CAAC,OAAA,KAA2B;AAC5D,EAAA,eAAA,GAAkB,OAAA;AACpB;AAEO,IAAM,oBAAoB,MAAe;AAEzC,IAAM,uBAAuB,OAA6B;AAAA,EAC/D,QAAA,EAAU,IAAI,gBAAA,EAAiB;AAAA,EAC/B,QAAA,EAAU,IAAI,gBAAA;AAChB,CAAA;AAEO,IAAM,4BAA4B,MAA4B;AACnE,EAAA,MAAM,WAAW,sBAAA,EAAuB;AACxC,EAAA,IAAI,UAAU,OAAO,QAAA;AAErB,EAAA,MAAM,SAAS,oBAAA,EAAqB;AACpC,EAAA,uBAAA,CAAwB,MAAM,CAAA;AAC9B,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,oBAAoB,MAAmC;AAClE,EAAA,IAAI,CAAC,iBAAiB,OAAO,IAAA;AAC7B,EAAA,OAAO,sBAAA,MAA4B,yBAAA,EAA0B;AAC/D;AAEO,IAAM,mBAAA,GAAsB,CAAI,GAAA,KAAuD;AAC5F,EAAA,IAAI,CAAC,iBAAiB,OAAO,IAAA;AAC7B,EAAA,OAAO,GAAA,CAAI,2BAA2B,CAAA;AACxC,CAAA;AAEO,IAAM,yBAAyB,MAAiC,kBAAA;AAGhE,IAAM,8BAA8B,MAAY;AACrD,EAAA,eAAA,GAAkB,IAAA;AAClB,EAAA,uBAAA,EAAwB;AAC1B;;;ACFO,IAAM,oBAAA,GAAuB,CAAC,KAAA,KAAqD;AACxF,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,sBAAA,EAAuB;AACxD,EAAA,OAAO,oBAAoB,CAAC,MAAA,KAAW,OAAO,QAAA,CAAS,QAAA,CAAS,KAAK,CAAC,CAAA;AACxE;AAEO,IAAM,sBAAA,GAAyB,CAAC,MAAA,KAA4B;AACjE,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,KAAA;AACjC,EAAA,OAAO,mBAAA,CAAoB,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,UAAA,CAAW,MAAM,CAAC,CAAA,IAAK,KAAA;AAChF;AAEO,IAAM,iBAAA,GAAoB,CAAC,KAAA,KAAwD;AACxF,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,IAAA;AACjC,EAAA,OAAO,oBAAoB,CAAC,MAAA,KAAW,OAAO,QAAA,CAAS,IAAA,CAAK,KAAK,CAAC,CAAA;AACpE;AAEO,IAAM,eAAA,GAAkB,CAAC,MAAA,KAAiD;AAC/E,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,MAAA;AACjC,EAAA,OAAO,mBAAA,CAAoB,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,WAAA,CAAY,MAAM,CAAC,CAAA,IAAK,MAAA;AACjF;AAEO,IAAM,kBAAkB,MAA0B;AACvD,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,EAAC;AAClC,EAAA,OAAO,mBAAA,CAAoB,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,eAAA,EAAiB,KAAK,EAAC;AAChF;AAEO,IAAM,oBAAoB,MAAgC;AAC/D,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,EAAC;AAClC,EAAA,OAAO,mBAAA,CAAoB,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,SAAA,EAAW,KAAK,EAAC;AAC1E;AAEO,IAAM,iBAAA,GAAoB,CAAC,QAAA,KAA6C;AAC7E,EAAA,IAAI,CAAC,iBAAA,EAAkB,EAAG,OAAO,MAAM;AAAA,EAAC,CAAA;AACxC,EAAA,OAAO,mBAAA,CAAoB,CAAC,MAAA,KAAW,MAAA,CAAO,SAAS,SAAA,CAAU,QAAQ,CAAC,CAAA,KAAM,MAAM;AAAA,EAAC,CAAA,CAAA;AACzF","file":"index.js","sourcesContent":["export type SafeSerializeOptions = {\n  maxDepth?: number\n}\n\nconst DEFAULT_MAX_DEPTH = 12\n\nexport const safeSerialize = (value: unknown, options: SafeSerializeOptions = {}): unknown => {\n  const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH\n  const seen = new WeakSet<object>()\n\n  const walk = (current: unknown, depth: number): unknown => {\n    if (depth > maxDepth) return '[MaxDepth]'\n\n    if (current === undefined) return undefined\n    if (current === null) return null\n\n    const valueType = typeof current\n\n    if (valueType === 'bigint') return `${current.toString()}n`\n    if (valueType === 'symbol') return current.toString()\n    if (valueType === 'function') {\n      const fn = current as (...args: unknown[]) => unknown\n      return `[Function ${fn.name || 'anonymous'}]`\n    }\n    if (valueType !== 'object') return current\n\n    if (seen.has(current as object)) return '[Circular]'\n\n    if (current instanceof Date) return current.toISOString()\n    if (current instanceof RegExp) return current.toString()\n    if (current instanceof Map) {\n      seen.add(current)\n      return {\n        __type: 'Map',\n        entries: [...current.entries()].map(([key, val]) => [walk(key, depth + 1), walk(val, depth + 1)]),\n      }\n    }\n    if (current instanceof Set) {\n      seen.add(current)\n      return {\n        __type: 'Set',\n        values: [...current.values()].map((val) => walk(val, depth + 1)),\n      }\n    }\n\n    seen.add(current as object)\n\n    if (Array.isArray(current)) {\n      return current.map((item) => walk(item, depth + 1))\n    }\n\n    const record = current as Record<string, unknown>\n    const output: Record<string, unknown> = {}\n\n    for (const key of Object.keys(record)) {\n      try {\n        output[key] = walk(record[key], depth + 1)\n      } catch {\n        output[key] = '[Unserializable]'\n      }\n    }\n\n    return output\n  }\n\n  try {\n    return walk(value, 0)\n  } catch {\n    return '[Unserializable]'\n  }\n}\n","import type { DevtoolsNode, DevtoolsSnapshot } from '../types'\nimport { safeSerialize } from '../utils/serialize'\n\nexport const captureNodeSnapshot = (node: DevtoolsNode): DevtoolsSnapshot => {\n  let state: unknown = null\n\n  if (node.getSnapshot) {\n    try {\n      state = safeSerialize(node.getSnapshot())\n    } catch {\n      state = '[SnapshotError]'\n    }\n  }\n\n  return {\n    id: node.id,\n    type: node.type,\n    name: node.name,\n    state,\n    timestamp: Date.now(),\n  }\n}\n","const counters = new Map<string, number>()\n\nexport const createDevtoolsId = (prefix = 'node'): string => {\n  const next = (counters.get(prefix) ?? 0) + 1\n  counters.set(prefix, next)\n  return `${prefix}_${next}`\n}\n\n/** @internal Test helper */\nexport const resetDevtoolsIds = (): void => {\n  counters.clear()\n}\n","import type { DevtoolsNode, RegisterDevtoolsNodeInput } from '../types'\nimport { createDevtoolsId } from '../utils/id'\n\nexport const normalizeDevtoolsNode = (input: RegisterDevtoolsNodeInput): DevtoolsNode => ({\n  id: input.id ?? createDevtoolsId(input.type),\n  type: input.type,\n  name: input.name,\n  getSnapshot: input.getSnapshot,\n})\n","import { captureNodeSnapshot } from './snapshot'\nimport { normalizeDevtoolsNode } from './node'\nimport type {\n  DevtoolsNode,\n  DevtoolsRegistryAPI,\n  DevtoolsSnapshot,\n  RegisterDevtoolsNodeInput,\n  RegisteredNode,\n} from '../types'\n\nexport class DevtoolsRegistry implements DevtoolsRegistryAPI {\n  readonly #nodes = new Map<string, DevtoolsNode>()\n\n  register(input: RegisterDevtoolsNodeInput): RegisteredNode {\n    const node = normalizeDevtoolsNode(input)\n\n    if (this.#nodes.has(node.id)) {\n      throw new Error(`@echojs-ecosystem/devtools: node \"${node.id}\" is already registered`)\n    }\n\n    this.#nodes.set(node.id, node)\n\n    return {\n      unregister: () => {\n        this.unregister(node.id)\n      },\n    }\n  }\n\n  unregister(nodeId: string): boolean {\n    return this.#nodes.delete(nodeId)\n  }\n\n  get(nodeId: string): DevtoolsNode | undefined {\n    return this.#nodes.get(nodeId)\n  }\n\n  getSnapshot(nodeId: string): DevtoolsSnapshot | undefined {\n    const node = this.#nodes.get(nodeId)\n    if (!node) return undefined\n    return captureNodeSnapshot(node)\n  }\n\n  getAllSnapshots(): DevtoolsSnapshot[] {\n    return [...this.#nodes.values()].map((node) => captureNodeSnapshot(node))\n  }\n\n  list(): DevtoolsNode[] {\n    return [...this.#nodes.values()]\n  }\n\n  clear(): void {\n    this.#nodes.clear()\n  }\n}\n","import type { DevtoolsEvent, EmitDevtoolsEventInput } from '../types'\nimport { createDevtoolsId } from '../utils/id'\nimport { safeSerialize } from '../utils/serialize'\n\nexport const createDevtoolsEvent = (input: EmitDevtoolsEventInput): DevtoolsEvent => ({\n  id: input.id ?? createDevtoolsId('event'),\n  timestamp: input.timestamp ?? Date.now(),\n  source: input.source,\n  type: input.type,\n  nodeId: input.nodeId,\n  payload:\n    input.payload === undefined ? undefined : safeSerialize(input.payload),\n})\n","import { createDevtoolsEvent } from './event'\nimport type {\n  DevtoolsEvent,\n  DevtoolsTimelineAPI,\n  EmitDevtoolsEventInput,\n  TimelineListener,\n} from '../types'\n\nconst DEFAULT_MAX_EVENTS = 500\n\nexport class DevtoolsTimeline implements DevtoolsTimelineAPI {\n  #events: DevtoolsEvent[] = []\n  #maxEvents = DEFAULT_MAX_EVENTS\n  readonly #listeners = new Set<TimelineListener>()\n\n  emit(input: EmitDevtoolsEventInput): DevtoolsEvent {\n    const event = createDevtoolsEvent(input)\n    this.#events.push(event)\n\n    if (this.#events.length > this.#maxEvents) {\n      this.#events.splice(0, this.#events.length - this.#maxEvents)\n    }\n\n    for (const listener of this.#listeners) {\n      listener(event)\n    }\n\n    return event\n  }\n\n  getEvents(): readonly DevtoolsEvent[] {\n    return this.#events\n  }\n\n  subscribe(listener: TimelineListener): () => void {\n    this.#listeners.add(listener)\n    return () => {\n      this.#listeners.delete(listener)\n    }\n  }\n\n  setMaxEvents(max: number): void {\n    this.#maxEvents = Math.max(1, max)\n    if (this.#events.length > this.#maxEvents) {\n      this.#events.splice(0, this.#events.length - this.#maxEvents)\n    }\n  }\n\n  clear(): void {\n    this.#events.length = 0\n  }\n}\n","export type DevtoolsNodeType =\n  | 'store'\n  | 'query'\n  | 'mutation'\n  | 'router'\n  | 'persist'\n  | 'url-state'\n  | 'ui-provider'\n  | 'signal'\n  | 'custom'\n\nexport type DevtoolsEventSource =\n  | 'store'\n  | 'query'\n  | 'mutation'\n  | 'router'\n  | 'persist'\n  | 'url-state'\n  | 'ui'\n  | 'custom'\n\nexport type DevtoolsNode = {\n  id: string\n  type: DevtoolsNodeType\n  name?: string\n  getSnapshot?: () => unknown\n}\n\nexport type RegisterDevtoolsNodeInput = {\n  id?: string\n  type: DevtoolsNodeType\n  name?: string\n  getSnapshot?: () => unknown\n}\n\nexport type RegisteredNode = {\n  unregister(): void\n}\n\nexport type DevtoolsSnapshot = {\n  id: string\n  type: DevtoolsNodeType\n  name?: string\n  state: unknown\n  timestamp: number\n}\n\nexport type DevtoolsEvent = {\n  id: string\n  timestamp: number\n  source: DevtoolsEventSource\n  type: string\n  nodeId?: string\n  payload?: unknown\n}\n\nexport type EmitDevtoolsEventInput = {\n  id?: string\n  timestamp?: number\n  source: DevtoolsEventSource\n  type: string\n  nodeId?: string\n  payload?: unknown\n}\n\nexport type TimelineListener = (event: DevtoolsEvent) => void\n\nexport type DevtoolsRegistryAPI = {\n  register(input: RegisterDevtoolsNodeInput): RegisteredNode\n  unregister(nodeId: string): boolean\n  get(nodeId: string): DevtoolsNode | undefined\n  getSnapshot(nodeId: string): DevtoolsSnapshot | undefined\n  getAllSnapshots(): DevtoolsSnapshot[]\n  list(): DevtoolsNode[]\n}\n\nexport type DevtoolsTimelineAPI = {\n  emit(input: EmitDevtoolsEventInput): DevtoolsEvent | null\n  getEvents(): readonly DevtoolsEvent[]\n  subscribe(listener: TimelineListener): () => void\n  setMaxEvents(max: number): void\n  clear(): void\n}\n\nexport type EchoJSDevtoolsBridge = {\n  registry: DevtoolsRegistryAPI\n  timeline: DevtoolsTimelineAPI\n}\n\nexport const DEVTOOLS_GLOBAL_HOOK_KEY = '__ECHOJS_DEVTOOLS__' as const\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __ECHOJS_DEVTOOLS__: EchoJSDevtoolsBridge | undefined\n}\n","import type { EchoJSDevtoolsBridge } from '../types'\nimport { DEVTOOLS_GLOBAL_HOOK_KEY } from '../types'\n\ntype GlobalHookHost = typeof globalThis & {\n  [DEVTOOLS_GLOBAL_HOOK_KEY]?: EchoJSDevtoolsBridge\n}\n\nexport const readGlobalDevtoolsHook = (): EchoJSDevtoolsBridge | undefined =>\n  (globalThis as GlobalHookHost)[DEVTOOLS_GLOBAL_HOOK_KEY]\n\nexport const writeGlobalDevtoolsHook = (bridge: EchoJSDevtoolsBridge): void => {\n  const host = globalThis as GlobalHookHost\n  if (host[DEVTOOLS_GLOBAL_HOOK_KEY]) return\n  host[DEVTOOLS_GLOBAL_HOOK_KEY] = bridge\n}\n\nexport const clearGlobalDevtoolsHook = (): void => {\n  delete (globalThis as GlobalHookHost)[DEVTOOLS_GLOBAL_HOOK_KEY]\n}\n","import { DevtoolsRegistry } from '../registry/registry'\nimport { DevtoolsTimeline } from '../timeline/timeline'\nimport {\n  clearGlobalDevtoolsHook,\n  readGlobalDevtoolsHook,\n  writeGlobalDevtoolsHook,\n} from './global-hook'\nimport type { EchoJSDevtoolsBridge } from '../types'\n\nlet devtoolsEnabled = true\n\nconst noopRegisteredNode = { unregister: () => {} }\n\nexport const setDevtoolsEnabled = (enabled: boolean): void => {\n  devtoolsEnabled = enabled\n}\n\nexport const isDevtoolsEnabled = (): boolean => devtoolsEnabled\n\nexport const createDevtoolsBridge = (): EchoJSDevtoolsBridge => ({\n  registry: new DevtoolsRegistry(),\n  timeline: new DevtoolsTimeline(),\n})\n\nexport const getOrCreateDevtoolsBridge = (): EchoJSDevtoolsBridge => {\n  const existing = readGlobalDevtoolsHook()\n  if (existing) return existing\n\n  const bridge = createDevtoolsBridge()\n  writeGlobalDevtoolsHook(bridge)\n  return bridge\n}\n\nexport const getDevtoolsBridge = (): EchoJSDevtoolsBridge | null => {\n  if (!devtoolsEnabled) return null\n  return readGlobalDevtoolsHook() ?? getOrCreateDevtoolsBridge()\n}\n\nexport const whenDevtoolsEnabled = <T>(run: (bridge: EchoJSDevtoolsBridge) => T): T | null => {\n  if (!devtoolsEnabled) return null\n  return run(getOrCreateDevtoolsBridge())\n}\n\nexport const disabledRegisteredNode = (): typeof noopRegisteredNode => noopRegisteredNode\n\n/** @internal Resets bridge state — tests only */\nexport const __resetDevtoolsCoreForTests = (): void => {\n  devtoolsEnabled = true\n  clearGlobalDevtoolsHook()\n}\n","export {\n  setDevtoolsEnabled,\n  isDevtoolsEnabled,\n  getDevtoolsBridge,\n  getOrCreateDevtoolsBridge,\n  createDevtoolsBridge,\n  __resetDevtoolsCoreForTests,\n} from './bridge/bridge'\n\nexport { DEVTOOLS_GLOBAL_HOOK_KEY } from './types'\n\nexport type {\n  DevtoolsNodeType,\n  DevtoolsEventSource,\n  DevtoolsNode,\n  RegisterDevtoolsNodeInput,\n  RegisteredNode,\n  DevtoolsSnapshot,\n  DevtoolsEvent,\n  EmitDevtoolsEventInput,\n  TimelineListener,\n  DevtoolsRegistryAPI,\n  DevtoolsTimelineAPI,\n  EchoJSDevtoolsBridge,\n} from './types'\n\nexport { createDevtoolsId, resetDevtoolsIds } from './utils/id'\nexport { safeSerialize } from './utils/serialize'\n\nexport { DevtoolsRegistry } from './registry/registry'\nexport { DevtoolsTimeline } from './timeline/timeline'\n\nimport {\n  disabledRegisteredNode,\n  getDevtoolsBridge,\n  isDevtoolsEnabled,\n  whenDevtoolsEnabled,\n} from './bridge/bridge'\nimport type {\n  DevtoolsSnapshot,\n  DevtoolsEvent,\n  EmitDevtoolsEventInput,\n  RegisterDevtoolsNodeInput,\n  RegisteredNode,\n  TimelineListener,\n} from './types'\n\nexport const registerDevtoolsNode = (input: RegisterDevtoolsNodeInput): RegisteredNode => {\n  if (!isDevtoolsEnabled()) return disabledRegisteredNode()\n  return whenDevtoolsEnabled((bridge) => bridge.registry.register(input))!\n}\n\nexport const unregisterDevtoolsNode = (nodeId: string): boolean => {\n  if (!isDevtoolsEnabled()) return false\n  return whenDevtoolsEnabled((bridge) => bridge.registry.unregister(nodeId)) ?? false\n}\n\nexport const emitDevtoolsEvent = (input: EmitDevtoolsEventInput): DevtoolsEvent | null => {\n  if (!isDevtoolsEnabled()) return null\n  return whenDevtoolsEnabled((bridge) => bridge.timeline.emit(input))\n}\n\nexport const getNodeSnapshot = (nodeId: string): DevtoolsSnapshot | undefined => {\n  if (!isDevtoolsEnabled()) return undefined\n  return whenDevtoolsEnabled((bridge) => bridge.registry.getSnapshot(nodeId)) ?? undefined\n}\n\nexport const getAllSnapshots = (): DevtoolsSnapshot[] => {\n  if (!isDevtoolsEnabled()) return []\n  return whenDevtoolsEnabled((bridge) => bridge.registry.getAllSnapshots()) ?? []\n}\n\nexport const getTimelineEvents = (): readonly DevtoolsEvent[] => {\n  if (!isDevtoolsEnabled()) return []\n  return whenDevtoolsEnabled((bridge) => bridge.timeline.getEvents()) ?? []\n}\n\nexport const subscribeTimeline = (listener: TimelineListener): (() => void) => {\n  if (!isDevtoolsEnabled()) return () => {}\n  return whenDevtoolsEnabled((bridge) => bridge.timeline.subscribe(listener)) ?? (() => {})\n}\n"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@echojs-ecosystem/devtools",
+  "version": "0.1.0",
+  "description": "Runtime registry and timeline infrastructure for EchoJS DevTools",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@echojs-ecosystem/oxc-config": "workspace:*",
+    "typescript": "5.9.2",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/echojs-ecosystem/echojs-core.git",
+    "directory": "packages/devtools"
+  }
+}