@gooddata/code-cli 0.65.0-alpha.5 → 0.65.0-alpha.6

package/dist/index.js

@@ -37445,7 +37445,7 @@ function isPromise(value) {
 //#endregion
 //#region package.json
 var name$1 = "@gooddata/code-cli";
-var version$1 = "0.65.0-alpha.5";
+var version$1 = "0.65.0-alpha.6";
 //#endregion
 //#region ../../../common/temp/aac/node_modules/.pnpm/@gooddata+sdk-maql-language-server@file+..+..+..+sdk+libs+sdk-maql-language-server_debug@4.4.3/node_modules/@gooddata/sdk-maql-language-server/esm/docs/en/docs/create-metrics/maql/aggregation/approximate_count.js
 const content$65 = `# APPROXIMATE_COUNT
@@ -118137,7 +118137,7 @@ const _CONFIG$1 = {
 		common: {
 			"X-Requested-With": "XMLHttpRequest",
 			"X-GDC-JS-PACKAGE": "@gooddata/api-client-tiger",
-			"X-GDC-JS-PACKAGE-VERSION": "11.68.0-alpha.5"
+			"X-GDC-JS-PACKAGE-VERSION": "11.68.0-alpha.6"
 		},
 		post: { "Content-Type": "application/json;charset=utf8" },
 		put: { "Content-Type": "application/json;charset=utf8" }
@@ -162550,7 +162550,7 @@ const CoreErrorMessages$1 = {
 	[CoreErrorCode$1.DuplicateFilterName]: `Duplicate filter name "{0}". Each filter in a query must have a unique name, including the filters a date filter carries.`,
 	[CoreErrorCode$1.DuplicateLayerIdentifier]: `Duplicate layer id "{0}". Each layer of a visualisation must have a unique id.`,
 	[CoreErrorCode$1.DuplicateTabIdentifier]: `Duplicate tab identifier "{0}". Each tab must have a unique identifier within the dashboard.`,
-	[CoreErrorCode$1.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$1.TabsAndRootContentMutuallyExclusive]: `Dashboard "{0}" defines both "tabs" and root-level "sections", "filters" or "parameters". These are mutually exclusive — keep all content inside tabs or at the root, not both.`,
 	[CoreErrorCode$1.InvalidIanaTimezoneId]: `"{0}" is not a valid IANA timezone ID. Use a real timezone such as Europe/Prague or $browserDetected.`,
 	[CoreErrorCode$1.UnsupportedContentVersion]: `Expected "{0}", got {1}.`,
 	[CoreErrorCode$1.DateFilterWithoutDataSet]: `Date filter "{0}" names no date dataset. A document date filter must name the date dataset it applies to.`,
@@ -164419,7 +164419,10 @@ function declarativeDashboardToYaml(entities, dashboard, filterContexts, context
 	const shouldUseTabs = hasMultipleTabs || hasSingleTabWithTitle;
 	if (content.tabs && shouldUseTabs) {
 		if (content.tabs[0].layout?.configuration?.sections?.enableHeader) doc.add(entryWithSpace("enable_section_headers", content.tabs[0].layout?.configuration?.sections?.enableHeader));
-		const tabs = declarativeTabsToYaml(content.tabs, filterContexts, entities, updateErrorContext(errorContext, { path: ["tabs"] }));
+		const tabs = declarativeTabsToYaml(content.tabs, {
+			filterContexts,
+			rootParameters: content.parameters
+		}, entities, updateErrorContext(errorContext, { path: ["tabs"] }));
 		if (tabs) doc.add(entryWithSpace("tabs", tabs));
 	} else if (content.tabs?.length === 1) {
 		if (content.tabs[0].layout?.configuration?.sections?.enableHeader) doc.add(entryWithSpace("enable_section_headers", content.tabs[0].layout?.configuration?.sections?.enableHeader));
@@ -164431,6 +164434,12 @@ function declarativeDashboardToYaml(entities, dashboard, filterContexts, context
 		declarativeFiltersConfigToYaml$1(filtersMap, tab.dateFilterConfig, tab.dateFilterConfigs, tab.attributeFilterConfigs, tab.measureValueFilterConfigs, errorContext);
 		const groupedFilters = declarativeFilterGroupsToYaml(filters, tab.filterGroupsConfig);
 		if (groupedFilters.items.length > 0) doc.add(entryWithSpace("filters", groupedFilters));
+		const parameters = declarativeParametersToYaml(tabParameters(tab, content.tabs, content.parameters), updateErrorContext(errorContext, { path: [
+			"tabs",
+			"0",
+			"parameters"
+		] }));
+		if (parameters) doc.add(entryWithSpace("parameters", parameters));
 	} else {
 		if (content.layout?.configuration?.sections?.enableHeader) doc.add(entryWithSpace("enable_section_headers", content.layout?.configuration?.sections?.enableHeader));
 		const section = declarativeSectionsToYaml(content.layout, entities, updateErrorContext(errorContext, { path: ["layout"] }));
@@ -164439,6 +164448,8 @@ function declarativeDashboardToYaml(entities, dashboard, filterContexts, context
 		const { filters, filtersMap } = declarativeFilterContextToYaml(content.dateFilterConfig, filterContexts?.find((fc) => fc.id === filterContextId), updateErrorContext(errorContext, { path: ["dateFilterConfig"] }));
 		declarativeFiltersConfigToYaml$1(filtersMap, content.dateFilterConfig, content.dateFilterConfigs, content.attributeFilterConfigs, content.measureValueFilterConfigs, errorContext);
 		if (filters.items.length > 0) doc.add(entryWithSpace("filters", filters));
+		const parameters = declarativeParametersToYaml(content.parameters, updateErrorContext(errorContext, { path: ["parameters"] }));
+		if (parameters) doc.add(entryWithSpace("parameters", parameters));
 	}
 	const plugins = declarativePluginsToYaml(content, updateErrorContext(errorContext, { path: ["plugins"] }));
 	if (plugins) doc.add(entryWithSpace("plugins", plugins));
@@ -164450,7 +164461,8 @@ function declarativeDashboardToYaml(entities, dashboard, filterContexts, context
 	};
 }
 /** @internal */
-function declarativeTabsToYaml(tabs, filterContexts, entities, errorContext) {
+function declarativeTabsToYaml(tabs, dependencies = {}, entities, errorContext) {
+	const { filterContexts, rootParameters } = dependencies;
 	if (!tabs || tabs.length === 0) return;
 	const yamlTabs = new import_dist$5.YAMLSeq();
 	tabs.forEach((tab, ti) => {
@@ -164469,6 +164481,8 @@ function declarativeTabsToYaml(tabs, filterContexts, entities, errorContext) {
 			const groupedFilters = declarativeFilterGroupsToYaml(filters, tab.filterGroupsConfig);
 			if (groupedFilters.items.length > 0) yamlTab.add(new import_dist$5.Pair("filters", groupedFilters));
 		}
+		const parameters = declarativeParametersToYaml(tabParameters(tab, tabs, rootParameters), updateErrorContext(tabErrorContext, { path: ["parameters"] }));
+		if (parameters) yamlTab.add(new import_dist$5.Pair("parameters", parameters));
 		if (tab.layout) {
 			const sections = declarativeSectionsToYaml({ layout: tab.layout }.layout, entities, updateErrorContext(tabErrorContext, { path: ["layout"] }));
 			if (sections) yamlTab.add(new import_dist$5.Pair("sections", sections));
@@ -164987,6 +165001,28 @@ function getFilterGroupIdBase({ title, localIdentifier }) {
 	if (localIdentifier) return localIdentifier;
 	return title.normalize().replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
 }
+/**
+* The parameters a tab shows: its own list, or the legacy root list when no tab has one.
+* Mirrors `pickTabParametersSource` in sdk-ui-dashboard, which this package cannot import.
+*/
+function tabParameters(tab, allTabs, rootParameters) {
+	if (tab.parameters !== void 0) return tab.parameters;
+	return allTabs.every((other) => other.parameters === void 0) ? rootParameters : void 0;
+}
+function declarativeParametersToYaml(parameters, errorContext) {
+	if (!parameters?.length) return;
+	const yamlParameters = new import_dist$5.YAMLSeq();
+	parameters.forEach((parameter, i) => {
+		yamlParameters.add({
+			id: getIdentifier(parameter.ref, true, updateErrorContext(errorContext, { path: [i.toString()] })),
+			type: parameter.parameterType,
+			...parameter.value === void 0 ? {} : { value: parameter.value },
+			...parameter.label === void 0 ? {} : { title: parameter.label },
+			...parameter.mode && parameter.mode !== "active" ? { mode: parameter.mode } : {}
+		});
+	});
+	return yamlParameters;
+}
 /** @internal */
 function declarativePluginsToYaml(dashboard, errorContext) {
 	if (!dashboard.plugins?.length) return;
@@ -165043,7 +165079,8 @@ function yamlTabsToDeclarative(entities, tabs, enableSectionHeaders) {
 			dateFilterConfigs,
 			attributeFilterConfigs,
 			measureValueFilterConfigs,
-			...filterGroupsConfig ? { filterGroupsConfig } : {}
+			...filterGroupsConfig ? { filterGroupsConfig } : {},
+			...tab.parameters?.length ? { parameters: yamlParametersToDeclarative(tab.parameters) } : {}
 		});
 	});
 	return {
@@ -165066,6 +165103,7 @@ function processDashboardWithTabsV2(entities, input) {
 		dateFilterConfigs: defaultTab.dateFilterConfigs,
 		attributeFilterConfigs: defaultTab.attributeFilterConfigs,
 		measureValueFilterConfigs: defaultTab.measureValueFilterConfigs,
+		parameters: defaultTab.parameters,
 		tabs: tabsResult.tabs,
 		tabFilterContexts: tabsResult.filterContexts
 	};
@@ -165082,6 +165120,7 @@ function processDashboardWithoutTabsV2(entities, input) {
 			id: "defaultTabId",
 			title: "",
 			filters: input.filters,
+			parameters: input.parameters,
 			sections: input.sections ?? []
 		}]
 	});
@@ -165114,6 +165153,7 @@ function processDashboardWithTabsV3(entities, input) {
 		dateFilterConfigs: void 0,
 		attributeFilterConfigs: void 0,
 		measureValueFilterConfigs: void 0,
+		parameters: void 0,
 		tabs: tabsResult.tabs,
 		tabFilterContexts: tabsResult.filterContexts
 	};
@@ -165127,6 +165167,7 @@ function processDashboardWithoutTabsV3(entities, input) {
 		id: "defaultTabId",
 		title: "",
 		filters: input.filters,
+		parameters: input.parameters,
 		sections: input.sections ?? []
 	}], input.enable_section_headers);
 	return {
@@ -165136,6 +165177,7 @@ function processDashboardWithoutTabsV3(entities, input) {
 		dateFilterConfigs: void 0,
 		attributeFilterConfigs: void 0,
 		measureValueFilterConfigs: void 0,
+		parameters: void 0,
 		tabs: tabsResult.tabs,
 		tabFilterContexts: tabsResult.filterContexts
 	};
@@ -165143,10 +165185,10 @@ function processDashboardWithoutTabsV3(entities, input) {
 /** @public */
 function yamlDashboardToDeclarative(entities, input) {
 	const hasTabs = Boolean(input.tabs && input.tabs.length > 0);
-	const hasRootContent = Boolean(input.sections && input.sections.length > 0 || input.filters && Object.keys(input.filters).length > 0);
+	const hasRootContent = Boolean(input.sections && input.sections.length > 0 || input.filters && Object.keys(input.filters).length > 0 || input.parameters && input.parameters.length > 0);
 	if (hasTabs && hasRootContent) throw newError$1(CoreErrorCode$1.TabsAndRootContentMutuallyExclusive, [input.id]);
 	const yamlVersion = input.version ?? "2";
-	const { layout, filterContext, dateFilterConfig, dateFilterConfigs, attributeFilterConfigs, measureValueFilterConfigs, tabs, tabFilterContexts } = yamlVersion === "3" ? hasTabs ? processDashboardWithTabsV3(entities, input) : processDashboardWithoutTabsV3(entities, input) : hasTabs ? processDashboardWithTabsV2(entities, input) : processDashboardWithoutTabsV2(entities, input);
+	const { layout, filterContext, dateFilterConfig, dateFilterConfigs, attributeFilterConfigs, measureValueFilterConfigs, parameters, tabs, tabFilterContexts } = yamlVersion === "3" ? hasTabs ? processDashboardWithTabsV3(entities, input) : processDashboardWithoutTabsV3(entities, input) : hasTabs ? processDashboardWithTabsV2(entities, input) : processDashboardWithoutTabsV2(entities, input);
 	const plugins = yamlPluginsToDeclarative(input.plugins);
 	const timezoneConfig = yamlTimezoneConfigToDeclarative(input.timezone_config);
 	const [, permissions] = toDeclarativePermissions(input.permissions);
@@ -165168,6 +165210,7 @@ function yamlDashboardToDeclarative(entities, input) {
 		measureValueFilterConfigs,
 		dateFilterConfig,
 		dateFilterConfigs,
+		...parameters ? { parameters } : {},
 		...timezoneConfig ? { timezoneConfig } : {},
 		...tabs ? { tabs } : {},
 		...input.cross_filtering === false ? { disableCrossFiltering: true } : {},
@@ -165435,6 +165478,15 @@ function yamlIgnoredFilterToDeclarative(input) {
 	};
 	return null;
 }
+function yamlParametersToDeclarative(parameters) {
+	return parameters.map((parameter) => ({
+		ref: createIdentifier(parameter.id, { forceType: "parameter" }),
+		parameterType: parameter.type,
+		...parameter.value === void 0 ? {} : { value: parameter.value },
+		...parameter.title === void 0 ? {} : { label: parameter.title },
+		...parameter.mode && parameter.mode !== "active" ? { mode: parameter.mode } : {}
+	}));
+}
 /** @internal */
 function yamlPluginsToDeclarative(plugins) {
 	return plugins?.map((plugin) => yamlPluginToDeclarative$1(plugin));
@@ -189932,6 +189984,7 @@ function resolveDashboardReferences(item) {
 		...resolveSectionsReferences(item.sections),
 		...resolveFiltersReferences$1(item.filters),
 		...resolvePluginsReferences(item.plugins),
+		...resolveParametersReferences(item.parameters),
 		...resolveTabsReferences(item.tabs)
 	];
 }
@@ -189940,6 +189993,7 @@ function resolveTabsReferences(tabs) {
 	if (tabs && Array.isArray(tabs)) tabs.forEach((tab) => {
 		references.push(...resolveSectionsReferences(tab.sections));
 		references.push(...resolveFiltersReferences$1(tab.filters));
+		references.push(...resolveParametersReferences(tab.parameters));
 	});
 	return references;
 }
@@ -190014,6 +190068,13 @@ function resolveFiltersReferences$1(filters) {
 	});
 	return references;
 }
+function resolveParametersReferences(parameters) {
+	const references = [];
+	if (parameters && Array.isArray(parameters)) parameters.forEach((parameter) => {
+		if (parameter && typeof parameter === "object" && typeof parameter.id === "string") references.push(createReferenceObject(parameter.id, "parameter"));
+	});
+	return references;
+}
 function resolvePluginsReferences(plugins) {
 	const references = [];
 	if (plugins && Array.isArray(plugins)) plugins.forEach((plugin) => {
@@ -193691,7 +193752,7 @@ const metadata_v1 = {
 				"version": {
 					"type": "string",
 					"enum": ["2", "3"],
-					"description": "Dashboard model version. \"2\" (default if omitted) — legacy shape: root-level sections/filters are also mirrored into a default tab, producing a declarative model with duplicated content for backward compatibility with older SDK readers. \"3\" — clean shape: tabs are the sole source of layout and filters; root sections/filters in YAML are still allowed as an authoring shortcut but are wrapped into a single synthetic tab without duplication. Use \"3\" for new dashboards; \"2\" exists to keep existing files round-trippable."
+					"description": "Dashboard model version. \"2\" (default if omitted) — legacy shape: root-level sections/filters/parameters are also mirrored into a default tab, producing a declarative model with duplicated content for backward compatibility with older SDK readers. \"3\" — clean shape: tabs are the sole source of layout, filters and parameters; root sections/filters/parameters in YAML are still allowed as an authoring shortcut but are wrapped into a single synthetic tab without duplication. Use \"3\" for new dashboards; \"2\" exists to keep existing files round-trippable."
 				},
 				"title": {
 					"$ref": "#/$global/gaac/title",
@@ -193779,9 +193840,13 @@ const metadata_v1 = {
 						}
 					}] }
 				},
+				"parameters": {
+					"$ref": "#/$defs/dashboardParameters",
+					"description": "Parameters shown in the filter bar of this dashboard."
+				},
 				"tabs": {
 					"type": "array",
-					"description": "A list of tabs in this dashboard. Each tab has its own layout, filters, and filter configurations. Mutually exclusive with sections and filters at dashboard level.",
+					"description": "A list of tabs in this dashboard. Each tab has its own layout, filters, parameters, and filter configurations. Mutually exclusive with sections, filters and parameters at dashboard level.",
 					"items": { "$ref": "#/$defs/tab" },
 					"$semantic": { "type": "unique_tab_identifiers" }
 				},
@@ -200689,7 +200754,7 @@ const metadata_v1 = {
 				"version": {
 					"type": "string",
 					"enum": ["2", "3"],
-					"description": "Dashboard model version. \"2\" (default if omitted) — legacy shape: root-level sections/filters are also mirrored into a default tab, producing a declarative model with duplicated content for backward compatibility with older SDK readers. \"3\" — clean shape: tabs are the sole source of layout and filters; root sections/filters in YAML are still allowed as an authoring shortcut but are wrapped into a single synthetic tab without duplication. Use \"3\" for new dashboards; \"2\" exists to keep existing files round-trippable."
+					"description": "Dashboard model version. \"2\" (default if omitted) — legacy shape: root-level sections/filters/parameters are also mirrored into a default tab, producing a declarative model with duplicated content for backward compatibility with older SDK readers. \"3\" — clean shape: tabs are the sole source of layout, filters and parameters; root sections/filters/parameters in YAML are still allowed as an authoring shortcut but are wrapped into a single synthetic tab without duplication. Use \"3\" for new dashboards; \"2\" exists to keep existing files round-trippable."
 				},
 				"title": {
 					"$ref": "#/$global/gaac/title",
@@ -200777,9 +200842,13 @@ const metadata_v1 = {
 						}
 					}] }
 				},
+				"parameters": {
+					"$ref": "#/$defs/dashboardParameters",
+					"description": "Parameters shown in the filter bar of this dashboard."
+				},
 				"tabs": {
 					"type": "array",
-					"description": "A list of tabs in this dashboard. Each tab has its own layout, filters, and filter configurations. Mutually exclusive with sections and filters at dashboard level.",
+					"description": "A list of tabs in this dashboard. Each tab has its own layout, filters, parameters, and filter configurations. Mutually exclusive with sections, filters and parameters at dashboard level.",
 					"items": { "$ref": "#/$defs/tab" },
 					"$semantic": { "type": "unique_tab_identifiers" }
 				},
@@ -200834,6 +200903,44 @@ const metadata_v1 = {
 			},
 			"required": ["widgets"]
 		},
+		"dashboardParameters": {
+			"type": "array",
+			"items": {
+				"title": "Dashboard Parameter",
+				"description": "A parameter shown in the filter bar: its value must have the parameter's type.",
+				"allOf": [{
+					"if": {
+						"properties": { "type": { "const": "STRING" } },
+						"required": ["type"]
+					},
+					"then": { "$ref": "#/$defs/stringDashboardParameter" }
+				}, {
+					"if": {
+						"properties": { "type": { "const": "NUMBER" } },
+						"required": ["type"]
+					},
+					"then": { "$ref": "#/$defs/numberDashboardParameter" }
+				}],
+				"properties": {
+					"id": {
+						"description": "An identifier of the parameter.",
+						"$semantic": {
+							"type": "reference",
+							"source": "parameter.id"
+						}
+					},
+					"type": {
+						"type": "string",
+						"enum": ["STRING", "NUMBER"],
+						"description": "The data type of the parameter. Must match the type in the parameter definition."
+					},
+					"value": { "description": "The value this dashboard uses instead of the parameter's default value." },
+					"title": { "description": "The label shown in the filter bar instead of the parameter's title." },
+					"mode": { "description": "Setting parameter mode to readonly will disable the parameter. Setting it to hidden will hide the parameter from the dashboard. Setting it to active will enable the parameter." }
+				},
+				"required": ["id", "type"]
+			}
+		},
 		"tab": {
 			"type": "object",
 			"additionalProperties": false,
@@ -200855,6 +200962,10 @@ const metadata_v1 = {
 					"description": "Filters specific to this tab.",
 					"$semantic": { "type": "unique_filter_local_identifiers" }
 				},
+				"parameters": {
+					"$ref": "#/$defs/dashboardParameters",
+					"description": "Parameters shown in the filter bar of this tab."
+				},
 				"sections": {
 					"type": "array",
 					"description": "A list of sections in this tab.",
@@ -200867,6 +200978,72 @@ const metadata_v1 = {
 				"sections"
 			]
 		},
+		"stringDashboardParameter": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"$ref": "#/$global/gaac/identifier",
+					"description": "An identifier of the parameter."
+				},
+				"type": {
+					"type": "string",
+					"enum": ["STRING"],
+					"description": "The data type of the parameter. Must match the type in the parameter definition."
+				},
+				"value": {
+					"type": "string",
+					"description": "The value this dashboard uses instead of the parameter's default value."
+				},
+				"title": {
+					"$ref": "#/$global/gaac/title",
+					"description": "The label shown in the filter bar instead of the parameter's title."
+				},
+				"mode": {
+					"type": "string",
+					"enum": [
+						"readonly",
+						"hidden",
+						"active"
+					],
+					"description": "Setting parameter mode to readonly will disable the parameter. Setting it to hidden will hide the parameter from the dashboard. Setting it to active will enable the parameter."
+				}
+			},
+			"required": ["id", "type"]
+		},
+		"numberDashboardParameter": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"$ref": "#/$global/gaac/identifier",
+					"description": "An identifier of the parameter."
+				},
+				"type": {
+					"type": "string",
+					"enum": ["NUMBER"],
+					"description": "The data type of the parameter. Must match the type in the parameter definition."
+				},
+				"value": {
+					"type": "number",
+					"description": "The value this dashboard uses instead of the parameter's default value."
+				},
+				"title": {
+					"$ref": "#/$global/gaac/title",
+					"description": "The label shown in the filter bar instead of the parameter's title."
+				},
+				"mode": {
+					"type": "string",
+					"enum": [
+						"readonly",
+						"hidden",
+						"active"
+					],
+					"description": "Setting parameter mode to readonly will disable the parameter. Setting it to hidden will hide the parameter from the dashboard. Setting it to active will enable the parameter."
+				}
+			},
+			"required": ["id", "type"]
+		},
 		"timezoneId": {
 			"description": "An IANA timezone ID (for example, Europe/Prague or UTC) or $browserDetected to use the viewer browser timezone.",
 			"oneOf": [{
@@ -210329,7 +210506,7 @@ async function open(state, emitter, file) {
 //#endregion
 //#region ../code/package.json
 var name = "@gooddata/code";
-var version = "0.65.0-alpha.5";
+var version = "0.65.0-alpha.6";
 //#endregion
 //#region ../code/esm/services/server/client.js
 function getApiClient$1(profile, { packageName, packageVersion }) {
@@ -237791,7 +237968,7 @@ const _CONFIG = {
 		common: {
 			"X-Requested-With": "XMLHttpRequest",
 			"X-GDC-JS-PACKAGE": "@gooddata/api-client-tiger",
-			"X-GDC-JS-PACKAGE-VERSION": "11.68.0-alpha.5"
+			"X-GDC-JS-PACKAGE-VERSION": "11.68.0-alpha.6"
 		},
 		post: { "Content-Type": "application/json;charset=utf8" },
 		put: { "Content-Type": "application/json;charset=utf8" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/code-cli",
-  "version": "0.65.0-alpha.5",
+  "version": "0.65.0-alpha.6",
   "description": "GoodData CLI",
   "keywords": [
     "analytics",