@gooddata/sdk-ui-catalog 11.48.0-alpha.0 → 11.48.0-alpha.2

package/esm/metric/metricMutationPort.js

@@ -1,5 +1,5 @@
 // (C) 2026 GoodData Corporation
-import { idRef, } from "@gooddata/sdk-model";
+import { idRef, isMeasureMetadataObject } from "@gooddata/sdk-model";
 import { convertMeasureToCatalogItem } from "../catalogItem/converter.js";
 import { createMeasureCatalogItem, deleteMeasureCatalogItem, getMeasureCatalogItem, getMeasureReferencingObjectsCatalogItem, updateMeasureCatalogItem, } from "../catalogItem/query.js";
 import { overlayMetricYamlFields } from "./metricConverter.js";
@@ -12,28 +12,26 @@ export function createMetricMutationAdapter(backend, workspace) {
             const savedMeasure = await createMeasureCatalogItem(backend, workspace, definition);
             return convertMeasureToCatalogItem(savedMeasure);
         },
-        async update(existing, definition) {
-            const savedMeasure = await updateMeasureCatalogItem(backend, workspace, mergeMeasureDefinition(existing, definition));
+        async update(base, definition) {
+            // The measures endpoint is a full replace, so overlay the YAML-owned fields onto the loaded
+            // measure to carry over what the YAML cannot express (metricType, isHiddenFromKda, identity).
+            // `base` must be the persisted measure `load` returned — a bare definition (no server-managed
+            // `ref`) would silently drop those fields, so reject it loudly rather than corrupt the update.
+            if (!isMeasureMetadataObject(base)) {
+                throw new Error("Metric update requires the loaded measure as base, not a bare definition.");
+            }
+            const savedMeasure = await updateMeasureCatalogItem(backend, workspace, overlayMetricYamlFields(base, definition));
             return convertMeasureToCatalogItem(savedMeasure);
         },
         async delete(ref) {
             await deleteMeasureCatalogItem(backend, workspace, idRef(ref.identifier, "measure"));
         },
-        async load(ref) {
-            return getMeasureCatalogItem(backend, workspace, idRef(ref.identifier, "measure"));
+        async load(item) {
+            return getMeasureCatalogItem(backend, workspace, idRef(item.identifier, "measure"));
         },
-        async getReferencingObjects(ref) {
-            return getMeasureReferencingObjectsCatalogItem(backend, workspace, idRef(ref.identifier, "measure"));
+        async getReferencingObjectsCount(item) {
+            const referencing = await getMeasureReferencingObjectsCatalogItem(backend, workspace, idRef(item.identifier, "measure"));
+            return (referencing.insights?.length ?? 0) + (referencing.measures?.length ?? 0);
         },
     };
 }
-/**
- * Overlays the fields the as-code YAML owns onto the loaded metric.
- *
- * The measures update endpoint is a full replace, so fields absent from the YAML
- * (`metricType`, `isHiddenFromKda`, identity, ...) must be carried over from the loaded metric to
- * avoid wiping them; `overlayMetricYamlFields` preserves them via the base spread.
- */
-function mergeMeasureDefinition(existing, definition) {
-    return overlayMetricYamlFields(existing, definition);
-}

package/esm/metric/metricValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metricValidation.d.ts","sourceRoot":"","sources":["../../src/metric/metricValidation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAK5E,MAAM,MAAM,sBAAsB,GAC5B;IACI,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,gCAAgC,CAAC;CAC7C,GACD;IACI,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,yBAAyB,CAAC;CACxC,CAAC;AAER,MAAM,MAAM,yBAAyB,GAC/B,OAAO,GACP,QAAQ,GACR,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,aAAa,CAAC;AAEpB,KAAK,yBAAyB,GAAG;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,yBAA8B,GACxC,sBAAsB,CAyBxB"}
+{"version":3,"file":"metricValidation.d.ts","sourceRoot":"","sources":["../../src/metric/metricValidation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAO5E,MAAM,MAAM,sBAAsB,GAC5B;IACI,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,gCAAgC,CAAC;CAC7C,GACD;IACI,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,yBAAyB,CAAC;CACxC,CAAC;AAER,MAAM,MAAM,yBAAyB,GAC/B,OAAO,GACP,QAAQ,GACR,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,aAAa,CAAC;AAEpB,KAAK,yBAAyB,GAAG;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,yBAA8B,GACxC,sBAAsB,CAUxB"}

package/esm/metric/metricValidation.js

@@ -1,47 +1,28 @@
 // (C) 2026 GoodData Corporation
-import { parse as parseYaml } from "yaml";
+import { validateYaml } from "../asCode/validateYaml.js";
 import { metricYamlToDefinition } from "./metricConverter.js";
 import { metricSchema } from "./metricSchema.js";
 export function validateMetricYaml(value, options = {}) {
-    if (value.trim() === "") {
-        return invalid("empty");
-    }
-    let parsed;
-    try {
-        parsed = parseYaml(value, { strict: true });
-    }
-    catch {
-        return invalid("syntax");
-    }
-    const result = metricSchema.safeParse(parsed);
-    if (!result.success) {
-        return classifySchemaError(result.error, parsed);
-    }
-    if (options.fixedIdentifier !== undefined && result.data.id !== options.fixedIdentifier) {
-        return invalid("idImmutable");
-    }
-    return {
-        isValid: true,
-        measure: metricYamlToDefinition(result.data),
-    };
+    const result = validateYaml(value, {
+        schema: metricSchema,
+        fixedIdentifier: options.fixedIdentifier,
+        classifyError: classifyMetricError,
+    });
+    return result.ok
+        ? { isValid: true, measure: metricYamlToDefinition(result.data) }
+        : { isValid: false, errorCode: result.errorCode };
 }
-function classifySchemaError(error, parsed) {
+function classifyMetricError(error, parsed) {
     const maqlProvided = typeof parsed === "object" && parsed !== null && parsed.maql !== undefined;
     for (const issue of error.issues) {
         const path = issue.path.map(String).join(".");
         if (path === "maql") {
             // A present-but-wrong-typed maql is a structural error, not a missing field.
-            return invalid(maqlProvided ? "invalidStructure" : "missingMaql");
+            return maqlProvided ? "invalidStructure" : "missingMaql";
         }
         if (path === "tags" || path.startsWith("tags.")) {
-            return invalid("invalidTags");
+            return "invalidTags";
         }
     }
-    return invalid("invalidStructure");
-}
-function invalid(code) {
-    return {
-        isValid: false,
-        errorCode: code,
-    };
+    return "invalidStructure";
 }

package/esm/metric/tests/metricMutationPort.test.utils.js

@@ -37,7 +37,7 @@ export function createTestMetricMutationPort(overrides = {}) {
             expression: "SELECT 1",
             format: "#,##0.00",
         }),
-        getReferencingObjects: vi.fn().mockResolvedValue({ insights: [], measures: [] }),
+        getReferencingObjectsCount: vi.fn().mockResolvedValue(0),
         ...overrides,
     };
 }

package/esm/parameter/gate.d.ts

@@ -1,4 +1,7 @@
 import type { ParameterType } from "@gooddata/sdk-model";
+/** The flag gating catalog parameters. The single source of truth, referenced by the gates below and
+ *  `parameterDescriptor.featureFlag`. */
+export declare const PARAMETER_FEATURE_FLAG = "enableParameters";
 /**
  * Catalog parameter feature gate.
  */

package/esm/parameter/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/parameter/gate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAI/C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CAM1D"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/parameter/gate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;yCACyC;AACzC,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CAM1D"}

package/esm/parameter/gate.js

@@ -1,19 +1,21 @@
 // (C) 2026 GoodData Corporation
 import { useMemo } from "react";
-import { useFeatureFlag, useWorkspacePermission } from "../permission/PermissionsContext.js";
+import { useCanManageAsCode } from "../asCode/gate.js";
+import { useFeatureFlag } from "../permission/PermissionsContext.js";
+/** The flag gating catalog parameters. The single source of truth, referenced by the gates below and
+ *  `parameterDescriptor.featureFlag`. */
+export const PARAMETER_FEATURE_FLAG = "enableParameters";
 /**
  * Catalog parameter feature gate.
  */
 export function useIsParametersEnabled() {
-    return useFeatureFlag("enableParameters");
+    return useFeatureFlag(PARAMETER_FEATURE_FLAG);
 }
 /**
  * Whether the current user can manage parameters in the catalog.
  */
 export function useCanManageParameter() {
-    const isParametersEnabled = useIsParametersEnabled();
-    const canManageProject = useWorkspacePermission("canManageProject");
-    return isParametersEnabled && canManageProject;
+    return useCanManageAsCode(PARAMETER_FEATURE_FLAG);
 }
 /**
  * Parameter types authorable in the catalog, gated by `enableStringParameters`.

package/esm/parameter/parameterCopy.d.ts

@@ -1,4 +1,3 @@
 import type { IParameterMetadataObjectDefinition } from "@gooddata/sdk-model";
 export declare function createCopiedParameter(parameter: IParameterMetadataObjectDefinition): IParameterMetadataObjectDefinition;
-export declare function isDuplicateIdError(error: unknown): boolean;
 //# sourceMappingURL=parameterCopy.d.ts.map

package/esm/parameter/parameterCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameterCopy.d.ts","sourceRoot":"","sources":["../../src/parameter/parameterCopy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAK9E,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,kCAAkC,GAC9C,kCAAkC,CASpC;AAqCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"parameterCopy.d.ts","sourceRoot":"","sources":["../../src/parameter/parameterCopy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAI9E,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,kCAAkC,GAC9C,kCAAkC,CAQpC"}

package/esm/parameter/parameterCopy.js

@@ -1,48 +1,11 @@
 // (C) 2026 GoodData Corporation
-import { isUnexpectedResponseError } from "@gooddata/sdk-backend-spi";
-const canonicalUuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const trailingCopySuffixRegex = /^(.*) \((\d+)\)$/;
+import { deriveCopyIdentity } from "../asCode/copy.js";
 export function createCopiedParameter(parameter) {
+    // A parameter definition carries no server-managed fields, so every field other than the
+    // re-derived identity is copied as-is.
     const { id: _id, title: _title, ...parameterRest } = parameter;
-    const title = getCopiedTitle(parameter.title);
-    const id = shouldOmitCopiedId(parameter.id) ? undefined : getCopiedId(title);
     return {
-        ...(id === undefined ? {} : { id }),
-        ...(title === undefined ? {} : { title }),
+        ...deriveCopyIdentity(parameter),
         ...parameterRest,
     };
 }
-function getCopiedTitle(title) {
-    if (title === undefined) {
-        return undefined;
-    }
-    if (title === "") {
-        return "";
-    }
-    const match = title.match(trailingCopySuffixRegex);
-    if (match) {
-        const [, prefix, suffix] = match;
-        return `${prefix} (${Number(suffix) + 1})`;
-    }
-    return `${title} (2)`;
-}
-function shouldOmitCopiedId(id) {
-    return id === undefined || isCanonicalUuid(id);
-}
-function getCopiedId(title) {
-    if (!title) {
-        return undefined;
-    }
-    const normalizedTitle = title
-        .normalize("NFKD")
-        .replace(/[\u0300-\u036f]/g, "")
-        .replace(/\W/g, "_")
-        .toLowerCase();
-    return normalizedTitle || undefined;
-}
-function isCanonicalUuid(value) {
-    return canonicalUuidRegex.test(value);
-}
-export function isDuplicateIdError(error) {
-    return isUnexpectedResponseError(error) && error.httpStatus === 409;
-}

package/esm/parameter/parameterDescriptor.d.ts

@@ -0,0 +1,7 @@
+import type { IParameterMetadataObjectDefinition } from "@gooddata/sdk-model";
+import type { ICatalogItemParameter } from "../catalogItem/types.js";
+/**
+ * @internal
+ */
+export declare const parameterDescriptor: import("../asCode/descriptor.js").IAsCodeDescriptor<IParameterMetadataObjectDefinition, ICatalogItemParameter>;
+//# sourceMappingURL=parameterDescriptor.d.ts.map

package/esm/parameter/parameterDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterDescriptor.d.ts","sourceRoot":"","sources":["../../src/parameter/parameterDescriptor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAqErE;;GAEG;AACH,eAAO,MAAM,mBAAmB,gHA2B9B,CAAC"}

package/esm/parameter/parameterDescriptor.js

@@ -0,0 +1,91 @@
+// (C) 2026 GoodData Corporation
+import { useMemo } from "react";
+import { defineMessages, useIntl } from "react-intl";
+import { defineAsCodeDescriptor } from "../asCode/descriptor.js";
+import { ObjectTypes } from "../objectType/constants.js";
+import { PARAMETER_FEATURE_FLAG, useEnabledParameterTypes } from "./gate.js";
+import { createParameterCompletions } from "./parameterCompletions.js";
+import { createCopiedParameter } from "./parameterCopy.js";
+import { createParameterMutationAdapter } from "./parameterMutationPort.js";
+import { serializeParameterToYaml } from "./parameterSerialization.js";
+import { validateParameterYaml } from "./parameterValidation.js";
+const PARAMETER_DOCS_URL = "https://www.gooddata.ai/docs/cloud/experimental-features/numeric-parameters/";
+const messages = defineMessages({
+    createTitle: { id: "analyticsCatalog.parameter.dialog.create.title" },
+    editTitle: { id: "analyticsCatalog.parameter.dialog.edit.title" },
+    duplicate: { id: "analyticsCatalog.parameter.dialog.edit.duplicate" },
+    createDefaultTitle: { id: "analyticsCatalog.parameter.create.defaultTitle" },
+    createSuccess: { id: "analyticsCatalog.parameter.create.success" },
+    updateSuccess: { id: "analyticsCatalog.parameter.update.success" },
+    sectionHeader: { id: "analyticsCatalog.parameter.dialog.sectionHeader" },
+    sectionHeaderTooltip: { id: "analyticsCatalog.parameter.dialog.sectionHeader.tooltip" },
+    help: { id: "analyticsCatalog.parameter.dialog.help" },
+    submitError: { id: "analyticsCatalog.parameter.dialog.submit.error" },
+    deleteTitle: { id: "analyticsCatalog.parameter.dialog.delete.title" },
+    deleteBody: { id: "analyticsCatalog.parameter.dialog.delete.body" },
+    deleteSubmit: { id: "analyticsCatalog.parameter.dialog.delete.submit" },
+    deleteSuccess: { id: "analyticsCatalog.parameter.delete.success" },
+    deleteError: { id: "analyticsCatalog.parameter.delete.error" },
+});
+const errorMessages = defineMessages({
+    empty: { id: "analyticsCatalog.parameter.validation.empty" },
+    syntax: { id: "analyticsCatalog.parameter.validation.syntax" },
+    invalidStructure: { id: "analyticsCatalog.parameter.validation.invalidStructure" },
+    idImmutable: { id: "analyticsCatalog.parameter.dialog.edit.idImmutable" },
+    unsupportedType: { id: "analyticsCatalog.parameter.validation.unsupportedType" },
+    invalidDefaultValue: { id: "analyticsCatalog.parameter.validation.invalidDefaultValue" },
+    invalidConstraints: { id: "analyticsCatalog.parameter.validation.invalidConstraints" },
+    invalidConstraintRange: { id: "analyticsCatalog.parameter.validation.invalidConstraintRange" },
+    invalidTags: { id: "analyticsCatalog.parameter.validation.invalidTags" },
+});
+function useParameterEditing() {
+    const intl = useIntl();
+    const enabledTypes = useEnabledParameterTypes();
+    const completionSource = useMemo(() => createParameterCompletions(enabledTypes), [enabledTypes]);
+    return useMemo(() => ({
+        completionSource,
+        syntaxErrorMessage: intl.formatMessage(errorMessages.syntax),
+        // Parameter YAML round-trips 1:1 to its definition, so serialization is a plain stringify.
+        serialize: (definition) => serializeParameterToYaml(definition),
+        validate: (value, options) => {
+            const result = validateParameterYaml(value, { enabledTypes, ...options });
+            return result.isValid
+                ? { isValid: true, definition: result.parameter }
+                : {
+                    isValid: false,
+                    error: intl.formatMessage(errorMessages[result.errorCode], {
+                        type: result.type,
+                        enabledTypes: intl.formatList(enabledTypes, { type: "conjunction" }),
+                    }),
+                };
+        },
+    }), [completionSource, enabledTypes, intl]);
+}
+/**
+ * @internal
+ */
+export const parameterDescriptor = defineAsCodeDescriptor({
+    objectType: ObjectTypes.PARAMETER,
+    docsUrl: PARAMETER_DOCS_URL,
+    featureFlag: PARAMETER_FEATURE_FLAG,
+    messages,
+    useEditing: useParameterEditing,
+    createMutationPort: createParameterMutationAdapter,
+    emptyDefinition: (defaultTitle) => ({
+        type: "parameter",
+        title: defaultTitle,
+        description: "",
+        definition: { type: "NUMBER", defaultValue: 0 },
+    }),
+    // No port.load: the catalog item maps field-for-field to a definition, so the editor seeds from it.
+    editSeed: (item) => ({
+        id: item.identifier,
+        type: "parameter",
+        title: item.title,
+        description: item.description,
+        tags: item.tags,
+        definition: item.definition,
+    }),
+    // Source is already a definition, so toCopy only re-derives identity; no applyYamlEdits (YAML round-trips 1:1).
+    toCopy: createCopiedParameter,
+});

package/esm/parameter/parameterMutationPort.d.ts

@@ -1,14 +1,13 @@
 import type { IAnalyticalBackend } from "@gooddata/sdk-backend-spi";
 import type { IParameterMetadataObjectDefinition } from "@gooddata/sdk-model";
-import type { ICatalogItemParameter, ICatalogItemRef } from "../catalogItem/types.js";
+import type { IAsCodeMutationPort } from "../asCode/descriptor.js";
+import type { ICatalogItemParameter } from "../catalogItem/types.js";
 /**
+ * A parameter's YAML round-trips 1:1 to its definition, so the editor works directly off the catalog
+ * item (see the descriptor's `editSeed`) — there is no `load` and no `getReferencingObjectsCount`.
  * @internal
  */
-export interface IParameterMutationPort {
-    create(definition: IParameterMetadataObjectDefinition): Promise<ICatalogItemParameter>;
-    update(item: ICatalogItemParameter): Promise<ICatalogItemParameter>;
-    delete(ref: ICatalogItemRef): Promise<void>;
-}
+export type IParameterMutationPort = IAsCodeMutationPort<IParameterMetadataObjectDefinition, ICatalogItemParameter>;
 /**
  * @internal
  */

package/esm/parameter/parameterMutationPort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameterMutationPort.d.ts","sourceRoot":"","sources":["../../src/parameter/parameterMutationPort.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAQ9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,UAAU,EAAE,kCAAkC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvF,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAClB,sBAAsB,CAcxB"}
+{"version":3,"file":"parameterMutationPort.d.ts","sourceRoot":"","sources":["../../src/parameter/parameterMutationPort.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAOnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CACpD,kCAAkC,EAClC,qBAAqB,CACxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,8BAA8B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAClB,sBAAsB,CA2BxB"}

package/esm/parameter/parameterMutationPort.js

@@ -10,8 +10,21 @@ export function createParameterMutationAdapter(backend, workspace) {
             const savedParameter = await createParameterCatalogItem(backend, workspace, definition);
             return convertParameterToCatalogItem(savedParameter);
         },
-        async update(item) {
-            const savedParameter = await updateParameterCatalogItem(backend, workspace, item);
+        async update(base, definition) {
+            // Identity is authoritative from the base the editor started from, never from the editable
+            // YAML — a hand-edited `id` must not retarget the update to a different parameter.
+            const identity = base.id;
+            if (identity === undefined) {
+                throw new Error("Cannot update a parameter without an identity.");
+            }
+            if (definition.id !== undefined && definition.id !== identity) {
+                throw new Error("A parameter's identity cannot be changed during an update.");
+            }
+            // The parsed definition is the complete new state (1:1 round-trip); only its identity is pinned.
+            const savedParameter = await updateParameterCatalogItem(backend, workspace, {
+                ...definition,
+                id: identity,
+            });
             return convertParameterToCatalogItem(savedParameter);
         },
         async delete(ref) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-catalog",
-  "version": "11.48.0-alpha.0",
+  "version": "11.48.0-alpha.2",
   "description": "GoodData SDK - Analytics Catalog",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -41,15 +41,15 @@
     "tslib": "2.8.1",
     "yaml": "2.8.3",
     "zod": "4.3.6",
-    "@gooddata/sdk-backend-spi": "11.48.0-alpha.0",
-    "@gooddata/sdk-code-schemas": "11.48.0-alpha.0",
-    "@gooddata/sdk-model": "11.48.0-alpha.0",
-    "@gooddata/sdk-ui": "11.48.0-alpha.0",
-    "@gooddata/sdk-ui-ext": "11.48.0-alpha.0",
-    "@gooddata/sdk-ui-kit": "11.48.0-alpha.0",
-    "@gooddata/sdk-ui-semantic-search": "11.48.0-alpha.0",
-    "@gooddata/sdk-ui-theme-provider": "11.48.0-alpha.0",
-    "@gooddata/util": "11.48.0-alpha.0"
+    "@gooddata/sdk-model": "11.48.0-alpha.2",
+    "@gooddata/sdk-ui": "11.48.0-alpha.2",
+    "@gooddata/sdk-ui-ext": "11.48.0-alpha.2",
+    "@gooddata/sdk-code-schemas": "11.48.0-alpha.2",
+    "@gooddata/sdk-backend-spi": "11.48.0-alpha.2",
+    "@gooddata/sdk-ui-kit": "11.48.0-alpha.2",
+    "@gooddata/sdk-ui-theme-provider": "11.48.0-alpha.2",
+    "@gooddata/sdk-ui-semantic-search": "11.48.0-alpha.2",
+    "@gooddata/util": "11.48.0-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -89,11 +89,11 @@
     "typescript": "5.9.3",
     "vitest": "4.1.8",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.48.0-alpha.0",
-    "@gooddata/i18n-toolkit": "11.48.0-alpha.0",
-    "@gooddata/oxlint-config": "11.48.0-alpha.0",
-    "@gooddata/sdk-backend-mockingbird": "11.48.0-alpha.0",
-    "@gooddata/stylelint-config": "11.48.0-alpha.0"
+    "@gooddata/eslint-config": "11.48.0-alpha.2",
+    "@gooddata/oxlint-config": "11.48.0-alpha.2",
+    "@gooddata/i18n-toolkit": "11.48.0-alpha.2",
+    "@gooddata/sdk-backend-mockingbird": "11.48.0-alpha.2",
+    "@gooddata/stylelint-config": "11.48.0-alpha.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/esm/metric/MetricCreateDialog.d.ts

@@ -1,11 +0,0 @@
-import type { IMeasureMetadataObjectDefinition } from "@gooddata/sdk-model";
-import type { ICatalogItemMeasure } from "../catalogItem/types.js";
-type Props = {
-    sourceDefinition?: IMeasureMetadataObjectDefinition;
-    isLoading?: boolean;
-    onClose: () => void;
-    onCreated?: (item: ICatalogItemMeasure) => void;
-};
-export declare function MetricCreateDialog({ sourceDefinition, isLoading, onClose, onCreated }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=MetricCreateDialog.d.ts.map

package/esm/metric/MetricCreateDialog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MetricCreateDialog.d.ts","sourceRoot":"","sources":["../../src/metric/MetricCreateDialog.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAYnE,KAAK,KAAK,GAAG;IACT,gBAAgB,CAAC,EAAE,gCAAgC,CAAC;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,SAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,2CA0DpG"}

package/esm/metric/MetricCreateDialog.js

@@ -1,55 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-// (C) 2026 GoodData Corporation
-import { useCallback, useMemo } from "react";
-import { defineMessages, useIntl } from "react-intl";
-import { useToastMessage } from "@gooddata/sdk-ui-kit";
-import { definitionToMetricYaml, mergeCopiedMetricDefinition } from "./metricConverter.js";
-import { createCopiedMetric, isDuplicateIdError } from "./metricCopy.js";
-import { MetricDialog } from "./MetricDialog.js";
-import { useMetricMutation } from "./MetricMutationContext.js";
-const messages = defineMessages({
-    metricCreateSuccess: { id: "analyticsCatalog.metric.create.success" },
-    metricCreateDefaultTitle: { id: "analyticsCatalog.metric.create.defaultTitle" },
-});
-export function MetricCreateDialog({ sourceDefinition, isLoading = false, onClose, onCreated }) {
-    const intl = useIntl();
-    const { addSuccess } = useToastMessage();
-    const mutation = useMetricMutation();
-    // The single source of truth for a duplicate's copy semantics (title bump, id derivation, and
-    // which author-owned fields carry over). Undefined for a blank create.
-    const copiedMetric = useMemo(() => (sourceDefinition ? createCopiedMetric(sourceDefinition) : undefined), [sourceDefinition]);
-    const initialMetric = useMemo(() => {
-        if (!copiedMetric) {
-            return {
-                type: "metric",
-                title: intl.formatMessage(messages.metricCreateDefaultTitle),
-                maql: "SELECT 1",
-            };
-        }
-        return definitionToMetricYaml(copiedMetric);
-    }, [copiedMetric, intl]);
-    const copiedId = copiedMetric ? initialMetric.id : undefined;
-    const handleSubmit = useCallback(async (metric) => {
-        // A duplicate layers the author's YAML edits over the copied source so its non-YAML
-        // fields (metricType, isHiddenFromKda) survive the lossy YAML round-trip; a blank create
-        // has no source and persists the parsed YAML as-is.
-        const definition = copiedMetric ? mergeCopiedMetricDefinition(copiedMetric, metric) : metric;
-        let createdMetric;
-        try {
-            createdMetric = await mutation.create(definition);
-        }
-        catch (error) {
-            if (copiedId !== undefined && definition.id === copiedId && isDuplicateIdError(error)) {
-                const { id: _id, ...metricWithoutId } = definition;
-                createdMetric = await mutation.create(metricWithoutId);
-            }
-            else {
-                throw error;
-            }
-        }
-        onCreated?.(createdMetric);
-        onClose();
-        addSuccess(messages.metricCreateSuccess);
-    }, [addSuccess, copiedId, copiedMetric, mutation, onClose, onCreated]);
-    return (_jsx(MetricDialog, { mode: "create", isLoading: isLoading, initialMetric: initialMetric, onClose: onClose, onSubmit: handleSubmit }));
-}

package/esm/metric/MetricDeleteDialog.d.ts

@@ -1,9 +0,0 @@
-import { type ICatalogItemMeasure } from "../catalogItem/types.js";
-type Props = {
-    item: ICatalogItemMeasure;
-    onClose: () => void;
-    onDeleted: () => void;
-};
-export declare function MetricDeleteDialog({ item, onClose, onDeleted }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=MetricDeleteDialog.d.ts.map

package/esm/metric/MetricDeleteDialog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MetricDeleteDialog.d.ts","sourceRoot":"","sources":["../../src/metric/MetricDeleteDialog.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAcnE,KAAK,KAAK,GAAG;IACT,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,2CA+ErE"}

package/esm/metric/MetricDeleteDialog.js

@@ -1,68 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// (C) 2026 GoodData Corporation
-import { useCallback, useEffect, useState } from "react";
-import { FormattedMessage, defineMessages, useIntl } from "react-intl";
-import { ConfirmDialog, useToastMessage } from "@gooddata/sdk-ui-kit";
-import {} from "../catalogItem/types.js";
-import { useMetricMutation } from "./MetricMutationContext.js";
-const messages = defineMessages({
-    title: { id: "analyticsCatalog.metric.dialog.delete.title" },
-    body: { id: "analyticsCatalog.metric.dialog.delete.body" },
-    usageWarning: { id: "analyticsCatalog.metric.dialog.delete.usageWarning" },
-    submit: { id: "analyticsCatalog.metric.dialog.delete.submit" },
-    cancel: { id: "analyticsCatalog.metric.dialog.cancel" },
-    deleteSuccess: { id: "analyticsCatalog.metric.delete.success" },
-    deleteError: { id: "analyticsCatalog.metric.delete.error" },
-});
-export function MetricDeleteDialog({ item, onClose, onDeleted }) {
-    const intl = useIntl();
-    const { addSuccess, addError } = useToastMessage();
-    const mutation = useMetricMutation();
-    const [isDeleting, setIsDeleting] = useState(false);
-    // undefined until the usage lookup resolves; deletion is withheld until then so the dependent-object
-    // warning can surface before the user can confirm.
-    const [referencingCount, setReferencingCount] = useState(undefined);
-    const displayName = item.title || item.identifier;
-    useEffect(() => {
-        let cancelled = false;
-        mutation
-            .getReferencingObjects(item)
-            .then((referencing) => {
-            if (!cancelled) {
-                const count = (referencing.insights?.length ?? 0) + (referencing.measures?.length ?? 0);
-                setReferencingCount(count);
-            }
-        })
-            .catch(() => {
-            // Usage lookup is advisory; on failure fall back to no warning rather than block deletion.
-            if (!cancelled) {
-                setReferencingCount(0);
-            }
-        });
-        return () => {
-            cancelled = true;
-        };
-    }, [item, mutation]);
-    const handleDelete = useCallback(async () => {
-        setIsDeleting(true);
-        try {
-            await mutation.delete(item);
-            onDeleted();
-            onClose();
-            addSuccess(messages.deleteSuccess);
-        }
-        catch {
-            addError(messages.deleteError);
-            setIsDeleting(false);
-        }
-    }, [addError, addSuccess, item, mutation, onClose, onDeleted]);
-    const handleClose = useCallback(() => {
-        if (!isDeleting) {
-            onClose();
-        }
-    }, [isDeleting, onClose]);
-    return (_jsxs(ConfirmDialog, { headline: intl.formatMessage(messages.title), cancelButtonText: intl.formatMessage(messages.cancel), submitButtonText: intl.formatMessage(messages.submit), isPositive: false, isSubmitDisabled: isDeleting || referencingCount === undefined, isCancelDisabled: isDeleting, showProgressIndicator: isDeleting, onCancel: handleClose, onClose: handleClose, onSubmit: handleDelete, displayCloseButton: !isDeleting, children: [_jsx(FormattedMessage, { ...messages.body, values: {
-                    name: displayName,
-                    b: (chunks) => _jsx("b", { children: chunks }),
-                } }), referencingCount ? (_jsx("div", { children: _jsx(FormattedMessage, { ...messages.usageWarning, values: { count: referencingCount } }) })) : null] }));
-}

package/esm/metric/MetricDetailActions.d.ts

@@ -1,23 +0,0 @@
-import { type MouseEvent } from "react";
-import type { OpenHandlerEvent } from "../catalogDetail/types.js";
-import type { ICatalogItemMeasure, ICatalogItemRef } from "../catalogItem/types.js";
-/**
- * @internal
- */
-export interface IMetricDetailActionsProps {
-    item: ICatalogItemMeasure;
-    /** When provided, adds an "Open in metric editor" menu action that opens the standalone editor. */
-    onOpen?: (event: MouseEvent, openEvent: OpenHandlerEvent) => void;
-    canShare?: boolean;
-    onShare?: () => void;
-    onCatalogItemCreate?: (item: ICatalogItemMeasure) => void;
-    onCatalogItemUpdate?: (item: ICatalogItemMeasure) => void;
-    onCatalogItemDelete?: (ref: ICatalogItemRef) => void;
-}
-/**
- * Detail-panel actions for a metric: inline edit, duplicate, and delete via the as-code editor,
- * alongside the shared Share button and "Open in metric editor" action.
- * @internal
- */
-export declare function MetricDetailActions({ item, onOpen, canShare, onShare, onCatalogItemCreate, onCatalogItemUpdate, onCatalogItemDelete }: IMetricDetailActionsProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=MetricDetailActions.d.ts.map

package/esm/metric/MetricDetailActions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MetricDetailActions.d.ts","sourceRoot":"","sources":["../../src/metric/MetricDetailActions.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEH,KAAK,UAAU,EAMlB,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAqBpF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,mGAAmG;IACnG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC1D,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC1D,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACtB,EAAE,yBAAyB,2CA6H3B"}