@caelo-cms/shared 0.11.2 → 0.11.4

package/src/template-engine.ts

@@ -85,6 +85,7 @@ import Mustache from "mustache";
 import { MODULE_FIELD_SECTION_KINDS, type ModuleFieldKind } from "./content.js";
 import { type LinkResolver, resolveLinkRefsInHtml } from "./link-refs.js";
 import { type SourceDef, sourceDefSchema } from "./lists/list-type.js";
+import type { ListPaginationSettings } from "./lists/pagination.js";
 import type { ListHolder, ListPageContext } from "./lists/resolve.js";
 import { stripCdataGuards } from "./strip-cdata.js";
 import { renderSections } from "./template-sections.js";
@@ -110,20 +111,21 @@ export interface TemplateField {
   readonly bind?: "local" | "shared" | "source";
   readonly list?: string;
   readonly source?: SourceDef;
+  /** #1257 — a paginated source field. */
+  readonly paginate?: ListPaginationSettings;
 }
 
 /**
- * Parse a stored `modules.fields` jsonb (array or JSON text) into the
+ * Parse a stored `modules.fields` jsonb (the parsed array) into the
  * fields the engine renders with: name, kind (absent = `text`), default,
  * and a `list` field's binding. A typo'd kind passes through as is — the
  * engine reports it loudly (kind-mismatch) instead of the parser hiding
  * it. Entries without a string name are skipped; they cannot be rendered.
  */
 export function templateFieldsFromJson(raw: unknown): TemplateField[] {
-  const parsed = typeof raw === "string" ? (JSON.parse(raw) as unknown) : raw;
-  if (!Array.isArray(parsed)) return [];
+  if (!Array.isArray(raw)) return [];
   const out: TemplateField[] = [];
-  for (const f of parsed) {
+  for (const f of raw) {
     if (!f || typeof f !== "object") continue;
     const o = f as Record<string, unknown>;
     if (typeof o.name !== "string") continue;
@@ -137,6 +139,9 @@ export function templateFieldsFromJson(raw: unknown): TemplateField[] {
       // A source that fails its schema stays absent: the resolver then
       // reports `list-malformed:<field>[source]` instead of guessing.
       ...(sourceDefSchema.safeParse(o.source).success ? { source: o.source as SourceDef } : {}),
+      // Passed as stored: the resolver validates it and reports a
+      // malformed one as `list-malformed:<field>[paginate]`.
+      ...(o.paginate !== undefined ? { paginate: o.paginate as ListPaginationSettings } : {}),
     });
   }
   return out;

package/src/template-sections.ts

@@ -407,6 +407,7 @@ class SectionRenderer {
         ...(field.list !== undefined ? { list: field.list } : {}),
         ...(field.source !== undefined ? { source: field.source } : {}),
         ...(field.default !== undefined ? { default: field.default } : {}),
+        ...(field.paginate !== undefined ? { paginate: field.paginate } : {}),
       };
       const value = Object.hasOwn(env.values, name) ? env.values[name] : undefined;
       const res = env.lists.resolveField(spec, value, env.holder);

package/src/version.ts

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