@gooddata/sdk-ui-catalog 11.50.0-alpha.2 → 11.50.0-alpha.4

package/esm/asCodeRegistry.js

@@ -1,32 +1,24 @@
 // (C) 2026 GoodData Corporation
+import { useMemo } from "react";
+import { visualizationDescriptor } from "./insight/insightDescriptor.js";
 import { metricDescriptor } from "./metric/metricDescriptor.js";
 import { ObjectTypes } from "./objectType/constants.js";
 import { parameterDescriptor } from "./parameter/parameterDescriptor.js";
-import { useFeatureFlags } from "./permission/PermissionsContext.js";
-/**
- * Every as-code descriptor, keyed by type — the one place the concrete descriptors are registered. The
- * key is the full `AsCodeObjectType` union, so a missing type is a compile error.
- * @internal
- */
+import { useFeatureFlags, useWorkspacePermission } from "./permission/PermissionsContext.js";
+/** @internal */
 export const asCodeDescriptors = {
     [ObjectTypes.METRIC]: metricDescriptor,
     [ObjectTypes.PARAMETER]: parameterDescriptor,
+    [ObjectTypes.VISUALIZATION]: visualizationDescriptor,
 };
 function isAsCodeObjectType(type) {
     return Object.prototype.hasOwnProperty.call(asCodeDescriptors, type);
 }
-/**
- * The as-code descriptor for a catalog object type, or `undefined` if the type is not editable as code.
- * @internal
- */
+/** @internal */
 export function getAsCodeDescriptor(type) {
     return isAsCodeObjectType(type) ? asCodeDescriptors[type] : undefined;
 }
-/**
- * Whether this descriptor's editor is enabled by the feature flags. A descriptor with no `featureFlag`
- * is always editable; `undefined` (not an as-code type) never is.
- * @internal
- */
+/** A descriptor with no `featureFlag` is always editable; `undefined` (not an as-code type) never is. @internal */
 export function useIsAsCodeTypeEditable(descriptor) {
     const flags = useFeatureFlags();
     if (descriptor === undefined) {
@@ -34,3 +26,25 @@ export function useIsAsCodeTypeEditable(descriptor) {
     }
     return descriptor.featureFlag === undefined || Boolean(flags?.[descriptor.featureFlag]);
 }
+function useIsAsCodeTypeCreatable(descriptor) {
+    const isTypeEditable = useIsAsCodeTypeEditable(descriptor);
+    const canManageProject = useWorkspacePermission("canManageProject");
+    const createGate = descriptor.useCreateGate?.() ?? true;
+    return isTypeEditable && canManageProject && createGate;
+}
+/** @internal */
+export function useCreatableObjectTypes() {
+    // One unconditional hook call per registered type (fixed count for the rules of hooks).
+    const metric = useIsAsCodeTypeCreatable(asCodeDescriptors[ObjectTypes.METRIC]);
+    const parameter = useIsAsCodeTypeCreatable(asCodeDescriptors[ObjectTypes.PARAMETER]);
+    const visualization = useIsAsCodeTypeCreatable(asCodeDescriptors[ObjectTypes.VISUALIZATION]);
+    return useMemo(() => {
+        // The `Record<AsCodeObjectType, …>` makes a newly registered type a compile error until listed here.
+        const creatable = {
+            [ObjectTypes.METRIC]: metric,
+            [ObjectTypes.PARAMETER]: parameter,
+            [ObjectTypes.VISUALIZATION]: visualization,
+        };
+        return new Set(Object.keys(creatable).filter((type) => creatable[type]));
+    }, [metric, parameter, visualization]);
+}

package/esm/catalog/Catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../src/catalog/Catalog.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAIxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAWtE,KAAK,KAAK,GAAG;IACT,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,sBAAsB,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnF,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/E,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,wBAAgB,OAAO,CAAC,EACpB,kBAAkB,EAClB,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACjB,EAAE,KAAK,2CAsEP"}
+{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../src/catalog/Catalog.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAIxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAUtE,KAAK,KAAK,GAAG;IACT,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,sBAAsB,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnF,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/E,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,wBAAgB,OAAO,CAAC,EACpB,kBAAkB,EAClB,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACjB,EAAE,KAAK,2CA4DP"}

package/esm/catalog/Catalog.js

@@ -4,16 +4,12 @@ import {} from "react";
 import { useIntl } from "react-intl";
 import { ErrorComponent } from "@gooddata/sdk-ui";
 import { LoadingMask } from "@gooddata/sdk-ui-kit";
-import { AsCodeMutationProvider } from "../asCode/AsCodeMutationContext.js";
-import { asCodeDescriptors } from "../asCodeRegistry.js";
 import { CatalogFeedProvider } from "../catalogItem/CatalogFeedContext.js";
 import {} from "../catalogItem/types.js";
 import { CreateObjectButton } from "../header/CreateObjectButton.js";
 import { Header } from "../header/Header.js";
 import { useCatalogItemOpen } from "../main/hooks/useCatalogItemOpen.js";
 import { Main } from "../main/Main.js";
-import { useCanManageMetric } from "../metric/gate.js";
-import { useCanManageParameter } from "../parameter/gate.js";
 import { PermissionsGate } from "../permission/PermissionsGate.js";
 import { useIsCatalogQualityEnabled } from "../quality/gate.js";
 import { QualityScoreCard } from "../quality/QualityScoreCard.js";
@@ -23,8 +19,6 @@ import { useIsCatalogTrendingObjectsEnabled } from "../tabs/gate.js";
 import { Layout } from "./Layout.js";
 export function Catalog({ openCatalogItemRef, backend, workspace, onCatalogItemOpenClick, onCatalogItemNavigation, onCatalogDetailOpened, onCatalogDetailClosed, onCreateObject, }) {
     const intl = useIntl();
-    const showParameter = useCanManageParameter();
-    const showMetricEditor = useCanManageMetric();
     const isTrendingEnabled = useIsCatalogTrendingObjectsEnabled();
     const isQualityEnabled = useIsCatalogQualityEnabled();
     const { open, openedItem, setItemOpened, onOpenDetail, onCloseDetail, onOpenClick } = useCatalogItemOpen(onCatalogItemOpenClick, onCatalogDetailOpened, onCatalogDetailClosed, openCatalogItemRef);
@@ -32,6 +26,6 @@ export function Catalog({ openCatalogItemRef, backend, workspace, onCatalogItemO
                     id: "analyticsCatalog.error.unknown.description",
                 }) }), unauthorizedNode: _jsx(ErrorComponent, { message: intl.formatMessage({ id: "analyticsCatalog.error.unauthorized.message" }), description: intl.formatMessage({
                     id: "analyticsCatalog.error.unauthorized.description",
-                }) }), children: _jsx(CatalogFeedProvider, { backend: backend, workspace: workspace, children: _jsxs(AsCodeMutationProvider, { descriptors: asCodeDescriptors, children: [_jsx(Header, { searchNode: _jsx(FullTextSearchInput, {}), createNode: onCreateObject ? (_jsx(CreateObjectButton, { onCreateObject: onCreateObject, showParameter: showParameter, showMetricEditor: showMetricEditor })) : null }), isTrendingEnabled ? (_jsx(CatalogTabs, { onItemClick: onOpenDetail })) : isQualityEnabled ? (_jsx(QualityScoreCard, {})) : null, _jsx(Main, { workspace: workspace, backend: backend, open: open, openedItem: openedItem, setItemOpened: setItemOpened, onOpenDetail: onOpenDetail, onCloseDetail: onCloseDetail, onOpenClick: onOpenClick, onCatalogItemNavigation: onCatalogItemNavigation })
-                    ] }) }) }) }));
+                }) }), children: _jsxs(CatalogFeedProvider, { backend: backend, workspace: workspace, children: [_jsx(Header, { searchNode: _jsx(FullTextSearchInput, {}), createNode: onCreateObject ? _jsx(CreateObjectButton, { onCreateObject: onCreateObject }) : null }), isTrendingEnabled ? (_jsx(CatalogTabs, { onItemClick: onOpenDetail })) : isQualityEnabled ? (_jsx(QualityScoreCard, {})) : null, _jsx(Main, { workspace: workspace, backend: backend, open: open, openedItem: openedItem, setItemOpened: setItemOpened, onOpenDetail: onOpenDetail, onCloseDetail: onCloseDetail, onOpenClick: onOpenClick, onCatalogItemNavigation: onCatalogItemNavigation })
+                ] }) }) }));
 }

package/esm/catalogDetail/CatalogDetailActionBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CatalogDetailActionBar.d.ts","sourceRoot":"","sources":["../../src/catalogDetail/CatalogDetailActionBar.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAOrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAUzE,MAAM,MAAM,4BAA4B,GAAG;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,YAAY,EAAE,oBAAoB,EAAE,EAAE,CAAC;IACvC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5E,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,KAAK,IAAI,CAAC;CACtF,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EACnC,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACtB,EAAE,4BAA4B,2CA+E9B"}
+{"version":3,"file":"CatalogDetailActionBar.d.ts","sourceRoot":"","sources":["../../src/catalogDetail/CatalogDetailActionBar.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAOrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAUzE,MAAM,MAAM,4BAA4B,GAAG;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,YAAY,EAAE,oBAAoB,EAAE,EAAE,CAAC;IACvC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5E,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,KAAK,IAAI,CAAC;CACtF,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EACnC,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACtB,EAAE,4BAA4B,2CA8E9B"}

package/esm/catalogDetail/CatalogDetailActionBar.js

@@ -4,6 +4,7 @@ import { useMemo } from "react";
 import { defineMessages, useIntl } from "react-intl";
 import { Dropdown, UiButton, UiIconButton, UiMenu } from "@gooddata/sdk-ui-kit";
 import { catalogDetailActionsTrigger } from "../automation/testIds.js";
+import { toOpenHandlerEvent } from "./openHandlerEvent.js";
 const messages = defineMessages({
     actionsMenuAriaLabel: { id: "analyticsCatalog.catalogItem.actionsMenu.ariaLabel" },
 });
@@ -22,14 +23,9 @@ export function CatalogDetailActionBar({ item, workspaceId, actionGroups, leadin
         }));
         return groupIndex > 0 ? [{ type: "separator" }, ...items] : items;
     }), [actionGroups]);
-    return (_jsxs("div", { className: "gd-analytics-catalog-detail__detail-actions", children: [leadingActions, _jsx(UiButton, { label: intl.formatMessage({ id: "analyticsCatalog.edit" }), variant: "primary", size: "medium", onClick: (event) => {
-                    onEditClick?.(event, {
-                        item,
-                        workspaceId,
-                        newTab: event.metaKey || event.ctrlKey,
-                        preventDefault: event.preventDefault.bind(event),
-                    });
-                } }), _jsx(Dropdown, { alignPoints: [{ align: "br tr" }], renderButton: ({ toggleDropdown, buttonRef, ariaAttributes, accessibilityConfig }) => (_jsx(UiIconButton, { ref: (element) => {
+    return (_jsxs("div", { className: "gd-analytics-catalog-detail__detail-actions", children: [leadingActions, onEditClick ? (_jsx(UiButton, { label: intl.formatMessage({ id: "analyticsCatalog.edit" }), variant: "primary", size: "medium", onClick: (event) => {
+                    onEditClick(event, toOpenHandlerEvent(event, item, workspaceId));
+                } })) : null, _jsx(Dropdown, { alignPoints: [{ align: "br tr" }], renderButton: ({ toggleDropdown, buttonRef, ariaAttributes, accessibilityConfig }) => (_jsx(UiIconButton, { ref: (element) => {
                         buttonRef.current = element;
                     }, icon: "ellipsis", variant: "secondary", size: "medium", onClick: toggleDropdown, dataTestId: catalogDetailActionsTrigger, accessibilityConfig: {
                         ...accessibilityConfig,

package/esm/catalogDetail/CatalogDetailActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CatalogDetailActions.d.ts","sourceRoot":"","sources":["../../src/catalogDetail/CatalogDetailActions.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AASxC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACtB,EAAE,0BAA0B,kDAqD5B"}
+{"version":3,"file":"CatalogDetailActions.d.ts","sourceRoot":"","sources":["../../src/catalogDetail/CatalogDetailActions.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AASxC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACtB,EAAE,0BAA0B,kDAgD5B"}

package/esm/catalogDetail/CatalogDetailActions.js

@@ -6,6 +6,7 @@ import { useWorkspaceStrict } from "@gooddata/sdk-ui";
 import { UiButton } from "@gooddata/sdk-ui-kit";
 import { AsCodeDetailActions } from "../asCode/AsCodeDetailActions.js";
 import { getAsCodeDescriptor, useIsAsCodeTypeEditable } from "../asCodeRegistry.js";
+import { toOpenHandlerEvent } from "./openHandlerEvent.js";
 import { useCatalogItemShareActions } from "./share/CatalogItemShareProvider.js";
 import { ShareButton } from "./share/ShareButton.js";
 /**
@@ -36,12 +37,7 @@ export function CatalogDetailActions({ item, canEdit, onOpen, onCatalogItemCreat
         return null;
     }
     return (_jsxs("div", { className: "gd-analytics-catalog-detail__header-actions", children: [share.active ? _jsx(ShareButton, { onClick: share.open }) : null, _jsx(UiButton, { label: intl.formatMessage({ id: "analyticsCatalog.catalogItem.open" }), variant: "primary", accessibilityConfig: { role: "link" }, onClick: (event) => {
-                    onOpen?.(event, {
-                        item,
-                        workspaceId,
-                        newTab: event.metaKey || event.ctrlKey,
-                        preventDefault: event.preventDefault.bind(event),
-                    });
+                    onOpen?.(event, toOpenHandlerEvent(event, item, workspaceId));
                 } })
         ] }));
 }

package/esm/catalogDetail/openHandlerEvent.d.ts

@@ -0,0 +1,6 @@
+import type { MouseEvent } from "react";
+import type { ICatalogItem } from "../catalogItem/types.js";
+import type { OpenHandlerEvent } from "./types.js";
+/** @internal */
+export declare function toOpenHandlerEvent(event: MouseEvent, item: ICatalogItem, workspaceId: string): OpenHandlerEvent;
+//# sourceMappingURL=openHandlerEvent.d.ts.map

package/esm/catalogDetail/openHandlerEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openHandlerEvent.d.ts","sourceRoot":"","sources":["../../src/catalogDetail/openHandlerEvent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,GACpB,gBAAgB,CAOlB"}

package/esm/catalogDetail/openHandlerEvent.js

@@ -0,0 +1,10 @@
+// (C) 2026 GoodData Corporation
+/** @internal */
+export function toOpenHandlerEvent(event, item, workspaceId) {
+    return {
+        item,
+        workspaceId,
+        newTab: event.metaKey || event.ctrlKey,
+        preventDefault: event.preventDefault.bind(event),
+    };
+}

package/esm/header/CreateObjectButton.d.ts

@@ -1,9 +1,7 @@
 import type { CatalogCreateObjectType } from "../objectType/types.js";
 type Props = {
     onCreateObject: (objectType: CatalogCreateObjectType) => void;
-    showParameter?: boolean;
-    showMetricEditor?: boolean;
 };
-export declare function CreateObjectButton({ onCreateObject, showParameter, showMetricEditor }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function CreateObjectButton({ onCreateObject }: Props): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=CreateObjectButton.d.ts.map

package/esm/header/CreateObjectButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateObjectButton.d.ts","sourceRoot":"","sources":["../../src/header/CreateObjectButton.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAatE,KAAK,KAAK,GAAG;IACT,cAAc,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,KAAK,2CAkH5F"}
+{"version":3,"file":"CreateObjectButton.d.ts","sourceRoot":"","sources":["../../src/header/CreateObjectButton.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAatE,KAAK,KAAK,GAAG;IACT,cAAc,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,EAAE,cAAc,EAAE,EAAE,KAAK,2CAsG3D"}

package/esm/header/CreateObjectButton.js

@@ -4,7 +4,7 @@ import { useCallback, useMemo, useState } from "react";
 import { useIntl } from "react-intl";
 import { Dropdown, UiButton, UiIcon, UiMenu, } from "@gooddata/sdk-ui-kit";
 import { AsCodeCreateDialog } from "../asCode/AsCodeCreateDialog.js";
-import { getAsCodeDescriptor } from "../asCodeRegistry.js";
+import { getAsCodeDescriptor, useCreatableObjectTypes } from "../asCodeRegistry.js";
 import { useCatalogFeedActions } from "../catalogItem/CatalogFeedContext.js";
 import { ObjectTypes } from "../objectType/constants.js";
 import { getObjectTypeLabel } from "../objectType/labels.js";
@@ -14,23 +14,12 @@ const icons = {
     [ObjectTypes.METRIC]: "metric",
     [ObjectTypes.PARAMETER]: "parameter",
 };
-export function CreateObjectButton({ onCreateObject, showParameter, showMetricEditor }) {
+export function CreateObjectButton({ onCreateObject }) {
     const intl = useIntl();
     const { refetchObjectType } = useCatalogFeedActions();
-    // The type whose create dialog is open, or undefined when none is. One state for every as-code
-    // type, since they all open the same generic dialog.
     const [openType, setOpenType] = useState(undefined);
-    // The types created inline in a catalog dialog (the rest redirect to a standalone editor).
-    const inCatalogTypes = useMemo(() => {
-        const types = new Set();
-        if (showMetricEditor) {
-            types.add(ObjectTypes.METRIC);
-        }
-        if (showParameter) {
-            types.add(ObjectTypes.PARAMETER);
-        }
-        return types;
-    }, [showMetricEditor, showParameter]);
+    // Widened to the full create-menu vocabulary so redirect-only types can be membership-tested.
+    const inCatalogTypes = useCreatableObjectTypes();
     const items = useMemo(() => {
         const externalLinkIcon = _jsx(MenuItemIcon, { type: "externalLink" });
         const interactiveItem = (type, redirects) => ({
@@ -38,21 +27,20 @@ export function CreateObjectButton({ onCreateObject, showParameter, showMetricEd
             id: type,
             stringTitle: getObjectTypeLabel(intl, type),
             iconLeft: _jsx(MenuItemIcon, { type: icons[type] }),
-            // A redirect create leaves the catalog for the standalone editor; an in-catalog create
-            // opens a dialog and needs no external-link affordance.
             iconRight: redirects ? externalLinkIcon : undefined,
             data: type,
         });
-        // A separator divides creates that redirect to a standalone editor from those handled inline
-        // in a catalog dialog. Metric switches sides: it redirects unless its in-catalog editor is on.
+        // Metric and visualization redirect to a standalone editor unless their in-catalog editor is on.
         return [
             interactiveItem(ObjectTypes.DASHBOARD, true),
-            interactiveItem(ObjectTypes.VISUALIZATION, true),
-            ...(showMetricEditor ? [] : [interactiveItem(ObjectTypes.METRIC, true)]),
+            ...(inCatalogTypes.has(ObjectTypes.VISUALIZATION)
+                ? []
+                : [interactiveItem(ObjectTypes.VISUALIZATION, true)]),
+            ...(inCatalogTypes.has(ObjectTypes.METRIC) ? [] : [interactiveItem(ObjectTypes.METRIC, true)]),
             { type: "separator" },
             ...[...inCatalogTypes].map((type) => interactiveItem(type, false)),
         ];
-    }, [intl, inCatalogTypes, showMetricEditor]);
+    }, [intl, inCatalogTypes]);
     const handleSelect = useCallback((item, _event) => {
         if (inCatalogTypes.has(item.data)) {
             setOpenType(item.data);

package/esm/index.d.ts

@@ -1,6 +1,8 @@
 export { AnalyticsCatalog, type IAnalyticsCatalogProps } from "./AnalyticsCatalog.js";
 export { AnalyticsCatalogDetail, type IAnalyticsCatalogDetailProps, AnalyticsCatalogDetailContent, type IAnalyticsCatalogDetailContentProps, } from "./AnalyticsCatalogDetail.js";
 export { AnalyticsCatalogFilter, type IAnalyticsCatalogFilterProps } from "./AnalyticsCatalogFilter.js";
+export { InsightCodecProvider, type IInsightCodec, type VisualizationTypePredicate, } from "./insight/insightCodecContext.js";
+export type { IAsCodeEditing, AsCodeValidation, AsCodeValidationContext } from "./asCode/descriptor.js";
 export type { ICatalogDetailProps } from "./catalogDetail/CatalogDetail.js";
 export type { EditHandlerEvent, OpenHandlerEvent } from "./catalogDetail/types.js";
 export type { ICatalogDetailContentProps } from "./catalogDetail/CatalogDetailContent.js";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACH,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,6BAA6B,EAC7B,KAAK,mCAAmC,GAC3C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,KAAK,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAMxG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACjF,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACH,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,6BAA6B,EAC7B,KAAK,mCAAmC,GAC3C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,KAAK,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAMxG,OAAO,EACH,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,0BAA0B,GAClC,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAMxG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACjF,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,yBAAyB,CAAC"}

package/esm/index.js

@@ -6,4 +6,9 @@
 export { AnalyticsCatalog } from "./AnalyticsCatalog.js";
 export { AnalyticsCatalogDetail, AnalyticsCatalogDetailContent, } from "./AnalyticsCatalogDetail.js";
 export { AnalyticsCatalogFilter } from "./AnalyticsCatalogFilter.js";
+/*
+ * Visualization as-code codec injection. The host supplies the Tiger-coupled AAC codec so this package
+ * stays backend-agnostic; without it, visualizations fall back to Analytical Designer.
+ */
+export { InsightCodecProvider, } from "./insight/insightCodecContext.js";
 export { isCatalogItemAttribute, isCatalogItemDashboard, isCatalogItemDataSet, isCatalogItemFact, isCatalogItemInsight, isCatalogItemMeasure, isCatalogItemParameter, } from "./catalogItem/guards.js";

package/esm/insight/gate.d.ts

@@ -0,0 +1,4 @@
+/** The flag gating the in-catalog visualization editor, referenced by
+ *  `visualizationDescriptor.featureFlag`. */
+export declare const VISUALIZATION_EDITOR_FEATURE_FLAG = "enableAnalyticalCatalogVisualizationEditor";
+//# sourceMappingURL=gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/insight/gate.ts"],"names":[],"mappings":"AAEA;6CAC6C;AAC7C,eAAO,MAAM,iCAAiC,+CAA+C,CAAC"}

package/esm/insight/gate.js

@@ -0,0 +1,4 @@
+// (C) 2026 GoodData Corporation
+/** The flag gating the in-catalog visualization editor, referenced by
+ *  `visualizationDescriptor.featureFlag`. */
+export const VISUALIZATION_EDITOR_FEATURE_FLAG = "enableAnalyticalCatalogVisualizationEditor";

package/esm/insight/insightCodecContext.d.ts

@@ -0,0 +1,22 @@
+import { type PropsWithChildren } from "react";
+import type { IInsightDefinition } from "@gooddata/sdk-model";
+import type { IAsCodeEditing } from "../asCode/descriptor.js";
+/** @internal */
+export type IInsightCodec = IAsCodeEditing<IInsightDefinition>;
+/** @internal */
+export type VisualizationTypePredicate = (visualizationType: string) => boolean;
+/** Injects the host-built visualization codec, keeping this package free of the Tiger-coupled convertors. @internal */
+export declare function InsightCodecProvider({ codec, requestLoad, isVisualizationTypeEditable, children }: PropsWithChildren<{
+    codec?: IInsightCodec;
+    requestLoad: () => Promise<void>;
+    isVisualizationTypeEditable?: VisualizationTypePredicate;
+}>): import("react/jsx-runtime").JSX.Element;
+/** Whether a host injected the codec machinery; entry points gate on this since without a host the codec never resolves. @internal */
+export declare function useHasInsightCodecHost(): boolean;
+/** The injected codec, or `null` while loading — a pure read; the load is driven by {@link useRequestInsightCodec}. @internal */
+export declare function useInsightCodec(): IInsightCodec | null;
+/** The host's codec-load request lever (contract on {@link InsightCodecContextValue}). @internal */
+export declare function useRequestInsightCodec(): () => Promise<void>;
+/** Per-chart-type editability from the host: false with no host, else its predicate (absent predicate ⇒ all editable). @internal */
+export declare function useIsVisualizationTypeEditable(): VisualizationTypePredicate;
+//# sourceMappingURL=insightCodecContext.d.ts.map

package/esm/insight/insightCodecContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insightCodecContext.d.ts","sourceRoot":"","sources":["../../src/insight/insightCodecContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAmD,MAAM,OAAO,CAAC;AAEhG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;AAE/D,gBAAgB;AAChB,MAAM,MAAM,0BAA0B,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC;AAchF,uHAAuH;AACvH,wBAAgB,oBAAoB,CAAC,EACjC,KAAK,EACL,WAAW,EACX,2BAA2B,EAC3B,QAAQ,EACX,EAAE,iBAAiB,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,2BAA2B,CAAC,EAAE,0BAA0B,CAAC;CAC5D,CAAC,2CAMD;AAED,sIAAsI;AACtI,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,mIAAiI;AACjI,wBAAgB,eAAe,IAAI,aAAa,GAAG,IAAI,CAEtD;AAKD,oGAAoG;AACpG,wBAAgB,sBAAsB,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,sIAAoI;AACpI,wBAAgB,8BAA8B,IAAI,0BAA0B,CAQ3E"}

package/esm/insight/insightCodecContext.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { createContext, useCallback, useContext, useMemo } from "react";
+const InsightCodecContext = createContext(null);
+/** Injects the host-built visualization codec, keeping this package free of the Tiger-coupled convertors. @internal */
+export function InsightCodecProvider({ codec, requestLoad, isVisualizationTypeEditable, children, }) {
+    const value = useMemo(() => ({ codec, requestLoad, isVisualizationTypeEditable }), [codec, requestLoad, isVisualizationTypeEditable]);
+    return _jsx(InsightCodecContext.Provider, { value: value, children: children });
+}
+/** Whether a host injected the codec machinery; entry points gate on this since without a host the codec never resolves. @internal */
+export function useHasInsightCodecHost() {
+    return useContext(InsightCodecContext) !== null;
+}
+/** The injected codec, or `null` while loading — a pure read; the load is driven by {@link useRequestInsightCodec}. @internal */
+export function useInsightCodec() {
+    return useContext(InsightCodecContext)?.codec ?? null;
+}
+// No host: a resolved no-op so the (gated-unreachable) request effect neither fetches nor crashes.
+const noCodecHost = () => Promise.resolve();
+/** The host's codec-load request lever (contract on {@link InsightCodecContextValue}). @internal */
+export function useRequestInsightCodec() {
+    return useContext(InsightCodecContext)?.requestLoad ?? noCodecHost;
+}
+/** Per-chart-type editability from the host: false with no host, else its predicate (absent predicate ⇒ all editable). @internal */
+export function useIsVisualizationTypeEditable() {
+    const context = useContext(InsightCodecContext);
+    const hasHost = context !== null;
+    const isVisualizationTypeEditable = context?.isVisualizationTypeEditable;
+    return useCallback((visualizationType) => hasHost && (isVisualizationTypeEditable?.(visualizationType) ?? true), [hasHost, isVisualizationTypeEditable]);
+}

package/esm/insight/insightCopy.d.ts

@@ -0,0 +1,4 @@
+import type { IInsightDefinition } from "@gooddata/sdk-model";
+/** Duplicate: bump the title, copy only author-owned fields — the source's identity/audit fields must not reach create. */
+export declare function createCopiedInsight(source: IInsightDefinition): IInsightDefinition;
+//# sourceMappingURL=insightCopy.d.ts.map

package/esm/insight/insightCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insightCopy.d.ts","sourceRoot":"","sources":["../../src/insight/insightCopy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,6HAA2H;AAC3H,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAqBlF"}

package/esm/insight/insightCopy.js

@@ -0,0 +1,25 @@
+// (C) 2026 GoodData Corporation
+import { deriveCopyIdentity } from "../asCode/copy.js";
+/** Duplicate: bump the title, copy only author-owned fields — the source's identity/audit fields must not reach create. */
+export function createCopiedInsight(source) {
+    const { insight } = source;
+    const { title } = deriveCopyIdentity({ title: insight.title });
+    return {
+        insight: {
+            title: title ?? insight.title,
+            visualizationUrl: insight.visualizationUrl,
+            buckets: insight.buckets,
+            filters: insight.filters,
+            sorts: insight.sorts,
+            properties: insight.properties,
+            ...(insight.tags === undefined ? {} : { tags: insight.tags }),
+            ...(insight.summary === undefined ? {} : { summary: insight.summary }),
+            ...(insight.attributeFilterConfigs === undefined
+                ? {}
+                : { attributeFilterConfigs: insight.attributeFilterConfigs }),
+            ...(insight.parameters === undefined ? {} : { parameters: insight.parameters }),
+            ...(insight.layers === undefined ? {} : { layers: insight.layers }),
+            ...(insight.isHidden === undefined ? {} : { isHidden: insight.isHidden }),
+        },
+    };
+}

package/esm/insight/insightDescriptor.d.ts

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

package/esm/insight/insightDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insightDescriptor.d.ts","sourceRoot":"","sources":["../../src/insight/insightDescriptor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA+CnE;;GAEG;AACH,eAAO,MAAM,uBAAuB,8FA6BlC,CAAC"}

package/esm/insight/insightDescriptor.js

@@ -0,0 +1,69 @@
+// (C) 2026 GoodData Corporation
+import { defineMessages } from "react-intl";
+import { defineAsCodeDescriptor } from "../asCode/descriptor.js";
+import { ObjectTypes } from "../objectType/constants.js";
+import { VISUALIZATION_EDITOR_FEATURE_FLAG } from "./gate.js";
+import { useHasInsightCodecHost, useInsightCodec, useIsVisualizationTypeEditable, useRequestInsightCodec, } from "./insightCodecContext.js";
+import { createCopiedInsight } from "./insightCopy.js";
+import { countInsightReferences, createInsightMutationAdapter, loadInsight } from "./insightMutationPort.js";
+const VISUALIZATION_DOCS_URL = "https://www.gooddata.ai/docs/cloud/api-and-sdk/vs-code-extension/structures/#visualisation";
+const messages = defineMessages({
+    createTitle: { id: "analyticsCatalog.visualization.dialog.create.title" },
+    editTitle: { id: "analyticsCatalog.visualization.dialog.edit.title" },
+    duplicate: { id: "analyticsCatalog.visualization.dialog.edit.duplicate" },
+    createDefaultTitle: { id: "analyticsCatalog.visualization.create.defaultTitle" },
+    createSuccess: { id: "analyticsCatalog.visualization.create.success" },
+    updateSuccess: { id: "analyticsCatalog.visualization.update.success" },
+    sectionHeader: { id: "analyticsCatalog.visualization.dialog.sectionHeader" },
+    sectionHeaderTooltip: { id: "analyticsCatalog.visualization.dialog.sectionHeader.tooltip" },
+    help: { id: "analyticsCatalog.visualization.dialog.help" },
+    submitError: { id: "analyticsCatalog.visualization.dialog.submit.error" },
+    deleteTitle: { id: "analyticsCatalog.visualization.dialog.delete.title" },
+    deleteBody: { id: "analyticsCatalog.visualization.dialog.delete.body" },
+    deleteSubmit: { id: "analyticsCatalog.visualization.dialog.delete.submit" },
+    deleteSuccess: { id: "analyticsCatalog.visualization.delete.success" },
+    deleteError: { id: "analyticsCatalog.visualization.delete.error" },
+});
+const capabilityMessages = defineMessages({
+    loadError: { id: "analyticsCatalog.visualization.load.error" },
+    deleteUsageWarning: { id: "analyticsCatalog.visualization.dialog.delete.usageWarning" },
+});
+const actionMessages = defineMessages({
+    openInAnalyticalDesigner: { id: "analyticsCatalog.visualization.actions.openInAnalyticalDesigner" },
+});
+function useIsInsightItemEditable(item) {
+    return useIsVisualizationTypeEditable()(item.visualizationType);
+}
+/**
+ * @internal
+ */
+export const visualizationDescriptor = defineAsCodeDescriptor({
+    objectType: ObjectTypes.VISUALIZATION,
+    docsUrl: VISUALIZATION_DOCS_URL,
+    featureFlag: VISUALIZATION_EDITOR_FEATURE_FLAG,
+    messages,
+    useEditing: useInsightCodec,
+    useRequestEditing: useRequestInsightCodec,
+    useIsItemEditable: useIsInsightItemEditable,
+    // Without a host-injected codec the editor can never resolve, so creation falls back to Analytical Designer.
+    useCreateGate: useHasInsightCodecHost,
+    createMutationPort: createInsightMutationAdapter,
+    emptyDefinition: (defaultTitle) => ({
+        insight: {
+            title: defaultTitle,
+            visualizationUrl: "local:table",
+            buckets: [],
+            filters: [],
+            sorts: [],
+            properties: {},
+        },
+    }),
+    seed: { load: loadInsight, loadError: capabilityMessages.loadError },
+    referenceCounted: {
+        count: countInsightReferences,
+        usageWarning: capabilityMessages.deleteUsageWarning,
+    },
+    // No identity: an insight definition has no id field, and creates never carry one (backend-assigned).
+    toCopy: createCopiedInsight,
+    openAction: actionMessages.openInAnalyticalDesigner,
+});

package/esm/insight/insightMutationPort.d.ts

@@ -0,0 +1,13 @@
+import type { IAnalyticalBackend } from "@gooddata/sdk-backend-spi";
+import { type IInsightDefinition } from "@gooddata/sdk-model";
+import type { IAsCodeMutationPort } from "../asCode/descriptor.js";
+import type { ICatalogItemInsight } from "../catalogItem/types.js";
+/** @internal */
+export type IInsightMutationPort = IAsCodeMutationPort<IInsightDefinition, ICatalogItemInsight>;
+/** Fetches the full insight for editing (the catalog item carries only metadata). @internal */
+export declare function loadInsight(backend: IAnalyticalBackend, workspace: string, item: ICatalogItemInsight): Promise<IInsightDefinition>;
+/** Counts the dashboards referencing an insight. @internal */
+export declare function countInsightReferences(backend: IAnalyticalBackend, workspace: string, item: ICatalogItemInsight): Promise<number>;
+/** @internal */
+export declare function createInsightMutationAdapter(backend: IAnalyticalBackend, workspace: string): IInsightMutationPort;
+//# sourceMappingURL=insightMutationPort.d.ts.map

package/esm/insight/insightMutationPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insightMutationPort.d.ts","sourceRoot":"","sources":["../../src/insight/insightMutationPort.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAiB,KAAK,kBAAkB,EAAoB,MAAM,qBAAqB,CAAC;AAE/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,gBAAgB;AAChB,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;AAEhG,+FAA+F;AAC/F,wBAAgB,WAAW,CACvB,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,8DAA8D;AAC9D,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAMjB;AAoBD,gBAAgB;AAChB,wBAAgB,4BAA4B,CACxC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAClB,oBAAoB,CAsBtB"}

package/esm/insight/insightMutationPort.js

@@ -0,0 +1,59 @@
+// (C) 2026 GoodData Corporation
+import { idRef, isInsight } from "@gooddata/sdk-model";
+import { convertInsightToCatalogItem } from "../catalogItem/converter.js";
+/** Fetches the full insight for editing (the catalog item carries only metadata). @internal */
+export function loadInsight(backend, workspace, item) {
+    // loadUserData so the base carries createdBy/updatedBy: updateInsight echoes its input rather than
+    // the server response, so without them the saved catalog item shows blank authors.
+    return backend
+        .workspace(workspace)
+        .insights()
+        .getInsight(idRef(item.identifier, "insight"), { loadUserData: true });
+}
+/** Counts the dashboards referencing an insight. @internal */
+export async function countInsightReferences(backend, workspace, item) {
+    const referencing = await backend
+        .workspace(workspace)
+        .insights()
+        .getInsightReferencingObjects(idRef(item.identifier, "insight"));
+    return referencing.analyticalDashboards?.length ?? 0;
+}
+function pickInsightIdentity(insight) {
+    const { identifier, uri, ref, isLocked, certification } = insight;
+    const { created, updated, createdBy, updatedBy } = insight;
+    return {
+        identifier,
+        uri,
+        ref,
+        isLocked,
+        certification,
+        created,
+        updated,
+        createdBy,
+        updatedBy,
+    };
+}
+/** @internal */
+export function createInsightMutationAdapter(backend, workspace) {
+    const insights = () => backend.workspace(workspace).insights();
+    return {
+        async create(definition) {
+            return convertInsightToCatalogItem(await insights().createInsight(definition));
+        },
+        async update(base, definition) {
+            if (!isInsight(base) || !base.insight.identifier) {
+                throw new Error("Visualization update requires the loaded insight as base.");
+            }
+            // Definition is authoritative for content (already reconciled); re-attach only identity — a
+            // base overlay would revert a field the editor cleared.
+            const saved = await insights().updateInsight({
+                ...base,
+                insight: { ...definition.insight, ...pickInsightIdentity(base.insight) },
+            });
+            return convertInsightToCatalogItem(saved);
+        },
+        async delete(ref) {
+            await insights().deleteInsight(idRef(ref.identifier, "insight"));
+        },
+    };
+}