@tangle-network/brand 1.31.8 → 1.31.9

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.31.9
+
+### Patch Changes
+
+- d5ff1b5: Compose route and document metadata through one shared owner, keeping canonical URLs on the product origin and rejecting partial social overrides.
+
 ## 1.31.8
 
 ### Patch Changes

package/README.md

@@ -28,6 +28,14 @@ current supported contract and a real preview check. This helper does not fetch
 media, prove its MIME/codec/duration/range/cache behavior, or approve publication.
 Verify those against the served files. Canonical URLs omit query and fragment.
 
+For routers that replace parent metadata, `pageMetadata(page, { pathname,
+overrides })` returns the document title, description, social tags and canonical
+link as descriptors. Route title/description overrides update both preview
+formats; blank overrides retain the page defaults. Other descriptors, such as
+robots and JSON-LD, pass through. The pathname stays on the page's origin.
+Set verified media on `page`; partial
+Open Graph or Twitter overrides are rejected to prevent contradictory cards.
+
 ### Tailwind v4
 
 ```css

package/dist/social.d.ts

@@ -35,4 +35,16 @@ export type SocialMetaTag = {
 export declare function socialMetadata(page: SocialPage): {
   canonicalUrl: string;
   tags: SocialMetaTag[];
-};
+};
+export type PageMetadataTag = SocialMetaTag | {
+  title: string;
+} | {
+  tagName: "link";
+  rel: "canonical";
+  href: string;
+};
+/** Compose document metadata after a route replaces its parent's descriptors. */
+export declare function pageMetadata<Descriptor extends object = never>(page: SocialPage, { pathname, overrides }?: {
+  pathname?: string;
+  overrides?: readonly Descriptor[];
+}): Array<PageMetadataTag | Descriptor>;

package/dist/social.js

@@ -105,4 +105,40 @@ function socialMetadata(page) {
 		]
 	};
 }
-export { socialMetadata };
+/** Compose document metadata after a route replaces its parent's descriptors. */
+function pageMetadata(page, { pathname, overrides = [] } = {}) {
+	let { title, description } = page;
+	const extra = [];
+	for (const tag of overrides) {
+		const data = tag;
+		if ([data.property, data.name].some((key) => typeof key === "string" && /^(og|twitter):/.test(key))) throw new Error("Pass verified social fields on the page, not partial route overrides");
+		if ("title" in data) {
+			if (typeof data.title === "string" && data.title.trim()) title = data.title;
+		} else if (data.name === "description") {
+			if (typeof data.content === "string" && data.content.trim()) description = data.content;
+		} else if (!(data.tagName === "link" && data.rel === "canonical")) extra.push(tag);
+	}
+	const url = httpsUrl(page.url);
+	if (pathname !== void 0) url.pathname = pathname;
+	const social = socialMetadata({
+		...page,
+		title,
+		description,
+		url: url.href
+	});
+	return [
+		{ title },
+		{
+			name: "description",
+			content: description
+		},
+		...social.tags,
+		{
+			tagName: "link",
+			rel: "canonical",
+			href: social.canonicalUrl
+		},
+		...extra
+	];
+}
+export { pageMetadata, socialMetadata };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/brand",
-  "version": "1.31.8",
+  "version": "1.31.9",
   "description": "Tangle brand system — design tokens, logo, Tailwind v4 theme. Single source of truth for every Tangle app.",
   "type": "module",
   "license": "MIT",

package/src/social.ts

@@ -91,3 +91,37 @@ export function socialMetadata(page: SocialPage): {
     ],
   };
 }
+
+export type PageMetadataTag = SocialMetaTag
+  | { title: string }
+  | { tagName: "link"; rel: "canonical"; href: string };
+
+/** Compose document metadata after a route replaces its parent's descriptors. */
+export function pageMetadata<Descriptor extends object = never>(
+  page: SocialPage,
+  { pathname, overrides = [] }: { pathname?: string; overrides?: readonly Descriptor[] } = {},
+): Array<PageMetadataTag | Descriptor> {
+  let { title, description } = page;
+  const extra: Descriptor[] = [];
+  for (const tag of overrides) {
+    const data = tag as Record<string, unknown>;
+    if ([data.property, data.name].some(key => typeof key === "string" && /^(og|twitter):/.test(key))) {
+      throw new Error("Pass verified social fields on the page, not partial route overrides");
+    }
+    if ("title" in data) {
+      if (typeof data.title === "string" && data.title.trim()) title = data.title;
+    } else if (data.name === "description") {
+      if (typeof data.content === "string" && data.content.trim()) description = data.content;
+    } else if (!(data.tagName === "link" && data.rel === "canonical")) extra.push(tag);
+  }
+  const url = httpsUrl(page.url);
+  if (pathname !== undefined) url.pathname = pathname;
+  const social = socialMetadata({ ...page, title, description, url: url.href });
+  return [
+    { title },
+    { name: "description", content: description },
+    ...social.tags,
+    { tagName: "link", rel: "canonical", href: social.canonicalUrl },
+    ...extra,
+  ];
+}