@caelo-cms/shared 0.11.0 → 0.11.1

package/src/template-engine-lists.test.ts

@@ -551,3 +551,58 @@ describe("lists — loud markers", () => {
     expect(r.missingSlots).toEqual(["list-context-unavailable:bullets"]);
   });
 });
+
+describe("lists — breadcrumbs and {{site_text.*}} (#1142)", () => {
+  const SITE_TEXTS = "00000000-0000-4000-8000-0000000000e1";
+  const withTexts = (pageId: string, texts: Record<string, string>): ListPageContext =>
+    createListRenderContext(
+      fixtureData({
+        lists: [
+          {
+            id: SITE_TEXTS,
+            slug: "site-texts",
+            name: "Site texts",
+            typeSlug: "site-texts",
+            items: Object.entries(texts).map(([key, text], i) => ({
+              id: uuid(900 + i),
+              node: "text",
+              values: { key, text },
+            })),
+          },
+        ],
+      }),
+    ).forPage(pageId, { linkResolver: fixtureLinkIndex().forPage(pageId) });
+  const CRUMBS: TemplateField = {
+    name: "crumbs",
+    kind: "list",
+    listType: "links",
+    bind: "source",
+    source: { kind: "system", name: "breadcrumbs" },
+  };
+  const NAV =
+    '<nav aria-label="{{site_text.breadcrumb_label}}"><ol>{{#crumbs}}<li>{{#is_current}}<span aria-current="page">{{short_title}}</span>{{/is_current}}{{^is_current}}<a href="{{link}}">{{short_title}}</a>{{/is_current}}</li>{{/crumbs}}</ol></nav>';
+
+  it("renders a trail home → current with the aria-label from the site texts", () => {
+    const r = render(NAV, [CRUMBS], {}, withTexts(PAGE.team, { breadcrumb_label: "Breadcrumb" }));
+    expect(r.html).toBe(
+      '<nav aria-label="Breadcrumb"><ol><li><a href="/">Home</a></li><li><a href="/about/">About</a></li><li><span aria-current="page">Team</span></li></ol></nav>',
+    );
+    expect(r.missingSlots).toEqual([]);
+  });
+
+  it("a missing site text stays loud", () => {
+    const r = render(
+      '<nav aria-label="{{site_text.breadcrumb_label}}"></nav>',
+      [],
+      {},
+      withTexts(PAGE.team, {}),
+    );
+    expect(r.html).toBe('<nav aria-label="{{site_text.breadcrumb_label}}"></nav>');
+    expect(r.missingSlots).toContain("site-text-missing:breadcrumb_label");
+  });
+
+  it("is loud without a list context", () => {
+    const r = render("{{site_text.breadcrumb_label}}", [], {}, null);
+    expect(r.missingSlots).toContain("list-context-unavailable:site_text");
+  });
+});

package/src/template-sections.ts

@@ -68,6 +68,17 @@ const TAG_RE = /\{\{\s*([#^/>]\s*)?([a-zA-Z][a-zA-Z0-9_]*(?:\.[a-zA-Z0-9_]+)*)\s
 const SECTION_NAME_RE = /^[a-z][a-z0-9_]*(?:\.[a-z0-9_]+)*$/;
 const DOT_RE = /\{\{\s*\.\s*\}\}/g;
 
+/** Dotted heads the list context answers, not an entry: `{{page.*}}`, `{{site_text.*}}`. */
+const CONTEXT_HEADS = new Set(["page", "site_text"]);
+
+function contextHead(name: string): string {
+  return (name.split(".")[0] ?? "").toLowerCase();
+}
+
+function isContextHead(name: string): boolean {
+  return CONTEXT_HEADS.has(contextHead(name));
+}
+
 function tokenize(html: string): Token[] {
   const out: Token[] = [];
   TAG_RE.lastIndex = 0;
@@ -201,6 +212,9 @@ class SectionRenderer {
       v = this.env.lists?.pageScope() ?? undefined;
       if (v === undefined)
         return parts.length > 1 || st.chain.length > 0 ? { missing: true } : undefined;
+    } else if (head === "site_text") {
+      v = this.env.lists?.siteTextScope();
+      if (v === undefined) return { missing: true };
     } else {
       for (let k = st.chain.length - 1; k >= 0 && v === undefined; k -= 1) {
         v = st.chain[k]?.entry.get(head);
@@ -251,8 +265,8 @@ class SectionRenderer {
     }
     if ("missing" in v) {
       const marker =
-        t.name.split(".")[0]?.toLowerCase() === "page" && this.env.lists === undefined
-          ? "list-context-unavailable:page"
+        isContextHead(t.name) && this.env.lists === undefined
+          ? `list-context-unavailable:${contextHead(t.name)}`
           : this.notDeclared(t.name, st);
       return this.raw(source, marker);
     }
@@ -321,8 +335,8 @@ class SectionRenderer {
     if (v !== undefined) {
       if ("missing" in v) {
         const marker =
-          t.name.split(".")[0] === "page" && this.env.lists === undefined
-            ? "list-context-unavailable:page"
+          isContextHead(t.name) && this.env.lists === undefined
+            ? `list-context-unavailable:${contextHead(t.name)}`
             : this.notDeclared(t.name, st);
         return this.raw(source, marker);
       }

package/src/version.ts

@@ -22,7 +22,7 @@
  * follow standard SemVer.
  */
 
-export const CAELO_VERSION = "0.11.0";
+export const CAELO_VERSION = "0.11.1";
 
 /**
  * Deprecated alias for back-compat — early P17 work spelled this