@gooddata/sdk-ui-kit 11.53.0-alpha.0 → 11.53.0-alpha.2

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

@@ -187,7 +187,7 @@ export declare function alignPointToPlacement(alignPoint: ILegacyAlignPoint): Pl
 /**
  * @internal
  */
-export declare const AppHeader: ComponentType<Omit<IAppHeaderProps, "theme" | "themeIsLoading" | "themeStatus">>;
+export declare function AppHeader({ logoHref, accountMenuItems, helpMenuItems, menuItemsGroups, search, notificationsPanel, workspacePicker, isAccessibilityCompliant, logoUrl, logoTitle, organizationName, className, activeColor, headerColor, headerTextColor, documentationUrl, expiredDate, showUpsellButton, onUpsellButtonClick, badges, showStaticHelpMenu, userName, helpMenuDropdownAlignPoints: helpDropdownAlign, disableHelpDropdown, onHelpClick, helpRedirectUrl, showChatItem, isChatOpen, onChatItemClick, onLogoClick, onMenuItemClick }: IAppHeaderProps): JSX.Element;
 
 /**
  * @internal
@@ -472,6 +472,14 @@ export declare function ComponentLabelsProvider({ children, labels }: IComponent
  */
 export declare function ComponentTable<TProps extends object>({ Component, columnsBy, rowsBy, baseProps, debug, codeSnippet, cellWidth, cellHeight, align, cellStyle }: IComponentTableProps<TProps>): JSX.Element;
 
+/**
+ * A language the config editor can display and emit. Every editor instance has a primary language —
+ * the one its value is written in — and may offer the other as an on-the-fly projection of it.
+ *
+ * @internal
+ */
+export declare type ConfigEditorLanguage = "json" | "yaml";
+
 /**
  * @internal
  */
@@ -630,9 +638,7 @@ export declare function DateDatasetsListItem({ id, title, isHeader, isSelected,
 /**
  * @internal
  */
-export declare class Datepicker extends PureComponent<IDatePickerProps> {
-    render(): JSX.Element;
-}
+export declare const Datepicker: NamedExoticComponent<IDatePickerProps>;
 
 /**
  * @internal
@@ -910,7 +916,7 @@ export declare function DropdownInvertableSelect<T>(props: IDropdownInvertableSe
  * @internal
  *
  */
-export declare function DropdownList<T>({ id, title, className, tabsClassName, width, height, maxHeight, onKeyDownSelect, onKeyDownConfirm, isMobile, isLoading, items, itemsCount, itemHeight, containerPadding, mobileItemHeight, showSearch, disableAutofocus, searchString, searchLabel, searchPlaceholder, searchFieldSize, onSearch, showTabs, tabs, selectedTabId, onTabSelect, renderNoData, footer, closeDropdown, accessibilityConfig, renderItem, body, itemHeightGetter, itemTitleGetter, loadNextPage, hasNextPage, skeletonItemsCount, shouldLoadNextPage, isNextPageLoading, SkeletonItem, onScroll, scrollToItem, scrollToItemKeyExtractor }: IDropdownListProps<T>): ReactElement;
+export declare function DropdownList<T>({ id, title, className, tabsClassName, width, height, maxHeight, onKeyDownSelect, onKeyDownConfirm, isMobile, isLoading, items, itemsCount, itemHeight, containerPadding, mobileItemHeight, showSearch, disableAutofocus, searchString, searchLabel, searchPlaceholder, searchFieldSize, onSearch, showTabs, tabs, selectedTabId, onTabSelect, renderNoData, footer, closeDropdown, accessibilityConfig, renderItem, body, itemHeightGetter, itemTitleGetter, getIsItemSelected, loadNextPage, hasNextPage, skeletonItemsCount, shouldLoadNextPage, isNextPageLoading, SkeletonItem, onScroll, scrollToItem, scrollToItemKeyExtractor }: IDropdownListProps<T>): ReactElement;
 
 /**
  * @internal
@@ -984,6 +990,18 @@ export declare const ExportDialogBase: NamedExoticComponent<IExportDialogBasePro
  */
 export declare const ExportTabularPdfDialog: NamedExoticComponent<IExportTabularPdfDialogProps>;
 
+/**
+ * Where the selection goes when the controlled value is replaced from outside.
+ *
+ * - `"clamp"` keeps the current selection, clamped into the new document's bounds.
+ * - `"end"` puts the cursor at the end of the new document — for editors whose external replaces
+ *   mean "a new document" (an applied example, a re-format), where the old offset is meaningless
+ *   and a subsequent insert-at-cursor should append rather than land at a stale position.
+ *
+ * @internal
+ */
+export declare type ExternalChangeSelection = "clamp" | "end";
+
 /**
  * @internal
  */
@@ -1054,24 +1072,7 @@ export declare const findItem: <T extends IUiMenuItemData = object>(items: IUiMe
 /**
  * @internal
  */
-export declare class FlexDimensions extends Component<IFlexDimensionsProps, IFlexDimensionsState> {
-    static defaultProps: {
-        children: boolean;
-        className: string;
-        measureWidth: boolean;
-        measureHeight: boolean;
-    };
-    private wrapperRef;
-    private readonly throttledUpdateSize;
-    private readonly resizeObserver;
-    constructor(props: IFlexDimensionsProps);
-    componentDidMount(): void;
-    componentWillUnmount(): void;
-    getChildrenDimensions(): Partial<IFlexDimensionsState>;
-    updateSize: () => void;
-    renderChildren(): ReactNode;
-    render(): ReactNode;
-}
+export declare const FlexDimensions: ForwardRefExoticComponent<IFlexDimensionsProps & RefAttributes<IFlexDimensionsHandle>>;
 
 /**
  * Data attribute to identify elements that should not trigger outside click closure.
@@ -1686,7 +1687,6 @@ export declare interface IAppHeaderProps {
     helpMenuDropdownAlignPoints?: HelpMenuDropdownAlignPoints;
     showStaticHelpMenu?: boolean;
     helpRedirectUrl?: string;
-    theme?: ITheme;
     showUpsellButton?: boolean;
     onUpsellButtonClick?: (e: MouseEvent_2) => void;
     search?: ReactNode;
@@ -3304,6 +3304,11 @@ export declare interface IDropdownListProps<T> {
     renderItem: (props: IRenderDropdownListItemProps<T>) => ReactElement;
     itemHeightGetter?: (index: number) => number;
     itemTitleGetter?: (item: T) => string;
+    /**
+     * Predicate that returns true for the currently selected item. It drives the options'
+     * `aria-selected` and the `isSelected` render prop.
+     */
+    getIsItemSelected?: (item: T) => boolean;
     accessibilityConfig?: Pick<IAccessibilityConfigBase, "ariaLabel" | "ariaLabelledBy" | "role">;
     body?: ReactNode | ((closeDropdown: () => void) => ReactNode);
     onScroll?: () => void;
@@ -3698,6 +3703,15 @@ export declare interface IFilterLabelState {
     hasEllipsis: boolean;
 }
 
+/**
+ * Imperative API exposed by the FlexDimensions component through its ref.
+ *
+ * @internal
+ */
+export declare interface IFlexDimensionsHandle {
+    updateSize: () => void;
+}
+
 /**
  * @internal
  */
@@ -4075,6 +4089,18 @@ export declare interface IInputPureAccessibilityConfig extends IAccessibilityCon
     ariaInvalid?: AriaAttributes["aria-invalid"];
 }
 
+/**
+ * Imperative handle exposed by {@link InputPure}.
+ *
+ * `inputNodeRef` is the native `<input>` element - consumers chain `Input.inputNodeRef.inputNodeRef`
+ * down to it, so it has to stay the DOM node and not the component instance.
+ *
+ * @internal
+ */
+export declare interface IInputPureHandle extends IDomNative {
+    inputNodeRef: HTMLInputElement | null;
+}
+
 /**
  * @internal
  */
@@ -5036,92 +5062,12 @@ export declare interface INoDataProps {
 /**
  * @internal
  */
-export declare class Input extends PureComponent<IInputPureProps, IInputState> {
-    static defaultProps: {
-        autofocus: boolean;
-        className: string;
-        clearOnEsc: boolean;
-        disabled: boolean;
-        hasError: boolean;
-        hasWarning: boolean;
-        isSearch: boolean;
-        isSmall: boolean;
-        maxlength: number;
-        onChange: (..._args: unknown[]) => void;
-        onEscKeyPress: (..._args: unknown[]) => void;
-        onEnterKeyPress: (..._args: unknown[]) => void;
-        onBlur: (..._args: unknown[]) => void;
-        onFocus: (..._args: unknown[]) => void;
-        placeholder: string;
-        prefix: string;
-        readonly: boolean;
-        suffix: string;
-        label: string;
-        labelPositionTop: boolean;
-        value: string;
-    };
-    inputNodeRef: InputPure | null;
-    constructor(props: IInputPureProps);
-    UNSAFE_componentWillReceiveProps(nextProps: IInputPureProps): void;
-    onChange: (value: string | number, e?: ChangeEvent<HTMLInputElement> | undefined) => void;
-    valueChanged(value: string | number, e?: ChangeEvent<HTMLInputElement>): void;
-    render(): JSX.Element;
-}
+export declare const Input: ForwardRefExoticComponent<IInputPureProps & RefAttributes<IInputPureHandle>>;
 
 /**
  * @internal
  */
-export declare class InputPure extends PureComponent<IInputPureProps> implements IDomNative {
-    inputNodeRef: HTMLInputElement | null;
-    private autofocusDispatcher;
-    private readonly a11yIdBase;
-    static defaultProps: {
-        autofocus: boolean;
-        className: string;
-        clearOnEsc: boolean;
-        disabled: boolean;
-        hasError: boolean;
-        hasWarning: boolean;
-        isSearch: boolean;
-        isSmall: boolean;
-        maxlength: number;
-        onChange: (..._args: unknown[]) => void;
-        onEscKeyPress: (..._args: unknown[]) => void;
-        onEnterKeyPress: (..._args: unknown[]) => void;
-        onBlur: (..._args: unknown[]) => void;
-        onFocus: (..._args: unknown[]) => void;
-        placeholder: string;
-        prefix: string;
-        readonly: boolean;
-        suffix: string;
-        label: string;
-        labelPositionTop: boolean;
-        value: string;
-    };
-    componentDidMount(): void;
-    componentWillUnmount(): void;
-    componentDidUpdate(prevProps: Readonly<IInputPureProps>): void;
-    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
-    onKeyPress: (e: KeyboardEvent_2<Element>) => void;
-    onClear: (e?: ChangeEvent<HTMLInputElement> | undefined) => void;
-    getLabelClassNames(className: string): string;
-    getInputClassNames(): string;
-    private getA11yIdBase;
-    private getPrefixA11yId;
-    private getSuffixA11yId;
-    renderPrefix(prefix: string, ariaLabel?: string): ReactNode;
-    renderSuffix(suffix: string, ariaLabel?: string): ReactNode;
-    renderLabel(label: ReactNode, htmlFor?: string): ReactNode;
-    renderSearch(isSearch: boolean): ReactNode;
-    renderClearIcon(clearOnEsc: boolean): ReactNode;
-    renderIconButton(iconButton: IconType, iconButtonLabel: string, onIconButtonClick: (e: MouseEvent_2<HTMLButtonElement>) => void): ReactNode;
-    getAriaDescribedBy(): string | undefined;
-    renderInput(): JSX.Element;
-    render(): JSX.Element;
-    focus(options?: {
-        preventScroll?: boolean;
-    }): void;
-}
+export declare const InputPure: ForwardRefExoticComponent<IInputPureProps & RefAttributes<IInputPureHandle>>;
 
 /**
  * @internal
@@ -5460,6 +5406,7 @@ export declare interface IRenderDropdownListItemProps<T> {
     isFirst: boolean;
     isLast: boolean;
     focused?: boolean;
+    isSelected?: boolean;
 }
 
 /**
@@ -5967,6 +5914,26 @@ export declare interface ISharingApplyPayload {
     granteesToDelete: IAccessGrantee[];
 }
 
+/**
+ * To make this component work, parent container needs this:
+ *      max-width: Xpx;
+ *      white-space: nowrap;
+ *
+ * and the component itself needs:
+ *      display: inline-block;
+ *      width: 100%;
+ *      white-space: nowrap;
+ */
+/**
+ * Imperative API exposed through a ref, used by consumers that need to re-measure the text
+ * after a layout change that React cannot observe on its own (e.g. a container resize).
+ *
+ * @internal
+ */
+export declare interface IShortenedTextHandle {
+    recomputeShortening: () => void;
+}
+
 /**
  * @internal
  */
@@ -6010,6 +5977,8 @@ export declare interface ISimpleSettingWidgetProps {
  */
 export declare interface ISingleSelectListItemProps {
     title?: string;
+    /** Rendered right after the title, e.g. a "(Default)" marker. */
+    suffix?: ReactNode;
     icon?: string | ReactNode;
     type?: SingleSelectListItemType;
     className?: string;
@@ -6136,6 +6105,18 @@ export declare interface IStylingEditorDialogProps<T extends StylingPickerItemCo
      * this never prevents submission — use it for content that applies but degrades the result.
      */
     validateDefinitionWarning?: (content: T) => string | undefined;
+    /**
+     * Optionally replaces the definition editor, e.g. with a syntax-highlighting one.
+     *
+     * @remarks
+     * `value` is the definition as JSON text, and `onChange` expects JSON text back — the same
+     * contract as the plain textarea rendered when this is not supplied. Anything richer (a language
+     * toggle and its persistence, for instance) stays owned by the caller.
+     */
+    renderDefinitionEditor?: (props: {
+        value: string;
+        onChange: (next: string) => void;
+    }) => ReactNode;
 }
 
 /**
@@ -6230,6 +6211,11 @@ export declare interface ISyntaxHighlightingInputProps {
         aboveCursor?: boolean;
     };
     onCompletion?: CompletionSource;
+    /**
+     * Where the selection goes when the controlled `value` is replaced from outside: clamped in
+     * place (default), or at the end of the new document.
+     */
+    externalChangeSelection?: ExternalChangeSelection;
 }
 
 /**
@@ -7111,6 +7097,141 @@ export declare interface IUiComboboxState {
     listboxId: string;
 }
 
+/**
+ * Imperative operations on the editor's text, for callers that need to act at the cursor.
+ *
+ * @internal
+ */
+export declare interface IUiConfigEditorApi {
+    /** Replaces the current selection with `text` and leaves the caret directly after it. */
+    insertAtCursor: (text: string) => void;
+    focus: () => void;
+}
+
+/**
+ * What the editor hands a caller rendering the toolbar's context menu.
+ *
+ * @internal
+ */
+export declare interface IUiConfigEditorContextMenuProps {
+    /** Closes the menu — pass straight to `UiMenu`'s `onClose`. */
+    onClose: () => void;
+    /**
+     * Identity for the menu, naming it after the button that opened it. Spread onto `UiMenu`'s
+     * required `ariaAttributes`.
+     */
+    ariaAttributes: {
+        id: string;
+        "aria-labelledby": string;
+    };
+}
+
+/**
+ * The editor's localized texts, gathered in one object so adding a text does not grow the prop
+ * list. The caller localizes them, as with the other kit primitives; every key is optional.
+ *
+ * @internal
+ */
+export declare interface IUiConfigEditorLabels {
+    /**
+     * Radio label per offered language, keyed by the language. Optional and partial: a language
+     * without an entry falls back to its technical name ("JSON", "YAML"), which as format names
+     * are usually left untranslated.
+     */
+    languages?: Partial<Record<ConfigEditorLanguage, string>>;
+    /** Label of the action that re-formats the current text. Defaults to "Auto-format". */
+    autoFormat?: string;
+    /** Accessible name for the language radio group, e.g. "Editor language". */
+    languageSwitcher?: string;
+    /** Accessible name for the button opening the context menu, e.g. "More actions". */
+    contextMenu?: string;
+    /**
+     * Localized message shown on each syntax-error diagnostic in the lint gutter. Read when the
+     * editor mounts (and whenever the language changes); a later change to it is not picked up on
+     * its own. Without it no syntax linting is installed.
+     */
+    syntaxError?: string;
+}
+
+/**
+ * @internal
+ */
+export declare interface IUiConfigEditorProps {
+    /**
+     * The value, as text in the primary language. The component's single source of truth — any other
+     * offered language is only ever a rendering of it.
+     */
+    value: string;
+    /**
+     * Fires with the next value, as text in the primary language.
+     *
+     * While a draft cannot be parsed, the raw draft is passed through verbatim instead. Callers
+     * already validate this value by parsing it, so the invalid text reaching them unchanged is what
+     * makes their existing "invalid definition" handling report the problem.
+     */
+    onChange: (next: string) => void;
+    /** Language the value is written in — what `onChange` emits. Defaults to JSON. */
+    primaryLanguage?: ConfigEditorLanguage;
+    /**
+     * Languages offered in the toolbar's switcher, in render order. With fewer than two entries no
+     * switcher is rendered at all and the value is shown in the primary language, verbatim — the
+     * editor never converts anything. Defaults to JSON and YAML.
+     *
+     * Only a JSON primary offers projections: YAML is a superset of JSON, so projecting the other
+     * way an invalid JSON draft can be a valid YAML document, and the pass-through contract could
+     * hand the caller text that validates as something the user never saw validated. With any
+     * other primary the editor is single-language regardless of this prop.
+     */
+    languages?: ConfigEditorLanguage[];
+    /**
+     * Language the text is displayed in. Controlled: the caller owns it, and any persistence of it.
+     * Defaults to the primary language, which is also what a single-language editor always
+     * displays. Honored only with a JSON primary, and the switcher renders only when this and
+     * `onLanguageChange` are both supplied — the controlled pair is what makes a selection able to
+     * take effect.
+     */
+    language?: ConfigEditorLanguage;
+    /**
+     * Reports the language the user picked in the switcher. Without it no switcher is rendered,
+     * whatever `languages` offers — the editor is controlled and cannot honor a selection it has
+     * no way to report.
+     */
+    onLanguageChange?: (next: ConfigEditorLanguage) => void;
+    /**
+     * Schema-aware autocompletion for YAML, consulted while YAML is the displayed language. It is
+     * handed the position's enclosing mapping keys, so completions can follow the document's shape.
+     */
+    completionSource?: YamlCompletionSource;
+    /** The editor's localized texts. Anything omitted falls back to a neutral default. */
+    labels?: IUiConfigEditorLabels;
+    /**
+     * Renders the contents of the toolbar's context menu, usually a `UiMenu`.
+     *
+     * The editor owns the button that opens it and the popover it sits in; what goes inside is the
+     * caller's, since the actions on offer are specific to what is being edited. Omit the prop and
+     * no button is rendered at all.
+     */
+    renderContextMenu?: (props: IUiConfigEditorContextMenuProps) => ReactNode;
+    /**
+     * Accessible name for the editor, wired to its aria-label. CodeMirror has no labellable input
+     * element, so a visible caption cannot be attached with `htmlFor` — pass its text here too.
+     */
+    label?: string;
+    placeholder?: string;
+    /**
+     * Renders the value without allowing edits, while keeping it focusable and selectable so it can
+     * still be read and copied with a keyboard or screen reader. The language toggle stays available
+     * — switching it only changes how the value is displayed.
+     */
+    readOnly?: boolean;
+    /** Blocks editing and the whole toolbar, e.g. while a save is in flight. */
+    disabled?: boolean;
+    /** Visible height, in text rows. The editor also grows to fill a taller parent. */
+    rows?: number;
+    dataTestId?: string;
+    editorRef?: Ref<IUiConfigEditorApi>;
+}
+
 /**
  * @internal
  */
@@ -8780,7 +8901,7 @@ export declare interface IUiSubmenuHeaderProps {
     useShortenedTitle?: boolean;
     textColor?: string;
     backgroundColor?: string;
-    height?: SizeMedium | SizeLarge;
+    height?: SizeSmall | SizeMedium | SizeLarge;
     titleId?: string;
 }
 
@@ -9558,33 +9679,9 @@ export declare interface IWorkspacePickerHomeFooterProps {
     href?: string;
     onClick?: (e: MouseEvent_2<HTMLAnchorElement>) => void;
     className?: string;
-    theme?: ITheme;
     children?: ReactNode;
 }
 
-/**
- * @internal
- */
-export declare interface IYamlEditorProps {
-    initialValue: string;
-    onChange?: (value: string) => void;
-    disabled?: boolean;
-    /** Accessible name for the editor (wired to its aria-label). */
-    label?: string;
-    completionSource?: YamlCompletionSource;
-    /**
-     * When set, wires the built-in YAML syntax linter with this (localized) diagnostic message.
-     * Applied once when the editor mounts; later changes are not re-applied.
-     */
-    syntaxErrorMessage?: string;
-    /**
-     * Extra CodeMirror extensions, appended after the YAML defaults. Applied once when the editor
-     * mounts; later changes are not re-applied.
-     */
-    extensions?: Extension[];
-    placeholder?: string;
-}
-
 /** @internal */
 export declare interface IYamlPosition {
     /** Keys of the mappings enclosing the position, outermost first. */
@@ -10024,8 +10121,9 @@ export declare type PageOrientation = "PORTRAIT" | "LANDSCAPE";
 export declare type PageSize = "A3" | "A4" | "LETTER";
 
 /**
- * Selects the parameter editing control by `definition.type` — the single seam where control
- * variants are dispatched. New parameter types get a sibling control and a new arm here.
+ * Selects the parameter editing control by `definition.type` and constraint shape — the single
+ * seam where control variants are dispatched. New variants get a sibling control and a new arm
+ * here.
  *
  * @internal
  */
@@ -10066,6 +10164,17 @@ export declare type PermissionMenuLevel = "VIEW" | "SHARE" | "EDIT";
  */
 export declare type PositionPoint = `${VerticalPosition}-${HorizontalPosition}`;
 
+/**
+ * Loads the grammar(s) `UiConfigEditor` needs for the given languages ahead of rendering one.
+ *
+ * Purely an optimization: the editor loads its grammar itself when it first renders, mounting
+ * without highlighting for the moment that takes. Callers that know an editor is coming (and
+ * tests that assert on a fully initialized editor synchronously) can await this instead.
+ *
+ * @internal
+ */
+export declare function preloadUiConfigEditorGrammars(languages?: ConfigEditorLanguage[]): Promise<void>;
+
 /**
  * @internal
  */
@@ -10297,33 +10406,10 @@ export declare type ShareDialogInteractionType = "SHARE_DIALOG_OPENED" | "SHARE_
  */
 export declare function ShareGranteeBase({ isLoading, isLockedNow, isUnderLenientControlNow, grantees, sharedObject, isDirty, currentUserPermissions, dashboardFilters, dashboardParameters, dashboardLinkBasePath, isShareGrantHidden, applyShareGrantOnSelect, showDashboardShareLink, isGranteeShareLoading, onCancel, onSubmit, onGranteeDelete, onGranularGranteeChange, onAddGranteeButtonClick, onLockChange, onUnderLenientControlChange, isCurrentUserWorkspaceManager, onShareLinkCopy }: IShareGranteeBaseProps): JSX.Element;
 
-/**
- * To make this component work, parent container needs this:
- *      max-width: Xpx;
- *      white-space: nowrap;
- *
- * and the component itself needs:
- *      display: inline-block;
- *      width: 100%;
- *      white-space: nowrap;
- */
 /**
  * @internal
  */
-export declare class ShortenedText extends PureComponent<IShortenedTextProps, IShortenedTextState> {
-    static defaultProps: Pick<IShortenedTextProps, "className" | "tagName" | "tooltipAlignPoints" | "tooltipVisibleOnMouseOver" | "getElement" | "displayTooltip" | "ellipsisPosition">;
-    textRef: RefObject<HTMLElement | null>;
-    private naturalScrollWidth;
-    constructor(props: IShortenedTextProps);
-    componentDidMount(): void;
-    UNSAFE_componentWillReceiveProps(nextProps: IShortenedTextProps): void;
-    componentDidUpdate(): void;
-    checkTitle(): void;
-    recomputeShortening(): void;
-    renderTextWithBubble(): ReactNode;
-    renderText(): ReactNode;
-    render(): ReactNode;
-}
+export declare const ShortenedText: ForwardRefExoticComponent<IShortenedTextProps & RefAttributes<IShortenedTextHandle>>;
 
 /**
  * Shortens large numbers with K/M/B suffixes for compact display.
@@ -10505,7 +10591,7 @@ export declare function SubMenu(props: ISubMenuProps): JSX.Element;
 /**
  * @internal
  */
-export declare function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions, extensions, disabled }: ISyntaxHighlightingInputProps): JSX.Element;
+export declare function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions, extensions, disabled, externalChangeSelection }: ISyntaxHighlightingInputProps): JSX.Element;
 
 /**
  * @internal
@@ -10880,6 +10966,25 @@ export declare type UiComboboxListItemLabelProps = HTMLAttributes<HTMLSpanElemen
 /** @internal */
 export declare function UiComboboxPopup({ children, style }: IUiComboboxPopupProps): JSX.Element | null;
 
+/**
+ * A config editor: a CodeMirror source editor with syntax highlighting, line numbers and a lint
+ * gutter, plus a toolbar to re-format the text and — when more than one language is offered — to
+ * read and edit the same value as either JSON or YAML.
+ *
+ * The primary language is always the value in and the value out. Any other offered language is a
+ * convenience projection converted on the fly, so a caller never has to know which language the user
+ * happens to be looking at. A single-language editor never converts at all: what is typed is what is
+ * emitted, byte for byte, so YAML comments and formatting the caller cares about survive.
+ *
+ * Switching language re-emits the value in canonical form, which is what makes switching to YAML and
+ * back re-format the JSON. The canonical form matches the `JSON.stringify(value, null, 4)` that
+ * callers conventionally seed the field with, so a switch on an untouched value is a no-op rather
+ * than something that marks a form dirty.
+ *
+ * @internal
+ */
+export declare function UiConfigEditor({ value, onChange, primaryLanguage, languages, language, onLanguageChange, completionSource, labels, renderContextMenu, label, placeholder, readOnly, disabled, rows, dataTestId, editorRef }: IUiConfigEditorProps): JSX.Element;
+
 /**
  * Modal confirm dialog used for actions that need explicit user confirmation
  * (granting workspace access, restricting access, removing a grantee,
@@ -12068,22 +12173,11 @@ export declare function withBubble<T>(WrappedComponent: ComponentType<T>): Forwa
 /**
  * @internal
  */
-export declare const WorkspacePickerHomeFooter: ComponentType<Omit<IWorkspacePickerHomeFooterProps, "theme" | "themeIsLoading" | "themeStatus">>;
+export declare function WorkspacePickerHomeFooter({ children, className, href, onClick }: IWorkspacePickerHomeFooterProps): JSX.Element;
 
 /** @internal */
 export declare type YamlCompletionSource = (context: CompletionContext, position: IYamlPosition) => ReturnType<CompletionSource>;
 
-/**
- * A YAML source editor: syntax highlighting, line numbers, a lint gutter, an optional syntax linter,
- * and optional schema-aware autocompletion. Generic YAML plumbing lives here; schema-specific policy
- * (the completion source, the syntax-error message, value handling) is injected by the caller.
- *
- * Uncontrolled: it seeds from `initialValue` and reports edits through `onChange`; the parent reads
- * the current value from `onChange`, never by re-driving `initialValue`.
- * @internal
- */
-export declare function YamlEditor({ initialValue, onChange, disabled, label, completionSource, syntaxErrorMessage, extensions, placeholder }: IYamlEditorProps): JSX.Element;
-
 /** @internal */
 export declare function yamlPositionAt(state: EditorState, pos: number): IYamlPosition;
 

package/esm/syntaxHighlightingInput/SyntaxHighlightingInput.d.ts

@@ -1,6 +1,7 @@
 import { type CompletionSource } from "@codemirror/autocomplete";
 import { type Extension } from "@codemirror/state";
 import { type EditorView } from "@codemirror/view";
+import { type ExternalChangeSelection } from "./hooks/useCodemirrorChange.js";
 /**
  * @internal
  */
@@ -24,9 +25,14 @@ export interface ISyntaxHighlightingInputProps {
         aboveCursor?: boolean;
     };
     onCompletion?: CompletionSource;
+    /**
+     * Where the selection goes when the controlled `value` is replaced from outside: clamped in
+     * place (default), or at the end of the new document.
+     */
+    externalChangeSelection?: ExternalChangeSelection;
 }
 /**
  * @internal
  */
-export declare function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions, extensions, disabled }: ISyntaxHighlightingInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions, extensions, disabled, externalChangeSelection }: ISyntaxHighlightingInputProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SyntaxHighlightingInput.d.ts.map

package/esm/syntaxHighlightingInput/SyntaxHighlightingInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SyntaxHighlightingInput.d.ts","sourceRoot":"","sources":["../../src/syntaxHighlightingInput/SyntaxHighlightingInput.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACvD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC;IAChE,cAAc,CAAC,EAAE;QACb,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,KAAK,EACL,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,MAAM,EACN,SAAS,EACT,gBAAqB,EACrB,UAAe,EACf,QAAQ,EACX,EAAE,6BAA6B,2CAmB/B"}
+{"version":3,"file":"SyntaxHighlightingInput.d.ts","sourceRoot":"","sources":["../../src/syntaxHighlightingInput/SyntaxHighlightingInput.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACvD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC;IAChE,cAAc,CAAC,EAAE;QACb,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,KAAK,EACL,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,MAAM,EACN,SAAS,EACT,gBAAqB,EACrB,UAAe,EACf,QAAQ,EACR,uBAAuB,EAC1B,EAAE,6BAA6B,2CAoB/B"}

package/esm/syntaxHighlightingInput/SyntaxHighlightingInput.js

@@ -4,7 +4,7 @@ import { useCodemirror } from "./hooks/useCodemirror.js";
 /**
  * @internal
  */
-export function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions = [], extensions = [], disabled, }) {
+export function SyntaxHighlightingInput({ value, label, placeholder, autocompletion, onApi, onChange, onCursor, onKeyDown, onCompletion, onFocus, onBlur, className, beforeExtensions = [], extensions = [], disabled, externalChangeSelection, }) {
     const { editorRef } = useCodemirror({
         placeholderText: placeholder,
         autocompletion,
@@ -20,6 +20,7 @@ export function SyntaxHighlightingInput({ value, label, placeholder, autocomplet
         onCompletion,
         onFocus,
         onBlur,
+        externalChangeSelection,
     });
     return _jsx("div", { className: cx(className, "gd-input-syntax-highlighting-input"), ref: editorRef });
 }

package/esm/syntaxHighlightingInput/hooks/useChangeHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChangeHandler.d.ts","sourceRoot":"","sources":["../../../src/syntaxHighlightingInput/hooks/useChangeHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAIhD,wBAAgB,gBAAgB,CAAC,EAC7B,YAAY,EACZ,YAAY,EACf,EAAE;IACC,YAAY,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;IACjD,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;CAC7E;;EAiBA"}
+{"version":3,"file":"useChangeHandler.d.ts","sourceRoot":"","sources":["../../../src/syntaxHighlightingInput/hooks/useChangeHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAKhD,wBAAgB,gBAAgB,CAAC,EAC7B,YAAY,EACZ,YAAY,EACf,EAAE;IACC,YAAY,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;IACjD,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;CAC7E;;EAwBA"}