@gooddata/sdk-ui-kit 11.42.0-alpha.2 → 11.42.0-alpha.4

package/esm/@ui/@types/icon.d.ts

@@ -1,5 +1,5 @@
 /**
  * @internal
  */
-export type IconType = "aiAgent" | "aiAgentDisabled" | "brain" | "brainDisabled" | "check" | "checkCircle" | "certification" | "plus" | "plusCircle" | "sync" | "alert" | "alertPaused" | "close" | "cross" | "edit" | "crossCircle" | "question" | "chevronUp" | "chevronRight" | "chevronDown" | "chevronLeft" | "date" | "navigateUp" | "navigateDown" | "navigateRight" | "navigateLeft" | "download" | "slack" | "expand" | "exclamationCircle" | "infoCircle" | "book" | "visible" | "invisible" | "lock" | "unlock" | "ai" | "aiFill" | "drawer" | "drawerEmpty" | "prohibited" | "dropDown" | "dropRight" | "clock" | "clockPaused" | "questionMark" | "upload" | "expandRectangle" | "file" | "number" | "code" | "user" | "userPlus" | "users" | "magic" | "tab" | "pauseCircle" | "filter" | "timer" | "mail" | "envelope" | "copy" | "rain" | "earth" | "geoCollection" | "geoCollectionUpload" | "minimize" | "shrink" | "copyright" | "ellipsis" | "pencil" | "folder" | "folderSmall" | "folderPlus" | "trash" | "arrowUp" | "arrowRight" | "arrowDown" | "arrowLeft" | "undo" | "redo" | "trendDown" | "trendUp" | "save" | "minus" | "minusCircle" | "percent" | "enter" | "enterRight" | "money" | "ghost" | "warning" | "home" | "settings" | "search" | "university" | "printer" | "picture" | "visualization" | "dashboard" | "metric" | "fact" | "ldmAttribute" | "ldmKey" | "ldmLabel" | "sharp" | "attribute" | "horn" | "cw" | "ccw" | "table" | "directionColumn" | "directionRow" | "header" | "genai" | "genai2" | "explainai" | "hiddenForAi" | "box" | "ellipsisVertical" | "list" | "drillTo" | "hierarchy" | "history" | "history2" | "thumbsUp" | "thumbsDown" | "send" | "visualizationArea" | "visualizationTable" | "visualizationTreemap" | "visualizationScatter" | "visualizationDonut" | "visualizationHeadline" | "visualizationColumn" | "visualizationLine" | "visualizationPyramid" | "visualizationFunnel" | "visualizationHeatmap" | "visualizationBubble" | "visualizationPie" | "visualizationBar" | "visualizationCombo" | "visualizationBullet" | "visualizationWaterfall" | "visualizationDependencywheel" | "visualizationSankey" | "visualizationPushpin" | "visualizationRepeater" | "visualizationXirr" | "link" | "externalLink" | "click" | "fileXlsx" | "filePptx" | "filePdf" | "fileImage" | "fileCsvFormatted" | "fileCsvRaw" | "aiDocument" | "recommendation" | "streamUp" | "streamDown" | "stream" | "density" | "parameter" | "pin" | "unpin";
+export type IconType = "aiAgent" | "aiAgentDisabled" | "brain" | "brainDisabled" | "check" | "checkCircle" | "certification" | "plus" | "plusCircle" | "sync" | "alert" | "alertPaused" | "close" | "cross" | "edit" | "crossCircle" | "question" | "chevronUp" | "chevronRight" | "chevronDown" | "chevronLeft" | "date" | "navigateUp" | "navigateDown" | "navigateRight" | "navigateLeft" | "download" | "slack" | "expand" | "exclamationCircle" | "infoCircle" | "book" | "visible" | "invisible" | "lock" | "unlock" | "ai" | "aiFill" | "drawer" | "drawerEmpty" | "prohibited" | "dropDown" | "dropRight" | "clock" | "clockPaused" | "questionMark" | "upload" | "expandRectangle" | "file" | "number" | "code" | "user" | "userPlus" | "users" | "magic" | "tab" | "pauseCircle" | "filter" | "timer" | "mail" | "envelope" | "copy" | "rain" | "earth" | "geoCollection" | "geoCollectionUpload" | "minimize" | "shrink" | "copyright" | "ellipsis" | "pencil" | "folder" | "folderSmall" | "folderPlus" | "trash" | "arrowUp" | "arrowRight" | "arrowDown" | "arrowLeft" | "undo" | "redo" | "trendDown" | "trendUp" | "save" | "minus" | "minusCircle" | "percent" | "enter" | "enterRight" | "money" | "ghost" | "warning" | "home" | "settings" | "search" | "university" | "printer" | "picture" | "visualization" | "dashboard" | "metric" | "fact" | "ldmAttribute" | "ldmKey" | "ldmLabel" | "sharp" | "attribute" | "horn" | "cw" | "ccw" | "table" | "directionColumn" | "directionRow" | "header" | "genai" | "genai2" | "explainai" | "hiddenForAi" | "box" | "ellipsisVertical" | "list" | "drillTo" | "hierarchy" | "history" | "history2" | "thumbsUp" | "thumbsDown" | "send" | "visualizationArea" | "visualizationTable" | "visualizationTreemap" | "visualizationScatter" | "visualizationDonut" | "visualizationHeadline" | "visualizationColumn" | "visualizationLine" | "visualizationPyramid" | "visualizationFunnel" | "visualizationHeatmap" | "visualizationBubble" | "visualizationPie" | "visualizationBar" | "visualizationCombo" | "visualizationBullet" | "visualizationWaterfall" | "visualizationDependencywheel" | "visualizationSankey" | "visualizationPushpin" | "visualizationRepeater" | "visualizationXirr" | "link" | "externalLink" | "click" | "fileXlsx" | "filePptx" | "filePdf" | "fileImage" | "fileCsvFormatted" | "fileCsvRaw" | "aiDocument" | "recommendation" | "streamUp" | "streamDown" | "stream" | "density" | "parameter" | "pin" | "unpin" | "speechBubble" | "pieChart";
 //# sourceMappingURL=icon.d.ts.map

package/esm/@ui/@types/icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/@ui/@types/icon.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,QAAQ,GACd,SAAS,GACT,iBAAiB,GACjB,OAAO,GACP,eAAe,GACf,OAAO,GACP,aAAa,GACb,eAAe,GACf,MAAM,GACN,YAAY,GACZ,MAAM,GACN,OAAO,GACP,aAAa,GACb,OAAO,GACP,OAAO,GACP,MAAM,GACN,aAAa,GACb,UAAU,GACV,WAAW,GACX,cAAc,GACd,aAAa,GACb,aAAa,GACb,MAAM,GACN,YAAY,GACZ,cAAc,GACd,eAAe,GACf,cAAc,GACd,UAAU,GACV,OAAO,GACP,QAAQ,GACR,mBAAmB,GACnB,YAAY,GACZ,MAAM,GACN,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,WAAW,GACX,OAAO,GACP,aAAa,GACb,cAAc,GACd,QAAQ,GACR,iBAAiB,GACjB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,OAAO,GACP,OAAO,GACP,KAAK,GACL,aAAa,GACb,QAAQ,GACR,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,eAAe,GACf,qBAAqB,GACrB,UAAU,GACV,QAAQ,GACR,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,OAAO,GACP,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,MAAM,GACN,MAAM,GACN,WAAW,GACX,SAAS,GACT,MAAM,GACN,OAAO,GACP,aAAa,GACb,SAAS,GACT,OAAO,GACP,YAAY,GACZ,OAAO,GACP,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,SAAS,GACT,eAAe,GACf,WAAW,GACX,QAAQ,GACR,MAAM,GACN,cAAc,GACd,QAAQ,GACR,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,IAAI,GACJ,KAAK,GACL,OAAO,GACP,iBAAiB,GACjB,cAAc,GACd,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,WAAW,GACX,aAAa,GACb,KAAK,GACL,kBAAkB,GAClB,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,YAAY,GACZ,MAAM,GACN,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,GAC9B,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,mBAAmB,GACnB,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,WAAW,GACX,KAAK,GACL,OAAO,CAAC"}
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/@ui/@types/icon.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,QAAQ,GACd,SAAS,GACT,iBAAiB,GACjB,OAAO,GACP,eAAe,GACf,OAAO,GACP,aAAa,GACb,eAAe,GACf,MAAM,GACN,YAAY,GACZ,MAAM,GACN,OAAO,GACP,aAAa,GACb,OAAO,GACP,OAAO,GACP,MAAM,GACN,aAAa,GACb,UAAU,GACV,WAAW,GACX,cAAc,GACd,aAAa,GACb,aAAa,GACb,MAAM,GACN,YAAY,GACZ,cAAc,GACd,eAAe,GACf,cAAc,GACd,UAAU,GACV,OAAO,GACP,QAAQ,GACR,mBAAmB,GACnB,YAAY,GACZ,MAAM,GACN,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,WAAW,GACX,OAAO,GACP,aAAa,GACb,cAAc,GACd,QAAQ,GACR,iBAAiB,GACjB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,OAAO,GACP,OAAO,GACP,KAAK,GACL,aAAa,GACb,QAAQ,GACR,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,eAAe,GACf,qBAAqB,GACrB,UAAU,GACV,QAAQ,GACR,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,OAAO,GACP,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,MAAM,GACN,MAAM,GACN,WAAW,GACX,SAAS,GACT,MAAM,GACN,OAAO,GACP,aAAa,GACb,SAAS,GACT,OAAO,GACP,YAAY,GACZ,OAAO,GACP,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,SAAS,GACT,eAAe,GACf,WAAW,GACX,QAAQ,GACR,MAAM,GACN,cAAc,GACd,QAAQ,GACR,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,IAAI,GACJ,KAAK,GACL,OAAO,GACP,iBAAiB,GACjB,cAAc,GACd,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,WAAW,GACX,aAAa,GACb,KAAK,GACL,kBAAkB,GAClB,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,YAAY,GACZ,MAAM,GACN,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,GAC9B,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,mBAAmB,GACnB,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,WAAW,GACX,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,CAAC"}

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialog.d.ts

@@ -1,42 +1,17 @@
-import { type ReactNode } from "react";
+import { type IUiAddGranteeDialogCardProps } from "./UiAddGranteeDialogCard.js";
 /**
  * @internal
  */
-export interface IUiAddGranteeDialogProps {
+export interface IUiAddGranteeDialogProps extends IUiAddGranteeDialogCardProps {
     /** Whether the dialog is shown. */
     isOpen: boolean;
-    /** Object title shown in the header — wrapped into `Share "\{title\}"`. */
-    objectTitle: string;
-    /** Current search query. */
-    searchQuery: string;
-    /** Fires when the user edits the search query. */
-    onSearchQueryChange: (next: string) => void;
-    /**
-     * Optional slot rendered between the search input and the bottom divider.
-     * When empty, the screen falls back to a "No user or group selected"
-     * placeholder. Callers typically render a single `UiGranteeRow`
-     * here to preview the grantee they've picked from the search dropdown.
-     */
-    selectedGrantee?: ReactNode;
-    /** Fires when the user clicks the header back-arrow button. */
-    onBack: () => void;
-    /** Fires when the user clicks the header X close button or dismisses the modal. */
-    onClose: () => void;
-    /** Fires when the user clicks Cancel in the footer. */
-    onCancel: () => void;
-    /** Fires when the user clicks the primary Add button in the footer. */
-    onAdd: () => void;
-    /** When true, the primary Add button is disabled. */
-    isAddDisabled?: boolean;
-    /** Test id forwarded to the modal overlay. */
-    dataTestId?: string;
 }
 /**
- * Modal dialog for adding a grantee, opened from the share dialog's
- * "+ Add" action. Lets the author search for a user or group, preview the
- * grantee they picked, and confirm adding them with the footer Add button.
+ * Add-grantee dialog — wraps `UiAddGranteeDialogCard` in `UiModalDialog`
+ * for the full modal contract (portal, dimmed backdrop, focus trap, Esc
+ * and backdrop dismiss).
  *
  * @internal
  */
-export declare function UiAddGranteeDialog({ isOpen, objectTitle, searchQuery, onSearchQueryChange, selectedGrantee, onBack, onClose, onCancel, onAdd, isAddDisabled, dataTestId }: IUiAddGranteeDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function UiAddGranteeDialog({ isOpen, ...cardProps }: IUiAddGranteeDialogProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=UiAddGranteeDialog.d.ts.map

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UiAddGranteeDialog.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAddGranteeDialog/UiAddGranteeDialog.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAmBvC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC;IAE5B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mFAAmF;IACnF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAC/B,MAAM,EACN,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,MAAM,EACN,OAAO,EACP,QAAQ,EACR,KAAK,EACL,aAAa,EACb,UAAU,EACb,EAAE,wBAAwB,2CAmD1B"}
+{"version":3,"file":"UiAddGranteeDialog.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAddGranteeDialog/UiAddGranteeDialog.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,4BAA4B,EAA0B,MAAM,6BAA6B,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC1E,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,EAAE,wBAAwB,2CAMpF"}

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialog.js

@@ -1,30 +1,14 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useIntl } from "react-intl";
-import { commonDialogMessages, olpAddGranteeDialogMessages, olpObjectShareDialogMessages, } from "../../locales.js";
-import { bem } from "../@utils/bem.js";
-import { UiButton } from "../UiButton/UiButton.js";
-import { UiIconButton } from "../UiIconButton/UiIconButton.js";
-import { UiDialogFooter } from "../UiModalDialog/UiDialogFooter.js";
-import { UiDialogHeader } from "../UiModalDialog/UiDialogHeader.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
 import { UiModalDialog } from "../UiModalDialog/UiModalDialog.js";
-import { UiTextInput } from "../UiTextInput/UiTextInput.js";
-const { b, e } = bem("gd-ui-kit-add-grantee-dialog");
+import { UiAddGranteeDialogCard } from "./UiAddGranteeDialogCard.js";
 /**
- * Modal dialog for adding a grantee, opened from the share dialog's
- * "+ Add" action. Lets the author search for a user or group, preview the
- * grantee they picked, and confirm adding them with the footer Add button.
+ * Add-grantee dialog — wraps `UiAddGranteeDialogCard` in `UiModalDialog`
+ * for the full modal contract (portal, dimmed backdrop, focus trap, Esc
+ * and backdrop dismiss).
  *
  * @internal
  */
-export function UiAddGranteeDialog({ isOpen, objectTitle, searchQuery, onSearchQueryChange, selectedGrantee, onBack, onClose, onCancel, onAdd, isAddDisabled, dataTestId, }) {
-    const intl = useIntl();
-    const dialogTitle = intl.formatMessage(olpObjectShareDialogMessages.title, { title: objectTitle });
-    const backButton = (_jsx(UiIconButton, { icon: "chevronLeft", variant: "tertiary", size: "small", onClick: onBack, accessibilityConfig: { ariaLabel: intl.formatMessage(olpAddGranteeDialogMessages.back) } }));
-    return (_jsxs(UiModalDialog, { isOpen: isOpen, onClose: onClose, dataTestId: dataTestId, children: [
-            _jsx(UiDialogHeader, { title: dialogTitle, titleSize: "large", onClose: onClose, leading: backButton }), _jsxs("div", { className: b(), children: [
-                    _jsx(UiTextInput, { type: "search", value: searchQuery, onChange: onSearchQueryChange, label: intl.formatMessage(olpAddGranteeDialogMessages.userOrGroup), placeholder: intl.formatMessage(olpAddGranteeDialogMessages.searchPlaceholder) }), _jsx("div", { className: e("preview"), children: selectedGrantee ?? (_jsx("span", { className: e("empty-state"), children: intl.formatMessage(olpAddGranteeDialogMessages.emptyState) })) })
-                ] }), _jsxs(UiDialogFooter, { divider: true, children: [
-                    _jsx(UiButton, { label: intl.formatMessage(commonDialogMessages.cancel), variant: "secondary", size: "medium", onClick: onCancel }), _jsx(UiButton, { label: intl.formatMessage(olpAddGranteeDialogMessages.add), variant: "primary", size: "medium", onClick: onAdd, isDisabled: isAddDisabled })
-                ] })
-        ] }));
+export function UiAddGranteeDialog({ isOpen, ...cardProps }) {
+    return (_jsx(UiModalDialog, { isOpen: isOpen, onClose: cardProps.onClose, children: _jsx(UiAddGranteeDialogCard, { ...cardProps }) }));
 }

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialogCard.d.ts

@@ -0,0 +1,56 @@
+import { type IUiGranteeAsyncOptions, type IUiPickedGrantee } from "../UiGranteeAsyncPicker/UiGranteeAsyncPicker.js";
+import { type PermissionMenuLevel } from "../UiPermissionMenu/UiPermissionMenu.js";
+/**
+ * @internal
+ */
+export interface IUiAddGranteeDialogCardProps {
+    /** Object title shown in the header — wrapped into `Share "\{title\}"`. */
+    objectTitle: string;
+    /** Loader passed straight through to the embedded `UiGranteeAsyncPicker`. */
+    loadOptions: (search: string) => Promise<IUiGranteeAsyncOptions>;
+    /**
+     * Grantees currently picked. Single source of truth — the card derives all
+     * row state from it and emits the next list via `onSelectedGranteesChange`.
+     */
+    selectedGrantees: ReadonlyArray<IUiPickedGrantee>;
+    /**
+     * Fires with the next list when the user picks a grantee, changes a row's
+     * permission level, or removes a row. Consumers store the result in their
+     * own state.
+     */
+    onSelectedGranteesChange: (next: IUiPickedGrantee[]) => void;
+    /**
+     * Permission level used when a grantee is added from the dropdown.
+     * Defaults to `"VIEW"`. Consumers that need a different default (e.g.
+     * "SHARE" for owners) override here.
+     */
+    initialPermissionLevel?: PermissionMenuLevel;
+    /** Fires when the user clicks the header back-arrow button. */
+    onBack: () => void;
+    /** Fires when the user clicks the header X close button. */
+    onClose: () => void;
+    /** Fires when the user clicks Cancel in the footer. */
+    onCancel: () => void;
+    /**
+     * Fires when the user clicks the primary Share button in the footer. The
+     * button is disabled while no grantee has been picked.
+     */
+    onShare: () => void;
+    /** Test id forwarded to the root element. */
+    dataTestId?: string;
+}
+/**
+ * Add-grantee dialog card — header + grantee picker (search input with
+ * sectioned Groups/Users dropdown and picked-rows list) + footer with Cancel
+ * and Share. Renders inline as a plain card. For modal behavior (portal,
+ * backdrop, focus trap, dismiss), use `UiAddGranteeDialog` which wraps this
+ * in `UiModalDialog`.
+ *
+ * The card owns the visual composition (picker layout) but no policy. The
+ * caller controls the picked list via `selectedGrantees` / `onSelectedGranteesChange`,
+ * and may override the initial permission level via `initialPermissionLevel`.
+ *
+ * @internal
+ */
+export declare function UiAddGranteeDialogCard({ objectTitle, loadOptions, selectedGrantees, onSelectedGranteesChange, initialPermissionLevel, onBack, onClose, onCancel, onShare, dataTestId }: IUiAddGranteeDialogCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UiAddGranteeDialogCard.d.ts.map

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialogCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiAddGranteeDialogCard.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAddGranteeDialog/UiAddGranteeDialogCard.tsx"],"names":[],"mappings":"AAWA,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAExB,MAAM,iDAAiD,CAAC;AAIzD,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAMnF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC,6EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IAEpB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjE;;;OAGG;IACH,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD;;;;OAIG;IACH,wBAAwB,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IAC7D;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAE7C,+DAA+D;IAC/D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,EACnC,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,wBAAwB,EACxB,sBAA+B,EAC/B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,OAAO,EACP,UAAU,EACb,EAAE,4BAA4B,2CAgD9B"}

package/esm/@ui/UiAddGranteeDialog/UiAddGranteeDialogCard.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useIntl } from "react-intl";
+import { commonDialogMessages, olpAddGranteeDialogMessages, olpObjectShareDialogMessages, } from "../../locales.js";
+import { bem } from "../@utils/bem.js";
+import { UiButton } from "../UiButton/UiButton.js";
+import { UiGranteeAsyncPicker, } from "../UiGranteeAsyncPicker/UiGranteeAsyncPicker.js";
+import { UiIconButton } from "../UiIconButton/UiIconButton.js";
+import { UiDialogFooter } from "../UiModalDialog/UiDialogFooter.js";
+import { UiDialogHeader } from "../UiModalDialog/UiDialogHeader.js";
+import { useGranteeSelection } from "./useGranteeSelection.js";
+const { b } = bem("gd-ui-kit-add-grantee-dialog");
+/**
+ * Add-grantee dialog card — header + grantee picker (search input with
+ * sectioned Groups/Users dropdown and picked-rows list) + footer with Cancel
+ * and Share. Renders inline as a plain card. For modal behavior (portal,
+ * backdrop, focus trap, dismiss), use `UiAddGranteeDialog` which wraps this
+ * in `UiModalDialog`.
+ *
+ * The card owns the visual composition (picker layout) but no policy. The
+ * caller controls the picked list via `selectedGrantees` / `onSelectedGranteesChange`,
+ * and may override the initial permission level via `initialPermissionLevel`.
+ *
+ * @internal
+ */
+export function UiAddGranteeDialogCard({ objectTitle, loadOptions, selectedGrantees, onSelectedGranteesChange, initialPermissionLevel = "VIEW", onBack, onClose, onCancel, onShare, dataTestId, }) {
+    const intl = useIntl();
+    const dialogTitle = intl.formatMessage(olpObjectShareDialogMessages.title, { title: objectTitle });
+    const backButton = (_jsx(UiIconButton, { icon: "chevronLeft", variant: "tertiary", size: "small", onClick: onBack, accessibilityConfig: { ariaLabel: intl.formatMessage(olpAddGranteeDialogMessages.back) } }));
+    const { select, changePermission, remove } = useGranteeSelection({
+        selectedGrantees,
+        onSelectedGranteesChange,
+        initialPermissionLevel,
+    });
+    return (_jsxs("div", { className: b(), "data-testid": dataTestId, children: [
+            _jsx(UiDialogHeader, { title: dialogTitle, titleSize: "large", onClose: onClose, leading: backButton }), _jsx(UiGranteeAsyncPicker, { loadOptions: loadOptions, selectedGrantees: selectedGrantees, onSelect: select, onPermissionChange: changePermission, onRemove: remove }), _jsxs(UiDialogFooter, { divider: true, children: [
+                    _jsx(UiButton, { label: intl.formatMessage(commonDialogMessages.cancel), variant: "secondary", size: "medium", onClick: onCancel }), _jsx(UiButton, { label: intl.formatMessage(olpAddGranteeDialogMessages.add), variant: "primary", size: "medium", onClick: onShare, isDisabled: selectedGrantees.length === 0 })
+                ] })
+        ] }));
+}

package/esm/@ui/UiAddGranteeDialog/useGranteeSelection.d.ts

@@ -0,0 +1,35 @@
+import { type IUiGranteeAsyncOption, type IUiPickedGrantee } from "../UiGranteeAsyncPicker/UiGranteeAsyncPicker.js";
+import { type PermissionMenuLevel } from "../UiPermissionMenu/UiPermissionMenu.js";
+/**
+ * @internal
+ */
+export interface IUseGranteeSelectionOptions {
+    /** Current picked list — caller owns the state. */
+    selectedGrantees: ReadonlyArray<IUiPickedGrantee>;
+    /** Fires with the next list whenever the hook produces a change. */
+    onSelectedGranteesChange: (next: IUiPickedGrantee[]) => void;
+    /**
+     * Permission level used when a grantee is added from the picker.
+     * Defaults to `"VIEW"`.
+     */
+    initialPermissionLevel?: PermissionMenuLevel;
+}
+/**
+ * @internal
+ */
+export interface IUseGranteeSelectionResult {
+    /** Pick a grantee from the picker — no-op if already in the list. */
+    select: (option: IUiGranteeAsyncOption) => void;
+    /** Change a row's permission level. */
+    changePermission: (grantee: IUiPickedGrantee, next: PermissionMenuLevel) => void;
+    /** Remove a row. */
+    remove: (grantee: IUiPickedGrantee) => void;
+}
+/**
+ * Selection callbacks for the add-grantee dialog. Caller owns the list and
+ * receives the next list via `onSelectedGranteesChange`.
+ *
+ * @internal
+ */
+export declare function useGranteeSelection({ selectedGrantees, onSelectedGranteesChange, initialPermissionLevel }: IUseGranteeSelectionOptions): IUseGranteeSelectionResult;
+//# sourceMappingURL=useGranteeSelection.d.ts.map

package/esm/@ui/UiAddGranteeDialog/useGranteeSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGranteeSelection.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAddGranteeDialog/useGranteeSelection.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,qDAAmD;IACnD,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,oEAAoE;IACpE,wBAAwB,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IAC7D;;;OAGG;IACH,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,uEAAqE;IACrE,MAAM,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChD,uCAAuC;IACvC,gBAAgB,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjF,oBAAoB;IACpB,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAChC,gBAAgB,EAChB,wBAAwB,EACxB,sBAA+B,EAClC,EAAE,2BAA2B,GAAG,0BAA0B,CAkC1D"}

package/esm/@ui/UiAddGranteeDialog/useGranteeSelection.js

@@ -0,0 +1,29 @@
+// (C) 2026 GoodData Corporation
+import { useCallback } from "react";
+/**
+ * Selection callbacks for the add-grantee dialog. Caller owns the list and
+ * receives the next list via `onSelectedGranteesChange`.
+ *
+ * @internal
+ */
+export function useGranteeSelection({ selectedGrantees, onSelectedGranteesChange, initialPermissionLevel = "VIEW", }) {
+    const select = useCallback((option) => {
+        // The picker already filters out picked ids, but a quick double-click
+        // can land a second select call before the parent re-renders — guard
+        // against the duplicate row here.
+        if (selectedGrantees.some((g) => g.id === option.id)) {
+            return;
+        }
+        onSelectedGranteesChange([
+            ...selectedGrantees,
+            { ...option, permissionLevel: initialPermissionLevel },
+        ]);
+    }, [selectedGrantees, onSelectedGranteesChange, initialPermissionLevel]);
+    const changePermission = useCallback((grantee, next) => {
+        onSelectedGranteesChange(selectedGrantees.map((g) => (g.id === grantee.id ? { ...g, permissionLevel: next } : g)));
+    }, [selectedGrantees, onSelectedGranteesChange]);
+    const remove = useCallback((grantee) => {
+        onSelectedGranteesChange(selectedGrantees.filter((g) => g.id !== grantee.id));
+    }, [selectedGrantees, onSelectedGranteesChange]);
+    return { select, changePermission, remove };
+}

package/esm/@ui/UiAutocomplete/UiAutocomplete.d.ts

@@ -0,0 +1,9 @@
+import type { IUiAutocompleteOption, IUiAutocompleteProps } from "./types.js";
+/**
+ * Async autocomplete: text input + sectioned listbox driven by a `loadOptions`
+ * loader. Implements the ARIA combobox+listbox APG pattern.
+ *
+ * @internal
+ */
+export declare function UiAutocomplete<T extends IUiAutocompleteOption = IUiAutocompleteOption>({ loadOptions, selectedIds, onSelect, debounceMs, messages, accessibilityConfig, dataTestId }: IUiAutocompleteProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UiAutocomplete.d.ts.map

package/esm/@ui/UiAutocomplete/UiAutocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiAutocomplete.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAutocomplete/UiAutocomplete.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAA0B,MAAM,YAAY,CAAC;AA+BtG;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB,EAAE,EACpF,WAAW,EACX,WAA6B,EAC7B,QAAQ,EACR,UAAgC,EAChC,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACb,EAAE,oBAAoB,CAAC,CAAC,CAAC,2CAkOzB"}

package/esm/@ui/UiAutocomplete/UiAutocomplete.js

@@ -0,0 +1,230 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { Fragment, useCallback, useId, useMemo } from "react";
+import { useIntl } from "react-intl";
+import { uiAutocompleteMessages } from "../../locales.js";
+import { bem } from "../@utils/bem.js";
+import { makeKeyboardNavigation } from "../@utils/keyboardNavigation.js";
+import { UiComboboxContextProvider } from "../UiCombobox/UiComboboxContext.js";
+import { UiComboboxInput } from "../UiCombobox/UiComboboxInput.js";
+import { UiComboboxListItem } from "../UiCombobox/UiComboboxListItem.js";
+import { UiComboboxPopup } from "../UiCombobox/UiComboboxPopup.js";
+import { useComboboxChrome } from "../UiCombobox/useComboboxChrome.js";
+import { UiSectionHeading } from "../UiSectionHeading/UiSectionHeading.js";
+import { useAsyncListSource } from "./useAsyncListSource.js";
+const { b, e } = bem("gd-ui-kit-autocomplete");
+const DEFAULT_DEBOUNCE_MS = 400;
+// Per-instance, per-generation synthetic id for the Load-more row; activating
+// it triggers a page fetch instead of `onSelect`. `listboxId` keeps it unique
+// across autocompletes on one page; `generation` makes it differ once the
+// query reloads, so a stale highlight can't carry onto the next query's row.
+const loadMoreId = (listboxId, generation) => `${listboxId}-load-more-${generation}`;
+// Stable default so an omitted `selectedIds` doesn't feed a fresh array into the
+// memo deps every render.
+const NO_SELECTED_IDS = [];
+// Mirrors `useCombobox`'s key map. Space, Home and End are left to the input
+// so the user can edit the query text natively.
+const autocompleteKeys = makeKeyboardNavigation({
+    onArrowDown: [{ code: "ArrowDown" }],
+    onArrowUp: [{ code: "ArrowUp" }],
+    onEnter: [{ code: ["Enter", "NumpadEnter"] }],
+    onEscape: [{ code: "Escape" }],
+});
+/**
+ * Async autocomplete: text input + sectioned listbox driven by a `loadOptions`
+ * loader. Implements the ARIA combobox+listbox APG pattern.
+ *
+ * @internal
+ */
+export function UiAutocomplete({ loadOptions, selectedIds = NO_SELECTED_IDS, onSelect, debounceMs = DEFAULT_DEBOUNCE_MS, messages, accessibilityConfig, dataTestId, }) {
+    const intl = useIntl();
+    const listboxId = useId();
+    const copy = useMemo(() => ({
+        searchPlaceholder: messages?.searchPlaceholder ?? intl.formatMessage(uiAutocompleteMessages.searchPlaceholder),
+        stateLoading: messages?.stateLoading ?? intl.formatMessage(uiAutocompleteMessages.stateLoading),
+        stateError: messages?.stateError ?? intl.formatMessage(uiAutocompleteMessages.stateError),
+        stateNoMatch: messages?.stateNoMatch ?? intl.formatMessage(uiAutocompleteMessages.stateNoMatch),
+        loadMore: messages?.loadMore ?? intl.formatMessage(uiAutocompleteMessages.loadMore),
+    }), [intl, messages]);
+    const source = useAsyncListSource(loadOptions, { debounceMs });
+    // The Load-more row's id is stamped with the load generation, so a highlight
+    // left on it before a query change can't re-attach to the next query's row
+    // (a constant id would survive and let Enter page the wrong query — the
+    // synthetic row is the one id the by-id highlight tracking can't otherwise
+    // tell apart across queries, since real options carry distinct ids).
+    const loadMoreRowId = loadMoreId(listboxId, source.generation);
+    const selectedIdSet = useMemo(() => new Set(selectedIds), [selectedIds]);
+    // Flat list of the rows the highlight can land on. Section headings and
+    // status rows render around it but never participate.
+    const focusableOptions = useMemo(() => {
+        const options = [];
+        for (const section of source.sections) {
+            for (const option of section.options) {
+                if (selectedIdSet.has(option.id)) {
+                    continue;
+                }
+                options.push({ id: option.id, label: option.label });
+            }
+        }
+        if (source.hasNextPage && source.status !== "loadingMore") {
+            options.push({ id: loadMoreRowId, label: copy.loadMore });
+        }
+        return options;
+    }, [source.sections, source.hasNextPage, source.status, selectedIdSet, copy.loadMore, loadMoreRowId]);
+    // Chrome tracks the highlight by row id, so a row that disappears (results
+    // change, Load-more row removed while its page loads) drops the highlight
+    // on its own — no manual resets to keep in sync.
+    const chrome = useComboboxChrome(focusableOptions);
+    const activeOptionData = useMemo(() => {
+        if (!chrome.activeOption) {
+            return undefined;
+        }
+        if (chrome.activeOption.id === loadMoreRowId) {
+            return "loadMore";
+        }
+        return findOptionById(source.sections, chrome.activeOption.id);
+    }, [chrome.activeOption, source.sections, loadMoreRowId]);
+    const handleSelect = useCallback((target) => {
+        if (target === "loadMore") {
+            // Drop the highlight while the next page loads: the Load-more row
+            // disappears, and a real option highlighted beforehand (e.g. clicked
+            // Load-more without hovering it first) must not stay Enter-armed.
+            chrome.setActiveIndex(null);
+            source.loadMore();
+            return;
+        }
+        onSelect(target);
+        // Clear the input + re-prime the loader so the next open shows the
+        // unfiltered first page rather than the previous query's results.
+        source.reset();
+        chrome.setIsOpen(false);
+    }, [chrome, source, onSelect]);
+    // Reopening after a failed load re-runs it, so every open path (click, type,
+    // and the keyboard arrows below) routes through this first to recover.
+    const retryIfErrored = useCallback(() => {
+        if (!chrome.isOpen && source.status === "error") {
+            source.retry();
+        }
+    }, [chrome.isOpen, source]);
+    const onInputKeyDown = useMemo(() => {
+        const onEnter = chrome.isOpen && activeOptionData ? () => handleSelect(activeOptionData) : undefined;
+        // Leave Escape unhandled when idle so an enclosing modal can dismiss.
+        const hasSomethingToClose = chrome.isOpen || source.inputValue.length > 0;
+        const onEscape = hasSomethingToClose
+            ? (event) => {
+                // Stop the native event too so an enclosing UiModalDialog's
+                // document Escape listener doesn't dismiss the whole dialog.
+                event.nativeEvent.stopPropagation();
+                if (chrome.isOpen) {
+                    chrome.setIsOpen(false);
+                    return;
+                }
+                source.reset();
+            }
+            : undefined;
+        return autocompleteKeys({
+            onArrowDown: () => {
+                retryIfErrored();
+                chrome.focusByDelta(1);
+            },
+            onArrowUp: () => {
+                retryIfErrored();
+                chrome.focusByDelta(-1);
+            },
+            onEnter,
+            onEscape,
+        });
+    }, [chrome, source, activeOptionData, handleSelect, retryIfErrored]);
+    const selectOptionFromContext = useCallback((option) => {
+        if (option.id === loadMoreRowId) {
+            handleSelect("loadMore");
+            return;
+        }
+        const resolved = findOptionById(source.sections, option.id);
+        if (resolved) {
+            handleSelect(resolved);
+        }
+    }, [handleSelect, source.sections, loadMoreRowId]);
+    // Stay visible across loading / error / no-match so the status row reaches
+    // the user; the sync combobox's "hide when empty" default does not apply here.
+    const shouldRenderPopup = chrome.isOpen;
+    const setIsOpen = useCallback((open) => {
+        if (open) {
+            retryIfErrored();
+        }
+        chrome.setIsOpen(open);
+    }, [chrome, retryIfErrored]);
+    const state = useMemo(() => ({
+        inputValue: source.inputValue,
+        onInputChange: (next) => {
+            source.setInputValue(next);
+            setIsOpen(true);
+        },
+        onInputKeyDown,
+        onInputBlur: () => chrome.setIsOpen(false),
+        availableOptions: focusableOptions,
+        activeIndex: chrome.activeIndex,
+        setActiveIndex: chrome.setActiveIndex,
+        activeOption: chrome.activeOption,
+        selectedOption: undefined,
+        selectOption: selectOptionFromContext,
+        isOpen: chrome.isOpen,
+        setIsOpen,
+        shouldRenderPopup,
+        anchorRef: chrome.anchorRef,
+        registerItemRef: chrome.registerItemRef,
+        creatable: false,
+        listboxId,
+    }), [
+        chrome,
+        source,
+        setIsOpen,
+        focusableOptions,
+        shouldRenderPopup,
+        onInputKeyDown,
+        selectOptionFromContext,
+        listboxId,
+    ]);
+    const visibleSections = source.sections
+        .map((section) => ({
+        ...section,
+        options: section.options.filter((o) => !selectedIdSet.has(o.id)),
+    }))
+        .filter((section) => section.options.length > 0);
+    // "No matching options" must mean the search found nothing — not that every
+    // match was hidden because it's already selected (a successful search). Key
+    // it off the loader's own result, before the selected-id filter.
+    const loaderReturnedNothing = source.sections.every((section) => section.options.length === 0);
+    const showEmptyState = source.status === "idle" && loaderReturnedNothing && !source.hasNextPage;
+    return (_jsx("div", { className: b(), "data-testid": dataTestId, children: _jsxs(UiComboboxContextProvider, { state: state, children: [
+                _jsx(UiComboboxInput, { placeholder: copy.searchPlaceholder, accessibilityConfig: accessibilityConfig }), _jsx(UiComboboxPopup, { children: _jsxs("ul", { className: e("list"), role: "listbox", id: listboxId, tabIndex: -1, children: [source.status === "loading" ? _jsx(StatusRow, { text: copy.stateLoading }) : null, source.status === "error" ? _jsx(StatusRow, { text: copy.stateError }) : null, visibleSections.length > 0 ? (_jsx(Sections, { sections: visibleSections, focusableOptions: focusableOptions })) : null, source.hasNextPage && source.status !== "loadingMore" ? (_jsx(LoadMoreRow, { id: loadMoreRowId, index: focusableOptions.findIndex((o) => o.id === loadMoreRowId), label: copy.loadMore })) : null, source.status === "loadingMore" ? _jsx(StatusRow, { text: copy.stateLoading }) : null, showEmptyState ? _jsx(StatusRow, { text: copy.stateNoMatch }) : null] }) })
+            ] }) }));
+}
+// `index` on each item must be its position in `focusableOptions` — chrome's
+// active-index navigation and item-ref registry are keyed off that.
+function Sections({ sections, focusableOptions, }) {
+    return sections.map((section) => (_jsxs(Fragment, { children: [
+            _jsx("li", { role: "presentation", className: e("section-header"), children: _jsx(UiSectionHeading, { label: section.label }) }), section.options.map((option) => {
+                const index = focusableOptions.findIndex((o) => o.id === option.id);
+                if (index < 0) {
+                    return null;
+                }
+                return (_jsxs(UiComboboxListItem, { option: { id: option.id, label: option.label }, index: index, className: e("option"), children: [
+                        _jsx("span", { className: e("option-label"), children: option.label }), option.secondaryText ? (_jsx("span", { className: e("option-secondary"), children: option.secondaryText })) : null] }, option.id));
+            })] }, section.id)));
+}
+function StatusRow({ text }) {
+    return (_jsx("li", { role: "presentation", className: e("state"), children: text }));
+}
+function LoadMoreRow({ id, index, label }) {
+    return (_jsx(UiComboboxListItem, { option: { id, label }, index: index, className: e("load-more"), children: _jsx("span", { children: label }) }));
+}
+function findOptionById(sections, id) {
+    for (const section of sections) {
+        const found = section.options.find((o) => o.id === id);
+        if (found) {
+            return found;
+        }
+    }
+    return undefined;
+}

package/esm/@ui/UiAutocomplete/types.d.ts

@@ -0,0 +1,61 @@
+import { type IAccessibilityConfigBase } from "../../typings/accessibility.js";
+/**
+ * Minimal option shape; specialized pickers map their domain objects onto it.
+ *
+ * @internal
+ */
+export interface IUiAutocompleteOption {
+    id: string;
+    label: string;
+    /** Secondary label rendered muted next to the primary label. */
+    secondaryText?: string;
+}
+/** @internal */
+export interface IUiAutocompleteSection<T extends IUiAutocompleteOption = IUiAutocompleteOption> {
+    id: string;
+    label: string;
+    options: T[];
+}
+/**
+ * User-facing copy overrides. Omitted fields fall back to the kit default.
+ *
+ * @internal
+ */
+export interface IUiAutocompleteMessages {
+    searchPlaceholder?: string;
+    stateLoading?: string;
+    stateError?: string;
+    stateNoMatch?: string;
+    loadMore?: string;
+}
+/** @internal */
+export interface IUiAutocompleteLoadResult<T extends IUiAutocompleteOption = IUiAutocompleteOption> {
+    sections: IUiAutocompleteSection<T>[];
+    /** Show a "Load more" row whose activation calls the loader with the next page. */
+    hasNextPage?: boolean;
+}
+/** @internal */
+export interface IUiAutocompleteProps<T extends IUiAutocompleteOption = IUiAutocompleteOption> {
+    /**
+     * Called with the debounced search and zero-based `page` index. Page 0
+     * fires on every query change; subsequent pages fire on Load-more.
+     *
+     * Must be referentially stable (memoize with `useCallback`) — it is a
+     * fetch dependency, so a new identity each render re-runs the page-0 query.
+     */
+    loadOptions: (search: string, page: number) => Promise<IUiAutocompleteLoadResult<T>>;
+    /** Filtered out of the dropdown so the user cannot pick the same option twice. */
+    selectedIds?: ReadonlyArray<string>;
+    onSelect: (option: T) => void;
+    /** Debounce delay for the input → loader path. Defaults to 400 ms. */
+    debounceMs?: number;
+    messages?: IUiAutocompleteMessages;
+    /**
+     * Forwarded to the search input for the accessible name / description.
+     * The combobox-internal attributes (`role`, `ariaExpanded`, `ariaControls`,
+     * `ariaAutocomplete`) are owned by the component and cannot be overridden.
+     */
+    accessibilityConfig?: IAccessibilityConfigBase;
+    dataTestId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/@ui/UiAutocomplete/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/@ui/UiAutocomplete/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IAC3F,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IAC9F,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,mFAAmF;IACnF,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IACzF;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,kFAAkF;IAClF,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,wEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/esm/@ui/UiAutocomplete/types.js

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