@uniweb/build 0.27.0 → 0.27.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -59,17 +59,17 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
+    "@uniweb/content-writer": "^0.3.4",
+    "@uniweb/projections": "^0.3.7",
     "@uniweb/schemas": "^0.2.11",
-    "@uniweb/theming": "^0.1.15",
     "@uniweb/semantic-parser": "^1.3.1",
-    "@uniweb/projections": "^0.3.7",
-    "@uniweb/content-writer": "^0.3.4"
+    "@uniweb/theming": "^0.1.15"
   },
   "optionalDependencies": {
     "@uniweb/runtime": "^0.13.0",
+    "@uniweb/content-reader": "^1.2.4",
     "@uniweb/schemas": "^0.2.11",
-    "@uniweb/semantic-parser": "^1.3.1",
-    "@uniweb/content-reader": "^1.2.4"
+    "@uniweb/semantic-parser": "^1.3.1"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",

package/src/uwx/collections.js

@@ -526,6 +526,30 @@ export async function buildCollectionEntities(siteRoot, opts = {}) {
   const entities = []
   const index = []
   const warnings = []
+
+  // ⛔ `@/x` IS A FOUNDATION-RELATIVE ALIAS AND MUST BE RESOLVED BEFORE IT SHIPS.
+  //
+  // `register` resolves it (`uwx/registry-package.js` builds `scoped` from the
+  // publish scope and applies it to BOTH the declaration's name and its refs), so
+  // a foundation's `@/member` is stored as `@org/member`. This path did NOT, and
+  // carried the alias verbatim into `$model` and `models_required.name_at_export`.
+  //
+  // ⚠️ The backend resolves Models BY NAME and never mints, so an unresolved alias
+  // is refused at restore with a message about a missing Model — which reads as a
+  // registration problem rather than a producer one. Measured 2026-08-27 on a live
+  // manor: `register` had already stored `@proximify/member` from the same alias,
+  // and the push then named `@/member`. One CLI, two paths, one resolver.
+  //
+  // ⭐ Resolving BEFORE `declarationFor` is what keeps this to one line of behaviour:
+  // `resolveDeclaration` already matches a fully-qualified name against the
+  // foundation's `@/`-keyed `dataSchemas`, so a resolved name looks up correctly and
+  // `declaration.name` — the value that becomes `$model` — is the resolved one.
+  const selfScopeOrg =
+    typeof opts.org === 'string' ? opts.org.replace(/^@/, '').replace(/\/.*$/, '') : ''
+  const resolveSelfScope = (ref) =>
+    typeof ref === 'string' && ref.startsWith('@/') && selfScopeOrg
+      ? `@${selfScopeOrg}/${ref.slice(2)}`
+      : ref
   // Collections that resolved no data schema (the convention-default soft-skip
   // below) — not synced as folder entities. The composite deploy delivers these
   // statically (the "data ball") instead, so the caller can route them there.
@@ -535,7 +559,18 @@ export async function buildCollectionEntities(siteRoot, opts = {}) {
   // reuse a slug).
   const seen = new Set()
   for (const { name, decl } of mapped) {
-    const modelName = decl.schema || decl.model
+    const declaredModel = decl.schema || decl.model
+    const modelName = resolveSelfScope(declaredModel)
+    // Unresolvable `@/` — no org is known. Ship it rather than throwing (a `status`
+    // probe on a never-pushed site has no org and must still count), but say so:
+    // the backend's refusal names a missing Model and cannot name this cause.
+    if (modelName === declaredModel && typeof declaredModel === 'string' && declaredModel.startsWith('@/')) {
+      warnings.push(
+        `collection "${name}": \`${declaredModel}\` is foundation-relative and no org is known, ` +
+          `so it ships unresolved. The backend resolves Models by name and will refuse it. ` +
+          `Pass \`--org @handle\`, or push once so the site records its org.`
+      )
+    }
     const declaration = await declarationFor(modelName)
     if (!declaration) {
       // A convention-defaulted schema (subfolder-name) that doesn't resolve is a

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]