sygnal 6.6.0 → 7.1.0

package/dist/vite/plugin.mjs

@@ -864,17 +864,25 @@ function graphMiddleware(server, root, engine, ping = 25000) {
         res.end(req.method === 'HEAD' ? undefined : body);
     };
 }
-/** Adds the page's URL under Vite's own when the dev server prints them. */
-function printGraphUrl(server) {
+/** The banner line when the project has no sygnal-check with the graph page (it used to print nothing). */
+const GRAPH_MISSING_LINE = '  ➜  Sygnal graph: needs sygnal-check 0.10.0 or later in this project (npm i -D sygnal-check)';
+/**
+ * Adds the page's URL under Vite's own when the dev server prints them, or, when the project's
+ * sygnal-check is missing or too old for the page (`available` false), a line saying what to install.
+ */
+function printGraphUrl(server, available = true) {
     const print = server?.printUrls;
     if (typeof print !== 'function')
         return;
     server.printUrls = function (...args) {
         const out = print.apply(this, args);
         try {
+            const logger = server.config?.logger || console;
             const local = server.resolvedUrls?.local?.[0];
-            if (local)
-                (server.config?.logger || console).info(`  ➜  Sygnal graph: ${new URL(local).origin}${GRAPH_PATH}`);
+            if (!available)
+                logger.info(GRAPH_MISSING_LINE);
+            else if (local)
+                logger.info(`  ➜  Sygnal graph: ${new URL(local).origin}${GRAPH_PATH}`);
         }
         catch (_) { }
         return out;
@@ -1013,7 +1021,8 @@ function printGraphUrl(server) {
  *      skipped silently when missing; a sygnal-check without the page keeps the checker as in 5)
  *      builds it with createLiveProject on start and after each change: one build gives the page,
  *      the check overlay / console findings of 5, and the component stamps. Its URL is printed
- *      under Vite's ("➜  Sygnal graph: http://localhost:5173/__sygnal/graph"). The modules of the
+ *      under Vite's ("➜  Sygnal graph: http://localhost:5173/__sygnal/graph"; without a sygnal-check
+ *      0.10.0+ in the project, a line saying so instead). The modules of the
  *      scanned files get a tail setting a non-enumerable `__sygnalKey` (the static 'file#name'
  *      key, D521) on each top-level component function, which the runtime inspect() reports as
  *      `key`; with DevTools on, the dev entries also import 'virtual:sygnal/graph'
@@ -1081,7 +1090,7 @@ function sygnal(options = {}) {
     // Files whose `import ... from 'sygnal'` resolves to the run() wrapper
     const runtimeImporters = new Set();
     // Statements run before the app starts: dev flag (+ strict flag)
-    const flags = DEV_FLAG + (diagnostics.strict ? STRICT_FLAG : '');
+    const flags = DEV_FLAG + (diagnostics.strict ? STRICT_FLAG : '') + (diagnostics.timingAudit ? AUDIT_FLAG : '');
     const devImports = `import 'sygnal/diagnostics';import '${DEV_CLIENT}';`;
     // D77: the DevTools bridge, dev only. First, so the diagnostics entry finds it.
     // E-1: the MCP endpoint needs the bridge, so `mcp` turns it on
@@ -1279,8 +1288,7 @@ function sygnal(options = {}) {
             // W-2 (D543): the page and its stream, behind the MCP endpoint's guard; its URL in the banner
             if (graphOn && server?.middlewares) {
                 server.middlewares.use(graphMiddleware(server, root, engine));
-                if (graphAvailable(root))
-                    printGraphUrl(server);
+                printGraphUrl(server, graphAvailable(root));
             }
         },
         transform(code, id, opts) {
@@ -1565,7 +1573,7 @@ function normalizeDiagnostics(value) {
     if (!MODES.includes(mode)) {
         throw new Error(`[vite-plugin-sygnal] diagnostics mode must be one of ${MODES.map(m => `'${m}'`).join(', ')}; got ${JSON.stringify(mode)}`);
     }
-    return { mode, strict: !!o.strict, ignore: Array.isArray(o.ignore) ? o.ignore.map(String) : [] };
+    return { mode, strict: !!o.strict, timingAudit: !!o.timingAudit, ignore: Array.isArray(o.ignore) ? o.ignore.map(String) : [] };
 }
 /** Module id without a query or hash. */
 function cleanId(id) {
@@ -1943,6 +1951,8 @@ function startChecker(server, root, mod, setup, opts, engine) {
 }
 const DEV_FLAG = 'if (globalThis.__SYGNAL_DEV__ === undefined) globalThis.__SYGNAL_DEV__ = true;';
 const STRICT_FLAG = 'if (globalThis.__SYGNAL_STRICT__ === undefined) globalThis.__SYGNAL_STRICT__ = true;';
+// 7.0: the opt-in timing audit (SYG257, 'sygnal/diagnostics' checks/timingAudit.ts)
+const AUDIT_FLAG = 'if (globalThis.__SYGNAL_TIMING_AUDIT__ === undefined) globalThis.__SYGNAL_TIMING_AUDIT__ = true;';
 // A top-level (column 0) run(Component, ...) statement: bare, or declaring a
 // new binding. Assignments to existing variables, nested calls and indented
 // calls (e.g. inside a function or test callback) do not match (B-007). It is