@reblu/site-blocks 0.7.0 → 0.9.0

package/dist/seo.cjs

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/seo.ts
+var seo_exports = {};
+__export(seo_exports, {
+  buildFaqPageJsonLd: () => buildFaqPageJsonLd,
+  collectFaqItems: () => collectFaqItems
+});
+module.exports = __toCommonJS(seo_exports);
+
+// src/lib/block-order.ts
+function sortBlocksByOrder(blocks) {
+  return [...blocks].sort((a, b) => a.order - b.order);
+}
+
+// src/lib/faq-json-ld.ts
+function normaliseText(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function buildFaqPageJsonLd(items) {
+  const mainEntity = [];
+  for (const item of items) {
+    const name = normaliseText(item.q);
+    const text = normaliseText(item.a);
+    if (!name || !text) continue;
+    mainEntity.push({ "@type": "Question", name, acceptedAnswer: { "@type": "Answer", text } });
+  }
+  if (mainEntity.length === 0) return null;
+  return { "@context": "https://schema.org", "@type": "FAQPage", mainEntity };
+}
+function collectFaqItems(blocks) {
+  if (!blocks) return [];
+  return sortBlocksByOrder(blocks).flatMap(
+    (block) => block.blockType === "faq" ? block.data.items : []
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildFaqPageJsonLd,
+  collectFaqItems
+});
+//# sourceMappingURL=seo.cjs.map

package/dist/seo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo.ts","../src/lib/block-order.ts","../src/lib/faq-json-ld.ts"],"sourcesContent":["// `@reblu/site-blocks/seo` — directive-free structured-data helpers (REB-850).\n//\n// NO `'use client'` here, ever: these are called from Server Components and\n// `generateMetadata`. A helper reachable only through a client entry is a client\n// reference on the server and throws when called there (REB-846).\n// `test/seo-entry.test.ts` enforces this on the emitted dist, not the source.\nexport {\n  buildFaqPageJsonLd,\n  collectFaqItems,\n  type FaqItem,\n  type FaqPageJsonLd,\n} from './lib/faq-json-ld'\n","/**\n * The single ordering rule for page blocks: ascending `order`, stable for ties,\n * never mutating the input. `PageBlocks` (what the page shows) and\n * `collectFaqItems` (what the FAQPage structured data says) both use it, so the\n * two can never disagree on question order.\n */\nexport function sortBlocksByOrder<T extends { order: number }>(blocks: readonly T[]): T[] {\n  return [...blocks].sort((a, b) => a.order - b.order)\n}\n","import type { PageBlock } from '@reblu/site-contracts'\n\nimport { sortBlocksByOrder } from './block-order'\n\n/**\n * REB-850 — schema.org `FAQPage` structured data for a page's FAQ blocks.\n *\n * Pure and framework-free on purpose: it is exported from the directive-free\n * `@reblu/site-blocks/seo` entry (and the RSC-safe root), so a Server Component\n * or `generateMetadata` can call it. REB-846 is the failure this avoids — a\n * helper reachable ONLY through a `'use client'` entry is a client reference on\n * the server, and calling it from a Server Component throws.\n *\n * The caller serialises the result; pair it with `@reblu/site-next`'s\n * `<JsonLd>`, which escapes the `</script>` boundary.\n */\n\n/** One question/answer pair — the `faq` block's `data.items[number]` shape. */\nexport interface FaqItem {\n  q: string\n  a: string\n}\n\nexport interface FaqPageJsonLd {\n  '@context': 'https://schema.org'\n  '@type': 'FAQPage'\n  mainEntity: Array<{\n    '@type': 'Question'\n    name: string\n    acceptedAnswer: { '@type': 'Answer'; text: string }\n  }>\n}\n\n/**\n * Questions and answers are PLAIN TEXT — authored in a Textarea and rendered by\n * `FaqAccordion` as escaped text. The structured data must say exactly what the\n * page shows, so nothing is stripped or decoded: `a < b`, `<b>` and `&amp;` are\n * content. Only whitespace is collapsed (the accordion keeps line breaks; the\n * visible words are identical). Escaping the `</script>` boundary is the\n * serialiser's job (`<JsonLd>`), not this function's.\n */\nfunction normaliseText(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim()\n}\n\n/**\n * Builds a schema.org `FAQPage` object from question/answer pairs.\n *\n * Items whose question or answer is blank are skipped, and the function\n * returns `null` when nothing is left — an empty `FAQPage` is invalid\n * structured data, so the caller simply renders no script.\n */\nexport function buildFaqPageJsonLd(items: readonly FaqItem[]): FaqPageJsonLd | null {\n  const mainEntity: FaqPageJsonLd['mainEntity'] = []\n  for (const item of items) {\n    const name = normaliseText(item.q)\n    const text = normaliseText(item.a)\n    if (!name || !text) continue\n    mainEntity.push({ '@type': 'Question', name, acceptedAnswer: { '@type': 'Answer', text } })\n  }\n  if (mainEntity.length === 0) return null\n  return { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity }\n}\n\n/**\n * Every `faq` block's items, in the order `PageBlocks` renders them (ascending\n * `order`, via the shared `sortBlocksByOrder`) — feed the result to\n * {@link buildFaqPageJsonLd}.\n */\nexport function collectFaqItems(blocks: readonly PageBlock[] | null | undefined): FaqItem[] {\n  if (!blocks) return []\n  return sortBlocksByOrder(blocks).flatMap((block) =>\n    block.blockType === 'faq' ? block.data.items : [],\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,SAAS,kBAA+C,QAA2B;AACxF,SAAO,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACrD;;;ACiCA,SAAS,cAAc,OAAuB;AAC5C,SAAO,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACzC;AASO,SAAS,mBAAmB,OAAiD;AAClF,QAAM,aAA0C,CAAC;AACjD,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,cAAc,KAAK,CAAC;AACjC,UAAM,OAAO,cAAc,KAAK,CAAC;AACjC,QAAI,CAAC,QAAQ,CAAC,KAAM;AACpB,eAAW,KAAK,EAAE,SAAS,YAAY,MAAM,gBAAgB,EAAE,SAAS,UAAU,KAAK,EAAE,CAAC;AAAA,EAC5F;AACA,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,SAAO,EAAE,YAAY,sBAAsB,SAAS,WAAW,WAAW;AAC5E;AAOO,SAAS,gBAAgB,QAA4D;AAC1F,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,SAAO,kBAAkB,MAAM,EAAE;AAAA,IAAQ,CAAC,UACxC,MAAM,cAAc,QAAQ,MAAM,KAAK,QAAQ,CAAC;AAAA,EAClD;AACF;","names":[]}

package/dist/seo.d.cts

@@ -0,0 +1,47 @@
+import { PageBlock } from '@reblu/site-contracts';
+
+/**
+ * REB-850 — schema.org `FAQPage` structured data for a page's FAQ blocks.
+ *
+ * Pure and framework-free on purpose: it is exported from the directive-free
+ * `@reblu/site-blocks/seo` entry (and the RSC-safe root), so a Server Component
+ * or `generateMetadata` can call it. REB-846 is the failure this avoids — a
+ * helper reachable ONLY through a `'use client'` entry is a client reference on
+ * the server, and calling it from a Server Component throws.
+ *
+ * The caller serialises the result; pair it with `@reblu/site-next`'s
+ * `<JsonLd>`, which escapes the `</script>` boundary.
+ */
+/** One question/answer pair — the `faq` block's `data.items[number]` shape. */
+interface FaqItem {
+    q: string;
+    a: string;
+}
+interface FaqPageJsonLd {
+    '@context': 'https://schema.org';
+    '@type': 'FAQPage';
+    mainEntity: Array<{
+        '@type': 'Question';
+        name: string;
+        acceptedAnswer: {
+            '@type': 'Answer';
+            text: string;
+        };
+    }>;
+}
+/**
+ * Builds a schema.org `FAQPage` object from question/answer pairs.
+ *
+ * Items whose question or answer is blank are skipped, and the function
+ * returns `null` when nothing is left — an empty `FAQPage` is invalid
+ * structured data, so the caller simply renders no script.
+ */
+declare function buildFaqPageJsonLd(items: readonly FaqItem[]): FaqPageJsonLd | null;
+/**
+ * Every `faq` block's items, in the order `PageBlocks` renders them (ascending
+ * `order`, via the shared `sortBlocksByOrder`) — feed the result to
+ * {@link buildFaqPageJsonLd}.
+ */
+declare function collectFaqItems(blocks: readonly PageBlock[] | null | undefined): FaqItem[];
+
+export { type FaqItem, type FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems };

package/dist/seo.d.ts

@@ -0,0 +1,47 @@
+import { PageBlock } from '@reblu/site-contracts';
+
+/**
+ * REB-850 — schema.org `FAQPage` structured data for a page's FAQ blocks.
+ *
+ * Pure and framework-free on purpose: it is exported from the directive-free
+ * `@reblu/site-blocks/seo` entry (and the RSC-safe root), so a Server Component
+ * or `generateMetadata` can call it. REB-846 is the failure this avoids — a
+ * helper reachable ONLY through a `'use client'` entry is a client reference on
+ * the server, and calling it from a Server Component throws.
+ *
+ * The caller serialises the result; pair it with `@reblu/site-next`'s
+ * `<JsonLd>`, which escapes the `</script>` boundary.
+ */
+/** One question/answer pair — the `faq` block's `data.items[number]` shape. */
+interface FaqItem {
+    q: string;
+    a: string;
+}
+interface FaqPageJsonLd {
+    '@context': 'https://schema.org';
+    '@type': 'FAQPage';
+    mainEntity: Array<{
+        '@type': 'Question';
+        name: string;
+        acceptedAnswer: {
+            '@type': 'Answer';
+            text: string;
+        };
+    }>;
+}
+/**
+ * Builds a schema.org `FAQPage` object from question/answer pairs.
+ *
+ * Items whose question or answer is blank are skipped, and the function
+ * returns `null` when nothing is left — an empty `FAQPage` is invalid
+ * structured data, so the caller simply renders no script.
+ */
+declare function buildFaqPageJsonLd(items: readonly FaqItem[]): FaqPageJsonLd | null;
+/**
+ * Every `faq` block's items, in the order `PageBlocks` renders them (ascending
+ * `order`, via the shared `sortBlocksByOrder`) — feed the result to
+ * {@link buildFaqPageJsonLd}.
+ */
+declare function collectFaqItems(blocks: readonly PageBlock[] | null | undefined): FaqItem[];
+
+export { type FaqItem, type FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems };

package/dist/seo.js

@@ -0,0 +1,31 @@
+// src/lib/block-order.ts
+function sortBlocksByOrder(blocks) {
+  return [...blocks].sort((a, b) => a.order - b.order);
+}
+
+// src/lib/faq-json-ld.ts
+function normaliseText(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function buildFaqPageJsonLd(items) {
+  const mainEntity = [];
+  for (const item of items) {
+    const name = normaliseText(item.q);
+    const text = normaliseText(item.a);
+    if (!name || !text) continue;
+    mainEntity.push({ "@type": "Question", name, acceptedAnswer: { "@type": "Answer", text } });
+  }
+  if (mainEntity.length === 0) return null;
+  return { "@context": "https://schema.org", "@type": "FAQPage", mainEntity };
+}
+function collectFaqItems(blocks) {
+  if (!blocks) return [];
+  return sortBlocksByOrder(blocks).flatMap(
+    (block) => block.blockType === "faq" ? block.data.items : []
+  );
+}
+export {
+  buildFaqPageJsonLd,
+  collectFaqItems
+};
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/block-order.ts","../src/lib/faq-json-ld.ts"],"sourcesContent":["/**\n * The single ordering rule for page blocks: ascending `order`, stable for ties,\n * never mutating the input. `PageBlocks` (what the page shows) and\n * `collectFaqItems` (what the FAQPage structured data says) both use it, so the\n * two can never disagree on question order.\n */\nexport function sortBlocksByOrder<T extends { order: number }>(blocks: readonly T[]): T[] {\n  return [...blocks].sort((a, b) => a.order - b.order)\n}\n","import type { PageBlock } from '@reblu/site-contracts'\n\nimport { sortBlocksByOrder } from './block-order'\n\n/**\n * REB-850 — schema.org `FAQPage` structured data for a page's FAQ blocks.\n *\n * Pure and framework-free on purpose: it is exported from the directive-free\n * `@reblu/site-blocks/seo` entry (and the RSC-safe root), so a Server Component\n * or `generateMetadata` can call it. REB-846 is the failure this avoids — a\n * helper reachable ONLY through a `'use client'` entry is a client reference on\n * the server, and calling it from a Server Component throws.\n *\n * The caller serialises the result; pair it with `@reblu/site-next`'s\n * `<JsonLd>`, which escapes the `</script>` boundary.\n */\n\n/** One question/answer pair — the `faq` block's `data.items[number]` shape. */\nexport interface FaqItem {\n  q: string\n  a: string\n}\n\nexport interface FaqPageJsonLd {\n  '@context': 'https://schema.org'\n  '@type': 'FAQPage'\n  mainEntity: Array<{\n    '@type': 'Question'\n    name: string\n    acceptedAnswer: { '@type': 'Answer'; text: string }\n  }>\n}\n\n/**\n * Questions and answers are PLAIN TEXT — authored in a Textarea and rendered by\n * `FaqAccordion` as escaped text. The structured data must say exactly what the\n * page shows, so nothing is stripped or decoded: `a < b`, `<b>` and `&amp;` are\n * content. Only whitespace is collapsed (the accordion keeps line breaks; the\n * visible words are identical). Escaping the `</script>` boundary is the\n * serialiser's job (`<JsonLd>`), not this function's.\n */\nfunction normaliseText(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim()\n}\n\n/**\n * Builds a schema.org `FAQPage` object from question/answer pairs.\n *\n * Items whose question or answer is blank are skipped, and the function\n * returns `null` when nothing is left — an empty `FAQPage` is invalid\n * structured data, so the caller simply renders no script.\n */\nexport function buildFaqPageJsonLd(items: readonly FaqItem[]): FaqPageJsonLd | null {\n  const mainEntity: FaqPageJsonLd['mainEntity'] = []\n  for (const item of items) {\n    const name = normaliseText(item.q)\n    const text = normaliseText(item.a)\n    if (!name || !text) continue\n    mainEntity.push({ '@type': 'Question', name, acceptedAnswer: { '@type': 'Answer', text } })\n  }\n  if (mainEntity.length === 0) return null\n  return { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity }\n}\n\n/**\n * Every `faq` block's items, in the order `PageBlocks` renders them (ascending\n * `order`, via the shared `sortBlocksByOrder`) — feed the result to\n * {@link buildFaqPageJsonLd}.\n */\nexport function collectFaqItems(blocks: readonly PageBlock[] | null | undefined): FaqItem[] {\n  if (!blocks) return []\n  return sortBlocksByOrder(blocks).flatMap((block) =>\n    block.blockType === 'faq' ? block.data.items : [],\n  )\n}\n"],"mappings":";AAMO,SAAS,kBAA+C,QAA2B;AACxF,SAAO,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACrD;;;ACiCA,SAAS,cAAc,OAAuB;AAC5C,SAAO,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACzC;AASO,SAAS,mBAAmB,OAAiD;AAClF,QAAM,aAA0C,CAAC;AACjD,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,cAAc,KAAK,CAAC;AACjC,UAAM,OAAO,cAAc,KAAK,CAAC;AACjC,QAAI,CAAC,QAAQ,CAAC,KAAM;AACpB,eAAW,KAAK,EAAE,SAAS,YAAY,MAAM,gBAAgB,EAAE,SAAS,UAAU,KAAK,EAAE,CAAC;AAAA,EAC5F;AACA,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,SAAO,EAAE,YAAY,sBAAsB,SAAS,WAAW,WAAW;AAC5E;AAOO,SAAS,gBAAgB,QAA4D;AAC1F,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,SAAO,kBAAkB,MAAM,EAAE;AAAA,IAAQ,CAAC,UACxC,MAAM,cAAc,QAAQ,MAAM,KAAK,QAAQ,CAAC;AAAA,EAClD;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-blocks",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Data-driven presentational organisms for Reblu SITEs (Collection, MarkdownRenderer, Treatment, Specialty, ProfileCard, ProductCard) — clean, token-driven, white-label.",
   "license": "Apache-2.0",
   "author": "Reblu — Adolfo Unturbe",
@@ -52,6 +52,16 @@
         "types": "./dist/client.d.cts",
         "default": "./dist/client.cjs"
       }
+    },
+    "./seo": {
+      "import": {
+        "types": "./dist/seo.d.ts",
+        "default": "./dist/seo.js"
+      },
+      "require": {
+        "types": "./dist/seo.d.cts",
+        "default": "./dist/seo.cjs"
+      }
     }
   },
   "publishConfig": {
@@ -60,8 +70,8 @@
   "dependencies": {
     "class-variance-authority": "^0.7.1",
     "html-react-parser": "5.2.17",
-    "@reblu/site-contracts": "^1.6.0",
-    "@reblu/site-ui": "^0.6.0"
+    "@reblu/site-contracts": "^1.8.0",
+    "@reblu/site-ui": "^0.7.0"
   },
   "peerDependencies": {
     "react": ">=19",
@@ -89,7 +99,8 @@
     "typescript": "^5.8.3",
     "unist-util-visit": "^5.1.0",
     "vitest": "^4.0.15",
-    "@reblu/config": "0.0.1"
+    "@reblu/config": "0.0.1",
+    "@reblu/site-client": "^5.3.1"
   },
   "scripts": {
     "build": "tsup",