@uniweb/build 0.26.1 → 0.27.1

package/src/uwx/site.js

@@ -234,10 +234,25 @@ function buildPageData(config, ctx) {
   // at `<base>/data/<name>.json`.
   if (fetch && typeof fetch.collection === 'string') {
     const { collection, ...rest } = fetch
+    // ⭐ BOTH, deliberately, and they are not redundant.
+    //
+    //   `collection` — the author's query, unresolved. A consumer that can ask
+    //     a host where collections live (`config.records`) resolves it there,
+    //     which is the only way a live lane is reachable at all: a resolved
+    //     path names one place and closes the question.
+    //
+    //   `path` — the compiled artifact, the answer when nobody declares a lane.
+    //     Also what a consumer still reading `fetch.path` gets, so teaching the
+    //     wire a new field does not break one that has not learned it.
+    //
+    // `@uniweb/core`'s resolveFetchConfigs gives `collection` precedence and
+    // drops `path` once it has resolved an address — matching parseFetchConfig,
+    // which has always returned early on `collection`.
+    //
     // `schema` (the collection name) is BOTH the content.data key and part of the
-    // dataStore cache key (deriveCacheKey hashes {path,url,schema,…}; `collection`
-    // is ignored). Mirrors the static build's parseFetchConfig resolution.
-    fetch = { path: collectionDataUrl(collection), schema: collection, ...rest }
+    // dataStore cache key (deriveCacheKey hashes {path,url,endpoint,schema,…};
+    // `collection` is ignored). Mirrors the static build's parseFetchConfig.
+    fetch = { collection, path: collectionDataUrl(collection), schema: collection, ...rest }
   }
   setIf(data, 'fetch', fetch)
   if (isDynamic) {

package/src/uwx/sync-package.js

@@ -265,6 +265,10 @@ export async function emitSyncPackages(siteRoot, opts = {}) {
     ...(opts.foundationDir ? { foundationDir: opts.foundationDir } : {}),
     ...(opts.resolveModel ? { resolveModel: opts.resolveModel } : {}),
     ...(sourceLocale ? { sourceLocale } : {}),
+    // The publish org — resolves a foundation-relative `@/x` model ref into
+    // `@org/x` before it ships. Absent on an offline probe, which is why
+    // buildCollectionEntities warns rather than throws.
+    ...(opts.org ? { org: opts.org } : {}),
   })
   const warnings = [...col.warnings]
 

package/src/vite-foundation-plugin.js

@@ -88,11 +88,25 @@ let _buildingSSRBundle = false
  * foundation's own package.json is recorded alongside the runtime version,
  * declaring the author's intent for the validation above.
  *
- * ⛔ **`policy` REACHES NOBODY TODAY — it is written here and read by nothing.**
+ * ⛔ **`policy` IS NOT SENT AT REGISTER — this half is ours and is certain.**
  * `readRuntimePin()` (`cli/src/utils/code-upload.js`) returns only `.runtime`, so
  * `register` carries the floor as `info.runtime` and the policy is dropped. A
  * foundation author who sets `uniweb.runtimePolicy` gets it emitted into `dist/`
- * and silently discarded.
+ * and no further.
+ *
+ * ⚠️ **Whether a HOST reads `runtime-pin.json` off the built foundation is that
+ * host's to answer, not ours — name the host before saying what is consumed.**
+ * A note here once read "nothing consumes it today", unscoped, which is a claim
+ * about every host the framework serves and framework can substantiate it for
+ * none of them.
+ *
+ * 📌 **The check that refutes it, so this is not a claim with no expiry:** grep a
+ * host's serving code for `runtime-pin` / `runtimePolicy`. Asked and answered for
+ * the Uniweb host on **2026-08-26 — zero consumers across its delivery worker,
+ * mirror, runtime host and capability worker**, and its runtime version comes
+ * solely from published site metadata and is part of a render-cache key, so a
+ * request-time policy would collide with its invalidation model. **That is one
+ * host on one date; a static host or a foreign backend is a separate question.**
  *
  * ⚖️ **This is a field with standing and no consumer — NOT a mistake to delete.**
  * The architecture assigns this declaration to the foundation on principle: each
@@ -205,8 +219,9 @@ async function emitRuntimePin(outDir, projectRoot) {
   // delivered implies both travel. Only the floor does.
   if (policy) {
     console.log(
-      `  note: runtimePolicy "${policy}" is recorded but not yet delivered — nothing consumes it today.\n` +
-        `        The floor (runtime ${runtimeVersion}) does travel, as info.runtime at register.`
+      `  note: runtimePolicy "${policy}" is recorded in dist/runtime-pin.json and is NOT sent at register.\n` +
+        `        The floor (runtime ${runtimeVersion}) does travel, as info.runtime.\n` +
+        `        Whether your host reads the file is its own to say — see the header for how to check.`
     )
   }
 }