@gooddata/sdk-model 11.54.0-alpha.6 → 11.54.0

package/esm/sdk-model.d.ts

@@ -949,6 +949,49 @@ export declare function bucketsTotals(buckets: IBucket[]): ITotal[];
  */
 export declare function bucketTotals(bucket: IBucket): ITotal[];
 
+/**
+ * Built-in cover page: report title and subtitle.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportPageLayoutCover: IReportPageLayout;
+
+/**
+ * All built-in report pages served by the SPI. Built-ins are read-only: they cannot be
+ * edited or deleted, and they are never persisted on the backend.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportPageLayouts: readonly IReportPageLayout[];
+
+/**
+ * Built-in section divider page.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportPageLayoutSection: IReportPageLayout;
+
+/**
+ * Built-in content page with six visualizations and a text column on the left.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportPageLayoutViz6TextLeft: IReportPageLayout;
+
+/**
+ * List of built-in report slot type names.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportSlotTypes: string[];
+
+/**
+ * All semantic kinds a text slot can carry.
+ *
+ * @alpha
+ */
+export declare const BuiltInReportTextSlotKinds: ReportTextSlotKind[];
+
 /**
  * List of built-in widget types. These type names are reserved and must not be used by custom widgets.
  *
@@ -2557,6 +2600,13 @@ export declare function getParameterAllowedValueTitle(allowedValue: IParameterAl
  */
 export declare function getParameterValueTitle(definition: IParameterDefinition, value: ParameterValue): string;
 
+/**
+ * Collects the distinct `{{variable}}` names referenced in the text, in order of first occurrence.
+ *
+ * @alpha
+ */
+export declare function getReportTextPlaceholders(text: string): string[];
+
 /**
  * Returns count of selected elements
  * @alpha
@@ -11894,6 +11944,453 @@ export declare interface IRemotePluggableApplicationsRegistryV1 {
     uiModule?: IRemotePluggableApplicationModule;
 }
 
+/**
+ * Report metadata object.
+ *
+ * @alpha
+ */
+export declare interface IReport extends IReportDefinition, IAuditableDates, IAuditableUsers {
+    ref: ObjRef;
+    /**
+     * When true, the object comes from a parent workspace and is not editable
+     * in the current workspace.
+     */
+    isLocked?: boolean;
+}
+
+/**
+ * Text generated by AI at report-build time.
+ *
+ * @alpha
+ */
+export declare interface IReportAiTextSource {
+    type: "ai";
+    /**
+     * Instruction for the generator. Supports `{{variables}}`.
+     */
+    prompt: string;
+    /**
+     * Materialized generation result (markdown), stored so the report renders
+     * deterministically without re-invoking AI. Absent until first generation.
+     */
+    content?: string;
+    /**
+     * ISO 8601 timestamp of the stored generation.
+     */
+    generatedAt?: string;
+}
+
+/**
+ * Fields shared by report definitions and persisted reports.
+ *
+ * @alpha
+ */
+export declare interface IReportBase {
+    title: string;
+    description?: string;
+    tags?: string[];
+    /**
+     * Reported period start, ISO 8601 date (YYYY-MM-DD), inclusive.
+     *
+     * @remarks
+     * At execution time the period materializes as an absolute date filter on each
+     * visualization slot's dateDataSet (lowest precedence, per-slot opt-out via
+     * ignoreReportPeriod). Also available as `{{periodStart}}` in text.
+     */
+    periodStart: ReportDateString;
+    /**
+     * Reported period end, ISO 8601 date (YYYY-MM-DD), inclusive.
+     */
+    periodEnd: ReportDateString;
+    /**
+     * Content of the report. When created from a template the content is deep-copied
+     * and NO reference to the template is kept — the report stays frozen while pages
+     * and templates evolve.
+     */
+    content: IReportContent;
+    /**
+     * Values for variables declared in content.variables, keyed by variable name.
+     */
+    variableValues?: Record<string, string>;
+}
+
+/**
+ * Versioned content shared verbatim by report templates and reports.
+ *
+ * @alpha
+ */
+export declare interface IReportContent {
+    /**
+     * Content model version, for stored-content evolution.
+     */
+    version: "1";
+    /**
+     * Ordered pages of the document.
+     */
+    pages: IReportContentPage[];
+    /**
+     * Content-level default filters; pages and slots may extend or override them.
+     * The report period is NOT stored here — it is derived from periodStart/periodEnd
+     * at execution time.
+     */
+    filters?: FilterContextItem[];
+    /**
+     * Custom variable declarations. Values live on the report
+     * ({@link IReportBase.variableValues}).
+     */
+    variables?: IReportVariableDefinition[];
+}
+
+/**
+ * Page instance embedded in template/report content: a deep clone of a page body
+ * plus its own identity.
+ *
+ * @remarks
+ * Cloning a {@link IReportPageLayout} 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 reports.
+ *
+ * @alpha
+ */
+export declare interface IReportContentPage extends IReportPageBody {
+    /**
+     * Identifier unique within the content; stable across template-to-report copy and reordering.
+     */
+    localIdentifier: string;
+}
+
+/**
+ * Payload for creating or updating a report.
+ *
+ * @alpha
+ */
+export declare interface IReportDefinition extends IReportBase {
+    type: "report";
+    /**
+     * Present when updating an existing report.
+     */
+    ref?: ObjRef;
+}
+
+/**
+ * Slot rendering an image.
+ *
+ * @alpha
+ */
+export declare interface IReportImageSlot extends IReportSlotBase {
+    type: "image";
+    /**
+     * Undefined = declared-but-empty slot.
+     */
+    source?: ReportImageSource;
+    altText?: string;
+    /**
+     * How the image fills the slot area. Defaults to "contain".
+     */
+    fit?: "contain" | "cover" | "fill";
+}
+
+/**
+ * Fields common to all report layout nodes.
+ *
+ * @alpha
+ */
+export declare interface IReportLayoutNodeBase {
+    /**
+     * 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;
+}
+
+/**
+ * A container splitting its area into children laid out along a direction.
+ *
+ * @alpha
+ */
+export declare interface IReportLayoutSection extends IReportLayoutNodeBase {
+    type: "section";
+    /**
+     * "row" lays children out horizontally, "column" vertically.
+     */
+    direction: "row" | "column";
+    children: ReportPageLayoutNode[];
+}
+
+/**
+ * A leaf assigning its area to a slot. The slot fills the area completely.
+ *
+ * @alpha
+ */
+export declare interface IReportLayoutSlotRef extends IReportLayoutNodeBase {
+    type: "slotRef";
+    /**
+     * Local identifier of a slot in {@link IReportPageBody.slots}.
+     * A slotId with no matching slot renders as an empty area.
+     */
+    slotId: string;
+}
+
+/**
+ * Body of a report page: geometry (flex split tree) plus the slots it places.
+ *
+ * @remarks
+ * This is both the content of the standalone {@link IReportPageLayout} object and the shape
+ * embedded in template/report content ({@link IReportContentPage}).
+ *
+ * There is no header/footer chrome: page title, description, footer, page numbers and
+ * logos are ordinary slots in the layout tree (text slots with `{{pageNumber}}`/`{{totalPages}}`,
+ * an image slot with `{{logo}}`). Every slot fills its layout area completely.
+ *
+ * @alpha
+ */
+export declare interface IReportPageBody {
+    /**
+     * 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";
+    /**
+     * Root of the page layout tree.
+     */
+    layout: ReportPageLayoutNode;
+    /**
+     * All slots referenced by the layout, flat, keyed by localIdentifier.
+     */
+    slots: ReportSlot[];
+    /**
+     * 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[];
+}
+
+/**
+ * Validation issue found in a report page body.
+ *
+ * @alpha
+ */
+export declare interface IReportPageBodyValidationIssue {
+    severity: "error" | "warning";
+    message: string;
+}
+
+/**
+ * Reusable report page metadata object.
+ *
+ * @alpha
+ */
+export declare interface IReportPageLayout extends IReportPageLayoutDefinition, 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.
+ *
+ * @alpha
+ */
+export declare interface IReportPageLayoutContent extends IReportPageBody {
+    /**
+     * Content model version, for stored-content evolution.
+     */
+    version: "1";
+}
+
+/**
+ * Payload for creating or updating a report page.
+ *
+ * @alpha
+ */
+export declare interface IReportPageLayoutDefinition {
+    type: "reportPageLayout";
+    /**
+     * Present when updating an existing page.
+     */
+    ref?: ObjRef;
+    title: string;
+    description?: string;
+    tags?: string[];
+    content: IReportPageLayoutContent;
+}
+
+/**
+ * Structural base of every report slot.
+ *
+ * @remarks
+ * Parsers written against this base can skip slot types introduced by a newer
+ * content version instead of failing.
+ *
+ * @alpha
+ */
+export declare interface IReportSlotBase {
+    type: string;
+    /**
+     * Identifier unique within the page body. The layout tree references it, and it is
+     * the join key when a report 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?: IReportSlotPlaceholder;
+}
+
+/**
+ * Metadata of a slot that is intentionally left unfilled in a report page or template.
+ *
+ * @alpha
+ */
+export declare interface IReportSlotPlaceholder {
+    /**
+     * Authoring hint shown in the empty slot.
+     */
+    hint?: string;
+    /**
+     * When true, a report is not considered complete until this slot is filled.
+     */
+    required?: boolean;
+}
+
+/**
+ * Author-written text.
+ *
+ * @alpha
+ */
+export declare interface IReportStaticTextSource {
+    type: "static";
+    /**
+     * Markdown content with `{{variable}}` placeholders. Stored raw — placeholders are
+     * resolved only at render/export time.
+     */
+    content: string;
+}
+
+/**
+ * Report template metadata object.
+ *
+ * @alpha
+ */
+export declare interface IReportTemplate extends IReportTemplateDefinition, IAuditableDates, IAuditableUsers {
+    ref: ObjRef;
+    /**
+     * When true, the object comes from a parent workspace and is not editable
+     * in the current workspace.
+     */
+    isLocked?: boolean;
+}
+
+/**
+ * Payload for creating or updating a report template.
+ *
+ * @alpha
+ */
+export declare interface IReportTemplateDefinition {
+    type: "reportTemplate";
+    /**
+     * Present when updating an existing template.
+     */
+    ref?: ObjRef;
+    title: string;
+    description?: string;
+    tags?: string[];
+    content: IReportContent;
+}
+
+/**
+ * Slot rendering text.
+ *
+ * @alpha
+ */
+export declare interface IReportTextSlot extends IReportSlotBase {
+    type: "text";
+    kind: ReportTextSlotKind;
+    /**
+     * Undefined = declared-but-empty slot.
+     */
+    source?: ReportTextSource;
+}
+
+/**
+ * A custom variable declared by report content and given a value by a report.
+ *
+ * @remarks
+ * Referenced from text as `{{name}}`. Values come from {@link IReportBase.variableValues},
+ * falling back to {@link IReportVariableDefinition.defaultValue}.
+ *
+ * @alpha
+ */
+export declare interface IReportVariableDefinition {
+    /**
+     * Variable name as used inside the `{{...}}` marker. Must match /^[a-zA-Z][a-zA-Z0-9_]*$/.
+     * Built-in names ({@link ReportBuiltInVariable}) are reserved.
+     */
+    name: string;
+    /**
+     * Human readable label shown in the editor.
+     */
+    title?: string;
+    description?: string;
+    /**
+     * Value used when the report does not provide one. May not contain further
+     * placeholders — there is no recursive expansion.
+     */
+    defaultValue?: string;
+}
+
+/**
+ * Slot rendering an insight, with its own filter context.
+ *
+ * @alpha
+ */
+export declare interface IReportVisualizationSlot extends IReportSlotBase {
+    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;
+    /**
+     * Visualization properties overriding the insight's own.
+     */
+    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.
+     */
+    filters?: FilterContextItem[];
+    /**
+     * Content- and page-level filters this slot ignores (matched by display form / date dataset).
+     */
+    ignoredFilters?: IDashboardFilterReference[];
+    /**
+     * Date dataset the report'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 report's period is not
+     * applied to this slot.
+     */
+    ignoreReportPeriod?: boolean;
+}
+
 /**
  * Attribute header specifies name and URI of the attribute element to which the calculated measure
  * values in the particular data view slice belong.
@@ -13926,6 +14423,104 @@ export declare function isRelativeUpperBoundedDateFilterBody(obj: unknown): obj
  */
 export declare function isRemotePluggableApplicationRegistryItem(app: PluggableApplicationRegistryItem): app is RemotePluggableApplicationRegistryItem;
 
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReport}.
+ *
+ * @alpha
+ */
+export declare function isReport(obj: unknown): obj is IReport;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportContent}.
+ *
+ * @alpha
+ */
+export declare function isReportContentV1(obj: unknown): obj is IReportContent;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportDefinition}.
+ *
+ * @alpha
+ */
+export declare function isReportDefinition(obj: unknown): obj is IReportDefinition;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportImageSlot}.
+ *
+ * @alpha
+ */
+export declare function isReportImageSlot(obj: unknown): obj is IReportImageSlot;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSection}.
+ *
+ * @alpha
+ */
+export declare function isReportLayoutSection(obj: unknown): obj is IReportLayoutSection;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportLayoutSlotRef}.
+ *
+ * @alpha
+ */
+export declare function isReportLayoutSlotRef(obj: unknown): obj is IReportLayoutSlotRef;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportPageLayout}.
+ *
+ * @alpha
+ */
+export declare function isReportPageLayout(obj: unknown): obj is IReportPageLayout;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportPageLayoutContent}.
+ *
+ * @alpha
+ */
+export declare function isReportPageLayoutContentV1(obj: unknown): obj is IReportPageLayoutContent;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportPageLayoutDefinition}.
+ *
+ * @alpha
+ */
+export declare function isReportPageLayoutDefinition(obj: unknown): obj is IReportPageLayoutDefinition;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link ReportSlot}.
+ *
+ * @alpha
+ */
+export declare function isReportSlot(obj: unknown): obj is ReportSlot;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportTemplate}.
+ *
+ * @alpha
+ */
+export declare function isReportTemplate(obj: unknown): obj is IReportTemplate;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportTemplateDefinition}.
+ *
+ * @alpha
+ */
+export declare function isReportTemplateDefinition(obj: unknown): obj is IReportTemplateDefinition;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportTextSlot}.
+ *
+ * @alpha
+ */
+export declare function isReportTextSlot(obj: unknown): obj is IReportTextSlot;
+
+/**
+ * Type-guard testing whether the provided object is an instance of {@link IReportVisualizationSlot}.
+ *
+ * @alpha
+ */
+export declare function isReportVisualizationSlot(obj: unknown): obj is IReportVisualizationSlot;
+
 /**
  * Type-guard testing whether the provided object is an instance of {@link IResultAttributeHeader}.
  *
@@ -17164,6 +17759,18 @@ export declare function newAbsoluteDashboardDateFilter(from: DateString, to: Dat
  */
 export declare function newAbsoluteDateFilter(dateDataSet: ObjRef | Identifier, from: string, to: string, localIdentifier?: string, emptyValueHandling?: EmptyValues): IAbsoluteDateFilter;
 
+/**
+ * Creates an ad-hoc report definition not based on any template.
+ *
+ * @alpha
+ */
+export declare function newAdHocReportDefinition(options: {
+    title: string;
+    periodStart: ReportDateString;
+    periodEnd: ReportDateString;
+    pages?: IReportContentPage[];
+}, modifications?: Partial<Omit<IReportDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IReportDefinition;
+
 /**
  * Creates a new all time date filter. This filter is used to indicate that there should be no filtering on the dates.
  *
@@ -17554,6 +18161,54 @@ export declare function newRelativeDashboardDateFilter(granularity: DateFilterGr
  */
 export declare function newRelativeDateFilter(dateDataSet: ObjRef | Identifier, granularity: DateAttributeGranularity, from: number, to: number, localIdentifier?: string, boundedFilter?: IUpperBoundedFilter | ILowerBoundedFilter, emptyValueHandling?: EmptyValues): IRelativeDateFilter;
 
+/**
+ * Creates report content from page instances.
+ *
+ * @alpha
+ */
+export declare function newReportContent(pages: IReportContentPage[], modifications?: Partial<Omit<IReportContent, "version" | "pages">>): IReportContent;
+
+/**
+ * Clones a report page into a page instance embeddable in template/report content.
+ *
+ * @remarks
+ * The body is deep-copied and detached from the source page — no reference is kept.
+ * Slot localIdentifiers (and the layout slotIds pointing at them) are prefixed with the
+ * page-instance localIdentifier, so one page used repeatedly in the same content stays unique.
+ *
+ * @alpha
+ */
+export declare function newReportContentPageFromLayout(page: IReportPageLayout | IReportPageLayoutDefinition, localIdentifier?: string): IReportContentPage;
+
+/**
+ * Creates a report definition from a template.
+ *
+ * @remarks
+ * The template content is deep-copied; no reference to the template is kept, so the
+ * report stays frozen while the template evolves.
+ *
+ * @alpha
+ */
+export declare function newReportDefinitionFromTemplate(template: IReportTemplate | IReportTemplateDefinition, options: {
+    title: string;
+    periodStart: ReportDateString;
+    periodEnd: ReportDateString;
+}, modifications?: Partial<Omit<IReportDefinition, "type" | "title" | "periodStart" | "periodEnd" | "content">>): IReportDefinition;
+
+/**
+ * Creates a new report page definition.
+ *
+ * @alpha
+ */
+export declare function newReportPageLayoutDefinition(title: string, body: IReportPageBody, modifications?: Partial<Omit<IReportPageLayoutDefinition, "type" | "title" | "content">>): IReportPageLayoutDefinition;
+
+/**
+ * Creates a new report template definition.
+ *
+ * @alpha
+ */
+export declare function newReportTemplateDefinition(title: string, content: IReportContent, modifications?: Partial<Omit<IReportTemplateDefinition, "type" | "title" | "content">>): IReportTemplateDefinition;
+
 /**
  * Creates a new total.
  *
@@ -17664,7 +18319,7 @@ export declare type ObjectPermissionsObjectKind = "attribute" | "fact" | "label"
  *
  * @public
  */
-export declare type ObjectType = "measure" | "fact" | "attribute" | "computedAttribute" | "displayForm" | "dataSet" | "tag" | "insight" | "variable" | "analyticalDashboard" | "theme" | "colorPalette" | "workspaceTheme" | "workspaceColorPalette" | "filterContext" | "dashboardPlugin" | "attributeHierarchy" | "user" | "userGroup" | "dateHierarchyTemplate" | "dateAttributeHierarchy" | "exportDefinition" | "automation" | "filterView" | "workspaceDataFilter" | "workspaceDataFilterSetting" | "userDataFilter" | "notificationChannel" | "memoryItem" | "parameter";
+export declare type ObjectType = "measure" | "fact" | "attribute" | "computedAttribute" | "displayForm" | "dataSet" | "tag" | "insight" | "variable" | "analyticalDashboard" | "theme" | "colorPalette" | "workspaceTheme" | "workspaceColorPalette" | "filterContext" | "dashboardPlugin" | "attributeHierarchy" | "user" | "userGroup" | "dateHierarchyTemplate" | "dateAttributeHierarchy" | "exportDefinition" | "automation" | "filterView" | "workspaceDataFilter" | "workspaceDataFilterSetting" | "userDataFilter" | "notificationChannel" | "memoryItem" | "parameter" | "reportPageLayout" | "reportTemplate" | "report";
 
 /**
  * Model object reference.
@@ -17963,6 +18618,88 @@ export declare type RemotePluggableApplicationRegistryItem = IRemotePluggableApp
  */
 export declare type RemotePluggableApplicationsRegistry = IRemotePluggableApplicationsRegistryV1;
 
+/**
+ * Variables resolved by the rendering runtime; they are never declared or stored.
+ *
+ * @remarks
+ * Referenced from report text as `{{name}}`. Custom variable names must not collide with these;
+ * on collision the built-in wins.
+ *
+ * @alpha
+ */
+export declare type ReportBuiltInVariable = "reportTitle" | "periodStart" | "periodEnd" | "workspaceName" | "generatedAt" | "pageNumber" | "totalPages" | "logo";
+
+/**
+ * All built-in report variable names.
+ *
+ * @alpha
+ */
+export declare const ReportBuiltInVariables: ReportBuiltInVariable[];
+
+/**
+ * Convenience accessor for a report or template page by its localIdentifier.
+ *
+ * @alpha
+ */
+export declare function reportContentPage(reportOrTemplate: IReport | IReportDefinition | IReportTemplate | IReportTemplateDefinition, pageLocalIdentifier: string): IReportContentPage | undefined;
+
+/**
+ * ISO 8601 calendar date (YYYY-MM-DD).
+ *
+ * @alpha
+ */
+export declare type ReportDateString = string;
+
+/**
+ * What an image slot displays.
+ *
+ * @alpha
+ */
+export declare type ReportImageSource = {
+    type: "url";
+    /**
+     * Image URL. Supports `{{variables}}` — a logo slot uses `{{logo}}`.
+     */
+    url: string;
+} | {
+    type: "asset";
+    /**
+     * Reference to a backend-managed asset.
+     */
+    ref: ObjRef;
+};
+
+/**
+ * Node of a report page layout: a recursive row/column split tree (flexbox semantics)
+ * over a fixed page. Leaves assign their area to slots; the tree carries only geometry,
+ * slot content lives in {@link IReportPageBody.slots}.
+ *
+ * @alpha
+ */
+export declare type ReportPageLayoutNode = IReportLayoutSection | IReportLayoutSlotRef;
+
+/**
+ * All slot types of report content version 1.
+ *
+ * @alpha
+ */
+export declare type ReportSlot = IReportVisualizationSlot | IReportTextSlot | IReportImageSlot;
+
+/**
+ * Semantic kind of a text slot. Drives default typography/styling and AI context only —
+ * never geometry (geometry always comes from the layout tree).
+ *
+ * @alpha
+ */
+export declare type ReportTextSlotKind = "title" | "subtitle" | "sectionTitle" | "description" | "summary" | "body" | "custom";
+
+/**
+ * Where the text of a text slot comes from.
+ *
+ * @alpha
+ */
+export declare type ReportTextSource = IReportStaticTextSource | IReportAiTextSource;
+
 /**
  * Entitlements and their values that must be set for the pluggable application to be accessible for
  * the currently logged user.
@@ -17997,6 +18734,14 @@ export declare type RequiredSettings = Condition<Partial<IPermanentSettings | IF
  */
 export declare type RequiredWorkspacePermissions = Condition<Partial<IPluggableApplicationWorkspacePermissions>>;
 
+/**
+ * Replaces `{{variable}}` markers with values. Markers with no value are left as-is.
+ * Values are inserted verbatim — there is no recursive expansion.
+ *
+ * @alpha
+ */
+export declare function resolveReportTextPlaceholders(text: string, values: Record<string, string>): string;
+
 /**
  * Resolves a dashboard timezone value to a concrete IANA timezone ID: the {@link BROWSER_DETECTED}
  * sentinel resolves to the browser/runtime timezone, any other value is returned as-is.
@@ -18358,6 +19103,16 @@ export declare type UserDataFilterDefinition = IUserDataFilterDefinition | IUser
  */
 export declare function userFullName(user: IUser): string | undefined;
 
+/**
+ * Validates the structural invariants of a page body the type system cannot express:
+ * slot localIdentifiers are unique, layout weights are positive, every slot is placed
+ * by the layout, and every layout slotId resolves (unresolved ones are warnings —
+ * they render as empty areas).
+ *
+ * @alpha
+ */
+export declare function validateReportPageBody(body: IReportPageBody): IReportPageBodyValidationIssue[];
+
 /**
  * Builder for virtual arithmetic measures.
  *