@pantheon-systems/puck-css 0.4.0

package/dist/data/remote-datasources/user-remote-datasource-store.js

@@ -0,0 +1,125 @@
+import { remoteDatasourceDefStore } from "../dal";
+import { getPageEditorMetaRow, setPageEditorMetaRow, } from "../page-editor-meta";
+const RESERVED_IDS = new Set(["urlParams"]);
+const ID_REGEX = /^[a-z][a-z0-9_]*$/;
+function cleanField(field) {
+    if (!field || typeof field !== "object" || Array.isArray(field))
+        return null;
+    const f = field;
+    const path = typeof f.path === "string" ? f.path.trim() : "";
+    const description = typeof f.description === "string" ? f.description.trim() : "";
+    if (!path || !description)
+        return null;
+    return { path, description };
+}
+const SAFE_IDENTIFIER_KEY_REGEX = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+function cleanStringRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {};
+    }
+    const src = value;
+    const out = Object.create(null);
+    for (const k of Object.keys(src)) {
+        if (!Object.prototype.hasOwnProperty.call(src, k))
+            continue;
+        const key = String(k).trim();
+        if (!SAFE_IDENTIFIER_KEY_REGEX.test(key))
+            continue;
+        const val = typeof src[k] === "string" ? src[k].trim() : "";
+        if (key && val) {
+            out[key] = val;
+        }
+    }
+    return out;
+}
+export function normalizeRemoteDatasourceDefinition(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return null;
+    }
+    const row = input;
+    const id = typeof row.id === "string" ? row.id.trim() : "";
+    const label = typeof row.label === "string" ? row.label.trim() : "";
+    const description = typeof row.description === "string" ? row.description.trim() : "";
+    const urlTemplate = typeof row.urlTemplate === "string" ? row.urlTemplate.trim() : "";
+    const fieldsRaw = Array.isArray(row.fields) ? row.fields : [];
+    const fields = fieldsRaw.map(cleanField).filter((f) => !!f);
+    const headers = cleanStringRecord(row.headers);
+    const query = cleanStringRecord(row.query);
+    if (!ID_REGEX.test(id) || !label || !description || !urlTemplate || fields.length === 0) {
+        return null;
+    }
+    if (RESERVED_IDS.has(id))
+        return null;
+    const out = {
+        id,
+        label,
+        description,
+        urlTemplate,
+        fields,
+    };
+    if (Object.keys(headers).length > 0)
+        out.headers = headers;
+    if (Object.keys(query).length > 0)
+        out.query = query;
+    return out;
+}
+function readNormalizedGlobalList() {
+    return remoteDatasourceDefStore.list()
+        .map((row) => normalizeRemoteDatasourceDefinition(row))
+        .filter((d) => !!d);
+}
+export function listGlobalRemoteDatasources() {
+    return readNormalizedGlobalList();
+}
+export function upsertGlobalRemoteDatasource(def) {
+    const next = readNormalizedGlobalList().filter((d) => d.id !== def.id);
+    next.push(def);
+    next.sort((a, b) => a.id.localeCompare(b.id));
+    remoteDatasourceDefStore.save(next);
+}
+export function deleteGlobalRemoteDatasource(id) {
+    const next = readNormalizedGlobalList().filter((d) => d.id !== id);
+    remoteDatasourceDefStore.save(next);
+}
+export function listPageRemoteDatasources(path) {
+    const row = getPageEditorMetaRow(path);
+    const list = Array.isArray(row.datasources) ? row.datasources : [];
+    return list
+        .map((d) => normalizeRemoteDatasourceDefinition(d))
+        .filter((d) => !!d);
+}
+export function upsertPageRemoteDatasource(path, def) {
+    const row = getPageEditorMetaRow(path);
+    const list = Array.isArray(row.datasources) ? row.datasources : [];
+    const normalized = list
+        .map((d) => normalizeRemoteDatasourceDefinition(d))
+        .filter((d) => !!d)
+        .filter((d) => d.id !== def.id);
+    normalized.push(def);
+    normalized.sort((a, b) => a.id.localeCompare(b.id));
+    setPageEditorMetaRow(path, { ...row, datasources: normalized });
+}
+export function deletePageRemoteDatasource(path, id) {
+    const row = getPageEditorMetaRow(path);
+    const list = Array.isArray(row.datasources) ? row.datasources : [];
+    const normalized = list
+        .map((d) => normalizeRemoteDatasourceDefinition(d))
+        .filter((d) => !!d)
+        .filter((d) => d.id !== id);
+    setPageEditorMetaRow(path, { ...row, datasources: normalized });
+}
+export function listRemoteDatasourcesForPage(path) {
+    return {
+        global: listGlobalRemoteDatasources(),
+        page: listPageRemoteDatasources(path),
+    };
+}
+export function idConflictsForRemoteDatasourceScope(scope, id, path) {
+    if (RESERVED_IDS.has(id))
+        return true;
+    if (scope === "global") {
+        return listPageRemoteDatasources(path).some((d) => d.id === id);
+    }
+    return listGlobalRemoteDatasources().some((d) => d.id === id);
+}
+//# sourceMappingURL=user-remote-datasource-store.js.map

package/dist/data/remote-datasources/user-remote-datasource-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-remote-datasource-store.js","sourceRoot":"","sources":["../../../src/data/remote-datasources/user-remote-datasource-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAErC,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAE7D,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,GAAG,GAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAAE,SAAS;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACnD,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACf,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,KAAc;IAEd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA8C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,GAAG,GAAuC;QAC9C,EAAE;QACF,KAAK;QACL,WAAW;QACX,WAAW;QACX,MAAM;KACP,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO,wBAAwB,CAAC,IAAI,EAAE;SACnC,GAAG,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,mCAAmC,CAAC,GAAG,CAAC,CAAC;SAC/D,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,wBAAwB,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAAuC;IAClF,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,EAAU;IACrD,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,GAAuC;IAEvC,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,oBAAoB,CAAC,IAAI,EAAE,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,EAAU;IACjE,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9B,oBAAoB,CAAC,IAAI,EAAE,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAY;IAIvD,OAAO;QACL,MAAM,EAAE,2BAA2B,EAAE;QACrC,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,KAA4B,EAC5B,EAAU,EACV,IAAY;IAEZ,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,2BAA2B,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/data/remote-datasources/user-remote-datasource-types.d.ts

@@ -0,0 +1,15 @@
+export type RemoteDatasourceFieldDocInput = {
+    path: string;
+    description: string;
+};
+export type HttpJsonRemoteDatasourceDefinition = {
+    id: string;
+    label: string;
+    description: string;
+    urlTemplate: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    fields: RemoteDatasourceFieldDocInput[];
+};
+export type RemoteDatasourceScope = "global" | "page";
+//# sourceMappingURL=user-remote-datasource-types.d.ts.map

package/dist/data/remote-datasources/user-remote-datasource-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-remote-datasource-types.d.ts","sourceRoot":"","sources":["../../../src/data/remote-datasources/user-remote-datasource-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,6BAA6B,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,CAAC"}

package/dist/data/remote-datasources/user-remote-datasource-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user-remote-datasource-types.js.map

package/dist/data/remote-datasources/user-remote-datasource-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-remote-datasource-types.js","sourceRoot":"","sources":["../../../src/data/remote-datasources/user-remote-datasource-types.ts"],"names":[],"mappings":""}

package/dist/data/resolve-data-templates.d.ts

@@ -0,0 +1,12 @@
+import type { Data } from "@puckeditor/core";
+import type { RemoteDatasourceContext } from "./remote-datasources/loader";
+/**
+ * Replace `{{ source.key }}` / `{{ source.nested.key }}` using datasource context.
+ * Unknown sources or missing values become empty strings.
+ */
+export declare function resolveStringTemplates(input: string, context: RemoteDatasourceContext): Promise<string>;
+/**
+ * Deep-walk Puck `Data`: interpolate all string props in `root`, `content`, and `zones`.
+ */
+export declare function resolveDataTemplates<T extends Partial<Data>>(data: T, context: RemoteDatasourceContext): Promise<T>;
+//# sourceMappingURL=resolve-data-templates.d.ts.map

package/dist/data/resolve-data-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-data-templates.d.ts","sourceRoot":"","sources":["../../src/data/resolve-data-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AA+L3E;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AA0ED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,CAAC,EAChE,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAiCZ"}

package/dist/data/resolve-data-templates.js

@@ -0,0 +1,286 @@
+import jsep from "jsep";
+import { resolveCrossPageTemplates } from "./cross-reference-resolve";
+import { isComponentNode, isUnsafeKey } from "./paths";
+import { toText, TEMPLATE_FUNCTIONS } from "./template-functions";
+function expandListMarkdownLinks(input, context) {
+    const re = /\{\{\s*([\w]+)\.markdownLinks(?:\s+(["'])([^"']*)\2)?\s*\}\}/g;
+    return input.replace(re, (_m, sourceName, _quote, hrefTemplateRaw) => {
+        const raw = context[sourceName];
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            return "";
+        }
+        const items = raw.items;
+        if (!Array.isArray(items)) {
+            return "";
+        }
+        const hrefTemplate = (hrefTemplateRaw || "/{id}").trim();
+        if (!hrefTemplate) {
+            return "";
+        }
+        const lines = [];
+        for (const it of items) {
+            if (!it || typeof it !== "object" || Array.isArray(it)) {
+                continue;
+            }
+            const row = it;
+            const id = String(row.id ?? "");
+            const name = String(row.name ?? "");
+            if (!id || !name) {
+                continue;
+            }
+            const href = hrefTemplate
+                .replace(/\{id\}/g, id)
+                .replace(/\{name\}/g, encodeURIComponent(name));
+            const label = name.replace(/[[\]]/g, "");
+            lines.push(`[${label}](${href})`);
+        }
+        return lines.join("\n");
+    });
+}
+function getByPath(obj, path) {
+    if (!path)
+        return undefined;
+    const parts = path.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (isUnsafeKey(p))
+            return undefined;
+        if (cur == null || typeof cur !== "object" || Array.isArray(cur)) {
+            return undefined;
+        }
+        cur = cur[p];
+    }
+    return cur;
+}
+/**
+ * Resolve a simple `source.path.to.value` expression from the datasource context.
+ * Returns `{ resolved: true, value }` if the inner string is a dotted identifier path,
+ * or `{ resolved: false }` if it requires full expression evaluation.
+ */
+function resolveSourcePath(inner, context) {
+    if (!/^[\w.]+$/.test(inner))
+        return { resolved: false };
+    const segments = inner.split(".");
+    const sourceName = segments[0] ?? "";
+    const pathWithinSource = segments.slice(1).join(".");
+    const sourceRow = context[sourceName];
+    if (!sourceRow || typeof sourceRow !== "object" || Array.isArray(sourceRow)) {
+        return { resolved: true, value: undefined };
+    }
+    const value = pathWithinSource
+        ? getByPath(sourceRow, pathWithinSource)
+        : sourceRow;
+    return { resolved: true, value };
+}
+function evalTemplateExpression(node, context) {
+    if (!node || typeof node !== "object") {
+        return undefined;
+    }
+    const n = node;
+    if (n.type === "Identifier") {
+        return context[n.name];
+    }
+    if (n.type === "Literal") {
+        return n.value;
+    }
+    if (n.type === "MemberExpression") {
+        const base = evalTemplateExpression(n.object, context);
+        if (!base || typeof base !== "object" || Array.isArray(base)) {
+            return undefined;
+        }
+        let key;
+        if (n.computed) {
+            const computedKey = evalTemplateExpression(n.property, context);
+            if (typeof computedKey === "string" || typeof computedKey === "number") {
+                key = String(computedKey);
+            }
+        }
+        else {
+            const prop = n.property;
+            if (prop.type === "Identifier") {
+                key = prop.name;
+            }
+        }
+        if (!key || isUnsafeKey(key))
+            return undefined;
+        return base[key];
+    }
+    if (n.type === "CallExpression") {
+        const callee = n.callee;
+        if (callee.type !== "Identifier") {
+            return undefined;
+        }
+        const fn = TEMPLATE_FUNCTIONS[callee.name];
+        if (!fn) {
+            return undefined;
+        }
+        const args = [];
+        const argsList = n.arguments;
+        for (const arg of argsList) {
+            const argNode = arg;
+            if (argNode.type === "SpreadElement") {
+                return undefined;
+            }
+            args.push(evalTemplateExpression(arg, context));
+        }
+        return fn(args);
+    }
+    return undefined;
+}
+function resolveTemplateExpression(inner, context) {
+    const value = resolveTemplateExpressionValue(inner, context);
+    return toText(value);
+}
+function resolveTemplateExpressionValue(inner, context) {
+    try {
+        const parsed = jsep(inner);
+        return evalTemplateExpression(parsed, context);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveWholeTemplateValue(input, context) {
+    const exact = input.match(/^\s*\{\{([^{}]+)\}\}\s*$/);
+    if (!exact)
+        return { matched: false, value: undefined };
+    const inner = String(exact[1]).trim();
+    if (!inner)
+        return { matched: true, value: "" };
+    // Preserve block-local item templates (e.g. `{{ item.name }}`) for component-level rendering.
+    if (inner === "item" || inner.startsWith("item.")) {
+        return { matched: false, value: undefined };
+    }
+    const result = resolveSourcePath(inner, context);
+    const value = result.resolved
+        ? result.value
+        : resolveTemplateExpressionValue(inner, context);
+    if (value == null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return { matched: true, value: toText(value) };
+    }
+    if (Array.isArray(value) || typeof value === "object") {
+        return { matched: true, value: structuredClone(value) };
+    }
+    return { matched: true, value: "" };
+}
+/**
+ * Replace `{{ source.key }}` / `{{ source.nested.key }}` using datasource context.
+ * Unknown sources or missing values become empty strings.
+ */
+export async function resolveStringTemplates(input, context) {
+    const afterCrossPage = await resolveCrossPageTemplates(input);
+    const afterList = expandListMarkdownLinks(afterCrossPage, context);
+    // Fresh RegExp each call — avoid `/g` lastIndex issues across invocations.
+    return afterList.replace(/\{\{([^{}]+)\}\}/g, (_match, rawExpression) => {
+        const inner = String(rawExpression).trim();
+        if (!inner)
+            return "";
+        // Keep `item` tokens intact so blocks can resolve per-item templates at render time.
+        if (inner === "item" || inner.startsWith("item.")) {
+            return _match;
+        }
+        // Fast path for common `source.path` expressions.
+        const result = resolveSourcePath(inner, context);
+        if (result.resolved) {
+            return toText(result.value);
+        }
+        return resolveTemplateExpression(inner, context);
+    });
+}
+async function resolveValue(value, context) {
+    if (typeof value === "string") {
+        // Resolve cross-page references first so that whole-value resolution
+        // does not swallow `{{ pages[...] }}` tokens as unknown datasource keys.
+        const afterCrossPage = await resolveCrossPageTemplates(value);
+        const whole = resolveWholeTemplateValue(afterCrossPage, context);
+        if (whole.matched) {
+            return whole.value;
+        }
+        return resolveStringTemplates(afterCrossPage, context);
+    }
+    if (Array.isArray(value)) {
+        return Promise.all(value.map(async (item) => {
+            if (isComponentNode(item)) {
+                return {
+                    ...item,
+                    props: await resolvePropsObject(item.props, context),
+                };
+            }
+            return resolveValue(item, context);
+        }));
+    }
+    if (value && typeof value === "object") {
+        return resolvePlainObject(value, context);
+    }
+    return value;
+}
+/** Regex that matches safe object-property keys (identifiers, hyphenated names, numeric indices). */
+const SAFE_PROP_KEY_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$-]*$|^\d+$/;
+async function resolvePropsObject(props, context) {
+    const out = {};
+    const entries = Object.keys(props)
+        .filter((key) => SAFE_PROP_KEY_REGEX.test(key))
+        .map(async (key) => [key, await resolveValue(props[key], context)]);
+    for (const [key, val] of await Promise.all(entries)) {
+        out[key] = val;
+    }
+    return out;
+}
+async function resolvePlainObject(obj, context) {
+    if (isComponentNode(obj)) {
+        return {
+            ...obj,
+            props: await resolvePropsObject(obj.props, context),
+        };
+    }
+    const out = {};
+    const entries = Object.keys(obj)
+        .filter((key) => SAFE_PROP_KEY_REGEX.test(key))
+        .map(async (key) => [key, await resolveValue(obj[key], context)]);
+    for (const [key, val] of await Promise.all(entries)) {
+        out[key] = val;
+    }
+    return out;
+}
+async function resolveRoot(root, context) {
+    if (!root || typeof root !== "object" || Array.isArray(root)) {
+        return root;
+    }
+    return resolvePlainObject(root, context);
+}
+/**
+ * Deep-walk Puck `Data`: interpolate all string props in `root`, `content`, and `zones`.
+ */
+export async function resolveDataTemplates(data, context) {
+    const cloned = structuredClone(data);
+    const d = cloned;
+    // Resolve root, content, and zones in parallel
+    const [resolvedRoot, resolvedContent, resolvedZones] = await Promise.all([
+        d.root !== undefined ? resolveRoot(d.root, context) : undefined,
+        d.content !== undefined ? resolveValue(d.content, context) : undefined,
+        d.zones !== undefined && d.zones !== null
+            ? (async () => {
+                const zones = d.zones;
+                const zoneEntries = Object.keys(zones).map(async (key) => [key, await resolveValue(zones[key], context)]);
+                for (const [key, val] of await Promise.all(zoneEntries)) {
+                    zones[key] = val;
+                }
+                return zones;
+            })()
+            : undefined,
+    ]);
+    if (resolvedRoot !== undefined) {
+        d.root = resolvedRoot;
+    }
+    if (resolvedContent !== undefined) {
+        d.content = resolvedContent;
+    }
+    if (resolvedZones !== undefined) {
+        d.zones = resolvedZones;
+    }
+    return cloned;
+}
+//# sourceMappingURL=resolve-data-templates.js.map

package/dist/data/resolve-data-templates.js.map

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

package/dist/data/route-templates.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Dynamic route patterns stored as database keys, e.g. `/jedi/:id`, `/starships/:id`, `/test/:a/:b`.
+ * Static segments must match exactly; `:param` segments capture any single path segment.
+ */
+export declare function normalizeRoutePath(path: string): string;
+/** Public page URL for navigation (e.g. structure “View”). */
+export declare function publicPagePathHref(routePath: string): string;
+/**
+ * P1 editor URL for a stored route. Maps to `/p1/<path>`.
+ */
+export declare function editorPathHref(routePath: string): string;
+/**
+ * Build the storage path from Next.js `[...catchAll]` segments. Each segment is URI-decoded
+ * so template keys like `/jedi/:id` work when the URL contains encoded colons (`%3A`).
+ */
+export declare function pagePathFromCatchAllSegments(segments: string[] | undefined): string;
+/** True if the path is a template (at least one `:param` segment). */
+export declare function isRouteTemplatePath(path: string): boolean;
+export declare function pathSegments(path: string): string[];
+/**
+ * Example concrete path for a template (each `:param` segment becomes `1`), for structure UI defaults.
+ */
+export declare function defaultInstancePathFromTemplate(templatePath: string): string;
+/**
+ * If `concrete` matches `template`, returns captured params. Otherwise null.
+ */
+export declare function matchConcretePathToTemplateParams(concretePath: string, templatePath: string): Record<string, string> | null;
+/** Keys that look like collection templates (`:param` segments). */
+export declare function listRouteTemplateKeys(allDatabaseKeys: string[]): string[];
+/**
+ * If `concretePath` is an instance of a known template, returns that template's storage key.
+ * Returns null when `concretePath` is itself the template row or does not match any template.
+ */
+export declare function pickTemplateSourcePath(concretePath: string, templateKeys: string[]): string | null;
+export declare function resolveTemplateMatch(concretePath: string, templateKeys: string[]): {
+    templateKey: string;
+    params: Record<string, string>;
+} | null;
+/** True when this path is a template row stored in the database (canonical layout). */
+export declare function isCanonicalTemplatePath(path: string, templateKeys: string[]): boolean;
+/** Parameter names declared on a template path, in order. */
+export declare function templatePathParamNames(templatePath: string): string[];
+//# sourceMappingURL=route-templates.d.ts.map

package/dist/data/route-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-templates.d.ts","sourceRoot":"","sources":["../../src/data/route-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAanF;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAInD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgB/B;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEzE;AAcD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,GAAG,IAAI,CAcf;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAShE;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAGT;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrE"}