@gooddata/sdk-code-convertors 11.59.0-alpha.0 → 11.59.0-alpha.2

package/esm/sdk-code-convertors.d.ts

@@ -27,6 +27,8 @@ import { DeclarativeLabel } from '@gooddata/api-client-tiger';
 import { DeclarativeMetric } from '@gooddata/api-client-tiger';
 import { DeclarativeParameter } from '@gooddata/api-client-tiger';
 import { DeclarativeReference } from '@gooddata/api-client-tiger';
+import { DeclarativeReport } from '@gooddata/api-client-tiger';
+import { DeclarativeReportPageLayout } from '@gooddata/api-client-tiger';
 import { DeclarativeTable } from '@gooddata/api-client-tiger';
 import { DeclarativeVisualizationObject } from '@gooddata/api-client-tiger';
 import type { Fields } from '@gooddata/sdk-code-schemas/v1';
@@ -70,6 +72,12 @@ import { IPositiveAttributeFilterBody } from '@gooddata/sdk-model';
 import { IPreviousPeriodMeasureDefinition } from '@gooddata/sdk-model';
 import { IRankingFilterBody } from '@gooddata/sdk-model';
 import { IRelativeDateFilter } from '@gooddata/sdk-model';
+import { IReportContentPage } from '@gooddata/sdk-model';
+import { IReportDefinition } from '@gooddata/sdk-model';
+import { IReportPageLayout } from '@gooddata/sdk-model';
+import { IReportPageLayoutDefinition } from '@gooddata/sdk-model';
+import { IReportTemplate } from '@gooddata/sdk-model';
+import { IReportTemplateDefinition } from '@gooddata/sdk-model';
 import { ISortItem } from '@gooddata/sdk-model';
 import { ITotal } from '@gooddata/sdk-model';
 import { JsonApiVisualizationObjectOut } from '@gooddata/api-client-tiger';
@@ -87,6 +95,10 @@ import type { PoPMetricField } from '@gooddata/sdk-code-schemas/v1';
 import type { PreviousPeriodMetricField } from '@gooddata/sdk-code-schemas/v1';
 import type { Query } from '@gooddata/sdk-code-schemas/v1';
 import type { QueryFilters } from '@gooddata/sdk-code-schemas/v1';
+import type { Report as Report_2 } from '@gooddata/sdk-code-schemas/v1';
+import type { ReportPageBody } from '@gooddata/sdk-code-schemas/v1';
+import type { ReportPageLayout } from '@gooddata/sdk-code-schemas/v1';
+import type { ReportTemplate } from '@gooddata/sdk-code-schemas/v1';
 import type { RichTextWidget } from '@gooddata/sdk-code-schemas/v1';
 import { Scalar } from 'yaml';
 import type { Section } from '@gooddata/sdk-code-schemas/v1';
@@ -137,6 +149,15 @@ export declare type AacPlugin = Plugin_2;
 /** @public */
 export declare type AacQuery = Query;
 
+/** @alpha */
+export declare type AacReport = Report_2;
+
+/** @alpha */
+export declare type AacReportPageLayout = ReportPageLayout;
+
+/** @alpha */
+export declare type AacReportTemplate = ReportTemplate;
+
 /** @public */
 export declare type AacSection = Section;
 
@@ -1474,6 +1495,18 @@ export declare function declarativeRelativeDateFilterToYaml(relativeDateFilter:
     carried: WrittenFilter[];
 };
 
+/** @alpha */
+export declare function declarativeReportPageLayoutToYaml(layout: DeclarativeReportPageLayout): {
+    content: string;
+    json: ReportPageLayout;
+};
+
+/** @alpha */
+export declare function declarativeReportToYaml(report: DeclarativeReport): {
+    content: string;
+    json: Report_2;
+};
+
 /** @internal */
 export declare function declarativeSectionsToYaml(layout?: IDashboardLayout, entities?: FromEntities, errorContext?: IErrorContext): YAMLSeq<unknown> | undefined;
 
@@ -3464,6 +3497,41 @@ export declare function repeaterChartSave(fields: Visualisation["query"]["fields
     } | undefined;
 } | undefined;
 
+/**
+ * The same report, written from what the frontend holds: the object reference it is identified by
+ * becomes the bare id a document names it with.
+ *
+ * @alpha
+ */
+export declare function reportDefinitionToYaml(report: IReportDefinition): {
+    content: string;
+    json: Report_2;
+};
+
+/**
+ * A reusable page. Its body is written at the top level, because the object it is already names it -
+ * a page written into a report names itself instead.
+ *
+ * @alpha
+ */
+export declare function reportPageLayoutDefinitionToYaml(layout: IReportPageLayout | IReportPageLayoutDefinition): {
+    content: string;
+    json: ReportPageLayout;
+};
+
+/**
+ * One page of a report or a template, as a document writes it down.
+ *
+ * @internal
+ */
+export declare function reportPageToAacPage(page: IReportContentPage): ReportPageBody;
+
+/** @alpha */
+export declare function reportTemplateDefinitionToYaml(template: IReportTemplate | IReportTemplateDefinition): {
+    content: string;
+    json: ReportTemplate;
+};
+
 /** @public */
 export declare function resolveIdFromFileName(fileName: FilePath): string;
 
@@ -4356,6 +4424,23 @@ export declare type YamlPostProcessors = {
     }>;
 };
 
+/**
+ * Named for the document it reads, because a visualisation's query convertor already owns the
+ * shorter name.
+ *
+ * @alpha
+ */
+export declare function yamlReportDocumentToDeclarative(input: Report_2, errorContext?: IErrorContext): DeclarativeReport;
+
+/** @alpha */
+export declare function yamlReportPageLayoutToDeclarative(input: ReportPageLayout, errorContext?: IErrorContext): DeclarativeReportPageLayout;
+
+/** @alpha */
+export declare function yamlReportPageLayoutToDefinition(input: ReportPageLayout, errorContext?: IErrorContext): IReportPageLayoutDefinition;
+
+/** @alpha */
+export declare function yamlReportTemplateToDefinition(input: ReportTemplate, errorContext?: IErrorContext): IReportTemplateDefinition;
+
 /** @internal */
 export declare function yamlReportToDeclarative(entities: ExportEntities, input: Visualisation): {
     buckets: VisualisationDefinition["buckets"];
@@ -4368,6 +4453,14 @@ export declare function yamlReportToDeclarative(entities: ExportEntities, input:
     attributeFilterConfigs?: IAttributeFilterConfigs;
 };
 
+/**
+ * The same report, as the frontend holds it: an object reference in place of the bare id the
+ * document names it by.
+ *
+ * @alpha
+ */
+export declare function yamlReportToDefinition(input: Report_2, errorContext?: IErrorContext): IReportDefinition;
+
 /** @internal */
 export declare function yamlReportTotalToDeclarative(totals: Total[] | undefined, attributeIdentifier: string): ITotal[];
 

package/esm/to/yamlDashboardToDeclarative.d.ts

@@ -1,6 +1,6 @@
 import { type DeclarativeAnalyticalDashboard, type DeclarativeFilterContext } from "@gooddata/api-client-tiger";
 import type { ContainerWidget, Dashboard, DashboardFilters, Interaction, RichTextWidget, VisualisationWidget, VisualizationSwitcherWidget, Widget } from "@gooddata/sdk-code-schemas/v1";
-import { type IDashboardAttributeFilterConfig, type IDashboardDateFilter, type IDashboardDateFilterConfig, type IDashboardDateFilterConfigItem, type IDashboardFilterGroupsConfig, type IDashboardMeasureValueFilterConfig, type IDashboardPluginLink, type IDrillToAttributeUrl, type IDrillToCustomUrl, type IDrillToDashboard, type IDrillToInsight, type IFilterContextDefinition } from "@gooddata/sdk-model";
+import { type IDashboardAttributeFilterConfig, type IDashboardDateFilter, type IDashboardDateFilterConfig, type IDashboardDateFilterConfigItem, type IDashboardFilterGroupsConfig, type IDashboardFilterReference, type IDashboardMeasureValueFilterConfig, type IDashboardPluginLink, type IDrillToAttributeUrl, type IDrillToCustomUrl, type IDrillToDashboard, type IDrillToInsight, type IFilterContextDefinition } from "@gooddata/sdk-model";
 import { type OverrideDashboardDefinition } from "../from/declarativeDashboardToYaml.js";
 import { type ExportEntities } from "../types.js";
 /** @internal */
@@ -30,6 +30,8 @@ export declare function yamlWidgetToDeclarative(entities: ExportEntities, input:
 /** @internal */
 export declare function yamlInteractionToDeclarative(entities: ExportEntities, visualisation: string, input: Interaction): IDrillToInsight | IDrillToDashboard | IDrillToCustomUrl | IDrillToAttributeUrl | null;
 /** @internal */
+export declare function yamlIgnoredFilterToDeclarative(input: string): IDashboardFilterReference | null;
+/** @internal */
 export declare function yamlPluginsToDeclarative(plugins: Dashboard["plugins"]): IDashboardPluginLink[] | undefined;
 /** @internal */
 export declare function yamlFilterContextToDeclarative(baseId: string, yamlFilters: DashboardFilters | undefined): {

package/esm/to/yamlDashboardToDeclarative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yamlDashboardToDeclarative.d.ts","sourceRoot":"","sources":["../../src/to/yamlDashboardToDeclarative.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yamlDashboardToDeclarative.d.ts","sourceRoot":"","sources":["../../src/to/yamlDashboardToDeclarative.ts"],"names":[],"mappings":"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"}

package/esm/to/yamlDashboardToDeclarative.js

@@ -568,7 +568,8 @@ function sourceInsightFilterIdToDeclarative(filterId, sourceVisualizationFilters
     }
     return null;
 }
-function yamlIgnoredFilterToDeclarative(input) {
+/** @internal */
+export function yamlIgnoredFilterToDeclarative(input) {
     const ref = parseReferenceObject(input);
     if (ref?.type === "label" || ref?.type === "computed_attribute") {
         return {

package/esm/to/yamlReportPageToDeclarative.d.ts

@@ -0,0 +1,25 @@
+import type { DashboardFilters, ReportPageBody } from "@gooddata/sdk-code-schemas/v1";
+import { type FilterContextItem, type IReportContentPage, type IReportPageBody } from "@gooddata/sdk-model";
+import { type IErrorContext } from "../utils/errors.js";
+/**
+ * A report holds its filters the way a dashboard's filter context does, so they are written and read
+ * back by the same convertor; only the envelope it expects is put around them here.
+ *
+ * @internal
+ */
+export declare function filtersToDeclarative(filters: DashboardFilters | undefined): FilterContextItem[] | undefined;
+/**
+ * Raises a page written as one tree back into the two halves it is stored as: the geometry, and the
+ * flat list of slots it and the boxes painted with an image point at.
+ *
+ * @internal
+ */
+export declare function yamlReportPageToDeclarative(body: ReportPageBody, errorContext?: IErrorContext): IReportContentPage;
+/**
+ * The body of a page, without the identity of whatever holds it: a page written into a report names
+ * itself, a reusable one is named by the object it is.
+ *
+ * @internal
+ */
+export declare function yamlReportPageBodyToDeclarative(body: ReportPageBody, errorContext?: IErrorContext): IReportPageBody;
+//# sourceMappingURL=yamlReportPageToDeclarative.d.ts.map

package/esm/to/yamlReportPageToDeclarative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yamlReportPageToDeclarative.d.ts","sourceRoot":"","sources":["../../src/to/yamlReportPageToDeclarative.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,gBAAgB,EAKhB,cAAc,EAIjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,KAAK,iBAAiB,EAItB,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EAQvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAiB,KAAK,aAAa,EAAgC,MAAM,oBAAoB,CAAC;AAQrG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAS3G;AAoND;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,cAAc,EACpB,YAAY,CAAC,EAAE,aAAa,GAC7B,kBAAkB,CAEpB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC3C,IAAI,EAAE,cAAc,EACpB,YAAY,CAAC,EAAE,aAAa,GAC7B,eAAe,CAcjB"}

package/esm/to/yamlReportPageToDeclarative.js

@@ -0,0 +1,215 @@
+// (C) 2026 GoodData Corporation
+import { idRef, } from "@gooddata/sdk-model";
+import { CoreErrorCode, newError, updateErrorContext } from "../utils/errors.js";
+import { referencesAsStored } from "../utils/reportFilterRefs.js";
+import { yamlFilterContextToDeclarative, yamlIgnoredFilterToDeclarative, } from "./yamlDashboardToDeclarative.js";
+/**
+ * A report holds its filters the way a dashboard's filter context does, so they are written and read
+ * back by the same convertor; only the envelope it expects is put around them here.
+ *
+ * @internal
+ */
+export function filtersToDeclarative(filters) {
+    if (filters === undefined) {
+        return undefined;
+    }
+    // The filter context the shared convertor builds around them is thrown away, so what it is
+    // named does not matter; only the filters inside it are what a report stores.
+    const { filterContext } = yamlFilterContextToDeclarative("report", filters);
+    const content = filterContext.content;
+    return content?.filters?.length ? referencesAsStored(content.filters) : undefined;
+}
+function placeholderToDeclarative(placeholder) {
+    if (placeholder === undefined) {
+        return undefined;
+    }
+    if (typeof placeholder === "boolean") {
+        return { required: placeholder };
+    }
+    if (typeof placeholder === "string") {
+        return { hint: placeholder };
+    }
+    return placeholder;
+}
+function textToDeclarative(text) {
+    if (typeof text === "string") {
+        // A slot written with no text has none, rather than text that happens to be empty: the key
+        // is there because it is what says which kind of slot this is.
+        return text === "" ? undefined : { type: "static", content: text };
+    }
+    if (text.prompt !== undefined) {
+        return {
+            type: "ai",
+            prompt: text.prompt,
+            ...(text.text === undefined ? {} : { content: text.text }),
+            ...(text.generated_at === undefined ? {} : { generatedAt: text.generated_at }),
+        };
+    }
+    // A mapping with neither a prompt nor any text states a slot that is declared but unwritten.
+    return text.text === undefined ? undefined : { type: "static", content: text.text };
+}
+function textStyleToDeclarative(style, page) {
+    if (style === undefined) {
+        return undefined;
+    }
+    if (typeof style === "string") {
+        return { type: style };
+    }
+    const { horizontal_align, vertical_align, border_radius, background, ...rest } = style;
+    return {
+        ...rest,
+        ...(horizontal_align === undefined ? {} : { horizontalAlign: horizontal_align }),
+        ...(vertical_align === undefined ? {} : { verticalAlign: vertical_align }),
+        ...(border_radius === undefined ? {} : { borderRadius: border_radius }),
+        ...(background === undefined ? {} : { background: backgroundToDeclarative(background, page) }),
+    };
+}
+/** The content of an image, without the identity of whatever draws it. */
+function imageContentToDeclarative(image) {
+    if (typeof image === "string") {
+        return { type: "image", source: { type: "url", url: image } };
+    }
+    const { url, asset, alt_text, fit, style, placeholder } = image;
+    const declaredPlaceholder = placeholderToDeclarative(placeholder);
+    return {
+        type: "image",
+        ...(url === undefined ? {} : { source: { type: "url", url } }),
+        ...(asset === undefined ? {} : { source: { type: "asset", ref: idRef(asset) } }),
+        ...(alt_text === undefined ? {} : { altText: alt_text }),
+        ...(fit === undefined ? {} : { fit: fit }),
+        ...(style === undefined
+            ? {}
+            : {
+                style: {
+                    ...(style.horizontal_align === undefined
+                        ? {}
+                        : { horizontalAlign: style.horizontal_align }),
+                    ...(style.vertical_align === undefined ? {} : { verticalAlign: style.vertical_align }),
+                },
+            }),
+        ...(declaredPlaceholder === undefined ? {} : { placeholder: declaredPlaceholder }),
+    };
+}
+/**
+ * A backdrop is drawn from a slot of its own. Writing the image down adds that slot to the page;
+ * naming one written down elsewhere - under another box, or by the leaf that places it - only
+ * points at it again.
+ */
+function backgroundImageToDeclarative(image, page) {
+    if ("ref" in image) {
+        return image.ref;
+    }
+    const { id, ...content } = image;
+    page.slots.push({ ...imageContentToDeclarative(content), localIdentifier: id });
+    return id;
+}
+function backgroundToDeclarative(background, page) {
+    if (typeof background === "string") {
+        return { type: "color", color: background };
+    }
+    return { type: "image", slotId: backgroundImageToDeclarative(background.image, page) };
+}
+function boxStyleToDeclarative(style, page) {
+    if (style === undefined) {
+        return undefined;
+    }
+    const { background, border_radius, padding } = style;
+    return {
+        ...(background === undefined ? {} : { background: backgroundToDeclarative(background, page) }),
+        ...(border_radius === undefined ? {} : { borderRadius: border_radius }),
+        ...(padding === undefined ? {} : { padding }),
+    };
+}
+/** A node that draws content becomes a slot of its own and a reference to it in the tree. */
+function layoutNodeToDeclarative(node, page, errorContext) {
+    const weight = "weight" in node && node.weight !== undefined ? { weight: node.weight } : {};
+    if ("column" in node || "row" in node) {
+        const direction = "column" in node ? "column" : "row";
+        const children = ("column" in node ? node.column : node.row) ?? [];
+        return {
+            type: "section",
+            direction,
+            children: children.map((child) => layoutNodeToDeclarative(child, page, errorContext)),
+            ...weight,
+            ...(node.style === undefined ? {} : { style: boxStyleToDeclarative(node.style, page) }),
+        };
+    }
+    page.slots.push(slotToDeclarative(node, page, errorContext));
+    return { type: "slotRef", slotId: node.id, ...weight };
+}
+function slotToDeclarative(node, page, errorContext) {
+    const placeholder = placeholderToDeclarative("placeholder" in node ? node.placeholder : undefined);
+    const shared = {
+        localIdentifier: node.id,
+        ...(placeholder === undefined ? {} : { placeholder }),
+    };
+    if ("visualization" in node) {
+        const { visualization, title, show_title, properties, date, ignore_report_period, filters } = node;
+        const declaredFilters = filtersToDeclarative(filters);
+        const ignoredFilters = (node.ignored_filters ?? [])
+            .map((filterId) => yamlIgnoredFilterToDeclarative(filterId))
+            .filter(Boolean)
+            .map((reference) => referencesAsStored(reference));
+        return {
+            ...shared,
+            type: "visualization",
+            ...(visualization === null || visualization === undefined
+                ? {}
+                : { insight: idRef(visualization, "insight") }),
+            // A title of false hides it and states no text; a title kept but not drawn says so in full.
+            ...(title === false ? { showTitle: false } : title === undefined ? {} : { title }),
+            ...(show_title === undefined ? {} : { showTitle: show_title }),
+            ...(properties === undefined ? {} : { properties }),
+            ...(date === undefined ? {} : { dateDataSet: idRef(date, "dataSet") }),
+            ...(ignore_report_period === undefined ? {} : { ignoreReportPeriod: ignore_report_period }),
+            ...(declaredFilters === undefined ? {} : { filters: declaredFilters }),
+            ...(ignoredFilters.length === 0 ? {} : { ignoredFilters }),
+        };
+    }
+    if ("heading" in node || "paragraph" in node) {
+        const isHeading = "heading" in node;
+        const source = textToDeclarative(isHeading ? node.heading : node.paragraph);
+        return {
+            ...shared,
+            type: isHeading ? "heading" : "paragraph",
+            ...(source === undefined ? {} : { source }),
+            ...(node.style === undefined ? {} : { style: textStyleToDeclarative(node.style, page) }),
+        };
+    }
+    if (!("image" in node)) {
+        // A node says what it draws by the key it carries, so one carrying none of them draws
+        // nothing - far more often a key spelled wrong than an area anyone meant to write.
+        throw newError(CoreErrorCode.ItemNotSupported, [JSON.stringify({ id: shared.localIdentifier, keys: Object.keys(node) })], updateErrorContext(errorContext, { path: ["layout", shared.localIdentifier] }));
+    }
+    const image = imageContentToDeclarative(node.image);
+    return { ...image, ...shared };
+}
+/**
+ * Raises a page written as one tree back into the two halves it is stored as: the geometry, and the
+ * flat list of slots it and the boxes painted with an image point at.
+ *
+ * @internal
+ */
+export function yamlReportPageToDeclarative(body, errorContext) {
+    return { localIdentifier: body.id, ...yamlReportPageBodyToDeclarative(body, errorContext) };
+}
+/**
+ * The body of a page, without the identity of whatever holds it: a page written into a report names
+ * itself, a reusable one is named by the object it is.
+ *
+ * @internal
+ */
+export function yamlReportPageBodyToDeclarative(body, errorContext) {
+    const page = { slots: [] };
+    const style = boxStyleToDeclarative(body.style, page);
+    const layout = layoutNodeToDeclarative(body.layout, page, errorContext);
+    const filters = filtersToDeclarative(body.filters);
+    return {
+        ...(body.kind === undefined ? {} : { kind: body.kind }),
+        ...(body.format === undefined ? {} : { format: body.format }),
+        ...(style === undefined ? {} : { style }),
+        layout,
+        slots: page.slots,
+        ...(filters === undefined ? {} : { filters }),
+    };
+}

package/esm/to/yamlReportToDeclarative.d.ts

@@ -0,0 +1,25 @@
+import { type DeclarativeReport, type DeclarativeReportPageLayout } from "@gooddata/api-client-tiger";
+import type { Report, ReportPageLayout, ReportTemplate } from "@gooddata/sdk-code-schemas/v1";
+import { type IReportDefinition, type IReportPageLayoutDefinition, type IReportTemplateDefinition } from "@gooddata/sdk-model";
+import { type IErrorContext } from "../utils/errors.js";
+/**
+ * Named for the document it reads, because a visualisation's query convertor already owns the
+ * shorter name.
+ *
+ * @alpha
+ */
+export declare function yamlReportDocumentToDeclarative(input: Report, errorContext?: IErrorContext): DeclarativeReport;
+/**
+ * The same report, as the frontend holds it: an object reference in place of the bare id the
+ * document names it by.
+ *
+ * @alpha
+ */
+export declare function yamlReportToDefinition(input: Report, errorContext?: IErrorContext): IReportDefinition;
+/** @alpha */
+export declare function yamlReportTemplateToDefinition(input: ReportTemplate, errorContext?: IErrorContext): IReportTemplateDefinition;
+/** @alpha */
+export declare function yamlReportPageLayoutToDefinition(input: ReportPageLayout, errorContext?: IErrorContext): IReportPageLayoutDefinition;
+/** @alpha */
+export declare function yamlReportPageLayoutToDeclarative(input: ReportPageLayout, errorContext?: IErrorContext): DeclarativeReportPageLayout;
+//# sourceMappingURL=yamlReportToDeclarative.d.ts.map

package/esm/to/yamlReportToDeclarative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yamlReportToDeclarative.d.ts","sourceRoot":"","sources":["../../src/to/yamlReportToDeclarative.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EACR,MAAM,EAEN,gBAAgB,EAChB,cAAc,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEH,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAIjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAuCxD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC3C,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,aAAa,GAC7B,iBAAiB,CAWnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAYrG;AAED,aAAa;AACb,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,cAAc,EACrB,YAAY,CAAC,EAAE,aAAa,GAC7B,yBAAyB,CAS3B;AAED,aAAa;AACb,wBAAgB,gCAAgC,CAC5C,KAAK,EAAE,gBAAgB,EACvB,YAAY,CAAC,EAAE,aAAa,GAC7B,2BAA2B,CAY7B;AAED,aAAa;AACb,wBAAgB,iCAAiC,CAC7C,KAAK,EAAE,gBAAgB,EACvB,YAAY,CAAC,EAAE,aAAa,GAC7B,2BAA2B,CAW7B"}

package/esm/to/yamlReportToDeclarative.js

@@ -0,0 +1,99 @@
+// (C) 2026 GoodData Corporation
+import { idRef, } from "@gooddata/sdk-model";
+import { convertIdToTitle } from "../utils/sharedUtils.js";
+import { filtersToDeclarative, yamlReportPageBodyToDeclarative, yamlReportPageToDeclarative, } from "./yamlReportPageToDeclarative.js";
+function variablesToDeclarative(variables) {
+    return variables?.map((variable) => ({
+        name: variable.name,
+        ...(variable.title === undefined ? {} : { title: variable.title }),
+        ...(variable.description === undefined ? {} : { description: variable.description }),
+        ...(variable.default === undefined ? {} : { defaultValue: variable.default }),
+    }));
+}
+function contentToDeclarative(pages, filters, variables, errorContext) {
+    // The stored content states its own version; a document states the schema's instead, so the
+    // convertor is what knows which shape it just wrote.
+    const declared = filtersToDeclarative(filters);
+    const declaredVariables = variablesToDeclarative(variables);
+    return {
+        version: "1",
+        pages: pages?.map((body) => yamlReportPageToDeclarative(body, errorContext)) ?? [],
+        ...(declared === undefined ? {} : { filters: declared }),
+        ...(declaredVariables === undefined ? {} : { variables: declaredVariables }),
+    };
+}
+/**
+ * Named for the document it reads, because a visualisation's query convertor already owns the
+ * shorter name.
+ *
+ * @alpha
+ */
+export function yamlReportDocumentToDeclarative(input, errorContext) {
+    return {
+        id: input.id,
+        title: input.title ?? convertIdToTitle(input.id ?? ""),
+        description: input.description ?? "",
+        tags: input.tags ?? [],
+        periodStart: input.period.start,
+        periodEnd: input.period.end,
+        ...(input.variable_values === undefined ? {} : { variableValues: input.variable_values }),
+        content: contentToDeclarative(input.pages, input.filters, input.variables, errorContext),
+    };
+}
+/**
+ * The same report, as the frontend holds it: an object reference in place of the bare id the
+ * document names it by.
+ *
+ * @alpha
+ */
+export function yamlReportToDefinition(input, errorContext) {
+    return {
+        type: "report",
+        ...(input.id === undefined ? {} : { ref: idRef(input.id) }),
+        title: input.title ?? convertIdToTitle(input.id ?? ""),
+        ...(input.description === undefined ? {} : { description: input.description }),
+        ...(input.tags === undefined ? {} : { tags: input.tags }),
+        periodStart: input.period.start,
+        periodEnd: input.period.end,
+        ...(input.variable_values === undefined ? {} : { variableValues: input.variable_values }),
+        content: contentToDeclarative(input.pages, input.filters, input.variables, errorContext),
+    };
+}
+/** @alpha */
+export function yamlReportTemplateToDefinition(input, errorContext) {
+    return {
+        type: "reportTemplate",
+        ...(input.id === undefined ? {} : { ref: idRef(input.id) }),
+        title: input.title ?? convertIdToTitle(input.id ?? ""),
+        ...(input.description === undefined ? {} : { description: input.description }),
+        ...(input.tags === undefined ? {} : { tags: input.tags }),
+        content: contentToDeclarative(input.pages, input.filters, input.variables, errorContext),
+    };
+}
+/** @alpha */
+export function yamlReportPageLayoutToDefinition(input, errorContext) {
+    return {
+        type: "reportPageLayout",
+        ...(input.id === undefined ? {} : { ref: idRef(input.id) }),
+        title: input.title ?? convertIdToTitle(input.id ?? ""),
+        ...(input.description === undefined ? {} : { description: input.description }),
+        ...(input.tags === undefined ? {} : { tags: input.tags }),
+        content: {
+            version: "1",
+            ...yamlReportPageBodyToDeclarative(input, errorContext),
+        },
+    };
+}
+/** @alpha */
+export function yamlReportPageLayoutToDeclarative(input, errorContext) {
+    return {
+        id: input.id,
+        title: input.title ?? convertIdToTitle(input.id ?? ""),
+        description: input.description ?? "",
+        tags: input.tags ?? [],
+        content: {
+            version: "1",
+            ...yamlReportPageBodyToDeclarative(input, errorContext),
+        },
+    };
+}

package/esm/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.12"
+      "packageVersion": "7.59.2"
     }
   ]
 }

package/esm/utils/reportFilterRefs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Every reference the value holds, named the way the document names the object.
+ *
+ * @internal
+ */
+export declare function referencesAsWritten<T>(value: T): T;
+/**
+ * Every reference the value holds, back in the shape and under the type the model stores.
+ *
+ * @internal
+ */
+export declare function referencesAsStored<T>(value: T): T;
+//# sourceMappingURL=reportFilterRefs.d.ts.map

package/esm/utils/reportFilterRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportFilterRefs.d.ts","sourceRoot":"","sources":["../../src/utils/reportFilterRefs.ts"],"names":[],"mappings":"AAoDA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQjD"}

package/esm/utils/reportFilterRefs.js

@@ -0,0 +1,69 @@
+// (C) 2026 GoodData Corporation
+/**
+ * A report stores its filters as the model holds them, while the convertor that writes and reads
+ * them is the dashboard's, which works on what the declarative API sends. The two agree on every
+ * field but one: how an object is referenced. The model names it by a type of its own and carries
+ * the id beside it, the API nests the two and names the object as the document's prefixes do.
+ *
+ * Only the references are translated, so a field added to either shape needs nothing here.
+ */
+const documentTypeOfModelType = {
+    displayForm: "label",
+    dataSet: "dataset",
+    measure: "metric",
+};
+const modelTypeOfDocumentType = {
+    label: "displayForm",
+    dataset: "dataSet",
+    metric: "measure",
+};
+/** A reference as the model holds it: the id beside the type. */
+function isModelReference(value) {
+    return typeof value.identifier === "string";
+}
+/** A reference as the declarative API sends it: the id and the type nested under the identifier. */
+function isApiReference(value) {
+    const { identifier } = value;
+    return typeof identifier === "object" && identifier !== null && typeof identifier.id === "string";
+}
+function translate(value, reference) {
+    if (Array.isArray(value)) {
+        return value.map((item) => translate(item, reference));
+    }
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const translated = reference(value);
+    if (translated !== undefined) {
+        return translated;
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, translate(item, reference)]));
+}
+/**
+ * Every reference the value holds, named the way the document names the object.
+ *
+ * @internal
+ */
+export function referencesAsWritten(value) {
+    return translate(value, (node) => {
+        if (!isModelReference(node)) {
+            return undefined;
+        }
+        const type = node.type === undefined ? undefined : documentTypeOfModelType[node.type];
+        return type === undefined ? undefined : { ...node, type };
+    });
+}
+/**
+ * Every reference the value holds, back in the shape and under the type the model stores.
+ *
+ * @internal
+ */
+export function referencesAsStored(value) {
+    return translate(value, (node) => {
+        if (!isApiReference(node)) {
+            return undefined;
+        }
+        const { id, type } = node.identifier;
+        return { identifier: id, type: modelTypeOfDocumentType[type] ?? type };
+    });
+}