@gooddata/sdk-ui-ext 11.55.0-alpha.2 → 11.55.0-alpha.4

package/esm/sdk-ui-ext.d.ts

@@ -21,7 +21,7 @@ import { DateFilterGranularity } from '@gooddata/sdk-model';
 import { Dispatch } from 'react';
 import { EmbedType } from '@gooddata/sdk-ui-kit';
 import { ExplicitDrill } from '@gooddata/sdk-ui';
-import type { GeneralAccessValue } from '@gooddata/sdk-ui-kit';
+import { GeneralAccessValue } from '@gooddata/sdk-ui-kit';
 import { GoodDataSdkError } from '@gooddata/sdk-ui';
 import { IAlertComparisonOperator } from '@gooddata/sdk-model';
 import { IAlertRelativeArithmeticOperator } from '@gooddata/sdk-model';
@@ -31,6 +31,7 @@ import { IAutomationMetadataObject } from '@gooddata/sdk-model';
 import { ICatalogAttributeHierarchy } from '@gooddata/sdk-model';
 import { IChartConfig } from '@gooddata/sdk-ui-charts';
 import { IColorPalette } from '@gooddata/sdk-model';
+import { IConditionalFormatting } from '@gooddata/sdk-model';
 import { IConditionalFormattingRule } from '@gooddata/sdk-ui-pivot/next';
 import { IDashboardUrlBuilder } from '@gooddata/sdk-ui';
 import { IDateFilterOptionsByType } from '@gooddata/sdk-ui-filters';
@@ -50,6 +51,7 @@ import { IntlShape } from 'react-intl';
 import type { IObjectAccessList } from '@gooddata/sdk-model';
 import type { IObjectPermissionsObject } from '@gooddata/sdk-backend-spi';
 import { IPivotTableConfig } from '@gooddata/sdk-ui-pivot';
+import { ISemanticConditionalFormatting } from '@gooddata/sdk-model';
 import { ISeparators } from '@gooddata/sdk-model';
 import { ISettings } from '@gooddata/sdk-model';
 import { ITab } from '@gooddata/sdk-ui-kit';
@@ -276,7 +278,7 @@ export declare const COMPARISON_OPERATORS: {
 /**
  * @internal
  */
-export declare function ConditionalFormattingDialog({ rule: initialRule, isNew, targetOptions, separators, dateFilterOptions, dateSettings, alignTo, readOnly, fixedTarget, onSave, onClose }: IConditionalFormattingDialogProps): JSX.Element;
+export declare function ConditionalFormattingDialog({ rule: initialRule, isNew, targetOptions, separators, dateFilterOptions, dateSettings, alignTo, fixedTarget, semanticByTarget, onDelete, onRevertToDefault, onSave, onClose }: IConditionalFormattingDialogProps): JSX.Element;
 
 /**
  * @internal
@@ -427,6 +429,17 @@ export declare const fluidLayoutDescriptor: FluidLayoutDescriptor;
  */
 export declare const getComparisonOperatorTitle: (operator: IAlertComparisonOperator, intl: IntlShape) => string;
 
+/**
+ * The conditional formatting config that should currently apply to an insight: gated behind the
+ * feature flag and behind the insight actually being a next-gen pivot table (disabled/not-a-pivot-
+ * table means no config at all, so there is no UI to edit rules a viewer can't see take effect, and
+ * a chart/geo export never picks up stale CF left over from a since-changed visualization type),
+ * preferring a runtime override (e.g. InsightView's config prop) over the insight's own saved rules.
+ *
+ * @internal
+ */
+export declare function getEffectiveConditionalFormatting(insight: IInsightDefinition, settings: ISettings | undefined, configOverride?: IConditionalFormatting): IConditionalFormatting | undefined;
+
 /**
  * @internal
  */
@@ -447,6 +460,43 @@ export declare function getInsightWithAppliedDrillDown(insight: IInsight, drillE
  */
 export declare const getRelativeOperatorTitle: (operator: IAlertRelativeOperator, art: IAlertRelativeArithmeticOperator, intl: IntlShape) => string;
 
+/**
+ * A transient edit overlaid on a fetched grantee row (keyed by grantee id in
+ * `mergeGrantees`). The pending-guard keeps at most one edit in flight per id.
+ * A pending edit that superseded an already-COMMITTED entry (an added row, an
+ * earlier level change) carries it as `settled`, because the fetched base no longer
+ * holds that row's last-settled state: failure restores `settled`, success drops it.
+ * With no `settled`, failure deletes the entry, reverting to the fetched row.
+ *
+ * @internal
+ */
+export declare type GranteeEdit = {
+    kind: "level";
+    level: ObjectSharePermissionLevel;
+    pending: boolean;
+    settled?: GranteeEdit;
+} | {
+    kind: "added";
+    grantee: IObjectShareGrantee;
+    pending: boolean;
+    settled?: GranteeEdit;
+} | {
+    kind: "removed";
+    pending: boolean;
+    settled?: GranteeEdit;
+}
+/**
+* Pending marker only — the row renders exactly as it stands. For a write that
+* locks the row without changing its access (a label-scope edit), so nothing has
+* to invent a level: reusing the `level` overlay would record the DISPLAYED level
+* as the direct grant, and that level is the effective one.
+*/
+| {
+    kind: "locked";
+    pending: boolean;
+    settled?: GranteeEdit;
+};
+
 /**
  * @internal
  */
@@ -602,10 +652,25 @@ export declare interface IConditionalFormattingDialogProps {
     dateSettings?: ICfDateSettings;
     /** CSS selector of a small, stable element the popover anchors to. */
     alignTo: string;
-    /** Renders the dialog non-interactively: no target picker, no editing, no Save button. */
-    readOnly?: boolean;
     /** Renders a static "icon + title" header for the rule's target instead of the picker dropdown. */
     fixedTarget?: boolean;
+    /**
+     * Semantic-layer rules by target localId. When the current target has an entry, the dialog
+     * offers the "Use default rule" checkbox switching between the inherited rule (locked) and an
+     * authored override (editable) — the whole map (not one resolved value) so an untargeted "Add
+     * rule" flow re-derives the right fallback if the user changes target mid-dialog.
+     */
+    semanticByTarget?: Record<string, ISemanticConditionalFormatting>;
+    /** Deletes THIS specific authored rule (wired only when one exists) — the trash button. */
+    onDelete?: () => void;
+    /**
+     * Reverts to Inherited: clears every authored rule for `target` (a target can have several
+     * stacked custom rules, not just this one) AND this rule's own original id — needed together
+     * because a non-fixedTarget dialog lets the user retarget before saving, so the rule being
+     * edited may not (yet) be one of the rules actually stored against `target`. Distinct from
+     * `onDelete`: triggered only by Save while "Use default rule" is checked.
+     */
+    onRevertToDefault?: (target: ConditionalFormattingTarget, ruleId: string) => void;
     onSave: (rule: IConditionalFormattingRule) => void;
     onClose: () => void;
 }
@@ -747,6 +812,19 @@ export declare interface IGrantedDataSource {
     accessSource?: DataSourceAccessSource;
 }
 
+/**
+ * Known identity facts of a grantee: real name/email only, never an id fallback.
+ * Undefined fields are unknown and may be backfilled.
+ *
+ * @internal
+ */
+export declare interface IGranteeIdentityFacts {
+    /** Real full name (users) / group name, when known. */
+    name?: string;
+    /** Real email, when known (users only). */
+    email?: string;
+}
+
 /**
  * @internal
  */
@@ -1547,6 +1625,23 @@ export declare interface IObjectShareDialogProps {
      * keep an inline access row in sync without refetching.
      */
     onSummaryChange?: (summary: IObjectAccessSummary) => void;
+    /**
+     * Manage access for an object that does not exist yet. Nothing is written; the result
+     * arrives through `onDraftChange`. Requires no `target`, and `labels` is ignored.
+     */
+    draft?: boolean;
+    /**
+     * Fires with the final draft as the dialog closes, while `draft`. Required: the session
+     * unmounts on close, so a draft nobody keeps is lost.
+     */
+    onDraftChange?: (draft: IObjectShareDraft) => void;
+    /** Draft to carry on from, when reopening. */
+    initialDraft?: IObjectShareDraft;
+    /**
+     * What a draft's general access starts as; an untouched default is never written.
+     * Defaults to RESTRICTED; pass WORKSPACE for a type the backend creates visible.
+     */
+    initialDraftGeneralAccess?: GeneralAccessValue;
     /**
      * Labels (display forms) of the shared attribute, enabling the per-grantee
      * label-scope picker. Omit for objects without labels (e.g. facts).
@@ -1568,6 +1663,67 @@ export declare interface IObjectShareDialogProps {
     labelsError?: boolean;
 }
 
+/**
+ * Unsaved access for an object that does not exist yet.
+ *
+ * @internal
+ */
+export declare interface IObjectShareDraft {
+    granteeEdits: Readonly<Record<string, GranteeEdit>>;
+    ruleEdit: IRuleEdit | undefined;
+}
+
+/**
+ * Dialog row derived from a backend grant. `name`/`email` are real facts only;
+ * display fallbacks are `granteeDisplayPair`'s concern.
+ *
+ * @internal
+ */
+export declare interface IObjectShareGrantee extends IGranteeIdentityFacts {
+    /** Stable id used as the dialog row's React key. `user:<ref>` / `group:<ref>`. */
+    id: string;
+    kind: "user" | "group";
+    granteeRef: ObjRef;
+    /**
+     * Whether this row is the signed-in user's own grant. Derived from the
+     * profile, so it holds for rows of any origin (fetched or optimistic).
+     */
+    isSelf?: boolean;
+    /**
+     * EFFECTIVE permission level shown on the row — the stronger of {@link IObjectShareGrantee.directLevel}
+     * and {@link IObjectShareGrantee.inheritedLevel}, so a grantee who only inherits a level is not
+     * understated as VIEW.
+     */
+    level: ObjectSharePermissionLevel;
+    /**
+     * Permission level granted by THIS workspace, or undefined when the grantee's
+     * access is inherited-only (a group, or a parent workspace in a hierarchy).
+     * This — not {@link IObjectShareGrantee.level} — is what a re-grade writes and what decides whether
+     * there is a grant here to remove: inherited access cannot be revoked from here.
+     */
+    directLevel?: ObjectSharePermissionLevel;
+    /**
+     * Inherited permission to surface as a warning: set when inheritance carries the
+     * grantee above their direct grant (including inherited-only, where the whole
+     * displayed level is inherited). Undefined when the direct grant already covers
+     * the effective permission. Drives the row's warning badge.
+     */
+    effectivePermission?: ObjectSharePermissionLevel;
+    /**
+     * Strongest permission the grantee inherits (via a group, or a parent workspace),
+     * regardless of the current direct level. Retained from the fetch so the
+     * displayed level and badge can be recomposed locally when the direct level
+     * changes (no refetch).
+     */
+    inheritedLevel?: ObjectSharePermissionLevel;
+    /**
+     * Row-level in-flight state for optimistic updates: `"saving"` while a level
+     * change or freshly-added grant is being committed, `"removing"` while a
+     * removal is in flight. Undefined when the row reflects committed state.
+     */
+    pending?: "saving" | "removing";
+}
+
 /**
  * A label (attribute display form) of the shared attribute. The share dialog
  * scopes a grantee's access to a subset of these via per-label permission grants.
@@ -1593,6 +1749,21 @@ export declare interface IObjectShareLabel {
     isDefault: boolean;
 }
 
+/**
+ * Transient edit of the all-workspace-users rule (general access + its level),
+ * overlaid on the fetched rule state in the hook. Same lifecycle and `settled`
+ * semantics as {@link GranteeEdit}, one edit in flight at a time.
+ *
+ * @internal
+ */
+export declare interface IRuleEdit {
+    generalAccess: GeneralAccessValue;
+    level: ObjectSharePermissionLevel;
+    pending: boolean;
+    /** The committed rule edit this pending one superseded; restored on failure. */
+    settled?: IRuleEdit;
+}
+
 /**
  * Type-guard testing whether the provided object is an instance of {@link IDrillDownDefinition}.
  * @beta
@@ -1891,6 +2062,14 @@ export declare function NotificationsPanel(props: INotificationsPanelProps): JSX
  */
 export declare function ObjectShareDialog(props: IObjectShareDialogProps): JSX.Element | null;
 
+/**
+ * Permission level surfaced in the share dialog — the model's granular access
+ * permission (VIEW / SHARE / EDIT), assignable from the permission menu.
+ *
+ * @internal
+ */
+export declare type ObjectSharePermissionLevel = AccessGranularPermission;
+
 /**
  * @alpha
  */
@@ -1972,6 +2151,17 @@ export declare type TelemetryEvent = "multiple-users-deleted" | "multiple-groups
  */
 export declare type TrackEventCallback = (event: TelemetryEvent) => void;
 
+/**
+ * Writes a draft's access to an object that now exists.
+ *
+ * @remarks
+ * One request, so it all lands or none does. True when it landed or asked for nothing,
+ * false when it failed — nothing is shown to the user.
+ *
+ * @internal
+ */
+export declare function useApplyObjectPermissions(): (target: IObjectPermissionsObject, draft: IObjectShareDraft) => Promise<boolean>;
+
 /**
  * The workspace date-filter preset catalog for date-condition value pickers — the same catalog the
  * dashboard date filter consumes. Undefined while loading (the picker degrades to its static form);

package/esm/share/ObjectShareDialog.d.ts

@@ -1,4 +1,6 @@
 import type { IObjectPermissionsObject } from "@gooddata/sdk-backend-spi";
+import { type GeneralAccessValue } from "@gooddata/sdk-ui-kit";
+import type { IObjectShareDraft } from "./objectShareController.types.js";
 import type { IObjectAccessSummary, IObjectShareLabel } from "./types.js";
 /**
  * Props for {@link ObjectShareDialog}.
@@ -24,6 +26,23 @@ export interface IObjectShareDialogProps {
      * keep an inline access row in sync without refetching.
      */
     onSummaryChange?: (summary: IObjectAccessSummary) => void;
+    /**
+     * Manage access for an object that does not exist yet. Nothing is written; the result
+     * arrives through `onDraftChange`. Requires no `target`, and `labels` is ignored.
+     */
+    draft?: boolean;
+    /**
+     * Fires with the final draft as the dialog closes, while `draft`. Required: the session
+     * unmounts on close, so a draft nobody keeps is lost.
+     */
+    onDraftChange?: (draft: IObjectShareDraft) => void;
+    /** Draft to carry on from, when reopening. */
+    initialDraft?: IObjectShareDraft;
+    /**
+     * What a draft's general access starts as; an untouched default is never written.
+     * Defaults to RESTRICTED; pass WORKSPACE for a type the backend creates visible.
+     */
+    initialDraftGeneralAccess?: GeneralAccessValue;
     /**
      * Labels (display forms) of the shared attribute, enabling the per-grantee
      * label-scope picker. Omit for objects without labels (e.g. facts).

package/esm/share/ObjectShareDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectShareDialog.d.ts","sourceRoot":"","sources":["../../src/share/ObjectShareDialog.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAc1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0C1E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,gDAAgD;IAChD,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7C,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,sFAAsF;IACtF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,kDAK/D"}
+{"version":3,"file":"ObjectShareDialog.d.ts","sourceRoot":"","sources":["../../src/share/ObjectShareDialog.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EACH,KAAK,kBAAkB,EAQ1B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EACR,iBAAiB,EAGpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0C1E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,gDAAgD;IAChD,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7C,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,sFAAsF;IACtF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,8CAA8C;IAC9C,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,kBAAkB,CAAC;IAC/C;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,kDAa/D"}

package/esm/share/ObjectShareDialog.js

@@ -1,6 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
 import { useIntl } from "react-intl";
+import { invariant } from "ts-invariant";
 import { UiAddGranteeDialog, UiConfirmDialog, UiGranteeRowControls, UiObjectShareDialog, UiTag, UiTooltip, } from "@gooddata/sdk-ui-kit";
 import { objectShareMessages } from "./messages.js";
 import { granteeDisplayPair } from "./objectShareController.helpers.js";
@@ -40,13 +41,15 @@ function AdminSelfTag() {
  * @internal
  */
 export function ObjectShareDialog(props) {
+    invariant(!props.draft || !props.target, "ObjectShareDialog: `draft` cannot be combined with a `target` — a draft is for an object that does not exist yet, and nothing it stages would ever be written to that target.");
+    invariant(!props.draft || props.onDraftChange, "ObjectShareDialog: `draft` requires `onDraftChange`, and something above the dialog must keep what it emits and pass it back as `initialDraft` — the session unmounts on close, discarding anything only drafted.");
     if (!props.isOpen) {
         return null;
     }
     return _jsx(ObjectShareDialogSession, { ...props });
 }
 /** The dialog session — mounted only while open, so its state cannot outlive a close. */
-function ObjectShareDialogSession({ target, objectTitle, onClose, onSummaryChange, labels, labelsLoading, labelsError, }) {
+function ObjectShareDialogSession({ target, objectTitle, onClose, onSummaryChange, labels, labelsLoading, labelsError, draft, onDraftChange, initialDraft, initialDraftGeneralAccess, }) {
     const intl = useIntl();
     const { state, actions, isShareViewOpen, isAddGranteeOpen, isGeneralAccessConfirmOpen, isSelfRestrictConfirmOpen, isMutable, isLoading, workspaceDisabledLevels, grantableDisabledLevels, grantLimitTooltip, rowDisabledLevels, rowDisabledLevelTooltips, isRowRemoveDisabled, isRowControlsLocked, rowRemoveDisabledTooltip, onClose: closeDialog, onRowPermissionChange, onRowRemove, onSelfRestrictCancel, onSelfRestrictConfirm, } = useObjectShareDialog({
         target,
@@ -55,6 +58,10 @@ function ObjectShareDialogSession({ target, objectTitle, onClose, onSummaryChang
         labels,
         labelsLoading,
         labelsError,
+        draft,
+        onDraftChange,
+        initialDraft,
+        initialDraftGeneralAccess,
     });
     // Primary label is locked — always selected, can't be unchecked.
     const labelItems = state.labels.map((l) => ({

package/esm/share/objectShareController.helpers.d.ts

@@ -1,6 +1,5 @@
 import { type IAvailableAccessGrantee, type IGranularAccessGrantee, type IObjectAccessList, type ObjRef } from "@gooddata/sdk-model";
-import type { GeneralAccessValue } from "@gooddata/sdk-ui-kit";
-import type { IGranteeIdentityFacts, IObjectShareGrantee, ISelfIdentity, ObjectSharePermissionLevel } from "./objectShareController.types.js";
+import type { GranteeEdit, IGranteeIdentityFacts, IObjectShareDraft, IObjectShareGrantee, ISelfIdentity, ObjectSharePermissionLevel } from "./objectShareController.types.js";
 import type { IObjectShareLabel } from "./types.js";
 /** Stable row id shared by grantee rows and picker options: `user:<ref>` / `group:<ref>`. */
 export declare function granteeId(kind: "user" | "group", ref: ObjRef): string;
@@ -117,56 +116,6 @@ export declare function withDirectLevel(grantee: IObjectShareGrantee, direct: Ob
  */
 export declare function withoutDirectGrant(grantee: IObjectShareGrantee, inheritedLevel: ObjectSharePermissionLevel): IObjectShareGrantee;
 export declare function granteesFromAccessList(list: IObjectAccessList | undefined): IObjectShareGrantee[];
-/**
- * A transient edit overlaid on a fetched grantee row (keyed by grantee id in
- * {@link mergeGrantees}). The pending-guard keeps at most one edit in flight per id.
- * A pending edit that superseded an already-COMMITTED entry (an added row, an
- * earlier level change) carries it as `settled`, because the fetched base no longer
- * holds that row's last-settled state: failure restores `settled`, success drops it.
- * With no `settled`, failure deletes the entry, reverting to the fetched row.
- *
- * @internal
- */
-export type GranteeEdit = {
-    kind: "level";
-    level: ObjectSharePermissionLevel;
-    pending: boolean;
-    settled?: GranteeEdit;
-} | {
-    kind: "added";
-    grantee: IObjectShareGrantee;
-    pending: boolean;
-    settled?: GranteeEdit;
-} | {
-    kind: "removed";
-    pending: boolean;
-    settled?: GranteeEdit;
-}
-/**
- * Pending marker only — the row renders exactly as it stands. For a write that
- * locks the row without changing its access (a label-scope edit), so nothing has
- * to invent a level: reusing the `level` overlay would record the DISPLAYED level
- * as the direct grant, and that level is the effective one.
- */
- | {
-    kind: "locked";
-    pending: boolean;
-    settled?: GranteeEdit;
-};
-/**
- * Transient edit of the all-workspace-users rule (general access + its level),
- * overlaid on the fetched rule state in the hook. Same lifecycle and `settled`
- * semantics as {@link GranteeEdit}, one edit in flight at a time.
- *
- * @internal
- */
-export interface IRuleEdit {
-    generalAccess: GeneralAccessValue;
-    level: ObjectSharePermissionLevel;
-    pending: boolean;
-    /** The committed rule edit this pending one superseded; restored on failure. */
-    settled?: IRuleEdit;
-}
 /**
  * Pure composition of the fetched base with the transient overlay — the hook's
  * `grantees` derive from this with no effect and no mirrored state. Marks the
@@ -247,6 +196,13 @@ export declare function buildLabelMutationsForScopes(changes: readonly ILabelSco
     ref: ObjRef;
     grantees: IGranularAccessGrantee[];
 }>;
+/**
+ * The permissions to POST for a draft, once its object exists. Idempotent.
+ *
+ * Only adds survive: nothing is granted yet, so removals drop out. The creator is left to
+ * the backend — a draft that named them could also drop them.
+ */
+export declare function draftToPermissions(draft: IObjectShareDraft): IGranularAccessGrantee[];
 /** Stable empty-labels default so the hook's default arg doesn't churn identities. */
 export declare const NO_LABELS: IObjectShareLabel[];
 /** Shared empty id-set for "no labels in scope" diffs. */

package/esm/share/objectShareController.helpers.d.ts.map

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

package/esm/share/objectShareController.helpers.js

@@ -438,6 +438,29 @@ export function buildLabelMutationsForScopes(changes, labels) {
     }
     return Array.from(byLabel.values());
 }
+/**
+ * The permissions to POST for a draft, once its object exists. Idempotent.
+ *
+ * Only adds survive: nothing is granted yet, so removals drop out. The creator is left to
+ * the backend — a draft that named them could also drop them.
+ */
+export function draftToPermissions(draft) {
+    const permissions = [];
+    for (const edit of Object.values(draft.granteeEdits)) {
+        // Only `added` can reach here: the other kinds need a fetched row, and there is none.
+        if (edit.kind === "added") {
+            permissions.push(toGranularGrantee(edit.grantee.kind, edit.grantee.granteeRef, edit.grantee.level));
+        }
+    }
+    const { ruleEdit } = draft;
+    if (ruleEdit?.generalAccess === "WORKSPACE") {
+        permissions.push(granularGranteeFor({ allWorkspaceUsers: true }, ruleEdit.level));
+    }
+    else if (ruleEdit?.generalAccess === "RESTRICTED") {
+        permissions.push(granularGranteeFor({ allWorkspaceUsers: true }, "none"));
+    }
+    return permissions;
+}
 /** Stable empty-labels default so the hook's default arg doesn't churn identities. */
 export const NO_LABELS = [];
 /** Shared empty id-set for "no labels in scope" diffs. */

package/esm/share/objectShareController.types.d.ts

@@ -47,15 +47,15 @@ export interface IObjectShareGrantee extends IGranteeIdentityFacts {
      */
     isSelf?: boolean;
     /**
-     * EFFECTIVE permission level shown on the row — the stronger of {@link directLevel}
-     * and {@link inheritedLevel}, so a grantee who only inherits a level is not
+     * EFFECTIVE permission level shown on the row — the stronger of {@link IObjectShareGrantee.directLevel}
+     * and {@link IObjectShareGrantee.inheritedLevel}, so a grantee who only inherits a level is not
      * understated as VIEW.
      */
     level: ObjectSharePermissionLevel;
     /**
      * Permission level granted by THIS workspace, or undefined when the grantee's
      * access is inherited-only (a group, or a parent workspace in a hierarchy).
-     * This — not {@link level} — is what a re-grade writes and what decides whether
+     * This — not {@link IObjectShareGrantee.level} — is what a re-grade writes and what decides whether
      * there is a grant here to remove: inherited access cannot be revoked from here.
      */
     directLevel?: ObjectSharePermissionLevel;
@@ -245,12 +245,73 @@ export interface IObjectShareControllerActions {
      */
     changeWorkspaceLevel: (level: ObjectSharePermissionLevel) => Promise<void>;
 }
+/**
+ * A transient edit overlaid on a fetched grantee row (keyed by grantee id in
+ * `mergeGrantees`). The pending-guard keeps at most one edit in flight per id.
+ * A pending edit that superseded an already-COMMITTED entry (an added row, an
+ * earlier level change) carries it as `settled`, because the fetched base no longer
+ * holds that row's last-settled state: failure restores `settled`, success drops it.
+ * With no `settled`, failure deletes the entry, reverting to the fetched row.
+ *
+ * @internal
+ */
+export type GranteeEdit = {
+    kind: "level";
+    level: ObjectSharePermissionLevel;
+    pending: boolean;
+    settled?: GranteeEdit;
+} | {
+    kind: "added";
+    grantee: IObjectShareGrantee;
+    pending: boolean;
+    settled?: GranteeEdit;
+} | {
+    kind: "removed";
+    pending: boolean;
+    settled?: GranteeEdit;
+}
+/**
+ * Pending marker only — the row renders exactly as it stands. For a write that
+ * locks the row without changing its access (a label-scope edit), so nothing has
+ * to invent a level: reusing the `level` overlay would record the DISPLAYED level
+ * as the direct grant, and that level is the effective one.
+ */
+ | {
+    kind: "locked";
+    pending: boolean;
+    settled?: GranteeEdit;
+};
+/**
+ * Transient edit of the all-workspace-users rule (general access + its level),
+ * overlaid on the fetched rule state in the hook. Same lifecycle and `settled`
+ * semantics as {@link GranteeEdit}, one edit in flight at a time.
+ *
+ * @internal
+ */
+export interface IRuleEdit {
+    generalAccess: GeneralAccessValue;
+    level: ObjectSharePermissionLevel;
+    pending: boolean;
+    /** The committed rule edit this pending one superseded; restored on failure. */
+    settled?: IRuleEdit;
+}
+/**
+ * Unsaved access for an object that does not exist yet.
+ *
+ * @internal
+ */
+export interface IObjectShareDraft {
+    granteeEdits: Readonly<Record<string, GranteeEdit>>;
+    ruleEdit: IRuleEdit | undefined;
+}
 /**
  * @internal
  */
 export interface IObjectShareController {
     state: IObjectShareControllerState;
     actions: IObjectShareControllerActions;
+    /** The session's unsaved access. Undefined outside draft mode. */
+    draft: IObjectShareDraft | undefined;
 }
 /**
  * Options for {@link useObjectShareController}.
@@ -276,5 +337,17 @@ export interface IUseObjectShareOptions {
      * the labels aren't passed yet, so an empty list must not read as label-free.
      */
     labelsLoading?: boolean;
+    /**
+     * Manage access for an object that does not exist yet. Nothing is written.
+     * Requires no `target`, and `labels` is ignored.
+     */
+    draft?: boolean;
+    /** Draft to carry on from. */
+    initialDraft?: IObjectShareDraft;
+    /**
+     * What a draft's general access starts as; an untouched default is never sent.
+     * Defaults to RESTRICTED, understating rather than overstating actual access.
+     */
+    initialDraftGeneralAccess?: GeneralAccessValue;
 }
 //# sourceMappingURL=objectShareController.types.d.ts.map

package/esm/share/objectShareController.types.d.ts.map

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

package/esm/share/useAccessList.d.ts

@@ -2,8 +2,7 @@ import { type IObjectPermissionsObject } from "@gooddata/sdk-backend-spi";
 import { type IGranularAccessGrantee } from "@gooddata/sdk-model";
 import { type GoodDataSdkError } from "@gooddata/sdk-ui";
 import { type GeneralAccessValue, type IUiGranteeAsyncOptions } from "@gooddata/sdk-ui-kit";
-import { type IRuleEdit } from "./objectShareController.helpers.js";
-import type { IObjectShareControllerState, IObjectShareGrantee, ISelfIdentity, ObjectSharePermissionLevel } from "./objectShareController.types.js";
+import type { IObjectShareControllerState, IObjectShareDraft, IObjectShareGrantee, IRuleEdit, ISelfIdentity, ObjectSharePermissionLevel } from "./objectShareController.types.js";
 import type { IObjectAccessSummary } from "./types.js";
 /**
  * The owned access list for {@link useObjectShareController}.
@@ -104,6 +103,18 @@ export interface IAccessList {
     settleRuleEdit: () => void;
     /** Revert the rule edit after a failed write: the superseded committed edit, or the fetch. */
     failRuleEdit: () => void;
+    /** The overlay as a draft. Only meaningful in draft mode. */
+    draft: IObjectShareDraft;
+}
+/**
+ * Draft-mode inputs. See {@link IUseObjectShareOptions} for what each one means.
+ *
+ * @internal
+ */
+export interface IAccessListDraftOptions {
+    draft?: boolean;
+    initialDraft?: IObjectShareDraft;
+    initialDraftGeneralAccess?: GeneralAccessValue;
 }
 /**
  * Owns the backend access list for ONE dialog session: the hook is mounted while
@@ -122,5 +133,5 @@ export interface IAccessList {
  *
  * @internal
  */
-export declare function useAccessList(target: IObjectPermissionsObject | undefined): IAccessList;
+export declare function useAccessList(target: IObjectPermissionsObject | undefined, draftOptions?: IAccessListDraftOptions): IAccessList;
 //# sourceMappingURL=useAccessList.d.ts.map