@gooddata/sdk-model 11.63.0-alpha.0 → 11.63.0-alpha.2

package/esm/publisher/v1/content.d.ts

@@ -1,13 +1,13 @@
 import { type IDashboardAttributeFilterConfig } from "../../dashboard/dashboard.js";
 import { type FilterContextItem } from "../../dashboard/filterContext.js";
-import { type IPublisherPageBodyV1 } from "./pageLayout.js";
+import { type IPublisherPageBodyV1 } from "./pageTemplate.js";
 import { type IPublisherVariableDefinitionV1 } from "./variables.js";
 /**
  * Page instance embedded in template/document content: a deep clone of a page body
  * plus its own identity.
  *
  * @remarks
- * Cloning a {@link IPublisherPageLayoutV1} into content assigns the localIdentifier and regenerates
+ * Cloning a {@link IPublisherPageTemplateV1} into content assigns the localIdentifier and regenerates
  * slot localIdentifiers (with the layout slotIds) so repeated use of one page stays unique.
  * Deliberately carries NO reference back to the source page — later page edits never
  * affect existing templates or documents.

package/esm/publisher/v1/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/content.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,KAAK,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IAClE;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAChD,+BAA+B,EAC/B,iBAAiB,GAAG,gBAAgB,CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAElC;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAE9B;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAE7D;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAE7C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,2BAA2B,CAM7F"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/content.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IAClE;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAChD,+BAA+B,EAC/B,iBAAiB,GAAG,gBAAgB,CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAElC;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAE9B;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAE7D;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAE7C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,2BAA2B,CAM7F"}

package/esm/publisher/v1/defaultPageTemplates.d.ts

@@ -0,0 +1,45 @@
+import { type IPublisherPageTemplateV1 } from "./pageTemplate.js";
+/**
+ * Default cover page: document title and subtitle.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateCoverV1: IPublisherPageTemplateV1;
+/**
+ * Default section divider page.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateSectionV1: IPublisherPageTemplateV1;
+/**
+ * Default content page with six visualizations and a text column on the left.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateViz6TextLeftV1: IPublisherPageTemplateV1;
+/**
+ * Default portrait cover page: document title and subtitle.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitCoverV1: IPublisherPageTemplateV1;
+/**
+ * Default portrait section divider page.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSectionV1: IPublisherPageTemplateV1;
+/**
+ * Default portrait page carrying a full-page narrative, with no visualization.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSummaryV1: IPublisherPageTemplateV1;
+/**
+ * All default page templates served by the SPI. They are read-only: they cannot be
+ * edited or deleted, and they are never persisted on the backend.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatesV1: readonly IPublisherPageTemplateV1[];
+//# sourceMappingURL=defaultPageTemplates.d.ts.map

package/esm/publisher/v1/defaultPageTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultPageTemplates.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/defaultPageTemplates.ts"],"names":[],"mappings":"AAMA,OAAO,EAA6B,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAqL7F;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,wBAkBhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,EAAE,wBAalD,CAAC;AA2DH;;;;GAIG;AACH,eAAO,MAAM,0CAA0C,EAAE,wBA0BvD,CAAC;AAiDH;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,EAAE,wBAkBxD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6CAA6C,EAAE,wBAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6CAA6C,EAAE,wBAc1D,CAAC;AA8CH;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,wBAAwB,EAa7E,CAAC"}

package/esm/publisher/v1/{builtinPageLayouts.js → defaultPageTemplates.js}

@@ -99,7 +99,7 @@ const vizIds = (count, perRow) => {
     }
     return rows;
 };
-// Built-ins are shared singletons served by every backend implementation;
+// Default page templates are shared singletons served by every backend implementation;
 // freezing makes accidental mutation by a consumer throw instead of corrupting them.
 function deepFreeze(value) {
     if (value && typeof value === "object" && !Object.isFrozen(value)) {
@@ -110,21 +110,21 @@ function deepFreeze(value) {
     }
     return value;
 }
-const builtInPage = ({ id, title, description, body, }) => deepFreeze({
+const defaultPage = ({ id, title, description, body, }) => deepFreeze({
     type: "reportPageLayout",
     ref: idRef(`builtin.reportPageLayout.${id}`, "reportPageLayout"),
     title,
     description,
     content: { version: "1", ...body },
-    isBuiltIn: true,
+    isDefault: true,
     isLocked: true,
 });
 /**
- * Built-in cover page: document title and subtitle.
+ * Default cover page: document title and subtitle.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutCoverV1 = builtInPage({
+export const DefaultPublisherPageTemplateCoverV1 = defaultPage({
     id: "cover",
     title: "Cover",
     description: "Title page",
@@ -144,11 +144,11 @@ export const BuiltInPublisherPageLayoutCoverV1 = builtInPage({
     },
 });
 /**
- * Built-in section divider page.
+ * Default section divider page.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutSectionV1 = builtInPage({
+export const DefaultPublisherPageTemplateSectionV1 = defaultPage({
     id: "section",
     title: "Section",
     description: "Section divider page",
@@ -218,11 +218,11 @@ const widescreenContentPages = [
     ],
 ];
 /**
- * Built-in content page with six visualizations and a text column on the left.
+ * Default content page with six visualizations and a text column on the left.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutViz6TextLeftV1 = builtInPage({
+export const DefaultPublisherPageTemplateViz6TextLeftV1 = defaultPage({
     id: "viz6TextLeft",
     title: "6 visualizations + text",
     description: "Two rows of three visualizations with a text column on the left",
@@ -276,11 +276,11 @@ const portraitContentPage = ({ vizRows, text, summary }) => {
     };
 };
 /**
- * Built-in portrait cover page: document title and subtitle.
+ * Default portrait cover page: document title and subtitle.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutPortraitCoverV1 = builtInPage({
+export const DefaultPublisherPageTemplatePortraitCoverV1 = defaultPage({
     id: "portraitCover",
     title: "Cover (portrait)",
     description: "Title page of an upright document",
@@ -300,11 +300,11 @@ export const BuiltInPublisherPageLayoutPortraitCoverV1 = builtInPage({
     },
 });
 /**
- * Built-in portrait section divider page.
+ * Default portrait section divider page.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutPortraitSectionV1 = builtInPage({
+export const DefaultPublisherPageTemplatePortraitSectionV1 = defaultPage({
     id: "portraitSection",
     title: "Section (portrait)",
     description: "Section divider page of an upright document",
@@ -319,11 +319,11 @@ export const BuiltInPublisherPageLayoutPortraitSectionV1 = builtInPage({
     },
 });
 /**
- * Built-in portrait page carrying a full-page narrative, with no visualization.
+ * Default portrait page carrying a full-page narrative, with no visualization.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutPortraitSummaryV1 = builtInPage({
+export const DefaultPublisherPageTemplatePortraitSummaryV1 = defaultPage({
     id: "portraitSummary",
     title: "Summary (portrait)",
     description: "Full-page narrative with no visualization",
@@ -382,18 +382,18 @@ const portraitContentPages = [
     ],
 ];
 /**
- * All built-in page layouts served by the SPI. Built-ins are read-only: they cannot be
+ * All default page templates served by the SPI. They are read-only: they cannot be
  * edited or deleted, and they are never persisted on the backend.
  *
  * @alpha
  */
-export const BuiltInPublisherPageLayoutsV1 = Object.freeze([
-    BuiltInPublisherPageLayoutCoverV1,
-    BuiltInPublisherPageLayoutSectionV1,
-    ...widescreenContentPages.map(([id, title, description, spec]) => builtInPage({ id, title, description, body: widescreenContentPage(spec) })),
-    BuiltInPublisherPageLayoutViz6TextLeftV1,
-    BuiltInPublisherPageLayoutPortraitCoverV1,
-    BuiltInPublisherPageLayoutPortraitSectionV1,
-    BuiltInPublisherPageLayoutPortraitSummaryV1,
-    ...portraitContentPages.map(([id, title, description, spec]) => builtInPage({ id, title, description, body: portraitContentPage(spec) })),
+export const DefaultPublisherPageTemplatesV1 = Object.freeze([
+    DefaultPublisherPageTemplateCoverV1,
+    DefaultPublisherPageTemplateSectionV1,
+    ...widescreenContentPages.map(([id, title, description, spec]) => defaultPage({ id, title, description, body: widescreenContentPage(spec) })),
+    DefaultPublisherPageTemplateViz6TextLeftV1,
+    DefaultPublisherPageTemplatePortraitCoverV1,
+    DefaultPublisherPageTemplatePortraitSectionV1,
+    DefaultPublisherPageTemplatePortraitSummaryV1,
+    ...portraitContentPages.map(([id, title, description, spec]) => defaultPage({ id, title, description, body: portraitContentPage(spec) })),
 ]);

package/esm/publisher/v1/factory.d.ts

@@ -1,15 +1,15 @@
 import { type IPublisherDocumentContentV1, type IPublisherDocumentPageV1 } from "./content.js";
 import { type IPublisherDocumentDefinitionV1, type IPublisherDocumentTemplateDefinitionV1, type IPublisherDocumentTemplateV1, type IPublisherDocumentV1 } from "./document.js";
-import { type IPublisherPageBodyV1, type IPublisherPageLayoutDefinitionV1, type IPublisherPageLayoutV1 } from "./pageLayout.js";
+import { type IPublisherPageBodyV1, type IPublisherPageTemplateDefinitionV1, type IPublisherPageTemplateV1 } from "./pageTemplate.js";
 import { type PublisherDateStringV1 } from "./variables.js";
 /**
- * Creates a new page layout definition.
+ * Creates a new page template definition.
  *
  * @alpha
  */
-export declare function newPublisherPageLayoutDefinitionV1(title: string, body: IPublisherPageBodyV1, modifications?: Partial<Omit<IPublisherPageLayoutDefinitionV1, "type" | "title" | "content">>): IPublisherPageLayoutDefinitionV1;
+export declare function newPublisherPageTemplateDefinitionV1(title: string, body: IPublisherPageBodyV1, modifications?: Partial<Omit<IPublisherPageTemplateDefinitionV1, "type" | "title" | "content">>): IPublisherPageTemplateDefinitionV1;
 /**
- * Clones a page layout into a page instance embeddable in template/document content.
+ * Clones a page template into a page instance embeddable in template/document content.
  *
  * @remarks
  * The body is deep-copied and detached from the source page — no reference is kept.
@@ -18,7 +18,7 @@ export declare function newPublisherPageLayoutDefinitionV1(title: string, body:
  *
  * @alpha
  */
-export declare function newPublisherDocumentPageFromLayoutV1(page: IPublisherPageLayoutV1 | IPublisherPageLayoutDefinitionV1, localIdentifier?: string): IPublisherDocumentPageV1;
+export declare function newPublisherDocumentPageFromTemplateV1(page: IPublisherPageTemplateV1 | IPublisherPageTemplateDefinitionV1, localIdentifier?: string): IPublisherDocumentPageV1;
 /**
  * Creates document content from page instances.
  *

package/esm/publisher/v1/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EACH,KAAK,8BAA8B,EACnC,KAAK,sCAAsC,EAC3C,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,KAAK,oBAAoB,EAEzB,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC9B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAyC5D;;;;GAIG;AACH,wBAAgB,kCAAkC,CAC9C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GAC9F,gCAAgC,CAQlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAChD,IAAI,EAAE,sBAAsB,GAAG,gCAAgC,EAC/D,eAAe,GAAE,MAAyC,GAC3D,wBAAwB,CAY1B;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,wBAAwB,EAAE,EACjC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAChF,2BAA2B,CAM7B;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACpD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,2BAA2B,EACpC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GACpG,sCAAsC,CAOxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4CAA4C,CACxD,QAAQ,EAAE,4BAA4B,GAAG,sCAAsC,EAC/E,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,qBAAqB,CAAC;IACnC,SAAS,EAAE,qBAAqB,CAAC;CACpC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACnG,GACF,8BAA8B,CAShC;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACjD,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,qBAAqB,CAAC;IACnC,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACtC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACnG,GACF,8BAA8B,CAShC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,kBAAkB,EACZ,oBAAoB,GACpB,8BAA8B,GAC9B,4BAA4B,GAC5B,sCAAsC,EAC5C,mBAAmB,EAAE,MAAM,GAC5B,wBAAwB,GAAG,SAAS,CAEtC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EACH,KAAK,8BAA8B,EACnC,KAAK,sCAAsC,EAC3C,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,KAAK,oBAAoB,EAEzB,KAAK,kCAAkC,EACvC,KAAK,wBAAwB,EAChC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAyC5D;;;;GAIG;AACH,wBAAgB,oCAAoC,CAChD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GAChG,kCAAkC,CAQpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sCAAsC,CAClD,IAAI,EAAE,wBAAwB,GAAG,kCAAkC,EACnE,eAAe,GAAE,MAAyC,GAC3D,wBAAwB,CAY1B;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,wBAAwB,EAAE,EACjC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAChF,2BAA2B,CAM7B;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACpD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,2BAA2B,EACpC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GACpG,sCAAsC,CAOxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4CAA4C,CACxD,QAAQ,EAAE,4BAA4B,GAAG,sCAAsC,EAC/E,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,qBAAqB,CAAC;IACnC,SAAS,EAAE,qBAAqB,CAAC;CACpC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACnG,GACF,8BAA8B,CAShC;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACjD,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,qBAAqB,CAAC;IACnC,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACtC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACnG,GACF,8BAA8B,CAShC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,kBAAkB,EACZ,oBAAoB,GACpB,8BAA8B,GAC9B,4BAA4B,GAC5B,sCAAsC,EAC5C,mBAAmB,EAAE,MAAM,GAC5B,wBAAwB,GAAG,SAAS,CAEtC"}

package/esm/publisher/v1/factory.js

@@ -33,11 +33,11 @@ function prefixLayoutSlotIds(node, prefix) {
     };
 }
 /**
- * Creates a new page layout definition.
+ * Creates a new page template definition.
  *
  * @alpha
  */
-export function newPublisherPageLayoutDefinitionV1(title, body, modifications) {
+export function newPublisherPageTemplateDefinitionV1(title, body, modifications) {
     const content = { version: "1", ...body };
     return {
         type: "reportPageLayout",
@@ -47,7 +47,7 @@ export function newPublisherPageLayoutDefinitionV1(title, body, modifications) {
     };
 }
 /**
- * Clones a page layout into a page instance embeddable in template/document content.
+ * Clones a page template into a page instance embeddable in template/document content.
  *
  * @remarks
  * The body is deep-copied and detached from the source page — no reference is kept.
@@ -56,7 +56,7 @@ export function newPublisherPageLayoutDefinitionV1(title, body, modifications) {
  *
  * @alpha
  */
-export function newPublisherDocumentPageFromLayoutV1(page, localIdentifier = generatePublisherLocalId("page")) {
+export function newPublisherDocumentPageFromTemplateV1(page, localIdentifier = generatePublisherLocalId("page")) {
     const { version: _version, ...body } = deepClone(page.content);
     return {
         ...body,

package/esm/publisher/v1/layout.d.ts

@@ -1,14 +1,14 @@
 import { type IPublisherBoxStyleV1 } from "./styling.js";
 /**
- * Node of a page layout: a recursive row/column split tree (flexbox semantics)
+ * Node of a page's layout tree: a recursive row/column split tree (flexbox semantics)
  * over a fixed page. Leaves assign their area to slots; the tree carries geometry and
  * box paint, slot content lives in {@link IPublisherPageBodyV1.slots}.
  *
  * @alpha
  */
-export type PublisherPageLayoutNodeV1 = IPublisherLayoutSectionV1 | IPublisherLayoutSlotRefV1;
+export type PublisherLayoutNodeV1 = IPublisherLayoutSectionV1 | IPublisherLayoutSlotRefV1;
 /**
- * Fields common to all page layout nodes.
+ * Fields common to all layout nodes.
  *
  * @alpha
  */
@@ -30,7 +30,7 @@ export interface IPublisherLayoutSectionV1 extends IPublisherLayoutNodeBaseV1 {
      * "row" lays children out horizontally, "column" vertically.
      */
     direction: "row" | "column";
-    children: PublisherPageLayoutNodeV1[];
+    children: PublisherLayoutNodeV1[];
     /**
      * Paint of this section's box. Never affects how children are laid out.
      */

package/esm/publisher/v1/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,GAAG,yBAAyB,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IACzE,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IAEtC;;OAEG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IACzE,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,yBAAyB,CAEzF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,yBAAyB,CAEzF"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,GAAG,yBAAyB,CAAC;AAE1F;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IACzE,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IACzE,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,yBAAyB,CAEzF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,yBAAyB,CAEzF"}

package/esm/publisher/v1/pageFormat.d.ts

@@ -1,5 +1,5 @@
 /**
- * Page shape a page layout is designed for.
+ * Page shape a page template is designed for.
  *
  * @remarks
  * A layout's geometry only reads correctly at the proportions it was authored for: a row of three

package/esm/publisher/v1/{pageLayout.d.ts → pageTemplate.d.ts}

@@ -1,7 +1,7 @@
 import { type IAuditableDates, type IAuditableUsers } from "../../base/metadata.js";
 import { type FilterContextItem } from "../../dashboard/filterContext.js";
 import { type ObjRef } from "../../objRef/index.js";
-import { type PublisherPageLayoutNodeV1 } from "./layout.js";
+import { type PublisherLayoutNodeV1 } from "./layout.js";
 import { type PublisherPageFormatV1 } from "./pageFormat.js";
 import { type PublisherSlotV1 } from "./slot.js";
 import { type IPublisherBoxStyleV1 } from "./styling.js";
@@ -9,7 +9,7 @@ import { type IPublisherBoxStyleV1 } from "./styling.js";
  * Body of a document page: geometry (flex split tree) plus the slots it places.
  *
  * @remarks
- * This is both the content of the standalone {@link IPublisherPageLayoutV1} object and the shape
+ * This is both the content of the standalone {@link IPublisherPageTemplateV1} object and the shape
  * embedded in template/document content ({@link IPublisherDocumentPageV1}).
  *
  * There is no header/footer chrome: page title, description, footer, page numbers and
@@ -34,9 +34,9 @@ export interface IPublisherPageBodyV1 {
      */
     style?: IPublisherBoxStyleV1;
     /**
-     * Root of the page layout tree.
+     * Root of the layout tree.
      */
-    layout: PublisherPageLayoutNodeV1;
+    layout: PublisherLayoutNodeV1;
     /**
      * All slots referenced by the layout, flat, keyed by localIdentifier.
      */
@@ -52,18 +52,18 @@ export interface IPublisherPageBodyV1 {
  *
  * @alpha
  */
-export interface IPublisherPageLayoutContentV1 extends IPublisherPageBodyV1 {
+export interface IPublisherPageTemplateContentV1 extends IPublisherPageBodyV1 {
     /**
      * Content model version, for stored-content evolution.
      */
     version: "1";
 }
 /**
- * Payload for creating or updating a page layout.
+ * Payload for creating or updating a page template.
  *
  * @alpha
  */
-export interface IPublisherPageLayoutDefinitionV1 {
+export interface IPublisherPageTemplateDefinitionV1 {
     type: "reportPageLayout";
     /**
      * Present when updating an existing page.
@@ -72,14 +72,14 @@ export interface IPublisherPageLayoutDefinitionV1 {
     title: string;
     description?: string;
     tags?: string[];
-    content: IPublisherPageLayoutContentV1;
+    content: IPublisherPageTemplateContentV1;
 }
 /**
- * Reusable page layout metadata object.
+ * Reusable page template metadata object.
  *
  * @alpha
  */
-export interface IPublisherPageLayoutV1 extends IPublisherPageLayoutDefinitionV1, IAuditableDates, IAuditableUsers {
+export interface IPublisherPageTemplateV1 extends IPublisherPageTemplateDefinitionV1, IAuditableDates, IAuditableUsers {
     ref: ObjRef;
     /**
      * When true, the object comes from a parent workspace and is not editable
@@ -88,28 +88,28 @@ export interface IPublisherPageLayoutV1 extends IPublisherPageLayoutDefinitionV1
     isLocked?: boolean;
     /**
      * Predefined page shipped with the product, populated by the SPI. Never sent to or
-     * stored on the backend; UI must disable deletion and editing of built-in pages.
+     * stored on the backend; UI must disable deletion and editing of default page templates.
      */
-    isBuiltIn?: boolean;
+    isDefault?: boolean;
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutDefinitionV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutDefinitionV1(obj: unknown): obj is IPublisherPageLayoutDefinitionV1;
+export declare function isPublisherPageTemplateDefinitionV1(obj: unknown): obj is IPublisherPageTemplateDefinitionV1;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutV1(obj: unknown): obj is IPublisherPageLayoutV1;
+export declare function isPublisherPageTemplateV1(obj: unknown): obj is IPublisherPageTemplateV1;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutContentV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateContentV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutContentV1(obj: unknown): obj is IPublisherPageLayoutContentV1;
+export declare function isPublisherPageTemplateContentV1(obj: unknown): obj is IPublisherPageTemplateContentV1;
 /**
  * Validation issue found in a page body.
  *
@@ -130,4 +130,4 @@ export interface IPublisherPageBodyValidationIssueV1 {
  * @alpha
  */
 export declare function validatePublisherPageBodyV1(body: IPublisherPageBodyV1): IPublisherPageBodyValidationIssueV1[];
-//# sourceMappingURL=pageLayout.d.ts.map
+//# sourceMappingURL=pageTemplate.d.ts.map

package/esm/publisher/v1/pageTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageTemplate.d.ts","sourceRoot":"","sources":["../../../src/publisher/v1/pageTemplate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EACH,KAAK,qBAAqB,EAG7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,qBAAqB,EAA2B,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,KAAK,eAAe,EAAiD,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,KAAK,oBAAoB,EAAgC,MAAM,cAAc,CAAC;AAEvF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,eAAe,EAAE,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IACzE;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IAC/C,IAAI,EAAE,kBAAkB,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,OAAO,EAAE,+BAA+B,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,wBACb,SAAQ,kCAAkC,EAAE,eAAe,EAAE,eAAe;IAC5E,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kCAAkC,CAE3G;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,wBAAwB,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,+BAA+B,CAOrG;AAED;;;;GAIG;AACH,MAAM,WAAW,mCAAmC;IAChD,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,oBAAoB,GAC3B,mCAAmC,EAAE,CA+FvC"}

package/esm/publisher/v1/{pageLayout.js → pageTemplate.js}

@@ -6,27 +6,27 @@ import { isPublisherPageFormatV1 } from "./pageFormat.js";
 import { isPublisherImageSlotV1, isPublisherTextSlotV1 } from "./slot.js";
 import { isPublisherImageBackgroundV1 } from "./styling.js";
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutDefinitionV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export function isPublisherPageLayoutDefinitionV1(obj) {
+export function isPublisherPageTemplateDefinitionV1(obj) {
     return !isEmpty(obj) && obj.type === "reportPageLayout";
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateV1}.
  *
  * @alpha
  */
-export function isPublisherPageLayoutV1(obj) {
-    return isPublisherPageLayoutDefinitionV1(obj) && isObjRef(obj.ref);
+export function isPublisherPageTemplateV1(obj) {
+    return isPublisherPageTemplateDefinitionV1(obj) && isObjRef(obj.ref);
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutContentV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateContentV1}.
  *
  * @alpha
  */
-export function isPublisherPageLayoutContentV1(obj) {
+export function isPublisherPageTemplateContentV1(obj) {
     return (!isEmpty(obj) &&
         obj.version === "1" &&
         !isEmpty(obj.layout) &&

package/esm/publisher/v1/slot.d.ts

@@ -3,7 +3,7 @@ import { type VisualizationProperties } from "../../insight/index.js";
 import { type ObjRef } from "../../objRef/index.js";
 import { type IPublisherHeadingStyleV1, type IPublisherImageStyleV1, type IPublisherParagraphStyleV1, type PublisherTextTypeV1 } from "./styling.js";
 /**
- * Metadata of a slot that is intentionally left unfilled in a page layout or template.
+ * Metadata of a slot that is intentionally left unfilled in a page template or document template.
  *
  * @alpha
  */

package/esm/publisher/v2/themeReference.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The path of a theme reference such as `{theme.colors.texts.muted}`, as
+ * `["colors", "texts", "muted"]`; undefined when the value is not one.
+ *
+ * @remarks
+ * A theme reference is always the whole value, never part of a longer string.
+ *
+ * @alpha
+ */
+export declare function getPublisherThemeReferencePathV2(value: unknown): string[] | undefined;
+/**
+ * The theme reference to the path, such as `{theme.assets.images.cover}`.
+ *
+ * @alpha
+ */
+export declare function publisherThemeReferenceV2(path: readonly string[]): string;
+//# sourceMappingURL=themeReference.d.ts.map

package/esm/publisher/v2/themeReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeReference.d.ts","sourceRoot":"","sources":["../../../src/publisher/v2/themeReference.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAMrF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzE"}

package/esm/publisher/v2/themeReference.js

@@ -0,0 +1,27 @@
+// (C) 2026 GoodData Corporation
+// Segments follow the validator's theme names, so a color id or a shadow name may hold dashes.
+const themeReferenceRegex = /^\{theme((?:\.[A-Za-z0-9_-]+)+)\}$/;
+/**
+ * The path of a theme reference such as `{theme.colors.texts.muted}`, as
+ * `["colors", "texts", "muted"]`; undefined when the value is not one.
+ *
+ * @remarks
+ * A theme reference is always the whole value, never part of a longer string.
+ *
+ * @alpha
+ */
+export function getPublisherThemeReferencePathV2(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const match = themeReferenceRegex.exec(value);
+    return match === null ? undefined : match[1].slice(1).split(".");
+}
+/**
+ * The theme reference to the path, such as `{theme.assets.images.cover}`.
+ *
+ * @alpha
+ */
+export function publisherThemeReferenceV2(path) {
+    return `{theme.${path.join(".")}}`;
+}

package/esm/publisher/v2/variables.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A variable every document resolves, referenced from text as `{name}`.
+ *
+ * @alpha
+ */
+export type PublisherTextVariableV2 = "documentName" | "documentDescription" | "documentDateRange" | "documentAttributeFilters" | "periodStart" | "periodEnd" | "lastModifiedAt" | "lastModifiedBy" | "exportedAt" | "exportedBy" | "workspaceName" | "workspaceId" | "currentPageNumber" | "totalPages";
+/**
+ * All document text variable names.
+ *
+ * @alpha
+ */
+export declare const PublisherTextVariablesV2: readonly PublisherTextVariableV2[];
+/**
+ * The marker referencing the variable from document text.
+ *
+ * @alpha
+ */
+export declare function publisherTextPlaceholderV2(name: PublisherTextVariableV2): string;
+/**
+ * Collects the distinct `{variable}` names referenced in the text, in order of first occurrence.
+ *
+ * @alpha
+ */
+export declare function getPublisherTextPlaceholdersV2(text: string): string[];
+/**
+ * Replaces `{variable}` markers with values. A marker with no value stays as typed.
+ *
+ * @alpha
+ */
+export declare function resolvePublisherTextPlaceholdersV2(text: string, values: Partial<Record<PublisherTextVariableV2, string>>): string;
+//# sourceMappingURL=variables.d.ts.map

package/esm/publisher/v2/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../../src/publisher/v2/variables.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC7B,cAAc,GACd,qBAAqB,GACrB,mBAAmB,GACnB,0BAA0B,GAC1B,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,YAAY,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,uBAAuB,EAetE,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CASrE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,GACzD,MAAM,CAOR"}

package/esm/publisher/v2/variables.js

@@ -0,0 +1,59 @@
+// (C) 2026 GoodData Corporation
+/**
+ * All document text variable names.
+ *
+ * @alpha
+ */
+export const PublisherTextVariablesV2 = [
+    "documentName",
+    "documentDescription",
+    "documentDateRange",
+    "documentAttributeFilters",
+    "periodStart",
+    "periodEnd",
+    "lastModifiedAt",
+    "lastModifiedBy",
+    "exportedAt",
+    "exportedBy",
+    "workspaceName",
+    "workspaceId",
+    "currentPageNumber",
+    "totalPages",
+];
+const placeholderRegex = /\{([a-zA-Z][a-zA-Z0-9_]*)\}/g;
+/**
+ * The marker referencing the variable from document text.
+ *
+ * @alpha
+ */
+export function publisherTextPlaceholderV2(name) {
+    return `{${name}}`;
+}
+/**
+ * Collects the distinct `{variable}` names referenced in the text, in order of first occurrence.
+ *
+ * @alpha
+ */
+export function getPublisherTextPlaceholdersV2(text) {
+    const names = [];
+    for (const match of text.matchAll(placeholderRegex)) {
+        const name = match[1];
+        if (!names.includes(name)) {
+            names.push(name);
+        }
+    }
+    return names;
+}
+/**
+ * Replaces `{variable}` markers with values. A marker with no value stays as typed.
+ *
+ * @alpha
+ */
+export function resolvePublisherTextPlaceholdersV2(text, values) {
+    return text.replace(placeholderRegex, (marker, name) => {
+        const value = Object.prototype.hasOwnProperty.call(values, name)
+            ? values[name]
+            : undefined;
+        return value === undefined ? marker : value;
+    });
+}