@caelo-cms/shared 0.10.72 → 0.11.0

package/dist/lists/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/lists/address.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAiCnC,MAAM,GAAG,GAAG,aAAa,CAAC;AAC1B,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,GAAG;IACxC,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,GAAG;IACpD,UAAU,GAAG,YAAY,GAAG,GAAG;IAC/B,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CACjD,CAAC;AAEF,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,CAAe;IAChD,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,KAAK,UAAU;YACb,OAAO,YAAY,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QACtF,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7C,KAAK,eAAe;YAClB,OAAO,aAAa,CAAC,CAAC,UAAU,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;YACvB,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACX,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACZ,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;SAChB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lists/default-types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The list types every install starts with (epic #1107,
+ * `docs/lists.md` §3). They are seeded as STORED data by migration 0352
+ * and edited like any other type afterwards — these objects are the
+ * source the seed and the tests share, not a render-time fallback
+ * (CLAUDE.md §2).
+ */
+import type { ListTypeDef } from "./list-type.js";
+export declare const DEFAULT_LIST_TYPES: readonly ListTypeDef[];
+//# sourceMappingURL=default-types.d.ts.map

package/dist/lists/default-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-types.d.ts","sourceRoot":"","sources":["../../src/lists/default-types.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAyFpD,CAAC"}

package/dist/lists/default-types.js

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: MPL-2.0
+export const DEFAULT_LIST_TYPES = [
+    {
+        slug: "texts",
+        name: "Texts",
+        purpose: "A flat list of short texts inside one module: feature bullets, chips, steps.",
+        role: "content",
+        root: { allow: ["text"] },
+        nodes: {
+            text: {
+                label: "Text",
+                fields: [{ name: "text", label: "Text", type: "text", required: true }],
+            },
+        },
+    },
+    {
+        slug: "links",
+        name: "Links",
+        purpose: "A flat group of links: legal links, social links, a footer column.",
+        role: "content",
+        root: { allow: ["link"] },
+        nodes: {
+            link: {
+                label: "Link",
+                fields: [
+                    { name: "label", label: "Label", type: "text", required: true },
+                    { name: "link", label: "Link", type: "link", required: true },
+                ],
+                current_from: "link",
+            },
+        },
+    },
+    {
+        slug: "menu",
+        name: "Menu",
+        purpose: "Site navigation with up to three levels: header menu, footer menu, mobile menu. Use a custom type for mega menus with columns or teasers.",
+        role: "navigation",
+        root: { allow: ["entry"] },
+        nodes: {
+            entry: {
+                label: "Menu entry",
+                fields: [
+                    { name: "label", label: "Label", type: "text", required: true },
+                    { name: "link", label: "Link", type: "link" },
+                ],
+                children: { name: "children", allow: ["entry"] },
+                current_from: "link",
+            },
+        },
+        max_depth: 3,
+    },
+    {
+        slug: "categories",
+        name: "Categories",
+        purpose: "A category tree pages are assigned to: blog sections, product groups, doc areas.",
+        role: "vocabulary",
+        root: { allow: ["category"] },
+        nodes: {
+            category: {
+                label: "Category",
+                fields: [
+                    { name: "name", label: "Name", type: "text", required: true },
+                    { name: "slug", label: "Slug", type: "text", required: true },
+                    { name: "description", label: "Description", type: "richtext" },
+                    { name: "landing_page", label: "Landing page", type: "link" },
+                ],
+                children: { name: "children", allow: ["category"] },
+                current_from: "landing_page",
+            },
+        },
+        max_depth: 6,
+    },
+    {
+        slug: "tags",
+        name: "Tags",
+        purpose: "Flat keywords pages are tagged with, for filters, tag clouds and related content.",
+        role: "vocabulary",
+        root: { allow: ["tag"] },
+        nodes: {
+            tag: {
+                label: "Tag",
+                fields: [
+                    { name: "name", label: "Name", type: "text", required: true },
+                    { name: "slug", label: "Slug", type: "text", required: true },
+                    { name: "color", label: "Color", type: "text", maxLength: 9 },
+                ],
+            },
+        },
+    },
+];
+//# sourceMappingURL=default-types.js.map

package/dist/lists/default-types.js.map

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

package/dist/lists/fields.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The field system shared by list types (entry fields) and page types
+ * (page properties) — epic #1107, `docs/lists.md` §2.
+ *
+ * A list imposes no shape of its own: no entry must have a label or a
+ * link. The list type declares fields once, and every stored value is
+ * checked against that declaration at write time. One set of field types
+ * keeps list entries, page properties and future definitions speaking the
+ * same language, so the editor generates every form from the same code
+ * and the template engine renders every value the same way.
+ *
+ * `ext` carries attributes a plugin declared for fields (translation is
+ * the canonical case). Core stores and validates them against the
+ * plugin's schema but never interprets them — core has no locale concept
+ * (epic #380).
+ */
+import { z } from "zod";
+/** Every field type a definition may declare. */
+export declare const LIST_FIELD_TYPES: readonly ["text", "richtext", "link", "media", "select", "boolean", "number", "date", "icon", "module", "term"];
+export type ListFieldType = (typeof LIST_FIELD_TYPES)[number];
+/**
+ * Names the template engine binds itself inside a list entry, so a field
+ * or children list may not take them. Prefixes `is_`, `has_`, `count_`
+ * are reserved as a family (`is_<node>`, `has_<children>`,
+ * `count_<children>`).
+ */
+export declare const LIST_RESERVED_NAMES: ReadonlySet<string>;
+/** True when `name` is taken by the engine (see {@link LIST_RESERVED_NAMES}). */
+export declare function isReservedListName(name: string): boolean;
+export declare const listNameSchema: z.ZodString;
+/** Plugin-declared attributes keyed by plugin slug; validated by the host. */
+export declare const fieldExtSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** One field declaration. See `docs/lists.md` §2 for the value shapes. */
+export declare const fieldDefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"richtext">;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"link">;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"media">;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    options: z.ZodArray<z.ZodString>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"date">;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"icon">;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"module">;
+    accepts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"term">;
+    list: z.ZodString;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+    name: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    ext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>], "type">;
+export type FieldDef = z.infer<typeof fieldDefSchema>;
+/** Stored value of a `link` field. `href` may be an internal reference. */
+export declare const linkValueSchema: z.ZodObject<{
+    href: z.ZodString;
+    target: z.ZodOptional<z.ZodEnum<{
+        _self: "_self";
+        _blank: "_blank";
+    }>>;
+}, z.core.$strict>;
+export type LinkValue = z.infer<typeof linkValueSchema>;
+/** Stored value of a `module` field — the same ref shape as module fields. */
+export declare const embeddedModuleValueSchema: z.ZodObject<{
+    moduleId: z.ZodString;
+    contentInstanceId: z.ZodString;
+}, z.core.$strict>;
+/** `caelo:term/<listId>/<itemId>` */
+export declare const TERM_REF_RE: RegExp;
+/** One problem found while checking a definition or a value. */
+export interface ListIssue {
+    /** Where the problem is, e.g. `items[2].values.label` or `nodes.entry.fields[0]`. */
+    readonly path: string;
+    /** What is wrong and what to do about it, written for the AI caller. */
+    readonly message: string;
+}
+/**
+ * Validate one stored value against its field. Returns the issues found
+ * (empty = valid). `undefined` is "not set" and only an issue when the
+ * field is required.
+ */
+export declare function validateFieldValue(field: FieldDef, value: unknown, path: string): ListIssue[];
+/** Checks on one field declaration that Zod cannot express. */
+export declare function checkFieldDef(field: FieldDef, path: string): ListIssue[];
+//# sourceMappingURL=fields.d.ts.map

package/dist/lists/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/lists/fields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,iHAYnB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAUlD,CAAC;AAGH,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,eAAO,MAAM,cAAc,aAEsE,CAAC;AAIlG,8EAA8E;AAC9E,eAAO,MAAM,cAAc,wCAA0D,CAAC;AAiEtF,0EAA0E;AAC1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAYzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,2EAA2E;AAC3E,eAAO,MAAM,eAAe;;;;;;kBAKjB,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB;;;kBAE3B,CAAC;AAGZ,qCAAqC;AACrC,eAAO,MAAM,WAAW,QAAmD,CAAC;AAO5E,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA+D7F;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BxE"}

package/dist/lists/fields.js

@@ -0,0 +1,258 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * The field system shared by list types (entry fields) and page types
+ * (page properties) — epic #1107, `docs/lists.md` §2.
+ *
+ * A list imposes no shape of its own: no entry must have a label or a
+ * link. The list type declares fields once, and every stored value is
+ * checked against that declaration at write time. One set of field types
+ * keeps list entries, page properties and future definitions speaking the
+ * same language, so the editor generates every form from the same code
+ * and the template engine renders every value the same way.
+ *
+ * `ext` carries attributes a plugin declared for fields (translation is
+ * the canonical case). Core stores and validates them against the
+ * plugin's schema but never interprets them — core has no locale concept
+ * (epic #380).
+ */
+import { z } from "zod";
+/** Every field type a definition may declare. */
+export const LIST_FIELD_TYPES = [
+    "text",
+    "richtext",
+    "link",
+    "media",
+    "select",
+    "boolean",
+    "number",
+    "date",
+    "icon",
+    "module",
+    "term",
+];
+/**
+ * Names the template engine binds itself inside a list entry, so a field
+ * or children list may not take them. Prefixes `is_`, `has_`, `count_`
+ * are reserved as a family (`is_<node>`, `has_<children>`,
+ * `count_<children>`).
+ */
+export const LIST_RESERVED_NAMES = new Set([
+    "id",
+    "node",
+    "index",
+    "depth",
+    "first",
+    "last",
+    "items",
+    "page",
+    "recurse",
+]);
+const RESERVED_PREFIXES = ["is_", "has_", "count_"];
+/** True when `name` is taken by the engine (see {@link LIST_RESERVED_NAMES}). */
+export function isReservedListName(name) {
+    return LIST_RESERVED_NAMES.has(name) || RESERVED_PREFIXES.some((p) => name.startsWith(p));
+}
+export const listNameSchema = z
+    .string()
+    .regex(/^[a-z][a-z0-9_]{0,63}$/, "must be snake_case (lowercase letters, digits, underscores)");
+const fieldLabel = z.string().min(1).max(128);
+/** Plugin-declared attributes keyed by plugin slug; validated by the host. */
+export const fieldExtSchema = z.record(z.string().regex(/^[a-z0-9-]+$/), z.unknown());
+const base = {
+    name: listNameSchema,
+    label: fieldLabel,
+    required: z.boolean().optional(),
+    default: z.unknown().optional(),
+    ext: fieldExtSchema.optional(),
+};
+const textField = z
+    .object({
+    ...base,
+    type: z.literal("text"),
+    maxLength: z.number().int().min(1).max(2000).optional(),
+})
+    .strict();
+const richtextField = z
+    .object({
+    ...base,
+    type: z.literal("richtext"),
+    maxLength: z.number().int().min(1).max(20000).optional(),
+})
+    .strict();
+const linkField = z.object({ ...base, type: z.literal("link") }).strict();
+const mediaField = z.object({ ...base, type: z.literal("media") }).strict();
+const selectField = z
+    .object({
+    ...base,
+    type: z.literal("select"),
+    options: z.array(listNameSchema).min(1).max(64),
+})
+    .strict();
+const booleanField = z.object({ ...base, type: z.literal("boolean") }).strict();
+const numberField = z
+    .object({
+    ...base,
+    type: z.literal("number"),
+    min: z.number().optional(),
+    max: z.number().optional(),
+})
+    .strict();
+const dateField = z.object({ ...base, type: z.literal("date") }).strict();
+const iconField = z.object({ ...base, type: z.literal("icon") }).strict();
+const moduleField = z
+    .object({
+    ...base,
+    type: z.literal("module"),
+    /** Stable module `type`s that may fill the slot; absent = any module. */
+    accepts: z
+        .array(z.string().regex(/^[a-z0-9-]+$/))
+        .max(32)
+        .optional(),
+})
+    .strict();
+const termField = z
+    .object({
+    ...base,
+    type: z.literal("term"),
+    /** Slug of the vocabulary list the terms come from. */
+    list: z.string().regex(/^[a-z0-9-]+$/),
+    multiple: z.boolean().optional(),
+})
+    .strict();
+/** One field declaration. See `docs/lists.md` §2 for the value shapes. */
+export const fieldDefSchema = z.discriminatedUnion("type", [
+    textField,
+    richtextField,
+    linkField,
+    mediaField,
+    selectField,
+    booleanField,
+    numberField,
+    dateField,
+    iconField,
+    moduleField,
+    termField,
+]);
+/** Stored value of a `link` field. `href` may be an internal reference. */
+export const linkValueSchema = z
+    .object({
+    href: z.string().min(1).max(2000),
+    target: z.enum(["_self", "_blank"]).optional(),
+})
+    .strict();
+/** Stored value of a `module` field — the same ref shape as module fields. */
+export const embeddedModuleValueSchema = z
+    .object({ moduleId: z.string().uuid(), contentInstanceId: z.string().uuid() })
+    .strict();
+const MEDIA_REF_RE = /^caelo:media\/[0-9a-f-]{36}(?:\/[a-z0-9-]+)?$/;
+/** `caelo:term/<listId>/<itemId>` */
+export const TERM_REF_RE = /^caelo:term\/([0-9a-f-]{36})\/([0-9a-f-]{36})$/;
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const ICON_RE = /^[a-z0-9-]{1,64}$/;
+const DEFAULT_TEXT_MAX = 500;
+const DEFAULT_RICHTEXT_MAX = 5000;
+/**
+ * Validate one stored value against its field. Returns the issues found
+ * (empty = valid). `undefined` is "not set" and only an issue when the
+ * field is required.
+ */
+export function validateFieldValue(field, value, path) {
+    if (value === undefined || value === null) {
+        return field.required
+            ? [{ path, message: `"${field.name}" is required (${field.type}) — set a value.` }]
+            : [];
+    }
+    const bad = (expected) => [
+        { path, message: `"${field.name}" must be ${expected}, got ${describe(value)}.` },
+    ];
+    switch (field.type) {
+        case "text":
+        case "richtext": {
+            if (typeof value !== "string")
+                return bad("a string");
+            const max = field.maxLength ?? (field.type === "text" ? DEFAULT_TEXT_MAX : DEFAULT_RICHTEXT_MAX);
+            if (value.length > max)
+                return bad(`at most ${max} characters`);
+            if (field.required && value.trim().length === 0)
+                return bad("non-empty text");
+            return [];
+        }
+        case "link": {
+            const r = linkValueSchema.safeParse(value);
+            return r.success ? [] : bad('{ href, target? } (href like "/about" or "https://…")');
+        }
+        case "media":
+            return typeof value === "string" && MEDIA_REF_RE.test(value)
+                ? []
+                : bad("a media reference (caelo:media/<id>) — pick an asset from find_media");
+        case "select":
+            return typeof value === "string" && field.options.includes(value)
+                ? []
+                : bad(`one of ${field.options.map((o) => `"${o}"`).join(", ")}`);
+        case "boolean":
+            return typeof value === "boolean" ? [] : bad("true or false");
+        case "number": {
+            if (typeof value !== "number" || !Number.isFinite(value))
+                return bad("a number");
+            if (field.min !== undefined && value < field.min)
+                return bad(`≥ ${field.min}`);
+            if (field.max !== undefined && value > field.max)
+                return bad(`≤ ${field.max}`);
+            return [];
+        }
+        case "date":
+            return typeof value === "string" &&
+                ISO_DATE_RE.test(value) &&
+                !Number.isNaN(Date.parse(value))
+                ? []
+                : bad("an ISO date YYYY-MM-DD");
+        case "icon":
+            return typeof value === "string" && ICON_RE.test(value) ? [] : bad("an icon name");
+        case "module":
+            return embeddedModuleValueSchema.safeParse(value).success
+                ? []
+                : bad("{ moduleId, contentInstanceId }");
+        case "term": {
+            if (!Array.isArray(value) ||
+                value.some((v) => typeof v !== "string" || !TERM_REF_RE.test(v))) {
+                return bad("an array of term references (caelo:term/<listId>/<itemId>)");
+            }
+            if (!field.multiple && value.length > 1)
+                return bad("at most one term (multiple is off)");
+            if (field.required && value.length === 0)
+                return bad("at least one term");
+            return [];
+        }
+    }
+}
+/** Checks on one field declaration that Zod cannot express. */
+export function checkFieldDef(field, path) {
+    const issues = [];
+    if (isReservedListName(field.name)) {
+        issues.push({
+            path,
+            message: `field name "${field.name}" is reserved by the template engine — pick another name.`,
+        });
+    }
+    if (field.default !== undefined) {
+        for (const i of validateFieldValue({ ...field, required: false }, field.default, `${path}.default`)) {
+            issues.push(i);
+        }
+    }
+    if (field.type === "number" &&
+        field.min !== undefined &&
+        field.max !== undefined &&
+        field.min > field.max) {
+        issues.push({ path, message: "min is greater than max." });
+    }
+    return issues;
+}
+function describe(value) {
+    if (Array.isArray(value))
+        return "an array";
+    if (value === null)
+        return "null";
+    const s = typeof value === "string" ? JSON.stringify(value.slice(0, 40)) : typeof value;
+    return s;
+}
+//# sourceMappingURL=fields.js.map

package/dist/lists/fields.js.map

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

package/dist/lists/index.d.ts

@@ -0,0 +1,14 @@
+/** Lists, list types, page types — epic #1107, see `docs/lists.md`. */
+export * from "./address.js";
+export * from "./default-types.js";
+export * from "./fields.js";
+export * from "./item-attr.js";
+export * from "./items.js";
+export * from "./list-type.js";
+export * from "./page-type.js";
+export * from "./refs.js";
+export * from "./render-data.js";
+export * from "./render-deps.js";
+export * from "./resolve.js";
+export * from "./scope.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lists/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lists/index.ts"],"names":[],"mappings":"AAEA,uEAAuE;AAEvE,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/lists/index.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: MPL-2.0
+/** Lists, list types, page types — epic #1107, see `docs/lists.md`. */
+export * from "./address.js";
+export * from "./default-types.js";
+export * from "./fields.js";
+export * from "./item-attr.js";
+export * from "./items.js";
+export * from "./list-type.js";
+export * from "./page-type.js";
+export * from "./refs.js";
+export * from "./render-data.js";
+export * from "./render-deps.js";
+export * from "./resolve.js";
+export * from "./scope.js";
+//# sourceMappingURL=index.js.map

package/dist/lists/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lists/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,uEAAuE;AAEvE,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/lists/item-attr.d.ts

@@ -0,0 +1,26 @@
+/** Every form a `data-caelo-list-item` value takes. */
+export declare const LIST_ITEM_ATTR_RE: RegExp;
+/** A parsed `data-caelo-list-item` value. */
+export type ListItemAttr = 
+/** An entry of a shared list. */
+{
+    readonly kind: "shared";
+    readonly listId: string;
+    readonly itemId: string;
+}
+/** An entry of a module's own list, stored in a content instance. */
+ | {
+    readonly kind: "instance";
+    readonly contentInstanceId: string;
+    readonly field: string;
+    readonly itemId: string;
+}
+/** An entry of a module field's default list (site chrome without stored content). */
+ | {
+    readonly kind: "local";
+    readonly field: string;
+    readonly itemId: string;
+};
+/** Parse a `data-caelo-list-item` value; null when it is not one. */
+export declare function parseListItemAttr(value: string): ListItemAttr | null;
+//# sourceMappingURL=item-attr.d.ts.map

package/dist/lists/item-attr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-attr.d.ts","sourceRoot":"","sources":["../../src/lists/item-attr.ts"],"names":[],"mappings":"AAaA,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,QAE7B,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,YAAY;AACtB,iCAAiC;AAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/E,qEAAqE;GACnE;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACH,sFAAsF;GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAepE"}

package/dist/lists/item-attr.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * The `data-caelo-list-item` value the engine stamps on a rendered stored
+ * list entry (epic #1107, `docs/lists.md` §13), parsed. Live Edit sends it
+ * with a click-to-chat reference so the chip names the list entry, not the
+ * whole module, and the AI edits that entry with the list tools (shared
+ * list) or the content tools (a module's own list).
+ */
+const UUID = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}";
+const NAME = "[a-z][a-z0-9_]{0,63}";
+/** Every form a `data-caelo-list-item` value takes. */
+export const LIST_ITEM_ATTR_RE = new RegExp(`^(?:${UUID}/${UUID}|instance/${UUID}/${NAME}/${UUID}|local/${NAME}/${UUID})$`);
+/** Parse a `data-caelo-list-item` value; null when it is not one. */
+export function parseListItemAttr(value) {
+    if (!LIST_ITEM_ATTR_RE.test(value))
+        return null;
+    const parts = value.split("/");
+    if (parts[0] === "instance") {
+        return {
+            kind: "instance",
+            contentInstanceId: parts[1],
+            field: parts[2],
+            itemId: parts[3],
+        };
+    }
+    if (parts[0] === "local") {
+        return { kind: "local", field: parts[1], itemId: parts[2] };
+    }
+    return { kind: "shared", listId: parts[0], itemId: parts[1] };
+}
+//# sourceMappingURL=item-attr.js.map

package/dist/lists/item-attr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-attr.js","sourceRoot":"","sources":["../../src/lists/item-attr.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;GAMG;AAEH,MAAM,IAAI,GAAG,8DAA8D,CAAC;AAC5E,MAAM,IAAI,GAAG,sBAAsB,CAAC;AAEpC,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,MAAM,CACzC,OAAO,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI,IAAI,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,IAAI,CAC/E,CAAC;AAgBF,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAW;YACrC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAW;YACzB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAW;SAC3B,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,CAAC;AACpF,CAAC"}