@caelo-cms/shared 0.10.72 → 0.11.0

package/src/structured-sets.ts

@@ -1,114 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-
-/**
- * P6.7.5 — typed schemas for the `structured_sets` table.
- *
- * One database table holds N kinds of named lists (nav-menus, taxonomies,
- * theme tokens, tag lists, footer link blocks, ...). The `kind`
- * discriminator drives both the Zod validator at the Query API layer
- * and the renderer that turns the items into HTML at preview / deploy.
- *
- * Adding a new kind: add a Zod schema below, add it to the
- * `structuredSetItem` discriminated union, add a renderer in
- * `packages/shared/src/structured-set-renderer.ts`. No DB migration
- * required — the table already accepts arbitrary `kind` text.
- *
- * Item shapes are deliberately **structured data**, not HTML strings.
- * That's what makes `change_page_slug` able to retarget every menu
- * link automatically: walk the JSON, swap `href` matches.
- */
-
-import { z } from "zod";
-
-/** Recursive nav menu — supports arbitrary submenu nesting. */
-export const navMenuItem: z.ZodType<{
-  label: string;
-  href: string;
-  target?: "_self" | "_blank";
-  children?: { label: string; href: string }[];
-  /** When set, the renderer delegates this slot to the named ad plugin. */
-  adSlotId?: string;
-}> = z.lazy(() =>
-  z
-    .object({
-      label: z.string().min(1).max(120),
-      href: z.string().min(1).max(500),
-      target: z.enum(["_self", "_blank"]).optional(),
-      children: z.array(navMenuItem).optional(),
-      adSlotId: z.string().min(1).max(100).optional(),
-    })
-    .strict(),
-);
-
-/** Tree-shaped category list. Used by typed-content / tag pages (P12A). */
-export const taxonomyItem = z
-  .object({
-    slug: z.string().min(1).max(120),
-    displayName: z.string().min(1).max(200),
-    parentSlug: z.string().min(1).max(120).optional(),
-    description: z.string().max(2000).optional(),
-  })
-  .strict();
-
-/** Flat tag — used by post taxonomies, content filtering. */
-export const tagItem = z
-  .object({
-    slug: z
-      .string()
-      .min(1)
-      .max(120)
-      .regex(/^[a-z0-9-]+$/, "lowercase letters/digits/hyphens"),
-    displayName: z.string().min(1).max(200),
-    color: z
-      .string()
-      .regex(/^#[0-9a-fA-F]{3,8}$/, "hex color")
-      .optional(),
-  })
-  .strict();
-
-/** Footer "legal" / related-resources block. */
-export const linkListItem = z
-  .object({
-    label: z.string().min(1).max(200),
-    href: z.string().min(1).max(500),
-    description: z.string().max(500).optional(),
-  })
-  .strict();
-
-/** Discriminated kind → items array. The Query API op picks the
- *  validator at runtime by reading `kind` first.
- *
- *  v0.11.0 (#45) — `theme` is no longer a structured-set kind. The
- *  theme primitive moved to its own `themes` table with DTCG-shaped
- *  jsonb tokens; see `themes.ts` + `theme-render.ts`. */
-export const structuredSetKind = z.enum(["nav-menu", "taxonomy", "tags", "link-list"]);
-export type StructuredSetKind = z.infer<typeof structuredSetKind>;
-
-/** Validate `items` against the right schema for `kind`. Throws a
- *  ZodError on mismatch — callers wrap and return `Err(ValidationFailed)`. */
-export function validateStructuredSetItems(kind: StructuredSetKind, items: unknown): unknown[] {
-  if (!Array.isArray(items)) {
-    throw new z.ZodError([
-      {
-        code: "custom",
-        path: ["items"],
-        message: "items must be an array",
-      },
-    ]);
-  }
-  switch (kind) {
-    case "nav-menu":
-      return items.map((it) => navMenuItem.parse(it));
-    case "taxonomy":
-      return items.map((it) => taxonomyItem.parse(it));
-    case "tags":
-      return items.map((it) => tagItem.parse(it));
-    case "link-list":
-      return items.map((it) => linkListItem.parse(it));
-  }
-}
-
-export type NavMenuItem = z.infer<typeof navMenuItem>;
-export type TaxonomyItem = z.infer<typeof taxonomyItem>;
-export type TagItem = z.infer<typeof tagItem>;
-export type LinkListItem = z.infer<typeof linkListItem>;

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

@@ -1,90 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-
-/**
- * Plugin data lists in the template engine: `{{#name}}…{{/name}}` over
- * data a plugin supplies per page, with the module owning the markup.
- *
- * The load-bearing case is the third one. Plugin activation is a hard
- * state, so a module written while a plugin ran keeps its
- * `{{#language_links}}` after the plugin is switched off. Rendering
- * that as an empty string would be a silent fallback (CLAUDE.md §2) and
- * would read to the operator as "the switcher vanished for no reason".
- * It has to stay visible AND say which plugin to turn back on.
- */
-
-import { describe, expect, it } from "bun:test";
-import { renderTemplate } from "./template-engine.js";
-
-const SWITCHER =
-  '<nav>{{#language_links}}<a href="{{href}}">{{label}}</a>{{/language_links}}</nav>';
-
-describe("template engine — plugin data lists", () => {
-  it("iterates a plugin list with the module's own markup", () => {
-    const r = renderTemplate({
-      html: SWITCHER,
-      fields: [],
-      dataLists: {
-        language_links: [
-          { href: "/", label: "English", locale: "en" },
-          { href: "/de", label: "Deutsch", locale: "de" },
-        ],
-      },
-    });
-    expect(r.html).toBe('<nav><a href="/">English</a><a href="/de">Deutsch</a></nav>');
-    expect(r.missingSlots).toEqual([]);
-  });
-
-  it("renders nothing for an empty list — that is data, not breakage", () => {
-    // A page with no published translations legitimately has no links.
-    const r = renderTemplate({
-      html: SWITCHER,
-      fields: [],
-      dataLists: { language_links: [] },
-    });
-    expect(r.html).toBe("<nav></nav>");
-    expect(r.missingSlots).toEqual([]);
-  });
-
-  it("stays loud and names the plugin when its plugin is switched off", () => {
-    const r = renderTemplate({
-      html: SWITCHER,
-      fields: [],
-      dormantDataLists: { language_links: "international-site" },
-    });
-    // Loud-raw: the section survives in the output rather than
-    // silently collapsing.
-    expect(r.html).toContain("{{#language_links}}");
-    expect(r.missingSlots).toContain(
-      "plugin-list-unavailable:language_links plugin=international-site",
-    );
-  });
-
-  it("keeps an unknown name a plain undeclared field", () => {
-    // No plugin claims it — this really is a typo, and must not be
-    // reported as a deactivated plugin.
-    const r = renderTemplate({ html: "<p>{{#nope}}x{{/nope}}</p>", fields: [] });
-    expect(r.missingSlots).toContain("field-not-declared:nope");
-  });
-
-  it("lets a module's own field win over a plugin list of the same name", () => {
-    // Module fields are resolved first by construction, so a plugin can
-    // never shadow content the author declared.
-    const r = renderTemplate({
-      html: "<ul>{{#items}}<li>{{label}}</li>{{/items}}</ul>",
-      fields: [{ name: "items", kind: "link-list" }],
-      contentValues: { items: [{ label: "authored", href: "/a" }] },
-      dataLists: { items: [{ label: "from-plugin" }] },
-    });
-    expect(r.html).toContain("authored");
-    expect(r.html).not.toContain("from-plugin");
-  });
-
-  it("leaves a key the items do not carry raw", () => {
-    const r = renderTemplate({
-      html: "{{#l}}<a href={{href}}>{{missing_key}}</a>{{/l}}",
-      fields: [],
-      dataLists: { l: [{ href: "/x" }] },
-    });
-    expect(r.html).toContain("{{missing_key}}");
-  });
-});