@caelo-cms/shared 0.10.71 → 0.11.0

package/dist/structured-sets.js

@@ -1,92 +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.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"]);
-/** Validate `items` against the right schema for `kind`. Throws a
- *  ZodError on mismatch — callers wrap and return `Err(ValidationFailed)`. */
-export function validateStructuredSetItems(kind, items) {
-    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));
-    }
-}
-//# sourceMappingURL=structured-sets.js.map

package/dist/structured-sets.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"structured-sets.js","sourceRoot":"","sources":["../src/structured-sets.ts"],"names":[],"mappings":"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"}

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}}");
-  });
-});