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

package/esm/asCode/descriptor.d.ts

@@ -5,64 +5,26 @@ import type { ICatalogItem, ICatalogItemRef } from "../catalogItem/types.js";
 import type { ObjectTypes } from "../objectType/constants.js";
 import type { ObjectType } from "../objectType/types.js";
 import type { useFeatureFlag } from "../permission/PermissionsContext.js";
-/** A feature-flag name, as accepted by {@link useFeatureFlag}. */
 export type AsCodeFeatureFlag = Parameters<typeof useFeatureFlag>[0];
-/**
- * The catalog object types editable as code. Add a member and the registry won't compile until it
- * registers a descriptor for the new type, whose own type then forces every field.
- */
-export type AsCodeObjectType = typeof ObjectTypes.METRIC | typeof ObjectTypes.PARAMETER;
-/**
- * The one field the generic layer reads off any as-code definition: an optional identity. Everything
- * else about a definition stays opaque to that layer.
- */
-export interface IAsCodeDefinition {
-    id?: string;
-}
-/**
- * The entity-specific strings a generic as-code dialog needs. The generic chrome (Create/Save/Cancel/
- * Duplicate, the "Error:" label) is shared and lives in the dialog, not here — these are only the
- * strings that name or describe the entity.
- */
+export type AsCodeObjectType = typeof ObjectTypes.METRIC | typeof ObjectTypes.PARAMETER | typeof ObjectTypes.VISUALIZATION;
 export interface IAsCodeMessages {
     createTitle: MessageDescriptor;
     editTitle: MessageDescriptor;
-    /** Label of the duplicate action (edit-dialog button + detail menu); per-entity — a metric says
-     *  "Duplicate", a parameter "Save as new". */
     duplicate: MessageDescriptor;
-    /** Default title seeded into a blank create. */
     createDefaultTitle: MessageDescriptor;
     createSuccess: MessageDescriptor;
     updateSuccess: MessageDescriptor;
-    /** Heading above the editor, e.g. "Metric definition". */
     sectionHeader: MessageDescriptor;
-    /** Tooltip explaining what the YAML should contain. */
     sectionHeaderTooltip: MessageDescriptor;
-    /** Text of the docs link, e.g. "How to write a metric". */
     help: MessageDescriptor;
-    /** Fallback shown when a save fails without a backend detail. */
     submitError: MessageDescriptor;
-    /**
-     * Shown when fetching the object to edit fails. A type that defines `port.load` should provide it;
-     * without it a load failure closes the dialog silently. A type that never loads omits it.
-     */
-    loadError?: MessageDescriptor;
     deleteTitle: MessageDescriptor;
-    /** Confirmation body; receives the object's `name` and a `b` bold-chunk renderer. */
     deleteBody: MessageDescriptor;
     deleteSubmit: MessageDescriptor;
     deleteSuccess: MessageDescriptor;
     deleteError: MessageDescriptor;
-    /**
-     * Warns that other objects depend on this one; receives their `count`. Only types that report a
-     * referencing count (see `port.getReferencingObjectsCount`) provide it.
-     */
-    deleteUsageWarning?: MessageDescriptor;
 }
-/**
- * Outcome of validating YAML: the parsed definition, or an already-localized error message. The entity
- * localizes the error itself, so there is no shared error-code vocabulary.
- */
+/** @internal */
 export type AsCodeValidation<TDef> = {
     isValid: true;
     definition: TDef;
@@ -71,90 +33,102 @@ export type AsCodeValidation<TDef> = {
     error: string;
 };
 /**
- * The per-entity editing behavior. Everything here can depend on the entity's own runtime context
- * (e.g. a parameter's enabled types), which is why it is delivered through a hook rather than as static
- * fields: the entity gathers its context, the generic shell never has to know about it.
+ * Identity rule per flow: `edit` keeps `fixedIdentifier`; `duplicate` accepts and ignores any id (the
+ * copy re-derives identity downstream); `create` applies the entity's own id policy.
+ * @internal
  */
-export interface IAsCodeEditing<TDef extends IAsCodeDefinition> {
-    /** Autocompletion source fed to the shared `<YamlEditor>`. */
+export type AsCodeValidationContext = {
+    intent: "create";
+} | {
+    intent: "edit";
+    fixedIdentifier: string;
+} | {
+    intent: "duplicate";
+};
+/** @internal */
+export declare function fixedIdentifierOf(context: AsCodeValidationContext): string | undefined;
+/** @internal */
+export interface IAsCodeEditing<TDef> {
     completionSource: CompletionSource;
-    /** Localized message the editor's inline linter shows on a YAML syntax error. */
     syntaxErrorMessage: string;
-    /** Renders a definition to the YAML seed shown in the editor. */
     serialize(definition: TDef): string;
-    /**
-     * Parses + validates YAML, returning the definition or a localized error. Identity is fixed while
-     * editing via `fixedIdentifier`.
-     */
-    validate(value: string, options: {
-        fixedIdentifier?: string;
-    }): AsCodeValidation<TDef>;
+    validate(value: string, context: AsCodeValidationContext): AsCodeValidation<TDef>;
+    /** Re-adds content the YAML can't express; applied on every persisting path. Omit if lossless. */
+    reconcile?(base: TDef, edited: TDef): TDef;
 }
 /**
- * Backend operations for one catalog as-code object type. Everything flows in the definition shape:
- * `load` returns the full editable definition (a metric's loaded measure already is one), and `update`
- * takes that as its `base`.
- *
- * `load` and `getReferencingObjectsCount` are optional capabilities. A type whose catalog item already
- * holds everything the editor needs omits `load` and supplies `editSeed` on the descriptor instead; a
- * type that tracks no referencing objects omits `getReferencingObjectsCount` (delete shows no warning).
+ * `update`'s `definition` (already reconciled) is authoritative for content; `base` supplies only the
+ * server-managed identity the definition shape cannot carry.
  */
-export interface IAsCodeMutationPort<TDef extends IAsCodeDefinition = IAsCodeDefinition, TItem extends ICatalogItem = ICatalogItem> {
+export interface IAsCodeMutationPort<TDef = unknown, TItem extends ICatalogItem = ICatalogItem> {
     create(definition: TDef): Promise<TItem>;
     update(base: TDef, definition: TDef): Promise<TItem>;
     delete(ref: ICatalogItemRef): Promise<void>;
-    load?(item: TItem): Promise<TDef>;
-    /** How many objects reference this one — used to warn before deletion. */
-    getReferencingObjectsCount?(item: TItem): Promise<number>;
 }
 /**
- * The contract one entity type implements so the shared as-code shell (dialogs, mutation ports, detail
- * actions) can drive it. Adding a type is "write one descriptor and register it"; the shell never
- * imports the concrete type.
- *
- * `useEditing` is a hook and differs in shape across types, so a component that calls it must bind to
- * ONE descriptor per mount and remount when the type changes (the detail dispatch keys on `objectType`
- * for this) — otherwise the hook order would shift and break the rules of hooks.
+ * The `never` fields keep the variants exclusive: excess-property checking runs per union constituent,
+ * so without them a literal mixing both (e.g. `load` with no `loadError`) would typecheck.
+ * @internal
+ */
+export type AsCodeSeed<TDef, TItem extends ICatalogItem> = {
+    editSeed(item: TItem): TDef;
+    load?: never;
+    loadError?: never;
+} | {
+    editSeed?: never;
+    load(backend: IAnalyticalBackend, workspace: string, item: TItem): Promise<TDef>;
+    loadError: MessageDescriptor;
+};
+/** @internal */
+export declare function isLoadSeed<TDef, TItem extends ICatalogItem>(seed: AsCodeSeed<TDef, TItem>): seed is Extract<AsCodeSeed<TDef, TItem>, {
+    loadError: MessageDescriptor;
+}>;
+/** @internal */
+export declare function loadErrorOf(descriptor: IAsCodeDescriptor): MessageDescriptor | undefined;
+/** @internal */
+export type AsCodeReferenceCount<TItem extends ICatalogItem> = {
+    count(backend: IAnalyticalBackend, workspace: string, item: TItem): Promise<number>;
+    usageWarning: MessageDescriptor;
+};
+/**
+ * Duplicate-collision retry: the create dialog retries without the id when a copy's derived id
+ * collides. Omitted by a type whose creates never carry an id.
+ * @internal
+ */
+export type AsCodeIdentity<TDef> = {
+    read(definition: TDef): string | undefined;
+    strip(definition: TDef): TDef;
+};
+/**
+ * A component calling `useEditing` (or the other hooks here) must bind to ONE descriptor per mount and
+ * remount when the type changes (the detail dispatch keys on `objectType`), or the hook order shifts
+ * and breaks the rules of hooks.
  */
-export interface IAsCodeDescriptor<TDef extends IAsCodeDefinition = IAsCodeDefinition, TItem extends ICatalogItem = ICatalogItem> {
+export interface IAsCodeDescriptor<TDef = unknown, TItem extends ICatalogItem = ICatalogItem> {
     objectType: ObjectType;
     docsUrl: string;
-    /**
-     * Gates whether this type's in-catalog editor is offered, paired with the per-item edit
-     * permission. Omit it for a type that is always editable (no feature-flag gate).
-     */
     featureFlag?: AsCodeFeatureFlag;
     messages: IAsCodeMessages;
-    /** The entity's per-mount editing behavior; a hook so it can read its own context. */
-    useEditing(): IAsCodeEditing<TDef>;
-    /** Builds this type's backend adapter; the mutation provider calls it once per backend/workspace. */
-    createMutationPort(backend: IAnalyticalBackend, workspace: string): IAsCodeMutationPort<TDef, TItem>;
-    /** A blank definition for a fresh create, seeded with a default title. */
-    emptyDefinition(defaultTitle: string): TDef;
+    /** `null` while an async editing brain is still loading. */
+    useEditing(): IAsCodeEditing<TDef> | null;
     /**
-     * Maps a catalog item to its editable definition without a fetch. Provided by types whose item
-     * already holds everything the editor needs; a type that must fetch (see `port.load`) omits it.
-     * A descriptor provides exactly one of `editSeed` / `port.load`.
+     * Starts/retries building the async editing brain; the promise rejects when it can't be built. The
+     * returned function must keep a stable identity while the request target is unchanged — it is an
+     * effect dependency, so a new identity re-issues the request.
      */
-    editSeed?(item: TItem): TDef;
-    /** Derives a duplicate's definition from a source definition (bumps title, re-derives identity). */
+    useRequestEditing?(): () => Promise<void>;
+    useIsItemEditable?(item: TItem): boolean;
+    /** Extra requirement for creation, ANDed with the feature flag and manage permission. */
+    useCreateGate?(): boolean;
+    createMutationPort(backend: IAnalyticalBackend, workspace: string): IAsCodeMutationPort<TDef, TItem>;
+    emptyDefinition(defaultTitle: string): TDef;
+    seed: AsCodeSeed<TDef, TItem>;
+    referenceCounted?: AsCodeReferenceCount<TItem>;
+    identity?: AsCodeIdentity<TDef>;
     toCopy(source: TDef): TDef;
-    /**
-     * Overlays the author's parsed YAML edits onto the full definition, re-adding fields the YAML
-     * cannot express (metric: metricType/isHiddenFromKda). Used both to seed a duplicate from the open
-     * editor and to reconcile a duplicate on save. Omitted — meaning `(_, parsed) => parsed` — for
-     * types whose YAML round-trips 1:1 to the definition (parameter).
-     */
-    applyYamlEdits?(full: TDef, parsed: TDef): TDef;
-    /**
-     * Label of the action that opens the object in its standalone editor; declaring it signals the type
-     * has such an editor. Omit it for a type with none (a parameter).
-     */
+    /** Presence signals the type has a standalone editor; its label opens it. */
     openAction?: MessageDescriptor;
 }
-/**
- * Identity helper that keeps a descriptor's generics inferred at authoring while letting the registry
- * store it widened, so the generic components never have to narrow.
- */
-export declare function defineAsCodeDescriptor<TDef extends IAsCodeDefinition, TItem extends ICatalogItem>(descriptor: IAsCodeDescriptor<TDef, TItem>): IAsCodeDescriptor<TDef, TItem>;
+/** Infers a descriptor's generics at authoring while the registry stores it widened. */
+export declare function defineAsCodeDescriptor<TDef, TItem extends ICatalogItem>(descriptor: IAsCodeDescriptor<TDef, TItem>): IAsCodeDescriptor<TDef, TItem>;
 //# sourceMappingURL=descriptor.d.ts.map

package/esm/asCode/descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/asCode/descriptor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/asCode/descriptor.ts"],"names":[],"mappings":"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"}

package/esm/asCode/descriptor.js

@@ -1,8 +1,17 @@
 // (C) 2026 GoodData Corporation
-/**
- * Identity helper that keeps a descriptor's generics inferred at authoring while letting the registry
- * store it widened, so the generic components never have to narrow.
- */
+/** @internal */
+export function fixedIdentifierOf(context) {
+    return context.intent === "edit" ? context.fixedIdentifier : undefined;
+}
+/** @internal */
+export function isLoadSeed(seed) {
+    return seed.load !== undefined;
+}
+/** @internal */
+export function loadErrorOf(descriptor) {
+    return isLoadSeed(descriptor.seed) ? descriptor.seed.loadError : undefined;
+}
+/** Infers a descriptor's generics at authoring while the registry stores it widened. */
 export function defineAsCodeDescriptor(descriptor) {
     return descriptor;
 }

package/esm/asCode/serverIdentity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A saved object's server-managed fields (those beyond its definition). The Pick keeps required
+ * saved-only fields required, so a new one fails the build at the pick rather than being dropped.
+ * @internal
+ */
+export type ServerIdentity<TSaved, TDef> = Pick<TSaved, Exclude<keyof TSaved, keyof TDef>>;
+//# sourceMappingURL=serverIdentity.d.ts.map

package/esm/asCode/serverIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverIdentity.d.ts","sourceRoot":"","sources":["../../src/asCode/serverIdentity.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC"}

package/esm/asCode/serverIdentity.js

@@ -0,0 +1,2 @@
+// (C) 2026 GoodData Corporation
+export {};

package/esm/asCode/tests/withMutationPort.d.ts

@@ -0,0 +1,4 @@
+import type { IAsCodeDescriptor, IAsCodeMutationPort } from "../descriptor.js";
+/** A descriptor whose `createMutationPort` yields `port` — the test seam for the mutation adapter. */
+export declare function withMutationPort(descriptor: IAsCodeDescriptor, port: IAsCodeMutationPort): IAsCodeDescriptor;
+//# sourceMappingURL=withMutationPort.d.ts.map

package/esm/asCode/tests/withMutationPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withMutationPort.d.ts","sourceRoot":"","sources":["../../../src/asCode/tests/withMutationPort.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,wGAAsG;AACtG,wBAAgB,gBAAgB,CAC5B,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,mBAAmB,GAC1B,iBAAiB,CAEnB"}

package/esm/asCode/tests/withMutationPort.js

@@ -0,0 +1,5 @@
+// (C) 2026 GoodData Corporation
+/** A descriptor whose `createMutationPort` yields `port` — the test seam for the mutation adapter. */
+export function withMutationPort(descriptor, port) {
+    return { ...descriptor, createMutationPort: () => port };
+}

package/esm/asCode/useAsCodeBase.d.ts

@@ -1,18 +1,15 @@
 import type { ICatalogItem } from "../catalogItem/types.js";
-import type { IAsCodeDefinition, IAsCodeDescriptor, IAsCodeMutationPort } from "./descriptor.js";
+import { type IAsCodeDescriptor, type IAsCodeMutationPort } from "./descriptor.js";
 type AsCodeBase = {
-    /** The editable definition for the item, or `undefined` while loading / when no item was given. */
-    base: IAsCodeDefinition | undefined;
+    base: unknown;
     isLoading: boolean;
     port: IAsCodeMutationPort;
 };
 /**
- * Resolves an existing item's editable definition for the edit dialog and for the create dialog when
- * duplicating. A fetching type (metric, `port.load`) resolves asynchronously; a mapping type
- * (parameter, `editSeed`) resolves synchronously, so it never flashes a loading state. `onError` fires
- * on a failed fetch; an `undefined` item (a blank create) resolves to nothing.
+ * Resolves an item's editable definition — async for a `seed.load` type, sync for `seed.editSeed`. A
+ * failed fetch toasts the seed's `loadError` and calls `onClose`.
  * @internal
  */
-export declare function useAsCodeBase(descriptor: IAsCodeDescriptor, item: ICatalogItem | undefined, onError: () => void): AsCodeBase;
+export declare function useAsCodeBase(descriptor: IAsCodeDescriptor, item: ICatalogItem | undefined, onClose: () => void): AsCodeBase;
 export {};
 //# sourceMappingURL=useAsCodeBase.d.ts.map

package/esm/asCode/useAsCodeBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAsCodeBase.d.ts","sourceRoot":"","sources":["../../src/asCode/useAsCodeBase.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjG,KAAK,UAAU,GAAG;IACd,mGAAmG;IACnG,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CACzB,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,IAAI,GACpB,UAAU,CAsBZ"}
+{"version":3,"file":"useAsCodeBase.d.ts","sourceRoot":"","sources":["../../src/asCode/useAsCodeBase.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAc,MAAM,iBAAiB,CAAC;AAI/F,KAAK,UAAU,GAAG;IACd,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,IAAI,GACpB,UAAU,CAsBZ"}

package/esm/asCode/useAsCodeBase.js

@@ -1,27 +1,29 @@
 // (C) 2026 GoodData Corporation
-import { useCancelablePromise } from "@gooddata/sdk-ui";
-import { useAsCodePort } from "./AsCodeMutationContext.js";
+import { useBackendStrict, useCancelablePromise, useWorkspaceStrict } from "@gooddata/sdk-ui";
+import { isLoadSeed } from "./descriptor.js";
+import { useAsCodeLoadFailure } from "./useAsCodeLoadFailure.js";
+import { useMutationPort } from "./useMutationPort.js";
 /**
- * Resolves an existing item's editable definition for the edit dialog and for the create dialog when
- * duplicating. A fetching type (metric, `port.load`) resolves asynchronously; a mapping type
- * (parameter, `editSeed`) resolves synchronously, so it never flashes a loading state. `onError` fires
- * on a failed fetch; an `undefined` item (a blank create) resolves to nothing.
+ * Resolves an item's editable definition — async for a `seed.load` type, sync for `seed.editSeed`. A
+ * failed fetch toasts the seed's `loadError` and calls `onClose`.
  * @internal
  */
-export function useAsCodeBase(descriptor, item, onError) {
-    const port = useAsCodePort(descriptor.objectType);
-    const load = port.load;
-    const { result: loaded } = useCancelablePromise({ promise: item && load ? () => load(item) : undefined, onError }, [item, port]);
+export function useAsCodeBase(descriptor, item, onClose) {
+    const backend = useBackendStrict();
+    const workspace = useWorkspaceStrict();
+    const fail = useAsCodeLoadFailure(descriptor, onClose);
+    const port = useMutationPort(descriptor);
+    const seed = descriptor.seed;
+    const load = isLoadSeed(seed) ? seed.load : undefined;
+    const { result: loaded } = useCancelablePromise({
+        promise: item && load ? () => load(backend, workspace, item) : undefined,
+        onError: fail,
+    }, [item, backend, workspace]);
     if (item === undefined) {
         return { base: undefined, isLoading: false, port };
     }
-    if (load) {
-        return { base: loaded, isLoading: loaded === undefined, port };
+    if (!isLoadSeed(seed)) {
+        return { base: seed.editSeed(item), isLoading: false, port };
     }
-    if (!descriptor.editSeed) {
-        // A descriptor must provide exactly one of `port.load` / `editSeed`; without either there is
-        // no way to seed the editor. Fail loudly rather than open a silently-blank editor.
-        throw new Error(`As-code descriptor "${descriptor.objectType}" provides neither port.load nor editSeed.`);
-    }
-    return { base: descriptor.editSeed(item), isLoading: false, port };
+    return { base: loaded, isLoading: loaded === undefined, port };
 }

package/esm/asCode/useAsCodeLoadFailure.d.ts

@@ -0,0 +1,8 @@
+import { type IAsCodeDescriptor } from "./descriptor.js";
+/**
+ * Identity-stable across the unstable toast and close identities, so an effect depending on it does
+ * not re-fire.
+ * @internal
+ */
+export declare function useAsCodeLoadFailure(descriptor: IAsCodeDescriptor, onClose: () => void): () => void;
+//# sourceMappingURL=useAsCodeLoadFailure.d.ts.map

package/esm/asCode/useAsCodeLoadFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsCodeLoadFailure.d.ts","sourceRoot":"","sources":["../../src/asCode/useAsCodeLoadFailure.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAe,MAAM,iBAAiB,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAUnG"}

package/esm/asCode/useAsCodeLoadFailure.js

@@ -0,0 +1,21 @@
+// (C) 2026 GoodData Corporation
+import { useCallback } from "react";
+import { useAutoupdateRef } from "@gooddata/sdk-ui";
+import { useToastMessage } from "@gooddata/sdk-ui-kit";
+import { loadErrorOf } from "./descriptor.js";
+/**
+ * Identity-stable across the unstable toast and close identities, so an effect depending on it does
+ * not re-fire.
+ * @internal
+ */
+export function useAsCodeLoadFailure(descriptor, onClose) {
+    const { addError } = useToastMessage();
+    const latest = useAutoupdateRef({ addError, onClose, loadError: loadErrorOf(descriptor) });
+    return useCallback(() => {
+        const { addError, onClose, loadError } = latest.current;
+        if (loadError) {
+            addError(loadError);
+        }
+        onClose();
+    }, [latest]);
+}

package/esm/asCode/useMutationPort.d.ts

@@ -0,0 +1,4 @@
+import type { IAsCodeDescriptor, IAsCodeMutationPort } from "./descriptor.js";
+/** @internal */
+export declare function useMutationPort(descriptor: IAsCodeDescriptor): IAsCodeMutationPort;
+//# sourceMappingURL=useMutationPort.d.ts.map

package/esm/asCode/useMutationPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMutationPort.d.ts","sourceRoot":"","sources":["../../src/asCode/useMutationPort.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,GAAG,mBAAmB,CAIlF"}

package/esm/asCode/useMutationPort.js

@@ -0,0 +1,9 @@
+// (C) 2026 GoodData Corporation
+import { useMemo } from "react";
+import { useBackendStrict, useWorkspaceStrict } from "@gooddata/sdk-ui";
+/** @internal */
+export function useMutationPort(descriptor) {
+    const backend = useBackendStrict();
+    const workspace = useWorkspaceStrict();
+    return useMemo(() => descriptor.createMutationPort(backend, workspace), [backend, descriptor, workspace]);
+}

package/esm/asCode/validateYaml.d.ts

@@ -1,14 +1,21 @@
 import type * as z from "zod/mini";
 /**
- * Neutral result of the shared YAML validation skeleton, before a type shapes it into its own
- * result. `data` is the parsed-and-schema-validated value; the caller converts it to a definition.
+ * Neutral result of the shared YAML validation skeleton, before a type shapes it into its own result.
+ * `data` is the parsed-and-schema-validated value; the caller converts it to a definition. A `schema`
+ * failure hands the caller the `error` and the `parsed` value to classify against its own error codes;
+ * the other kinds are already the codes every as-code type shares.
  */
-export type YamlValidation<TData, TErrorCode extends string> = {
+export type YamlValidation<TData> = {
     ok: true;
     data: TData;
 } | {
     ok: false;
-    errorCode: TErrorCode | "empty" | "syntax" | "idImmutable";
+    kind: "empty" | "syntax" | "idImmutable";
+} | {
+    ok: false;
+    kind: "schema";
+    error: z.core.$ZodError;
+    parsed: unknown;
 };
 type SafeParseSchema<TData> = {
     safeParse(value: unknown): {
@@ -19,21 +26,18 @@ type SafeParseSchema<TData> = {
         error: z.core.$ZodError;
     };
 };
-type ValidateYamlOptions<TData, TErrorCode extends string> = {
+type ValidateYamlOptions<TData> = {
     schema: SafeParseSchema<TData>;
-    /** Maps a schema failure to a type-specific error code. */
-    classifyError: (error: z.core.$ZodError, parsed: unknown) => TErrorCode;
     /** When set, the parsed `id` must match it, else `idImmutable` (identity is fixed while editing). */
     fixedIdentifier?: string;
 };
 /**
- * Runs the steps every as-code YAML shares: reject empty input, parse (strict) YAML, validate
- * against the schema, and enforce identity immutability. Type-specific concerns — the schema, how a
- * schema failure maps to an error code, and how the validated data becomes a definition — are the
- * caller's.
+ * Runs the steps every as-code YAML shares: reject empty input, parse (strict) YAML, validate against
+ * the schema, and enforce identity immutability. The schema itself and the conversion of validated data
+ * into a definition are the caller's.
  */
 export declare function validateYaml<TData extends {
     id?: string;
-}, TErrorCode extends string>(value: string, { schema, classifyError, fixedIdentifier }: ValidateYamlOptions<TData, TErrorCode>): YamlValidation<TData, TErrorCode>;
+}>(value: string, { schema, fixedIdentifier }: ValidateYamlOptions<TData>): YamlValidation<TData>;
 export {};
 //# sourceMappingURL=validateYaml.d.ts.map

package/esm/asCode/validateYaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateYaml.d.ts","sourceRoot":"","sources":["../../src/asCode/validateYaml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;AAEnC;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,EAAE,UAAU,SAAS,MAAM,IACrD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACzB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAA;CAAE,CAAC;AAEhF,KAAK,eAAe,CAAC,KAAK,IAAI;IAC1B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;KAAE,CAAC;CAC3G,CAAC;AAEF,KAAK,mBAAmB,CAAC,KAAK,EAAE,UAAU,SAAS,MAAM,IAAI;IACzD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,KAAK,UAAU,CAAC;IACxE,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,SAAS,MAAM,EACjF,KAAK,EAAE,MAAM,EACb,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,GACnF,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAsBnC"}
+{"version":3,"file":"validateYaml.d.ts","sourceRoot":"","sources":["../../src/asCode/validateYaml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACzB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAA;CAAE,GACvD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E,KAAK,eAAe,CAAC,KAAK,IAAI;IAC1B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;KAAE,CAAC;CAC3G,CAAC;AAEF,KAAK,mBAAmB,CAAC,KAAK,IAAI;IAC9B,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/B,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACtD,KAAK,EAAE,MAAM,EACb,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,mBAAmB,CAAC,KAAK,CAAC,GACxD,cAAc,CAAC,KAAK,CAAC,CAsBvB"}

package/esm/asCode/validateYaml.js

@@ -1,28 +1,27 @@
 // (C) 2026 GoodData Corporation
 import { parse as parseYaml } from "yaml";
 /**
- * Runs the steps every as-code YAML shares: reject empty input, parse (strict) YAML, validate
- * against the schema, and enforce identity immutability. Type-specific concerns — the schema, how a
- * schema failure maps to an error code, and how the validated data becomes a definition — are the
- * caller's.
+ * Runs the steps every as-code YAML shares: reject empty input, parse (strict) YAML, validate against
+ * the schema, and enforce identity immutability. The schema itself and the conversion of validated data
+ * into a definition are the caller's.
  */
-export function validateYaml(value, { schema, classifyError, fixedIdentifier }) {
+export function validateYaml(value, { schema, fixedIdentifier }) {
     if (value.trim() === "") {
-        return { ok: false, errorCode: "empty" };
+        return { ok: false, kind: "empty" };
     }
     let parsed;
     try {
         parsed = parseYaml(value, { strict: true });
     }
     catch {
-        return { ok: false, errorCode: "syntax" };
+        return { ok: false, kind: "syntax" };
     }
     const result = schema.safeParse(parsed);
     if (!result.success) {
-        return { ok: false, errorCode: classifyError(result.error, parsed) };
+        return { ok: false, kind: "schema", error: result.error, parsed };
     }
     if (fixedIdentifier !== undefined && result.data.id !== fixedIdentifier) {
-        return { ok: false, errorCode: "idImmutable" };
+        return { ok: false, kind: "idImmutable" };
     }
     return { ok: true, data: result.data };
 }

package/esm/asCodeRegistry.d.ts

@@ -1,20 +1,11 @@
 import type { AsCodeObjectType, IAsCodeDescriptor } from "./asCode/descriptor.js";
 import type { ObjectType } from "./objectType/types.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
- */
+/** @internal */
 export declare const asCodeDescriptors: Record<AsCodeObjectType, IAsCodeDescriptor>;
-/**
- * The as-code descriptor for a catalog object type, or `undefined` if the type is not editable as code.
- * @internal
- */
+/** @internal */
 export declare function getAsCodeDescriptor(type: ObjectType): IAsCodeDescriptor | 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 declare function useIsAsCodeTypeEditable(descriptor: IAsCodeDescriptor | undefined): boolean;
+/** @internal */
+export declare function useCreatableObjectTypes(): ReadonlySet<AsCodeObjectType>;
 //# sourceMappingURL=asCodeRegistry.d.ts.map

package/esm/asCodeRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asCodeRegistry.d.ts","sourceRoot":"","sources":["../src/asCodeRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAGzE,CAAC;AAMF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAM1F"}
+{"version":3,"file":"asCodeRegistry.d.ts","sourceRoot":"","sources":["../src/asCodeRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAIzE,CAAC;AAMF,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAEnF;AAED,mHAAmH;AACnH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAM1F;AASD,gBAAgB;AAChB,wBAAgB,uBAAuB,IAAI,WAAW,CAAC,gBAAgB,CAAC,CAcvE"}