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

package/esm/{reports/report.d.ts → publisher/document.d.ts}

@@ -1,13 +1,13 @@
 import { type IAuditableDates, type IAuditableUsers } from "../base/metadata.js";
 import { type ObjRef } from "../objRef/index.js";
-import { type IReportContent } from "./content.js";
-import { type ReportDateString } from "./variables.js";
+import { type IPublisherDocumentContent } from "./content.js";
+import { type PublisherDateString } from "./variables.js";
 /**
- * Payload for creating or updating a report template.
+ * Payload for creating or updating a document template.
  *
  * @alpha
  */
-export interface IReportTemplateDefinition {
+export interface IPublisherDocumentTemplateDefinition {
     type: "reportTemplate";
     /**
      * Present when updating an existing template.
@@ -16,14 +16,14 @@ export interface IReportTemplateDefinition {
     title: string;
     description?: string;
     tags?: string[];
-    content: IReportContent;
+    content: IPublisherDocumentContent;
 }
 /**
- * Report template metadata object.
+ * Document template metadata object.
  *
  * @alpha
  */
-export interface IReportTemplate extends IReportTemplateDefinition, IAuditableDates, IAuditableUsers {
+export interface IPublisherDocumentTemplate extends IPublisherDocumentTemplateDefinition, IAuditableDates, IAuditableUsers {
     ref: ObjRef;
     /**
      * When true, the object comes from a parent workspace and is not editable
@@ -32,11 +32,11 @@ export interface IReportTemplate extends IReportTemplateDefinition, IAuditableDa
     isLocked?: boolean;
 }
 /**
- * Fields shared by report definitions and persisted reports.
+ * Fields shared by document definitions and persisted documents.
  *
  * @alpha
  */
-export interface IReportBase {
+export interface IPublisherDocumentBase {
     title: string;
     description?: string;
     tags?: string[];
@@ -48,40 +48,40 @@ export interface IReportBase {
      * visualization slot's dateDataSet (lowest precedence, per-slot opt-out via
      * ignoreReportPeriod). Also available as `{periodStart}` in text.
      */
-    periodStart: ReportDateString;
+    periodStart: PublisherDateString;
     /**
      * Reported period end, ISO 8601 date (YYYY-MM-DD), inclusive.
      */
-    periodEnd: ReportDateString;
+    periodEnd: PublisherDateString;
     /**
-     * Content of the report. When created from a template the content is deep-copied
-     * and NO reference to the template is kept — the report stays frozen while pages
+     * Content of the document. When created from a template the content is deep-copied
+     * and NO reference to the template is kept — the document stays frozen while pages
      * and templates evolve.
      */
-    content: IReportContent;
+    content: IPublisherDocumentContent;
     /**
      * Values for variables declared in content.variables, keyed by variable name.
      */
     variableValues?: Record<string, string>;
 }
 /**
- * Payload for creating or updating a report.
+ * Payload for creating or updating a document.
  *
  * @alpha
  */
-export interface IReportDefinition extends IReportBase {
+export interface IPublisherDocumentDefinition extends IPublisherDocumentBase {
     type: "report";
     /**
-     * Present when updating an existing report.
+     * Present when updating an existing document.
      */
     ref?: ObjRef;
 }
 /**
- * Report metadata object.
+ * Document metadata object.
  *
  * @alpha
  */
-export interface IReport extends IReportDefinition, IAuditableDates, IAuditableUsers {
+export interface IPublisherDocument extends IPublisherDocumentDefinition, IAuditableDates, IAuditableUsers {
     ref: ObjRef;
     /**
      * When true, the object comes from a parent workspace and is not editable
@@ -90,27 +90,27 @@ export interface IReport extends IReportDefinition, IAuditableDates, IAuditableU
     isLocked?: boolean;
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportTemplateDefinition}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplateDefinition}.
  *
  * @alpha
  */
-export declare function isReportTemplateDefinition(obj: unknown): obj is IReportTemplateDefinition;
+export declare function isPublisherDocumentTemplateDefinition(obj: unknown): obj is IPublisherDocumentTemplateDefinition;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportTemplate}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplate}.
  *
  * @alpha
  */
-export declare function isReportTemplate(obj: unknown): obj is IReportTemplate;
+export declare function isPublisherDocumentTemplate(obj: unknown): obj is IPublisherDocumentTemplate;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportDefinition}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentDefinition}.
  *
  * @alpha
  */
-export declare function isReportDefinition(obj: unknown): obj is IReportDefinition;
+export declare function isPublisherDocumentDefinition(obj: unknown): obj is IPublisherDocumentDefinition;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReport}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocument}.
  *
  * @alpha
  */
-export declare function isReport(obj: unknown): obj is IReport;
-//# sourceMappingURL=report.d.ts.map
+export declare function isPublisherDocument(obj: unknown): obj is IPublisherDocument;
+//# sourceMappingURL=document.d.ts.map

package/esm/publisher/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/publisher/document.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,oCAAoC;IACjD,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;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,yBAAyB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,0BACb,SAAQ,oCAAoC,EAAE,eAAe,EAAE,eAAe;IAC9E,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;;;;OAOG;IACH,WAAW,EAAE,mBAAmB,CAAC;IAEjC;;OAEG;IACH,SAAS,EAAE,mBAAmB,CAAC;IAE/B;;;;OAIG;IACH,OAAO,EAAE,yBAAyB,CAAC;IAEnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IACxE,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B,EAAE,eAAe,EAAE,eAAe;IACtG,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACjD,GAAG,EAAE,OAAO,GACb,GAAG,IAAI,oCAAoC,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,0BAA0B,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,4BAA4B,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kBAAkB,CAE3E"}

package/esm/{reports/report.js → publisher/document.js}

@@ -2,34 +2,34 @@
 import { isEmpty } from "lodash-es";
 import { isObjRef } from "../objRef/index.js";
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportTemplateDefinition}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplateDefinition}.
  *
  * @alpha
  */
-export function isReportTemplateDefinition(obj) {
+export function isPublisherDocumentTemplateDefinition(obj) {
     return !isEmpty(obj) && obj.type === "reportTemplate";
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportTemplate}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplate}.
  *
  * @alpha
  */
-export function isReportTemplate(obj) {
-    return isReportTemplateDefinition(obj) && isObjRef(obj.ref);
+export function isPublisherDocumentTemplate(obj) {
+    return isPublisherDocumentTemplateDefinition(obj) && isObjRef(obj.ref);
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportDefinition}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentDefinition}.
  *
  * @alpha
  */
-export function isReportDefinition(obj) {
+export function isPublisherDocumentDefinition(obj) {
     return !isEmpty(obj) && obj.type === "report";
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReport}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocument}.
  *
  * @alpha
  */
-export function isReport(obj) {
-    return isReportDefinition(obj) && isObjRef(obj.ref);
+export function isPublisherDocument(obj) {
+    return isPublisherDocumentDefinition(obj) && isObjRef(obj.ref);
 }

package/esm/publisher/factory.d.ts

@@ -0,0 +1,65 @@
+import { type IPublisherDocumentContent, type IPublisherDocumentPage } from "./content.js";
+import { type IPublisherDocument, type IPublisherDocumentDefinition, type IPublisherDocumentTemplate, type IPublisherDocumentTemplateDefinition } from "./document.js";
+import { type IPublisherPageBody, type IPublisherPageLayout, type IPublisherPageLayoutDefinition } from "./pageLayout.js";
+import { type PublisherDateString } from "./variables.js";
+/**
+ * Creates a new page layout definition.
+ *
+ * @alpha
+ */
+export declare function newPublisherPageLayoutDefinition(title: string, body: IPublisherPageBody, modifications?: Partial<Omit<IPublisherPageLayoutDefinition, "type" | "title" | "content">>): IPublisherPageLayoutDefinition;
+/**
+ * Clones a page layout 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.
+ * Slot localIdentifiers (and the layout slotIds pointing at them) are prefixed with the
+ * page-instance localIdentifier, so one page used repeatedly in the same content stays unique.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentPageFromLayout(page: IPublisherPageLayout | IPublisherPageLayoutDefinition, localIdentifier?: string): IPublisherDocumentPage;
+/**
+ * Creates document content from page instances.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentContent(pages: IPublisherDocumentPage[], modifications?: Partial<Omit<IPublisherDocumentContent, "version" | "pages">>): IPublisherDocumentContent;
+/**
+ * Creates a new document template definition.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentTemplateDefinition(title: string, content: IPublisherDocumentContent, modifications?: Partial<Omit<IPublisherDocumentTemplateDefinition, "type" | "title" | "content">>): IPublisherDocumentTemplateDefinition;
+/**
+ * Creates a document definition from a template.
+ *
+ * @remarks
+ * The template content is deep-copied; no reference to the template is kept, so the
+ * document stays frozen while the template evolves.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentDefinitionFromTemplate(template: IPublisherDocumentTemplate | IPublisherDocumentTemplateDefinition, options: {
+    title: string;
+    periodStart: PublisherDateString;
+    periodEnd: PublisherDateString;
+}, modifications?: Partial<Omit<IPublisherDocumentDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinition;
+/**
+ * Creates an ad-hoc document definition not based on any template.
+ *
+ * @alpha
+ */
+export declare function newAdHocPublisherDocumentDefinition(options: {
+    title: string;
+    periodStart: PublisherDateString;
+    periodEnd: PublisherDateString;
+    pages?: IPublisherDocumentPage[];
+}, modifications?: Partial<Omit<IPublisherDocumentDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinition;
+/**
+ * Convenience accessor for a document or template page by its localIdentifier.
+ *
+ * @alpha
+ */
+export declare function publisherDocumentPage(documentOrTemplate: IPublisherDocument | IPublisherDocumentDefinition | IPublisherDocumentTemplate | IPublisherDocumentTemplateDefinition, pageLocalIdentifier: string): IPublisherDocumentPage | undefined;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/publisher/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,yBAAyB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,oCAAoC,EAC5C,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAEzB,KAAK,8BAA8B,EACtC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAyC1D;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC5C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,kBAAkB,EACxB,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GAC5F,8BAA8B,CAQhC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAC9C,IAAI,EAAE,oBAAoB,GAAG,8BAA8B,EAC3D,eAAe,GAAE,MAAyC,GAC3D,sBAAsB,CAYxB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,sBAAsB,EAAE,EAC/B,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAC9E,yBAAyB,CAM3B;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAClD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,EAClC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GAClG,oCAAoC,CAOtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0CAA0C,CACtD,QAAQ,EAAE,0BAA0B,GAAG,oCAAoC,EAC3E,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,mBAAmB,CAAC;CAClC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,4BAA4B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACjG,GACF,4BAA4B,CAS9B;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAC/C,OAAO,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACpC,EACD,aAAa,CAAC,EAAE,OAAO,CACnB,IAAI,CAAC,4BAA4B,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CACjG,GACF,4BAA4B,CAS9B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,kBAAkB,EACZ,kBAAkB,GAClB,4BAA4B,GAC5B,0BAA0B,GAC1B,oCAAoC,EAC1C,mBAAmB,EAAE,MAAM,GAC5B,sBAAsB,GAAG,SAAS,CAEpC"}

package/esm/{reports → publisher}/factory.js

@@ -1,7 +1,7 @@
 // (C) 2026 GoodData Corporation
-import { isReportLayoutSection } from "./layout.js";
-import { isReportImageBackground } from "./styling.js";
-function generateReportLocalId(prefix) {
+import { isPublisherLayoutSection } from "./layout.js";
+import { isPublisherImageBackground } from "./styling.js";
+function generatePublisherLocalId(prefix) {
     const unique = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function"
         ? crypto.randomUUID().replace(/-/g, "").slice(0, 12)
         : Math.random().toString(36).slice(2, 14);
@@ -11,7 +11,7 @@ function deepClone(value) {
     return JSON.parse(JSON.stringify(value));
 }
 function prefixBackgroundSlotId(style, prefix) {
-    if (!style?.background || !isReportImageBackground(style.background)) {
+    if (!style?.background || !isPublisherImageBackground(style.background)) {
         return style;
     }
     return {
@@ -20,7 +20,7 @@ function prefixBackgroundSlotId(style, prefix) {
     };
 }
 function prefixLayoutSlotIds(node, prefix) {
-    if (isReportLayoutSection(node)) {
+    if (isPublisherLayoutSection(node)) {
         return {
             ...node,
             ...(node.style === undefined ? {} : { style: prefixBackgroundSlotId(node.style, prefix) }),
@@ -33,11 +33,11 @@ function prefixLayoutSlotIds(node, prefix) {
     };
 }
 /**
- * Creates a new report page definition.
+ * Creates a new page layout definition.
  *
  * @alpha
  */
-export function newReportPageLayoutDefinition(title, body, modifications) {
+export function newPublisherPageLayoutDefinition(title, body, modifications) {
     const content = { version: "1", ...body };
     return {
         type: "reportPageLayout",
@@ -47,7 +47,7 @@ export function newReportPageLayoutDefinition(title, body, modifications) {
     };
 }
 /**
- * Clones a report page into a page instance embeddable in template/report content.
+ * Clones a page layout 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 newReportPageLayoutDefinition(title, body, modifications) {
  *
  * @alpha
  */
-export function newReportContentPageFromLayout(page, localIdentifier = generateReportLocalId("page")) {
+export function newPublisherDocumentPageFromLayout(page, localIdentifier = generatePublisherLocalId("page")) {
     const { version: _version, ...body } = deepClone(page.content);
     return {
         ...body,
@@ -70,11 +70,11 @@ export function newReportContentPageFromLayout(page, localIdentifier = generateR
     };
 }
 /**
- * Creates report content from page instances.
+ * Creates document content from page instances.
  *
  * @alpha
  */
-export function newReportContent(pages, modifications) {
+export function newPublisherDocumentContent(pages, modifications) {
     return {
         version: "1",
         pages,
@@ -82,11 +82,11 @@ export function newReportContent(pages, modifications) {
     };
 }
 /**
- * Creates a new report template definition.
+ * Creates a new document template definition.
  *
  * @alpha
  */
-export function newReportTemplateDefinition(title, content, modifications) {
+export function newPublisherDocumentTemplateDefinition(title, content, modifications) {
     return {
         type: "reportTemplate",
         title,
@@ -95,15 +95,15 @@ export function newReportTemplateDefinition(title, content, modifications) {
     };
 }
 /**
- * Creates a report definition from a template.
+ * Creates a document definition from a template.
  *
  * @remarks
  * The template content is deep-copied; no reference to the template is kept, so the
- * report stays frozen while the template evolves.
+ * document stays frozen while the template evolves.
  *
  * @alpha
  */
-export function newReportDefinitionFromTemplate(template, options, modifications) {
+export function newPublisherDocumentDefinitionFromTemplate(template, options, modifications) {
     return {
         type: "report",
         title: options.title,
@@ -114,25 +114,25 @@ export function newReportDefinitionFromTemplate(template, options, modifications
     };
 }
 /**
- * Creates an ad-hoc report definition not based on any template.
+ * Creates an ad-hoc document definition not based on any template.
  *
  * @alpha
  */
-export function newAdHocReportDefinition(options, modifications) {
+export function newAdHocPublisherDocumentDefinition(options, modifications) {
     return {
         type: "report",
         title: options.title,
         periodStart: options.periodStart,
         periodEnd: options.periodEnd,
-        content: newReportContent(options.pages ?? []),
+        content: newPublisherDocumentContent(options.pages ?? []),
         ...modifications,
     };
 }
 /**
- * Convenience accessor for a report or template page by its localIdentifier.
+ * Convenience accessor for a document or template page by its localIdentifier.
  *
  * @alpha
  */
-export function reportContentPage(reportOrTemplate, pageLocalIdentifier) {
-    return reportOrTemplate.content.pages.find((page) => page.localIdentifier === pageLocalIdentifier);
+export function publisherDocumentPage(documentOrTemplate, pageLocalIdentifier) {
+    return documentOrTemplate.content.pages.find((page) => page.localIdentifier === pageLocalIdentifier);
 }

package/esm/{reports → publisher}/layout.d.ts

@@ -1,18 +1,18 @@
-import { type IReportBoxStyle } from "./styling.js";
+import { type IPublisherBoxStyle } from "./styling.js";
 /**
- * Node of a report page layout: a recursive row/column split tree (flexbox semantics)
+ * Node of a page layout: 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 IReportPageBody.slots}.
+ * box paint, slot content lives in {@link IPublisherPageBody.slots}.
  *
  * @alpha
  */
-export type ReportPageLayoutNode = IReportLayoutSection | IReportLayoutSlotRef;
+export type PublisherPageLayoutNode = IPublisherLayoutSection | IPublisherLayoutSlotRef;
 /**
- * Fields common to all report layout nodes.
+ * Fields common to all page layout nodes.
  *
  * @alpha
  */
-export interface IReportLayoutNodeBase {
+export interface IPublisherLayoutNodeBase {
     /**
      * Fractional weight of this node inside its parent (flex-grow semantics).
      * Defaults to 1. Example: sibling weights [2, 1] render a 2/3 + 1/3 split.
@@ -24,41 +24,41 @@ export interface IReportLayoutNodeBase {
  *
  * @alpha
  */
-export interface IReportLayoutSection extends IReportLayoutNodeBase {
+export interface IPublisherLayoutSection extends IPublisherLayoutNodeBase {
     type: "section";
     /**
      * "row" lays children out horizontally, "column" vertically.
      */
     direction: "row" | "column";
-    children: ReportPageLayoutNode[];
+    children: PublisherPageLayoutNode[];
     /**
      * Paint of this section's box. Never affects how children are laid out.
      */
-    style?: IReportBoxStyle;
+    style?: IPublisherBoxStyle;
 }
 /**
  * A leaf assigning its area to a slot. The slot fills the area completely.
  *
  * @alpha
  */
-export interface IReportLayoutSlotRef extends IReportLayoutNodeBase {
+export interface IPublisherLayoutSlotRef extends IPublisherLayoutNodeBase {
     type: "slotRef";
     /**
-     * Local identifier of a slot in {@link IReportPageBody.slots}.
+     * Local identifier of a slot in {@link IPublisherPageBody.slots}.
      * A slotId with no matching slot renders as an empty area.
      */
     slotId: string;
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSection}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSection}.
  *
  * @alpha
  */
-export declare function isReportLayoutSection(obj: unknown): obj is IReportLayoutSection;
+export declare function isPublisherLayoutSection(obj: unknown): obj is IPublisherLayoutSection;
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSlotRef}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSlotRef}.
  *
  * @alpha
  */
-export declare function isReportLayoutSlotRef(obj: unknown): obj is IReportLayoutSlotRef;
+export declare function isPublisherLayoutSlotRef(obj: unknown): obj is IPublisherLayoutSlotRef;
 //# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/publisher/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACrE,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACrE,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,uBAAuB,CAErF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,uBAAuB,CAErF"}

package/esm/{reports → publisher}/layout.js

@@ -1,18 +1,18 @@
 // (C) 2026 GoodData Corporation
 import { isEmpty } from "lodash-es";
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSection}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSection}.
  *
  * @alpha
  */
-export function isReportLayoutSection(obj) {
+export function isPublisherLayoutSection(obj) {
     return !isEmpty(obj) && obj.type === "section";
 }
 /**
- * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSlotRef}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSlotRef}.
  *
  * @alpha
  */
-export function isReportLayoutSlotRef(obj) {
+export function isPublisherLayoutSlotRef(obj) {
     return !isEmpty(obj) && obj.type === "slotRef";
 }

package/esm/publisher/pageFormat.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Page shape a page layout is designed for.
+ *
+ * @remarks
+ * A layout's geometry only reads correctly at the proportions it was authored for: a row of three
+ * visualizations that works on a widescreen page is unusably narrow on an upright page. The format
+ * is therefore a property of the page, not a choice made when rendering it.
+ *
+ * @alpha
+ */
+export type PublisherPageFormat = "widescreen" | "a4Portrait" | "letterPortrait";
+/**
+ * Format assumed by a page that declares none, which keeps pages authored before formats existed
+ * on the shape they were designed for.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageFormat: PublisherPageFormat;
+/**
+ * List of built-in page format names.
+ *
+ * @alpha
+ */
+export declare const PublisherPageFormats: PublisherPageFormat[];
+/**
+ * Width divided by height for each page format: 16:9 for a widescreen page, ISO A4 (210 x 297 mm) and
+ * US Letter (8.5 x 11 in) upright.
+ *
+ * @alpha
+ */
+export declare const PublisherPageFormatAspectRatios: Record<PublisherPageFormat, number>;
+/**
+ * Type-guard testing whether the provided value is a {@link PublisherPageFormat}.
+ *
+ * @alpha
+ */
+export declare function isPublisherPageFormat(value: unknown): value is PublisherPageFormat;
+//# sourceMappingURL=pageFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageFormat.d.ts","sourceRoot":"","sources":["../../src/publisher/pageFormat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBAAkC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EAAmD,CAAC;AAE1G;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAI/E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF"}

package/esm/publisher/pageFormat.js

@@ -0,0 +1,33 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Format assumed by a page that declares none, which keeps pages authored before formats existed
+ * on the shape they were designed for.
+ *
+ * @alpha
+ */
+export const DefaultPublisherPageFormat = "widescreen";
+/**
+ * List of built-in page format names.
+ *
+ * @alpha
+ */
+export const PublisherPageFormats = ["widescreen", "a4Portrait", "letterPortrait"];
+/**
+ * Width divided by height for each page format: 16:9 for a widescreen page, ISO A4 (210 x 297 mm) and
+ * US Letter (8.5 x 11 in) upright.
+ *
+ * @alpha
+ */
+export const PublisherPageFormatAspectRatios = {
+    widescreen: 16 / 9,
+    a4Portrait: 210 / 297,
+    letterPortrait: 8.5 / 11,
+};
+/**
+ * Type-guard testing whether the provided value is a {@link PublisherPageFormat}.
+ *
+ * @alpha
+ */
+export function isPublisherPageFormat(value) {
+    return typeof value === "string" && PublisherPageFormats.includes(value);
+}