@fluixi/vite-plugin 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/index.cjs

@@ -1 +1,213 @@
-"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var f=(i,t)=>{for(var p in t)o(i,p,{get:t[p],enumerable:!0})},s=(i,t,p,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of x(t))!m.call(i,e)&&e!==p&&o(i,e,{get:()=>t[e],enumerable:!(n=u(t,e))||n.enumerable});return i};var O=i=>s(o({},"__esModule",{value:!0}),i);var y={};f(y,{createVitePlugin:()=>r.createVitePlugin,default:()=>g,fluixi:()=>l});module.exports=O(y);var r=require("@fluixi/compiler/integrations");function l(i={}){return(0,r.createVitePlugin)(i)}var g=l;
+/*! @fluixi/vite-plugin v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createVitePlugin: () => import_integrations.createVitePlugin,
+  default: () => index_default,
+  fluixi: () => fluixi
+});
+module.exports = __toCommonJS(index_exports);
+var import_integrations = require("@fluixi/compiler/integrations");
+
+// src/graph-channel.ts
+var import_node_module = require("node:module");
+var import_node_path = require("node:path");
+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
+// installs a hook at document_start and so owns it; without this the graph would be built
+// by that extension's build rather than the one shipped alongside this application.
+const hook = installDevtoolsHook();
+hook.inject({ observeReactiveNodes, version: VERSION, watch: observeGraph });
+
+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
+// one has not been told about yet.
+let cursor = first?.cursor;
+send('full', first);
+const timer = setInterval(() => {
+  const delta = hook.snapshot({ partial: true, since: cursor });
+  if (!delta) return;
+  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 ownDevtools() {
+  try {
+    return (0, import_node_module.createRequire)(import_meta.url).resolve("@fluixi/devtools");
+  } catch {
+    return null;
+  }
+}
+function ownPlugins() {
+  try {
+    return (0, import_node_module.createRequire)(import_meta.url).resolve("@fluixi/devtools/plugins");
+  } 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);
+}
+
+// src/index.ts
+function fluixi(options = {}) {
+  const settings = options;
+  let serving = false;
+  const enabled = () => serving && settings.devtools !== false;
+  const base = (0, import_integrations.createVitePlugin)(settings);
+  const inherited = base.configResolved;
+  const start = () => {
+    settings.sourceLocations = true;
+    settings.sourceLocationsExternal = typeof settings.devtools === "object" && settings.devtools.external === true;
+  };
+  return withGraphChannel(
+    {
+      ...base,
+      configResolved(config) {
+        inherited?.(config);
+        serving = config?.command === "serve";
+        settings.sourceRoot = config.root;
+      }
+    },
+    enabled,
+    start
+  );
+}
+var index_default = fluixi;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEvF,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAE9D;AAED,eAAe,MAAM,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGvF,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAqC9D;AAED,eAAe,MAAM,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import { createVitePlugin } from '@fluixi/compiler/integrations';
+import { withGraphChannel } from './graph-channel.js';
 /**
  * Fluixi Vite plugin.
  *
@@ -13,7 +14,31 @@ import { createVitePlugin } from '@fluixi/compiler/integrations';
  * ```
  */
 export function fluixi(options = {}) {
-    return createVitePlugin(options);
+    // The compiler reads this object per transform, so turning source marks on once the
+    // command is known reaches every file — they are worth their size in dev and nothing in a
+    // build, which is why the answer waits for configResolved.
+    const settings = options;
+    let serving = false;
+    const enabled = () => serving && settings.devtools !== false;
+    const base = createVitePlugin(settings);
+    const inherited = base.configResolved;
+    const start = () => {
+        settings.sourceLocations = true;
+        // Marking a dependency is for someone working on the framework, so it is asked for.
+        settings.sourceLocationsExternal =
+            typeof settings.devtools === 'object' && settings.devtools.external === true;
+    };
+    return withGraphChannel({
+        ...base,
+        configResolved(config) {
+            inherited?.(config);
+            // `serve` covers vitest as well as the dev server, and a test run has no page to
+            // watch — the marks would only change what the compiler emits under test. The
+            // channel turns them on from configureServer, which only a real server calls.
+            serving = config?.command === 'serve';
+            settings.sourceRoot = config.root;
+        },
+    }, enabled, start);
 }
 export default fluixi;
 // Backwards-compatible alias (matches the name fluixi has historically used).

package/dist/index.mjs

@@ -1 +1,182 @@
-import{createVitePlugin as t}from"@fluixi/compiler/integrations";function e(i={}){return t(i)}var o=e;export{t as createVitePlugin,o as default,e as fluixi};
+/*! @fluixi/vite-plugin v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
+// src/index.ts
+import { createVitePlugin } from "@fluixi/compiler/integrations";
+
+// src/graph-channel.ts
+import { createRequire } from "node:module";
+import { join } from "node:path";
+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
+// installs a hook at document_start and so owns it; without this the graph would be built
+// by that extension's build rather than the one shipped alongside this application.
+const hook = installDevtoolsHook();
+hook.inject({ observeReactiveNodes, version: VERSION, watch: observeGraph });
+
+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
+// one has not been told about yet.
+let cursor = first?.cursor;
+send('full', first);
+const timer = setInterval(() => {
+  const delta = hook.snapshot({ partial: true, since: cursor });
+  if (!delta) return;
+  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 ownDevtools() {
+  try {
+    return createRequire(import.meta.url).resolve("@fluixi/devtools");
+  } catch {
+    return null;
+  }
+}
+function ownPlugins() {
+  try {
+    return createRequire(import.meta.url).resolve("@fluixi/devtools/plugins");
+  } 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);
+}
+
+// src/index.ts
+function fluixi(options = {}) {
+  const settings = options;
+  let serving = false;
+  const enabled = () => serving && settings.devtools !== false;
+  const base = createVitePlugin(settings);
+  const inherited = base.configResolved;
+  const start = () => {
+    settings.sourceLocations = true;
+    settings.sourceLocationsExternal = typeof settings.devtools === "object" && settings.devtools.external === true;
+  };
+  return withGraphChannel(
+    {
+      ...base,
+      configResolved(config) {
+        inherited?.(config);
+        serving = config?.command === "serve";
+        settings.sourceRoot = config.root;
+      }
+    },
+    enabled,
+    start
+  );
+}
+var index_default = fluixi;
+export {
+  createVitePlugin,
+  index_default as default,
+  fluixi
+};