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

package/esm/to/yamlPublisherEntityToDeclarativeV2.js

@@ -0,0 +1,190 @@
+// (C) 2026 GoodData Corporation
+import { idRef, } from "@gooddata/sdk-model";
+import { CoreErrorCode, newError, updateErrorContext } from "../utils/errors.js";
+import { camelKeys } from "../utils/keyCase.js";
+import { pagesOrSectionsV2, unknownLayoutNodeV2 } from "../utils/publisherContentV2.js";
+import { referencesAsStored } from "../utils/publisherFilterRefs.js";
+import { assertDocumentDateFiltersNameDataSet, filtersToDeclarativeV2 } from "../utils/publisherFilters.js";
+import { periodToDeclarativeV2 } from "../utils/publisherPeriodV2.js";
+import { assertPublisherContentVersionV2, publisherContentVersionV2 } from "../utils/publisherVersionV2.js";
+import { yamlIgnoredFilterToDeclarative } from "./yamlDashboardToDeclarative.js";
+function ignoredFilterToDeclarative(id, errorContext) {
+    const reference = yamlIgnoredFilterToDeclarative(id);
+    if (reference === null) {
+        throw newError(CoreErrorCode.ReferenceTypeNotSupported, [id], errorContext);
+    }
+    return referencesAsStored(reference);
+}
+function visualizationToDeclarative(widget, errorContext) {
+    const { visualization, date, filters, ignored_filters, ...rest } = widget;
+    return {
+        ...camelKeys(rest),
+        ...(visualization === undefined
+            ? {}
+            : { visualization: { identifier: visualization, type: "insight" } }),
+        ...(date === undefined ? {} : { dateDataSet: { identifier: date, type: "dataSet" } }),
+        ...(filters === undefined
+            ? {}
+            : { filters: filtersToDeclarativeV2(filters, "widget", errorContext).filters }),
+        ...(ignored_filters === undefined
+            ? {}
+            : {
+                ignoreDocumentFilters: ignored_filters.map((id) => ignoredFilterToDeclarative(id, errorContext)),
+            }),
+    };
+}
+function layoutNodeToDeclarative(node, errorContext) {
+    switch (node.type) {
+        case "row":
+        case "column": {
+            const { children, ...container } = node;
+            return {
+                ...camelKeys(container),
+                children: children.map((child) => layoutNodeToDeclarative(child, errorContext)),
+            };
+        }
+        case "visualization":
+            return visualizationToDeclarative(node, errorContext);
+        case "title":
+        case "heading":
+        case "text":
+        case "image":
+        case "takeaway":
+            return camelKeys(node);
+        default:
+            throw unknownLayoutNodeV2(node, errorContext);
+    }
+}
+function pageBodyToDeclarative(body, errorContext) {
+    const { layout, filters, ...rest } = body;
+    return {
+        ...camelKeys(rest),
+        layout: layoutNodeToDeclarative(layout, errorContext),
+        ...(filters === undefined
+            ? {}
+            : { filters: filtersToDeclarativeV2(filters, "page", errorContext).filters }),
+    };
+}
+function documentPageToDeclarative(page, errorContext) {
+    const { id, visible, ...body } = page;
+    return {
+        id,
+        ...(visible === undefined ? {} : { visible }),
+        ...pageBodyToDeclarative(body, updateErrorContext(errorContext, { path: [id] })),
+    };
+}
+function sectionToDeclarative(section, errorContext) {
+    const { pages, ...rest } = section;
+    const pagesContext = updateErrorContext(errorContext, { path: ["sections", section.id, "pages"] });
+    return { ...rest, pages: pages.map((page) => documentPageToDeclarative(page, pagesContext)) };
+}
+function defaultsToDeclarative({ period, ...rest }) {
+    return {
+        ...camelKeys(rest),
+        ...(period === undefined ? {} : { period: periodToDeclarativeV2(period) }),
+    };
+}
+function contentToDeclarative(content, errorContext) {
+    const { defaults, filters, pages, sections, ...rest } = content;
+    const held = pagesOrSectionsV2({ pages, sections }, errorContext);
+    const filtersContext = updateErrorContext(errorContext, { path: ["filters"] });
+    const declared = filters === undefined ? undefined : filtersToDeclarativeV2(filters, "document", filtersContext);
+    if (declared !== undefined) {
+        assertDocumentDateFiltersNameDataSet(declared.filters, filtersContext);
+    }
+    const base = {
+        ...(defaults === undefined
+            ? {}
+            : {
+                defaults: defaultsToDeclarative(defaults),
+            }),
+        ...declared,
+        ...camelKeys(rest),
+    };
+    if (held.sections !== undefined) {
+        return {
+            ...base,
+            sections: held.sections.map((section) => sectionToDeclarative(section, errorContext)),
+        };
+    }
+    const pagesContext = updateErrorContext(errorContext, { path: ["pages"] });
+    return { ...base, pages: held.pages.map((page) => documentPageToDeclarative(page, pagesContext)) };
+}
+function entityFields(entity) {
+    return {
+        title: entity.title,
+        ...(entity.description === undefined ? {} : { description: entity.description }),
+        ...(entity.tags === undefined ? {} : { tags: entity.tags }),
+        version: publisherContentVersionV2,
+    };
+}
+function documentBody(input, errorContext) {
+    assertPublisherContentVersionV2(input, errorContext);
+    return {
+        type: "document",
+        ...entityFields(input),
+        period: periodToDeclarativeV2(input.period),
+        content: contentToDeclarative(input.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+function documentTemplateBody(input, errorContext) {
+    assertPublisherContentVersionV2(input, errorContext);
+    return {
+        type: "documentTemplate",
+        ...entityFields(input),
+        content: contentToDeclarative(input.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+function pageTemplateBody(input, errorContext) {
+    assertPublisherContentVersionV2(input, errorContext);
+    return {
+        type: "pageTemplate",
+        ...entityFields(input),
+        content: pageBodyToDeclarative(input.content, updateErrorContext(errorContext, { path: ["content"] })),
+    };
+}
+/** An `id:` written without a value reads as null and counts as missing. */
+function refFromId(id) {
+    return id === undefined || id === null ? {} : { ref: idRef(id) };
+}
+/**
+ * Converts a v2 document as code to the stored document.
+ *
+ * @alpha
+ */
+export function yamlPublisherDocumentToDeclarativeV2(input, errorContext) {
+    return { id: input.id, ...documentBody(input, errorContext) };
+}
+/**
+ * Converts a v2 document template as code to the stored document template.
+ *
+ * @alpha
+ */
+export function yamlPublisherDocumentTemplateToDeclarativeV2(input, errorContext) {
+    return { id: input.id, ...documentTemplateBody(input, errorContext) };
+}
+/**
+ * Converts a v2 page template as code to the stored page template.
+ *
+ * @alpha
+ */
+export function yamlPublisherPageTemplateToDeclarativeV2(input, errorContext) {
+    return { id: input.id, ...pageTemplateBody(input, errorContext) };
+}
+/**
+ * Converts a v2 document as code to the definition the frontend holds: an object reference in place
+ * of the bare id. A document written without an id reads back without a reference.
+ *
+ * @alpha
+ */
+export function yamlPublisherDocumentToDefinitionV2(input, errorContext) {
+    return { ...documentBody(input, errorContext), ...refFromId(input.id) };
+}
+/** @alpha */
+export function yamlPublisherDocumentTemplateToDefinitionV2(input, errorContext) {
+    return { ...documentTemplateBody(input, errorContext), ...refFromId(input.id) };
+}
+/** @alpha */
+export function yamlPublisherPageTemplateToDefinitionV2(input, errorContext) {
+    return { ...pageTemplateBody(input, errorContext), ...refFromId(input.id) };
+}

package/esm/utils/errors.d.ts

@@ -18,7 +18,12 @@ export declare enum CoreErrorCode {
     DuplicateLayerIdentifier = "core.duplicateLayerIdentifier",
     DuplicateTabIdentifier = "core.duplicateTabIdentifier",
     TabsAndRootContentMutuallyExclusive = "core.tabsAndRootContentMutuallyExclusive",
-    InvalidIanaTimezoneId = "core.invalidIanaTimezoneId"
+    InvalidIanaTimezoneId = "core.invalidIanaTimezoneId",
+    UnsupportedContentVersion = "core.unsupportedContentVersion",
+    DateFilterWithoutDataSet = "core.dateFilterWithoutDataSet",
+    FilterSettingNotStorable = "core.filterSettingNotStorable",
+    PagesAndSectionsMutuallyExclusive = "core.pagesAndSectionsMutuallyExclusive",
+    PagesOrSectionsRequired = "core.pagesOrSectionsRequired"
 }
 /**
  * @public

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,aAAa;IAErB,0BAA0B,oCAAoC;IAC9D,0BAA0B,oCAAoC;IAC9D,gBAAgB,0BAA0B;IAC1C,yBAAyB,mCAAmC;IAC5D,yBAAyB,mCAAmC;IAC5D,qBAAqB,+BAA+B;IACpD,oBAAoB,8BAA8B;IAClD,yBAAyB,mCAAmC;IAC5D,2BAA2B,qCAAqC;IAChE,yBAAyB,mCAAmC;IAC5D,8BAA8B,wCAAwC;IACtE,kBAAkB,4BAA4B;IAC9C,mBAAmB,6BAA6B;IAChD,wBAAwB,kCAAkC;IAC1D,sBAAsB,gCAAgC;IACtD,mCAAmC,6CAA6C;IAChF,qBAAqB,+BAA+B;CACvD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAkB3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAkBxD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,aAAa,CAaf;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,KAAK,CAAC,MAAM,CAAM,EAAE,OAAO,CAAC,EAAE,aAAa,cAOhG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,UAU3F"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,aAAa;IAErB,0BAA0B,oCAAoC;IAC9D,0BAA0B,oCAAoC;IAC9D,gBAAgB,0BAA0B;IAC1C,yBAAyB,mCAAmC;IAC5D,yBAAyB,mCAAmC;IAC5D,qBAAqB,+BAA+B;IACpD,oBAAoB,8BAA8B;IAClD,yBAAyB,mCAAmC;IAC5D,2BAA2B,qCAAqC;IAChE,yBAAyB,mCAAmC;IAC5D,8BAA8B,wCAAwC;IACtE,kBAAkB,4BAA4B;IAC9C,mBAAmB,6BAA6B;IAChD,wBAAwB,kCAAkC;IAC1D,sBAAsB,gCAAgC;IACtD,mCAAmC,6CAA6C;IAChF,qBAAqB,+BAA+B;IACpD,yBAAyB,mCAAmC;IAC5D,wBAAwB,kCAAkC;IAC1D,wBAAwB,kCAAkC;IAC1D,iCAAiC,2CAA2C;IAC5E,uBAAuB,iCAAiC;CAC3D;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAuB3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAuBxD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,aAAa,CAaf;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,KAAK,CAAC,MAAM,CAAM,EAAE,OAAO,CAAC,EAAE,aAAa,cAOhG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,UAU3F"}

package/esm/utils/errors.js

@@ -22,6 +22,11 @@ export var CoreErrorCode;
     CoreErrorCode["DuplicateTabIdentifier"] = "core.duplicateTabIdentifier";
     CoreErrorCode["TabsAndRootContentMutuallyExclusive"] = "core.tabsAndRootContentMutuallyExclusive";
     CoreErrorCode["InvalidIanaTimezoneId"] = "core.invalidIanaTimezoneId";
+    CoreErrorCode["UnsupportedContentVersion"] = "core.unsupportedContentVersion";
+    CoreErrorCode["DateFilterWithoutDataSet"] = "core.dateFilterWithoutDataSet";
+    CoreErrorCode["FilterSettingNotStorable"] = "core.filterSettingNotStorable";
+    CoreErrorCode["PagesAndSectionsMutuallyExclusive"] = "core.pagesAndSectionsMutuallyExclusive";
+    CoreErrorCode["PagesOrSectionsRequired"] = "core.pagesOrSectionsRequired";
 })(CoreErrorCode || (CoreErrorCode = {}));
 /**
  * @public
@@ -44,6 +49,11 @@ export const CoreErrorMessages = {
     [CoreErrorCode.DuplicateTabIdentifier]: `Duplicate tab identifier "{0}". Each tab must have a unique identifier within the dashboard.`,
     [CoreErrorCode.TabsAndRootContentMutuallyExclusive]: `Dashboard "{0}" defines both "tabs" and root-level "sections" or "filters". These are mutually exclusive — keep all content inside tabs or at the root, not both.`,
     [CoreErrorCode.InvalidIanaTimezoneId]: `"{0}" is not a valid IANA timezone ID. Use a real timezone such as Europe/Prague or $browserDetected.`,
+    [CoreErrorCode.UnsupportedContentVersion]: `Content version "{0}" is not supported. Supported version: "{1}".`,
+    [CoreErrorCode.DateFilterWithoutDataSet]: `Date filter "{0}" names no date dataset. A document date filter must name the date dataset it applies to.`,
+    [CoreErrorCode.FilterSettingNotStorable]: `Filter "{0}" sets "{1}", which a {2} cannot store.`,
+    [CoreErrorCode.PagesAndSectionsMutuallyExclusive]: `Content defines both "pages" and "sections". Keep the pages at the top level or inside sections, not both.`,
+    [CoreErrorCode.PagesOrSectionsRequired]: `Content defines neither "pages" nor "sections". Add one of them; an empty document has "pages: []".`,
 };
 /**
  * @public
@@ -66,6 +76,11 @@ export const CoreErrorTypes = {
     [CoreErrorCode.DuplicateTabIdentifier]: "DuplicateTabIdentifier",
     [CoreErrorCode.TabsAndRootContentMutuallyExclusive]: "TabsAndRootContentMutuallyExclusive",
     [CoreErrorCode.InvalidIanaTimezoneId]: "InvalidIanaTimezoneId",
+    [CoreErrorCode.UnsupportedContentVersion]: "UnsupportedContentVersion",
+    [CoreErrorCode.DateFilterWithoutDataSet]: "DateFilterWithoutDataSet",
+    [CoreErrorCode.FilterSettingNotStorable]: "FilterSettingNotStorable",
+    [CoreErrorCode.PagesAndSectionsMutuallyExclusive]: "PagesAndSectionsMutuallyExclusive",
+    [CoreErrorCode.PagesOrSectionsRequired]: "PagesOrSectionsRequired",
 };
 /**
  * Update error context with new values

package/esm/utils/keyCase.d.ts

@@ -0,0 +1,24 @@
+type SnakeCase<S extends string> = S extends `${infer Head}${infer Tail}` ? `${Head extends Lowercase<Head> ? Head : `_${Lowercase<Head>}`}${SnakeCase<Tail>}` : S;
+type CamelCase<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${Capitalize<CamelCase<Tail>>}` : S;
+/** @internal */
+export type SnakeKeys<T> = T extends readonly (infer Item)[] ? SnakeKeys<Item>[] : T extends object ? {
+    [K in keyof T as K extends string ? SnakeCase<K> : K]: SnakeKeys<T[K]>;
+} : T;
+/** @internal */
+export type CamelKeys<T> = T extends readonly (infer Item)[] ? CamelKeys<Item>[] : T extends object ? {
+    [K in keyof T as K extends string ? CamelCase<K> : K]: CamelKeys<T[K]>;
+} : T;
+/**
+ * Every key of a plain JSON value, at any depth, in snake_case. Values are kept as they are.
+ *
+ * @internal
+ */
+export declare function snakeKeys<T>(value: T): SnakeKeys<T>;
+/**
+ * Every key of a plain JSON value, at any depth, in camelCase. Values are kept as they are.
+ *
+ * @internal
+ */
+export declare function camelKeys<T>(value: T): CamelKeys<T>;
+export {};
+//# sourceMappingURL=keyCase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyCase.d.ts","sourceRoot":"","sources":["../../src/utils/keyCase.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,GACnE,GAAG,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,GAClF,CAAC,CAAC;AAER,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACpE,GAAG,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,GACvC,CAAC,CAAC;AAER,gBAAgB;AAChB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACtD,SAAS,CAAC,IAAI,CAAC,EAAE,GACjB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC1E,CAAC,CAAC;AAEV,gBAAgB;AAChB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACtD,SAAS,CAAC,IAAI,CAAC,EAAE,GACjB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC1E,CAAC,CAAC;AAcV;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAKnD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAKnD"}

package/esm/utils/keyCase.js

@@ -0,0 +1,28 @@
+// (C) 2026 GoodData Corporation
+function mapKeys(value, rename) {
+    if (Array.isArray(value)) {
+        return value.map((item) => mapKeys(item, rename));
+    }
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [rename(key), mapKeys(item, rename)]));
+}
+/**
+ * Every key of a plain JSON value, at any depth, in snake_case. Values are kept as they are.
+ *
+ * @internal
+ */
+export function snakeKeys(value) {
+    // Sound only while the regex renames exactly as the SnakeCase type does.
+    return mapKeys(value, (key) => key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`));
+}
+/**
+ * Every key of a plain JSON value, at any depth, in camelCase. Values are kept as they are.
+ *
+ * @internal
+ */
+export function camelKeys(value) {
+    // Sound only while the regex renames exactly as the CamelCase type does.
+    return mapKeys(value, (key) => key.replace(/_([a-z0-9])/g, (_, letter) => letter.toUpperCase()));
+}

package/esm/utils/publisherContentV2.d.ts

@@ -0,0 +1,25 @@
+import { type IErrorContext } from "./errors.js";
+/**
+ * The one of `pages` and `sections` that document content holds. Both or neither throws. Both keys
+ * written counts as both, whatever their values, as the schema reads it; otherwise a key written
+ * without a value, which YAML reads as null, counts as missing.
+ *
+ * @internal
+ */
+export declare function pagesOrSectionsV2<Pages, Sections>({ pages, sections }: {
+    pages?: Pages | null;
+    sections?: Sections | null;
+}, errorContext: IErrorContext | undefined): {
+    pages: Pages;
+    sections?: never;
+} | {
+    pages?: never;
+    sections: Sections;
+};
+/**
+ * The error for a layout node whose type the v2 converters do not know.
+ *
+ * @internal
+ */
+export declare function unknownLayoutNodeV2(node: never, errorContext: IErrorContext | undefined): Error;
+//# sourceMappingURL=publisherContentV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisherContentV2.d.ts","sourceRoot":"","sources":["../../src/utils/publisherContentV2.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAC7C,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,EACzE,YAAY,EAAE,aAAa,GAAG,SAAS,GACxC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAa5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,GAAG,SAAS,GAAG,KAAK,CAI/F"}

package/esm/utils/publisherContentV2.js

@@ -0,0 +1,33 @@
+// (C) 2026 GoodData Corporation
+import { CoreErrorCode, newError } from "./errors.js";
+/**
+ * The one of `pages` and `sections` that document content holds. Both or neither throws. Both keys
+ * written counts as both, whatever their values, as the schema reads it; otherwise a key written
+ * without a value, which YAML reads as null, counts as missing.
+ *
+ * @internal
+ */
+export function pagesOrSectionsV2({ pages, sections }, errorContext) {
+    if (pages !== undefined && sections !== undefined) {
+        throw newError(CoreErrorCode.PagesAndSectionsMutuallyExclusive, [], errorContext);
+    }
+    const hasPages = pages !== null && pages !== undefined;
+    const hasSections = sections !== null && sections !== undefined;
+    if (hasSections) {
+        return { sections };
+    }
+    if (hasPages) {
+        return { pages };
+    }
+    throw newError(CoreErrorCode.PagesOrSectionsRequired, [], errorContext);
+}
+/**
+ * The error for a layout node whose type the v2 converters do not know.
+ *
+ * @internal
+ */
+export function unknownLayoutNodeV2(node, errorContext) {
+    // Unreachable for typed input; stored data and YAML are not checked against the node union.
+    const { type } = node;
+    return newError(CoreErrorCode.ItemNotSupported, [JSON.stringify({ node: type })], errorContext);
+}

package/esm/utils/publisherFilters.d.ts

@@ -0,0 +1,50 @@
+import { type YAMLMap } from "yaml";
+import type { DashboardFilters } from "@gooddata/sdk-code-schemas/v1";
+import { type FilterContextItem, type IDashboardAttributeFilterConfig } from "@gooddata/sdk-model";
+import { type IErrorContext } from "./errors.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 declare function filtersToYaml(filters: FilterContextItem[] | undefined): YAMLMap | undefined;
+/**
+ * A document 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;
+/**
+ * What holds a v2 filter list. Only a document keeps attribute filter settings (`mode`, `display_as`,
+ * `selection_type`), in its `attributeFilterConfigs`.
+ *
+ * @internal
+ */
+export type PublisherFilterHolderV2 = "document" | "page" | "widget";
+/** @internal */
+export interface IPublisherFiltersV2 {
+    filters: FilterContextItem[];
+    attributeFilterConfigs?: IDashboardAttributeFilterConfig[];
+}
+/**
+ * Reads a v2 filter list. A setting the v2 shape has nowhere to keep throws instead of being dropped.
+ *
+ * @internal
+ */
+export declare function filtersToDeclarativeV2(filters: DashboardFilters, holder: PublisherFilterHolderV2, errorContext?: IErrorContext): IPublisherFiltersV2;
+/**
+ * Writes a v2 filter list. An empty list is written as an empty map, so it reads back as an empty list.
+ *
+ * @internal
+ */
+export declare function filtersToYamlV2({ filters, attributeFilterConfigs }: IPublisherFiltersV2, errorContext?: IErrorContext): DashboardFilters;
+/**
+ * A document's own date filters each name the date dataset they apply to; the period plays the role
+ * of a dashboard's common date filter.
+ *
+ * @internal
+ */
+export declare function assertDocumentDateFiltersNameDataSet(filters: FilterContextItem[], errorContext?: IErrorContext): void;
+//# sourceMappingURL=publisherFilters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisherFilters.d.ts","sourceRoot":"","sources":["../../src/utils/publisherFilters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,+BAA+B,EAMvC,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAiB,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAI1E;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAQ3F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAS3G;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErE,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,sBAAsB,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAC9D;AA0BD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,uBAAuB,EAC/B,YAAY,CAAC,EAAE,aAAa,GAC7B,mBAAmB,CAgCrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,mBAAmB,EACxD,YAAY,CAAC,EAAE,aAAa,GAC7B,gBAAgB,CA8BlB;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAChD,OAAO,EAAE,iBAAiB,EAAE,EAC5B,YAAY,CAAC,EAAE,aAAa,GAC7B,IAAI,CASN"}

package/esm/utils/publisherFilters.js

@@ -0,0 +1,122 @@
+// (C) 2026 GoodData Corporation
+import { dashboardFilterLocalIdentifier, isDashboardCommonDateFilter, isDashboardDateFilter, isNoopAllTimeDashboardDateFilter, } from "@gooddata/sdk-model";
+import { declarativeFilterContextToYaml, declarativeFiltersConfigToYaml, } from "../from/declarativeDashboardToYaml.js";
+import { yamlFilterContextToDeclarative } from "../to/yamlDashboardToDeclarative.js";
+import { CoreErrorCode, newError } from "./errors.js";
+import { referencesAsStored, referencesAsWritten } from "./publisherFilterRefs.js";
+import { createFilterContextItemKeyName } from "./yamlUtils.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 written.items.length === 0 ? undefined : written;
+}
+/**
+ * A document 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 document stores.
+    const { filterContext } = yamlFilterContextToDeclarative("report", filters);
+    const content = filterContext.content;
+    return content?.filters?.length ? referencesAsStored(content.filters) : undefined;
+}
+function setting(filter, key) {
+    return filter[key];
+}
+function changedSetting(filter, key) {
+    const value = setting(filter, key);
+    return key === "mode" ? value !== undefined && value !== "active" : value !== undefined;
+}
+function lostSettings(filter, holder) {
+    switch (setting(filter, "type")) {
+        case "filter_group":
+            return ["filter_group"];
+        case "date_filter":
+            return ["title", "mode"].filter((key) => changedSetting(filter, key));
+        case "metric_value_filter":
+            return ["mode"].filter((key) => changedSetting(filter, key));
+        default:
+            return holder === "document"
+                ? []
+                : ["mode", "display_as", "selection_type"].filter((key) => changedSetting(filter, key));
+    }
+}
+/**
+ * Reads a v2 filter list. A setting the v2 shape has nowhere to keep throws instead of being dropped.
+ *
+ * @internal
+ */
+export function filtersToDeclarativeV2(filters, holder, errorContext) {
+    const entries = Object.entries(filters);
+    for (const [key, filter] of entries) {
+        const [lost] = lostSettings(filter, holder);
+        if (lost !== undefined) {
+            throw newError(CoreErrorCode.FilterSettingNotStorable, [key, lost, holder], errorContext);
+        }
+    }
+    const { filterContext, attributeFilterConfigs } = yamlFilterContextToDeclarative("document", filters);
+    const read = filterContext.content?.filters ?? [];
+    const missing = entries.find(([key]) => !read.some((filter) => dashboardFilterLocalIdentifier(filter) === key));
+    if (missing !== undefined) {
+        throw newError(CoreErrorCode.ItemNotSupported, [missing[0]], errorContext);
+    }
+    const unwritable = read.find((filter) => isDashboardCommonDateFilter(filter) && isNoopAllTimeDashboardDateFilter(filter));
+    if (unwritable !== undefined) {
+        throw newError(CoreErrorCode.ItemNotSupported, [dashboardFilterLocalIdentifier(unwritable) ?? JSON.stringify(unwritable)], errorContext);
+    }
+    return {
+        filters: referencesAsStored(read),
+        ...(attributeFilterConfigs?.length
+            ? { attributeFilterConfigs: referencesAsStored(attributeFilterConfigs) }
+            : {}),
+    };
+}
+/**
+ * Writes a v2 filter list. An empty list is written as an empty map, so it reads back as an empty list.
+ *
+ * @internal
+ */
+export function filtersToYamlV2({ filters, attributeFilterConfigs }, errorContext) {
+    const writtenFilters = referencesAsWritten(filters);
+    const { filters: written, filtersMap } = declarativeFilterContextToYaml(undefined, { content: { filters: writtenFilters, version: "2" } }, errorContext);
+    const keys = writtenFilters.map((filter) => createFilterContextItemKeyName(filter, "date", errorContext));
+    // Two kept filters sharing a key make the writer throw, so a shared key means one of them was skipped.
+    const lostFilter = keys.find((key, index) => !Object.hasOwn(filtersMap, key) || keys.indexOf(key) !== index);
+    if (lostFilter !== undefined) {
+        throw newError(CoreErrorCode.ItemNotSupported, [lostFilter], errorContext);
+    }
+    const lostConfig = attributeFilterConfigs?.find(({ localIdentifier }) => !Object.hasOwn(filtersMap, localIdentifier));
+    if (lostConfig !== undefined) {
+        throw newError(CoreErrorCode.ItemNotSupported, [lostConfig.localIdentifier], errorContext);
+    }
+    declarativeFiltersConfigToYaml(filtersMap, undefined, undefined, referencesAsWritten(attributeFilterConfigs), undefined, errorContext);
+    return written.toJSON();
+}
+/**
+ * A document's own date filters each name the date dataset they apply to; the period plays the role
+ * of a dashboard's common date filter.
+ *
+ * @internal
+ */
+export function assertDocumentDateFiltersNameDataSet(filters, errorContext) {
+    const index = filters.findIndex((filter) => isDashboardDateFilter(filter) && !filter.dateFilter.dataSet);
+    if (index !== -1) {
+        throw newError(CoreErrorCode.DateFilterWithoutDataSet, [dashboardFilterLocalIdentifier(filters[index]) ?? `#${index}`], errorContext);
+    }
+}

package/esm/utils/publisherPeriodV2.d.ts

@@ -0,0 +1,7 @@
+import type { PublisherPeriodV2 as AacPublisherPeriodV2 } from "@gooddata/sdk-code-schemas/v1";
+import { type PublisherPeriodV2 } from "@gooddata/sdk-model";
+/** @internal */
+export declare function periodToDeclarativeV2(period: AacPublisherPeriodV2): PublisherPeriodV2;
+/** @internal */
+export declare function periodToYamlV2(period: PublisherPeriodV2): AacPublisherPeriodV2;
+//# sourceMappingURL=publisherPeriodV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisherPeriodV2.d.ts","sourceRoot":"","sources":["../../src/utils/publisherPeriodV2.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,iBAAiB,IAAI,oBAAoB,EAE5C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAsBzF,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,CAUrF;AAED,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAK9E"}

package/esm/utils/publisherPeriodV2.js

@@ -0,0 +1,34 @@
+// (C) 2026 GoodData Corporation
+const storedGranularities = {
+    SECOND: "GDC.time.second",
+    MINUTE: "GDC.time.minute",
+    HOUR: "GDC.time.hour",
+    DAY: "GDC.time.date",
+    WEEK_US: "GDC.time.week_us",
+    MONTH: "GDC.time.month",
+    QUARTER: "GDC.time.quarter",
+    YEAR: "GDC.time.year",
+    FISCAL_YEAR: "GDC.time.fiscal_year",
+    FISCAL_QUARTER: "GDC.time.fiscal_quarter",
+    FISCAL_MONTH: "GDC.time.fiscal_month",
+};
+const yamlGranularities = Object.fromEntries(Object.entries(storedGranularities).map(([yaml, stored]) => [stored, yaml]));
+/** @internal */
+export function periodToDeclarativeV2(period) {
+    if ("granularity" in period) {
+        return {
+            type: "relative",
+            granularity: storedGranularities[period.granularity],
+            from: period.from,
+            to: period.to,
+        };
+    }
+    return { type: "absolute", granularity: "GDC.time.date", from: period.from, to: period.to };
+}
+/** @internal */
+export function periodToYamlV2(period) {
+    if (period.type === "relative") {
+        return { granularity: yamlGranularities[period.granularity], from: period.from, to: period.to };
+    }
+    return { from: period.from, to: period.to };
+}

package/esm/utils/publisherVersionV2.d.ts

@@ -0,0 +1,9 @@
+import { type PublisherContentVersionV2 } from "@gooddata/sdk-model";
+import { type IErrorContext } from "./errors.js";
+/** @internal */
+export declare const publisherContentVersionV2: PublisherContentVersionV2;
+/** @internal */
+export declare function assertPublisherContentVersionV2({ version }: {
+    version: unknown;
+}, errorContext: IErrorContext | undefined): void;
+//# sourceMappingURL=publisherVersionV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisherVersionV2.d.ts","sourceRoot":"","sources":["../../src/utils/publisherVersionV2.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAiB,KAAK,aAAa,EAAgC,MAAM,aAAa,CAAC;AAE9F,gBAAgB;AAChB,eAAO,MAAM,yBAAyB,EAAE,yBAA+B,CAAC;AAExE,gBAAgB;AAChB,wBAAgB,+BAA+B,CAC3C,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EACjC,YAAY,EAAE,aAAa,GAAG,SAAS,GACxC,IAAI,CAQN"}

package/esm/utils/publisherVersionV2.js

@@ -0,0 +1,10 @@
+// (C) 2026 GoodData Corporation
+import { CoreErrorCode, newError, updateErrorContext } from "./errors.js";
+/** @internal */
+export const publisherContentVersionV2 = "2";
+/** @internal */
+export function assertPublisherContentVersionV2({ version }, errorContext) {
+    if (version !== publisherContentVersionV2) {
+        throw newError(CoreErrorCode.UnsupportedContentVersion, [String(version), publisherContentVersionV2], updateErrorContext(errorContext, { path: ["version"] }));
+    }
+}

package/esm/utils/texts.d.ts

@@ -10,4 +10,5 @@ export declare const PLUGIN_COMMENT: string;
 export declare const PUBLISHER_DOCUMENT_COMMENT: string;
 export declare const PUBLISHER_DOCUMENT_TEMPLATE_COMMENT: string;
 export declare const PUBLISHER_PAGE_LAYOUT_COMMENT: string;
+export declare const PUBLISHER_PAGE_TEMPLATE_COMMENT_V2: string;
 //# sourceMappingURL=texts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"texts.d.ts","sourceRoot":"","sources":["../../src/utils/texts.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,QAKhB,CAAC;AAEb,eAAO,MAAM,qBAAqB,QAKtB,CAAC;AAEb,eAAO,MAAM,0BAA0B,QAK3B,CAAC;AAEb,eAAO,MAAM,cAAc,QAKf,CAAC;AAEb,eAAO,MAAM,iBAAiB,QAKlB,CAAC;AAEb,eAAO,MAAM,qBAAqB,QAOtB,CAAC;AAEb,eAAO,MAAM,iBAAiB,QAKlB,CAAC;AAEb,eAAO,MAAM,2BAA2B,QAM5B,CAAC;AAEb,eAAO,MAAM,cAAc,QAKf,CAAC;AAEb,eAAO,MAAM,0BAA0B,QAI3B,CAAC;AAEb,eAAO,MAAM,mCAAmC,QAIpC,CAAC;AAEb,eAAO,MAAM,6BAA6B,QAI9B,CAAC"}
+{"version":3,"file":"texts.d.ts","sourceRoot":"","sources":["../../src/utils/texts.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,QAKhB,CAAC;AAEb,eAAO,MAAM,qBAAqB,QAKtB,CAAC;AAEb,eAAO,MAAM,0BAA0B,QAK3B,CAAC;AAEb,eAAO,MAAM,cAAc,QAKf,CAAC;AAEb,eAAO,MAAM,iBAAiB,QAKlB,CAAC;AAEb,eAAO,MAAM,qBAAqB,QAOtB,CAAC;AAEb,eAAO,MAAM,iBAAiB,QAKlB,CAAC;AAEb,eAAO,MAAM,2BAA2B,QAM5B,CAAC;AAEb,eAAO,MAAM,cAAc,QAKf,CAAC;AAEb,eAAO,MAAM,0BAA0B,QAI3B,CAAC;AAEb,eAAO,MAAM,mCAAmC,QAIpC,CAAC;AAEb,eAAO,MAAM,6BAA6B,QAI9B,CAAC;AAEb,eAAO,MAAM,kCAAkC,QAInC,CAAC"}

package/esm/utils/texts.js

@@ -71,3 +71,8 @@ export const PUBLISHER_PAGE_LAYOUT_COMMENT = [
     " It places what it draws in a tree of rows and columns, and a slot left",
     " empty here is one whatever uses the page is expected to fill.",
 ].join("\n");
+export const PUBLISHER_PAGE_TEMPLATE_COMMENT_V2 = [
+    " A page template is one page a document or a document template can copy.",
+    " It places widgets in a tree of rows and columns, and a widget left empty",
+    " here is one the document is expected to fill.",
+].join("\n");