@fluixi/vite-plugin 1.0.0-alpha.83 → 1.0.0-alpha.85

package/dist/graph-channel.cjs

@@ -1,10 +1,58 @@
-"use strict";var T=Object.create;var f=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var C=Object.getPrototypeOf,G=Object.prototype.hasOwnProperty;var j=(e,t)=>{for(var i in t)f(e,i,{get:t[i],enumerable:!0})},S=(e,t,i,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let l of D(t))!G.call(e,l)&&l!==i&&f(e,l,{get:()=>t[l],enumerable:!(n=P(t,l))||n.enumerable});return e};var A=(e,t,i)=>(i=e!=null?T(C(e)):{},S(t||!e||!e.__esModule?f(i,"default",{value:e,enumerable:!0}):i,e)),J=e=>S(f({},"__esModule",{value:!0}),e);var Y={};j(Y,{withGraphChannel:()=>K});module.exports=J(Y);var w=require("node:module"),N=require("node:path"),$={},v="virtual:fluixi/devtools-agent",I=`\0${v}`,M="/__fluixi/graph",R="fluixi:graph",m="the plugin could not load @fluixi/devtools from its own dependencies",V="no page has reported yet — open the application in a browser",_=100,W=500,q=(e,t,i,n)=>`
-import { installDevtoolsHook, observeGraph } from ${JSON.stringify(e)};
-import ${JSON.stringify(t)};
-import { observeReactiveNodes } from ${JSON.stringify(i)};
-import { VERSION } from ${JSON.stringify(n)};
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// The runtime this module imports is the application's own — same module graph, same nodes.
+// src/graph-channel.ts
+var graph_channel_exports = {};
+__export(graph_channel_exports, {
+  withGraphChannel: () => withGraphChannel
+});
+module.exports = __toCommonJS(graph_channel_exports);
+var import_node_module = require("node:module");
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var import_node_url = require("node:url");
+var import_meta = {};
+var VIRTUAL = "virtual:fluixi/devtools-agent";
+var RESOLVED = `\0${VIRTUAL}`;
+var ENDPOINT = "/__fluixi/graph";
+var EVENT = "fluixi:graph";
+var MISSING = "the plugin could not load @fluixi/devtools from its own dependencies";
+var WAITING = "no page has reported yet — open the application in a browser";
+var INTERVAL = 100;
+var HISTORY = 500;
+var agentSource = (devtools, plugins, signal, reactive) => `
+import { installDevtoolsHook, observeGraph } from ${JSON.stringify(devtools)};
+import ${JSON.stringify(plugins)};
+import { observeReactiveNodes } from ${JSON.stringify(signal)};
+import { VERSION } from ${JSON.stringify(reactive)};
+
+// The runtime this module imports is the application's own, same module graph, same nodes.
 // Nothing waits for the runtime to offer itself; that path is for a tool loaded from outside.
 //
 // \`watch\` is this copy of devtools, handed over with the runtime. A browser extension
@@ -13,7 +61,7 @@ import { VERSION } from ${JSON.stringify(n)};
 const hook = installDevtoolsHook();
 hook.inject({ observeReactiveNodes, version: VERSION, watch: observeGraph });
 
-const send = (kind, snapshot) => import.meta.hot?.send(${JSON.stringify(R)}, { kind, snapshot });
+const send = (kind, snapshot) => import.meta.hot?.send(${JSON.stringify(EVENT)}, { kind, snapshot });
 
 const first = hook.snapshot();
 // Kept and handed back, so a browser panel polling the same hook cannot consume what this
@@ -26,7 +74,120 @@ const timer = setInterval(() => {
   cursor = delta.cursor;
   // Events count on their own: an effect that ran without changing a value moves no node.
   if (delta.nodes.length || delta.removed?.length || delta.events?.length) send('delta', delta);
-}, ${_});
+}, ${INTERVAL});
 
 import.meta.hot?.dispose(() => clearInterval(timer));
-`;function L(){try{return(0,w.createRequire)($.url).resolve("@fluixi/devtools")}catch{return null}}function z(){try{return(0,w.createRequire)($.url).resolve("@fluixi/devtools/plugins")}catch{return null}}function K(e,t,i){let n=null,l=!1,u=m,c=process.cwd(),h,g=new Map,y=0,p=[],O=e.resolveId,H=e.transformIndexHtml;return{...e,resolveId(s,a){return s===v?I:O?.call(this,s,a)??null},async load(s){if(s!==I)return null;let a=(0,N.join)(c,"fluixi-devtools-agent.js"),o=["@fluixi/reactive/signal","@fluixi/reactive"],r=await Promise.all(o.map(b=>this.resolve?.(b,a,{skipSelf:!0}))),d=o.filter((b,E)=>!r[E]?.id),k=L(),x=z();return d.length||!k||!x?(u=d.length?`${d.join(", ")} did not resolve from ${c}`:m,h?.(`[fluixi] reactive graph off — ${u}`),"export {};"):q(`/@fs/${k}`,`/@fs/${x}`,r[0].id,r[1].id)},async configureServer(s){t()&&(c=s.config?.root??c,h=s.config?.logger?.info.bind(s.config.logger),n=await import("@fluixi/devtools/wire").catch(()=>null),l=n!==null,n&&i(),n?u=V:h?.(`[fluixi] reactive graph off — ${m}`),s.middlewares.use(M,(a,o)=>{let r=n?{...n.serializeGraph(g,y||Date.now()),events:p}:{t:Date.now(),nodes:[]},d=JSON.stringify(u?{...r,reason:u}:r);o.setHeader("Content-Type","application/json"),o.setHeader("Access-Control-Allow-Origin","*"),o.setHeader("Cache-Control","no-store"),o.end(d)}),n&&s.ws.on(R,a=>{let o=a;if(!o?.snapshot||!n)return;let r=o.kind==="full";g=n.applySnapshot(r?new Map:g,o.snapshot),r&&(p=[]);let d=o.snapshot.events;d?.length&&(p=[...p,...d].slice(-W)),y=Date.now(),u=null}))},transformIndexHtml:{order:"pre",handler(s,a){let o=U(H,s,a);return!t()||!l||!n?o:{html:typeof o=="string"?o:s,tags:[{tag:"script",injectTo:"head-prepend",attrs:{type:"module",src:`/@id/${v}`}}]}}}}}function U(e,t,i){if(typeof e=="function")return e(t,i);let n=e?.handler;return n?.(t,i)}
+`;
+function ownDevtools() {
+  return resolveForBrowser("@fluixi/devtools");
+}
+function ownPlugins() {
+  return resolveForBrowser("@fluixi/devtools/plugins");
+}
+function resolveForBrowser(spec) {
+  try {
+    const resolved = import_meta.resolve?.(spec);
+    if (resolved) return (0, import_node_url.fileURLToPath)(resolved);
+  } catch {
+  }
+  try {
+    const required = (0, import_node_module.createRequire)(import_meta.url).resolve(spec);
+    if (!required.endsWith(".cjs")) return required;
+    for (const ext of [".mjs", ".js"]) {
+      const sibling = required.slice(0, -".cjs".length) + ext;
+      if ((0, import_node_fs.existsSync)(sibling)) return sibling;
+    }
+    return required;
+  } catch {
+    return null;
+  }
+}
+function withGraphChannel(base, enabled, start) {
+  let wire = null;
+  let available = false;
+  let reason = MISSING;
+  let root = process.cwd();
+  let log;
+  let graph = /* @__PURE__ */ new Map();
+  let stamp = 0;
+  let events = [];
+  const baseResolveId = base.resolveId;
+  const baseTransformIndexHtml = base.transformIndexHtml;
+  return {
+    ...base,
+    resolveId(id, importer) {
+      if (id === VIRTUAL) return RESOLVED;
+      return baseResolveId?.call(this, id, importer) ?? null;
+    },
+    async load(id) {
+      if (id !== RESOLVED) return null;
+      const from = (0, import_node_path.join)(root, "fluixi-devtools-agent.js");
+      const specs = ["@fluixi/reactive/signal", "@fluixi/reactive"];
+      const ids = await Promise.all(specs.map((spec) => this.resolve?.(spec, from, { skipSelf: true })));
+      const missing = specs.filter((_, i) => !ids[i]?.id);
+      const devtools = ownDevtools();
+      const plugins = ownPlugins();
+      if (missing.length || !devtools || !plugins) {
+        reason = missing.length ? `${missing.join(", ")} did not resolve from ${root}` : MISSING;
+        log?.(`[fluixi] reactive graph off — ${reason}`);
+        return "export {};";
+      }
+      return agentSource(`/@fs/${devtools}`, `/@fs/${plugins}`, ids[0].id, ids[1].id);
+    },
+    async configureServer(server) {
+      if (!enabled()) return;
+      root = server.config?.root ?? root;
+      log = server.config?.logger?.info.bind(server.config.logger);
+      wire = await import("@fluixi/devtools/wire").catch(() => null);
+      available = wire !== null;
+      if (wire) start();
+      if (wire) reason = WAITING;
+      else {
+        log?.(`[fluixi] reactive graph off — ${MISSING}`);
+      }
+      server.middlewares.use(ENDPOINT, (_req, res) => {
+        const snapshot = wire ? { ...wire.serializeGraph(graph, stamp || Date.now()), events } : { t: Date.now(), nodes: [] };
+        const body = JSON.stringify(reason ? { ...snapshot, reason } : snapshot);
+        res.setHeader("Content-Type", "application/json");
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Cache-Control", "no-store");
+        res.end(body);
+      });
+      if (!wire) return;
+      server.ws.on(EVENT, (payload) => {
+        const message = payload;
+        if (!message?.snapshot || !wire) return;
+        const full = message.kind === "full";
+        graph = wire.applySnapshot(full ? /* @__PURE__ */ new Map() : graph, message.snapshot);
+        if (full) events = [];
+        const arriving = message.snapshot.events;
+        if (arriving?.length) events = [...events, ...arriving].slice(-HISTORY);
+        stamp = Date.now();
+        reason = null;
+      });
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(html, ctx) {
+        const inherited = callInheritedHtml(baseTransformIndexHtml, html, ctx);
+        if (!enabled() || !available || !wire) return inherited;
+        return {
+          html: typeof inherited === "string" ? inherited : html,
+          tags: [
+            {
+              tag: "script",
+              // First in the head, so the entry cannot create a node before the agent runs.
+              injectTo: "head-prepend",
+              attrs: { type: "module", src: `/@id/${VIRTUAL}` }
+            }
+          ]
+        };
+      }
+    }
+  };
+}
+function callInheritedHtml(hook, html, ctx) {
+  if (typeof hook === "function") return hook(html, ctx);
+  const handler = hook?.handler;
+  return handler?.(html, ctx);
+}

package/dist/graph-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-channel.d.ts","sourceRoot":"","sources":["../src/graph-channel.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA4EnC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,CAyHhG"}
+{"version":3,"file":"graph-channel.d.ts","sourceRoot":"","sources":["../src/graph-channel.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAqGnC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,CAyHhG"}

package/dist/graph-channel.js

@@ -2,7 +2,7 @@
 //
 // A dev-only agent module goes into the page ahead of the entry, so no node is created
 // before something is watching. It pushes the graph over the channel Vite already keeps open
-// for HMR, and the dev server holds the latest state and answers a plain GET — so an editor
+// for HMR, and the dev server holds the latest state and answers a plain GET, so an editor
 // extension, a panel, or curl all read the same thing without speaking HMR.
 //
 //   GET /__fluixi/graph  →  { t, nodes: [...] }
@@ -12,7 +12,9 @@
 // the framework itself is resolved from the project, because watching a second copy of the
 // runtime would watch a graph nobody is using.
 import { createRequire } from 'node:module';
+import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 const VIRTUAL = 'virtual:fluixi/devtools-agent';
 const RESOLVED = `\0${VIRTUAL}`;
 const ENDPOINT = '/__fluixi/graph';
@@ -31,7 +33,7 @@ import ${JSON.stringify(plugins)};
 import { observeReactiveNodes } from ${JSON.stringify(signal)};
 import { VERSION } from ${JSON.stringify(reactive)};
 
-// The runtime this module imports is the application's own — same module graph, same nodes.
+// The runtime this module imports is the application's own, same module graph, same nodes.
 // Nothing waits for the runtime to offer itself; that path is for a tool loaded from outside.
 //
 // \`watch\` is this copy of devtools, handed over with the runtime. A browser extension
@@ -62,20 +64,46 @@ import.meta.hot?.dispose(() => clearInterval(timer));
  *
  * Asking the application to install it as well made the graph depend on a devDependency
  * nobody knew to add, and in a workspace it resolved for one project and not the one beside
- * it — which reads as the feature being broken rather than absent.
+ * it: which reads as the feature being broken rather than absent.
  */
 function ownDevtools() {
+    return resolveForBrowser('@fluixi/devtools');
+}
+/** The built-in plugins, beside the bundle they extend. Collecting happens in the agent. */
+function ownPlugins() {
+    return resolveForBrowser('@fluixi/devtools/plugins');
+}
+/**
+ * A package's ESM entry, by path.
+ *
+ * The agent below is served to a browser as an ES module and imports these by `/@fs/`
+ * path, so the file has to be the one with the named exports. `createRequire().resolve`
+ * answers with the `require` condition instead: the CJS build, and a `.cjs` file
+ * offers nothing to import, which surfaces as "does not provide an export named
+ * 'installDevtoolsHook'". It only started happening when devtools gained a CJS build;
+ * before that there was one file and either resolver found it.
+ */
+function resolveForBrowser(spec) {
+    // Honours the `import` condition, which is the one that matches how this is loaded.
     try {
-        return createRequire(import.meta.url).resolve('@fluixi/devtools');
+        const resolved = import.meta.resolve?.(spec);
+        if (resolved)
+            return fileURLToPath(resolved);
     }
     catch {
-        return null;
+        // Fall through to the require-based resolution below.
     }
-}
-/** The built-in plugins, beside the bundle they extend. Collecting happens in the agent. */
-function ownPlugins() {
     try {
-        return createRequire(import.meta.url).resolve('@fluixi/devtools/plugins');
+        const required = createRequire(import.meta.url).resolve(spec);
+        if (!required.endsWith('.cjs'))
+            return required;
+        // Landed on the CJS build. Prefer its ESM sibling when the package ships one.
+        for (const ext of ['.mjs', '.js']) {
+            const sibling = required.slice(0, -'.cjs'.length) + ext;
+            if (existsSync(sibling))
+                return sibling;
+        }
+        return required;
     }
     catch {
         return null;
@@ -148,7 +176,7 @@ export function withGraphChannel(base, enabled, start) {
                 log?.(`[fluixi] reactive graph off — ${MISSING}`);
             }
             // The endpoint answers either way. A tool asking for the graph of a project that has
-            // not turned it on deserves to be told which of the two it is, and 404 says neither —
+            // not turned it on deserves to be told which of the two it is, and 404 says neither , 
             // it reads the same as a dev server that is not a fluixi project at all.
             server.middlewares.use(ENDPOINT, (_req, res) => {
                 const snapshot = wire

package/dist/graph-channel.mjs

@@ -1,10 +1,23 @@
-import{createRequire as b}from"node:module";import{join as $}from"node:path";var g="virtual:fluixi/devtools-agent",x=`\0${g}`,O="/__fluixi/graph",S="fluixi:graph",h="the plugin could not load @fluixi/devtools from its own dependencies",H="no page has reported yet — open the application in a browser",E=100,T=500,P=(o,l,a,t)=>`
-import { installDevtoolsHook, observeGraph } from ${JSON.stringify(o)};
-import ${JSON.stringify(l)};
-import { observeReactiveNodes } from ${JSON.stringify(a)};
-import { VERSION } from ${JSON.stringify(t)};
+// src/graph-channel.ts
+import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+var VIRTUAL = "virtual:fluixi/devtools-agent";
+var RESOLVED = `\0${VIRTUAL}`;
+var ENDPOINT = "/__fluixi/graph";
+var EVENT = "fluixi:graph";
+var MISSING = "the plugin could not load @fluixi/devtools from its own dependencies";
+var WAITING = "no page has reported yet — open the application in a browser";
+var INTERVAL = 100;
+var HISTORY = 500;
+var agentSource = (devtools, plugins, signal, reactive) => `
+import { installDevtoolsHook, observeGraph } from ${JSON.stringify(devtools)};
+import ${JSON.stringify(plugins)};
+import { observeReactiveNodes } from ${JSON.stringify(signal)};
+import { VERSION } from ${JSON.stringify(reactive)};
 
-// The runtime this module imports is the application's own — same module graph, same nodes.
+// The runtime this module imports is the application's own, same module graph, same nodes.
 // Nothing waits for the runtime to offer itself; that path is for a tool loaded from outside.
 //
 // \`watch\` is this copy of devtools, handed over with the runtime. A browser extension
@@ -13,7 +26,7 @@ import { VERSION } from ${JSON.stringify(t)};
 const hook = installDevtoolsHook();
 hook.inject({ observeReactiveNodes, version: VERSION, watch: observeGraph });
 
-const send = (kind, snapshot) => import.meta.hot?.send(${JSON.stringify(S)}, { kind, snapshot });
+const send = (kind, snapshot) => import.meta.hot?.send(${JSON.stringify(EVENT)}, { kind, snapshot });
 
 const first = hook.snapshot();
 // Kept and handed back, so a browser panel polling the same hook cannot consume what this
@@ -26,7 +39,123 @@ const timer = setInterval(() => {
   cursor = delta.cursor;
   // Events count on their own: an effect that ran without changing a value moves no node.
   if (delta.nodes.length || delta.removed?.length || delta.events?.length) send('delta', delta);
-}, ${E});
+}, ${INTERVAL});
 
 import.meta.hot?.dispose(() => clearInterval(timer));
-`;function D(){try{return b(import.meta.url).resolve("@fluixi/devtools")}catch{return null}}function C(){try{return b(import.meta.url).resolve("@fluixi/devtools/plugins")}catch{return null}}function J(o,l,a){let t=null,m=!1,d=h,u=process.cwd(),p,f=new Map,v=0,c=[],I=o.resolveId,N=o.transformIndexHtml;return{...o,resolveId(n,s){return n===g?x:I?.call(this,n,s)??null},async load(n){if(n!==x)return null;let s=$(u,"fluixi-devtools-agent.js"),e=["@fluixi/reactive/signal","@fluixi/reactive"],i=await Promise.all(e.map(k=>this.resolve?.(k,s,{skipSelf:!0}))),r=e.filter((k,R)=>!i[R]?.id),w=D(),y=C();return r.length||!w||!y?(d=r.length?`${r.join(", ")} did not resolve from ${u}`:h,p?.(`[fluixi] reactive graph off — ${d}`),"export {};"):P(`/@fs/${w}`,`/@fs/${y}`,i[0].id,i[1].id)},async configureServer(n){l()&&(u=n.config?.root??u,p=n.config?.logger?.info.bind(n.config.logger),t=await import("@fluixi/devtools/wire").catch(()=>null),m=t!==null,t&&a(),t?d=H:p?.(`[fluixi] reactive graph off — ${h}`),n.middlewares.use(O,(s,e)=>{let i=t?{...t.serializeGraph(f,v||Date.now()),events:c}:{t:Date.now(),nodes:[]},r=JSON.stringify(d?{...i,reason:d}:i);e.setHeader("Content-Type","application/json"),e.setHeader("Access-Control-Allow-Origin","*"),e.setHeader("Cache-Control","no-store"),e.end(r)}),t&&n.ws.on(S,s=>{let e=s;if(!e?.snapshot||!t)return;let i=e.kind==="full";f=t.applySnapshot(i?new Map:f,e.snapshot),i&&(c=[]);let r=e.snapshot.events;r?.length&&(c=[...c,...r].slice(-T)),v=Date.now(),d=null}))},transformIndexHtml:{order:"pre",handler(n,s){let e=G(N,n,s);return!l()||!m||!t?e:{html:typeof e=="string"?e:n,tags:[{tag:"script",injectTo:"head-prepend",attrs:{type:"module",src:`/@id/${g}`}}]}}}}}function G(o,l,a){if(typeof o=="function")return o(l,a);let t=o?.handler;return t?.(l,a)}export{J as withGraphChannel};
+`;
+function ownDevtools() {
+  return resolveForBrowser("@fluixi/devtools");
+}
+function ownPlugins() {
+  return resolveForBrowser("@fluixi/devtools/plugins");
+}
+function resolveForBrowser(spec) {
+  try {
+    const resolved = import.meta.resolve?.(spec);
+    if (resolved) return fileURLToPath(resolved);
+  } catch {
+  }
+  try {
+    const required = createRequire(import.meta.url).resolve(spec);
+    if (!required.endsWith(".cjs")) return required;
+    for (const ext of [".mjs", ".js"]) {
+      const sibling = required.slice(0, -".cjs".length) + ext;
+      if (existsSync(sibling)) return sibling;
+    }
+    return required;
+  } catch {
+    return null;
+  }
+}
+function withGraphChannel(base, enabled, start) {
+  let wire = null;
+  let available = false;
+  let reason = MISSING;
+  let root = process.cwd();
+  let log;
+  let graph = /* @__PURE__ */ new Map();
+  let stamp = 0;
+  let events = [];
+  const baseResolveId = base.resolveId;
+  const baseTransformIndexHtml = base.transformIndexHtml;
+  return {
+    ...base,
+    resolveId(id, importer) {
+      if (id === VIRTUAL) return RESOLVED;
+      return baseResolveId?.call(this, id, importer) ?? null;
+    },
+    async load(id) {
+      if (id !== RESOLVED) return null;
+      const from = join(root, "fluixi-devtools-agent.js");
+      const specs = ["@fluixi/reactive/signal", "@fluixi/reactive"];
+      const ids = await Promise.all(specs.map((spec) => this.resolve?.(spec, from, { skipSelf: true })));
+      const missing = specs.filter((_, i) => !ids[i]?.id);
+      const devtools = ownDevtools();
+      const plugins = ownPlugins();
+      if (missing.length || !devtools || !plugins) {
+        reason = missing.length ? `${missing.join(", ")} did not resolve from ${root}` : MISSING;
+        log?.(`[fluixi] reactive graph off — ${reason}`);
+        return "export {};";
+      }
+      return agentSource(`/@fs/${devtools}`, `/@fs/${plugins}`, ids[0].id, ids[1].id);
+    },
+    async configureServer(server) {
+      if (!enabled()) return;
+      root = server.config?.root ?? root;
+      log = server.config?.logger?.info.bind(server.config.logger);
+      wire = await import("@fluixi/devtools/wire").catch(() => null);
+      available = wire !== null;
+      if (wire) start();
+      if (wire) reason = WAITING;
+      else {
+        log?.(`[fluixi] reactive graph off — ${MISSING}`);
+      }
+      server.middlewares.use(ENDPOINT, (_req, res) => {
+        const snapshot = wire ? { ...wire.serializeGraph(graph, stamp || Date.now()), events } : { t: Date.now(), nodes: [] };
+        const body = JSON.stringify(reason ? { ...snapshot, reason } : snapshot);
+        res.setHeader("Content-Type", "application/json");
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Cache-Control", "no-store");
+        res.end(body);
+      });
+      if (!wire) return;
+      server.ws.on(EVENT, (payload) => {
+        const message = payload;
+        if (!message?.snapshot || !wire) return;
+        const full = message.kind === "full";
+        graph = wire.applySnapshot(full ? /* @__PURE__ */ new Map() : graph, message.snapshot);
+        if (full) events = [];
+        const arriving = message.snapshot.events;
+        if (arriving?.length) events = [...events, ...arriving].slice(-HISTORY);
+        stamp = Date.now();
+        reason = null;
+      });
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(html, ctx) {
+        const inherited = callInheritedHtml(baseTransformIndexHtml, html, ctx);
+        if (!enabled() || !available || !wire) return inherited;
+        return {
+          html: typeof inherited === "string" ? inherited : html,
+          tags: [
+            {
+              tag: "script",
+              // First in the head, so the entry cannot create a node before the agent runs.
+              injectTo: "head-prepend",
+              attrs: { type: "module", src: `/@id/${VIRTUAL}` }
+            }
+          ]
+        };
+      }
+    }
+  };
+}
+function callInheritedHtml(hook, html, ctx) {
+  if (typeof hook === "function") return hook(html, ctx);
+  const handler = hook?.handler;
+  return handler?.(html, ctx);
+}
+export {
+  withGraphChannel
+};