@rsc-kit/core 0.28.1 → 0.29.1

package/dist/vite.js

@@ -221,6 +221,44 @@ const hostManifestRan = new Set();
  * the ordinary case for an app that installs the engine from npm and runs
  * `vite build` itself.
  */
+/** This package's version, as published - what an AGENTS.md section is compared with. */
+const PACKAGE_VERSION = (() => {
+    try {
+        return (JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8")).version ?? "");
+    }
+    catch {
+        return "";
+    }
+})();
+/**
+ * Say, once, when AGENTS.md's rsc-kit section is from an older rsc-kit than
+ * this one - so an agent is not left following rules that have moved on.
+ * Stamped sections only: an unstamped one is from before stamps, and says so.
+ */
+function agentsNotice(root) {
+    let text;
+    try {
+        text = readFileSync(join(root, "AGENTS.md"), "utf-8");
+    }
+    catch {
+        return;
+    }
+    const at = text.indexOf("<!-- rsc-kit:start");
+    if (at === -1)
+        return;
+    const line = text.slice(at, text.indexOf("-->", at));
+    let stamped = "";
+    try {
+        stamped = JSON.parse(line.slice("<!-- rsc-kit:start".length).trim() || "{}").version ?? "";
+    }
+    catch {
+        // An unreadable stamp is as good as none.
+    }
+    if (stamped && (stamped === PACKAGE_VERSION || !PACKAGE_VERSION))
+        return;
+    console.log(`\n  rsc-kit: AGENTS.md has the rules of ${stamped ? `rsc-kit ${stamped}` : "an earlier rsc-kit"}; this is ${PACKAGE_VERSION || "a newer one"}.` +
+        `\n  Bring them up to date: bunx rsc-kit agents   (review the change in git)\n`);
+}
 /** This package's name, for excluding it from dep optimization. */
 const PACKAGE_NAME = (() => {
     try {
@@ -2263,7 +2301,7 @@ const SECTION_FILE = /\.section\.(tsx|jsx|ts|js)$/;
 function usesRefreshOn() {
     for (const component of components.values()) {
         const src = readFileSync(component.absPath, "utf-8");
-        if (SECTION_FILE.test(component.absPath) ? /\brefreshOn\s*:/.test(src) : urlSchemaExports(component.absPath).refreshOn)
+        if (SECTION_FILE.test(component.absPath) ? /\brefreshOn\b/.test(src) : urlSchemaExports(component.absPath).refreshOn)
             return true;
     }
     return false;
@@ -2555,7 +2593,14 @@ function urlSchemaExports(absPath) {
         searchParams: /export\s+const\s+searchParams\s*[=:]/.test(src),
         // What the page itself refreshes on, beside its url schemas: a change to
         // one of its names refreshes the page, as refresh('page') does.
-        refreshOn: /export\s+(const|function|async\s+function)\s+refreshOn\s*[=:(]/.test(src),
+        //
+        // Every way of exporting it, not one: `export const`, `export function`,
+        // and a list - `export { refreshOn }`, `export { names as refreshOn }`,
+        // `export { refreshOn } from './names'`. A pattern for one silently did
+        // nothing for the others. `export * from` cannot be read without
+        // following the import; name it in a list instead.
+        refreshOn: /export\s+(const|let|function|async\s+function)\s+refreshOn\b/.test(src) ||
+            /export\s*(type\s+)?\{[^}]*\brefreshOn\b[^}]*\}/.test(src),
     };
 }
 // ── Codegen ──────────────────────────────────────────────────────────────────
@@ -6958,6 +7003,10 @@ export function rscKit(options = {}) {
         // Swapping the plugins in the app's config is not a fix: Nitro then loads
         // .env too late for the app's first request.
         configureServer: { order: "pre", handler(server) {
+                // The rules an agent follows here say which rsc-kit wrote them. One
+                // line when they are older than the rsc-kit running - never a rewrite:
+                // the section is the app's to update, and git shows the change.
+                agentsNotice(projectRoot);
                 // The icons and share images live in app/, which nothing serves; the
                 // build copies them beside the client output. There is no output while
                 // developing, so the same hrefs the head tags carry are answered from