@gooddata/sdk-code-convertors 11.63.0-alpha.1 → 11.63.0-alpha.2

package/esm/declarativePublisherTypesV2.d.ts

@@ -0,0 +1,27 @@
+import { type IPublisherDocumentDefinitionV2, type IPublisherDocumentTemplateDefinitionV2, type IPublisherPageTemplateDefinitionV2 } from "@gooddata/sdk-model";
+/**
+ * A document as the declarative API stores it: the model's definition named by a bare id.
+ *
+ * @alpha
+ */
+export type DeclarativePublisherDocumentV2 = Omit<IPublisherDocumentDefinitionV2, "ref"> & {
+    id: string;
+};
+/**
+ * A document template as the declarative API stores it.
+ *
+ * @alpha
+ */
+export type DeclarativePublisherDocumentTemplateV2 = Omit<IPublisherDocumentTemplateDefinitionV2, "ref"> & {
+    id: string;
+};
+/**
+ * A page template as the declarative API stores it. The backend's default page templates are not
+ * part of the declarative layout.
+ *
+ * @alpha
+ */
+export type DeclarativePublisherPageTemplateV2 = Omit<IPublisherPageTemplateDefinitionV2, "ref"> & {
+    id: string;
+};
+//# sourceMappingURL=declarativePublisherTypesV2.d.ts.map

package/esm/declarativePublisherTypesV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarativePublisherTypesV2.d.ts","sourceRoot":"","sources":["../src/declarativePublisherTypesV2.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,8BAA8B,EACnC,KAAK,sCAAsC,EAC3C,KAAK,kCAAkC,EAC1C,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,8BAA8B,EAAE,KAAK,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1G;;;;GAIG;AACH,MAAM,MAAM,sCAAsC,GAAG,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,GAAG;IACvG,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kCAAkC,GAAG,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,GAAG;IAC/F,EAAE,EAAE,MAAM,CAAC;CACd,CAAC"}

package/esm/declarativePublisherTypesV2.js

@@ -0,0 +1,2 @@
+// (C) 2026 GoodData Corporation
+export {};

package/esm/fillPublisherIdsV2.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Adds the section, page and widget ids a v2 document, document template or page template as code
+ * leaves out, so the YAML written by hand states the ids the stored entity keeps. An id counts as
+ * missing when it is absent, null or empty. Comments and the indent width survive, the line break of
+ * the first line is applied to the whole file, and the sequence style survives too, except that
+ * unindented sequences are kept only at a 2-space indent and the compact `-   ` style is not kept.
+ * Block scalars take the indent width of the maps. Content that needs no id, or does not parse,
+ * comes back unchanged.
+ *
+ * @alpha
+ */
+export declare function fillPublisherIdsV2(content: string): {
+    content: string;
+    changed: boolean;
+};
+//# sourceMappingURL=fillPublisherIdsV2.d.ts.map

package/esm/fillPublisherIdsV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillPublisherIdsV2.d.ts","sourceRoot":"","sources":["../src/fillPublisherIdsV2.ts"],"names":[],"mappings":"AA+JA;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAezF"}

package/esm/fillPublisherIdsV2.js

@@ -0,0 +1,149 @@
+// (C) 2026 GoodData Corporation
+import { LineCounter, Pair, Scalar, isMap, isScalar, isSeq, parseDocument, visit, } from "yaml";
+import { newPublisherPageIdV2, newPublisherSectionIdV2, newPublisherWidgetIdV2 } from "@gooddata/sdk-model";
+function isKey(pair, key) {
+    return isScalar(pair.key) ? pair.key.value === key : pair.key === key;
+}
+function isMissingId(node) {
+    const id = node.get("id");
+    return id === undefined || id === null || id === "";
+}
+function takenIds(nodes) {
+    return new Set(nodes.filter((node) => !isMissingId(node)).map((node) => String(node.get("id"))));
+}
+function drawId(generate, taken) {
+    let id = generate();
+    while (taken.has(id)) {
+        id = generate();
+    }
+    taken.add(id);
+    return id;
+}
+/** An `id` key already written keeps its place and its comment; a new one goes after `after`, or first. */
+function placeId(node, id, after) {
+    const written = node.items.find((item) => isKey(item, "id"));
+    if (written !== undefined && isScalar(written.value)) {
+        written.value.value = id;
+        written.value.type = Scalar.PLAIN;
+        return;
+    }
+    if (written !== undefined) {
+        written.value = new Scalar(id);
+        return;
+    }
+    const position = after === undefined ? 0 : node.items.findIndex((item) => isKey(item, after)) + 1;
+    node.items.splice(position, 0, new Pair(new Scalar("id"), new Scalar(id)));
+}
+function maps(value) {
+    return isSeq(value) ? value.items.filter((item) => isMap(item)) : [];
+}
+function layoutNodes(node) {
+    if (!isMap(node)) {
+        return [];
+    }
+    const type = node.get("type");
+    return type === "row" || type === "column" ? maps(node.get("children")).flatMap(layoutNodes) : [node];
+}
+function fillMissing(nodes, { generate, taken, after }) {
+    const missing = nodes.filter(isMissingId);
+    for (const node of missing) {
+        placeId(node, drawId(generate, taken), after);
+    }
+    return missing.length > 0;
+}
+function fillWidgetIds(layout) {
+    const widgets = layoutNodes(layout);
+    return fillMissing(widgets, {
+        generate: newPublisherWidgetIdV2,
+        taken: takenIds(widgets),
+        after: "type",
+    });
+}
+function fillContentIds(type, content) {
+    if (!isMap(content)) {
+        return false;
+    }
+    if (type === "page_template") {
+        return fillWidgetIds(content.get("layout"));
+    }
+    if (type !== "document" && type !== "document_template") {
+        return false;
+    }
+    const sections = maps(content.get("sections"));
+    const pages = [
+        ...maps(content.get("pages")),
+        ...sections.flatMap((section) => maps(section.get("pages"))),
+    ];
+    const taken = takenIds([...sections, ...pages]);
+    const filledSections = fillMissing(sections, { generate: newPublisherSectionIdV2, taken });
+    const filledPages = fillMissing(pages, { generate: newPublisherPageIdV2, taken });
+    const filledWidgets = pages.map((page) => fillWidgetIds(page.get("layout"))).some(Boolean);
+    return filledSections || filledPages || filledWidgets;
+}
+/** The indent width the source uses: how far a block map's keys sit right of their parent key. */
+function indentOf(document, lineCounter) {
+    let indent;
+    visit(document, {
+        Pair(_, pair) {
+            const [first] = isMap(pair.value) && !pair.value.flow ? pair.value.items : [];
+            if (indent === undefined &&
+                isScalar(pair.key) &&
+                pair.key.range &&
+                isScalar(first?.key) &&
+                first.key.range) {
+                indent =
+                    lineCounter.linePos(first.key.range[0]).col - lineCounter.linePos(pair.key.range[0]).col;
+            }
+        },
+    });
+    return indent !== undefined && indent > 0 ? indent : 2;
+}
+/** True when block sequence items are written at their parent key's column (`key:` then `- item`). */
+function hasUnindentedSequences(document, lineCounter) {
+    let unindented = false;
+    visit(document, {
+        Pair(_, pair) {
+            if (isScalar(pair.key) &&
+                isSeq(pair.value) &&
+                !pair.value.flow &&
+                pair.key.range &&
+                pair.value.range) {
+                const keyColumn = lineCounter.linePos(pair.key.range[0]).col;
+                unindented ||= keyColumn === lineCounter.linePos(pair.value.range[0]).col;
+            }
+        },
+    });
+    return unindented;
+}
+/** The first line break decides which one the whole output uses. */
+function usesCrlf(content) {
+    const firstBreak = content.indexOf("\n");
+    return firstBreak > 0 && content[firstBreak - 1] === "\r";
+}
+/**
+ * Adds the section, page and widget ids a v2 document, document template or page template as code
+ * leaves out, so the YAML written by hand states the ids the stored entity keeps. An id counts as
+ * missing when it is absent, null or empty. Comments and the indent width survive, the line break of
+ * the first line is applied to the whole file, and the sequence style survives too, except that
+ * unindented sequences are kept only at a 2-space indent and the compact `-   ` style is not kept.
+ * Block scalars take the indent width of the maps. Content that needs no id, or does not parse,
+ * comes back unchanged.
+ *
+ * @alpha
+ */
+export function fillPublisherIdsV2(content) {
+    const lineCounter = new LineCounter();
+    const document = parseDocument(content, { lineCounter });
+    if (document.errors.length > 0 || !isMap(document.contents)) {
+        return { content, changed: false };
+    }
+    if (!fillContentIds(document.contents.get("type"), document.contents.get("content"))) {
+        return { content, changed: false };
+    }
+    const written = document.toString({
+        indent: indentOf(document, lineCounter),
+        indentSeq: !hasUnindentedSequences(document, lineCounter),
+        lineWidth: 0,
+    });
+    return { content: usesCrlf(content) ? written.replace(/\n/g, "\r\n") : written, changed: true };
+}

package/esm/from/declarativePublisherDocumentPageToYaml.d.ts

@@ -1,12 +1,5 @@
 import { YAMLMap } from "yaml";
-import { type FilterContextItem, type IPublisherDocumentPage, type IPublisherPageBody } from "@gooddata/sdk-model";
-/**
- * A document holds its filters the way a dashboard's filter context does, so the same convertor writes
- * them; only the envelope it expects is put around them here.
- *
- * @internal
- */
-export declare function filtersToYaml(filters: FilterContextItem[] | undefined): YAMLMap | undefined;
+import { type IPublisherDocumentPageV1, type IPublisherPageBodyV1 } from "@gooddata/sdk-model";
 /** @internal */
 export declare function mapOf(entries: Array<[string, unknown]>): YAMLMap;
 /**
@@ -19,7 +12,7 @@ export declare function mapOf(entries: Array<[string, unknown]>): YAMLMap;
  *
  * @internal
  */
-export declare function publisherPageBodyEntries(body: IPublisherPageBody): Array<[string, unknown]>;
+export declare function publisherPageBodyEntries(body: IPublisherPageBodyV1): Array<[string, unknown]>;
 /** @internal */
-export declare function declarativePublisherDocumentPageToYaml(body: IPublisherDocumentPage): YAMLMap;
+export declare function declarativePublisherDocumentPageToYaml(body: IPublisherDocumentPageV1): YAMLMap;
 //# sourceMappingURL=declarativePublisherDocumentPageToYaml.d.ts.map

package/esm/from/declarativePublisherDocumentPageToYaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declarativePublisherDocumentPageToYaml.d.ts","sourceRoot":"","sources":["../../src/from/declarativePublisherDocumentPageToYaml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAW,MAAM,MAAM,CAAC;AAG9C,OAAO,EACH,KAAK,iBAAiB,EAEtB,KAAK,sBAAsB,EAE3B,KAAK,kBAAkB,EAe1B,MAAM,qBAAqB,CAAC;AAQ7B;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAQ3F;AAoBD,gBAAgB;AAChB,wBAAgB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAMhE;AAyOD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmB3F;AAED,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAE5F"}
+{"version":3,"file":"declarativePublisherDocumentPageToYaml.d.ts","sourceRoot":"","sources":["../../src/from/declarativePublisherDocumentPageToYaml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAW,MAAM,MAAM,CAAC;AAE9C,OAAO,EAEH,KAAK,wBAAwB,EAE7B,KAAK,oBAAoB,EAe5B,MAAM,qBAAqB,CAAC;AAyB7B,gBAAgB;AAChB,wBAAgB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAMhE;AA8OD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmB7F;AAED,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAE9F"}

package/esm/from/declarativePublisherDocumentPageToYaml.js

@@ -1,25 +1,10 @@
 // (C) 2026 GoodData Corporation
 import { Pair, YAMLMap, YAMLSeq } from "yaml";
-import { dashboardFilterReferenceObjRef, isPublisherImageBackground, isPublisherImageSlot, isPublisherLayoutSection, isPublisherTextSlot, isPublisherVisualizationSlot, objRefToString, } from "@gooddata/sdk-model";
+import { dashboardFilterReferenceObjRef, isPublisherImageBackgroundV1, isPublisherImageSlotV1, isPublisherLayoutSectionV1, isPublisherTextSlotV1, isPublisherVisualizationSlotV1, objRefToString, } from "@gooddata/sdk-model";
 import { CoreErrorCode, newError } from "../utils/errors.js";
 import { referencesAsWritten } from "../utils/publisherFilterRefs.js";
+import { filtersToYaml } from "../utils/publisherFilters.js";
 import { getIdentifier } from "../utils/yamlUtils.js";
-import { declarativeFilterContextToYaml } from "./declarativeDashboardToYaml.js";
-/**
- * A document holds its filters the way a dashboard's filter context does, so the same convertor writes
- * them; only the envelope it expects is put around them here.
- *
- * @internal
- */
-export function filtersToYaml(filters) {
-    if (!filters?.length) {
-        return undefined;
-    }
-    const { filters: written } = declarativeFilterContextToYaml(undefined, {
-        content: { filters: referencesAsWritten(filters), version: "2" },
-    });
-    return emptyToUndefined(written);
-}
 /**
  * Collapses a mapping that says only one thing down to that thing, the way a bucket with nothing
  * but a `using` is written as the field it uses.
@@ -110,7 +95,7 @@ function imageContentToYaml(slot) {
     return shorten(map, ["url"]) ?? map;
 }
 function placedSlotIds(node, into) {
-    if (isPublisherLayoutSection(node)) {
+    if (isPublisherLayoutSectionV1(node)) {
         for (const child of node.children) {
             placedSlotIds(child, into);
         }
@@ -124,7 +109,7 @@ function backgroundToYaml(background, page) {
     if (background === undefined) {
         return undefined;
     }
-    if (!isPublisherImageBackground(background)) {
+    if (!isPublisherImageBackgroundV1(background)) {
         return background.color;
     }
     const { slotId } = background;
@@ -137,7 +122,7 @@ function backgroundToYaml(background, page) {
     const slot = page.slotsById.get(slotId);
     // A backdrop naming a slot the page does not hold paints nothing, and is written as the bare
     // reference it is rather than invented content.
-    if (slot === undefined || !isPublisherImageSlot(slot)) {
+    if (slot === undefined || !isPublisherImageSlotV1(slot)) {
         return mapOf([["image", mapOf([["ref", slotId]])]]);
     }
     const content = imageContentToYaml(slot);
@@ -196,7 +181,7 @@ function imageSlotToYaml(slot, weight) {
     ]);
 }
 function layoutNodeToYaml(node, page) {
-    if (isPublisherLayoutSection(node)) {
+    if (isPublisherLayoutSectionV1(node)) {
         const children = new YAMLSeq();
         for (const child of node.children) {
             children.add(layoutNodeToYaml(child, page));
@@ -217,18 +202,20 @@ function layoutNodeToYaml(node, page) {
             ["visualization", null],
         ]);
     }
-    if (isPublisherVisualizationSlot(slot)) {
+    if (isPublisherVisualizationSlotV1(slot)) {
         return visualizationSlotToYaml(slot, node.weight);
     }
-    if (isPublisherTextSlot(slot)) {
+    if (isPublisherTextSlotV1(slot)) {
         return textSlotToYaml(slot, node.weight, page);
     }
-    if (isPublisherImageSlot(slot)) {
+    if (isPublisherImageSlotV1(slot)) {
         return imageSlotToYaml(slot, node.weight);
     }
     // A slot of a kind this version does not know cannot be written without saying it is something
     // it is not, so the page is refused rather than quietly rewritten into a shape it never had.
-    throw newError(CoreErrorCode.ItemNotSupported, [JSON.stringify({ slot: slot.type })]);
+    throw newError(CoreErrorCode.ItemNotSupported, [
+        JSON.stringify({ slot: slot.type }),
+    ]);
 }
 /**
  * Writes a page out as the single tree it is authored as: the geometry and the slots it places

package/esm/from/declarativePublisherDocumentToYaml.d.ts

@@ -1,6 +1,6 @@
 import { type DeclarativeReport, type DeclarativeReportPageLayout } from "@gooddata/api-client-tiger";
 import type { Report, ReportPageBody, ReportPageLayout, ReportTemplate } from "@gooddata/sdk-code-schemas/v1";
-import { type IPublisherDocumentDefinition, type IPublisherDocumentPage, type IPublisherDocumentTemplate, type IPublisherDocumentTemplateDefinition, type IPublisherPageLayout, type IPublisherPageLayoutDefinition } from "@gooddata/sdk-model";
+import { type IPublisherDocumentDefinitionV1, type IPublisherDocumentPageV1, type IPublisherDocumentTemplateDefinitionV1, type IPublisherDocumentTemplateV1, type IPublisherPageTemplateDefinitionV1, type IPublisherPageTemplateV1 } from "@gooddata/sdk-model";
 /** @alpha */
 export declare function declarativePublisherDocumentToYaml(publisherDocument: DeclarativeReport): {
     content: string;
@@ -12,12 +12,12 @@ export declare function declarativePublisherDocumentToYaml(publisherDocument: De
  *
  * @alpha
  */
-export declare function publisherDocumentDefinitionToYaml(publisherDocument: IPublisherDocumentDefinition): {
+export declare function publisherDocumentDefinitionToYaml(publisherDocument: IPublisherDocumentDefinitionV1): {
     content: string;
     json: Report;
 };
 /** @alpha */
-export declare function publisherDocumentTemplateDefinitionToYaml(template: IPublisherDocumentTemplate | IPublisherDocumentTemplateDefinition): {
+export declare function publisherDocumentTemplateDefinitionToYaml(template: IPublisherDocumentTemplateV1 | IPublisherDocumentTemplateDefinitionV1): {
     content: string;
     json: ReportTemplate;
 };
@@ -27,7 +27,7 @@ export declare function publisherDocumentTemplateDefinitionToYaml(template: IPub
  *
  * @alpha
  */
-export declare function publisherPageLayoutDefinitionToYaml(layout: IPublisherPageLayout | IPublisherPageLayoutDefinition): {
+export declare function publisherPageLayoutDefinitionToYaml(layout: IPublisherPageTemplateV1 | IPublisherPageTemplateDefinitionV1): {
     content: string;
     json: ReportPageLayout;
 };
@@ -41,5 +41,5 @@ export declare function declarativePublisherPageLayoutToYaml(layout: Declarative
  *
  * @internal
  */
-export declare function publisherDocumentPageToAacPage(page: IPublisherDocumentPage): ReportPageBody;
+export declare function publisherDocumentPageToAacPage(page: IPublisherDocumentPageV1): ReportPageBody;
 //# sourceMappingURL=declarativePublisherDocumentToYaml.d.ts.map

package/esm/from/declarativePublisherDocumentToYaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declarativePublisherDocumentToYaml.d.ts","sourceRoot":"","sources":["../../src/from/declarativePublisherDocumentToYaml.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC9G,OAAO,EAEH,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,oCAAoC,EACzC,KAAK,oBAAoB,EAEzB,KAAK,8BAA8B,EAGtC,MAAM,qBAAqB,CAAC;AA2E7B,aAAa;AACb,wBAAgB,kCAAkC,CAAC,iBAAiB,EAAE,iBAAiB,GAAG;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,CAsBA;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,iBAAiB,EAAE,4BAA4B,GAAG;IAChG,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,CAsBA;AAED,aAAa;AACb,wBAAgB,yCAAyC,CACrD,QAAQ,EAAE,0BAA0B,GAAG,oCAAoC,GAC5E;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;CACxB,CAYA;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAC/C,MAAM,EAAE,oBAAoB,GAAG,8BAA8B,GAC9D;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;CAC1B,CAYA;AAED,aAAa;AACb,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,2BAA2B,GAAG;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;CAC1B,CAYA;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc,CAE3F"}
+{"version":3,"file":"declarativePublisherDocumentToYaml.d.ts","sourceRoot":"","sources":["../../src/from/declarativePublisherDocumentToYaml.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC9G,OAAO,EAEH,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,sCAAsC,EAC3C,KAAK,4BAA4B,EAEjC,KAAK,kCAAkC,EACvC,KAAK,wBAAwB,EAGhC,MAAM,qBAAqB,CAAC;AA2E7B,aAAa;AACb,wBAAgB,kCAAkC,CAAC,iBAAiB,EAAE,iBAAiB,GAAG;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,CAsBA;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,iBAAiB,EAAE,8BAA8B,GAAG;IAClG,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,CAsBA;AAED,aAAa;AACb,wBAAgB,yCAAyC,CACrD,QAAQ,EAAE,4BAA4B,GAAG,sCAAsC,GAChF;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;CACxB,CAYA;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAC/C,MAAM,EAAE,wBAAwB,GAAG,kCAAkC,GACtE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;CAC1B,CAYA;AAED,aAAa;AACb,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,2BAA2B,GAAG;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;CAC1B,CAYA;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,GAAG,cAAc,CAE7F"}

package/esm/from/declarativePublisherDocumentToYaml.js

@@ -1,8 +1,9 @@
 // (C) 2026 GoodData Corporation
 import { Document, Scalar, YAMLSeq } from "yaml";
 import { objRefToString, } from "@gooddata/sdk-model";
+import { filtersToYaml } from "../utils/publisherFilters.js";
 import { PUBLISHER_DOCUMENT_COMMENT, PUBLISHER_DOCUMENT_TEMPLATE_COMMENT, PUBLISHER_PAGE_LAYOUT_COMMENT, } from "../utils/texts.js";
-import { declarativePublisherDocumentPageToYaml, filtersToYaml, mapOf, publisherPageBodyEntries, } from "./declarativePublisherDocumentPageToYaml.js";
+import { declarativePublisherDocumentPageToYaml, mapOf, publisherPageBodyEntries, } from "./declarativePublisherDocumentPageToYaml.js";
 /**
  * A date is quoted, so a reader whose YAML dialect knows timestamps hands back the string the
  * schema states rather than a date of its own making.

package/esm/from/declarativePublisherEntityToYamlV2.d.ts

@@ -0,0 +1,52 @@
+import { type IPublisherDocumentDefinitionV2, type IPublisherDocumentTemplateDefinitionV2, type IPublisherPageTemplateDefinitionV2 } from "@gooddata/sdk-model";
+import { type DeclarativePublisherDocumentTemplateV2, type DeclarativePublisherDocumentV2, type DeclarativePublisherPageTemplateV2 } from "../declarativePublisherTypesV2.js";
+import { type AacPublisherDocumentTemplateV2, type AacPublisherDocumentV2, type AacPublisherEntityWithOptionalIdV2, type AacPublisherPageTemplateV2 } from "../schemas/types.js";
+import { type IErrorContext } from "../utils/errors.js";
+/**
+ * Converts a stored v2 document to its as-code YAML.
+ *
+ * @alpha
+ */
+export declare function declarativePublisherDocumentToYamlV2(document: DeclarativePublisherDocumentV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherDocumentV2;
+};
+/**
+ * Converts a stored v2 document template to its as-code YAML.
+ *
+ * @alpha
+ */
+export declare function declarativePublisherDocumentTemplateToYamlV2(template: DeclarativePublisherDocumentTemplateV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherDocumentTemplateV2;
+};
+/**
+ * Converts a stored v2 page template to its as-code YAML.
+ *
+ * @alpha
+ */
+export declare function declarativePublisherPageTemplateToYamlV2(template: DeclarativePublisherPageTemplateV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherPageTemplateV2;
+};
+/**
+ * Converts the v2 document the frontend holds to its as-code YAML. A document without a reference
+ * yet is written without an id.
+ *
+ * @alpha
+ */
+export declare function publisherDocumentDefinitionToYamlV2(document: IPublisherDocumentDefinitionV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherEntityWithOptionalIdV2<AacPublisherDocumentV2>;
+};
+/** @alpha */
+export declare function publisherDocumentTemplateDefinitionToYamlV2(template: IPublisherDocumentTemplateDefinitionV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherEntityWithOptionalIdV2<AacPublisherDocumentTemplateV2>;
+};
+/** @alpha */
+export declare function publisherPageTemplateDefinitionToYamlV2(template: IPublisherPageTemplateDefinitionV2, errorContext?: IErrorContext): {
+    content: string;
+    json: AacPublisherEntityWithOptionalIdV2<AacPublisherPageTemplateV2>;
+};
+//# sourceMappingURL=declarativePublisherEntityToYamlV2.d.ts.map

package/esm/from/declarativePublisherEntityToYamlV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarativePublisherEntityToYamlV2.d.ts","sourceRoot":"","sources":["../../src/from/declarativePublisherEntityToYamlV2.ts"],"names":[],"mappings":"AAYA,OAAO,EACH,KAAK,8BAA8B,EAEnC,KAAK,sCAAsC,EAE3C,KAAK,kCAAkC,EAO1C,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,KAAK,sCAAsC,EAC3C,KAAK,8BAA8B,EACnC,KAAK,kCAAkC,EAC1C,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,EACvC,KAAK,0BAA0B,EAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AA+O5E;;;;GAIG;AACH,wBAAgB,oCAAoC,CAChD,QAAQ,EAAE,8BAA8B,EACxC,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,4CAA4C,CACxD,QAAQ,EAAE,sCAAsC,EAChD,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,8BAA8B,CAAA;CAAE,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACpD,QAAQ,EAAE,kCAAkC,EAC5C,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAC/C,QAAQ,EAAE,8BAA8B,EACxC,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kCAAkC,CAAC,sBAAsB,CAAC,CAAA;CAAE,CAGvF;AAED,aAAa;AACb,wBAAgB,2CAA2C,CACvD,QAAQ,EAAE,sCAAsC,EAChD,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kCAAkC,CAAC,8BAA8B,CAAC,CAAA;CAAE,CAM/F;AAED,aAAa;AACb,wBAAgB,uCAAuC,CACnD,QAAQ,EAAE,kCAAkC,EAC5C,YAAY,CAAC,EAAE,aAAa,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kCAAkC,CAAC,0BAA0B,CAAC,CAAA;CAAE,CAM3F"}

package/esm/from/declarativePublisherEntityToYamlV2.js

@@ -0,0 +1,216 @@
+// (C) 2026 GoodData Corporation
+import { Document, Scalar, visit } from "yaml";
+import { dashboardFilterReferenceObjRef, } from "@gooddata/sdk-model";
+import { updateErrorContext } from "../utils/errors.js";
+import { snakeKeys } from "../utils/keyCase.js";
+import { pagesOrSectionsV2, unknownLayoutNodeV2 } from "../utils/publisherContentV2.js";
+import { referencesAsWritten } from "../utils/publisherFilterRefs.js";
+import { assertDocumentDateFiltersNameDataSet, filtersToYamlV2 } from "../utils/publisherFilters.js";
+import { periodToYamlV2 } from "../utils/publisherPeriodV2.js";
+import { assertPublisherContentVersionV2, publisherContentVersionV2 } from "../utils/publisherVersionV2.js";
+import { PUBLISHER_DOCUMENT_COMMENT, PUBLISHER_DOCUMENT_TEMPLATE_COMMENT, PUBLISHER_PAGE_TEMPLATE_COMMENT_V2, } from "../utils/texts.js";
+import { getIdentifier } from "../utils/yamlUtils.js";
+function visualizationToYaml(widget, errorContext) {
+    const { visualization, dateDataSet, filters, ignoreDocumentFilters, ...rest } = widget;
+    return {
+        ...snakeKeys(rest),
+        ...(visualization === undefined ? {} : { visualization: visualization.identifier }),
+        ...(dateDataSet === undefined ? {} : { date: dateDataSet.identifier }),
+        ...(filters === undefined ? {} : { filters: filtersToYamlV2({ filters }, errorContext) }),
+        ...(ignoreDocumentFilters === undefined
+            ? {}
+            : {
+                ignored_filters: ignoreDocumentFilters.map((reference) => getIdentifier(referencesAsWritten(dashboardFilterReferenceObjRef(reference)), undefined, errorContext)),
+            }),
+    };
+}
+function layoutNodeToYaml(node, errorContext) {
+    switch (node.type) {
+        case "row":
+        case "column": {
+            const { children, ...container } = node;
+            return {
+                ...snakeKeys(container),
+                children: children.map((child) => layoutNodeToYaml(child, errorContext)),
+            };
+        }
+        case "visualization":
+            return visualizationToYaml(node, errorContext);
+        case "title":
+        case "heading":
+        case "text":
+        case "image":
+        case "takeaway":
+            return snakeKeys(node);
+        default:
+            throw unknownLayoutNodeV2(node, errorContext);
+    }
+}
+function pageBodyToYaml(body, errorContext) {
+    const { layout, filters, ...rest } = body;
+    return {
+        ...snakeKeys(rest),
+        layout: layoutNodeToYaml(layout, errorContext),
+        ...(filters === undefined ? {} : { filters: filtersToYamlV2({ filters }, errorContext) }),
+    };
+}
+function documentPageToYaml(page, errorContext) {
+    const { id, visible, ...body } = page;
+    return {
+        id,
+        ...(visible === undefined ? {} : { visible }),
+        ...pageBodyToYaml(body, updateErrorContext(errorContext, { path: [id] })),
+    };
+}
+function sectionToYaml(section, errorContext) {
+    const { pages, ...rest } = section;
+    const pagesContext = updateErrorContext(errorContext, { path: ["sections", section.id, "pages"] });
+    return { ...rest, pages: pages.map((page) => documentPageToYaml(page, pagesContext)) };
+}
+function defaultsToYaml({ period, ...rest }) {
+    return {
+        ...snakeKeys(rest),
+        ...(period === undefined ? {} : { period: periodToYamlV2(period) }),
+    };
+}
+function contentToYaml(content, errorContext) {
+    const { defaults, filters, attributeFilterConfigs, pages, sections, ...rest } = content;
+    const held = pagesOrSectionsV2({ pages, sections }, errorContext);
+    const filtersContext = updateErrorContext(errorContext, { path: ["filters"] });
+    if (filters !== undefined) {
+        assertDocumentDateFiltersNameDataSet(filters, filtersContext);
+    }
+    const base = {
+        ...(defaults === undefined
+            ? {}
+            : {
+                defaults: defaultsToYaml(defaults),
+            }),
+        ...(filters === undefined && !attributeFilterConfigs?.length
+            ? {}
+            : {
+                filters: filtersToYamlV2({ filters: filters ?? [], attributeFilterConfigs }, filtersContext),
+            }),
+        ...snakeKeys(rest),
+    };
+    if (held.sections !== undefined) {
+        return { ...base, sections: held.sections.map((section) => sectionToYaml(section, errorContext)) };
+    }
+    const pagesContext = updateErrorContext(errorContext, { path: ["pages"] });
+    return { ...base, pages: held.pages.map((page) => documentPageToYaml(page, pagesContext)) };
+}
+function entityFields(entity) {
+    return {
+        version: publisherContentVersionV2,
+        title: entity.title,
+        ...(entity.description === undefined ? {} : { description: entity.description }),
+        ...(entity.tags === undefined ? {} : { tags: entity.tags }),
+    };
+}
+function withId({ type, ...rest }, id) {
+    return { type, id, ...rest };
+}
+function withOptionalId(entity, id) {
+    return id === undefined ? entity : withId(entity, id);
+}
+// A 1.1 document leaves `0o17` plain, which a YAML 1.2 reader turns into a number. The merge tag
+// writes `<<` plain whatever its quoting, so it goes; nothing written here is a merge key.
+function yaml11Tags(tags) {
+    return [
+        ...tags.filter((tag) => typeof tag === "string" || tag.tag !== "tag:yaml.org,2002:merge"),
+        "intOct",
+    ];
+}
+/**
+ * Written for YAML 1.1, which PyYAML reads, so strings such as `no`, `on` or dates stay quoted strings.
+ */
+function toYaml(json, comment) {
+    const document = new Document(json, { version: "1.1", customTags: yaml11Tags });
+    document.commentBefore = comment;
+    // PyYAML resolves a plain `=` or `<<` to its value or merge tag, and safe_load rejects both.
+    visit(document, {
+        Scalar(_, node) {
+            if (node.value === "=" || node.value === "<<") {
+                node.type = Scalar.QUOTE_DOUBLE;
+            }
+        },
+    });
+    return document.toString({ lineWidth: 0 });
+}
+function documentToYaml(document, errorContext) {
+    assertPublisherContentVersionV2(document, errorContext);
+    return {
+        type: "document",
+        ...entityFields(document),
+        period: periodToYamlV2(document.period),
+        content: contentToYaml(document.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+function documentTemplateToYaml(template, errorContext) {
+    assertPublisherContentVersionV2(template, errorContext);
+    return {
+        type: "document_template",
+        ...entityFields(template),
+        content: contentToYaml(template.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+function pageTemplateToYaml(template, errorContext) {
+    assertPublisherContentVersionV2(template, errorContext);
+    return {
+        type: "page_template",
+        ...entityFields(template),
+        content: pageBodyToYaml(template.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+function refToId(ref, errorContext) {
+    return ref === undefined
+        ? undefined
+        : getIdentifier(ref, true, updateErrorContext(errorContext, { path: ["ref"] }));
+}
+/**
+ * Converts a stored v2 document to its as-code YAML.
+ *
+ * @alpha
+ */
+export function declarativePublisherDocumentToYamlV2(document, errorContext) {
+    const json = withId(documentToYaml(document, errorContext), document.id);
+    return { content: toYaml(json, PUBLISHER_DOCUMENT_COMMENT), json };
+}
+/**
+ * Converts a stored v2 document template to its as-code YAML.
+ *
+ * @alpha
+ */
+export function declarativePublisherDocumentTemplateToYamlV2(template, errorContext) {
+    const json = withId(documentTemplateToYaml(template, errorContext), template.id);
+    return { content: toYaml(json, PUBLISHER_DOCUMENT_TEMPLATE_COMMENT), json };
+}
+/**
+ * Converts a stored v2 page template to its as-code YAML.
+ *
+ * @alpha
+ */
+export function declarativePublisherPageTemplateToYamlV2(template, errorContext) {
+    const json = withId(pageTemplateToYaml(template, errorContext), template.id);
+    return { content: toYaml(json, PUBLISHER_PAGE_TEMPLATE_COMMENT_V2), json };
+}
+/**
+ * Converts the v2 document the frontend holds to its as-code YAML. A document without a reference
+ * yet is written without an id.
+ *
+ * @alpha
+ */
+export function publisherDocumentDefinitionToYamlV2(document, errorContext) {
+    const json = withOptionalId(documentToYaml(document, errorContext), refToId(document.ref, errorContext));
+    return { content: toYaml(json, PUBLISHER_DOCUMENT_COMMENT), json };
+}
+/** @alpha */
+export function publisherDocumentTemplateDefinitionToYamlV2(template, errorContext) {
+    const json = withOptionalId(documentTemplateToYaml(template, errorContext), refToId(template.ref, errorContext));
+    return { content: toYaml(json, PUBLISHER_DOCUMENT_TEMPLATE_COMMENT), json };
+}
+/** @alpha */
+export function publisherPageTemplateDefinitionToYamlV2(template, errorContext) {
+    const json = withOptionalId(pageTemplateToYaml(template, errorContext), refToId(template.ref, errorContext));
+    return { content: toYaml(json, PUBLISHER_PAGE_TEMPLATE_COMMENT_V2), json };
+}