@gooddata/code-cli 0.50.0-alpha.0 → 0.50.0-alpha.1

package/dist/fixtures/rules/gooddata.mdc

@@ -15,6 +15,7 @@ GoodData Analytics as Code allows you to represent metadata for analytical works
 - **Attribute label** is a non-numeric field in a dataset. It is always linked to an attribute.
 - **Date instance** (Date Dataset) is a representation of a date dimension.
 - **Metric** is an aggregation on top of facts and attribute labels. A single number that can be sliced ad-hoc when building a visualization.
+- **Parameter** is a named, typed value that metrics reference instead of hardcoding a literal. Changing the parameter's default changes every metric that references it. Textual parameters can be defined as code.
 - **Multidimensional Analytical Query Language (MAQL)** a proprietary language used by GoodData for metrics definition.
 - **Semantic Layer** is LDM and Metrics combined.
 - **Visualization** - a data visualization built on top of Semantic Layer. I.e. a chart, graph or a table.
@@ -35,5 +36,6 @@ A typical folder structure for GoodData analytics project looks like this:
 - `{{ANALYTICS}}` - the root folder for the project
 - `{{ANALYTICS}}/datasets` - a folder with all datasets and date instances
 - `{{ANALYTICS}}/metrics` - a folder with all metrics
+- `{{ANALYTICS}}/parameters` - a folder with all parameters
 - `{{ANALYTICS}}/visualisations` - a folder with all visualizations
 - `{{ANALYTICS}}/dashboards` - a folder with all dashboards

package/dist/fixtures/rules/parameters.mdc

@@ -0,0 +1,40 @@
+---
+description: Detailed information about GoodData parameters definition.
+alwaysApply: false
+---
+# Fields
+
+On top of generic fields like `id`, `type` (always "parameter"), `title`, `description` and `tags`,
+parameters support:
+- `definition`: (object, required) the typed definition of the parameter.
+
+# Definition
+
+- `type`: (string, required) always "STRING". Only textual parameters can be defined as code.
+- `defaultValue`: (string, required) the value used whenever the parameter is not overridden.
+- `constraints`: (object) optional restrictions on the accepted values.
+
+`constraints` accepts `minLength` and `maxLength` (both inclusive), or `allowedValues` - a non-empty
+list of `{ value, title }` entries where `title` is optional and defaults to `value`. Length bounds
+and `allowedValues` are mutually exclusive. Without `constraints`, the parameter accepts any
+free-text value.
+
+# Example
+
+```yaml
+id: scenario
+type: parameter
+
+title: Scenario
+description: Selects the planning scenario used in metric computation.
+
+definition:
+    type: STRING
+    defaultValue: Actual
+```
+
+# Usage
+
+Metrics reference a parameter instead of hardcoding a literal, so changing the parameter's default
+changes every metric that references it. A parameter cannot be deleted while a metric still
+references it - remove the references first.

package/dist/index.js

@@ -37370,7 +37370,7 @@ function isPromise(value) {
 //#endregion
 //#region package.json
 var name$1 = "@gooddata/code-cli";
-var version$1 = "0.50.0-alpha.0";
+var version$1 = "0.50.0-alpha.1";
 //#endregion
 //#region ../../../common/temp/aac/node_modules/.pnpm/vscode-languageserver@8.1.0/node_modules/vscode-languageserver/lib/common/utils/is.js
 var require_is$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -102866,6 +102866,7 @@ var SpecificCoreErrorCode;
 (function(SpecificCoreErrorCode) {
 	SpecificCoreErrorCode["UniquenessDatasetsId"] = "core.uniqueness.datasets.id";
 	SpecificCoreErrorCode["UniquenessMetricsId"] = "core.uniqueness.metrics.id";
+	SpecificCoreErrorCode["UniquenessParametersId"] = "core.uniqueness.parameters.id";
 	SpecificCoreErrorCode["UniquenessVisualisationsId"] = "core.uniqueness.visualisations.id";
 	SpecificCoreErrorCode["UniquenessDashboardsId"] = "core.uniqueness.dashboards.id";
 	SpecificCoreErrorCode["UniquenessPluginId"] = "core.uniqueness.plugins.id";
@@ -103009,6 +103010,7 @@ const CoreErrorMessages$1 = {
 	[CoreErrorCode.SqlIsNotRefreshedFromServer]: `SQL statement not loaded from server and need to be refreshed. Use "Run" button over the SQL statement to force retrieve new definition.`,
 	[SpecificCoreErrorCode.UniquenessDatasetsId]: `There are more datasets with id "{0}". Use unique names for datasets.`,
 	[SpecificCoreErrorCode.UniquenessMetricsId]: `There are more metrics with id "{0}". Use unique names for metrics.`,
+	[SpecificCoreErrorCode.UniquenessParametersId]: `There are more parameters with id "{0}". Use unique names for parameters.`,
 	[SpecificCoreErrorCode.UniquenessVisualisationsId]: `There are more visualisations with id "{0}". Use unique names for visualisations.`,
 	[SpecificCoreErrorCode.UniquenessDashboardsId]: `There are more dashboards with id "{0}". Use unique names for dashboards.`,
 	[SpecificCoreErrorCode.UniquenessPluginId]: `There are more plugins with id "{0}". Use unique names for plugins.`,
@@ -103085,6 +103087,7 @@ const CoreErrorTypes$1 = {
 	[CoreErrorCode.MissingDataSourceId]: "MissingDataSourceId",
 	[SpecificCoreErrorCode.UniquenessDatasetsId]: "UniquenessDatasetsId",
 	[SpecificCoreErrorCode.UniquenessMetricsId]: "UniquenessMetricsId",
+	[SpecificCoreErrorCode.UniquenessParametersId]: "UniquenessParametersId",
 	[SpecificCoreErrorCode.UniquenessPluginId]: "UniquenessPluginId",
 	[SpecificCoreErrorCode.UniquenessAttributeHierarchyId]: "UniquenessAttributeHierarchyId",
 	[SpecificCoreErrorCode.UniquenessDashboardWidgetLocalId]: "UniquenessDashboardWidgetLocalId",
@@ -106494,10 +106497,14 @@ const SupportedReferenceTypes$1 = [
 	"dataset",
 	"attribute"
 ];
-function parseReferenceObject$1(obj) {
+/** MAQL can additionally name a parameter; custom URLs and shorthand fields cannot. */
+const SupportedMaqlReferenceTypes = [...SupportedReferenceTypes$1, "parameter"];
+/** The id fragment of a `type/id` reference, shared by every pattern that matches one. */
+const REFERENCE_ID_PATTERN = "(?!\\.)[.A-Za-z0-9_-]{1,255}";
+function parseReferenceObject$1(obj, supported = SupportedReferenceTypes$1) {
 	const [t, identifier] = obj?.split("/") ?? [];
 	const type = t;
-	if (Boolean(type && identifier) && SupportedReferenceTypes$1.includes(type)) return {
+	if (Boolean(type && identifier) && supported.includes(type)) return {
 		identifier,
 		type
 	};
@@ -106572,6 +106579,7 @@ function referencePathResolve(obj, { resolved, match }) {
 const DatasetTypes$2 = ["dataset"];
 const DateDatasetTypes$2 = ["date"];
 const MetricTypes$1 = ["metric"];
+const ParameterTypes$1 = ["parameter"];
 const AttrTypes$1 = ["attribute"];
 const FactTypes$1 = ["fact"];
 const AggregatedFactTypes = ["aggregated_fact"];
@@ -106611,6 +106619,7 @@ const TypesAll = allReferenceTypes([
 	"date",
 	"dataset",
 	"metric",
+	"parameter",
 	"area_chart",
 	"bubble_chart",
 	"bar_chart",
@@ -106668,6 +106677,10 @@ function isMetric(obj) {
 	if (typeof obj === "object" && obj && "id" in obj && "type" in obj) return MetricTypes$1.includes(obj.type);
 	return false;
 }
+function isParameter(obj) {
+	if (typeof obj === "object" && obj && "id" in obj && "type" in obj) return ParameterTypes$1.includes(obj.type);
+	return false;
+}
 function isManifest(obj) {
 	return !!(typeof obj === "object" && obj && "profiles" in obj && "source_dir" in obj);
 }
@@ -135273,6 +135286,51 @@ function yamlMetricToDeclarative(input) {
 	return output;
 }
 //#endregion
+//#region ../../../sdk/libs/sdk-code-convertors/src/utils/parameterUtils.ts
+/** @public */
+function isDeclarativeStringParameter(parameter) {
+	return parameter.content.type === "STRING";
+}
+/**
+* Spreadable `constraints` entry for a parameter definition: present only when at least one
+* restriction is set, and never carrying a key whose value is undefined.
+*/
+function optionalConstraints(constraints) {
+	const defined = Object.fromEntries(Object.entries(constraints).filter(([, value]) => value !== void 0));
+	return Object.keys(defined).length === 0 ? {} : { constraints: defined };
+}
+/** An allowed value as authored: `title` is optional and defaults to `value`, so it is only carried when set. */
+function toAllowedValue({ value, title }) {
+	return title === void 0 ? { value } : {
+		value,
+		title
+	};
+}
+//#endregion
+//#region ../../../sdk/libs/sdk-code-convertors/src/to/yamlParameterToDeclarative.ts
+/** @public */
+function yamlParameterToDeclarative(input) {
+	return {
+		id: input.id,
+		title: input.title ?? convertIdToTitle$1(input.id),
+		description: input.description ?? "",
+		tags: input.tags ?? [],
+		content: yamlParameterDefinitionToDeclarative(input.definition)
+	};
+}
+function yamlParameterDefinitionToDeclarative(definition) {
+	const { minLength, maxLength, allowedValues } = definition.constraints ?? {};
+	return {
+		type: "STRING",
+		defaultValue: definition.defaultValue,
+		...optionalConstraints({
+			minLength,
+			maxLength,
+			allowedValues: allowedValues?.length ? allowedValues.map(toAllowedValue) : void 0
+		})
+	};
+}
+//#endregion
 //#region ../../../sdk/libs/sdk-code-convertors/src/configs/utils.ts
 /** @public */
 function getValueOrDefault(value, defaultValue, type = "string", undefinedAsDefault = false) {
@@ -140179,6 +140237,8 @@ const DateDatasetTypes = ["date"];
 /** @internal */
 const MetricTypes = ["metric"];
 /** @internal */
+const ParameterTypes = ["parameter"];
+/** @internal */
 const DashboardTypes = ["dashboard"];
 /** @internal */
 const PluginTypes = ["plugin"];
@@ -140215,6 +140275,7 @@ const AllTypes = [
 	...DatasetTypes,
 	...DateDatasetTypes,
 	...MetricTypes,
+	...ParameterTypes,
 	...DashboardTypes,
 	...PluginTypes,
 	...VisualisationsTypes,
@@ -140741,7 +140802,7 @@ function yamlTimezoneConfigToDeclarative(input) {
 	return {
 		...input.timezone_id ? { timezoneId: input.timezone_id } : {},
 		...input.show_timezone_info ? { showTimezoneInfo: input.show_timezone_info } : {},
-		...typeof input.allow_user_override_in_view_mode === "boolean" ? { allowUserOverrideInViewMode: input.allow_user_override_in_view_mode } : {}
+		...input.allow_user_override_in_view_mode ? { allowUserOverrideInViewMode: input.allow_user_override_in_view_mode } : {}
 	};
 }
 function isFilterGroup$1(filter) {
@@ -141028,6 +141089,12 @@ const METRIC_COMMENT = [
 	" Read more about MAQL:",
 	" https://www.gooddata.com/developers/cloud-native/doc/cloud/create-metrics/maql/"
 ].join("\n");
+const PARAMETER_COMMENT = [
+	" A parameter is a named, typed value that metrics reference instead of hardcoding a literal.",
+	" Changing the parameter's default changes every metric that references it, without editing their MAQL.",
+	" Read more about parameters:",
+	" https://www.gooddata.ai/docs/cloud/experimental-features/numeric-parameters/"
+].join("\n");
 const VISUALISATION_COMMENT = [
 	" A visualization is a visual representation of a user's analytical view of the data.",
 	" You build visualizations from metrics, attributes, and optionally filters that are combined in a way to visualize a particular aspect of your data.",
@@ -141241,6 +141308,35 @@ function declarativeMetricToYaml(metric) {
 	};
 }
 //#endregion
+//#region ../../../sdk/libs/sdk-code-convertors/src/from/declarativeParameterToYaml.ts
+/** @public */
+function declarativeParameterToYaml(parameter) {
+	const doc = new import_dist.Document({
+		type: "parameter",
+		id: parameter.id
+	});
+	doc.commentBefore = PARAMETER_COMMENT;
+	fillOptionalMetaFields(doc, parameter);
+	doc.add(entryWithSpace("definition", doc.createNode(declarativeParameterDefinitionToYaml(parameter.content))));
+	return {
+		content: doc.toString({ lineWidth: 0 }),
+		json: doc.toJSON()
+	};
+}
+function declarativeParameterDefinitionToYaml(definition) {
+	const { minLength, maxLength, allowedValues } = definition.constraints ?? {};
+	const [first, ...rest] = allowedValues ?? [];
+	return {
+		type: "STRING",
+		defaultValue: definition.defaultValue,
+		...optionalConstraints({
+			minLength,
+			maxLength,
+			allowedValues: first ? [toAllowedValue(first), ...rest.map(toAllowedValue)] : void 0
+		})
+	};
+}
+//#endregion
 //#region ../../../sdk/libs/sdk-code-convertors/src/from/filtersToYaml.ts
 function detectEmptyValuesFilterType(filter) {
 	const attributeElements = filterAttributeElements(filter);
@@ -142578,7 +142674,7 @@ function declarativeTimezoneConfigToYaml(config) {
 	return {
 		...config.timezoneId ? { timezone_id: config.timezoneId } : {},
 		...config.showTimezoneInfo ? { show_timezone_info: config.showTimezoneInfo } : { show_timezone_info: false },
-		...typeof config.allowUserOverrideInViewMode === "boolean" ? { allow_user_override_in_view_mode: config.allowUserOverrideInViewMode } : {}
+		...config.allowUserOverrideInViewMode ? { allow_user_override_in_view_mode: config.allowUserOverrideInViewMode } : { allow_user_override_in_view_mode: false }
 	};
 }
 function declarativeVisualizationSwitcherWidgetToYaml(widget, size, entities, errorContext) {
@@ -143608,7 +143704,7 @@ function resolveAttributeHierarchyReferences(item) {
 }
 //#endregion
 //#region ../code/esm/features/references/resolve/metric.js
-const ID_PATTERN = /(fact|label|metric|dataset|attribute)\/((?!\.)[.A-Za-z0-9_-]{1,255})/g;
+const ID_PATTERN = new RegExp(`(${SupportedMaqlReferenceTypes.join("|")})\\/(${REFERENCE_ID_PATTERN})`, "g");
 function resolveMetricReferences(item) {
 	return resolveMaqlReferences(item.maql ?? "");
 }
@@ -143867,6 +143963,7 @@ function containsReference(item, ref) {
 		...isDashboard(item) ? [createReferenceObject(item.id, "dashboard")] : [],
 		...isPlugin(item) ? [createReferenceObject(item.id, "plugin")] : [],
 		...isMetric(item) ? [createReferenceObject(item.id, "metric")] : [],
+		...isParameter(item) ? [createReferenceObject(item.id, "parameter")] : [],
 		...isAttributeHierarchy(item) ? [createReferenceObject(item.id, "attribute_hierarchy")] : []
 	].some((item) => item.type === ref.type && item.identifier === ref.identifier);
 }
@@ -143876,7 +143973,8 @@ function collectItemReferences(item) {
 		case "date": return resolveDatasetReferences$1(item);
 		case "metric": return resolveMetricReferences(item);
 		case "dashboard": return resolveDashboardReferences(item);
-		case "plugin": return [];
+		case "plugin":
+		case "parameter": return [];
 		case "table":
 		case "bar_chart":
 		case "column_chart":
@@ -144155,18 +144253,20 @@ function convertDateTitle(item, gran) {
 //#endregion
 //#region ../code/esm/features/references/resolve/objects.js
 function resolveLdmObjects(files) {
-	const { metrics, datasets, dates } = files.reduce((prev, item) => {
+	const { metrics, parameters, datasets, dates } = files.reduce((prev, item) => {
 		if (isDataset$1(item)) prev.datasets.push(buildDataset(item));
 		if (isDateDataset$1(item)) prev.dates.push(buildDate(item));
 		if (isMetric(item)) prev.metrics.push(buildMetric(item));
+		if (isParameter(item)) prev.parameters.push(buildParameter(item));
 		return prev;
 	}, {
 		metrics: [],
+		parameters: [],
 		dates: [],
 		datasets: []
 	});
 	const { attributes, facts } = extractFromDatasets(datasets);
-	return new LdmObjects(attributes, facts, metrics, [], dates, datasets);
+	return new LdmObjects(attributes, facts, metrics, parameters, dates, datasets);
 }
 function extractFromDatasets(datasets) {
 	const attributes = [];
@@ -144291,6 +144391,19 @@ function buildMetric(item) {
 		groups: []
 	};
 }
+function buildParameter(item) {
+	return {
+		type: "parameter",
+		...buildUriRef("parameter", item.id),
+		id: item.id,
+		description: item.description ?? "",
+		title: item.title ?? convertIdToTitle(item.id),
+		definition: item.definition,
+		production: true,
+		deprecated: false,
+		unlisted: false
+	};
+}
 function buildDate(item) {
 	return {
 		type: "dateDataset",
@@ -145658,6 +145771,15 @@ function resolveReferencesByObjectSource(references, source, opts) {
 				remote: false
 			};
 		}
+		case "parameter.id": {
+			const [available, diagnostics] = resolveReferencesIds(references, ["parameter"]);
+			return {
+				available: withPrefix(isParameter(references.self) ? available.filter(filterBySelf(references.self?.id)) : available, "parameter", opts.typePrefix),
+				ambiguous: getAmbiguous(available),
+				diagnostics,
+				remote: false
+			};
+		}
 		case "dataset.field": {
 			const [available, diagnostics] = resolveFieldsIds(references, ["dataset"]);
 			return {
@@ -146109,62 +146231,22 @@ function getAffectedFiles(file, before, after) {
 //#region ../code/esm/features/references/update/objects.js
 function addObjectReferences(state, file, fileMode, json) {
 	const refs = state.references;
-	if (isDataset$1(json)) {
-		const dataset = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, dataset]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, dataset]);
-		});
-	}
-	if (isDateDataset$1(json)) {
-		const dataset = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, dataset]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, dataset]);
-		});
-	}
-	if (isMetric(json)) {
-		const metric = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, metric]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, metric]);
-		});
-	}
-	if (isVisualisation(json)) {
-		const visualisation = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, visualisation]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, visualisation]);
-		});
-	}
-	if (isDashboard(json)) {
-		const dashboard = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, dashboard]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, dashboard]);
-		});
-	}
-	if (isPlugin(json)) {
-		const plugin = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, plugin]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, plugin]);
-		});
-	}
-	if (isAttributeHierarchy(json)) {
-		const hierarchy = buildObj(file, json);
-		handleType(fileMode, () => {
-			updateVirtual(state, [...refs.virtual, hierarchy]);
-		}, () => {
-			updatePhysical(state, [...refs.physical, hierarchy]);
-		});
-	}
+	if (![
+		isDataset$1,
+		isDateDataset$1,
+		isMetric,
+		isParameter,
+		isVisualisation,
+		isDashboard,
+		isPlugin,
+		isAttributeHierarchy
+	].some((isType) => isType(json))) return;
+	const object = buildObj(file, json);
+	handleType(fileMode, () => {
+		updateVirtual(state, [...refs.virtual, object]);
+	}, () => {
+		updatePhysical(state, [...refs.physical, object]);
+	});
 }
 function buildObj(file, obj) {
 	return {
@@ -146600,6 +146682,13 @@ const metadata_v1 = {
 			},
 			"then": { "$ref": "#/$global/gaac/attribute_hierarchy" }
 		},
+		{
+			"if": {
+				"properties": { "type": { "const": "parameter" } },
+				"required": ["type"]
+			},
+			"then": { "$ref": "#/$global/gaac/parameter" }
+		},
 		{
 			"if": {
 				"properties": { "type": { "enum": [
@@ -146667,7 +146756,8 @@ const metadata_v1 = {
 					"geo_area_chart",
 					"repeater_chart",
 					"radar_chart",
-					"attribute_hierarchy"
+					"attribute_hierarchy",
+					"parameter"
 				]
 			} }
 		}
@@ -146703,7 +146793,8 @@ const metadata_v1 = {
 			"geo_area_chart",
 			"repeater_chart",
 			"radar_chart",
-			"attribute_hierarchy"
+			"attribute_hierarchy",
+			"parameter"
 		]
 	} },
 	required: ["type"],
@@ -147226,6 +147317,54 @@ const metadata_v1 = {
 				"attributes"
 			]
 		},
+		"parameter": {
+			"title": "Parameter",
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"$ref": "#/$global/gaac/identifier",
+					"description": "A unique identifier of the parameter.",
+					"$semantic": [{
+						"type": "uniqueness",
+						"source": "parameter.id",
+						"code": "core.uniqueness.parameters.id"
+					}, {
+						"type": "definition",
+						"source": "parameter.id"
+					}]
+				},
+				"type": {
+					"type": "string",
+					"enum": ["parameter"]
+				},
+				"title": {
+					"$ref": "#/$global/gaac/title",
+					"description": "An optional human readable title for the parameter. Will be derived from id if not provided explicitly."
+				},
+				"description": {
+					"$ref": "#/$global/gaac/description",
+					"description": "An optional description of the parameter."
+				},
+				"tags": {
+					"$ref": "#/$global/gaac/tags",
+					"description": "A list of strings - metadata tags of this parameter."
+				},
+				"definition": {
+					"$ref": "#/$defs/parameterDefinition",
+					"description": "The typed definition of the parameter - its data type, default value and constraints."
+				}
+			},
+			"$semantic": {
+				"type": "snippet",
+				"snippets": ["parameter"]
+			},
+			"required": [
+				"id",
+				"type",
+				"definition"
+			]
+		},
 		"visualisation": {
 			"$schema": "http://json-schema.org/draft-07/schema#",
 			"title": "Visualisation",
@@ -153590,6 +153729,129 @@ const metadata_v1 = {
 				"maql"
 			]
 		},
+		"parameter": {
+			"title": "Parameter",
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"id": {
+					"$ref": "#/$global/gaac/identifier",
+					"description": "A unique identifier of the parameter.",
+					"$semantic": [{
+						"type": "uniqueness",
+						"source": "parameter.id",
+						"code": "core.uniqueness.parameters.id"
+					}, {
+						"type": "definition",
+						"source": "parameter.id"
+					}]
+				},
+				"type": {
+					"type": "string",
+					"enum": ["parameter"]
+				},
+				"title": {
+					"$ref": "#/$global/gaac/title",
+					"description": "An optional human readable title for the parameter. Will be derived from id if not provided explicitly."
+				},
+				"description": {
+					"$ref": "#/$global/gaac/description",
+					"description": "An optional description of the parameter."
+				},
+				"tags": {
+					"$ref": "#/$global/gaac/tags",
+					"description": "A list of strings - metadata tags of this parameter."
+				},
+				"definition": {
+					"$ref": "#/$defs/parameterDefinition",
+					"description": "The typed definition of the parameter - its data type, default value and constraints."
+				}
+			},
+			"$semantic": {
+				"type": "snippet",
+				"snippets": ["parameter"]
+			},
+			"required": [
+				"id",
+				"type",
+				"definition"
+			]
+		},
+		"parameterDefinition": {
+			"title": "Parameter Definition",
+			"description": "A typed parameter definition. Only textual parameters are supported as code.",
+			"allOf": [{
+				"if": {
+					"properties": { "type": { "const": "STRING" } },
+					"required": ["type"]
+				},
+				"then": { "$ref": "#/$defs/stringParameterDefinition" }
+			}],
+			"properties": { "type": {
+				"type": "string",
+				"enum": ["STRING"]
+			} },
+			"required": ["type"]
+		},
+		"stringParameterDefinition": {
+			"title": "String Parameter Definition",
+			"description": "A textual parameter definition. Without 'constraints' the parameter accepts any free-text value.",
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"type": {
+					"type": "string",
+					"enum": ["STRING"]
+				},
+				"defaultValue": {
+					"type": "string",
+					"description": "The value used whenever the parameter is not overridden."
+				},
+				"constraints": {
+					"title": "String Parameter Constraints",
+					"type": "object",
+					"additionalProperties": false,
+					"description": "Optional restrictions the parameter value must satisfy. Length bounds and 'allowedValues' are mutually exclusive.",
+					"properties": {
+						"minLength": {
+							"type": "integer",
+							"minimum": 0,
+							"description": "The shortest accepted value length, inclusive."
+						},
+						"maxLength": {
+							"type": "integer",
+							"minimum": 0,
+							"description": "The longest accepted value length, inclusive."
+						},
+						"allowedValues": {
+							"type": "array",
+							"minItems": 1,
+							"description": "When present, the parameter value must equal one of the listed values.",
+							"items": { "$ref": "#/$defs/parameterAllowedValue" }
+						}
+					},
+					"not": { "anyOf": [{ "required": ["allowedValues", "minLength"] }, { "required": ["allowedValues", "maxLength"] }] }
+				}
+			},
+			"required": ["type", "defaultValue"]
+		},
+		"parameterAllowedValue": {
+			"title": "Parameter Allowed Value",
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"value": {
+					"type": "string",
+					"minLength": 1,
+					"description": "The accepted parameter value."
+				},
+				"title": {
+					"type": "string",
+					"description": "An optional human readable title shown instead of the raw value. Defaults to the value."
+				}
+			},
+			"required": ["value"]
+		},
 		"plugin": {
 			"title": "Plugin",
 			"type": "object",
@@ -157994,6 +158256,7 @@ function buildSnippet(definition, type) {
 		case "dataset": return buildSnippetForDataset(definition);
 		case "date": return buildSnippetForDateDataset(definition);
 		case "metric": return buildSnippetForMetric(definition);
+		case "parameter": return buildSnippetForParameter(definition);
 		case "attribute": return buildSnippetForAttribute(definition);
 		case "fact": return buildSnippetForFact(definition);
 		case "color": return buildSnippetForColor();
@@ -158041,6 +158304,19 @@ function buildSnippetForMetric(definition) {
 	lines.push(``);
 	return lines.join("\n");
 }
+function buildSnippetForParameter(definition) {
+	const lines = [];
+	const tb = tabStopBuilder();
+	if (!definition.id) lines.push(`id: ${tb()}`);
+	if (!definition.type) lines.push(`type: parameter`);
+	if (!definition.definition) {
+		lines.push(`definition:`);
+		lines.push(`  type: STRING`);
+		lines.push(`  defaultValue: ${tb()}`);
+	}
+	lines.push(``);
+	return lines.join("\n");
+}
 function buildSnippetForAttribute(definition) {
 	const lines = [];
 	const tb = tabStopBuilder();
@@ -159147,7 +159423,7 @@ function findTransitiveReferences(file, references, point) {
 }
 //#endregion
 //#region ../code/esm/shared/maql/index.js
-const referenceRegex = new RegExp(`\\{((?:${SupportedReferenceTypes$1.join("|")})\\/(?!\\.)[.A-Za-z0-9_-]{1,255})\\}`);
+const referenceRegex = new RegExp(`\\{((?:${SupportedMaqlReferenceTypes.join("|")})\\/${REFERENCE_ID_PATTERN})\\}`);
 function loadMaqlReferencesWithPositions(document, offset, data) {
 	const items = parseMaqlObjects(data);
 	const results = [];
@@ -159170,7 +159446,7 @@ function parseMaqlObjects(data) {
 		const item = parsed[i];
 		if (i % 2 === 0) result.push(item);
 		else {
-			const identifier = parseReferenceObject$1(item);
+			const identifier = parseReferenceObject$1(item, SupportedMaqlReferenceTypes);
 			identifier && result.push({
 				...identifier,
 				text: `{${item}}`,
@@ -159295,6 +159571,7 @@ const REFERENCED_OBJECT_TYPES = {
 	"dashboard.id": "dashboard",
 	"dataSource.id": "dataSource",
 	"metric.id": "metric",
+	"parameter.id": "parameter",
 	"table.id": "table",
 	"fact.id": "fact",
 	"aggregated_fact.id": "aggregated_fact",
@@ -159317,6 +159594,7 @@ function referencesFindYamlForReferences(references, nodeItem, semanticItem, typ
 			case "dashboard.id":
 			case "dataSource.id":
 			case "metric.id":
+			case "parameter.id":
 			case "table.id":
 			case "fact.id":
 			case "aggregated_fact.id":
@@ -159424,6 +159702,9 @@ function referencesFindYamlForDefinition(references, parents, nodeItem, semantic
 			case "metric.id":
 				prev.push(...createDefinitionForMainType(references, isMetric, value, "metric"));
 				break;
+			case "parameter.id":
+				prev.push(...createDefinitionForMainType(references, isParameter, value, "parameter"));
+				break;
 			case "visualisation.id":
 				prev.push(...createDefinitionForMainType(references, isVisualisation, value, "visualisation"));
 				break;
@@ -159888,6 +160169,7 @@ const MAIN_OBJECTS = [
 	...PluginTypes$1,
 	...DashboardTypes$1,
 	...MetricTypes$1,
+	...ParameterTypes$1,
 	...VisualisationType,
 	...AttributeHierarchyTypes$1
 ];
@@ -159942,6 +160224,7 @@ function createTextEdit(item, name) {
 		case "dashboard":
 		case "dataSource":
 		case "metric":
+		case "parameter":
 		case "attribute_hierarchy":
 		case "label": {
 			const prefix = `${item.type}/`;
@@ -160397,7 +160680,7 @@ async function open(state, emitter, file) {
 //#endregion
 //#region ../code/package.json
 var name = "@gooddata/code";
-var version = "0.50.0-alpha.0";
+var version = "0.50.0-alpha.1";
 //#endregion
 //#region ../../../sdk/libs/api-client-tiger/src/axios.ts
 /**
@@ -160419,7 +160702,7 @@ const _CONFIG = {
 		common: {
 			"X-Requested-With": "XMLHttpRequest",
 			"X-GDC-JS-PACKAGE": "@gooddata/api-client-tiger",
-			"X-GDC-JS-PACKAGE-VERSION": "11.54.0-alpha.0"
+			"X-GDC-JS-PACKAGE-VERSION": "11.54.0-alpha.1"
 		},
 		post: { "Content-Type": "application/json;charset=utf8" },
 		put: { "Content-Type": "application/json;charset=utf8" }
@@ -198928,6 +199211,10 @@ async function makeRequest(func) {
 		throw e;
 	}
 }
+function mergeParameters(current, fromFiles) {
+	const authored = new Set(fromFiles.map((parameter) => parameter.id));
+	return [...(current ?? []).filter((parameter) => !isDeclarativeStringParameter(parameter) && !authored.has(parameter.id)), ...fromFiles];
+}
 function updateDeclarativeLayout(currentWs, newWs) {
 	return {
 		...currentWs,
@@ -198939,7 +199226,8 @@ function updateDeclarativeLayout(currentWs, newWs) {
 			...newWs.analytics?.analyticalDashboards ? { analyticalDashboards: newWs.analytics?.analyticalDashboards } : {},
 			...newWs.analytics?.filterContexts ? { filterContexts: newWs.analytics?.filterContexts } : {},
 			...newWs.analytics?.dashboardPlugins ? { dashboardPlugins: newWs.analytics?.dashboardPlugins } : {},
-			...newWs.analytics?.attributeHierarchies ? { attributeHierarchies: newWs.analytics?.attributeHierarchies } : {}
+			...newWs.analytics?.attributeHierarchies ? { attributeHierarchies: newWs.analytics?.attributeHierarchies } : {},
+			...newWs.analytics?.parameters ? { parameters: mergeParameters(currentWs.analytics?.parameters, newWs.analytics.parameters) } : {}
 		}
 	};
 }
@@ -199110,6 +199398,11 @@ function createDeclarativeWorkspaceModel(entities, profile) {
 		return data;
 	});
 	ws.analytics.metrics = metricsEntities.map((d) => d.declarative);
+	const parameterEntities = entities.filter((e) => ParameterTypes.includes(e.type)).map((data) => {
+		data.declarative = yamlParameterToDeclarative(data.data);
+		return data;
+	});
+	ws.analytics.parameters = parameterEntities.map((d) => d.declarative);
 	const visualisationsEntities = entities.filter((e) => VisualisationsTypes.includes(e.type)).map((data) => {
 		data.declarative = yamlVisualisationToDeclarative(entities, data.data);
 		return data;
@@ -199418,6 +199711,7 @@ async function fromDeclarative(workspace, basePath, profile, { tables = {}, stor
 	const entitiesLoaded = [];
 	const datasetsPath = [...basePath, "datasets"];
 	const metricsPath = [...basePath, "metrics"];
+	const parametersPath = [...basePath, "parameters"];
 	const visualisationsPath = [...basePath, "visualisations"];
 	const dashboardsPath = [...basePath, "dashboards"];
 	const pluginPath = [...basePath, "plugins"];
@@ -199464,6 +199758,17 @@ async function fromDeclarative(workspace, basePath, profile, { tables = {}, stor
 		});
 		return createNewFile(store, filePath, createFileContent({ content: Buffer.from(content, "utf8") }), { mode: "remote" });
 	}) ?? []);
+	if (workspace?.analytics?.parameters) mergeResults(update, workspace.analytics.parameters.filter(isDeclarativeStringParameter).map((parameter) => {
+		const { content, json } = declarativeParameterToYaml(parameter);
+		const filePath = generateFileName(files, parametersPath, parameter.id, parameter.title);
+		if (json && content) entitiesLoaded.push({
+			type: "parameter",
+			id: parameter.id,
+			data: json,
+			path: filePath
+		});
+		return createNewFile(store, filePath, createFileContent({ content: Buffer.from(content, "utf8") }), { mode: "remote" });
+	}) ?? []);
 	if (workspace?.analytics?.visualizationObjects) mergeResults(update, workspace.analytics.visualizationObjects.map((visualisation) => {
 		const { content, json } = declarativeVisualisationToYaml(entitiesLoaded, visualisation);
 		const filePath = generateFileName(files, visualisationsPath, visualisation.id, visualisation.title);
@@ -201865,6 +202170,7 @@ const ruleFiles = [
 	"datasets.mdc",
 	"gooddata.mdc",
 	"metrics.mdc",
+	"parameters.mdc",
 	"visualizations.mdc"
 ];
 async function prepareCursorRulesFile() {

package/package.json

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