@gooddata/sdk-model 11.63.0-alpha.1 → 11.63.0-alpha.3

package/esm/sdk-model.d.ts

@@ -43,7 +43,7 @@ export declare type AccessGranularPermission = "VIEW" | "EDIT" | "SHARE";
  *
  * @alpha
  */
-export declare type AgentCustomSkill = "alert" | "anomaly_detection" | "clustering" | "dashboard_builder" | "dashboard_editor" | "dashboard_summary" | "forecasting" | "key_driver_analysis" | "metric" | "schedule_export" | "visualization" | "visualization_summary" | "what_if_analysis" | "knowledge" | "report_builder";
+export declare type AgentCustomSkill = "alert" | "anomaly_detection" | "clustering" | "dashboard_builder" | "dashboard_editor" | "dashboard_summary" | "document_builder" | "forecasting" | "key_driver_analysis" | "metric" | "schedule_export" | "visualization" | "visualization_summary" | "what_if_analysis" | "knowledge" | "report_builder";
 
 /**
  * Determines when an agent instruction is applied to a request.
@@ -970,105 +970,6 @@ export declare function bucketsTotals(buckets: IBucket[]): ITotal[];
  */
 export declare function bucketTotals(bucket: IBucket): ITotal[];
 
-/**
- * Current version of {@link BuiltInPublisherPageLayoutCoverV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutCover: IPublisherPageLayoutV1;
-
-/**
- * Built-in cover page: document title and subtitle.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutCoverV1: IPublisherPageLayoutV1;
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutPortraitCoverV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitCover: IPublisherPageLayoutV1;
-
-/**
- * Built-in portrait cover page: document title and subtitle.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitCoverV1: IPublisherPageLayoutV1;
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutPortraitSectionV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitSection: IPublisherPageLayoutV1;
-
-/**
- * Built-in portrait section divider page.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitSectionV1: IPublisherPageLayoutV1;
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutPortraitSummaryV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitSummary: IPublisherPageLayoutV1;
-
-/**
- * Built-in portrait page carrying a full-page narrative, with no visualization.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutPortraitSummaryV1: IPublisherPageLayoutV1;
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutsV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayouts: readonly IPublisherPageLayoutV1[];
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutSectionV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutSection: IPublisherPageLayoutV1;
-
-/**
- * Built-in section divider page.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutSectionV1: IPublisherPageLayoutV1;
-
-/**
- * All built-in page layouts served by the SPI. Built-ins are read-only: they cannot be
- * edited or deleted, and they are never persisted on the backend.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutsV1: readonly IPublisherPageLayoutV1[];
-
-/**
- * Current version of {@link BuiltInPublisherPageLayoutViz6TextLeftV1}.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutViz6TextLeft: IPublisherPageLayoutV1;
-
-/**
- * Built-in content page with six visualizations and a text column on the left.
- *
- * @alpha
- */
-export declare const BuiltInPublisherPageLayoutViz6TextLeftV1: IPublisherPageLayoutV1;
-
 /**
  * Current version of {@link BuiltInPublisherSlotTypesV1}.
  *
@@ -1972,6 +1873,105 @@ export declare const DefaultPublisherPageFormatV1: PublisherPageFormatV1;
  */
 export declare const DefaultPublisherPageSizeV2: PublisherPageSizeV2;
 
+/**
+ * Current version of {@link DefaultPublisherPageTemplateCoverV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateCover: IPublisherPageTemplateV1;
+
+/**
+ * Default cover page: document title and subtitle.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateCoverV1: IPublisherPageTemplateV1;
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplatePortraitCoverV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitCover: IPublisherPageTemplateV1;
+
+/**
+ * Default portrait cover page: document title and subtitle.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitCoverV1: IPublisherPageTemplateV1;
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplatePortraitSectionV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSection: IPublisherPageTemplateV1;
+
+/**
+ * Default portrait section divider page.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSectionV1: IPublisherPageTemplateV1;
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplatePortraitSummaryV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSummary: IPublisherPageTemplateV1;
+
+/**
+ * Default portrait page carrying a full-page narrative, with no visualization.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplatePortraitSummaryV1: IPublisherPageTemplateV1;
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplatesV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplates: readonly IPublisherPageTemplateV1[];
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplateSectionV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateSection: IPublisherPageTemplateV1;
+
+/**
+ * Default section divider page.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateSectionV1: 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[];
+
+/**
+ * Current version of {@link DefaultPublisherPageTemplateViz6TextLeftV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateViz6TextLeft: IPublisherPageTemplateV1;
+
+/**
+ * Default content page with six visualizations and a text column on the left.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageTemplateViz6TextLeftV1: IPublisherPageTemplateV1;
+
 /**
  * Current version of {@link DefaultPublisherParagraphTypeV1}.
  *
@@ -3016,6 +3016,24 @@ export declare const getPublisherTextPlaceholders: typeof getPublisherTextPlaceh
  */
 export declare function getPublisherTextPlaceholdersV1(text: string): string[];
 
+/**
+ * Collects the distinct `{variable}` names referenced in the text, in order of first occurrence.
+ *
+ * @alpha
+ */
+export declare function getPublisherTextPlaceholdersV2(text: string): string[];
+
+/**
+ * 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;
+
 /**
  * Returns count of selected elements
  * @alpha
@@ -12832,7 +12850,7 @@ export declare interface IPublisherDocumentPagesContentV2 extends IPublisherDocu
  * 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.
@@ -13192,7 +13210,7 @@ export declare interface IPublisherInheritedTextStyleV2 {
 export declare type IPublisherLayoutNodeBase = IPublisherLayoutNodeBaseV1;
 
 /**
- * Fields common to all page layout nodes.
+ * Fields common to all layout nodes.
  *
  * @alpha
  */
@@ -13222,7 +13240,7 @@ export declare interface IPublisherLayoutSectionV1 extends IPublisherLayoutNodeB
      * "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.
      */
@@ -13275,7 +13293,7 @@ export declare type IPublisherPageBody = IPublisherPageBodyV1;
  * 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
@@ -13300,9 +13318,9 @@ export declare 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.
      */
@@ -13349,25 +13367,35 @@ export declare interface IPublisherPageBodyValidationIssueV1 {
 }
 
 /**
- * Current version of {@link IPublisherPageLayoutV1}.
+ * @alpha
+ */
+export declare interface IPublisherPageStyleV2 extends IPublisherBackgroundStyleV2, IPublisherPaddingStyleV2, IPublisherInheritedTextStyleV2 {
+    /**
+     * Default gap of every container on the page.
+     */
+    gap?: PublisherGapValueV2;
+}
+
+/**
+ * Current version of {@link IPublisherPageTemplateV1}.
  *
  * @alpha
  */
-export declare type IPublisherPageLayout = IPublisherPageLayoutV1;
+export declare type IPublisherPageTemplate = IPublisherPageTemplateV1;
 
 /**
- * Current version of {@link IPublisherPageLayoutContentV1}.
+ * Current version of {@link IPublisherPageTemplateContentV1}.
  *
  * @alpha
  */
-export declare type IPublisherPageLayoutContent = IPublisherPageLayoutContentV1;
+export declare type IPublisherPageTemplateContent = IPublisherPageTemplateContentV1;
 
 /**
  * Stored content of the reportPage entity.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayoutContentV1 extends IPublisherPageBodyV1 {
+export declare interface IPublisherPageTemplateContentV1 extends IPublisherPageBodyV1 {
     /**
      * Content model version, for stored-content evolution.
      */
@@ -13375,18 +13403,18 @@ export declare interface IPublisherPageLayoutContentV1 extends IPublisherPageBod
 }
 
 /**
- * Current version of {@link IPublisherPageLayoutDefinitionV1}.
+ * Current version of {@link IPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare type IPublisherPageLayoutDefinition = IPublisherPageLayoutDefinitionV1;
+export declare type IPublisherPageTemplateDefinition = IPublisherPageTemplateDefinitionV1;
 
 /**
- * Payload for creating or updating a page layout.
+ * Payload for creating or updating a page template.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayoutDefinitionV1 {
+export declare interface IPublisherPageTemplateDefinitionV1 {
     type: "reportPageLayout";
     /**
      * Present when updating an existing page.
@@ -13395,15 +13423,25 @@ export declare interface IPublisherPageLayoutDefinitionV1 {
     title: string;
     description?: string;
     tags?: string[];
-    content: IPublisherPageLayoutContentV1;
+    content: IPublisherPageTemplateContentV1;
 }
 
 /**
- * Reusable page layout metadata object.
+ * Payload for creating or updating a page template.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayoutV1 extends IPublisherPageLayoutDefinitionV1, IAuditableDates, IAuditableUsers {
+export declare interface IPublisherPageTemplateDefinitionV2 extends IPublisherEntityDefinitionBaseV2 {
+    type: "pageTemplate";
+    content: IPublisherPageBodyV2;
+}
+
+/**
+ * Reusable page template metadata object.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageTemplateV1 extends IPublisherPageTemplateDefinitionV1, IAuditableDates, IAuditableUsers {
     ref: ObjRef;
     /**
      * When true, the object comes from a parent workspace and is not editable
@@ -13412,29 +13450,9 @@ export declare interface IPublisherPageLayoutV1 extends IPublisherPageLayoutDefi
     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.
-     */
-    isBuiltIn?: boolean;
-}
-
-/**
- * @alpha
- */
-export declare interface IPublisherPageStyleV2 extends IPublisherBackgroundStyleV2, IPublisherPaddingStyleV2, IPublisherInheritedTextStyleV2 {
-    /**
-     * Default gap of every container on the page.
+     * stored on the backend; UI must disable deletion and editing of default page templates.
      */
-    gap?: PublisherGapValueV2;
-}
-
-/**
- * Payload for creating or updating a page template.
- *
- * @alpha
- */
-export declare interface IPublisherPageTemplateDefinitionV2 extends IPublisherEntityDefinitionBaseV2 {
-    type: "pageTemplate";
-    content: IPublisherPageBodyV2;
+    isDefault?: boolean;
 }
 
 /**
@@ -13583,7 +13601,7 @@ export declare interface IPublisherSlotBaseV1 {
 export declare type IPublisherSlotPlaceholder = IPublisherSlotPlaceholderV1;
 
 /**
- * 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
  */
@@ -16499,49 +16517,49 @@ export declare const isPublisherPageFormat: typeof isPublisherPageFormatV1;
 export declare function isPublisherPageFormatV1(value: unknown): value is PublisherPageFormatV1;
 
 /**
- * Current version of {@link isPublisherPageLayoutV1}.
- *
  * @alpha
  */
-export declare const isPublisherPageLayout: typeof isPublisherPageLayoutV1;
+export declare function isPublisherPageSizeV2(value: unknown): value is PublisherPageSizeV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutContentV1}.
+ * Current version of {@link isPublisherPageTemplateV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutContentV1(obj: unknown): obj is IPublisherPageLayoutContentV1;
+export declare const isPublisherPageTemplate: typeof isPublisherPageTemplateV1;
 
 /**
- * Current version of {@link isPublisherPageLayoutDefinitionV1}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateContentV1}.
  *
  * @alpha
  */
-export declare const isPublisherPageLayoutDefinition: typeof isPublisherPageLayoutDefinitionV1;
+export declare function isPublisherPageTemplateContentV1(obj: unknown): obj is IPublisherPageTemplateContentV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutDefinitionV1}.
+ * Current version of {@link isPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutDefinitionV1(obj: unknown): obj is IPublisherPageLayoutDefinitionV1;
+export declare const isPublisherPageTemplateDefinition: typeof isPublisherPageTemplateDefinitionV1;
 
 /**
- * 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 IPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayoutV1(obj: unknown): obj is IPublisherPageLayoutV1;
+export declare function isPublisherPageTemplateDefinitionV1(obj: unknown): obj is IPublisherPageTemplateDefinitionV1;
 
 /**
  * @alpha
  */
-export declare function isPublisherPageSizeV2(value: unknown): value is PublisherPageSizeV2;
+export declare function isPublisherPageTemplateDefinitionV2(obj: unknown): obj is IPublisherPageTemplateDefinitionV2;
 
 /**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageTemplateV1}.
+ *
  * @alpha
  */
-export declare function isPublisherPageTemplateDefinitionV2(obj: unknown): obj is IPublisherPageTemplateDefinitionV2;
+export declare function isPublisherPageTemplateV1(obj: unknown): obj is IPublisherPageTemplateV1;
 
 /**
  * @alpha
@@ -17321,6 +17339,13 @@ export declare interface ITheme {
      * @alpha
      */
     reports?: IThemePublisher;
+    /**
+     * How documents with content version 2 look. Version 1 documents read `reports` until the
+     * switch to version 2.
+     *
+     * @alpha
+     */
+    documents?: IThemeDocuments;
     /**
      * Image assets offered to documents
      *
@@ -17939,6 +17964,239 @@ export declare interface IThemeDefinition extends Partial<IMetadataObject> {
     readonly theme: ITheme;
 }
 
+/**
+ * How documents with content version 2 look.
+ *
+ * @remarks
+ * A key left out falls back to the matching platform key, then the complementary palette, then the
+ * built-in default. Only documents follow it; the Publisher UI around them follows the platform theme.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocuments {
+    colors?: IThemeDocumentsColors;
+    textStyle?: IThemeDocumentsTextStyle;
+    chart?: IPublisherChartStyleV2;
+    table?: IPublisherTableStyleV2;
+    headline?: IPublisherHeadlineStyleV2;
+    shadows?: Record<string, IThemeDocumentsShadow>;
+    /**
+     * The default look of a takeaway widget.
+     */
+    takeaway?: IPublisherTextWidgetStyleV2;
+    page?: IThemeDocumentsPage;
+    corners?: IThemeDocumentsCorners;
+    spacing?: IThemeDocumentsSpacing;
+}
+
+/**
+ * A color offered to documents. Content stores its id, never its position in the list.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsColor {
+    id: string;
+    /**
+     * Absent: the role keeps its inherited value. May reference `{theme.palette.<name>}`.
+     */
+    color?: PublisherColorValueV2;
+}
+
+/**
+ * Colors offered to documents, one list per kind of paint.
+ *
+ * @remarks
+ * The ids `default`, `surface` and `inverse` (backgrounds), `default`, `muted` and `inverse` (texts),
+ * `default` (lines) and `accent` (any list) always resolve, falling back to the platform palette.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsColors {
+    backgrounds?: IThemeDocumentsColor[];
+    texts?: IThemeDocumentsColor[];
+    /**
+     * Borders, dividers, accent bars, gridlines and axis lines.
+     */
+    lines?: IThemeDocumentsColor[];
+    /**
+     * Colors of visualizations: stated inline, or a reference to a color palette object. When
+     * absent, documents use the workspace's active color palette.
+     */
+    visualizationPalette?: PublisherColorValueV2[] | IThemeColorPaletteRef;
+}
+
+/**
+ * Corner radius steps; `full` is built in.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsCorners {
+    small?: ThemeDocumentsLength;
+    medium?: ThemeDocumentsLength;
+    large?: ThemeDocumentsLength;
+}
+
+/**
+ * One hosted font file registered as a font face for documents.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsFontFace {
+    family: string;
+    url: string;
+    /**
+     * `"400 700"` covers a variable font's range with one face.
+     */
+    weight?: number | string;
+    style?: "normal" | "italic";
+    unicodeRange?: string;
+}
+
+/**
+ * Heading text styles.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsHeading extends IThemeDocumentsTextGroup {
+    h1?: IThemeDocumentsTextLevel;
+    h2?: IThemeDocumentsTextLevel;
+    h3?: IThemeDocumentsTextLevel;
+    h4?: IThemeDocumentsTextLevel;
+    h5?: IThemeDocumentsTextLevel;
+    h6?: IThemeDocumentsTextLevel;
+}
+
+/**
+ * The look of marked text: strong, emphasis, highlight or link.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsMarkStyle {
+    color?: PublisherColorValueV2;
+    backgroundColor?: PublisherColorValueV2;
+    fontWeight?: number;
+    fontStyle?: "normal" | "italic";
+}
+
+/**
+ * Page defaults of documents.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsPage {
+    padding?: PublisherPaddingValueV2;
+    gap?: PublisherGapValueV2;
+}
+
+/**
+ * A named shadow, referenced from content as `{theme.shadows.<name>}`.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsShadow {
+    x?: number;
+    y?: number;
+    blur?: ThemeDocumentsLength;
+    spread?: number;
+    color?: PublisherColorValueV2;
+    opacity?: number;
+}
+
+/**
+ * Spacing scales of documents.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsSpacing {
+    gap?: IThemeDocumentsSteps;
+    padding?: IThemeDocumentsSteps;
+}
+
+/**
+ * The named steps of a document spacing scale.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsSteps {
+    compact?: ThemeDocumentsLength;
+    normal?: ThemeDocumentsLength;
+    spacious?: ThemeDocumentsLength;
+}
+
+/**
+ * Body text styles.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsText extends IThemeDocumentsTextGroup {
+    largeText?: IThemeDocumentsTextLevel;
+    normalText?: IThemeDocumentsTextLevel;
+    smallText?: IThemeDocumentsTextLevel;
+}
+
+/**
+ * Values a group of text styles shares unless a level sets its own.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsTextGroup {
+    color?: PublisherColorValueV2;
+    /**
+     * A multiple of the font size.
+     */
+    lineHeight?: number;
+}
+
+/**
+ * One named text style.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsTextLevel extends IThemeDocumentsTextGroup {
+    fontSize?: ThemeDocumentsLength;
+}
+
+/**
+ * The named text styles of documents.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsTextStyle {
+    typography?: IThemeDocumentsTypography;
+    /**
+     * Falls back to `heading.h1`.
+     */
+    title?: IThemeDocumentsTextLevel;
+    heading?: IThemeDocumentsHeading;
+    text?: IThemeDocumentsText;
+    /**
+     * Default: bold.
+     */
+    strong?: IThemeDocumentsMarkStyle;
+    /**
+     * Default: italic.
+     */
+    emphasis?: IThemeDocumentsMarkStyle;
+    highlight?: IThemeDocumentsMarkStyle;
+    /**
+     * Default color: `{theme.palette.primary}`.
+     */
+    link?: IThemeDocumentsMarkStyle;
+}
+
+/**
+ * Fonts of documents.
+ *
+ * @alpha
+ */
+export declare interface IThemeDocumentsTypography {
+    /**
+     * A CSS font family list; a name with a digit must be quoted.
+     */
+    fontFamily?: string;
+    fonts?: IThemeDocumentsFontFace[];
+}
+
 /**
  *
  * @beta
@@ -20699,14 +20957,14 @@ export declare function newPublisherDocumentDefinitionFromTemplateV1(template: I
 export declare function newPublisherDocumentFilterIdV2({ target, usedIds, }: INewPublisherDocumentFilterIdOptionsV2): string;
 
 /**
- * Current version of {@link newPublisherDocumentPageFromLayoutV1}.
+ * Current version of {@link newPublisherDocumentPageFromTemplateV1}.
  *
  * @alpha
  */
-export declare const newPublisherDocumentPageFromLayout: typeof newPublisherDocumentPageFromLayoutV1;
+export declare const newPublisherDocumentPageFromTemplate: typeof newPublisherDocumentPageFromTemplateV1;
 
 /**
- * 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.
@@ -20715,7 +20973,7 @@ export declare const newPublisherDocumentPageFromLayout: typeof newPublisherDocu
  *
  * @alpha
  */
-export declare function newPublisherDocumentPageFromLayoutV1(page: IPublisherPageLayoutV1 | IPublisherPageLayoutDefinitionV1, localIdentifier?: string): IPublisherDocumentPageV1;
+export declare function newPublisherDocumentPageFromTemplateV1(page: IPublisherPageTemplateV1 | IPublisherPageTemplateDefinitionV1, localIdentifier?: string): IPublisherDocumentPageV1;
 
 /**
  * Copies a page template's content into a new document page.
@@ -20763,18 +21021,18 @@ export declare function newPublisherIdV2(prefix: string): string;
 export declare function newPublisherPageIdV2(): string;
 
 /**
- * Current version of {@link newPublisherPageLayoutDefinitionV1}.
+ * Current version of {@link newPublisherPageTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare const newPublisherPageLayoutDefinition: typeof newPublisherPageLayoutDefinitionV1;
+export declare const newPublisherPageTemplateDefinition: typeof newPublisherPageTemplateDefinitionV1;
 
 /**
- * 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;
 
 /**
  * Generates a section id such as `section_7f3a91c4`.
@@ -21468,6 +21726,22 @@ export declare type PublisherImageSourceV1 = {
  */
 export declare type PublisherImageSourceV2 = string;
 
+/**
+ * Current version of {@link PublisherLayoutNodeV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherLayoutNode = PublisherLayoutNodeV1;
+
+/**
+ * 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 declare type PublisherLayoutNodeV1 = IPublisherLayoutSectionV1 | IPublisherLayoutSlotRefV1;
+
 /**
  * @alpha
  */
@@ -21522,7 +21796,7 @@ export declare const PublisherPageFormats: PublisherPageFormatV1[];
 export declare const PublisherPageFormatsV1: PublisherPageFormatV1[];
 
 /**
- * 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
@@ -21540,22 +21814,6 @@ export declare type PublisherPageFormatV1 = "widescreen" | "a4Portrait" | "lette
  */
 export declare type PublisherPageKindV2 = "cover" | "section" | "content";
 
-/**
- * Current version of {@link PublisherPageLayoutNodeV1}.
- *
- * @alpha
- */
-export declare type PublisherPageLayoutNode = PublisherPageLayoutNodeV1;
-
-/**
- * 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 IPublisherPageBodyV1.slots}.
- *
- * @alpha
- */
-export declare type PublisherPageLayoutNodeV1 = IPublisherLayoutSectionV1 | IPublisherLayoutSlotRefV1;
-
 /**
  * @alpha
  */
@@ -21651,6 +21909,13 @@ export declare const publisherTextPlaceholder: typeof publisherTextPlaceholderV1
  */
 export declare function publisherTextPlaceholderV1(name: string): string;
 
+/**
+ * The marker referencing the variable from document text.
+ *
+ * @alpha
+ */
+export declare function publisherTextPlaceholderV2(name: PublisherTextVariableV2): string;
+
 /**
  * Current version of {@link publisherTextSlotTypeV1}.
  *
@@ -21737,6 +22002,27 @@ export declare const PublisherTextTypesV1: PublisherTextTypeV1[];
  */
 export declare type PublisherTextTypeV1 = PublisherHeadingTypeV1 | PublisherParagraphTypeV1;
 
+/**
+ * All document text variable names.
+ *
+ * @alpha
+ */
+export declare const PublisherTextVariablesV2: readonly PublisherTextVariableV2[];
+
+/**
+ * A variable every document resolves, referenced from text as `{name}`.
+ *
+ * @alpha
+ */
+export declare type PublisherTextVariableV2 = "documentName" | "documentDescription" | "documentDateRange" | "documentAttributeFilters" | "periodStart" | "periodEnd" | "lastModifiedAt" | "lastModifiedBy" | "exportedAt" | "exportedBy" | "workspaceName" | "workspaceId" | "currentPageNumber" | "totalPages";
+
+/**
+ * The theme reference to the path, such as `{theme.assets.images.cover}`.
+ *
+ * @alpha
+ */
+export declare function publisherThemeReferenceV2(path: readonly string[]): string;
+
 /**
  * @alpha
  */
@@ -21852,6 +22138,13 @@ export declare const resolvePublisherTextPlaceholders: typeof resolvePublisherTe
  */
 export declare function resolvePublisherTextPlaceholdersV1(text: string, values: Record<string, 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;
+
 /**
  * Resolves a dashboard timezone value to a concrete IANA timezone ID: the {@link BROWSER_DETECTED}
  * sentinel resolves to the browser/runtime timezone, any other value is returned as-is.
@@ -22098,6 +22391,13 @@ export declare type ThemeColor = string;
  */
 export declare type ThemeDashboardDensity = "comfortable" | "compact";
 
+/**
+ * A length on the document page canvas, in px. Units are not accepted.
+ *
+ * @alpha
+ */
+export declare type ThemeDocumentsLength = number;
+
 /**
  * Custom font URI which is used to override the default font
  *