@gooddata/sdk-model 11.62.0-alpha.3 → 11.62.0-alpha.4

package/esm/sdk-model.d.ts

@@ -970,33 +970,82 @@ 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 BuiltInPublisherPageLayoutCover: IPublisherPageLayout;
+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 BuiltInPublisherPageLayoutPortraitCover: IPublisherPageLayout;
+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 BuiltInPublisherPageLayoutPortraitSection: IPublisherPageLayout;
+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 BuiltInPublisherPageLayoutPortraitSummary: IPublisherPageLayout;
+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
@@ -1004,29 +1053,36 @@ export declare const BuiltInPublisherPageLayoutPortraitSummary: IPublisherPageLa
  *
  * @alpha
  */
-export declare const BuiltInPublisherPageLayouts: readonly IPublisherPageLayout[];
+export declare const BuiltInPublisherPageLayoutsV1: readonly IPublisherPageLayoutV1[];
 
 /**
- * Built-in section divider page.
+ * Current version of {@link BuiltInPublisherPageLayoutViz6TextLeftV1}.
  *
  * @alpha
  */
-export declare const BuiltInPublisherPageLayoutSection: IPublisherPageLayout;
+export declare const BuiltInPublisherPageLayoutViz6TextLeft: IPublisherPageLayoutV1;
 
 /**
  * Built-in content page with six visualizations and a text column on the left.
  *
  * @alpha
  */
-export declare const BuiltInPublisherPageLayoutViz6TextLeft: IPublisherPageLayout;
+export declare const BuiltInPublisherPageLayoutViz6TextLeftV1: IPublisherPageLayoutV1;
 
 /**
- * List of built-in document slot type names.
+ * Current version of {@link BuiltInPublisherSlotTypesV1}.
  *
  * @alpha
  */
 export declare const BuiltInPublisherSlotTypes: string[];
 
+/**
+ * List of built-in document slot type names.
+ *
+ * @alpha
+ */
+export declare const BuiltInPublisherSlotTypesV1: string[];
+
 /**
  * List of built-in widget types. These type names are reserved and must not be used by custom widgets.
  *
@@ -1882,12 +1938,26 @@ export declare function defaultDimensionsGenerator(definition: IExecutionDefinit
  */
 export declare const DefaultLocale: ILocale;
 
+/**
+ * Current version of {@link DefaultPublisherHeadingTypeV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherHeadingType: PublisherHeadingTypeV1;
+
 /**
  * Size a heading slot that states none is rendered at.
  *
  * @alpha
  */
-export declare const DefaultPublisherHeadingType: PublisherHeadingType;
+export declare const DefaultPublisherHeadingTypeV1: PublisherHeadingTypeV1;
+
+/**
+ * Current version of {@link DefaultPublisherPageFormatV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherPageFormat: PublisherPageFormatV1;
 
 /**
  * Format assumed by a page that declares none, which keeps pages authored before formats existed
@@ -1895,14 +1965,26 @@ export declare const DefaultPublisherHeadingType: PublisherHeadingType;
  *
  * @alpha
  */
-export declare const DefaultPublisherPageFormat: PublisherPageFormat;
+export declare const DefaultPublisherPageFormatV1: PublisherPageFormatV1;
+
+/**
+ * @alpha
+ */
+export declare const DefaultPublisherPageSizeV2: PublisherPageSizeV2;
+
+/**
+ * Current version of {@link DefaultPublisherParagraphTypeV1}.
+ *
+ * @alpha
+ */
+export declare const DefaultPublisherParagraphType: PublisherParagraphTypeV1;
 
 /**
  * Size a paragraph slot that states none is rendered at.
  *
  * @alpha
  */
-export declare const DefaultPublisherParagraphType: PublisherParagraphType;
+export declare const DefaultPublisherParagraphTypeV1: PublisherParagraphTypeV1;
 
 /**
  * Calculates fingerprint for the execution definition.
@@ -2920,12 +3002,19 @@ export declare function getPluggableApplicationHref(app: PluggableApplicationReg
  */
 export declare function getPluggableApplicationLocalizedTitle(app: PluggableApplicationRegistryItem, locale: ILocale | undefined): string;
 
+/**
+ * Current version of {@link getPublisherTextPlaceholdersV1}.
+ *
+ * @alpha
+ */
+export declare const getPublisherTextPlaceholders: typeof getPublisherTextPlaceholdersV1;
+
 /**
  * Collects the distinct `{variable}` names referenced in the text, in order of first occurrence.
  *
  * @alpha
  */
-export declare function getPublisherTextPlaceholders(text: string): string[];
+export declare function getPublisherTextPlaceholdersV1(text: string): string[];
 
 /**
  * Returns count of selected elements
@@ -7880,7 +7969,6 @@ export declare interface IFeatureFlags {
     enableOracleDataSource?: boolean;
     enableOidcAuth?: boolean;
     enableMotherDuckDataSource?: boolean;
-    enableMongoDbDataSource?: boolean;
     enableStarrocksDataSource?: boolean;
     enableSingleStoreDataSource?: boolean;
     enableDenodoDataSource?: boolean;
@@ -8353,6 +8441,10 @@ export declare interface IFeatureFlags {
      * Enable the templates and page layouts screens of the Business Briefing reports application.
      */
     enableReportsSubsections?: boolean;
+    /**
+     * Enable Publisher v2.
+     */
+    enablePublisherV2?: boolean;
     /**
      * Enable the write and export postMessage commands for embedded dashboards and Analytical Designer.
      *
@@ -8373,6 +8465,13 @@ export declare interface IFeatureFlags {
      * Disabled by default.
      */
     enableLocalizationOverview?: boolean;
+    /**
+     * Enable the new rendering of charts in the AI Assistant.
+     *
+     * @remarks
+     * Disabled by default.
+     */
+    enableAiAssistantChartsV2?: boolean;
 }
 
 /**
@@ -8838,8 +8937,9 @@ export declare interface IGenAIPublisherDocumentContext {
     title?: string;
     /**
      * Document definition as the user sees it, including edits that are not saved yet.
+     * Pinned to the v1 type because the v1 copilot reads it; it does not follow newer Publisher versions.
      */
-    definition?: IPublisherDocumentDefinition;
+    definition?: IPublisherDocumentDefinitionV1;
     /**
      * Name of the conversation draft the editor shows, while that draft is not saved yet.
      */
@@ -10938,6 +11038,20 @@ export declare interface INegativeAttributeFilterBody extends IIdentifiableFilte
     notIn: IAttributeElements;
 }
 
+/**
+ * @alpha
+ */
+export declare interface INewPublisherDocumentFilterIdOptionsV2 {
+    /**
+     * The label of an attribute filter or the dataset of a date filter, as an identifier ref.
+     */
+    target: ObjRef;
+    /**
+     * Local identifiers of the document's `content.filters`.
+     */
+    usedIds: ReadonlySet<string>;
+}
+
 /**
  * Builder for inline measures.
  *
@@ -12232,12 +12346,37 @@ export declare interface IProductionFeaturesConfig {
     features?: IProductionFeatureConfig[];
 }
 
+/**
+ * Both ends are inclusive.
+ *
+ * @alpha
+ */
+export declare interface IPublisherAbsolutePeriodV2 {
+    type: "absolute";
+    granularity: "GDC.time.date";
+    /**
+     * `YYYY-MM-DD`.
+     */
+    from: string;
+    /**
+     * `YYYY-MM-DD`.
+     */
+    to: string;
+}
+
+/**
+ * Current version of {@link IPublisherAiTextSourceV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherAiTextSource = IPublisherAiTextSourceV1;
+
 /**
  * Text generated by AI at document-build time.
  *
  * @alpha
  */
-export declare interface IPublisherAiTextSource {
+export declare interface IPublisherAiTextSourceV1 {
     type: "ai";
     /**
      * Instruction for the generator. Supports `{variables}`.
@@ -12254,13 +12393,99 @@ export declare interface IPublisherAiTextSource {
     generatedAt?: string;
 }
 
+/**
+ * Current version of {@link IPublisherAttributeFilterConfigV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherAttributeFilterConfig = IPublisherAttributeFilterConfigV1;
+
 /**
  * Configuration of a document's content-level attribute filter: the part of a dashboard attribute
  * filter's configuration that documents support.
  *
  * @alpha
  */
-export declare type IPublisherAttributeFilterConfig = Pick<IDashboardAttributeFilterConfig, "localIdentifier" | "displayAsLabel">;
+export declare type IPublisherAttributeFilterConfigV1 = Pick<IDashboardAttributeFilterConfig, "localIdentifier" | "displayAsLabel">;
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherAxisDisplayV2 {
+    visible?: boolean;
+    /**
+     * The axis title.
+     */
+    name?: {
+        visible?: boolean;
+        position?: "low" | "middle" | "high";
+    };
+    /**
+     * The tick labels. Rotation is in degrees, -90 to 90.
+     */
+    values?: {
+        visible?: boolean;
+        rotation?: number;
+    };
+    min?: number;
+    max?: number;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherBackgroundStyleV2 {
+    backgroundColor?: PublisherColorValueV2;
+    /**
+     * Opacity of the background color only.
+     */
+    backgroundOpacity?: PublisherOpacityV2;
+    backgroundImage?: PublisherImageSourceV2;
+    backgroundImageOpacity?: PublisherOpacityV2;
+    /**
+     * Defaults to `cover`.
+     */
+    backgroundFit?: "cover" | "contain" | "fill" | "tile";
+    backgroundHorizontalAlign?: PublisherHorizontalAlignV2;
+    backgroundVerticalAlign?: PublisherVerticalAlignV2;
+    backgroundOffset?: PublisherPxV2;
+    backgroundOffsetTop?: PublisherPxV2;
+    backgroundOffsetRight?: PublisherPxV2;
+    backgroundOffsetBottom?: PublisherPxV2;
+    backgroundOffsetLeft?: PublisherPxV2;
+}
+
+/**
+ * @remarks
+ * A side key wins over the matching all-sides key in any order. `borderStyle` defaults to `solid`,
+ * so a width alone draws a line.
+ *
+ * @alpha
+ */
+export declare interface IPublisherBorderStyleV2 {
+    borderWidth?: PublisherPxV2;
+    borderStyle?: PublisherBorderLineStyleV2;
+    borderColor?: PublisherColorValueV2;
+    borderTopWidth?: PublisherPxV2;
+    borderTopStyle?: PublisherBorderLineStyleV2;
+    borderTopColor?: PublisherColorValueV2;
+    borderRightWidth?: PublisherPxV2;
+    borderRightStyle?: PublisherBorderLineStyleV2;
+    borderRightColor?: PublisherColorValueV2;
+    borderBottomWidth?: PublisherPxV2;
+    borderBottomStyle?: PublisherBorderLineStyleV2;
+    borderBottomColor?: PublisherColorValueV2;
+    borderLeftWidth?: PublisherPxV2;
+    borderLeftStyle?: PublisherBorderLineStyleV2;
+    borderLeftColor?: PublisherColorValueV2;
+}
+
+/**
+ * Current version of {@link IPublisherBoxStyleV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherBoxStyle = IPublisherBoxStyleV1;
 
 /**
  * Paint of the box itself. Never affects the geometry of the box or its children —
@@ -12268,8 +12493,8 @@ export declare type IPublisherAttributeFilterConfig = Pick<IDashboardAttributeFi
  *
  * @alpha
  */
-export declare interface IPublisherBoxStyle {
-    background?: PublisherBackground;
+export declare interface IPublisherBoxStyleV1 {
+    background?: PublisherBackgroundV1;
     /**
      * Corner radius in percent of the page width — the same relative unit the rest of a document page
      * is sized in, so the corners keep their proportion however large the page is rendered.
@@ -12278,19 +12503,63 @@ export declare interface IPublisherBoxStyle {
     borderRadius?: number;
     /**
      * Inset of the box's own content, in percent of the page width like
-     * {@link IPublisherBoxStyle.borderRadius}. Insets only inward — siblings and the layout
+     * {@link IPublisherBoxStyleV1.borderRadius}. Insets only inward — siblings and the layout
      * gaps around the box are untouched. A box that paints a background usually wants one;
      * a full-bleed box (an image-backed cover) wants none, which is why no default exists.
      */
     padding?: number;
 }
 
+/**
+ * Box keys. They apply to the node they are set on and never inherit.
+ *
+ * @alpha
+ */
+export declare interface IPublisherBoxStyleV2 extends IPublisherBackgroundStyleV2, IPublisherPaddingStyleV2, IPublisherBorderStyleV2, IPublisherCornerStyleV2, IPublisherShadowStyleV2 {
+    /**
+     * Opacity of the whole node, content included.
+     */
+    opacity?: PublisherOpacityV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherChartStyleV2 {
+    fontSize?: PublisherPxV2;
+    textColor?: PublisherColorValueV2;
+    axisLineColor?: PublisherColorValueV2;
+    /**
+     * Color of the axis title.
+     */
+    axisNameColor?: PublisherColorValueV2;
+    axisNameSize?: PublisherPxV2;
+    /**
+     * Color of the tick labels.
+     */
+    axisValueColor?: PublisherColorValueV2;
+    axisValueSize?: PublisherPxV2;
+    gridColor?: PublisherColorValueV2;
+    plotLineColor?: PublisherColorValueV2;
+    legendColor?: PublisherColorValueV2;
+    legendSize?: PublisherPxV2;
+    dataLabelColor?: PublisherColorValueV2;
+    dataLabelSize?: PublisherPxV2;
+}
+
+/**
+ * Current version of {@link IPublisherColorBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherColorBackground = IPublisherColorBackgroundV1;
+
 /**
  * Solid color painted behind a section's or page's content.
  *
  * @alpha
  */
-export declare interface IPublisherColorBackground {
+export declare interface IPublisherColorBackgroundV1 {
     type: "color";
     /**
      * CSS color value. Absolute: document styling states brand colors directly and does not
@@ -12300,25 +12569,80 @@ export declare interface IPublisherColorBackground {
 }
 
 /**
- * Document metadata object.
+ * @alpha
+ */
+export declare interface IPublisherContainerStyleV2 extends IPublisherBoxStyleV2, IPublisherInheritedTextStyleV2 {
+    gap?: PublisherGapValueV2;
+}
+
+/**
+ * Row or column of layout nodes.
  *
  * @alpha
  */
-export declare interface IPublisherDocument extends IPublisherDocumentDefinition, IAuditableDates, IAuditableUsers {
-    ref: ObjRef;
+export declare interface IPublisherContainerV2 {
+    type: "row" | "column";
     /**
-     * When true, the object comes from a parent workspace and is not editable
-     * in the current workspace.
+     * Matches `[A-Za-z0-9_.-]{1,64}`.
      */
-    isLocked?: boolean;
+    id?: string;
+    /**
+     * In reading order. An empty list renders as a spacer.
+     */
+    children: PublisherLayoutNodeV2[];
+    /**
+     * Share of the parent's main axis, greater than 0. Defaults to 1.
+     */
+    proportion?: number;
+    /**
+     * Enforced by the editor, never checked on write.
+     */
+    locked?: boolean;
+    style?: IPublisherContainerStyleV2;
+}
+
+/**
+ * @remarks
+ * A corner key wins over `borderRadius` in any order.
+ *
+ * @alpha
+ */
+export declare interface IPublisherCornerStyleV2 {
+    borderRadius?: PublisherRadiusValueV2;
+    borderTopLeftRadius?: PublisherRadiusValueV2;
+    borderTopRightRadius?: PublisherRadiusValueV2;
+    borderBottomRightRadius?: PublisherRadiusValueV2;
+    borderBottomLeftRadius?: PublisherRadiusValueV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherDataSetRefV2 {
+    identifier: string;
+    type: "dataSet";
 }
 
+/**
+ * Current version of {@link IPublisherDocumentV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherDocument = IPublisherDocumentV1;
+
+/**
+ * Current version of {@link IPublisherDocumentBaseV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherDocumentBase = IPublisherDocumentBaseV1;
+
 /**
  * Fields shared by document definitions and persisted documents.
  *
  * @alpha
  */
-export declare interface IPublisherDocumentBase {
+export declare interface IPublisherDocumentBaseV1 {
     title: string;
     description?: string;
     tags?: string[];
@@ -12330,29 +12654,70 @@ export declare interface IPublisherDocumentBase {
      * visualization slot's dateDataSet (lowest precedence, per-slot opt-out via
      * ignoreReportPeriod). Also available as `{periodStart}` in text.
      */
-    periodStart: PublisherDateString;
+    periodStart: PublisherDateStringV1;
     /**
      * Reported period end, ISO 8601 date (YYYY-MM-DD), inclusive.
      */
-    periodEnd: PublisherDateString;
+    periodEnd: PublisherDateStringV1;
     /**
      * 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: IPublisherDocumentContent;
+    content: IPublisherDocumentContentV1;
     /**
      * Values for variables declared in content.variables, keyed by variable name.
      */
     variableValues?: Record<string, string>;
 }
 
+/**
+ * Current version of {@link IPublisherDocumentContentV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherDocumentContent = IPublisherDocumentContentV1;
+
+/**
+ * Keys shared by both shapes of document content.
+ *
+ * @alpha
+ */
+export declare interface IPublisherDocumentContentBaseV2 {
+    defaults?: IPublisherDocumentDefaultsV2;
+    /**
+     * Date filters name their `dataSet`. At most one filter per attribute or date dataset.
+     */
+    filters?: FilterContextItem[];
+    attributeFilterConfigs?: IDashboardAttributeFilterConfig[];
+    style?: IPublisherDocumentStyleV2;
+    /**
+     * Overrides the workspace locale for this document, for example `de-DE`.
+     */
+    locale?: string;
+    /**
+     * Overrides the workspace format locale used for dates, for example `de-DE`.
+     */
+    formatLocale?: string;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherDocumentContentSetSectionsOptionsV2 {
+    /**
+     * Content the sections were read from. Its other keys are kept.
+     */
+    content: PublisherDocumentContentV2;
+    sections: IPublisherSectionV2[];
+}
+
 /**
  * Versioned content shared verbatim by document templates and documents.
  *
  * @alpha
  */
-export declare interface IPublisherDocumentContent {
+export declare interface IPublisherDocumentContentV1 {
     /**
      * Content model version, for stored-content evolution.
      */
@@ -12360,7 +12725,7 @@ export declare interface IPublisherDocumentContent {
     /**
      * Ordered pages of the document.
      */
-    pages: IPublisherDocumentPage[];
+    pages: IPublisherDocumentPageV1[];
     /**
      * Content-level default filters; pages and slots may extend or override them.
      * The document period is NOT stored here — it is derived from periodStart/periodEnd
@@ -12374,12 +12739,12 @@ export declare interface IPublisherDocumentContent {
      * A filter with a `displayAsLabel` must be stored on the attribute's primary label: its selection
      * is read as primary-label values and shown by `displayAsLabel`.
      */
-    attributeFilterConfigs?: IPublisherAttributeFilterConfig[];
+    attributeFilterConfigs?: IPublisherAttributeFilterConfigV1[];
     /**
      * Custom variable declarations. Values live on the document
-     * ({@link IPublisherDocumentBase.variableValues}).
+     * ({@link IPublisherDocumentBaseV1.variableValues}).
      */
-    variables?: IPublisherVariableDefinition[];
+    variables?: IPublisherVariableDefinitionV1[];
     /**
      * Instructions every AI-written text without instructions of its own is generated with.
      * Supports `{variables}`.
@@ -12388,433 +12753,1140 @@ export declare interface IPublisherDocumentContent {
 }
 
 /**
- * Payload for creating or updating a document.
- *
  * @alpha
  */
-export declare interface IPublisherDocumentDefinition extends IPublisherDocumentBase {
-    type: "report";
+export declare interface IPublisherDocumentDefaultsV2 {
     /**
-     * Present when updating an existing document.
+     * Applies to every page without its own `pageSize`.
      */
-    ref?: ObjRef;
+    pageSize?: PublisherPageSizeV2;
+    takeaway?: {
+        /**
+         * Combined with each takeaway widget's own `generation`.
+         */
+        generation?: IPublisherTakeawayGenerationV2;
+    };
+    /**
+     * Document templates only. A document stores its period on the entity.
+     */
+    period?: PublisherPeriodV2;
 }
 
 /**
- * Page instance embedded in template/document content: a deep clone of a page body
- * plus its own identity.
- *
- * @remarks
- * Cloning a {@link IPublisherPageLayout} 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.
+ * Current version of {@link IPublisherDocumentDefinitionV1}.
  *
  * @alpha
  */
-export declare interface IPublisherDocumentPage extends IPublisherPageBody {
-    /**
-     * Identifier unique within the content; stable across template-to-document copy and reordering.
-     */
-    localIdentifier: string;
-}
+export declare type IPublisherDocumentDefinition = IPublisherDocumentDefinitionV1;
 
 /**
- * Document template metadata object.
+ * Payload for creating or updating a document.
  *
  * @alpha
  */
-export declare interface IPublisherDocumentTemplate extends IPublisherDocumentTemplateDefinition, IAuditableDates, IAuditableUsers {
-    ref: ObjRef;
+export declare interface IPublisherDocumentDefinitionV1 extends IPublisherDocumentBaseV1 {
+    type: "report";
     /**
-     * When true, the object comes from a parent workspace and is not editable
-     * in the current workspace.
+     * Present when updating an existing document.
      */
-    isLocked?: boolean;
+    ref?: ObjRef;
 }
 
 /**
- * Payload for creating or updating a document template.
+ * Payload for creating or updating a document.
  *
  * @alpha
  */
-export declare interface IPublisherDocumentTemplateDefinition {
-    type: "reportTemplate";
+export declare interface IPublisherDocumentDefinitionV2 extends IPublisherEntityDefinitionBaseV2 {
+    type: "document";
+    period: PublisherPeriodV2;
     /**
-     * Present when updating an existing template.
+     * A document created from a template gets a deep copy of its content and keeps no reference to it.
      */
-    ref?: ObjRef;
-    title: string;
-    description?: string;
-    tags?: string[];
-    content: IPublisherDocumentContent;
+    content: PublisherDocumentContentV2;
 }
 
 /**
- * Slot rendering a heading.
- *
- * @remarks
- * A heading is a line of display text, so it carries no markup of its own: what is typed in it is
- * what it renders.
+ * Current version of {@link IPublisherDocumentPageV1}.
  *
  * @alpha
  */
-export declare interface IPublisherHeadingSlot extends IPublisherSlotBase {
-    type: "heading";
-    style?: IPublisherHeadingStyle;
-    /**
-     * Undefined = declared-but-empty slot.
-     */
-    source?: PublisherTextSource;
-}
+export declare type IPublisherDocumentPage = IPublisherDocumentPageV1;
 
 /**
- * Styling of a heading slot.
+ * Document content stored as a flat list of pages.
  *
  * @alpha
  */
-export declare interface IPublisherHeadingStyle extends IPublisherTextStyle {
-    /**
-     * Defaults to {@link DefaultPublisherHeadingType}. The size owns the semantic typography that goes
-     * with it; the rest of the style overrides ink and placement on top of it.
-     */
-    type?: PublisherHeadingType;
+export declare interface IPublisherDocumentPagesContentV2 extends IPublisherDocumentContentBaseV2 {
+    pages: IPublisherDocumentPageV2[];
+    sections?: never;
 }
 
 /**
- * Image painted behind a section's or page's content.
+ * 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
+ * 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.
  *
  * @alpha
  */
-export declare interface IPublisherImageBackground {
-    type: "image";
+export declare interface IPublisherDocumentPageV1 extends IPublisherPageBodyV1 {
     /**
-     * Local identifier of an image slot in {@link IPublisherPageBody.slots}. Routing the image
-     * through a slot keeps it template-fillable and gives it the slot's placeholder metadata.
-     * A reference that is missing or resolves to a non-image slot paints no background.
+     * Identifier unique within the content; stable across template-to-document copy and reordering.
      */
-    slotId: string;
+    localIdentifier: string;
 }
 
 /**
- * Slot rendering an image.
+ * Page inside a document.
  *
  * @alpha
  */
-export declare interface IPublisherImageSlot extends IPublisherSlotBase {
-    type: "image";
-    /**
-     * Undefined = declared-but-empty slot.
-     */
-    source?: PublisherImageSource;
-    altText?: string;
+export declare interface IPublisherDocumentPageV2 extends IPublisherPageBodyV2 {
     /**
-     * How the image fills the slot area. Defaults to "contain".
+     * Unique in the document. Matches `[A-Za-z0-9_.-]{1,64}`.
      */
-    fit?: PublisherImageFit;
+    id: string;
     /**
-     * Placement overrides for the drawn image; centered on both axes by default.
+     * Defaults to `true`. A hidden page is left out of the viewer, exports and page numbers.
      */
-    style?: IPublisherImageStyle;
+    visible?: boolean;
 }
 
 /**
- * Where the drawn image sits when it does not fill its box, and which part of it is kept when it
- * is cropped to fill one.
+ * Document content stored as sections of pages.
  *
  * @alpha
  */
-export declare interface IPublisherImageStyle {
-    horizontalAlign?: PublisherContentAlignment;
-    verticalAlign?: PublisherContentAlignment;
+export declare interface IPublisherDocumentSectionsContentV2 extends IPublisherDocumentContentBaseV2 {
+    sections: IPublisherSectionV2[];
+    pages?: never;
 }
 
 /**
- * Fields common to all page layout nodes.
+ * Style of the area behind the pages. Exports ignore it.
  *
  * @alpha
  */
-export declare interface IPublisherLayoutNodeBase {
+export declare interface IPublisherDocumentStyleV2 extends IPublisherBackgroundStyleV2 {
     /**
-     * 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.
+     * Space between pages in the viewer and the editor.
      */
-    weight?: number;
+    gap?: PublisherGapValueV2;
 }
 
 /**
- * A container splitting its area into children laid out along a direction.
+ * Current version of {@link IPublisherDocumentTemplateV1}.
  *
  * @alpha
  */
-export declare interface IPublisherLayoutSection extends IPublisherLayoutNodeBase {
-    type: "section";
-    /**
-     * "row" lays children out horizontally, "column" vertically.
-     */
-    direction: "row" | "column";
-    children: PublisherPageLayoutNode[];
-    /**
-     * Paint of this section's box. Never affects how children are laid out.
-     */
-    style?: IPublisherBoxStyle;
-}
+export declare type IPublisherDocumentTemplate = IPublisherDocumentTemplateV1;
 
 /**
- * A leaf assigning its area to a slot. The slot fills the area completely.
+ * Current version of {@link IPublisherDocumentTemplateDefinitionV1}.
  *
  * @alpha
  */
-export declare interface IPublisherLayoutSlotRef extends IPublisherLayoutNodeBase {
-    type: "slotRef";
+export declare type IPublisherDocumentTemplateDefinition = IPublisherDocumentTemplateDefinitionV1;
+
+/**
+ * Payload for creating or updating a document template.
+ *
+ * @alpha
+ */
+export declare interface IPublisherDocumentTemplateDefinitionV1 {
+    type: "reportTemplate";
     /**
-     * Local identifier of a slot in {@link IPublisherPageBody.slots}.
-     * A slotId with no matching slot renders as an empty area.
+     * Present when updating an existing template.
      */
-    slotId: string;
+    ref?: ObjRef;
+    title: string;
+    description?: string;
+    tags?: string[];
+    content: IPublisherDocumentContentV1;
 }
 
 /**
- * Body of a document page: geometry (flex split tree) plus the slots it places.
- *
- * @remarks
- * This is both the content of the standalone {@link IPublisherPageLayout} object and the shape
- * embedded in template/document content ({@link IPublisherDocumentPage}).
+ * Payload for creating or updating a document template.
  *
- * There is no header/footer chrome: page title, description, footer, page numbers and
- * logos are ordinary slots in the layout tree (text slots with `{currentPageNumber}`/`{totalPages}`,
- * an image slot with `{logo}`). Every slot fills its layout area completely.
+ * @alpha
+ */
+export declare interface IPublisherDocumentTemplateDefinitionV2 extends IPublisherEntityDefinitionBaseV2 {
+    type: "documentTemplate";
+    content: PublisherDocumentContentV2;
+}
+
+/**
+ * Document template metadata object.
  *
  * @alpha
  */
-export declare interface IPublisherPageBody {
-    /**
-     * Editor hint only (template galleries, default styling, AI context).
-     * Renderers must not branch layout logic on it — geometry always comes from `layout`.
-     */
-    kind?: "cover" | "section" | "content";
-    /**
-     * Page proportions the layout was authored for. Defaults to
-     * {@link DefaultPublisherPageFormat}.
-     */
-    format?: PublisherPageFormat;
-    /**
-     * Paint of the page itself, behind everything the layout places.
-     */
-    style?: IPublisherBoxStyle;
-    /**
-     * Root of the page layout tree.
-     */
-    layout: PublisherPageLayoutNode;
-    /**
-     * All slots referenced by the layout, flat, keyed by localIdentifier.
-     */
-    slots: PublisherSlot[];
+export declare interface IPublisherDocumentTemplateV1 extends IPublisherDocumentTemplateDefinitionV1, IAuditableDates, IAuditableUsers {
+    ref: ObjRef;
     /**
-     * Page-level filters: merged over content-level filters (a filter targeting the
-     * same object replaces the inherited one); slot filters apply on top.
+     * When true, the object comes from a parent workspace and is not editable
+     * in the current workspace.
      */
-    filters?: FilterContextItem[];
+    isLocked?: boolean;
 }
 
 /**
- * Validation issue found in a page body.
+ * Document template metadata object.
  *
  * @alpha
  */
-export declare interface IPublisherPageBodyValidationIssue {
-    severity: "error" | "warning";
-    message: string;
+export declare interface IPublisherDocumentTemplateV2 extends IPublisherDocumentTemplateDefinitionV2, IPublisherEntityMetadataV2 {
+    ref: ObjRef;
 }
 
 /**
- * Reusable page layout metadata object.
+ * Document metadata object.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayout extends IPublisherPageLayoutDefinition, IAuditableDates, IAuditableUsers {
+export declare interface IPublisherDocumentV1 extends IPublisherDocumentDefinitionV1, IAuditableDates, IAuditableUsers {
     ref: ObjRef;
     /**
      * When true, the object comes from a parent workspace and is not editable
      * in the current workspace.
      */
     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;
 }
 
 /**
- * Stored content of the reportPage entity.
+ * Document metadata object.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayoutContent extends IPublisherPageBody {
-    /**
-     * Content model version, for stored-content evolution.
-     */
-    version: "1";
+export declare interface IPublisherDocumentV2 extends IPublisherDocumentDefinitionV2, IPublisherEntityMetadataV2 {
+    ref: ObjRef;
 }
 
 /**
- * Payload for creating or updating a page layout.
+ * Fields shared by the definitions of all Publisher entities.
  *
  * @alpha
  */
-export declare interface IPublisherPageLayoutDefinition {
-    type: "reportPageLayout";
+export declare interface IPublisherEntityDefinitionBaseV2 {
     /**
-     * Present when updating an existing page.
+     * Present when updating an existing entity.
      */
     ref?: ObjRef;
     title: string;
     description?: string;
     tags?: string[];
-    content: IPublisherPageLayoutContent;
+    version: PublisherContentVersionV2;
 }
 
 /**
- * Slot rendering prose, written as markdown.
+ * Fields shared by all persisted Publisher entities.
  *
  * @alpha
  */
-export declare interface IPublisherParagraphSlot extends IPublisherSlotBase {
-    type: "paragraph";
-    style?: IPublisherParagraphStyle;
+export declare interface IPublisherEntityMetadataV2 extends IAuditableDates, IAuditableUsers {
+    ref: ObjRef;
     /**
-     * Undefined = declared-but-empty slot.
+     * When true, the object comes from a parent workspace and is not editable
+     * in the current workspace.
      */
-    source?: PublisherTextSource;
+    isLocked?: boolean;
 }
 
 /**
- * Styling of a paragraph slot.
+ * Current version of {@link IPublisherHeadingSlotV1}.
  *
  * @alpha
  */
-export declare interface IPublisherParagraphStyle extends IPublisherTextStyle {
-    /**
-     * Defaults to {@link DefaultPublisherParagraphType}.
-     */
-    type?: PublisherParagraphType;
-}
+export declare type IPublisherHeadingSlot = IPublisherHeadingSlotV1;
 
 /**
- * Structural base of every document slot.
+ * Slot rendering a heading.
  *
  * @remarks
- * Parsers written against this base can skip slot types introduced by a newer
- * content version instead of failing.
+ * A heading is a line of display text, so it carries no markup of its own: what is typed in it is
+ * what it renders.
  *
  * @alpha
  */
-export declare interface IPublisherSlotBase {
-    type: string;
+export declare interface IPublisherHeadingSlotV1 extends IPublisherSlotBaseV1 {
+    type: "heading";
+    style?: IPublisherHeadingStyleV1;
     /**
-     * Identifier unique within the page body. The layout tree references it, and it is
-     * the join key when a document fills a template's slots. Regenerated when a page is
-     * cloned into template content so repeated use of one page stays unique.
+     * Undefined = declared-but-empty slot.
      */
-    localIdentifier: string;
+    source?: PublisherTextSourceV1;
+}
+
+/**
+ * Current version of {@link IPublisherHeadingStyleV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherHeadingStyle = IPublisherHeadingStyleV1;
+
+/**
+ * Styling of a heading slot.
+ *
+ * @alpha
+ */
+export declare interface IPublisherHeadingStyleV1 extends IPublisherTextStyleV1 {
     /**
-     * Present when the slot is an unfilled placeholder.
+     * Defaults to {@link DefaultPublisherHeadingTypeV1}. The size owns the semantic typography that goes
+     * with it; the rest of the style overrides ink and placement on top of it.
      */
-    placeholder?: IPublisherSlotPlaceholder;
+    type?: PublisherHeadingTypeV1;
 }
 
 /**
- * Metadata of a slot that is intentionally left unfilled in a page layout or template.
- *
  * @alpha
  */
-export declare interface IPublisherSlotPlaceholder {
+export declare interface IPublisherHeadingWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "heading";
     /**
-     * Authoring hint shown in the empty slot.
+     * Inline markdown only.
      */
-    hint?: string;
+    markdown?: string;
     /**
-     * When true, a document is not considered complete until this slot is filled.
+     * Outline level below the page title, independent of the text style. Defaults to 1.
      */
-    required?: boolean;
+    level?: PublisherHeadingLevelV2;
+    /**
+     * `textStyle` defaults to {@link publisherHeadingDefaultTextStyleV2} of the level.
+     */
+    style?: IPublisherTextWidgetStyleV2;
 }
 
 /**
- * Author-written text.
- *
  * @alpha
  */
-export declare interface IPublisherStaticTextSource {
-    type: "static";
-    /**
-     * Markdown content with `{variable}` placeholders. Stored raw — placeholders are
-     * resolved only at render/export time.
-     */
-    content: string;
+export declare interface IPublisherHeadlineStyleV2 {
+    primaryValueColor?: PublisherColorValueV2;
+    primaryValueSize?: PublisherPxV2;
+    secondaryValueColor?: PublisherColorValueV2;
+    secondaryValueSize?: PublisherPxV2;
+    positiveColor?: PublisherColorValueV2;
+    negativeColor?: PublisherColorValueV2;
 }
 
 /**
- * Slot rendering text of either kind.
+ * Current version of {@link IPublisherImageBackgroundV1}.
  *
  * @alpha
  */
-export declare type IPublisherTextSlot = IPublisherHeadingSlot | IPublisherParagraphSlot;
+export declare type IPublisherImageBackground = IPublisherImageBackgroundV1;
 
 /**
- * Styling of a text slot: the paint of its box, plus the ink and placement of the text it owns.
+ * Image painted behind a section's or page's content.
  *
  * @alpha
  */
-export declare interface IPublisherTextStyle extends IPublisherBoxStyle {
+export declare interface IPublisherImageBackgroundV1 {
+    type: "image";
     /**
-     * CSS color value. Absolute, like {@link IPublisherColorBackground.color}.
+     * Local identifier of an image slot in {@link IPublisherPageBodyV1.slots}. Routing the image
+     * through a slot keeps it template-fillable and gives it the slot's placeholder metadata.
+     * A reference that is missing or resolves to a non-image slot paints no background.
      */
-    color?: string;
-    horizontalAlign?: PublisherContentAlignment;
-    verticalAlign?: PublisherContentAlignment;
+    slotId: string;
 }
 
 /**
- * A custom variable declared by document content and given a value by a document.
+ * Current version of {@link IPublisherImageSlotV1}.
  *
- * @remarks
- * Referenced from text as `{name}`. Values come from {@link IPublisherDocumentBase.variableValues},
- * falling back to {@link IPublisherVariableDefinition.defaultValue}.
+ * @alpha
+ */
+export declare type IPublisherImageSlot = IPublisherImageSlotV1;
+
+/**
+ * Slot rendering an image.
  *
  * @alpha
  */
-export declare interface IPublisherVariableDefinition {
+export declare interface IPublisherImageSlotV1 extends IPublisherSlotBaseV1 {
+    type: "image";
     /**
-     * Variable name as used inside the `{...}` marker. Must match /^[a-zA-Z][a-zA-Z0-9_]*$/.
-     * Built-in names ({@link PublisherBuiltInVariable}) are reserved.
+     * Undefined = declared-but-empty slot.
      */
-    name: string;
+    source?: PublisherImageSourceV1;
+    altText?: string;
     /**
-     * Human readable label shown in the editor.
+     * How the image fills the slot area. Defaults to "contain".
      */
-    title?: string;
-    description?: string;
+    fit?: PublisherImageFitV1;
     /**
-     * Value used when the document does not provide one. May not contain further
-     * placeholders — there is no recursive expansion.
+     * Placement overrides for the drawn image; centered on both axes by default.
      */
-    defaultValue?: string;
+    style?: IPublisherImageStyleV1;
 }
 
 /**
- * Slot rendering an insight, with its own filter context.
+ * Current version of {@link IPublisherImageStyleV1}.
  *
  * @alpha
  */
-export declare interface IPublisherVisualizationSlot extends IPublisherSlotBase {
-    type: "visualization";
+export declare type IPublisherImageStyle = IPublisherImageStyleV1;
+
+/**
+ * Where the drawn image sits when it does not fill its box, and which part of it is kept when it
+ * is cropped to fill one.
+ *
+ * @alpha
+ */
+export declare interface IPublisherImageStyleV1 {
+    horizontalAlign?: PublisherContentAlignmentV1;
+    verticalAlign?: PublisherContentAlignmentV1;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherImageWidgetStyleV2 extends IPublisherBoxStyleV2 {
     /**
-     * Insight to render. Undefined = declared-but-empty slot; renderers show a placeholder.
+     * Defaults to `contain`.
      */
-    insight?: ObjRef;
+    fit?: "contain" | "cover" | "fill";
+    horizontalAlign?: PublisherHorizontalAlignV2;
+    verticalAlign?: PublisherVerticalAlignV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherImageWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "image";
+    source?: PublisherImageSourceV2;
+    altText?: string;
+    decorative?: boolean;
+    style?: IPublisherImageWidgetStyleV2;
+}
+
+/**
+ * Text keys that a page or container passes down to the content inside, unless a widget sets its own.
+ *
+ * @alpha
+ */
+export declare interface IPublisherInheritedTextStyleV2 {
+    textStyle?: PublisherTextStyleNameV2;
+    textColor?: PublisherColorValueV2;
     /**
-     * Optional title rendered above the visualization. Supports `{variables}`.
+     * `justify` applies to text only.
+     */
+    horizontalAlign?: PublisherHorizontalAlignV2 | "justify";
+    verticalAlign?: PublisherVerticalAlignV2;
+}
+
+/**
+ * Current version of {@link IPublisherLayoutNodeBaseV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherLayoutNodeBase = IPublisherLayoutNodeBaseV1;
+
+/**
+ * Fields common to all page layout nodes.
+ *
+ * @alpha
+ */
+export declare interface IPublisherLayoutNodeBaseV1 {
+    /**
+     * 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.
+     */
+    weight?: number;
+}
+
+/**
+ * Current version of {@link IPublisherLayoutSectionV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherLayoutSection = IPublisherLayoutSectionV1;
+
+/**
+ * A container splitting its area into children laid out along a direction.
+ *
+ * @alpha
+ */
+export declare interface IPublisherLayoutSectionV1 extends IPublisherLayoutNodeBaseV1 {
+    type: "section";
+    /**
+     * "row" lays children out horizontally, "column" vertically.
+     */
+    direction: "row" | "column";
+    children: PublisherPageLayoutNodeV1[];
+    /**
+     * Paint of this section's box. Never affects how children are laid out.
+     */
+    style?: IPublisherBoxStyleV1;
+}
+
+/**
+ * Current version of {@link IPublisherLayoutSlotRefV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherLayoutSlotRef = IPublisherLayoutSlotRefV1;
+
+/**
+ * A leaf assigning its area to a slot. The slot fills the area completely.
+ *
+ * @alpha
+ */
+export declare interface IPublisherLayoutSlotRefV1 extends IPublisherLayoutNodeBaseV1 {
+    type: "slotRef";
+    /**
+     * Local identifier of a slot in {@link IPublisherPageBodyV1.slots}.
+     * A slotId with no matching slot renders as an empty area.
+     */
+    slotId: string;
+}
+
+/**
+ * @remarks
+ * A side key wins over `padding` in any order.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPaddingStyleV2 {
+    padding?: PublisherPaddingValueV2;
+    paddingTop?: PublisherPaddingValueV2;
+    paddingRight?: PublisherPaddingValueV2;
+    paddingBottom?: PublisherPaddingValueV2;
+    paddingLeft?: PublisherPaddingValueV2;
+}
+
+/**
+ * Current version of {@link IPublisherPageBodyV1}.
+ *
+ * @alpha
+ */
+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
+ * embedded in template/document content ({@link IPublisherDocumentPageV1}).
+ *
+ * There is no header/footer chrome: page title, description, footer, page numbers and
+ * logos are ordinary slots in the layout tree (text slots with `{currentPageNumber}`/`{totalPages}`,
+ * an image slot with `{logo}`). Every slot fills its layout area completely.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageBodyV1 {
+    /**
+     * Editor hint only (template galleries, default styling, AI context).
+     * Renderers must not branch layout logic on it — geometry always comes from `layout`.
+     */
+    kind?: "cover" | "section" | "content";
+    /**
+     * Page proportions the layout was authored for. Defaults to
+     * {@link DefaultPublisherPageFormatV1}.
+     */
+    format?: PublisherPageFormatV1;
+    /**
+     * Paint of the page itself, behind everything the layout places.
+     */
+    style?: IPublisherBoxStyleV1;
+    /**
+     * Root of the page layout tree.
+     */
+    layout: PublisherPageLayoutNodeV1;
+    /**
+     * All slots referenced by the layout, flat, keyed by localIdentifier.
+     */
+    slots: PublisherSlotV1[];
+    /**
+     * Page-level filters: merged over content-level filters (a filter targeting the
+     * same object replaces the inherited one); slot filters apply on top.
+     */
+    filters?: FilterContextItem[];
+}
+
+/**
+ * Content of one page, as a page template stores it.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageBodyV2 {
+    kind?: PublisherPageKindV2;
+    pageSize?: PublisherPageSizeV2;
+    /**
+     * Markdown speaker notes, never drawn on the page.
+     */
+    notes?: string;
+    style?: IPublisherPageStyleV2;
+    layout: PublisherLayoutNodeV2;
+    filters?: FilterContextItem[];
+}
+
+/**
+ * Current version of {@link IPublisherPageBodyValidationIssueV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherPageBodyValidationIssue = IPublisherPageBodyValidationIssueV1;
+
+/**
+ * Validation issue found in a page body.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageBodyValidationIssueV1 {
+    severity: "error" | "warning";
+    message: string;
+}
+
+/**
+ * Current version of {@link IPublisherPageLayoutV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherPageLayout = IPublisherPageLayoutV1;
+
+/**
+ * Current version of {@link IPublisherPageLayoutContentV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherPageLayoutContent = IPublisherPageLayoutContentV1;
+
+/**
+ * Stored content of the reportPage entity.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageLayoutContentV1 extends IPublisherPageBodyV1 {
+    /**
+     * Content model version, for stored-content evolution.
+     */
+    version: "1";
+}
+
+/**
+ * Current version of {@link IPublisherPageLayoutDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherPageLayoutDefinition = IPublisherPageLayoutDefinitionV1;
+
+/**
+ * Payload for creating or updating a page layout.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageLayoutDefinitionV1 {
+    type: "reportPageLayout";
+    /**
+     * Present when updating an existing page.
+     */
+    ref?: ObjRef;
+    title: string;
+    description?: string;
+    tags?: string[];
+    content: IPublisherPageLayoutContentV1;
+}
+
+/**
+ * Reusable page layout metadata object.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageLayoutV1 extends IPublisherPageLayoutDefinitionV1, IAuditableDates, IAuditableUsers {
+    ref: ObjRef;
+    /**
+     * When true, the object comes from a parent workspace and is not editable
+     * in the current workspace.
+     */
+    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.
+     */
+    gap?: PublisherGapValueV2;
+}
+
+/**
+ * Payload for creating or updating a page template.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageTemplateDefinitionV2 extends IPublisherEntityDefinitionBaseV2 {
+    type: "pageTemplate";
+    content: IPublisherPageBodyV2;
+}
+
+/**
+ * Page template metadata object.
+ *
+ * @alpha
+ */
+export declare interface IPublisherPageTemplateV2 extends IPublisherPageTemplateDefinitionV2, IPublisherEntityMetadataV2 {
+    ref: ObjRef;
+    /**
+     * True for the default page templates the backend serves. Their ids start with `default.`.
+     */
+    isDefault?: boolean;
+}
+
+/**
+ * Current version of {@link IPublisherParagraphSlotV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherParagraphSlot = IPublisherParagraphSlotV1;
+
+/**
+ * Slot rendering prose, written as markdown.
+ *
+ * @alpha
+ */
+export declare interface IPublisherParagraphSlotV1 extends IPublisherSlotBaseV1 {
+    type: "paragraph";
+    style?: IPublisherParagraphStyleV1;
+    /**
+     * Undefined = declared-but-empty slot.
+     */
+    source?: PublisherTextSourceV1;
+}
+
+/**
+ * Current version of {@link IPublisherParagraphStyleV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherParagraphStyle = IPublisherParagraphStyleV1;
+
+/**
+ * Styling of a paragraph slot.
+ *
+ * @alpha
+ */
+export declare interface IPublisherParagraphStyleV1 extends IPublisherTextStyleV1 {
+    /**
+     * Defaults to {@link DefaultPublisherParagraphTypeV1}.
+     */
+    type?: PublisherParagraphTypeV1;
+}
+
+/**
+ * Both ends are inclusive.
+ *
+ * @alpha
+ */
+export declare interface IPublisherRelativePeriodV2 {
+    type: "relative";
+    granularity: DateFilterGranularity;
+    /**
+     * Offset in `granularity` units from the current one, for example `-1`.
+     */
+    from: number;
+    to: number;
+}
+
+/**
+ * Named group of pages.
+ *
+ * @alpha
+ */
+export declare interface IPublisherSectionV2 {
+    /**
+     * Unique in the document. Matches `[A-Za-z0-9_.-]{1,64}`.
+     */
+    id: string;
+    title?: string;
+    description?: string;
+    pages: IPublisherDocumentPageV2[];
+}
+
+/**
+ * @remarks
+ * The part keys override the named `shadow`, or define a shadow without one.
+ *
+ * @alpha
+ */
+export declare interface IPublisherShadowStyleV2 {
+    shadow?: PublisherShadowValueV2;
+    /**
+     * px on the design canvas; may be negative.
+     */
+    shadowX?: number;
+    /**
+     * px on the design canvas; may be negative.
+     */
+    shadowY?: number;
+    shadowBlur?: PublisherPxV2;
+    /**
+     * px on the design canvas; may be negative.
+     */
+    shadowSpread?: number;
+    shadowColor?: PublisherColorValueV2;
+    shadowOpacity?: PublisherOpacityV2;
+}
+
+/**
+ * Current version of {@link IPublisherSlotBaseV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherSlotBase = IPublisherSlotBaseV1;
+
+/**
+ * Structural base of every document slot.
+ *
+ * @remarks
+ * Parsers written against this base can skip slot types introduced by a newer
+ * content version instead of failing.
+ *
+ * @alpha
+ */
+export declare interface IPublisherSlotBaseV1 {
+    type: string;
+    /**
+     * Identifier unique within the page body. The layout tree references it, and it is
+     * the join key when a document fills a template's slots. Regenerated when a page is
+     * cloned into template content so repeated use of one page stays unique.
+     */
+    localIdentifier: string;
+    /**
+     * Present when the slot is an unfilled placeholder.
+     */
+    placeholder?: IPublisherSlotPlaceholderV1;
+}
+
+/**
+ * Current version of {@link IPublisherSlotPlaceholderV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherSlotPlaceholder = IPublisherSlotPlaceholderV1;
+
+/**
+ * Metadata of a slot that is intentionally left unfilled in a page layout or template.
+ *
+ * @alpha
+ */
+export declare interface IPublisherSlotPlaceholderV1 {
+    /**
+     * Authoring hint shown in the empty slot.
+     */
+    hint?: string;
+    /**
+     * When true, a document is not considered complete until this slot is filled.
+     */
+    required?: boolean;
+}
+
+/**
+ * Current version of {@link IPublisherStaticTextSourceV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherStaticTextSource = IPublisherStaticTextSourceV1;
+
+/**
+ * Author-written text.
+ *
+ * @alpha
+ */
+export declare interface IPublisherStaticTextSourceV1 {
+    type: "static";
+    /**
+     * Markdown content with `{variable}` placeholders. Stored raw — placeholders are
+     * resolved only at render/export time.
+     */
+    content: string;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTableStyleV2 {
+    fontSize?: PublisherPxV2;
+    rowHeight?: PublisherPxV2;
+    gridColor?: PublisherColorValueV2;
+    valueColor?: PublisherColorValueV2;
+    nullValueColor?: PublisherColorValueV2;
+    headerLabelColor?: PublisherColorValueV2;
+    headerBackgroundColor?: PublisherColorValueV2;
+    totalValueColor?: PublisherColorValueV2;
+    totalBackgroundColor?: PublisherColorValueV2;
+    subtotalBackgroundColor?: PublisherColorValueV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTakeawayGenerationV2 {
+    /**
+     * Appended to the preset instructions. Sent together with the document's takeaway instructions;
+     * the widget's instructions win on a clash.
+     */
+    instructions?: string;
+    /**
+     * What the AI reads.
+     */
+    context?: {
+        /**
+         * Widget ids on the same page. Defaults to every visualization on the page.
+         */
+        widgets?: string[];
+        /**
+         * Defaults to `true`.
+         */
+        pageTitle?: boolean;
+        /**
+         * Filters and period. Defaults to `true`.
+         */
+        filters?: boolean;
+        /**
+         * Defaults to `false`.
+         */
+        otherPages?: boolean;
+    };
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTakeawayWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "takeaway";
+    /**
+     * Text defaults to a localized "Takeaway".
+     */
+    title?: IPublisherWidgetTitleV2;
+    /**
+     * The generated or written text.
+     */
+    markdown?: string;
+    generation?: IPublisherTakeawayGenerationV2;
+    style?: IPublisherTextWidgetStyleV2;
+}
+
+/**
+ * Current version of {@link IPublisherTextSlotV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherTextSlot = IPublisherTextSlotV1;
+
+/**
+ * Slot rendering text of either kind.
+ *
+ * @alpha
+ */
+export declare type IPublisherTextSlotV1 = IPublisherHeadingSlotV1 | IPublisherParagraphSlotV1;
+
+/**
+ * Current version of {@link IPublisherTextStyleV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherTextStyle = IPublisherTextStyleV1;
+
+/**
+ * Styling of a text slot: the paint of its box, plus the ink and placement of the text it owns.
+ *
+ * @alpha
+ */
+export declare interface IPublisherTextStyleV1 extends IPublisherBoxStyleV1 {
+    /**
+     * CSS color value. Absolute, like {@link IPublisherColorBackgroundV1.color}.
+     */
+    color?: string;
+    horizontalAlign?: PublisherContentAlignmentV1;
+    verticalAlign?: PublisherContentAlignmentV1;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTextStyleV2 extends IPublisherInheritedTextStyleV2 {
+    fontSize?: PublisherPxV2;
+    /**
+     * 1 to 1000.
+     */
+    fontWeight?: number;
+    fontStyle?: "normal" | "italic";
+    /**
+     * Multiple of the font size.
+     */
+    lineHeight?: number;
+    /**
+     * In em.
+     */
+    letterSpacing?: number;
+    textTransform?: "none" | "uppercase" | "lowercase" | "capitalize";
+    /**
+     * Defaults to `shrink`.
+     */
+    textOverflow?: "shrink" | "clip" | "ellipsis";
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTextWidgetStyleV2 extends IPublisherBoxStyleV2, IPublisherTextStyleV2 {
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherTextWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "text";
+    /**
+     * Full markdown: paragraphs, lists, quotes and headings.
+     */
+    markdown?: string;
+    /**
+     * Page furniture such as page numbers: kept out of the accessibility tree, PDF tags and AI context.
+     */
+    decorative?: boolean;
+    /**
+     * `textStyle` defaults to `normalText`.
+     */
+    style?: IPublisherTextWidgetStyleV2;
+}
+
+/**
+ * Page title: the PowerPoint slide title and the page name for screen readers.
+ *
+ * @remarks
+ * At most one per page. A page without one uses its first heading as the slide title.
+ *
+ * @alpha
+ */
+export declare interface IPublisherTitleWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "title";
+    /**
+     * Inline markdown only: strong, emphasis, highlight, strike, links and line breaks.
+     */
+    markdown?: string;
+    /**
+     * `textStyle` defaults to `title`.
+     */
+    style?: IPublisherTextWidgetStyleV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherValidationIssueV2 {
+    /**
+     * Where the problem is, for example `content.sections[1].pages[0].layout.children[2].id`.
+     * Empty for the validated value itself.
+     */
+    path: string;
+    message: string;
+}
+
+/**
+ * Current version of {@link IPublisherVariableDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherVariableDefinition = IPublisherVariableDefinitionV1;
+
+/**
+ * A custom variable declared by document content and given a value by a document.
+ *
+ * @remarks
+ * Referenced from text as `{name}`. Values come from {@link IPublisherDocumentBaseV1.variableValues},
+ * falling back to {@link IPublisherVariableDefinitionV1.defaultValue}.
+ *
+ * @alpha
+ */
+export declare interface IPublisherVariableDefinitionV1 {
+    /**
+     * Variable name as used inside the `{...}` marker. Must match /^[a-zA-Z][a-zA-Z0-9_]*$/.
+     * Built-in names ({@link PublisherBuiltInVariableV1}) are reserved.
+     */
+    name: string;
+    /**
+     * Human readable label shown in the editor.
+     */
+    title?: string;
+    description?: string;
+    /**
+     * Value used when the document does not provide one. May not contain further
+     * placeholders — there is no recursive expansion.
+     */
+    defaultValue?: string;
+}
+
+/**
+ * Overrides of the saved visualization's display settings.
+ *
+ * @remarks
+ * A key left out keeps the saved visualization's value. A key the visualization type does not
+ * support is ignored.
+ *
+ * @alpha
+ */
+export declare interface IPublisherVisualizationDisplayV2 {
+    legend?: {
+        visible?: boolean;
+        position?: "auto" | "top" | "bottom" | "left" | "right";
+    };
+    xAxis?: IPublisherAxisDisplayV2;
+    yAxis?: IPublisherAxisDisplayV2;
+    secondaryYAxis?: IPublisherAxisDisplayV2;
+    gridlines?: {
+        visible?: boolean;
+    };
+    dataLabels?: {
+        visible?: boolean | "auto";
+    };
+    dataPoints?: {
+        visible?: boolean | "auto";
+    };
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherVisualizationRefV2 {
+    identifier: string;
+    type: "insight";
+}
+
+/**
+ * Current version of {@link IPublisherVisualizationSlotV1}.
+ *
+ * @alpha
+ */
+export declare type IPublisherVisualizationSlot = IPublisherVisualizationSlotV1;
+
+/**
+ * Slot rendering an insight, with its own filter context.
+ *
+ * @alpha
+ */
+export declare interface IPublisherVisualizationSlotV1 extends IPublisherSlotBaseV1 {
+    type: "visualization";
+    /**
+     * Insight to render. Undefined = declared-but-empty slot; renderers show a placeholder.
+     */
+    insight?: ObjRef;
+    /**
+     * Optional title rendered above the visualization. Supports `{variables}`.
      */
     title?: string;
     showTitle?: boolean;
@@ -12823,25 +13895,109 @@ export declare interface IPublisherVisualizationSlot extends IPublisherSlotBase
      */
     properties?: VisualizationProperties;
     /**
-     * Slot-level filters, applied on top of the effective content and page filters.
-     * A slot filter targeting the same object replaces the inherited one.
+     * Slot-level filters, applied on top of the effective content and page filters.
+     * A slot filter targeting the same object replaces the inherited one.
+     */
+    filters?: FilterContextItem[];
+    /**
+     * Content- and page-level filters this slot ignores (matched by display form / date dataset).
+     */
+    ignoredFilters?: IDashboardFilterReference[];
+    /**
+     * Date dataset the document's period (periodStart/periodEnd) is applied to as an
+     * absolute date filter at execution time. Undefined = backend date-dataset
+     * auto-resolution applies.
+     */
+    dateDataSet?: ObjRef;
+    /**
+     * When true, the implicit date filter derived from the document's period is not
+     * applied to this slot.
+     */
+    ignoreReportPeriod?: boolean;
+}
+
+/**
+ * @remarks
+ * Each of `chart`, `table` and `headline` applies only while the visualization renders as that kind,
+ * so the style survives a switch from a chart to a table.
+ *
+ * @alpha
+ */
+export declare interface IPublisherVisualizationStyleV2 extends IPublisherBoxStyleV2 {
+    chart?: IPublisherChartStyleV2;
+    table?: IPublisherTableStyleV2;
+    headline?: IPublisherHeadlineStyleV2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherVisualizationWidgetV2 extends IPublisherWidgetBaseV2 {
+    type: "visualization";
+    visualization?: IPublisherVisualizationRefV2;
+    title?: IPublisherWidgetTitleV2;
+    /**
+     * Defaults to the visualization's description.
+     */
+    altText?: string;
+    /**
+     * The date dataset that the document period filters.
+     */
+    dateDataSet?: IPublisherDataSetRefV2;
+    ignoreDocumentPeriod?: boolean;
+    filters?: FilterContextItem[];
+    /**
+     * May name a filter the document no longer has.
+     */
+    ignoreDocumentFilters?: IDashboardFilterReference[];
+    display?: IPublisherVisualizationDisplayV2;
+    style?: IPublisherVisualizationStyleV2;
+}
+
+/**
+ * @remarks
+ * Empty content is an absent key; `""` and `null` are invalid.
+ *
+ * @alpha
+ */
+export declare interface IPublisherWidgetBaseV2 {
+    type: PublisherWidgetTypeV2;
+    /**
+     * Unique within its page. Copying a page keeps widget ids as written. Matches `[A-Za-z0-9_.-]{1,64}`.
+     */
+    id: string;
+    /**
+     * Share of the parent's main axis, greater than 0. Defaults to 1.
      */
-    filters?: FilterContextItem[];
+    proportion?: number;
+    placeholder?: IPublisherWidgetPlaceholderV2;
     /**
-     * Content- and page-level filters this slot ignores (matched by display form / date dataset).
+     * Enforced by the editor, never checked on write.
      */
-    ignoredFilters?: IDashboardFilterReference[];
+    locked?: boolean;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherWidgetPlaceholderV2 {
+    hint?: string;
+    required?: boolean;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IPublisherWidgetTitleV2 {
     /**
-     * Date dataset the document's period (periodStart/periodEnd) is applied to as an
-     * absolute date filter at execution time. Undefined = backend date-dataset
-     * auto-resolution applies.
+     * Defaults to `true`.
      */
-    dateDataSet?: ObjRef;
+    visible?: boolean;
     /**
-     * When true, the implicit date filter derived from the document's period is not
-     * applied to this slot.
+     * May contain text variables. A visible title without text shows the visualization's own title.
      */
-    ignoreReportPeriod?: boolean;
+    text?: string;
+    style?: IPublisherTextStyleV2;
 }
 
 /**
@@ -15019,229 +16175,486 @@ export declare interface ISourceInsightAttributeFilterRef {
 }
 
 /**
- * Source insight date filter reference.
- * @public
+ * Source insight date filter reference.
+ * @public
+ */
+export declare interface ISourceInsightDateFilterRef {
+    type: "dateFilter";
+    dataSet: ObjRefInScope;
+}
+
+/**
+ * Source insight measure value filter reference.
+ * @public
+ */
+export declare interface ISourceInsightMeasureValueFilterRef {
+    type: "measureValueFilter";
+    measure: ObjRefInScope;
+}
+
+/**
+ * Source insight ranking filter reference.
+ * @public
+ */
+export declare interface ISourceInsightRankingFilterRef {
+    type: "rankingFilter";
+    measure: ObjRefInScope;
+}
+
+/**
+ * Tests whether the provided object is of type {@link IParameterMetadataObject}.
+ *
+ * @param obj - object to test
+ * @public
+ */
+export declare function isParameterMetadataObject(obj: unknown): obj is IParameterMetadataObject;
+
+/**
+ * Tests whether the provided object is of type {@link IParameterMetadataObjectDefinition}.
+ *
+ * @param obj - object to test
+ * @public
+ */
+export declare function isParameterMetadataObjectDefinition(obj: unknown): obj is IParameterMetadataObjectDefinition;
+
+/**
+ * Type guard for checking whether object is a period-over-period measure.
+ *
+ * @public
+ */
+export declare function isPoPMeasure(obj: unknown): obj is IMeasure<IPoPMeasureDefinition>;
+
+/**
+ * Type guard for checking whether object is a period-over-period measure definition.
+ *
+ * @public
+ */
+export declare function isPoPMeasureDefinition(obj: unknown): obj is IPoPMeasureDefinition;
+
+/**
+ * Type guard checking whether the provided object is a positive attribute filter.
+ *
+ * @public
+ */
+export declare function isPositiveAttributeFilter(obj: unknown): obj is IPositiveAttributeFilter;
+
+/**
+ * Type guard for checking whether object is a previous-period measure.
+ *
+ * @public
+ */
+export declare function isPreviousPeriodMeasure(obj: unknown): obj is IMeasure<IPreviousPeriodMeasureDefinition>;
+
+/**
+ * Type guard for checking whether object is a previous period measure definition.
+ *
+ * @public
+ */
+export declare function isPreviousPeriodMeasureDefinition(obj: unknown): obj is IPreviousPeriodMeasureDefinition;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherAbsolutePeriodV2(obj: unknown): obj is IPublisherAbsolutePeriodV2;
+
+/**
+ * Current version of {@link isPublisherColorBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherColorBackground: typeof isPublisherColorBackgroundV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherColorBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherColorBackgroundV1(obj: unknown): obj is IPublisherColorBackgroundV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherColumnV2(obj: unknown): obj is IPublisherContainerV2 & {
+    type: "column";
+};
+
+/**
+ * @alpha
+ */
+export declare function isPublisherContainerV2(obj: unknown): obj is IPublisherContainerV2;
+
+/**
+ * Current version of {@link isPublisherDocumentV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherDocument: typeof isPublisherDocumentV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentContentV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherDocumentContentV1(obj: unknown): obj is IPublisherDocumentContentV1;
+
+/**
+ * Current version of {@link isPublisherDocumentDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherDocumentDefinition: typeof isPublisherDocumentDefinitionV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherDocumentDefinitionV1(obj: unknown): obj is IPublisherDocumentDefinitionV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentDefinitionV2(obj: unknown): obj is IPublisherDocumentDefinitionV2;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentPagesContentV2(obj: unknown): obj is IPublisherDocumentPagesContentV2;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentPageV2(obj: unknown): obj is IPublisherDocumentPageV2;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentSectionsContentV2(obj: unknown): obj is IPublisherDocumentSectionsContentV2;
+
+/**
+ * Current version of {@link isPublisherDocumentTemplateV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherDocumentTemplate: typeof isPublisherDocumentTemplateV1;
+
+/**
+ * Current version of {@link isPublisherDocumentTemplateDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherDocumentTemplateDefinition: typeof isPublisherDocumentTemplateDefinitionV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplateDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherDocumentTemplateDefinitionV1(obj: unknown): obj is IPublisherDocumentTemplateDefinitionV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentTemplateDefinitionV2(obj: unknown): obj is IPublisherDocumentTemplateDefinitionV2;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplateV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherDocumentTemplateV1(obj: unknown): obj is IPublisherDocumentTemplateV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentTemplateV2(obj: unknown): obj is IPublisherDocumentTemplateV2;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherDocumentV1(obj: unknown): obj is IPublisherDocumentV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherDocumentV2(obj: unknown): obj is IPublisherDocumentV2;
+
+/**
+ * Current version of {@link isPublisherHeadingSlotV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherHeadingSlot: typeof isPublisherHeadingSlotV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherHeadingSlotV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherHeadingSlotV1(obj: unknown): obj is IPublisherHeadingSlotV1;
+
+/**
+ * Current version of {@link isPublisherHeadingTypeV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherHeadingType: typeof isPublisherHeadingTypeV1;
+
+/**
+ * Type-guard testing whether the value is a {@link PublisherHeadingTypeV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherHeadingTypeV1(value: unknown): value is PublisherHeadingTypeV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherHeadingWidgetV2(obj: unknown): obj is IPublisherHeadingWidgetV2;
+
+/**
+ * Current version of {@link isPublisherImageBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherImageBackground: typeof isPublisherImageBackgroundV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherImageBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherImageBackgroundV1(obj: unknown): obj is IPublisherImageBackgroundV1;
+
+/**
+ * Current version of {@link isPublisherImageSlotV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherImageSlot: typeof isPublisherImageSlotV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherImageSlotV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherImageSlotV1(obj: unknown): obj is IPublisherImageSlotV1;
+
+/**
+ * @alpha
+ */
+export declare function isPublisherImageWidgetV2(obj: unknown): obj is IPublisherImageWidgetV2;
+
+/**
+ * Current version of {@link isPublisherLayoutSectionV1}.
+ *
+ * @alpha
+ */
+export declare const isPublisherLayoutSection: typeof isPublisherLayoutSectionV1;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSectionV1}.
+ *
+ * @alpha
+ */
+export declare function isPublisherLayoutSectionV1(obj: unknown): obj is IPublisherLayoutSectionV1;
+
+/**
+ * Current version of {@link isPublisherLayoutSlotRefV1}.
+ *
+ * @alpha
  */
-export declare interface ISourceInsightDateFilterRef {
-    type: "dateFilter";
-    dataSet: ObjRefInScope;
-}
+export declare const isPublisherLayoutSlotRef: typeof isPublisherLayoutSlotRefV1;
 
 /**
- * Source insight measure value filter reference.
- * @public
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSlotRefV1}.
+ *
+ * @alpha
  */
-export declare interface ISourceInsightMeasureValueFilterRef {
-    type: "measureValueFilter";
-    measure: ObjRefInScope;
-}
+export declare function isPublisherLayoutSlotRefV1(obj: unknown): obj is IPublisherLayoutSlotRefV1;
 
 /**
- * Source insight ranking filter reference.
- * @public
+ * @alpha
  */
-export declare interface ISourceInsightRankingFilterRef {
-    type: "rankingFilter";
-    measure: ObjRefInScope;
-}
+export declare function isPublisherPageBodyV2(obj: unknown): obj is IPublisherPageBodyV2;
 
 /**
- * Tests whether the provided object is of type {@link IParameterMetadataObject}.
+ * Current version of {@link isPublisherPageFormatV1}.
  *
- * @param obj - object to test
- * @public
+ * @alpha
  */
-export declare function isParameterMetadataObject(obj: unknown): obj is IParameterMetadataObject;
+export declare const isPublisherPageFormat: typeof isPublisherPageFormatV1;
 
 /**
- * Tests whether the provided object is of type {@link IParameterMetadataObjectDefinition}.
+ * Type-guard testing whether the provided value is a {@link PublisherPageFormatV1}.
  *
- * @param obj - object to test
- * @public
+ * @alpha
  */
-export declare function isParameterMetadataObjectDefinition(obj: unknown): obj is IParameterMetadataObjectDefinition;
+export declare function isPublisherPageFormatV1(value: unknown): value is PublisherPageFormatV1;
 
 /**
- * Type guard for checking whether object is a period-over-period measure.
+ * Current version of {@link isPublisherPageLayoutV1}.
  *
- * @public
+ * @alpha
  */
-export declare function isPoPMeasure(obj: unknown): obj is IMeasure<IPoPMeasureDefinition>;
+export declare const isPublisherPageLayout: typeof isPublisherPageLayoutV1;
 
 /**
- * Type guard for checking whether object is a period-over-period measure definition.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutContentV1}.
  *
- * @public
+ * @alpha
  */
-export declare function isPoPMeasureDefinition(obj: unknown): obj is IPoPMeasureDefinition;
+export declare function isPublisherPageLayoutContentV1(obj: unknown): obj is IPublisherPageLayoutContentV1;
 
 /**
- * Type guard checking whether the provided object is a positive attribute filter.
+ * Current version of {@link isPublisherPageLayoutDefinitionV1}.
  *
- * @public
+ * @alpha
  */
-export declare function isPositiveAttributeFilter(obj: unknown): obj is IPositiveAttributeFilter;
+export declare const isPublisherPageLayoutDefinition: typeof isPublisherPageLayoutDefinitionV1;
 
 /**
- * Type guard for checking whether object is a previous-period measure.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutDefinitionV1}.
  *
- * @public
+ * @alpha
  */
-export declare function isPreviousPeriodMeasure(obj: unknown): obj is IMeasure<IPreviousPeriodMeasureDefinition>;
+export declare function isPublisherPageLayoutDefinitionV1(obj: unknown): obj is IPublisherPageLayoutDefinitionV1;
 
 /**
- * Type guard for checking whether object is a previous period measure definition.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutV1}.
  *
- * @public
+ * @alpha
  */
-export declare function isPreviousPeriodMeasureDefinition(obj: unknown): obj is IPreviousPeriodMeasureDefinition;
+export declare function isPublisherPageLayoutV1(obj: unknown): obj is IPublisherPageLayoutV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherColorBackground}.
- *
  * @alpha
  */
-export declare function isPublisherColorBackground(obj: unknown): obj is IPublisherColorBackground;
+export declare function isPublisherPageSizeV2(value: unknown): value is PublisherPageSizeV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherDocument}.
- *
  * @alpha
  */
-export declare function isPublisherDocument(obj: unknown): obj is IPublisherDocument;
+export declare function isPublisherPageTemplateDefinitionV2(obj: unknown): obj is IPublisherPageTemplateDefinitionV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentContent}.
- *
  * @alpha
  */
-export declare function isPublisherDocumentContentV1(obj: unknown): obj is IPublisherDocumentContent;
+export declare function isPublisherPageTemplateV2(obj: unknown): obj is IPublisherPageTemplateV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentDefinition}.
+ * Current version of {@link isPublisherParagraphSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherDocumentDefinition(obj: unknown): obj is IPublisherDocumentDefinition;
+export declare const isPublisherParagraphSlot: typeof isPublisherParagraphSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplate}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherParagraphSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherDocumentTemplate(obj: unknown): obj is IPublisherDocumentTemplate;
+export declare function isPublisherParagraphSlotV1(obj: unknown): obj is IPublisherParagraphSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherDocumentTemplateDefinition}.
+ * Current version of {@link isPublisherParagraphTypeV1}.
  *
  * @alpha
  */
-export declare function isPublisherDocumentTemplateDefinition(obj: unknown): obj is IPublisherDocumentTemplateDefinition;
+export declare const isPublisherParagraphType: typeof isPublisherParagraphTypeV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherHeadingSlot}.
+ * Type-guard testing whether the value is a {@link PublisherParagraphTypeV1}.
  *
  * @alpha
  */
-export declare function isPublisherHeadingSlot(obj: unknown): obj is IPublisherHeadingSlot;
+export declare function isPublisherParagraphTypeV1(value: unknown): value is PublisherParagraphTypeV1;
 
 /**
- * Type-guard testing whether the value is a {@link PublisherHeadingType}.
- *
  * @alpha
  */
-export declare function isPublisherHeadingType(value: unknown): value is PublisherHeadingType;
+export declare function isPublisherRelativePeriodV2(obj: unknown): obj is IPublisherRelativePeriodV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherImageBackground}.
- *
  * @alpha
  */
-export declare function isPublisherImageBackground(obj: unknown): obj is IPublisherImageBackground;
+export declare function isPublisherRowV2(obj: unknown): obj is IPublisherContainerV2 & {
+    type: "row";
+};
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherImageSlot}.
+ * Current version of {@link isPublisherSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherImageSlot(obj: unknown): obj is IPublisherImageSlot;
+export declare const isPublisherSlot: typeof isPublisherSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSection}.
+ * Type-guard testing whether the provided object is an instance of {@link PublisherSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherLayoutSection(obj: unknown): obj is IPublisherLayoutSection;
+export declare function isPublisherSlotV1(obj: unknown): obj is PublisherSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherLayoutSlotRef}.
- *
  * @alpha
  */
-export declare function isPublisherLayoutSlotRef(obj: unknown): obj is IPublisherLayoutSlotRef;
+export declare function isPublisherTakeawayWidgetV2(obj: unknown): obj is IPublisherTakeawayWidgetV2;
 
 /**
- * Type-guard testing whether the provided value is a {@link PublisherPageFormat}.
+ * Current version of {@link isPublisherTextSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageFormat(value: unknown): value is PublisherPageFormat;
+export declare const isPublisherTextSlot: typeof isPublisherTextSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayout}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherTextSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherPageLayout(obj: unknown): obj is IPublisherPageLayout;
+export declare function isPublisherTextSlotV1(obj: unknown): obj is IPublisherTextSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutContent}.
- *
  * @alpha
  */
-export declare function isPublisherPageLayoutContentV1(obj: unknown): obj is IPublisherPageLayoutContent;
+export declare function isPublisherTextStyleNameV2(value: unknown): value is PublisherTextStyleNameV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherPageLayoutDefinition}.
- *
  * @alpha
  */
-export declare function isPublisherPageLayoutDefinition(obj: unknown): obj is IPublisherPageLayoutDefinition;
+export declare function isPublisherTextWidgetV2(obj: unknown): obj is IPublisherTextWidgetV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherParagraphSlot}.
- *
  * @alpha
  */
-export declare function isPublisherParagraphSlot(obj: unknown): obj is IPublisherParagraphSlot;
+export declare function isPublisherTitleWidgetV2(obj: unknown): obj is IPublisherTitleWidgetV2;
 
 /**
- * Type-guard testing whether the value is a {@link PublisherParagraphType}.
+ * Current version of {@link isPublisherVisualizationSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherParagraphType(value: unknown): value is PublisherParagraphType;
+export declare const isPublisherVisualizationSlot: typeof isPublisherVisualizationSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link PublisherSlot}.
+ * Type-guard testing whether the provided object is an instance of {@link IPublisherVisualizationSlotV1}.
  *
  * @alpha
  */
-export declare function isPublisherSlot(obj: unknown): obj is PublisherSlot;
+export declare function isPublisherVisualizationSlotV1(obj: unknown): obj is IPublisherVisualizationSlotV1;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherTextSlot}.
- *
  * @alpha
  */
-export declare function isPublisherTextSlot(obj: unknown): obj is IPublisherTextSlot;
+export declare function isPublisherVisualizationWidgetV2(obj: unknown): obj is IPublisherVisualizationWidgetV2;
 
 /**
- * Type-guard testing whether the provided object is an instance of {@link IPublisherVisualizationSlot}.
- *
  * @alpha
  */
-export declare function isPublisherVisualizationSlot(obj: unknown): obj is IPublisherVisualizationSlot;
+export declare function isPublisherWidgetV2(obj: unknown): obj is PublisherWidgetV2;
 
 /**
  * Type guard checking whether the provided object is a measure value filter's range condition.
@@ -18874,17 +20287,24 @@ export declare function newAbsoluteDateFilter(dateDataSet: ObjRef | Identifier,
  */
 export declare function newAbsoluteDateFilter(dateDataSet: ObjRef | Identifier, from: string, to: string, localIdentifier?: string, emptyValueHandling?: EmptyValues): IAbsoluteDateFilter;
 
+/**
+ * Current version of {@link newAdHocPublisherDocumentDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare const newAdHocPublisherDocumentDefinition: typeof newAdHocPublisherDocumentDefinitionV1;
+
 /**
  * Creates an ad-hoc document definition not based on any template.
  *
  * @alpha
  */
-export declare function newAdHocPublisherDocumentDefinition(options: {
+export declare function newAdHocPublisherDocumentDefinitionV1(options: {
     title: string;
-    periodStart: PublisherDateString;
-    periodEnd: PublisherDateString;
-    pages?: IPublisherDocumentPage[];
-}, modifications?: Partial<Omit<IPublisherDocumentDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinition;
+    periodStart: PublisherDateStringV1;
+    periodEnd: PublisherDateStringV1;
+    pages?: IPublisherDocumentPageV1[];
+}, modifications?: Partial<Omit<IPublisherDocumentDefinitionV1, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinitionV1;
 
 /**
  * Creates a new all time date filter. This filter is used to indicate that there should be no filtering on the dates.
@@ -19224,12 +20644,26 @@ export declare function newPositiveAttributeFilter(attributeOrRef: IAttribute |
  */
 export declare function newPreviousPeriodMeasure(measureIdOrLocalId: MeasureOrLocalId, dateDataSets: IPreviousPeriodDateDataSetSimple[], modifications?: MeasureModifications<PreviousPeriodMeasureBuilder>): IMeasure<IPreviousPeriodMeasureDefinition>;
 
+/**
+ * Current version of {@link newPublisherDocumentContentV1}.
+ *
+ * @alpha
+ */
+export declare const newPublisherDocumentContent: typeof newPublisherDocumentContentV1;
+
 /**
  * Creates document content from page instances.
  *
  * @alpha
  */
-export declare function newPublisherDocumentContent(pages: IPublisherDocumentPage[], modifications?: Partial<Omit<IPublisherDocumentContent, "version" | "pages">>): IPublisherDocumentContent;
+export declare function newPublisherDocumentContentV1(pages: IPublisherDocumentPageV1[], modifications?: Partial<Omit<IPublisherDocumentContentV1, "version" | "pages">>): IPublisherDocumentContentV1;
+
+/**
+ * Current version of {@link newPublisherDocumentDefinitionFromTemplateV1}.
+ *
+ * @alpha
+ */
+export declare const newPublisherDocumentDefinitionFromTemplate: typeof newPublisherDocumentDefinitionFromTemplateV1;
 
 /**
  * Creates a document definition from a template.
@@ -19240,11 +20674,32 @@ export declare function newPublisherDocumentContent(pages: IPublisherDocumentPag
  *
  * @alpha
  */
-export declare function newPublisherDocumentDefinitionFromTemplate(template: IPublisherDocumentTemplate | IPublisherDocumentTemplateDefinition, options: {
+export declare function newPublisherDocumentDefinitionFromTemplateV1(template: IPublisherDocumentTemplateV1 | IPublisherDocumentTemplateDefinitionV1, options: {
     title: string;
-    periodStart: PublisherDateString;
-    periodEnd: PublisherDateString;
-}, modifications?: Partial<Omit<IPublisherDocumentDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinition;
+    periodStart: PublisherDateStringV1;
+    periodEnd: PublisherDateStringV1;
+}, modifications?: Partial<Omit<IPublisherDocumentDefinitionV1, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IPublisherDocumentDefinitionV1;
+
+/**
+ * Generates a document filter id such as `document_filter_region_name`.
+ *
+ * @remarks
+ * Every character of the target's identifier outside `[A-Za-z0-9_]` becomes `_`, and the id is cut to
+ * 64 characters. When the document already uses the id, `_2`, `_3` and so on is appended, with the
+ * base shortened so the id stays within 64 characters.
+ *
+ * Throws when the target is not an identifier ref.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentFilterIdV2({ target, usedIds, }: INewPublisherDocumentFilterIdOptionsV2): string;
+
+/**
+ * Current version of {@link newPublisherDocumentPageFromLayoutV1}.
+ *
+ * @alpha
+ */
+export declare const newPublisherDocumentPageFromLayout: typeof newPublisherDocumentPageFromLayoutV1;
 
 /**
  * Clones a page layout into a page instance embeddable in template/document content.
@@ -19256,21 +20711,80 @@ export declare function newPublisherDocumentDefinitionFromTemplate(template: IPu
  *
  * @alpha
  */
-export declare function newPublisherDocumentPageFromLayout(page: IPublisherPageLayout | IPublisherPageLayoutDefinition, localIdentifier?: string): IPublisherDocumentPage;
+export declare function newPublisherDocumentPageFromLayoutV1(page: IPublisherPageLayoutV1 | IPublisherPageLayoutDefinitionV1, localIdentifier?: string): IPublisherDocumentPageV1;
+
+/**
+ * Copies a page template's content into a new document page.
+ *
+ * @remarks
+ * The page is a deep copy with its own page id. Widget ids stay as written, so pages made from
+ * one template share widget ids; a widget is addressed by page id plus widget id.
+ *
+ * A document page can be passed as the template: its `id` is replaced and its `visible` is dropped.
+ *
+ * @alpha
+ */
+export declare function newPublisherDocumentPageFromTemplateV2(body: IPublisherPageBodyV2 & Partial<Pick<IPublisherDocumentPageV2, "id" | "visible">>, id?: string): IPublisherDocumentPageV2;
+
+/**
+ * Current version of {@link newPublisherDocumentTemplateDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare const newPublisherDocumentTemplateDefinition: typeof newPublisherDocumentTemplateDefinitionV1;
 
 /**
  * Creates a new document template definition.
  *
  * @alpha
  */
-export declare function newPublisherDocumentTemplateDefinition(title: string, content: IPublisherDocumentContent, modifications?: Partial<Omit<IPublisherDocumentTemplateDefinition, "type" | "title" | "content">>): IPublisherDocumentTemplateDefinition;
+export declare function newPublisherDocumentTemplateDefinitionV1(title: string, content: IPublisherDocumentContentV1, modifications?: Partial<Omit<IPublisherDocumentTemplateDefinitionV1, "type" | "title" | "content">>): IPublisherDocumentTemplateDefinitionV1;
+
+/**
+ * Generates an id such as `widget_7f3a91c4`.
+ *
+ * @remarks
+ * For a valid id, the prefix uses only `[A-Za-z0-9_.-]`, has at most 55 characters and does not
+ * start with `default.`.
+ *
+ * @alpha
+ */
+export declare function newPublisherIdV2(prefix: string): string;
+
+/**
+ * Generates a page id such as `page_7f3a91c4`.
+ *
+ * @alpha
+ */
+export declare function newPublisherPageIdV2(): string;
+
+/**
+ * Current version of {@link newPublisherPageLayoutDefinitionV1}.
+ *
+ * @alpha
+ */
+export declare const newPublisherPageLayoutDefinition: typeof newPublisherPageLayoutDefinitionV1;
 
 /**
  * Creates a new page layout definition.
  *
  * @alpha
  */
-export declare function newPublisherPageLayoutDefinition(title: string, body: IPublisherPageBody, modifications?: Partial<Omit<IPublisherPageLayoutDefinition, "type" | "title" | "content">>): IPublisherPageLayoutDefinition;
+export declare function newPublisherPageLayoutDefinitionV1(title: string, body: IPublisherPageBodyV1, modifications?: Partial<Omit<IPublisherPageLayoutDefinitionV1, "type" | "title" | "content">>): IPublisherPageLayoutDefinitionV1;
+
+/**
+ * Generates a section id such as `section_7f3a91c4`.
+ *
+ * @alpha
+ */
+export declare function newPublisherSectionIdV2(): string;
+
+/**
+ * Generates a widget id such as `widget_7f3a91c4`.
+ *
+ * @alpha
+ */
+export declare function newPublisherWidgetIdV2(): string;
 
 /**
  * Creates a new ranking filter.
@@ -19653,98 +21167,234 @@ export declare class PoPMeasureBuilder extends MeasureBuilderBase<IPoPMeasureDef
 }
 
 /**
- * Input to the PoPMeasureBuilder.
- * @public
+ * Input to the PoPMeasureBuilder.
+ * @public
+ */
+export declare type PoPMeasureBuilderInput = {
+    measureOrLocalId: MeasureOrLocalId;
+    popAttrIdOrRef: ObjRef | Identifier;
+} | IMeasure<IPoPMeasureDefinition>;
+
+/**
+ * Builder for previous period measures.
+ *
+ * Do not instantiate this builder directly, instead use {@link newPreviousPeriodMeasure}.
+ *
+ * @public
+ */
+export declare class PreviousPeriodMeasureBuilder extends MeasureBuilderBase<IPreviousPeriodMeasureDefinition> {
+    private previousPeriodMeasure;
+    /**
+     * @internal
+     */
+    constructor(input: PreviousPeriodMeasureBuilderInput);
+    /**
+     * Sets master measure from which this previous period measure should be calculated.
+     *
+     * @param measureOrLocalId - measure value or measure local identifier
+     */
+    masterMeasure: (measureOrLocalId: MeasureOrLocalId) => this;
+    /**
+     * Sets date data set + offset within the data set to use when calculating values of this measure.
+     *
+     * @param dd - date data set + offset
+     */
+    dateDataSets: (dd: IPreviousPeriodDateDataSetSimple[]) => this;
+    protected buildDefinition(): IPreviousPeriodMeasureDefinition;
+    protected generateLocalId(): string;
+    private convertDd;
+}
+
+/**
+ * Import to the PreviousPeriodMeasureBuilder.
+ * @public
+ */
+export declare type PreviousPeriodMeasureBuilderInput = {
+    measureIdOrLocalId: MeasureOrLocalId;
+    dateDataSets: IPreviousPeriodDateDataSetSimple[];
+} | IMeasure<IPreviousPeriodMeasureDefinition>;
+
+/**
+ * Current version of {@link PublisherBackgroundV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherBackground = PublisherBackgroundV1;
+
+/**
+ * What a section or page paints behind its content.
+ *
+ * @alpha
+ */
+export declare type PublisherBackgroundV1 = IPublisherColorBackgroundV1 | IPublisherImageBackgroundV1;
+
+/**
+ * @alpha
+ */
+export declare type PublisherBorderLineStyleV2 = "solid" | "dashed" | "dotted" | "none";
+
+/**
+ * Current version of {@link PublisherBuiltInVariableV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherBuiltInVariable = PublisherBuiltInVariableV1;
+
+/**
+ * Current version of {@link PublisherBuiltInVariablesV1}.
+ *
+ * @alpha
+ */
+export declare const PublisherBuiltInVariables: PublisherBuiltInVariableV1[];
+
+/**
+ * All built-in document variable names.
+ *
+ * @alpha
+ */
+export declare const PublisherBuiltInVariablesV1: PublisherBuiltInVariableV1[];
+
+/**
+ * Variables resolved by the rendering runtime; they are never declared or stored.
+ *
+ * @remarks
+ * Referenced from document text as `{name}`. Custom variable names must not collide with these;
+ * on collision the built-in wins.
+ *
+ * @alpha
+ */
+export declare type PublisherBuiltInVariableV1 = "reportName" | "reportDescription" | "periodStart" | "periodEnd" | "reportDateRange" | "reportAttributeFilters" | "exportedAt" | "exportedBy" | "lastModifiedAt" | "lastModifiedBy" | "workspaceName" | "workspaceId" | "totalPages" | "currentPageNumber" | "logo";
+
+/**
+ * Theme color reference or literal color.
+ *
+ * @remarks
+ * A reference is the whole value, never part of a longer string:
+ * `{theme.colors.<list>.<id>}`, where list is `backgrounds`, `texts` or `lines`, or
+ * `{theme.palette.<name>}`, where name is `primary`, `success`, `error` or `warning`.
+ * The ids `default`, `surface`, `inverse`, `muted` and `accent` always resolve.
+ *
+ * A literal is `#rgb`, `#rrggbb`, `#rrggbbaa`, or `rgb()` with 3 or 4 arguments. `#rgba` is invalid.
+ *
+ * @alpha
+ */
+export declare type PublisherColorValueV2 = string;
+
+/**
+ * Current version of {@link PublisherContentAlignmentV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherContentAlignment = PublisherContentAlignmentV1;
+
+/**
+ * Where content sits inside the box that carries it, along one axis.
+ *
+ * @alpha
+ */
+export declare type PublisherContentAlignmentV1 = "start" | "center" | "end";
+
+/**
+ * @alpha
+ */
+export declare type PublisherContentVersionV2 = "2";
+
+/**
+ * Current version of {@link PublisherDateStringV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherDateString = PublisherDateStringV1;
+
+/**
+ * ISO 8601 calendar date (YYYY-MM-DD).
+ *
+ * @alpha
+ */
+export declare type PublisherDateStringV1 = string;
+
+/**
+ * Returns the sections of document content. Content stored as `pages` becomes one untitled section
+ * with a generated id.
+ *
+ * @remarks
+ * For content stored as `pages`, each call returns a new section id. Read once and keep the result
+ * for as long as the section must stay the same one.
+ *
+ * @alpha
  */
-export declare type PoPMeasureBuilderInput = {
-    measureOrLocalId: MeasureOrLocalId;
-    popAttrIdOrRef: ObjRef | Identifier;
-} | IMeasure<IPoPMeasureDefinition>;
+export declare function publisherDocumentContentSectionsV2(content: PublisherDocumentContentV2): IPublisherSectionV2[];
 
 /**
- * Builder for previous period measures.
+ * Writes sections back into document content, in the shape the content was read in.
  *
- * Do not instantiate this builder directly, instead use {@link newPreviousPeriodMeasure}.
+ * @remarks
+ * The result holds `sections` when the content held `sections`, when there is more than one section,
+ * or when the only section has a title or description. Otherwise it holds `pages`, and the section's
+ * id is dropped.
  *
- * @public
+ * @alpha
  */
-export declare class PreviousPeriodMeasureBuilder extends MeasureBuilderBase<IPreviousPeriodMeasureDefinition> {
-    private previousPeriodMeasure;
-    /**
-     * @internal
-     */
-    constructor(input: PreviousPeriodMeasureBuilderInput);
-    /**
-     * Sets master measure from which this previous period measure should be calculated.
-     *
-     * @param measureOrLocalId - measure value or measure local identifier
-     */
-    masterMeasure: (measureOrLocalId: MeasureOrLocalId) => this;
-    /**
-     * Sets date data set + offset within the data set to use when calculating values of this measure.
-     *
-     * @param dd - date data set + offset
-     */
-    dateDataSets: (dd: IPreviousPeriodDateDataSetSimple[]) => this;
-    protected buildDefinition(): IPreviousPeriodMeasureDefinition;
-    protected generateLocalId(): string;
-    private convertDd;
-}
+export declare function publisherDocumentContentSetSectionsV2({ content, sections, }: IPublisherDocumentContentSetSectionsOptionsV2): PublisherDocumentContentV2;
 
 /**
- * Import to the PreviousPeriodMeasureBuilder.
- * @public
+ * Content of a document or a document template. It holds `pages` or `sections`, never both.
+ *
+ * @alpha
  */
-export declare type PreviousPeriodMeasureBuilderInput = {
-    measureIdOrLocalId: MeasureOrLocalId;
-    dateDataSets: IPreviousPeriodDateDataSetSimple[];
-} | IMeasure<IPreviousPeriodMeasureDefinition>;
+export declare type PublisherDocumentContentV2 = IPublisherDocumentPagesContentV2 | IPublisherDocumentSectionsContentV2;
 
 /**
- * What a section or page paints behind its content.
+ * Current version of {@link publisherDocumentPageV1}.
  *
  * @alpha
  */
-export declare type PublisherBackground = IPublisherColorBackground | IPublisherImageBackground;
+export declare const publisherDocumentPage: typeof publisherDocumentPageV1;
 
 /**
- * Variables resolved by the rendering runtime; they are never declared or stored.
- *
- * @remarks
- * Referenced from document text as `{name}`. Custom variable names must not collide with these;
- * on collision the built-in wins.
+ * Convenience accessor for a document or template page by its localIdentifier.
  *
  * @alpha
  */
-export declare type PublisherBuiltInVariable = "reportName" | "reportDescription" | "periodStart" | "periodEnd" | "reportDateRange" | "reportAttributeFilters" | "exportedAt" | "exportedBy" | "lastModifiedAt" | "lastModifiedBy" | "workspaceName" | "workspaceId" | "totalPages" | "currentPageNumber" | "logo";
+export declare function publisherDocumentPageV1(documentOrTemplate: IPublisherDocumentV1 | IPublisherDocumentDefinitionV1 | IPublisherDocumentTemplateV1 | IPublisherDocumentTemplateDefinitionV1, pageLocalIdentifier: string): IPublisherDocumentPageV1 | undefined;
 
 /**
- * All built-in document variable names.
+ * @alpha
+ */
+export declare type PublisherGapValueV2 = PublisherPxV2 | "{theme.spacing.gap.compact}" | "{theme.spacing.gap.normal}" | "{theme.spacing.gap.spacious}";
+
+/**
+ * Text style a heading uses when its style sets none: `h(n+1)` for level n, `h6` for levels 5 and 6.
  *
  * @alpha
  */
-export declare const PublisherBuiltInVariables: PublisherBuiltInVariable[];
+export declare function publisherHeadingDefaultTextStyleV2(level?: PublisherHeadingLevelV2): Extract<PublisherTextStyleNameV2, "h2" | "h3" | "h4" | "h5" | "h6">;
 
 /**
- * Where content sits inside the box that carries it, along one axis.
+ * @alpha
+ */
+export declare type PublisherHeadingLevelV2 = 1 | 2 | 3 | 4 | 5 | 6;
+
+/**
+ * Current version of {@link PublisherHeadingTypeV1}.
  *
  * @alpha
  */
-export declare type PublisherContentAlignment = "start" | "center" | "end";
+export declare type PublisherHeadingType = PublisherHeadingTypeV1;
 
 /**
- * ISO 8601 calendar date (YYYY-MM-DD).
+ * Current version of {@link PublisherHeadingTypesV1}.
  *
  * @alpha
  */
-export declare type PublisherDateString = string;
+export declare const PublisherHeadingTypes: PublisherHeadingTypeV1[];
 
 /**
- * Convenience accessor for a document or template page by its localIdentifier.
+ * All heading sizes, largest first.
  *
  * @alpha
  */
-export declare function publisherDocumentPage(documentOrTemplate: IPublisherDocument | IPublisherDocumentDefinition | IPublisherDocumentTemplate | IPublisherDocumentTemplateDefinition, pageLocalIdentifier: string): IPublisherDocumentPage | undefined;
+export declare const PublisherHeadingTypesV1: PublisherHeadingTypeV1[];
 
 /**
  * Size a heading is rendered at. Each size is styled by the matching theme text level
@@ -19752,14 +21402,19 @@ export declare function publisherDocumentPage(documentOrTemplate: IPublisherDocu
  *
  * @alpha
  */
-export declare type PublisherHeadingType = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+export declare type PublisherHeadingTypeV1 = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
 
 /**
- * All heading sizes, largest first.
+ * @alpha
+ */
+export declare type PublisherHorizontalAlignV2 = "left" | "center" | "right";
+
+/**
+ * Current version of {@link PublisherImageFitV1}.
  *
  * @alpha
  */
-export declare const PublisherHeadingTypes: PublisherHeadingType[];
+export declare type PublisherImageFit = PublisherImageFitV1;
 
 /**
  * How an image is fitted to the area it is drawn in: kept whole inside it, filling it and cropped to
@@ -19767,14 +21422,21 @@ export declare const PublisherHeadingTypes: PublisherHeadingType[];
  *
  * @alpha
  */
-export declare type PublisherImageFit = "contain" | "cover" | "fill";
+export declare type PublisherImageFitV1 = "contain" | "cover" | "fill";
+
+/**
+ * Current version of {@link PublisherImageSourceV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherImageSource = PublisherImageSourceV1;
 
 /**
  * What an image slot displays.
  *
  * @alpha
  */
-export declare type PublisherImageSource = {
+export declare type PublisherImageSourceV1 = {
     type: "url";
     /**
      * Image URL. Supports `{variables}` — a logo slot uses `{logo}`.
@@ -19788,6 +21450,73 @@ export declare type PublisherImageSource = {
     ref: ObjRef;
 };
 
+/**
+ * Theme image reference or https URL.
+ *
+ * @remarks
+ * A reference is the whole value: `{theme.logo}`, `{theme.coverImage}`, `{theme.assets.logos.<id>}`
+ * or `{theme.assets.images.<id>}`.
+ *
+ * A URL must start with `https://` and may contain text variables; each resolved value is
+ * percent-encoded and the result must still start with `https://`.
+ *
+ * @alpha
+ */
+export declare type PublisherImageSourceV2 = string;
+
+/**
+ * @alpha
+ */
+export declare type PublisherLayoutNodeV2 = IPublisherContainerV2 | PublisherWidgetV2;
+
+/**
+ * Number from 0 to 1.
+ *
+ * @alpha
+ */
+export declare type PublisherOpacityV2 = number;
+
+/**
+ * @alpha
+ */
+export declare type PublisherPaddingValueV2 = PublisherPxV2 | "{theme.spacing.padding.compact}" | "{theme.spacing.padding.normal}" | "{theme.spacing.padding.spacious}";
+
+/**
+ * Current version of {@link PublisherPageFormatV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherPageFormat = PublisherPageFormatV1;
+
+/**
+ * Current version of {@link PublisherPageFormatAspectRatiosV1}.
+ *
+ * @alpha
+ */
+export declare const PublisherPageFormatAspectRatios: Record<PublisherPageFormatV1, number>;
+
+/**
+ * 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 PublisherPageFormatAspectRatiosV1: Record<PublisherPageFormatV1, number>;
+
+/**
+ * Current version of {@link PublisherPageFormatsV1}.
+ *
+ * @alpha
+ */
+export declare const PublisherPageFormats: PublisherPageFormatV1[];
+
+/**
+ * List of built-in page format names.
+ *
+ * @alpha
+ */
+export declare const PublisherPageFormatsV1: PublisherPageFormatV1[];
+
 /**
  * Page shape a page layout is designed for.
  *
@@ -19798,31 +21527,63 @@ export declare type PublisherImageSource = {
  *
  * @alpha
  */
-export declare type PublisherPageFormat = "widescreen" | "a4Portrait" | "letterPortrait";
+export declare type PublisherPageFormatV1 = "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.
+ * Editor hint; it does not change how the page renders.
  *
  * @alpha
  */
-export declare const PublisherPageFormatAspectRatios: Record<PublisherPageFormat, number>;
+export declare type PublisherPageKindV2 = "cover" | "section" | "content";
 
 /**
- * List of built-in page format names.
+ * Current version of {@link PublisherPageLayoutNodeV1}.
  *
  * @alpha
  */
-export declare const PublisherPageFormats: PublisherPageFormat[];
+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 IPublisherPageBody.slots}.
+ * box paint, slot content lives in {@link IPublisherPageBodyV1.slots}.
+ *
+ * @alpha
+ */
+export declare type PublisherPageLayoutNodeV1 = IPublisherLayoutSectionV1 | IPublisherLayoutSlotRefV1;
+
+/**
+ * @alpha
+ */
+export declare const PublisherPageSizesV2: readonly ["widescreen"];
+
+/**
+ * Page size. The widescreen design canvas is 1920 × 1080 px.
+ *
+ * @alpha
+ */
+export declare type PublisherPageSizeV2 = (typeof PublisherPageSizesV2)[number];
+
+/**
+ * Current version of {@link PublisherParagraphTypeV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherParagraphType = PublisherParagraphTypeV1;
+
+/**
+ * Current version of {@link PublisherParagraphTypesV1}.
+ *
+ * @alpha
+ */
+export declare const PublisherParagraphTypes: PublisherParagraphTypeV1[];
+
+/**
+ * All paragraph sizes, largest first.
  *
  * @alpha
  */
-export declare type PublisherPageLayoutNode = IPublisherLayoutSection | IPublisherLayoutSlotRef;
+export declare const PublisherParagraphTypesV1: PublisherParagraphTypeV1[];
 
 /**
  * Size a paragraph is rendered at. Each size is styled by the matching theme text level
@@ -19830,28 +21591,82 @@ export declare type PublisherPageLayoutNode = IPublisherLayoutSection | IPublish
  *
  * @alpha
  */
-export declare type PublisherParagraphType = "largeText" | "normalText" | "smallText";
+export declare type PublisherParagraphTypeV1 = "largeText" | "normalText" | "smallText";
 
 /**
- * All paragraph sizes, largest first.
+ * Reported period, in the dashboard date filter grammar without a dataset.
+ *
+ * @alpha
+ */
+export declare type PublisherPeriodV2 = IPublisherAbsolutePeriodV2 | IPublisherRelativePeriodV2;
+
+/**
+ * Length in px on the page's design canvas, zero or more.
+ *
+ * @alpha
+ */
+export declare type PublisherPxV2 = number;
+
+/**
+ * @alpha
+ */
+export declare type PublisherRadiusValueV2 = PublisherPxV2 | "{theme.corners.small}" | "{theme.corners.medium}" | "{theme.corners.large}" | "{theme.corners.full}";
+
+/**
+ * `{theme.shadows.<name>}` or `none`.
+ *
+ * @alpha
+ */
+export declare type PublisherShadowValueV2 = string;
+
+/**
+ * Current version of {@link PublisherSlotV1}.
  *
  * @alpha
  */
-export declare const PublisherParagraphTypes: PublisherParagraphType[];
+export declare type PublisherSlot = PublisherSlotV1;
 
 /**
  * All slot types of document content version 1.
  *
  * @alpha
  */
-export declare type PublisherSlot = IPublisherVisualizationSlot | IPublisherTextSlot | IPublisherImageSlot;
+export declare type PublisherSlotV1 = IPublisherVisualizationSlotV1 | IPublisherTextSlotV1 | IPublisherImageSlotV1;
+
+/**
+ * Current version of {@link publisherTextPlaceholderV1}.
+ *
+ * @alpha
+ */
+export declare const publisherTextPlaceholder: typeof publisherTextPlaceholderV1;
 
 /**
  * The marker referencing the named variable from document text.
  *
  * @alpha
  */
-export declare function publisherTextPlaceholder(name: string): string;
+export declare function publisherTextPlaceholderV1(name: string): string;
+
+/**
+ * Current version of {@link publisherTextSlotTypeV1}.
+ *
+ * @alpha
+ */
+export declare const publisherTextSlotType: typeof publisherTextSlotTypeV1;
+
+/**
+ * Current version of {@link publisherTextSlotTypesV1}.
+ *
+ * @alpha
+ */
+export declare const publisherTextSlotTypes: typeof publisherTextSlotTypesV1;
+
+/**
+ * Sizes the slot can be rendered at, which is what its own type decides.
+ *
+ * @alpha
+ */
+export declare function publisherTextSlotTypesV1(slot: IPublisherTextSlotV1): PublisherTextTypeV1[];
 
 /**
  * Size the slot is rendered at.
@@ -19862,35 +21677,81 @@ export declare function publisherTextPlaceholder(name: string): string;
  *
  * @alpha
  */
-export declare function publisherTextSlotType(slot: IPublisherTextSlot): PublisherTextType;
+export declare function publisherTextSlotTypeV1(slot: IPublisherTextSlotV1): PublisherTextTypeV1;
 
 /**
- * Sizes the slot can be rendered at, which is what its own type decides.
+ * Current version of {@link PublisherTextSourceV1}.
  *
  * @alpha
  */
-export declare function publisherTextSlotTypes(slot: IPublisherTextSlot): PublisherTextType[];
+export declare type PublisherTextSource = PublisherTextSourceV1;
 
 /**
  * Where the text of a text slot comes from.
  *
  * @alpha
  */
-export declare type PublisherTextSource = IPublisherStaticTextSource | IPublisherAiTextSource;
+export declare type PublisherTextSourceV1 = IPublisherStaticTextSourceV1 | IPublisherAiTextSourceV1;
 
 /**
- * Size any document text is rendered at.
+ * @alpha
+ */
+export declare const PublisherTextStyleNamesV2: readonly ["title", "h1", "h2", "h3", "h4", "h5", "h6", "largeText", "normalText", "smallText"];
+
+/**
+ * Named text style from the theme's `documents.textStyle`.
+ *
+ * @alpha
+ */
+export declare type PublisherTextStyleNameV2 = (typeof PublisherTextStyleNamesV2)[number];
+
+/**
+ * Current version of {@link PublisherTextTypeV1}.
+ *
+ * @alpha
+ */
+export declare type PublisherTextType = PublisherTextTypeV1;
+
+/**
+ * Current version of {@link PublisherTextTypesV1}.
  *
  * @alpha
  */
-export declare type PublisherTextType = PublisherHeadingType | PublisherParagraphType;
+export declare const PublisherTextTypes: PublisherTextTypeV1[];
 
 /**
  * All sizes a text slot can be rendered at, headings first.
  *
  * @alpha
  */
-export declare const PublisherTextTypes: PublisherTextType[];
+export declare const PublisherTextTypesV1: PublisherTextTypeV1[];
+
+/**
+ * Size any document text is rendered at.
+ *
+ * @alpha
+ */
+export declare type PublisherTextTypeV1 = PublisherHeadingTypeV1 | PublisherParagraphTypeV1;
+
+/**
+ * @alpha
+ */
+export declare type PublisherVerticalAlignV2 = "top" | "center" | "bottom";
+
+/**
+ * @alpha
+ */
+export declare const PublisherWidgetTypesV2: readonly ["title", "heading", "text", "image", "visualization", "takeaway"];
+
+/**
+ * @alpha
+ */
+export declare type PublisherWidgetTypeV2 = (typeof PublisherWidgetTypesV2)[number];
+
+/**
+ * @alpha
+ */
+export declare type PublisherWidgetV2 = IPublisherTitleWidgetV2 | IPublisherHeadingWidgetV2 | IPublisherTextWidgetV2 | IPublisherImageWidgetV2 | IPublisherVisualizationWidgetV2 | IPublisherTakeawayWidgetV2;
 
 /**
  * @public
@@ -19968,6 +21829,13 @@ export declare type RequiredSettings = Condition<Partial<IPermanentSettings | IF
  */
 export declare type RequiredWorkspacePermissions = Condition<Partial<IPluggableApplicationWorkspacePermissions>>;
 
+/**
+ * Current version of {@link resolvePublisherTextPlaceholdersV1}.
+ *
+ * @alpha
+ */
+export declare const resolvePublisherTextPlaceholders: typeof resolvePublisherTextPlaceholdersV1;
+
 /**
  * Replaces `{variable}` markers with values. Markers with no value are left as-is.
  * Values are inserted verbatim — there is no recursive expansion.
@@ -19978,7 +21846,7 @@ export declare type RequiredWorkspacePermissions = Condition<Partial<IPluggableA
  *
  * @alpha
  */
-export declare function resolvePublisherTextPlaceholders(text: string, values: Record<string, string>): string;
+export declare function resolvePublisherTextPlaceholdersV1(text: string, values: Record<string, string>): string;
 
 /**
  * Resolves a dashboard timezone value to a concrete IANA timezone ID: the {@link BROWSER_DETECTED}
@@ -20369,6 +22237,32 @@ export declare type UserDataFilterDefinition = IUserDataFilterDefinition | IUser
  */
 export declare function userFullName(user: IUser): string | undefined;
 
+/**
+ * Validates the content of a document or a document template: every key, value and node type,
+ * exactly one of `pages` and `sections`, page and section ids unique in the document, a `dataSet` on
+ * every date filter, at most one filter per attribute display form or date dataset, and the page
+ * rules on every page.
+ *
+ * @alpha
+ */
+export declare function validatePublisherDocumentContentV2(content: unknown): IPublisherValidationIssueV2[];
+
+/**
+ * Validates a document, document template or page template, as a definition or as a persisted
+ * object: everything its content validator checks, `version` `"2"`, `defaults.period` set on document
+ * templates only, and the `default.` id prefix left to the backend's default page templates.
+ *
+ * @alpha
+ */
+export declare function validatePublisherEntityV2(entity: unknown): IPublisherValidationIssueV2[];
+
+/**
+ * Current version of {@link validatePublisherPageBodyV1}.
+ *
+ * @alpha
+ */
+export declare const validatePublisherPageBody: typeof validatePublisherPageBodyV1;
+
 /**
  * Validates the structural invariants of a page body beyond what its types guarantee for content
  * arriving from the wire: the page format is known, slot localIdentifiers are unique, layout
@@ -20379,7 +22273,15 @@ export declare function userFullName(user: IUser): string | undefined;
  *
  * @alpha
  */
-export declare function validatePublisherPageBody(body: IPublisherPageBody): IPublisherPageBodyValidationIssue[];
+export declare function validatePublisherPageBodyV1(body: IPublisherPageBodyV1): IPublisherPageBodyValidationIssueV1[];
+
+/**
+ * Validates a page body, such as a page template's content: every key, value and node type, at most
+ * one title widget, and widget ids unique in the page.
+ *
+ * @alpha
+ */
+export declare function validatePublisherPageBodyV2(body: unknown): IPublisherValidationIssueV2[];
 
 /**
  * Builder for virtual arithmetic measures.