sygnal 5.3.7 → 5.4.0

package/dist/vite/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","sources":["../../src/vite/plugin.ts"],"sourcesContent":["/**\n * Sygnal Vite Plugin\n *\n * Auto-configures JSX, wires up HMR with state preservation and, in dev,\n * turns on Sygnal's diagnostics (runtime checks and the static checker).\n * Nothing it adds in dev reaches a production build.\n *\n * Usage:\n *   import sygnal from 'sygnal/vite'\n *   export default defineConfig({ plugins: [sygnal()] })\n *\n * What it does:\n *   1. Configures the automatic JSX transform with sygnal as the import source:\n *      `oxc` (Vite 8), plus `esbuild` under Vite 7 and older\n *   2. Detects files that call `run()` from sygnal and auto-injects HMR wiring\n *   3. Dev mode (`vite` / `vite dev` only; never `vite build`). Into every\n *      file that imports `run` from sygnal (including entries with manual HMR\n *      wiring or `disableHmr`) it inserts, on an existing line:\n *\n *        if (globalThis.__SYGNAL_DEV__ === undefined) globalThis.__SYGNAL_DEV__ = true;\n *        import 'sygnal/diagnostics';import 'virtual:sygnal/dev';\n *\n *      The flag turns on runtime diagnostics in 'warn' mode; 'sygnal/diagnostics'\n *      registers the runtime checks (SYG101-106, 201, 202, 301, 401, ...);\n *      'virtual:sygnal/dev' logs static-check results in the browser console\n *      (see 5). With `diagnostics: { strict: true }` the snippet also sets\n *      `globalThis.__SYGNAL_STRICT__ = true` (same guard), which turns on the\n *      strict (SYG5xx) runtime checks of 'sygnal/diagnostics'. The snippet goes\n *      after any shebang line and directive prologue ('use strict',\n *      'use client'); line numbers are unchanged and the transform returns a\n *      sourcemap. Opt out per app with `run(App, drivers, { diagnostics: 'off' })`\n *      or for the whole dev server with `sygnal({ diagnostics: 'off' })`.\n *   4. `diagnostics` option. The runtime core only understands\n *      `__SYGNAL_DEV__ === true` ('warn'), so another mode or an ignore list\n *      is passed as run()'s own `diagnostics` option: imports of 'sygnal'\n *      from the entry files above resolve to a dev-only wrapper module\n *      ('\\0sygnal-dev:runtime') that re-exports sygnal with a run() that adds\n *      `diagnostics: { mode, ignore }` unless the call sets `diagnostics`\n *      itself. With the default ('warn', no ignore list) there is no wrapper.\n *   5. `check` option: runs sygnal-check (an optional dependency, loaded\n *      lazily from the project; `strict` defaults to `diagnostics.strict`)\n *      over `include` (default: the existing ones of src/, pages/ and\n *      renderer/, else the project root, with a notice) when the dev\n *      server starts and again after every source file change. Results go to\n *      the terminal in sygnal-check's format, and to the browser as a\n *      'sygnal:check' HMR event that the dev client ('virtual:sygnal/dev')\n *      logs with console.warn (non-disruptive). The dev client asks for the\n *      current findings when the page loads ('sygnal:check:request'), and only\n *      that client is answered; after a source change the new findings go to\n *      every connected client, and only when they changed. Error-severity\n *      findings also open Vite's error overlay (`overlay: false`: never).\n *      sygnal-check's codes are currently all warnings or info, so in practice\n *      everything goes to the console. Warnings never use the overlay: while\n *      one is open Vite's client reloads the page on the next HMR update\n *      (`overlay: 'warn'` is treated as 'error', with a notice). The dev\n *      client closes a sygnal-check overlay before each update, and the\n *      server sends it again after the re-check, so it never causes a reload\n *      and doesn't go stale. A missing sygnal-check is skipped silently; a\n *      checker that throws only logs a warning.\n *   6. Vitest (process.env.VITEST): appends the package's 'sygnal/diagnostics'\n *      ESM file to `test.setupFiles` (merged with a string or array value;\n *      not added twice), so renderComponent tests get the runtime checks.\n *      Its directory is added to the resolved `server.fs.allow` (G-050):\n *      in jsdom / happy-dom environments Vitest loads setup files through\n *      Vite's /@fs/ URLs, which a linked sygnal outside the workspace would\n *      otherwise fail. Opt out with `vitestSetup: false`. Under Vitest the transform adds\n *      nothing (no flags, HMR wiring, run() wrapper, dev client or checker):\n *      a __SYGNAL_DEV__ / __SYGNAL_STRICT__ flag set by one test file would\n *      leak into later test files of the same worker, and renderComponent()\n *      manages the diagnostics modes itself.\n *   7. Vike and Astro (G-014): the app is started by sygnal's own client\n *      entry, which user code doesn't import. Client-side imports of\n *      'sygnal/vike/onRenderClient' resolve to a dev wrapper that sets the\n *      flag and loads the checks first. Astro resolves its renderer entry on\n *      the server and the browser loads the file itself, so the same snippet\n *      is added to sygnal's 'astro/client' file by the transform. That file\n *      imports the public 'sygnal' entry (one shared core, B-019), so its\n *      'sygnal' import gets the run() wrapper too: every `diagnostics` mode\n *      and ignore list works for islands. The sygnal/astro integration adds\n *      this plugin in `astro dev`.\n *\n * Why not Vite's `define`? Vite's dependency optimizer does not apply user\n * `define` replacements to pre-bundled dependencies (only process.env.NODE_ENV),\n * so a `define` would never reach sygnal's own code when sygnal is pre-bundled.\n * Vite's client does copy `define` entries onto globalThis at runtime, but only\n * when `/@vite/client` is loaded (not under SSR or Vitest, where it would also\n * switch diagnostics on for every test run). Injecting the flag into the\n * entry file that calls run() is deterministic and scoped to the dev app; it\n * runs before run() is called, which is when the diagnostics mode is resolved.\n *\n * The HMR transform finds the pattern:\n *   import { run } from 'sygnal'\n *   import App from './App.jsx'\n *   run(App)\n *\n * And appends:\n *   if (import.meta.hot) {\n *     import.meta.hot.accept('./App.jsx', __sygnal.hmr)\n *     import.meta.hot.dispose(__sygnal.dispose)\n *   }\n *\n * HMR wiring is only added for a recognized top-level (column 0) run()\n * statement whose result reference is actually defined (see RUN_CALL_RE). It\n * is skipped — the dev flag is still injected — for any other shape (e.g.\n * `app = run(App)`, nested or indented calls), for test files (*.test.*,\n * *.spec.*) and under Vitest (process.env.VITEST).\n */\n// Node built-ins (the plugin runs in Node). The package has no @types/node.\n// @ts-ignore\nimport fs from 'node:fs'\n// @ts-ignore\nimport path from 'node:path'\n// @ts-ignore\nimport { createRequire } from 'node:module'\n// @ts-ignore\nimport { pathToFileURL } from 'node:url'\n\nconst nodeProcess: any = (globalThis as any).process\n\nexport type DiagnosticsMode = 'off' | 'collect' | 'warn' | 'error'\n\nexport interface DiagnosticsPluginOptions {\n  /** Runtime diagnostics mode in dev. @default 'warn' */\n  mode?: DiagnosticsMode\n  /** Strict (canonical-form, SYG5xx) runtime checks: sets globalThis.__SYGNAL_STRICT__. @default false */\n  strict?: boolean\n  /** Diagnostic codes to drop, e.g. ['SYG105'] */\n  ignore?: string[]\n}\n\nexport interface CheckPluginOptions {\n  /** Also run sygnal-check's strict (SYG5xx) rules. @default `diagnostics.strict` */\n  strict?: boolean\n  /**\n   * Files, directories or globs to check, relative to the Vite root.\n   * @default the existing ones of ['src', 'pages', 'renderer'], else the project root\n   */\n  include?: string[]\n  /** Codes to drop. @default the `diagnostics` ignore list */\n  ignore?: string[]\n  /**\n   * Error-severity findings also open Vite's error overlay ('error', the\n   * default); false: never. All findings are logged in the terminal and the\n   * browser console. Warnings never use the overlay (Vite reloads the page on\n   * the next update while one is open): 'warn' is accepted but treated as\n   * 'error'. sygnal-check currently reports no error-severity codes.\n   * @default 'error'\n   */\n  overlay?: 'error' | 'warn' | false\n}\n\nexport interface SygnalPluginOptions {\n  /**\n   * Disable automatic JSX configuration.\n   * Set to true if you want to configure JSX yourself.\n   * @default false\n   */\n  disableJsx?: boolean\n\n  /**\n   * Disable automatic HMR wiring.\n   * Set to true if you want to handle HMR manually.\n   * @default false\n   */\n  disableHmr?: boolean\n\n  /**\n   * Runtime diagnostics in dev (`vite`, not `vite build`): a mode, or\n   * { mode, strict, ignore }. 'off' injects nothing. A `diagnostics` option\n   * passed to run() itself still wins.\n   * @default 'warn'\n   */\n  diagnostics?: DiagnosticsMode | DiagnosticsPluginOptions\n\n  /**\n   * Run sygnal-check in dev on startup and on file changes. Skipped silently\n   * when sygnal-check isn't installed.\n   * @default true\n   */\n  check?: boolean | CheckPluginOptions\n\n  /**\n   * Under Vitest, add 'sygnal/diagnostics' to `test.setupFiles` so tests get\n   * the runtime checks.\n   * @default true\n   */\n  vitestSetup?: boolean\n}\n\n// Virtual modules (dev server only)\nconst DEV_CLIENT = 'virtual:sygnal/dev'\nconst DEV_CLIENT_ID = '\\0' + DEV_CLIENT\nconst RUNTIME_ID = '\\0sygnal-dev:runtime'\nconst VIKE_CLIENT = 'sygnal/vike/onRenderClient'\nconst VIKE_CLIENT_ID = '\\0sygnal-dev:vike-client'\nconst CHECK_EVENT = 'sygnal:check'\n// Sent by the dev client when it loads: the server answers that client only\nconst CHECK_REQUEST = 'sygnal:check:request'\nconst OVERLAY_PLUGIN = 'sygnal-check'\n// Register the runtime checks with the core that loaded last (see the Vike wrapper)\nconst REINSTALL_IMPORT = `import { installChecks as __sygnalInstallChecks } from 'sygnal/diagnostics';`\nconst REINSTALL_CALL = 'try { __sygnalInstallChecks() } catch (e) { console.warn(e) }\\n'\n\nexport default function sygnal(options: SygnalPluginOptions = {}) {\n  const { disableJsx = false, disableHmr = false, vitestSetup = true } = options\n  const diagnostics = normalizeDiagnostics(options.diagnostics)\n  const devOn = diagnostics.mode !== 'off'\n  // A mode other than the flag's 'warn', or an ignore list, needs run()'s option\n  const wrapRun = devOn && (diagnostics.mode !== 'warn' || diagnostics.ignore.length > 0)\n  let isServe = false\n  let isVitest = false\n  let root: string = nodeProcess.cwd()\n  // Files whose `import ... from 'sygnal'` resolves to the run() wrapper\n  const runtimeImporters = new Set<string>()\n  // Statements run before the app starts: dev flag (+ strict flag)\n  const flags = DEV_FLAG + (diagnostics.strict ? STRICT_FLAG : '')\n  const devImports = `import 'sygnal/diagnostics';import '${DEV_CLIENT}';`\n  let astroClient: Set<string> | undefined\n\n  return {\n    name: 'vite-plugin-sygnal',\n\n    config(this: any, config: any, env: { command: string }) {\n      isServe = env.command === 'serve'\n      isVitest = !!nodeProcess?.env?.VITEST\n      root = config?.root ? path.resolve(config.root) : nodeProcess.cwd()\n\n      const result: any = {\n        // Ensure sygnal is bundled for SSR rather than externalized.\n        // Without this, Node fails to resolve sygnal's exports from\n        // Vike's server chunks in production builds.\n        ssr: {\n          noExternal: ['sygnal'],\n        },\n      }\n\n      if (!disableJsx) {\n        result.oxc = {\n          jsx: {\n            runtime: 'automatic' as const,\n            importSource: 'sygnal',\n          },\n        }\n        // Vite 7 and older (Astro 6, Vitest on Vite 7) compile JSX with\n        // esbuild and ignore `oxc` (B-027); Vite 8 warns about `esbuild`\n        // from a plugin, so it is only set below Vite 8.\n        if (viteMajor(this, root) < 8) {\n          result.esbuild = { jsx: 'automatic', jsxImportSource: 'sygnal' }\n        }\n        // Vite 8's dependency scanner doesn't use the `oxc` options: without\n        // this it compiles JSX for React, fails to resolve\n        // react/jsx-dev-runtime and skips pre-bundling (a reload on first load).\n        if (isServe && !isVitest) {\n          result.optimizeDeps = { rolldownOptions: { transform: { jsx: { runtime: 'automatic', importSource: 'sygnal' } } } }\n        }\n      }\n\n      if (isVitest) {\n        if (vitestSetup) {\n          const setup = diagnosticsSetupFile(root)\n          const existing = ([] as string[]).concat(config?.test?.setupFiles || [])\n          const loaded = existing.some(f => typeof f === 'string' &&\n            (f === 'sygnal/diagnostics' || (!!setup && path.resolve(root, f) === setup)))\n          // Vite merges arrays (and a string with an array) by concatenation\n          if (setup && !loaded) result.test = { setupFiles: [setup] }\n        }\n      } else if (isServe && devOn && sygnalInNodeModules(root)) {\n        // The dependency scan reads the original sources, which don't import\n        // the checks entry: pre-bundle it with sygnal so the first page load\n        // doesn't trigger a re-optimization. Only for an installed sygnal: a\n        // linked one is served from source, and pre-bundling the checks alone\n        // would give them their own copy of the core.\n        result.optimizeDeps = { ...result.optimizeDeps, include: ['sygnal/diagnostics'] }\n      }\n\n      return result\n    },\n\n    configResolved(config: any) {\n      if (config?.root) root = config.root\n      // G-050: Vitest loads setup files by URL (/@fs/...) in browser-like\n      // environments (jsdom, happy-dom), and Vite refuses files outside\n      // server.fs.allow, which is the project's workspace by default. A linked\n      // (or hoisted) sygnal lives outside it, so allow its setup file's\n      // directory. The resolved list already holds Vite's defaults.\n      if (isVitest) {\n        const setup = diagnosticsSetupFile(root)\n        const allow = config?.server?.fs?.allow\n        if (setup && Array.isArray(allow)) {\n          const dir = path.dirname(setup)\n          const inside = (base: string) => {\n            const rel = path.relative(path.resolve(base), dir)\n            return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel))\n          }\n          if (!allow.some(inside)) allow.push(dir)\n        }\n      }\n    },\n\n    resolveId: {\n      order: 'pre' as const,\n      async handler(this: any, source: string, importer: string | undefined, opts: any) {\n        if (!isServe || isVitest) return null\n        if (source === DEV_CLIENT) return DEV_CLIENT_ID\n        if (source === 'sygnal' && importer && wrapRun && runtimeImporters.has(cleanId(importer))) {\n          return RUNTIME_ID\n        }\n        if (source === VIKE_CLIENT && devOn && !opts?.ssr) {\n          if (importer !== VIKE_CLIENT_ID) return VIKE_CLIENT_ID\n          // The wrapper's own import of the real entry: resolve it normally.\n          // The real Vike client's run() then gets the run() wrapper too, when\n          // it is served unbundled (a pre-bundled copy stays in 'warn' mode).\n          const real = await this.resolve(source, importer, { ...opts, skipSelf: true })\n          if (real && wrapRun) runtimeImporters.add(cleanId(real.id))\n          return real\n        }\n        return null\n      },\n    },\n\n    load(id: string) {\n      if (id === DEV_CLIENT_ID) return devClientModule()\n      if (id === RUNTIME_ID) return runtimeModule(diagnostics)\n      // The checks register again once the real entry has loaded: a\n      // pre-bundled copy of it can carry its own copy of the Sygnal core\n      // (e.g. with a linked sygnal), which then holds the diagnostics bridge.\n      if (id === VIKE_CLIENT_ID) {\n        return `${devImports}${REINSTALL_IMPORT}\\nexport * from '${VIKE_CLIENT}';\\n${flags}\\n${REINSTALL_CALL}`\n      }\n      return null\n    },\n\n    configureServer(server: any) {\n      if (isVitest || options.check === false) return\n      const checkOptions = typeof options.check === 'object' && options.check ? options.check : {}\n      // Deferred: the dev server doesn't wait for the first check\n      const checkDefaults = { strict: diagnostics.strict, ignore: diagnostics.ignore }\n      setTimeout(() => {\n        startChecker(server, root, checkOptions, checkDefaults, options.check !== undefined)\n          .catch(err => server?.config?.logger?.warn?.(`[sygnal] sygnal-check could not start: ${err?.message || err}`))\n      }, 0)\n    },\n\n    transform(code: string, id: string, opts?: { ssr?: boolean }) {\n      if (!isServe) return null\n\n      // sygnal/astro/client (Astro islands): flags + checks first. It imports\n      // the public 'sygnal' entry (the app's core, B-019), which resolves to\n      // the run() wrapper when the diagnostics option needs it.\n      if (devOn && !isVitest && !opts?.ssr) {\n        astroClient = astroClient || astroClientFiles(root)\n        if (astroClient.has(cleanId(id))) {\n          if (wrapRun) runtimeImporters.add(cleanId(id))\n          return withSourcemap(code, [[0, flags + devImports]], '', id)\n        }\n      }\n\n      // Only transform JS/TS/JSX/TSX files\n      if (!/\\.[jt]sx?$/.test(id)) return null\n      // Skip node_modules\n      if (id.includes('node_modules')) return null\n      // Must import run from sygnal\n      if (!code.includes('sygnal')) return null\n\n      // Match against the code with comments blanked out (same offsets), so\n      // e.g. `// run(App)` or a commented-out import is never matched.\n      const noComments = blankOut(code, false)\n\n      // Find: import { run, ... } from 'sygnal'\n      const runImportRe = /import\\s+\\{[^}]*\\brun\\b[^}]*\\}\\s+from\\s+['\"]sygnal['\"]/\n      if (!runImportRe.test(noComments)) return null\n\n      // Dev snippet: injected into every file that imports run() — also when\n      // HMR wiring below is skipped. Inserted after any shebang line and\n      // directive prologue, without adding a line. Nothing under Vitest: a\n      // global flag set by one test file would leak dev/strict mode into the\n      // later test files of the same worker; there the checks come from\n      // test.setupFiles and renderComponent() manages the modes.\n      const inserts: Array<[number, string]> = []\n      if (devOn && !isVitest) {\n        inserts.push(flagInsertion(code, flags + devImports))\n        if (wrapRun) runtimeImporters.add(cleanId(id))\n      }\n      const done = (tail = '') => (inserts.length || tail ? withSourcemap(code, inserts, tail, id) : null)\n\n      // Skip HMR wiring if disabled, in tests, or already manually wired\n      if (disableHmr || isVitest || /\\.(test|spec)\\.[jt]sx?$/.test(id)) return done()\n      if (noComments.includes('import.meta.hot')) return done()\n\n      // Strings and template literals blanked out too: a statement-level match only\n      const runCall = RUN_CALL_RE.exec(blankOut(code, true))\n      if (!runCall) return done()\n      const [, binding, componentName] = runCall\n\n      // Find the import path for this component\n      // Handles: import App from './App.jsx'\n      //          import App from \"./App\"\n      const componentImportRe = new RegExp(\n        `import\\\\s+${componentName.replace(/\\$/g, '\\\\$')}\\\\s+from\\\\s+['\"]([^'\"]+)['\"]`\n      )\n      const componentImportMatch = noComments.match(componentImportRe)\n      if (!componentImportMatch) return done()\n      const componentPath = componentImportMatch[1]\n\n      // Pattern 3: bare run(App, ...) — no result captured → const __sygnal = run(\n      if (!binding) {\n        inserts.push([runCall.index, 'const __sygnal = '])\n        return done(hmrBlock(componentPath, '__sygnal.hmr', '__sygnal.dispose'))\n      }\n\n      // Pattern 2: const app = run(App, ...)\n      if (binding[0] !== '{') {\n        return done(hmrBlock(componentPath, `${binding}.hmr`, `${binding}.dispose`))\n      }\n\n      // Pattern 1: const { hmr, dispose, ... } = run(App, ...) — only when both\n      // are bound under their own names (a rename would leave them undefined)\n      const names = binding.slice(1, -1).split(',').map(s => s.trim())\n      if (names.includes('hmr') && names.includes('dispose')) {\n        return done(hmrBlock(componentPath, 'hmr', 'dispose'))\n      }\n      return done()\n    },\n  }\n}\n\n/**\n * Major version of the running Vite: from the plugin context (this.meta,\n * Vite 7+), else from the vite package the project resolves. Infinity when\n * unknown (treated as Vite 8+: no `esbuild` option).\n */\nfunction viteMajor(ctx: any, root: string): number {\n  const fromMeta = ctx?.meta?.viteVersion\n  if (typeof fromMeta === 'string') return parseInt(fromMeta, 10)\n  if (ctx?.meta?.rolldownVersion) return 8\n  try {\n    const req = createRequire(path.join(root, 'package.json'))\n    const v = JSON.parse(fs.readFileSync(req.resolve('vite/package.json'), 'utf8')).version\n    const major = parseInt(v, 10)\n    if (major > 0) return major\n  } catch (_) {}\n  return Infinity\n}\n\ninterface NormalizedDiagnostics { mode: DiagnosticsMode, strict: boolean, ignore: string[] }\n\nconst MODES: DiagnosticsMode[] = ['off', 'collect', 'warn', 'error']\n\nfunction normalizeDiagnostics(value: SygnalPluginOptions['diagnostics']): NormalizedDiagnostics {\n  const o: DiagnosticsPluginOptions = typeof value === 'string' ? { mode: value } : value || {}\n  const mode = o.mode === undefined ? 'warn' : o.mode\n  if (!MODES.includes(mode)) {\n    throw new Error(`[vite-plugin-sygnal] diagnostics mode must be one of ${MODES.map(m => `'${m}'`).join(', ')}; got ${JSON.stringify(mode)}`)\n  }\n  return { mode, strict: !!o.strict, ignore: Array.isArray(o.ignore) ? o.ignore.map(String) : [] }\n}\n\n/** Module id without a query or hash. */\nfunction cleanId(id: string): string {\n  return id.replace(/[?#].*$/, '')\n}\n\n/** 'virtual:sygnal/dev': logs sygnal-check results in the browser console. */\nfunction devClientModule(): string {\n  // Vite's client reloads the page on the first HMR update while an error\n  // overlay is open. A sygnal-check overlay is closed before each update (the\n  // server sends it again after the re-check), so it never causes a reload.\n  return `if (import.meta.hot) {\n  let shown = 0;\n  let ours = false;\n  const closeOurs = () => {\n    if (!ours || typeof document === 'undefined') return;\n    document.querySelectorAll('vite-error-overlay').forEach((n) => n.close ? n.close() : n.remove());\n    ours = false;\n  };\n  import.meta.hot.on('vite:error', (payload) => {\n    ours = !!(payload && payload.err && payload.err.plugin === '${OVERLAY_PLUGIN}');\n  });\n  import.meta.hot.on('vite:beforeUpdate', closeOurs);\n  import.meta.hot.on('${CHECK_EVENT}', (payload) => {\n    const list = (payload && payload.diagnostics) || [];\n    if (!list.some((d) => d.severity === 'error')) closeOurs();\n    if (!list.length) {\n      if (shown) console.info('[sygnal-check] all findings resolved');\n      shown = 0;\n      return;\n    }\n    shown = list.length;\n    for (const d of list) console[d.severity === 'error' ? 'error' : 'warn']('[sygnal-check] ' + d.text);\n    console.info('[sygnal-check] ' + payload.summary);\n  });\n  import.meta.hot.send('${CHECK_REQUEST}');\n}\n`\n}\n\n/** '\\0sygnal-dev:runtime': sygnal with a run() that adds the plugin's diagnostics option. */\nfunction runtimeModule(d: NormalizedDiagnostics): string {\n  const option = JSON.stringify({ mode: d.mode, ignore: d.ignore })\n  return `import { run as __run } from 'sygnal';\nexport * from 'sygnal';\nexport function run(app, drivers, options) {\n  if (options && options.diagnostics !== undefined) return __run(app, drivers, options);\n  return __run(app, drivers, Object.assign({}, options, { diagnostics: ${option} }));\n}\n`\n}\n\n/** Directory of the 'sygnal' package the project resolves, or undefined. */\nfunction sygnalPackageDir(root: string): string | undefined {\n  try {\n    const req = createRequire(path.join(root, 'package.json'))\n    let dir = path.dirname(req.resolve('sygnal'))\n    while (dir !== path.dirname(dir)) {\n      const pkgFile = path.join(dir, 'package.json')\n      if (fs.existsSync(pkgFile) && JSON.parse(fs.readFileSync(pkgFile, 'utf8')).name === 'sygnal') return dir\n      dir = path.dirname(dir)\n    }\n  } catch (_) {}\n  return undefined\n}\n\n/** Real paths of sygnal's 'astro/client' ESM file. */\nfunction astroClientFiles(root: string): Set<string> {\n  const files = new Set<string>()\n  const dir = sygnalPackageDir(root)\n  if (!dir) return files\n  try {\n    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'))\n    const entry = pkg.exports?.['./astro/client']\n    const rel = typeof entry === 'string' ? entry : entry?.import\n    if (typeof rel !== 'string') return files\n    const file = path.resolve(dir, rel)\n    files.add(file.split(path.sep).join('/'))\n    files.add(fs.realpathSync(file).split(path.sep).join('/'))\n  } catch (_) {}\n  return files\n}\n\nfunction sygnalInNodeModules(root: string): boolean {\n  const dir = sygnalPackageDir(root)\n  if (!dir) return false\n  try {\n    return fs.realpathSync(dir).split(path.sep).includes('node_modules')\n  } catch (_) {\n    return false\n  }\n}\n\n/**\n * Absolute path of the ESM build of 'sygnal/diagnostics' (its \"import\"\n * condition), so the checks share the core instance the tests import.\n */\nfunction diagnosticsSetupFile(root: string): string | undefined {\n  const dir = sygnalPackageDir(root)\n  if (!dir) return undefined\n  try {\n    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'))\n    const entry = pkg.exports?.['./diagnostics']\n    const rel = typeof entry === 'string' ? entry : entry?.import?.default || entry?.import || entry?.default\n    if (typeof rel !== 'string') return undefined\n    const file = path.resolve(dir, rel)\n    return fs.existsSync(file) ? file : undefined\n  } catch (_) {\n    return undefined\n  }\n}\n\n/** Load sygnal-check from the project (optional dependency); undefined when it is missing. */\nasync function loadSygnalCheck(root: string): Promise<any> {\n  try {\n    const file = createRequire(path.join(root, 'package.json')).resolve('sygnal-check')\n    return await import(/* @vite-ignore */ pathToFileURL(file).href)\n  } catch (_) {}\n  try {\n    const name = 'sygnal-check'\n    return await import(/* @vite-ignore */ name)\n  } catch (_) {\n    return undefined\n  }\n}\n\nconst SOURCE_RE = /\\.[cm]?[jt]sx?$/\n\n/** sygnal-check's one-line format: `file:line:col CODE [severity] Component: message (fix)` */\nfunction formatLine(d: any): string {\n  const where = d.file ? `${d.file}:${d.line}:${d.column}` : '<sygnal-check>'\n  const sev = d.severity === 'warn' ? '' : ` [${d.severity}]`\n  return `${where} ${d.code}${sev} ${d.component ? d.component + ': ' : ''}${d.message}${d.fix ? ` (${d.fix})` : ''}`\n}\n\n// Source directories checked by default, those that exist (Vike apps use\n// pages/ and renderer/, often without src/)\nconst DEFAULT_INCLUDE = ['src', 'pages', 'renderer']\n\n/**\n * What sygnal-check checks: `include` when given, else the existing default\n * directories, else the project root (sygnal-check skips node_modules, dist\n * and other build output). Logs one notice when the default finds no\n * directory, or when none of the given paths exists, so an empty check is\n * never a silent all-clear.\n */\nfunction checkInclude(root: string, include: string[] | undefined, notice: (m: string) => void): string[] {\n  const exists = (p: string) => /[*?[{]/.test(p) || fs.existsSync(path.resolve(root, p))\n  if (include && include.length) {\n    if (!include.some(exists)) notice(`[sygnal] sygnal-check: none of check.include (${include.join(', ')}) exists under ${root}, so nothing is checked`)\n    return include\n  }\n  const dirs = DEFAULT_INCLUDE.filter(exists)\n  if (dirs.length) return dirs\n  notice(`[sygnal] sygnal-check: no ${DEFAULT_INCLUDE.join('/, ')}/ directory under ${root}; checking the project root (set check.include to choose)`)\n  return ['.']\n}\n\n/** Run sygnal-check now and after source changes; report to the terminal and the browser. */\nasync function startChecker(server: any, root: string, opts: CheckPluginOptions,\n  defaults: { strict: boolean, ignore: string[] }, explicit: boolean) {\n  const mod = await loadSygnalCheck(root)\n  const logger = server?.config?.logger || console\n  if (!mod || typeof mod.check !== 'function') {\n    if (explicit) logger.info('[sygnal] sygnal-check is not installed, so static checks are off (npm i -D sygnal-check)')\n    return\n  }\n  const include = checkInclude(root, opts.include, (m: string) => logger.info(m))\n  const ignore = opts.ignore || defaults.ignore\n  const strict = opts.strict === undefined ? defaults.strict : !!opts.strict\n  // Only error-severity findings open Vite's overlay: while an overlay is open\n  // Vite's client reloads the page on the first HMR update, so warnings stay\n  // in the terminal and the browser console. overlay: 'warn' is treated as\n  // 'error' (with a one-time notice).\n  if (opts.overlay === 'warn') {\n    logger.info(\"[sygnal] check.overlay: 'warn' is treated as 'error': warnings go to the browser console, not Vite's error overlay (an open overlay makes Vite reload the page on the next update)\")\n  }\n  const overlay = opts.overlay !== false\n  let lastKey: string | undefined\n  let payload: any = null\n  let overlayErr: any = null\n\n  const event = () => ({ type: 'custom', event: CHECK_EVENT, data: payload })\n  const errorMessage = () => ({ type: 'error', err: overlayErr })\n  // Every connected client (after a source change). An error with no client\n  // connected would be buffered by Vite and shown on the next page load.\n  const broadcast = (findingsChanged: boolean) => {\n    const ws = server.ws\n    if (!ws || typeof ws.send !== 'function') return\n    try {\n      if (findingsChanged && payload) ws.send(event())\n      if (overlayErr && !(ws.clients && ws.clients.size === 0)) ws.send(errorMessage())\n    } catch (_) {}\n  }\n\n  const run = (initial = false) => {\n    let diags: any[]\n    try {\n      diags = mod.check(include, { cwd: root, strict, ignore })\n    } catch (err: any) {\n      logger.warn(`[sygnal] sygnal-check failed: ${err?.message || err}`, { timestamp: true })\n      return\n    }\n    const shown = diags.filter(d => d.severity !== 'info')\n    const lines = shown.map(formatLine)\n    const key = lines.join('\\n')\n    const changed = key !== lastKey\n    if (changed) {\n      lastKey = key\n      const text: string = typeof mod.formatDiagnostics === 'function'\n        ? mod.formatDiagnostics(diags)\n        : lines.concat(`sygnal-check: ${shown.length} finding(s)`).join('\\n')\n      const summary = text.split('\\n').pop() || ''\n      if (shown.length) logger.warn(text, { timestamp: true })\n      else logger.info(summary, { timestamp: true })\n      payload = {\n        summary,\n        diagnostics: shown.map((d, i) => ({ code: d.code, severity: d.severity, file: d.file, line: d.line, column: d.column, text: lines[i] })),\n      }\n      const forOverlay = overlay ? shown.filter(d => d.severity === 'error') : []\n      const first = forOverlay[0]\n      overlayErr = first ? {\n        plugin: OVERLAY_PLUGIN,\n        message: forOverlay.map(formatLine).join('\\n'),\n        stack: '',\n        id: path.resolve(root, first.file || ''),\n        loc: { file: path.resolve(root, first.file || ''), line: first.line, column: first.column },\n      } : null\n    }\n    // The first check runs before any page is open; pages ask for the\n    // findings when they load (CHECK_REQUEST). After a change the overlay is\n    // sent again even when the findings are the same: the HMR update closed it.\n    if (!initial) broadcast(changed)\n  }\n\n  run(true)\n  // A page that loads (or reloads) asks for the current findings: answer\n  // that client only, never every client.\n  try {\n    server.ws?.on?.(CHECK_REQUEST, (_data: any, client: any) => {\n      try {\n        if (payload) client?.send?.(event())\n        if (overlayErr) client?.send?.(errorMessage())\n      } catch (_) {}\n    })\n  } catch (_) {}\n\n  let timer: any\n  const onChange = (file: string) => {\n    if (!SOURCE_RE.test(file) || file.split(/[\\\\/]/).includes('node_modules')) return\n    clearTimeout(timer)\n    timer = setTimeout(run, 100)\n  }\n  const watcher = server?.watcher\n  if (watcher && typeof watcher.on === 'function') {\n    watcher.on('change', onChange)\n    watcher.on('add', onChange)\n    watcher.on('unlink', onChange)\n  }\n  try { server.httpServer?.once?.('close', () => clearTimeout(timer)) } catch (_) {}\n}\n\nconst DEV_FLAG = 'if (globalThis.__SYGNAL_DEV__ === undefined) globalThis.__SYGNAL_DEV__ = true;'\nconst STRICT_FLAG = 'if (globalThis.__SYGNAL_STRICT__ === undefined) globalThis.__SYGNAL_STRICT__ = true;'\n\n// A top-level (column 0) run(Component, ...) statement: bare, or declaring a\n// new binding. Assignments to existing variables, nested calls and indented\n// calls (e.g. inside a function or test callback) do not match (B-007). It is\n// matched against the code with comments and strings blanked out.\nconst RUN_CALL_RE = /^(?:(?:const|let|var)\\s+(\\{[^}]*\\}|[\\w$]+)\\s*=\\s*)?run\\s*\\(\\s*([A-Z][\\w$]*)/m\n\n// Comments, string literals and template literals (a regex literal containing\n// a quote or `//` can over-blank; that only ever skips HMR wiring).\nconst COMMENT_OR_STRING_RE = /\\/\\/[^\\n]*|\\/\\*[\\s\\S]*?(?:\\*\\/|$)|(['\"])(?:\\\\.|(?!\\1)[^\\\\\\n])*\\1?|`(?:\\\\[\\s\\S]|[^\\\\`])*`?/g\n\n/** Replace comments (and, with `strings`, string/template literals) by spaces, keeping offsets and newlines. */\nfunction blankOut(code: string, strings: boolean): string {\n  return code.replace(COMMENT_OR_STRING_RE, m =>\n    !strings && m[0] !== '/' ? m : m.replace(/[^\\n]/g, ' ')\n  )\n}\n\n// One directive ('use strict', \"use client\", ...) with any leading whitespace\n// and comments. It must end with `;` (group 2) or at the end of its line.\nconst DIRECTIVE_RE = /(?:\\s|\\/\\/[^\\n]*|\\/\\*[\\s\\S]*?\\*\\/)*(['\"])(?:\\\\.|(?!\\1)[^\\\\\\n])*\\1(?:[ \\t]*(;)|(?=[ \\t]*(?:\\/\\/[^\\n]*|\\/\\*[^\\n]*?\\*\\/)?[ \\t]*(?:\\r?\\n|$)))/y\n\n/** Insert `text` (the dev snippet) after a shebang line and the directive prologue. */\nfunction flagInsertion(code: string, text: string): [number, string] {\n  let at = code.startsWith('#!') ? (code.indexOf('\\n') + 1 || code.length) : 0\n  let semicolon = true\n  DIRECTIVE_RE.lastIndex = at\n  let m\n  while ((m = DIRECTIVE_RE.exec(code))) {\n    at = DIRECTIVE_RE.lastIndex\n    semicolon = !!m[2]\n  }\n  return [at, (semicolon ? '' : ';') + text]\n}\n\nconst B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'\n\nfunction vlq(n: number): string {\n  let v = n < 0 ? (-n << 1) | 1 : n << 1\n  let out = ''\n  do {\n    let digit = v & 31\n    v >>>= 5\n    if (v) digit |= 32\n    out += B64[digit]\n  } while (v)\n  return out\n}\n\n/**\n * Apply single-line insertions (at offsets in the original code) plus an\n * appended tail, and build a v3 sourcemap without extra dependencies. No line\n * is added before the tail, so every original line maps to itself; on a line\n * with an insertion, the text after it maps back to its original column.\n */\nfunction withSourcemap(code: string, inserts: Array<[number, string]>, tail: string, id: string) {\n  inserts.sort((a, b) => a[0] - b[0])\n  let out = ''\n  let last = 0\n  for (const [at, text] of inserts) {\n    out += code.slice(last, at) + text\n    last = at\n  }\n  out += code.slice(last) + tail\n\n  let offset = 0\n  let k = 0\n  let prevLine = 0\n  let prevCol = 0\n  const mappings = code.split('\\n').map((line, i) => {\n    const segments: Array<[number, number]> = [[0, 0]]  // [generated column, original column]\n    let shift = 0\n    while (k < inserts.length && inserts[k][0] <= offset + line.length) {\n      const col = inserts[k][0] - offset\n      shift += inserts[k][1].length\n      segments.push([col + shift, col])\n      k++\n    }\n    offset += line.length + 1\n    let genCol = 0\n    return segments.map(([gen, col]) => {\n      const seg = vlq(gen - genCol) + 'A' + vlq(i - prevLine) + vlq(col - prevCol)\n      genCol = gen\n      prevLine = i\n      prevCol = col\n      return seg\n    }).join(',')\n  }).join(';')\n\n  return {\n    code: out,\n    map: { version: 3, sources: [id], sourcesContent: [code], names: [] as string[], mappings },\n  }\n}\n\nfunction hmrBlock(componentPath: string, hmrRef: string, disposeRef: string): string {\n  return `\nif (import.meta.hot) {\n  import.meta.hot.accept('${componentPath}', ${hmrRef})\n  import.meta.hot.dispose(${disposeRef})\n}\n`\n}\n"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,250 @@
+# Sygnal
+
+> Reactive component framework (Cycle.js Model-View-Intent, JSX views, xstream streams). `npm i sygnal`; Vite: `import sygnal from 'sygnal/vite'`, `plugins: [sygnal()]`; entry: `run(App)`. This file shows only the canonical forms. Other forms still work, but strict mode (`sygnal-check --strict`, runtime `strict: true`) flags them as SYG5xx.
+
+## 1. Mental model
+- A component is a pure view function plus static properties: `.intent` (WHEN: sources → named action streams), `.model` (WHAT: action → one reducer per sink), `.initialState`.
+- There is one state tree. A child sees its parent's whole state, or a slice with `state="key"`. A Collection item sees one array element.
+- Every side effect is a sink of a model entry (STATE, EVENTS, PARENT, EFFECT, custom drivers). JSX never has event handlers (`onClick`).
+- Streams are xstream, not RxJS. An intent's DOM selectors only see the component's own JSX, never a child component's.
+
+## 2. Component anatomy
+```jsx
+import { ABORT } from 'sygnal'
+
+function Counter({ state, context, label }) {  // 1st arg: parent props + state, context, children, slots
+  return (
+    <div className="counter">
+      <span>{label} {state.count} (x2 = {state.double})</span>
+      <button className="inc">+</button>
+      <button className="reset">reset</button>
+    </div>
+  )
+}
+Counter.initialState = { count: 0 }                    // root only: a child gets state from its parent (SYG405)
+Counter.calculated = { double: state => state.count * 2 } // or [['count'], fn]; read as state.double
+Counter.context = { total: state => state.count }        // all descendants: ({ context }) => context.total
+Counter.intent = ({ DOM }) => ({                          // sources: DOM STATE EVENTS CHILD props$ commands$ dispose$ + drivers
+  INC:   DOM.click('.inc'),
+  RESET: DOM.click('.reset'),
+})
+Counter.model = {
+  INC:   (state, data, next, props) => ({ ...state, count: state.count + 1 }),
+  RESET: (state) => (state.count === 0 ? ABORT : { ...state, count: 0 }),
+}
+Counter.onError = (error, { componentName }) => <div className="error">{componentName} failed</div>
+export default Counter
+```
+- Reducer `(state, data, next, props)`. `data` is the action stream's value. `next('ACTION', data?, delayMs = 10)` dispatches another action. `props` holds the parent's props plus `state`, `context`, `children`, `slots`.
+- Model entry: a function is the STATE reducer. An object `{ STATE, EVENTS, PARENT, EFFECT, LOG, <DRIVER>: fn }` maps each sink to a `(state, data, next, props)` function whose return value goes to that sink. `<SINK>: true` forwards `data` as-is.
+- Built-in actions (model only): `BOOTSTRAP` (once, just after mount), `INITIALIZE` (automatic: sets initialState), `HYDRATE` (SSR data), `DISPOSE` (unmount).
+
+## 3. Canonical examples
+### State update, ABORT, set / toggle, controlled input
+```jsx
+import { ABORT, set, toggle } from 'sygnal'
+
+function AddTodo({ state }) {
+  return (
+    <div>
+      <input className="draft" value={state.draft} />
+      <button className="add">Add</button>
+      <button className="help">?</button>
+      {state.showHelp && <p className="hint">Type, then Add</p>}
+    </div>
+  )
+}
+AddTodo.initialState = { draft: '', todos: [], nextId: 1, showHelp: false }
+AddTodo.intent = ({ DOM }) => ({
+  DRAFT: DOM.input('.draft').value(),   // a bound value={...} needs an input listener (SYG111)
+  ADD:   DOM.click('.add'),
+  HELP:  DOM.click('.help'),
+})
+AddTodo.model = {
+  DRAFT: set((state, draft) => ({ draft })),           // merges: ({ ...state, draft })
+  ADD: (state) => {
+    const text = state.draft.trim()
+    if (!text) return ABORT                              // "no change" is ABORT, never `return state`
+    return { ...state, draft: '', nextId: state.nextId + 1, todos: [...state.todos, { id: state.nextId, text }] }
+  },
+  HELP: toggle('showHelp'),
+}
+```
+### Multi-sink entry + EVENTS between non-adjacent components
+```jsx
+import { event } from 'sygnal'
+
+function SaveButton({ state }) {
+  return <button className="save">{state.saving ? 'Saving' : 'Save'}</button>
+}
+SaveButton.intent = ({ DOM }) => ({ SAVE: DOM.click('.save') })
+SaveButton.model = {
+  SAVE: {
+    STATE:  (state) => ({ ...state, saving: true }),
+    EVENTS: event('DOC_SAVED', (state) => ({ id: state.id })),  // or event('RESET'), event('MODE', 'dark')
+  },
+}
+
+function Toast({ state }) {   // anywhere in the tree: EVENTS is a global bus
+  return <p className="toast">{state.lastSaved}</p>
+}
+Toast.intent = ({ EVENTS }) => ({ SAVED: EVENTS.select('DOC_SAVED') })  // emits the payload only
+Toast.model = { SAVED: (state, payload) => ({ ...state, lastSaved: payload.id }) }
+```
+### Child → parent (PARENT + CHILD.select), Collection, item removal
+```jsx
+import { Collection } from 'sygnal'
+
+function TaskItem({ state }) {
+  return (
+    <li className="task" data={{ id: state.id }}>
+      {state.title} <button className="pick">pick</button> <button className="remove">x</button>
+    </li>
+  )
+}
+TaskItem.intent = ({ DOM }) => ({ PICK: DOM.click('.pick'), REMOVE: DOM.click('.remove') })
+TaskItem.model = {
+  PICK:   { PARENT: (state) => ({ taskId: state.id }) },   // the parent receives exactly this value
+  REMOVE: () => undefined,                                   // a Collection item removes itself
+}
+
+function TaskList({ state }) {
+  return (
+    <div>
+      <p className="picked">{state.picked}</p>
+      <Collection of={TaskItem} from="tasks" className="tasks" />
+    </div>
+  )
+}
+TaskList.initialState = { picked: null, tasks: [{ id: 1, title: 'Write' }, { id: 2, title: 'Test' }] }
+TaskList.intent = ({ CHILD }) => ({ PICKED: CHILD.select(TaskItem) })  // the function, not a string
+TaskList.model = { PICKED: (state, { taskId }) => ({ ...state, picked: taskId }) }
+```
+- `from` names an array field; items are keyed by `.id`. Also `filter={t => !t.done}`, `sort="title"`. An item edits its own element (`{ ...state, done: true }`).
+- Switchable: `<Switchable of={{ home: Home, settings: Settings }} current={state.route} />` (optional `state="slice"`).
+### Commands (parent → child) + EFFECT
+```jsx
+import { createCommand } from 'sygnal'
+
+const player = createCommand()
+
+function Player({ state }) {
+  return <div className="player">{state.playing ? 'playing' : 'paused'}</div>
+}
+Player.intent = ({ commands$ }) => ({ PLAY: commands$.select('play') })  // emits send()'s data
+Player.model = { PLAY: (state) => ({ ...state, playing: true }) }
+
+function Controls({ state }) {
+  return <div><button className="play">Play</button><Player commands={player} state="player" /></div>
+}
+Controls.initialState = { player: { playing: false } }
+Controls.intent = ({ DOM }) => ({ PLAY: DOM.click('.play') })
+Controls.model = { PLAY: { EFFECT: () => player.send('play') } }  // EFFECT: side effect only, returns nothing
+```
+### Drivers (driverFromAsync + errors()), document-level events
+```jsx
+import { xs } from 'sygnal'
+
+function Quote({ state }) {
+  return <div><button className="load">Load</button><p className="text">{state.error || state.text}</p></div>
+}
+Quote.initialState = { id: 1, text: '', error: null }
+Quote.intent = ({ DOM, QUOTE }) => ({
+  LOAD:   xs.merge(DOM.click('.load'), DOM.select('document').events('keydown').key().filter(k => k === 'r')),
+  LOADED: QUOTE.select('quote'),   // { category: 'quote', value }
+  FAILED: QUOTE.errors('quote'),   // { error, category, request }; unheard errors are only console.error'd
+})
+Quote.model = {
+  LOAD:   { QUOTE: (state) => ({ category: 'quote', value: state.id }) },
+  LOADED: (state, { value }) => ({ ...state, text: value.text, error: null }),
+  FAILED: (state, { error }) => ({ ...state, error: String(error) }),
+}
+```
+```js
+// main.js. A request { category, value } calls fn(value); the reply is { category, value: result }
+import { run, driverFromAsync } from 'sygnal'
+import Quote from './Quote.jsx'
+run(Quote, { QUOTE: driverFromAsync(id => fetch(`/api/quotes/${id}`).then(r => r.json())) })
+```
+A driver is any function `sink$ => source`. Page-wide events: `DOM.select('document' | 'body').events(type)`, CSS-filtered with `DOM.select('document').select('.overlay').events('click')`.
+
+## 4. API facts
+- **Child props**: `<Rating name="food" value={state.food} />` → `function Rating({ state, name, value })`; reducers read `props.name` (4th arg); intent gets the `props$` stream. Reserved: `state` (lens: `"key"` or `{ get, set }`), `children`, `slots`, `context`, `peers` (SYG106). Without `state=` a child shares its parent's whole state.
+- **CHILD.select(Comp)** emits exactly what the child's `PARENT` function returned, for every instance (Collection items too). Put an id in the payload.
+- **run(App, drivers = {}, { mountPoint = '#root', diagnostics })** returns `{ sources, sinks, dispose, hmr }`. DOM, EVENTS, LOG and STATE are built in. `app.sources.STATE.stream` is the state stream; `app.dispose()` fires DISPOSE.
+- **ABORT**: from a STATE reducer, the state is unchanged; from any other sink, nothing is sent.
+- **Focus**: `blur`/`focus` don't bubble, but `DOM.blur('.field')` and `DOM.focus('.field')` work (listener on the element). For any field inside a container use the bubbling `DOM.focusout('.form')` / `DOM.focusin`.
+- **Shorthands**: `DOM.<event>('.sel')` = `DOM.select('.sel').events('<event>')` for every event name.
+- **Enriched streams** (chainable, optional mapper): `.value(fn?)` e.target.value; `.checked(fn?)` boolean; `.key(fn?)` e.key; `.target(fn?)`; `.data('id', Number)` reads `data-id` on the target or its nearest ancestor that has it (JSX: `data={{ id: 7 }}`). camelCase names map to kebab-case attributes: `.data('taskId')` reads `data-task-id` (`data={{ taskId }}`).
+- **xstream**: `xs.merge/combine/of/periodic/never/fromPromise`; methods `map mapTo filter startWith fold take drop last endWhen flatten compose remember replaceError debug`. From `'sygnal'`, used with `.compose(...)`: `debounce(ms) throttle(ms) delay(ms) dropRepeats() sampleCombine(other$)`.
+
+| RxJS | xstream | RxJS | xstream |
+|---|---|---|---|
+| `pipe(a, b)` | chain `.a().b()`, `.compose(op)` | `switchMap(f)` | `.map(f).flatten()` |
+| `debounceTime(ms)` | `.compose(debounce(ms))` | `throttleTime(ms)` | `.compose(throttle(ms))` |
+| `distinctUntilChanged()` | `.compose(dropRepeats())` | `withLatestFrom(b$)` | `.compose(sampleCombine(b$))` |
+| `combineLatest(a$, b$)` | `xs.combine(a$, b$)` | `merge(a$, b$)` | `xs.merge(a$, b$)` |
+| `scan(f, seed)` | `.fold(f, seed)` | `skip(n)` / `first()` | `.drop(n)` / `.take(1)` |
+| `takeUntil(b$)` | `.endWhen(b$)` | `tap(f)` | `.debug(f)` |
+| `catchError(f)` | `.replaceError(f)` | `shareReplay(1)` | `.remember()` |
+| `mergeMap(f)` | `.map(f).compose(flattenConcurrently)` | `concatMap(f)` | `.map(f).compose(flattenSequentially)` |
+(Last row: `import { flattenConcurrently, flattenSequentially, concat } from 'sygnal'`.)
+
+## 5. Wiring rules (silent failures, and what catches them)
+- **Selectors are scoped to the component's own JSX.** A parent's `DOM.click('.remove')` never fires for `.remove` rendered by a child or a Collection item. Handle the event in the child and send it up with `PARENT` (read with `CHILD.select(Child)`) or `EVENTS`. Caught as SYG104; a selector the view never renders is SYG110.
+- **Every intent action needs a model entry (SYG101), and every model entry needs a trigger (SYG102)**: an intent action, a built-in, or `next('X')`.
+- **EVENTS types must match exactly** between `event('X')` and `EVENTS.select('X')` (SYG105).
+- **Collection `from` must name an array field of the state** (SYG401).
+- **A controlled input needs an input listener**: `value={state.x}` plus `DOM.input('.x').value()`, otherwise a re-render resets the text (SYG111).
+- Also: reducers return the complete new state (`{ ...state, ... }`); never mutate; no side effects in views or STATE reducers (use EFFECT or a driver).
+
+## 6. Diagnostics
+- Format: `[Sygnal SYG104] Lane: <what is wrong>. <how to fix> https://sygnal.js.org/reference/errors#syg104`. Severities error/warn/info. 1xx wiring, 2xx model/state, 3xx streams (SYG301: RxJS operator on an xstream stream), 4xx components (Collection, Switchable, context), 5xx strict, 6xx drivers and setup, 9xx internal.
+- `npx --no-install sygnal-check` runs the locally installed checker, never a download (a `create-sygnal-app` project already has the `sygnal-check` dev dependency; elsewhere `npm i -D sygnal-check`; still not installed? skip it and rely on the runtime diagnostics in the tests). It checks `src` statically; pass other paths instead, e.g. `npx --no-install sygnal-check pages --strict` (Vike). Use `--strict` for canonical forms, `--fix` to apply the mechanical rewrites (implies `--strict`), and `--json` / `--verbose` for output. `npx --no-install sygnal-check explain SYG104` explains a code and its fix. Suppress one line with `// sygnal-ignore SYG110`.
+- App graph: `npx --no-install sygnal-check --graph --json` (static), `t.inspect()` (test), `getDevTools().inspect()` (running dev app). All return the same `InspectGraph`: components, actions and their triggers, selectors (`matched`, `isolationHit`), EVENTS emitters/selectors, diagnostics.
+- Vite plugin in dev (`vite`, never `vite build`): runtime checks print warnings to the console; when `sygnal-check` is installed, the plugin also runs it on start and on every save (terminal + browser console). Stricter: `sygnal({ diagnostics: { mode: 'error', strict: true }, check: { strict: true } })`.
+- Without the plugin: `run(App, drivers, { diagnostics: 'warn' })` (`'collect'` → `getDiagnostics()`; `'error'` throws) and `import 'sygnal/diagnostics'` for the full checks. Runtime strict: `configureStrict(true)` from `'sygnal/diagnostics'`, or `renderComponent(C, { strict: true })`. `run()` has no strict option.
+- MCP: `claude mcp add sygnal-check -- npx --no-install sygnal-check mcp` (tools `check`, `graph`, `explain`).
+
+## 7. Testing your change
+```js
+import { it, expect, afterEach } from 'vitest'
+import { renderComponent } from 'sygnal'
+import TaskList from './TaskList.jsx'
+
+let t
+afterEach(() => t?.dispose())
+
+it('picks, then removes a task', async () => {
+  t = renderComponent(TaskList, { strict: true })   // also: initialState, drivers, mockConfig, diagnostics
+  t.simulateEvent('.pick', 'click')                 // first match; bubbles; reaches child components too
+  await t.next(s => s.picked === 1)                 // a state emitted after this call
+  t.simulateEvent('.task[data-id="2"] .remove', 'click')
+  await t.next(s => s.tasks.length === 1)
+  await t.settle()                                  // nothing pending anywhere in the tree
+  expect(t.html()).not.toContain('Test')
+  t.expectNoDiagnostics()                           // throws on any warn/error diagnostic
+})
+```
+- `simulateEvent(sel, type, init?)`: init `{ value }`, `{ checked }`, `{ key: 'Enter' }`, `{ data: { id: 2 } }`; `'document'` targets `DOM.select('document')` listeners. Calls made before the component is ready are buffered (`await t.ready()` is optional). `sel` matches the rendered tree like the real DOM: tag, `.class`, `#id`, `[attr="v"]`, `:first-child`, `:last-child`, `:nth-child(n)`, `:nth-of-type(n)`, `:not()`, descendant and `>` (e.g. `.list:nth-child(2) .card:first-child .next`). If it matches nothing (after waiting up to 300ms for a render), the test fails with an error naming the selector (check `t.html()`, or select by attribute: `[data-id="3"]`); `{ allowMissing: true }` drops the event instead. `:has()`, `+`, `~` throw "unsupported selector syntax".
+- `t.next(pred)` matches only future states. `t.waitForState(pred)` also matches states already recorded (e.g. the initial one), so use it only for a state that can't already exist. Both resolve after the whole tree has rendered. `t.states`, `t.emitted` (EVENTS sent) and `t.sinkValues('PARENT')` are live arrays.
+- `t.simulateAction('LOADED', data)` pushes an action straight into intent → model (all sinks run). Use it for actions without a DOM trigger; for drivers prefer `drivers: { QUOTE: driverFromAsync(async () => ({ text: 'hi' })) }`.
+- With the Vite plugin, Vitest gets `sygnal/diagnostics` in its setupFiles automatically; otherwise `import 'sygnal/diagnostics'` in the test.
+- Full app in jsdom (`npm i -D jsdom`):
+```js
+// @vitest-environment jsdom
+import { it, expect } from 'vitest'
+import { run } from 'sygnal'
+import Counter from './Counter.jsx'
+
+it('counts in the real DOM', async () => {
+  document.body.innerHTML = '<div id="root"></div>'
+  const app = run(Counter, {}, { mountPoint: '#root' })
+  const tick = () => new Promise(r => setTimeout(r, 30))
+  await tick()
+  document.querySelector('.inc').click()
+  await tick()
+  expect(document.querySelector('.counter span').textContent).toContain('1')
+  app.dispose()
+})
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sygnal",
-  "version": "5.3.7",
+  "version": "5.4.0",
   "description": "An intuitive framework for building fast and small components or applications based on Cycle.js",
   "main": "./dist/index.cjs.js",
   "types": "./dist/index.d.ts",
@@ -26,6 +26,11 @@
       "import": "./dist/jsx-dev-runtime.esm.js",
       "require": "./dist/jsx-dev-runtime.cjs.js"
     },
+    "./diagnostics": {
+      "types": "./src/extra/diagnostics/checks/public.d.ts",
+      "import": "./dist/diagnostics.esm.js",
+      "require": "./dist/diagnostics.cjs.js"
+    },
     "./vite": {
       "types": "./src/vite/plugin.d.ts",
       "import": "./dist/vite/plugin.mjs",
@@ -80,18 +85,21 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "llms.txt"
   ],
   "scripts": {
-    "test": "vitest run && npm run test:types && npm run test:browser",
+    "test": "vitest run && npm run test:examples && npm run test:types && npm run test:browser",
+    "test:examples": "node scripts/test-examples.mjs",
     "test:types": "npx tsc --project type-tests/tsconfig.json 2>&1 | grep '^type-tests/' && exit 1 || exit 0",
     "test:browser": "npm test --prefix browser-tests",
     "test:watch": "vitest",
-    "build": "npx rollup -c && cp src/index.d.ts dist/index.d.ts",
+    "build": "npx rollup -c && npx rollup -c rollup.config.dts.mjs",
     "build:types": "npx rollup -c rollup.config.dts.mjs",
-    "build:all": "npm run build && npm run build:types",
+    "build:all": "npm run build",
     "build:devtools": "node devtools/build.mjs",
-    "start": "npx rollup -c -w"
+    "start": "npx rollup -c -w",
+    "prepublishOnly": "npm run build:all"
   },
   "repository": {
     "type": "git",
@@ -123,6 +131,7 @@
     "@rollup/plugin-node-resolve": "^15.2.1",
     "@rollup/plugin-terser": "^0.4.3",
     "@rollup/plugin-typescript": "^11.1.6",
+    "jsdom": "^29.1.1",
     "rollup": "^3.28.1",
     "rollup-plugin-dts": "^6.1.1",
     "tslib": "^2.6.2",

package/src/astro/client.ts

@@ -1,4 +1,6 @@
-import run from '../extra/run'
+// The public entry (external in the build), so islands share the app's
+// Sygnal core instead of a bundled copy (B-019).
+import { run } from 'sygnal'
 
 interface SygnalComponent {
   (args: any): any;
@@ -50,7 +52,13 @@ export default (element: any) => {
       previous.dispose()
     }
 
-    const Wrapped: any = (args: any) => Component({ ...args, props: { ...(props || {}) } })
+    // Island props reach the view like any component's props, spread
+    // top-level (`{ state, title }`), the same as on the server
+    // (renderToString). The view args (state, context, ...) win over a prop
+    // with the same name; `props` is kept for older `({ state, props })`
+    // views (B-026).
+    const islandProps = { ...(props || {}) }
+    const Wrapped: any = (args: any) => Component({ ...islandProps, ...args, props: islandProps })
     Wrapped.model = Component.model
     Wrapped.intent = Component.intent
     Wrapped.hmrActions = Component.hmrActions
@@ -65,6 +73,9 @@ export default (element: any) => {
     Wrapped.onError = Component.onError
     Wrapped.debug = Component.debug
     Wrapped.componentName = Component.componentName || Component.name
+    // run() names the root by `name` first: diagnostics and devtools should
+    // say 'Counter', not 'Wrapped'
+    try { Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true }) } catch (_) {}
 
     const app = run(Wrapped, {}, { mountPoint })
     element.__sygnal = app

package/src/astro/index.d.ts

@@ -1,3 +1,5 @@
+import type { DiagnosticsMode, DiagnosticsPluginOptions, CheckPluginOptions } from '../vite/plugin.d'
+
 declare type SygnalAstroIntegration = {
   name: string;
   hooks: {
@@ -8,8 +10,29 @@ declare type SygnalAstroIntegration = {
         serverEntrypoint: string;
       }) => void;
       updateConfig: (config: any) => void;
+      command?: 'dev' | 'build' | 'preview' | 'sync';
+      logger?: { warn: (message: string) => void };
     }) => void;
   };
 };
 
-export default function sygnalAstroIntegration(): SygnalAstroIntegration;
+export interface SygnalAstroOptions {
+  /**
+   * Runtime diagnostics for islands in `astro dev`: a mode ('warn',
+   * 'collect', 'error' or 'off') or { mode, strict, ignore }, the same as
+   * the sygnal/vite `diagnostics` option.
+   * @default 'warn'
+   */
+  diagnostics?: DiagnosticsMode | DiagnosticsPluginOptions;
+  /**
+   * Run sygnal-check in `astro dev` (see the sygnal/vite `check` option).
+   * @default true
+   */
+  check?: boolean | CheckPluginOptions;
+}
+
+/**
+ * Sygnal Astro integration. In `astro dev` it also adds the sygnal Vite
+ * plugin, which turns on runtime diagnostics for islands and runs sygnal-check.
+ */
+export default function sygnalAstroIntegration(options?: SygnalAstroOptions): SygnalAstroIntegration;

package/src/astro/index.ts

@@ -1,3 +1,6 @@
+import sygnalVite from '../vite/plugin'
+import type { DiagnosticsMode, DiagnosticsPluginOptions, CheckPluginOptions } from '../vite/plugin'
+
 const SYGNAL_RENDERER_NAME = '@sygnal/astro'
 
 interface AstroRenderer {
@@ -9,27 +12,55 @@ interface AstroRenderer {
 interface AstroConfigSetupArgs {
   addRenderer: (renderer: AstroRenderer) => void;
   updateConfig: (config: any) => void;
+  command?: 'dev' | 'build' | 'preview' | 'sync';
+  logger?: { warn: (message: string) => void };
+}
+
+export interface SygnalAstroOptions {
+  /**
+   * Runtime diagnostics for islands in `astro dev`: a mode or
+   * { mode, strict, ignore }, the same as the sygnal/vite `diagnostics`
+   * option (the island client shares the app's core, B-019).
+   * @default 'warn'
+   */
+  diagnostics?: DiagnosticsMode | DiagnosticsPluginOptions;
+  /** Run sygnal-check in `astro dev` (see the sygnal/vite `check` option). @default true */
+  check?: boolean | CheckPluginOptions;
 }
 
-export default function sygnalAstroIntegration() {
+export default function sygnalAstroIntegration(options: SygnalAstroOptions = {}) {
   return {
     name: SYGNAL_RENDERER_NAME,
     hooks: {
-      'astro:config:setup': ({ addRenderer, updateConfig }: AstroConfigSetupArgs) => {
+      'astro:config:setup': ({ addRenderer, updateConfig, command }: AstroConfigSetupArgs) => {
         addRenderer({
           name: SYGNAL_RENDERER_NAME,
           clientEntrypoint: 'sygnal/astro/client',
           serverEntrypoint: 'sygnal/astro/server',
         })
 
-        updateConfig({
-          vite: {
-            esbuild: {
-              jsx: 'automatic',
-              jsxImportSource: 'sygnal',
-            },
+        const vite: any = {
+          esbuild: {
+            jsx: 'automatic',
+            jsxImportSource: 'sygnal',
           },
-        })
+        }
+
+        // Dev mode (G-014): islands are started by sygnal/astro/client, which
+        // user code never imports, so the sygnal Vite plugin wraps that entry
+        // in dev to set the dev flag and load the runtime checks first. It
+        // also runs sygnal-check. Nothing is added to `astro build`.
+        if (command === 'dev') {
+          vite.plugins = [sygnalVite({
+            disableJsx: true,
+            disableHmr: true,
+            vitestSetup: false,
+            diagnostics: options.diagnostics,
+            check: options.check,
+          })]
+        }
+
+        updateConfig({ vite })
       },
     },
   }

package/src/astro/server.ts

@@ -22,9 +22,11 @@ export function renderToStaticMarkup(
   _metadata?: any
 ): { html: string; attrs: Record<string, any> } {
   try {
+    // Props are spread top-level by renderToString (`{ state, ...props }`);
+    // `props` is also passed, as on the client, for `({ state, props })` views.
     const html = renderToString(Component, {
       state: props.initialState || Component.initialState,
-      props,
+      props: {...props, props},
     })
     return {html, attrs: {}}
   } catch (err: any) {

package/src/collection.ts

@@ -2,6 +2,7 @@ import isolate from './cycle/isolate/index';
 import {makeCollection} from './cycle/state/index';
 import {h} from './cycle/dom/index';
 import type {Lens} from './cycle/state/types';
+import {fail} from './extra/diagnostics/legacy';
 
 let COLLECTION_COUNT = 0;
 
@@ -20,7 +21,7 @@ export default function collection(
   opts: CollectionOptions = {}
 ): (sources: any) => any {
   if (typeof component !== 'function') {
-    throw new Error('collection: first argument (component) must be a function');
+    fail('SYG411', 'collection', 'first argument (component) must be a function', 'Pass a component function');
   }
   const {
     combineList = ['DOM'],
@@ -37,7 +38,9 @@ export default function collection(
       item: component,
       itemKey: (state: any, ind: number) =>
         typeof state.id !== 'undefined' ? state.id : ind,
-      itemScope: (key: any) => key,
+      // B-009: prefix with the collection instance so two Collections in one parent whose
+      // items share ids get different DOM isolation scopes
+      itemScope: (itemKey: any) => `${key}-${itemKey}`,
       channel: stateSourceName,
       collectSinks: (instances: any) => {
         return Object.entries(sources).reduce<Record<string, any>>(