@elytracms/next 0.0.105 → 0.0.106

package/dist/index.d.ts

@@ -946,15 +946,27 @@ declare function createCanvasRoute(options: CanvasRouteOptions): CanvasRoute;
  *   defaults live on the project's own settings document and are read by its layout —
  *   this reader needs none (EC-590 (b): nothing here ever read a settings document).
  * - `robots`: `seo.noindex` → `{ index: false }`.
- * - `alternates.canonical`: `seo.canonical` (EC-228), verbatim.
+ * - `alternates.canonical`: `seo.canonical` (EC-228), verbatim — else the page's own ADDRESS,
+ *   `doc.path` (EC-779): the path the content client puts on the `resolvePage` document, the
+ *   one router's `urlFor` in the request's locale, so each locale's page names its own
+ *   localized URL and every duplicate URL of a page (a second route, a trailing slash) names
+ *   the one address. ROOT-RELATIVE on purpose: Next makes it absolute against the host's
+ *   `metadataBase` — the host's one declaration of its origin — and keeps an absolute URL over
+ *   it, so it is never built from `frontendUrl` (a preview deployment's origin on a real site)
+ *   nor from the request URL. None is inferred on a `noindex` page, nor where the document has
+ *   no address (a page no route addresses in this locale, a document from `getDocument`). A
+ *   locale served the default locale's SEO object by fallback never receives its explicit
+ *   canonical — delivery drops it (`content/resolve.ts`).
  *
  * Image resolution (EC-202/EC-266): `seo.image` is an asset field, delivered as a resolved
  * asset object (`{ id, url, … }`) → its `url`; a string is a passthrough URL or a raw asset
  * id resolved against the page's baked `assets`; anything unresolvable is dropped — an
  * `og:image` must carry a real URL, never an internal id.
  *
- * `hreflang` alternates are intentionally NOT derived here (a per-page translation map is
- * the sitemap's — EC-517).
+ * `hreflang` alternates are intentionally NOT derived here: the sitemap is their one emitter
+ * (EC-517) — a head emitter would need every locale's client and the sitemap's gates, a second
+ * reader of the same facts. What the head carries, its own address, agrees with the sitemap's
+ * entry for the page (`sitemap-agreement.test.ts`, EC-779).
  */
 interface SeoMetadataContext {
     /** The SEO role field name — `result.seoField`. Default: the conventional `seo`. */

package/dist/index.js

@@ -279,7 +279,9 @@ function seoMetadata(doc, ctx = {}) {
     };
   }
   if (noindex) metadata.robots = { index: false };
-  if (canonical) metadata.alternates = { canonical };
+  const address = noindex ? null : str(doc?.["path"]);
+  const effectiveCanonical = canonical ?? address;
+  if (effectiveCanonical) metadata.alternates = { canonical: effectiveCanonical };
   return metadata;
 }
 function mergeMetadataOverParent(parent, page) {