@reactra/vite-plugin 0.1.0-alpha.0

package/dist/graph-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-cache.js","sourceRoot":"","sources":["../src/graph-cache.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,iFAAiF;AACjF,EAAE;AACF,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,6EAA6E;AAC7E,mCAAmC;AACnC,EAAE;AACF,kFAAkF;AAClF,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,gDAAgD;AAChD,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,iEAAiE;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAkBtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAe,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoC,CAAA;IAE1D,MAAM,aAAa,GAAG,CAAC,IAAY,EAA4B,EAAE;QAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,IAAI,UAAoC,CAAA;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACzC,qEAAqE;YACrE,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,CAAA;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;YAClE,oEAAoE;YACpE,UAAU,GAAG,EAAE,CAAA;QACjB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAC5B,OAAO,UAAU,CAAA;IACnB,CAAC,CAAA;IAED,OAAO,EAAE,aAAa,EAAE,CAAA;AAC1B,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import type { Plugin } from "vite";
+import { type EsbuildPlugin } from "./esbuild-prescan.ts";
+/**
+ * Options accepted by the Vite plugin factory. Reserved for Phase 2 —
+ * pagesDir / storesDir / servicesDir / emitSidecars / devtools per
+ * Compiler §7.1 land alongside items #7 and #5c.
+ */
+export interface ReactraVitePluginOptions {
+    /** Reserved — no options recognised in the Phase 1 MVP. */
+    readonly _reserved?: never;
+}
+interface ResolvedConfigLike {
+    readonly root: string;
+}
+interface FSWatcherLike {
+    on(event: "add" | "unlink" | "change", listener: (path: string) => void): unknown;
+}
+interface ViteDevServerLike {
+    readonly watcher: FSWatcherLike;
+}
+interface ViteSourceMap {
+    version: 3;
+    file: string;
+    sources: string[];
+    sourcesContent: string[];
+    names: string[];
+    mappings: string;
+}
+/**
+ * Vite plugin shape used by Reactra. Structurally a subset of Vite's
+ * `Plugin` interface — we don't import Vite types so the plugin source
+ * resolves under Bun without Vite installed (matches the test environment).
+ */
+export interface ReactraVitePlugin {
+    readonly name: string;
+    readonly enforce: "pre";
+    /**
+     * Day 24 / `#15`: contributes
+     * `optimizeDeps.esbuildOptions.plugins` so esbuild's dep-scan pass
+     * can preprocess Reactra DSL files before its parser sees them.
+     * Returns a partial UserConfig — Vite shallow-merges with the
+     * user's `vite.config.ts`.
+     */
+    config(): {
+        optimizeDeps: {
+            esbuildOptions: {
+                plugins: EsbuildPlugin[];
+            };
+        };
+    };
+    configResolved(config: ResolvedConfigLike): void;
+    buildStart(): void;
+    configureServer(server: ViteDevServerLike): void;
+    transform(code: string, id: string): {
+        code: string;
+        map: ViteSourceMap | null;
+    } | null;
+}
+/**
+ * Vite plugin factory.
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite"
+ * import reactra from "@reactra/vite-plugin"
+ * import react from "@vitejs/plugin-react"
+ *
+ * export default defineConfig({
+ *   plugins: [reactra(), react()],
+ * })
+ * ```
+ *
+ * Reactra MUST run before @vitejs/plugin-react. The enforce: "pre" hint
+ * pins us to the head of the pipeline; downstream plugins see standard
+ * React 19 TSX, never the DSL.
+ */
+export declare const reactraVitePlugin: (_options?: ReactraVitePluginOptions) => Plugin;
+export default reactraVitePlugin;
+export { chainsForRoutes, collectServiceInjectionDiagnostics, deriveRoutePath, emitRouteManifest, emitRouterMiddleware, scanMiddleware, scanPages, scanServices, scanStores, type DiscoveredMiddleware, type DiscoveredRoute, type DiscoveredService, type DiscoveredStore, type ServiceInjectionDiagnostic, } from "./walker.ts";
+export { MANIFEST_RELATIVE_PATH, ROUTER_MIDDLEWARE_RELATIVE_PATH, regenerateRouteManifest, type RegenerateResult, } from "./manifest.ts";
+export { RESOURCE_NAMES_RELATIVE_PATH, collectResourceNames, emitResourceNames, regenerateResourceNames, type ResourceNamesResult, } from "./resource-names.ts";
+export { deleteSidecar, isEmptyForIndex, writeSidecar, type DeleteSidecarResult, type WriteSidecarResult, } from "./sidecar-writer.ts";
+export { reactraEsbuildPlugin } from "./esbuild-prescan.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAkBlC,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAmC/E;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAC3B;AAID,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAID,UAAU,aAAa;IACrB,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;CAClF;AACD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC;AAQD,UAAU,aAAa;IACrB,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IACvB;;;;;;OAMG;IACH,MAAM,IAAI;QACR,YAAY,EAAE;YACZ,cAAc,EAAE;gBAGd,OAAO,EAAE,aAAa,EAAE,CAAA;aACzB,CAAA;SACF,CAAA;KACF,CAAA;IACD,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAChD,UAAU,IAAI,IAAI,CAAA;IAClB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChD,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CACtD;AAmDD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAU,wBAA6B,KACtC,MA2OF,CAAA;AAED,eAAe,iBAAiB,CAAA;AAIhC,OAAO,EACL,eAAe,EACf,kCAAkC,EAClC,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,379 @@
+// @reactra/vite-plugin — Vite integration for the Reactra compiler.
+//
+// Owner: reactra-compiler-spec.md §7.1
+//
+// Phase 1 surface — what ships today:
+//   - enforce: "pre" — Reactra's transform runs before @vitejs/plugin-react.
+//   - transform(code, id): calls @reactra/babel-plugin's compile() on any
+//     .tsx / .ts / .jsx / .js file whose source contains a Reactra container
+//     keyword. compile() short-circuits cheaply on non-DSL files via the
+//     containsReactraDsl gate.
+//   - configResolved(config): captures the project root for the walker.
+//   - buildStart: scan src/pages/ and emit routeManifest.generated.ts.
+//     Phase 1 #5b — file-based route discovery (Router §5.1).
+//   - configureServer({ watcher }): re-emit on src/pages/ add/unlink/change.
+//   - Source maps return null (Vite falls back to a 1-to-1 line map).
+//
+// Deferred (still tracked in phase-1.md):
+//   - Typed RouteId / RouteParams / RouteQuery / TypedNavigate exports
+//     in the manifest (item #5c — needs compiler to surface query schemas)
+//   - HMR boundary injection via import.meta.hot.accept(...) (item #11)
+//   - Source maps (item #10)
+//
+// Day 14b (#7 writer): every successful transform also drops a
+// `.reactra.json` sidecar under node_modules/.reactra/sidecars/ per
+// Compiler §6. Cross-file `use storeX` resolution (the consumer side)
+// is a follow-up — this commit only emits.
+import { buildSidecar, compile, containsReactraDsl, } from "@reactra/babel-plugin";
+import { createGraphCache } from "./graph-cache.js";
+import { fingerprintOf, fingerprintsEqual, isPagesFile, } from "./fingerprint.js";
+import { regenerateRouteManifest } from "./manifest.js";
+import { regenerateResourceNames } from "./resource-names.js";
+import { reactraEsbuildPlugin } from "./esbuild-prescan.js";
+import { deleteSidecar, isEmptyForIndex, writeSidecar } from "./sidecar-writer.js";
+/** File-level opt-out for the co-located-store HMR advisory (improvements #5). */
+const COLOCATION_OPT_OUT = "// reactra-allow-colocated-route-store";
+const STORE_KINDS = new Set([
+    "route-store",
+    "session-store",
+    "export-store",
+]);
+/**
+ * improvements #5 — advise when a store is co-located with a component in one
+ * file. The emitted store binding is a non-component export, which makes the
+ * whole module ineligible for React Fast Refresh, so HMR full-reloads. A
+ * co-located `route store` loses its per-route state on every edit (the
+ * painful case); `session`/`export` stores are registry-preserved, so only
+ * in-progress Fast Refresh is disrupted. Advisory only — never fails the
+ * build (same-file stores are legal; Store v4.2 §2.5). Opt out per file with
+ * the {@link COLOCATION_OPT_OUT} comment.
+ */
+const warnIfColocatedStore = (graph, source) => {
+    if (source.includes(COLOCATION_OPT_OUT))
+        return;
+    const stores = graph.containers.filter((c) => STORE_KINDS.has(c.kind));
+    if (stores.length === 0 || !graph.containers.some((c) => c.kind === "component"))
+        return;
+    const names = stores.map((c) => `\`${c.name}\``).join(", ");
+    const note = stores.some((c) => c.kind === "route-store")
+        ? " — per-route store state is lost on every edit"
+        : " (store state is registry-preserved; only in-progress Fast Refresh is disrupted)";
+    console.warn(`[@reactra/vite-plugin] Store(s) ${names} co-located with a component — HMR will full-reload${note}. ` +
+        `Extract to src/stores/ for fast HMR, or add \`${COLOCATION_OPT_OUT}\` to this file to silence. (Store §2.5)`);
+};
+const SUPPORTED_EXT_RE = /\.(?:tsx|ts|jsx|js)(?:\?.*)?$/;
+const stripQuery = (id) => {
+    const q = id.indexOf("?");
+    return q === -1 ? id : id.slice(0, q);
+};
+/**
+ * Relabel a compiled module's source map so DevTools doesn't list the DSL
+ * original under the same name as the served compiled module (devtools-debugging
+ * backlog issue A). The compiled module is served at its real http URL; the map's
+ * `sources[0]` (the DSL leaf the user authored) is moved under a distinct
+ * `reactra://` virtual URL so the two appear as clearly different Sources entries.
+ * `sourcesContent` is untouched — devtools still shows the DSL you wrote — and
+ * `file` keeps the real path, since it names the generated output. Only the first
+ * source (Reactra always emits exactly one) is relabelled.
+ */
+const labelDslSource = (map, sourcePath) => {
+    if (map.sources.length === 0)
+        return map;
+    // Drive letter + backslashes → a clean POSIX-ish path under the virtual host.
+    const rel = sourcePath
+        .replace(/^[A-Za-z]:/, "")
+        .replace(/\\/g, "/")
+        .replace(/^\/+/, "");
+    return { ...map, sources: [`reactra:///${rel}`, ...map.sources.slice(1)] };
+};
+// True when `path` (absolute or project-relative) refers to a file under
+// `<projectRoot>/src/`. Day 20 / `#5c` widened from `src/pages/` only —
+// store-file changes anywhere under `src/` need to regen the manifest
+// so `STORES` picks up adds / removes. Filter still excludes the generated
+// manifest itself to avoid feedback loops (Vite watcher fires `change`
+// on its own write).
+const isInsideSrc = (projectRoot, eventPath) => {
+    const root = projectRoot.replace(/\\/g, "/");
+    const target = eventPath.replace(/\\/g, "/");
+    const prefix = root.endsWith("/") ? root + "src/" : root + "/src/";
+    if (!target.startsWith(prefix))
+        return false;
+    // Skip the generated manifest's own writes (Day-20 added the loop
+    // risk because store-file detection now walks src/, and the manifest
+    // lives under src/).
+    if (target.endsWith("/routeManifest.generated.ts"))
+        return false;
+    // Same skip for the Wave-3 / Stage-2 middleware companion. Without it,
+    // regenerateRouteManifest's own write-out would re-fire this watcher
+    // and loop indefinitely.
+    if (target.endsWith("/router-middleware.generated.ts"))
+        return false;
+    return true;
+};
+/**
+ * Vite plugin factory.
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite"
+ * import reactra from "@reactra/vite-plugin"
+ * import react from "@vitejs/plugin-react"
+ *
+ * export default defineConfig({
+ *   plugins: [reactra(), react()],
+ * })
+ * ```
+ *
+ * Reactra MUST run before @vitejs/plugin-react. The enforce: "pre" hint
+ * pins us to the head of the pipeline; downstream plugins see standard
+ * React 19 TSX, never the DSL.
+ */
+export const reactraVitePlugin = (_options = {}) => {
+    // Captured in configResolved; consumed by buildStart + configureServer.
+    // Starts empty so the type stays narrow; the plugin never reads it
+    // before configResolved fires (Vite guarantees the call order).
+    let projectRoot = "";
+    // A3 increment 2 — the per-file declaration fingerprint map. The ONLY mutable
+    // watcher state (C1 exempts it). Scoped to this plugin instance (not a
+    // module-level global) so two projects building in one process don't share
+    // it. A `change` whose recomputed fingerprint matches the stored one means
+    // no store/service/resource decl was added/renamed/removed → the src/-wide
+    // rescan can be skipped (a non-pages/ change can skip the regen entirely).
+    // Entries are added/refreshed on every full regen and removed on `unlink`.
+    const fingerprints = new Map();
+    /**
+     * Run BOTH regens (manifest + resource-names) over one shared per-event
+     * cache, then refresh the fingerprint for `eventPath` from that same cache
+     * (no extra compile). `eventPath` is absolute; pass `null` for build-time
+     * regens that don't carry a single triggering file.
+     */
+    const regenAll = (eventPath) => {
+        const cache = createGraphCache();
+        try {
+            regenerateRouteManifest(projectRoot, cache);
+        }
+        catch (err) {
+            console.error("[@reactra/vite-plugin] manifest regen failed:", err);
+        }
+        try {
+            regenerateResourceNames(projectRoot, cache);
+        }
+        catch (err) {
+            console.error("[@reactra/vite-plugin] resource-names regen failed:", err);
+        }
+        if (eventPath) {
+            fingerprints.set(eventPath, fingerprintOf(cache.containersFor(eventPath)));
+        }
+    };
+    const plugin = {
+        name: "@reactra/vite-plugin",
+        enforce: "pre",
+        config() {
+            // Day 24 / `#15`: hand esbuild a Reactra-aware onLoad so the
+            // dep-scan phase can preprocess DSL files before its parser
+            // sees them. Without this, esbuild prints "Unexpected
+            // component" / "Expected ';' but found 'store'" + the
+            // umbrella "Failed to run dependency scan" warning at first
+            // dev-server boot. On-demand serving still works because the
+            // transform() hook below catches each per-request compile.
+            return {
+                optimizeDeps: {
+                    esbuildOptions: {
+                        plugins: [reactraEsbuildPlugin],
+                    },
+                },
+            };
+        },
+        configResolved(config) {
+            projectRoot = config.root;
+        },
+        buildStart() {
+            // First emission of the manifest. Walker tolerates a missing
+            // src/pages/ directory (returns [] and we write an empty manifest)
+            // so this is safe even on a fresh-clone with no pages yet.
+            if (projectRoot) {
+                // A3: one shared cache across both build-time regens (regenAll), so a
+                // file read by both compiles once. QW-5: this also emits
+                // `.reactra/resource-names.d.ts` so `useMutation`'s `invalidate` is
+                // typed against the project's resource set (degrades to `string` when
+                // no resource is declared). regenAll swallows generator failures so a
+                // bad file never fails the build.
+                regenAll(null);
+            }
+        },
+        configureServer(server) {
+            // Day 20 / `#5c`: watch all of src/ (was src/pages/ only). Page
+            // adds/removes still regen ROUTES; store file adds/removes regen
+            // STORES. The generated manifest itself is filtered out by
+            // `isInsideSrc` to avoid feedback loops.
+            // `add` / `unlink` ALWAYS full-regen + refresh fingerprints — the file-
+            // set membership changed, so ROUTES/STORES/SERVICES/resources may all
+            // shift (regenAll shares one per-event cache between both generators).
+            const onAdd = (path) => {
+                if (!projectRoot || !isInsideSrc(projectRoot, path))
+                    return;
+                regenAll(path);
+            };
+            // A3 increment 2 — `change` is the hot path (every keystroke-save). Compile
+            // the changed file ONCE, diff its declaration fingerprint against the
+            // stored one:
+            //   - decl set DIFFERENT (store/service renamed, added, removed, or a
+            //     service modifier flipped) → full regen + refresh fingerprint.
+            //   - decl set UNCHANGED (body-only edit) → the src/-wide store/service/
+            //     resource scan can't change the output, so SKIP it. A pages/ change
+            //     still needs scanPages (routes/queries/prefetch can change), so we
+            //     regen there; a non-pages/ body-only change skips the regen entirely.
+            const onChange = (path) => {
+                if (!projectRoot || !isInsideSrc(projectRoot, path))
+                    return;
+                const cache = createGraphCache();
+                const next = fingerprintOf(cache.containersFor(path));
+                const prev = fingerprints.get(path);
+                const declUnchanged = prev !== undefined && fingerprintsEqual(prev, next);
+                fingerprints.set(path, next);
+                if (declUnchanged && !isPagesFile(projectRoot, path)) {
+                    // Body-only edit to a non-pages/ file — nothing the manifest or
+                    // resource-names depend on changed. Skip the whole regen.
+                    return;
+                }
+                if (declUnchanged) {
+                    // Body-only edit to a pages/ file: routes/queries/prefetch could
+                    // still change, so regen the manifest (reusing the cache that already
+                    // compiled this file). The src/-wide store/service walk still runs
+                    // inside regenerateRouteManifest but reads cached compiles — cheap.
+                    // resource-names also reuses the cache.
+                    try {
+                        regenerateRouteManifest(projectRoot, cache);
+                    }
+                    catch (err) {
+                        console.error("[@reactra/vite-plugin] manifest regen failed:", err);
+                    }
+                    try {
+                        regenerateResourceNames(projectRoot, cache);
+                    }
+                    catch (err) {
+                        console.error("[@reactra/vite-plugin] resource-names regen failed:", err);
+                    }
+                    return;
+                }
+                // Decl set changed (or first-ever sighting of this file) → full regen.
+                // Reuse the cache that already compiled the changed file.
+                try {
+                    regenerateRouteManifest(projectRoot, cache);
+                }
+                catch (err) {
+                    console.error("[@reactra/vite-plugin] manifest regen failed:", err);
+                }
+                try {
+                    regenerateResourceNames(projectRoot, cache);
+                }
+                catch (err) {
+                    console.error("[@reactra/vite-plugin] resource-names regen failed:", err);
+                }
+            };
+            // Day 25 / sidecar-on-unlink: when a Reactra source file is
+            // DELETED (not just edited), Vite never re-fires `transform()`
+            // for it — the file is gone — so `#7c`'s sidecar GC path inside
+            // transform() doesn't get a chance to run. Result: the deleted
+            // file's stale sidecar lingers under
+            // `node_modules/.reactra/sidecars/` and the next
+            // `loadSidecarIndex` call still sees its `stores[]` entries,
+            // potentially triggering duplicate-store-across-files against a
+            // new home file the user moved the store to. Fix: hook the
+            // watcher's unlink event directly to delete the sidecar by path.
+            // ENOENT-as-no-op in `deleteSidecar` means we don't need to gate
+            // by file extension — the call is harmless on non-Reactra files
+            // that never had a sidecar to begin with.
+            const onUnlink = (path) => {
+                if (!projectRoot || !isInsideSrc(projectRoot, path))
+                    return;
+                // File removed → drop its fingerprint so a later re-create is treated
+                // as a fresh sighting (full regen), and full-regen now that the
+                // file-set membership changed.
+                fingerprints.delete(path);
+                regenAll(null);
+                try {
+                    deleteSidecar(projectRoot, path);
+                }
+                catch (err) {
+                    console.error("[@reactra/vite-plugin] sidecar unlink failed:", err);
+                }
+            };
+            server.watcher.on("add", onAdd);
+            server.watcher.on("unlink", onUnlink);
+            // `change` is needed too — renaming a [param] segment from
+            // [id] → [customerId] surfaces as change(rename source) on some
+            // platforms rather than add+unlink (the fingerprint differ in onChange
+            // still forces a regen because the file's queries/route change).
+            server.watcher.on("change", onChange);
+        },
+        transform(code, id) {
+            // Skip files Reactra doesn't own (node_modules, virtual modules).
+            if (id.includes("/node_modules/") || id.includes("\\node_modules\\")) {
+                return null;
+            }
+            if (id.startsWith("\0") || id.startsWith("virtual:"))
+                return null;
+            if (!SUPPORTED_EXT_RE.test(stripQuery(id)))
+                return null;
+            if (!containsReactraDsl(code))
+                return null;
+            const sourcePath = stripQuery(id);
+            // Backlog 1a: `inject store X` binds via `import type` / same-file decl,
+            // so Pass 9 no longer needs `projectRoot` to resolve store names — the
+            // sidecar reader is gone. We still pass `sourceFile: id` (Day 22 / `#10`)
+            // so the returned source map's `sources[0]` + `file` carry the Vite
+            // module id; devtools shows the original DSL in the Sources panel.
+            const { code: compiled, graph, map } = compile(code, {
+                sourceFile: sourcePath,
+            });
+            warnIfColocatedStore(graph, code);
+            if (projectRoot) {
+                // Best-effort write — failures log but never break the transform.
+                // Day 18 / `#7c`: if the recompile produced a sidecar with no
+                // stores+services (e.g. a route store was moved out to its own
+                // file and what's left in this source is a pure-component page),
+                // DELETE the prior sidecar instead of overwriting it with an
+                // empty one. Leaving the stale sidecar around would let
+                // loadSidecarIndex keep seeing the moved-away store name and
+                // throw duplicate-store-across-files against the new home file.
+                try {
+                    const sidecar = buildSidecar(graph, sourcePath);
+                    if (isEmptyForIndex(sidecar)) {
+                        deleteSidecar(projectRoot, sourcePath);
+                    }
+                    else {
+                        writeSidecar(projectRoot, sourcePath, sidecar);
+                    }
+                }
+                catch (err) {
+                    console.error("[@reactra/vite-plugin] sidecar write failed:", err);
+                }
+            }
+            // `#10-followup` (Compiler §8): the returned map is now the full composed
+            // source→compiled map — both hops mapped, one segment per user-code slice
+            // (state/derived/action/resource/view) — so a breakpoint on a DSL line
+            // binds to the matching compiled line. `sourcesContent` carries the DSL.
+            //
+            // devtools-debugging backlog issue A: relabel the DSL leaf so DevTools
+            // doesn't list it under the same name as the served compiled module.
+            // Cast the readonly RawSourceMap to the mutable boundary type — same
+            // object, only the array element types differ in readonly-ness.
+            return { code: compiled, map: (map && labelDslSource(map, sourcePath)) };
+        },
+    };
+    // `ReactraVitePlugin` is a hand-rolled structural subset of Vite's `Plugin`
+    // (we don't import Vite at runtime). Vite's richer esbuild/source-map hook
+    // types don't bidirectionally match our minimal ones, so cast at the public
+    // boundary — the object is still type-checked against ReactraVitePlugin above.
+    return plugin;
+};
+export default reactraVitePlugin;
+// Re-exports so consumers (tests, integrations) can reach the walker and
+// the manifest helpers without a second package boundary.
+export { chainsForRoutes, collectServiceInjectionDiagnostics, deriveRoutePath, emitRouteManifest, emitRouterMiddleware, scanMiddleware, scanPages, scanServices, scanStores, } from "./walker.js";
+export { MANIFEST_RELATIVE_PATH, ROUTER_MIDDLEWARE_RELATIVE_PATH, regenerateRouteManifest, } from "./manifest.js";
+export { RESOURCE_NAMES_RELATIVE_PATH, collectResourceNames, emitResourceNames, regenerateResourceNames, } from "./resource-names.js";
+export { deleteSidecar, isEmptyForIndex, writeSidecar, } from "./sidecar-writer.js";
+export { reactraEsbuildPlugin } from "./esbuild-prescan.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,57 @@
+import { type DiscoveredMiddleware, type DiscoveredRoute, type DiscoveredService, type DiscoveredStore } from "./walker.ts";
+/**
+ * The on-disk location of the generated manifest, relative to the project
+ * root. Exported for tests + so the vite plugin can `import` from a stable
+ * path in the demo / app config.
+ */
+export declare const MANIFEST_RELATIVE_PATH = "src/routeManifest.generated.ts";
+/**
+ * The on-disk location of the generated middleware chains module (Wave 3,
+ * Stage 2). Sits next to the route manifest in `src/` so importers can
+ * pull `import { middlewareChains } from "./router-middleware.generated.ts"`
+ * with the same relative-path convention. Spec §6.4 names this file.
+ */
+export declare const ROUTER_MIDDLEWARE_RELATIVE_PATH = "src/router-middleware.generated.ts";
+/**
+ * Result of a regeneration attempt. `wrote: true` means the file changed
+ * and we wrote new bytes; `wrote: false` means the content was already
+ * up-to-date and we left the file alone.
+ */
+export interface RegenerateResult {
+    readonly wrote: boolean;
+    readonly routes: readonly DiscoveredRoute[];
+    /**
+     * Stores discovered via the sidecar index — surfaced in the result for
+     * tests + diagnostics. Day 20 / `#5c`.
+     */
+    readonly stores: readonly DiscoveredStore[];
+    /**
+     * Services discovered via the `preprocess()`-based scan of `src/` —
+     * surfaced in the result for tests + diagnostics. Phase 3.
+     */
+    readonly services: readonly DiscoveredService[];
+    readonly content: string;
+    readonly path: string;
+    /**
+     * Wave 3 / Stage 2 — middleware files discovered + the per-route chains
+     * resolved against them. Surfaced for tests + so the vite plugin can
+     * detect "no middleware exists anywhere" and skip the second write.
+     */
+    readonly middleware: readonly DiscoveredMiddleware[];
+    /**
+     * Whether the middleware companion file `<projectRoot>/src/
+     * router-middleware.generated.ts` was rewritten this call. Same
+     * change-check semantics as `wrote` — true only when bytes differ.
+     */
+    readonly wroteMiddleware: boolean;
+}
+/**
+ * Scan + emit + write-if-changed. Idempotent — calling twice with no
+ * page-tree change is a no-op for the filesystem.
+ *
+ * The walker tolerates a missing `src/pages/` directory (returns []); we
+ * still write the empty manifest so importers don't ImportError before
+ * any pages exist. Mirrors the placeholder a fresh-clone commits.
+ */
+export declare const regenerateRouteManifest: (projectRoot: string, cache?: import("./graph-cache.ts").GraphCache) => RegenerateResult;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAkBA,OAAO,EASL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAA;AAEpB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,mCAAmC,CAAA;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,uCACN,CAAA;AAEtC;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACpD;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,MAAM,EACnB,6CAA0B,KACzB,gBA4GF,CAAA"}