@reactra/vite-plugin 0.1.0-alpha.0

package/dist/manifest.js

@@ -0,0 +1,147 @@
+// @reactra/vite-plugin — manifest regeneration
+//
+// Owner: reactra-compiler-spec.md §7.1 (vite plugin file-watcher hook) +
+//        reactra-router-spec.md §5.1 (manifest format)
+//
+// Phase 1 #5b: a thin wrapper around the walker that
+//   (1) scans `<projectRoot>/src/pages/`,
+//   (2) renders the manifest text via `emitRouteManifest`, and
+//   (3) writes it to `<projectRoot>/src/routeManifest.generated.ts` IFF
+//       the rendered text differs from the current on-disk content.
+//
+// The change check matters: writing on every watcher fire would cascade
+// into an HMR full-reload even when the page set didn't actually change.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createGraphCache } from "./graph-cache.js";
+import { chainsForRoutes, collectServiceInjectionDiagnostics, emitRouteManifest, emitRouterMiddleware, scanMiddleware, scanPages, scanServices, scanStores, } from "./walker.js";
+/**
+ * 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 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 const ROUTER_MIDDLEWARE_RELATIVE_PATH = "src/router-middleware.generated.ts";
+/**
+ * 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 const regenerateRouteManifest = (projectRoot, cache = createGraphCache()) => {
+    // A3: ONE graph cache per regen — every container-reading scanner below
+    // (scanPages/scanStores/scanServices/collectServiceInjectionDiagnostics)
+    // shares it, so each src/ file compiles at most once per regen instead of
+    // 4–5×. scanMiddleware stays OFF the cache (it reads plain-TS via lex()).
+    // The watcher passes its own per-event cache so resource-names shares it too.
+    //
+    // B6: scanPages is wrapped to add a legible context frame, but it RETHROWS
+    // (unlike scanStores/scanServices, which degrade to []). Routes are the
+    // PRIMARY manifest output — degrading to empty would silently blank the app.
+    // The missing-`src/pages/` case already returns [] from INSIDE the walker
+    // (the top-level readdirSync try/catch), so only genuine fs/parse errors
+    // reach this catch.
+    let routes;
+    try {
+        routes = scanPages(projectRoot, cache);
+    }
+    catch (err) {
+        // Routes are the PRIMARY manifest output — unlike scanStores/scanServices
+        // (which degrade to []), empty routes = a silently-blank app. Fail loud,
+        // but add a legible context frame + spec ref so the raw error isn't alone.
+        throw new Error(`[@reactra/vite-plugin] scanPages failed for "${projectRoot}/src/pages" — ` +
+            `the route manifest cannot be regenerated. Routes are the primary manifest ` +
+            `output and are NOT degraded to empty (that would silently blank the app). ` +
+            `Fix the page tree (fs access or a malformed page component) and save again. ` +
+            `(reactra-router-spec.md §5.1)`, { cause: err });
+    }
+    // Day 20 / `#5c`: defensive try/catch around scanStores — it walks
+    // src/ and reads each candidate file. fs errors (permission, etc.)
+    // shouldn't crash the manifest regen; emit STORES as empty on
+    // failure and let the next regen recover.
+    let stores = [];
+    try {
+        stores = scanStores(projectRoot, cache);
+    }
+    catch (err) {
+        console.error("[@reactra/vite-plugin] scanStores failed (STORES omitted from manifest):", err);
+    }
+    // Phase 3: defensive try/catch around scanServices — same pattern as scanStores.
+    let services = [];
+    try {
+        services = scanServices(projectRoot, cache);
+    }
+    catch (err) {
+        console.error("[@reactra/vite-plugin] scanServices failed (SERVICES omitted from manifest):", err);
+    }
+    // Phase 3: service injection diagnostics — warn-only, no error code minted yet
+    // (deferred to Phase 6). Run after scanServices so we know the declared set.
+    try {
+        const diags = collectServiceInjectionDiagnostics(projectRoot, cache);
+        for (const d of diags) {
+            console.warn(`[@reactra/vite-plugin] inject service "${d.service}" in ${d.file} references an undeclared service — ` +
+                `add \`export service ${d.service} { ... }\` under src/ or list it in configureServices({ services }). ` +
+                `(reactra-service-spec.md §2)`);
+        }
+    }
+    catch {
+        // Diagnostic errors must never crash the manifest regen — swallow silently.
+    }
+    // Wave 3 / Stage 2 — same defensive pattern for the middleware walker.
+    let middleware = [];
+    try {
+        middleware = scanMiddleware(projectRoot);
+    }
+    catch (err) {
+        console.error("[@reactra/vite-plugin] scanMiddleware failed (router-middleware.generated.ts emitted empty):", err);
+    }
+    const content = emitRouteManifest(routes, stores, services);
+    const path = join(projectRoot, MANIFEST_RELATIVE_PATH);
+    let prior = "";
+    if (existsSync(path)) {
+        try {
+            prior = readFileSync(path, "utf8");
+        }
+        catch {
+            // unreadable file — treat as missing so we overwrite cleanly.
+        }
+    }
+    let wrote = false;
+    if (prior !== content) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content, "utf8");
+        wrote = true;
+    }
+    // Companion `router-middleware.generated.ts` — same change-check
+    // semantics so an unrelated touch doesn't churn HMR. Always emitted
+    // (even when empty) so importers don't break before any
+    // `_middleware.ts` exists.
+    const chains = chainsForRoutes(routes, middleware);
+    const mwContent = emitRouterMiddleware(middleware, chains);
+    const mwPath = join(projectRoot, ROUTER_MIDDLEWARE_RELATIVE_PATH);
+    let mwPrior = "";
+    if (existsSync(mwPath)) {
+        try {
+            mwPrior = readFileSync(mwPath, "utf8");
+        }
+        catch {
+            // unreadable → overwrite cleanly.
+        }
+    }
+    let wroteMiddleware = false;
+    if (mwPrior !== mwContent) {
+        mkdirSync(dirname(mwPath), { recursive: true });
+        writeFileSync(mwPath, mwContent, "utf8");
+        wroteMiddleware = true;
+    }
+    return { wrote, routes, stores, services, content, path, middleware, wroteMiddleware };
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/resource-names.d.ts

@@ -0,0 +1,49 @@
+import { type GraphCache } from "./graph-cache.ts";
+/**
+ * On-disk location of the generated ResourceName declaration, relative to the
+ * project root. Sits under `.reactra/` (gitignored, not committed) so it never
+ * collides with the `src/`-located route manifest.
+ */
+export declare const RESOURCE_NAMES_RELATIVE_PATH = ".reactra/resource-names.d.ts";
+/**
+ * Walk `<projectRoot>/src/` and collect every `resource X(...)` name declared
+ * in any DSL file, deduped into a sorted array. Cold-start safe: reads each
+ * candidate file and runs `compileToGraph` (preprocess → parse → extract,
+ * stopping before codegen — no emission). A file that fails to compile is
+ * skipped (a half-typed file mid-edit must not crash the dev server).
+ *
+ * Names are sorted with `localeCompare` so the emitted union is byte-stable
+ * across runs (C5 determinism).
+ *
+ * Tolerates a missing `src/` directory (returns []).
+ */
+export declare const collectResourceNames: (projectRoot: string, cache?: GraphCache) => string[];
+/**
+ * Render the `.reactra/resource-names.d.ts` module text from a list of names.
+ *
+ * Empty project → `type ResourceName = string` (NEVER an empty union / `never`,
+ * which would make every `invalidate` entry a type error and break the build
+ * before any resource exists). A non-empty project emits the sorted union.
+ *
+ * Pure: same input → byte-identical output (C5).
+ */
+export declare const emitResourceNames: (names: readonly string[]) => string;
+/**
+ * Result of a {@link regenerateResourceNames} call. `wrote: true` means the
+ * file changed and new bytes were written; `wrote: false` means the content
+ * was already up-to-date and the file was left untouched (mirrors the manifest
+ * change-check so an unrelated edit doesn't churn HMR).
+ */
+export interface ResourceNamesResult {
+    readonly wrote: boolean;
+    readonly names: readonly string[];
+    readonly content: string;
+    readonly path: string;
+}
+/**
+ * Collect → render → write-if-changed. Idempotent: a second call over an
+ * unchanged `src/` is a filesystem no-op. The change-check matters — writing
+ * on every watcher fire would cascade into needless TS re-checks.
+ */
+export declare const regenerateResourceNames: (projectRoot: string, cache?: GraphCache) => ResourceNamesResult;
+//# sourceMappingURL=resource-names.d.ts.map

package/dist/resource-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-names.d.ts","sourceRoot":"","sources":["../src/resource-names.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAA;AAI1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,QAAO,UAA+B,KACrC,MAAM,EAkCR,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,SAAS,MAAM,EAAE,KAAG,MAe5D,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,MAAM,EACnB,QAAO,UAA+B,KACrC,mBAmBF,CAAA"}

package/dist/resource-names.js

@@ -0,0 +1,128 @@
+// @reactra/vite-plugin — project-wide ResourceName union generator
+//
+// Owner: reactra-resource-spec.md §7 (typed `invalidate`) +
+//        reactra-compiler-spec.md §7.1 (vite plugin file-watcher hook).
+//
+// framework-review QW-5 / C1-tier-1: surface the set of resource names declared
+// across the WHOLE project to the TS layer, so `useMutation(..., { invalidate:
+// [...] })` autocompletes + type-errors on a typo. The mechanism is a generated
+// `.reactra/resource-names.d.ts` that narrows `@reactra/resource`'s
+// `ResourceName` alias via TS declaration merging.
+//
+// READ-ONLY over the source graph (C3): this module only READS resource names
+// from `compileToGraph(source).graph` — it never alters emitted code. It writes
+// exactly one generated `.d.ts` file and nothing else.
+//
+// Project-wide (NOT per-file): invalidation is cross-file (a mutation in one
+// page invalidates a resource declared in another), so the union must be the
+// union of ALL declared names. We piggyback on the same `src/` walk the manifest
+// regen already performs.
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createGraphCache } from "./graph-cache.js";
+/**
+ * On-disk location of the generated ResourceName declaration, relative to the
+ * project root. Sits under `.reactra/` (gitignored, not committed) so it never
+ * collides with the `src/`-located route manifest.
+ */
+export const RESOURCE_NAMES_RELATIVE_PATH = ".reactra/resource-names.d.ts";
+const SUPPORTED_EXT_RE = /\.(?:tsx|jsx|ts|js)$/;
+/**
+ * Walk `<projectRoot>/src/` and collect every `resource X(...)` name declared
+ * in any DSL file, deduped into a sorted array. Cold-start safe: reads each
+ * candidate file and runs `compileToGraph` (preprocess → parse → extract,
+ * stopping before codegen — no emission). A file that fails to compile is
+ * skipped (a half-typed file mid-edit must not crash the dev server).
+ *
+ * Names are sorted with `localeCompare` so the emitted union is byte-stable
+ * across runs (C5 determinism).
+ *
+ * Tolerates a missing `src/` directory (returns []).
+ */
+export const collectResourceNames = (projectRoot, cache = createGraphCache()) => {
+    const srcRoot = join(projectRoot, "src");
+    const names = new Set();
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            const stat = statSync(full);
+            if (stat.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (!stat.isFile())
+                continue;
+            if (!SUPPORTED_EXT_RE.test(entry))
+                continue;
+            // A3: one cached compile per file (shared with the manifest scanners when
+            // the watcher threads the same per-event cache). Returns [] on read/
+            // compile failure — a half-typed file mid-edit is skipped, next regen
+            // recovers.
+            for (const container of cache.containersFor(full)) {
+                for (const resource of container.resources) {
+                    names.add(resource.name);
+                }
+            }
+        }
+    };
+    walk(srcRoot);
+    return [...names].sort((a, b) => a.localeCompare(b));
+};
+/**
+ * Render the `.reactra/resource-names.d.ts` module text from a list of names.
+ *
+ * Empty project → `type ResourceName = string` (NEVER an empty union / `never`,
+ * which would make every `invalidate` entry a type error and break the build
+ * before any resource exists). A non-empty project emits the sorted union.
+ *
+ * Pure: same input → byte-identical output (C5).
+ */
+export const emitResourceNames = (names) => {
+    const union = names.length === 0
+        ? "string"
+        : names.map((n) => JSON.stringify(n)).join(" | ");
+    return [
+        "// GENERATED by @reactra/vite-plugin — do not edit.",
+        "// Narrows @reactra/resource's ResourceName to this project's resource set",
+        "// (framework-review QW-5 / C1). Regenerated on every src/ change; degrades",
+        "// to `string` when the project declares no resources.",
+        'declare module "@reactra/resource" {',
+        `  type ResourceName = ${union}`,
+        "}",
+        "",
+    ].join("\n");
+};
+/**
+ * Collect → render → write-if-changed. Idempotent: a second call over an
+ * unchanged `src/` is a filesystem no-op. The change-check matters — writing
+ * on every watcher fire would cascade into needless TS re-checks.
+ */
+export const regenerateResourceNames = (projectRoot, cache = createGraphCache()) => {
+    const names = collectResourceNames(projectRoot, cache);
+    const content = emitResourceNames(names);
+    const path = join(projectRoot, RESOURCE_NAMES_RELATIVE_PATH);
+    let prior = "";
+    if (existsSync(path)) {
+        try {
+            prior = readFileSync(path, "utf8");
+        }
+        catch {
+            // Unreadable → treat as missing so we overwrite cleanly.
+        }
+    }
+    let wrote = false;
+    if (prior !== content) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content, "utf8");
+        wrote = true;
+    }
+    return { wrote, names, content, path };
+};
+//# sourceMappingURL=resource-names.js.map

package/dist/resource-names.js.map

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

package/dist/sidecar-writer.d.ts

@@ -0,0 +1,60 @@
+import { type ReactraSidecar } from "@reactra/babel-plugin";
+/**
+ * Result of one sidecar-write attempt. `wrote` is false when the on-disk
+ * file already matched (modulo `generated`) — useful for HMR diagnostics
+ * and idempotence assertions in tests.
+ */
+export interface WriteSidecarResult {
+    readonly wrote: boolean;
+    readonly path: string;
+}
+/**
+ * Write `sidecar` to its Compiler §6 location and return the result.
+ * Re-uses the existing on-disk `generated` timestamp when every other
+ * field is unchanged, so a no-op dev-server transform doesn't churn the
+ * file's mtime (which would otherwise re-trigger any external watcher).
+ */
+export declare const writeSidecar: (projectRoot: string, sourcePath: string, sidecar: ReactraSidecar) => WriteSidecarResult;
+/**
+ * Result of one `deleteSidecar` attempt. `deleted` is true when an
+ * on-disk file was removed; false when there was nothing to remove
+ * (which is the idempotent no-op case the caller can rely on).
+ */
+export interface DeleteSidecarResult {
+    readonly deleted: boolean;
+    readonly path: string;
+}
+/**
+ * Remove the sidecar for `sourcePath`. Used by the Vite plugin's
+ * `transform` hook (Day 18 / `#7c`) when a recompile produces a sidecar with
+ * no stores+services — e.g. a route store was moved out to its own file. This
+ * keeps the on-disk sidecar set accurate for the tooling that consumes it
+ * (devtools/LSP — Compiler §6). (Backlog 1a deleted the codegen sidecar
+ * reader, so a stale sidecar no longer causes a duplicate-store build error;
+ * GC is now hygiene for the tooling metadata, not correctness for codegen.)
+ *
+ * Best-effort: ENOENT (nothing to delete) returns `deleted: false`; any
+ * other error logs to stderr but doesn't throw (matches `writeSidecar`'s
+ * "never break the transform" stance).
+ */
+export declare const deleteSidecar: (projectRoot: string, sourcePath: string) => DeleteSidecarResult;
+/**
+ * True when the sidecar carries nothing any consumer reads — no stores,
+ * no services, AND no components. Used by the Vite plugin to decide
+ * between `writeSidecar` (keep the sidecar; consumers want the data)
+ * and `deleteSidecar` (truly nothing to keep; clearing prevents stale
+ * store-name conflicts AND keeps the sidecar directory tidy).
+ *
+ * Day 23 / `#7b` note: tightened from "stores+services empty" →
+ * "components+stores+services empty." The earlier predicate over-
+ * deleted component-only sidecars (e.g. pure-component pages after
+ * the Day-18 split), losing the per-component metadata that the
+ * Day-23 view-tree walker now populates into `components[].awaitBlocks`.
+ * Component-only sidecars are exactly what devtools / LSP will read.
+ *
+ * The store-name conflict GC still works: when a file's store moves out,
+ * the file's recompile produces `stores: []` and `writeSidecar`
+ * overwrites the old listing — no need to delete the whole sidecar.
+ */
+export declare const isEmptyForIndex: (sidecar: ReactraSidecar) => boolean;
+//# sourceMappingURL=sidecar-writer.d.ts.map

package/dist/sidecar-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-writer.d.ts","sourceRoot":"","sources":["../src/sidecar-writer.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3E;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,YAAY,MAAM,EAClB,SAAS,cAAc,KACtB,kBAiBF,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,aAAa,MAAM,EACnB,YAAY,MAAM,KACjB,mBAUF,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,KAAG,OAGzB,CAAA"}

package/dist/sidecar-writer.js

@@ -0,0 +1,114 @@
+// On-disk sidecar writer — Compiler §6 (`.reactra.json`).
+//
+// Every Reactra source that the vite plugin compiles also gets a
+// per-file metadata sidecar dropped under
+// `<projectRoot>/node_modules/.reactra/sidecars/<rel-src>.reactra.json`.
+// Future passes (cross-file `use storeX` resolution, devtools, LSP, replay)
+// read these manifests; the writer scope here only emits.
+//
+// `writeSidecar` is best-effort: failures (read-only FS, permissions) log
+// to stderr but never break the transform — Reactra source still compiles
+// to React 19 even if the sidecar can't be written.
+//
+// Day 18 / `#7c` — sidecar GC on container move:
+//   `deleteSidecar(projectRoot, sourcePath)` removes the on-disk file when
+//   a recompile produces a `FileGraph` with no stores+services (the two
+//   kinds the cross-file index keys on). Without this, moving a store
+//   declaration to another file leaves a stale sidecar listing the same
+//   name → `loadSidecarIndex` throws duplicate-store-across-files. The
+//   Vite plugin's `transform` hook chooses between write and delete based
+//   on `isEmptyForIndex(sidecar)`.
+import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { sidecarPathFor } from "@reactra/babel-plugin";
+/**
+ * Write `sidecar` to its Compiler §6 location and return the result.
+ * Re-uses the existing on-disk `generated` timestamp when every other
+ * field is unchanged, so a no-op dev-server transform doesn't churn the
+ * file's mtime (which would otherwise re-trigger any external watcher).
+ */
+export const writeSidecar = (projectRoot, sourcePath, sidecar) => {
+    const path = sidecarPathFor(projectRoot, sourcePath);
+    const next = JSON.stringify(sidecar, null, 2) + "\n";
+    let existing = null;
+    try {
+        existing = readFileSync(path, "utf8");
+    }
+    catch {
+        // File doesn't exist yet — first write.
+    }
+    if (existing !== null && contentMatches(existing, next)) {
+        return { wrote: false, path };
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, next, "utf8");
+    return { wrote: true, path };
+};
+/**
+ * Remove the sidecar for `sourcePath`. Used by the Vite plugin's
+ * `transform` hook (Day 18 / `#7c`) when a recompile produces a sidecar with
+ * no stores+services — e.g. a route store was moved out to its own file. This
+ * keeps the on-disk sidecar set accurate for the tooling that consumes it
+ * (devtools/LSP — Compiler §6). (Backlog 1a deleted the codegen sidecar
+ * reader, so a stale sidecar no longer causes a duplicate-store build error;
+ * GC is now hygiene for the tooling metadata, not correctness for codegen.)
+ *
+ * Best-effort: ENOENT (nothing to delete) returns `deleted: false`; any
+ * other error logs to stderr but doesn't throw (matches `writeSidecar`'s
+ * "never break the transform" stance).
+ */
+export const deleteSidecar = (projectRoot, sourcePath) => {
+    const path = sidecarPathFor(projectRoot, sourcePath);
+    try {
+        unlinkSync(path);
+        return { deleted: true, path };
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return { deleted: false, path };
+        console.error("[@reactra/vite-plugin] sidecar delete failed:", err);
+        return { deleted: false, path };
+    }
+};
+/**
+ * True when the sidecar carries nothing any consumer reads — no stores,
+ * no services, AND no components. Used by the Vite plugin to decide
+ * between `writeSidecar` (keep the sidecar; consumers want the data)
+ * and `deleteSidecar` (truly nothing to keep; clearing prevents stale
+ * store-name conflicts AND keeps the sidecar directory tidy).
+ *
+ * Day 23 / `#7b` note: tightened from "stores+services empty" →
+ * "components+stores+services empty." The earlier predicate over-
+ * deleted component-only sidecars (e.g. pure-component pages after
+ * the Day-18 split), losing the per-component metadata that the
+ * Day-23 view-tree walker now populates into `components[].awaitBlocks`.
+ * Component-only sidecars are exactly what devtools / LSP will read.
+ *
+ * The store-name conflict GC still works: when a file's store moves out,
+ * the file's recompile produces `stores: []` and `writeSidecar`
+ * overwrites the old listing — no need to delete the whole sidecar.
+ */
+export const isEmptyForIndex = (sidecar) => sidecar.stores.length === 0 &&
+    sidecar.services.length === 0 &&
+    sidecar.components.length === 0;
+// Node's fs errors carry `code: "ENOENT"`; this narrows the unknown
+// without pulling in `NodeJS.ErrnoException` from `@types/node`.
+const isEnoent = (e) => typeof e === "object" && e != null && e.code === "ENOENT";
+// Compare two serialised sidecar bodies for equality ignoring `generated`.
+// JSON.parse → strip → JSON.stringify both sides; on any parse failure
+// fall back to raw string equality (safe default that just rewrites).
+const contentMatches = (existing, next) => {
+    try {
+        const a = JSON.parse(existing);
+        const b = JSON.parse(next);
+        const stripGenerated = (o) => {
+            const { generated: _g, ...rest } = o;
+            return rest;
+        };
+        return JSON.stringify(stripGenerated(a)) === JSON.stringify(stripGenerated(b));
+    }
+    catch {
+        return existing === next;
+    }
+};
+//# sourceMappingURL=sidecar-writer.js.map

package/dist/sidecar-writer.js.map

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