@vertesia/appgen-docs 1.5.0-dev.20260725.083715Z

package/lib/docs/ui-interfaces.d.ts

@@ -0,0 +1,1284 @@
+// Generated by @vertesia/appgen-docs.
+// Do not edit by hand. This concatenates selected @vertesia/ui declaration files
+// so generated app agents can grep exact exported names and prop interfaces.
+// Section file paths below are source declaration paths, not import specifiers.
+// Import public UI APIs from '@vertesia/ui/core', '@vertesia/ui/session',
+// '@vertesia/ui/router', '@vertesia/ui/layout', '@vertesia/ui/features',
+// or '@vertesia/ui/widgets'. Do not import '@vertesia/ui/core/shadcn/*'.
+
+// -----------------------------------------------------------------------------
+// core/components/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './Avatar.js';
+export * from './Center.js';
+export * from './ComboBox.js';
+export * from './Divider.js';
+export * from './EmptyCollection.js';
+export * from './FileUpload.js';
+export * from './FormItem.js';
+export * from './InputList.js';
+export * from './Link.js';
+export * from './MenuList.js';
+export * from './NumberInput.js';
+export * from './Overlay.js';
+export * from './Portal.js';
+export * from './popup/index.js';
+export * from './SelectList.js';
+export * from './SidePanel.js';
+export * from './Spinner.js';
+export * from './shadcn/index.js';
+export * from './styles.js';
+export * from './TagsInput.js';
+export * from './table/index.js';
+export * from './toast/index.js';
+export type HeroIcon = React.ForwardRefExoticComponent<Omit<React.SVGProps<SVGSVGElement>, 'ref'> & {
+    title?: string | undefined;
+    titleId?: string | undefined;
+} & React.RefAttributes<SVGSVGElement>>;
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './badge';
+export * from './breadcrumb';
+export * from './button';
+export * from './button';
+export * from './card';
+export * from './checkbox';
+export * from './collaspible';
+export * from './command';
+export * from './dropdown';
+export * from './filters';
+export * from './heading';
+export * from './input';
+export * from './LanguageSwitcher';
+export * from './label';
+export * from './MessageBox';
+export * from './modal';
+export * from './Panel';
+export * from './popover';
+export * from './radioGroup';
+export * from './resizeable';
+export * from './selectBox';
+export * from './separator';
+export * from './slider';
+export * from './switch';
+export * from './tabs';
+export * from './text';
+export * from './textarea';
+export * from './theme/ThemeProvider';
+export * from './theme/ThemeSwitcher';
+export * from './tooltip';
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/input.d.ts
+// -----------------------------------------------------------------------------
+import { type VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare const variants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+    variant?: "default" | "legacy" | "unstyled" | "noPadding" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type InputVariant = 'default' | 'unstyled' | 'noPadding' | 'legacy';
+export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'onChange'> {
+    size?: VariantProps<typeof variants>['size'];
+    variant?: InputVariant;
+    clearable?: boolean;
+    value?: string;
+    onChange?: (value: string) => void;
+    /**
+     * Convenience for `aria-invalid`. When true, sets aria-invalid="true" and styles via
+     * the existing `aria-invalid:*` Tailwind utilities. Prefer this over passing aria-invalid
+     * directly so consumers and FormItem can drive validity through a single prop.
+     */
+    invalid?: boolean;
+}
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+export { Input };
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/button.d.ts
+// -----------------------------------------------------------------------------
+import { type VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "destructive" | "outline" | "secondary" | "ghost" | "primary" | "unstyled" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "icon" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+    /**
+     * @deprecated Use `title` instead. `alt` drives the same tooltip but, unlike `title`, it
+     * overrides the accessible name even when the button shows a text label — which usually
+     * violates WCAG 2.5.3 (Label in Name). That legacy behavior is preserved so existing call
+     * sites keep announcing what they always did. Slated for removal in the next major.
+     */
+    alt?: string;
+    /**
+     * Tooltip text. Renders a `<VTooltip>` around the button and doubles as the accessible name,
+     * so icon-only buttons need nothing else. Pass `aria-label` to override the name independently.
+     */
+    title?: string;
+    /** Which side the `title` tooltip opens on. Defaults to `top`. */
+    tooltipPlacement?: 'top' | 'right' | 'bottom' | 'left';
+    isDisabled?: boolean;
+    isLoading?: boolean;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+interface CopyButtonProps {
+    content: string;
+    /** @deprecated use `aria-label` */
+    alt?: string;
+    'aria-label'?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'icon';
+    toast?: {
+        toast: (options: {
+            status: 'success' | 'error';
+            title: string;
+            duration: number;
+        }) => void;
+        message: string;
+    };
+    className?: string;
+}
+declare const CopyButton: React.ForwardRefExoticComponent<CopyButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export { Button, buttonVariants, CopyButton };
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/badge.d.ts
+// -----------------------------------------------------------------------------
+import { type VariantProps } from 'class-variance-authority';
+import type * as React from 'react';
+declare const badgeVariants: (props?: ({
+    variant?: "done" | "default" | "destructive" | "outline" | "secondary" | "success" | "attention" | "info" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+interface BaseBadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+    children: React.ReactNode;
+    onClick?: () => void;
+}
+export declare function Badge({ className, variant, children, onClick, ...props }: BaseBadgeProps): React.JSX.Element;
+declare const dotBadgeVariants: (props?: ({
+    variant?: "done" | "default" | "destructive" | "outline" | "success" | "attention" | "info" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+interface DotBadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof dotBadgeVariants> {
+    children?: React.ReactNode;
+    dotClassName?: string;
+}
+export declare function DotBadge({ variant, className, dotClassName, // New prop for dot-specific classes
+children, ...props }: DotBadgeProps): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/modal/dialog.d.ts
+// -----------------------------------------------------------------------------
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+import * as React from 'react';
+interface ModalProps {
+    children: React.ReactNode | React.ReactNode[];
+    isOpen: boolean;
+    onClose: () => void;
+    description?: string;
+    noCloseButton?: boolean;
+    className?: string;
+    allowOverflow?: boolean;
+    disableCloseOnClickOutside?: boolean;
+    size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    action?: React.ReactNode;
+}
+export declare function useIsInModal(): boolean;
+export declare function ModalContextProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+export declare function Modal({ className, children, isOpen, onClose, description, noCloseButton, allowOverflow, disableCloseOnClickOutside, size, action, }: ModalProps): React.JSX.Element;
+export declare const ModalTitle: ({ children, show, className, description, showDivider, ...props }: React.HTMLAttributes<HTMLHeadingElement> & {
+    show?: boolean;
+    description?: string;
+    showDivider?: boolean;
+}) => React.JSX.Element;
+export declare const ModalBody: ({ children, className, ...props }: React.HTMLAttributes<HTMLDivElement>) => React.JSX.Element;
+interface ModalFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+    align?: 'left' | 'right' | 'center';
+    children: React.ReactNode | React.ReactNode[];
+    className?: string;
+}
+export declare const ModalFooter: ({ align, children, className, ...props }: ModalFooterProps) => React.JSX.Element;
+declare const Dialog: React.FC<DialogPrimitive.DialogProps>;
+declare const DialogTrigger: React.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const DialogPortal: React.FC<DialogPrimitive.DialogPortalProps>;
+declare const DialogClose: React.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const DialogContent: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const DialogDescription: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+declare const DialogTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/modal/ConfirmModal.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+interface ConfirmModalProps {
+    title: string;
+    content: string | React.ReactNode;
+    onConfirm: () => void;
+    onCancel: () => void;
+    isOpen: boolean;
+    isLoading?: boolean;
+    /**
+     * When set, the user must type this exact value into a confirmation input
+     * before the Confirm button is enabled. Use for destructive, irreversible
+     * actions (e.g. typing a principal's email before deleting their access).
+     * Matching ignores leading/trailing whitespace but is case-sensitive.
+     */
+    confirmationValue?: string;
+    /**
+     * Label rendered above the confirmation input. Recommended whenever
+     * `confirmationValue` is set so the user knows what to type. Ignored when
+     * `confirmationValue` is not set.
+     */
+    confirmationLabel?: React.ReactNode;
+    /** Placeholder for the confirmation input. Ignored when `confirmationValue` is not set. */
+    confirmationPlaceholder?: string;
+}
+export declare function ConfirmModal({ title, content, onConfirm, onCancel, isOpen, isLoading, confirmationValue, confirmationLabel, confirmationPlaceholder, }: ConfirmModalProps): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/modal/DeleteModal.d.ts
+// -----------------------------------------------------------------------------
+import type { ReactNode } from 'react';
+interface DeleteModalProps {
+    idToDelete?: string;
+    title: string;
+    content: string | ReactNode;
+    setIdToDelete: (id: string | undefined) => void;
+    deleteApi: (id: string) => Promise<unknown>;
+}
+export declare function DeleteModal({ idToDelete, title, content, setIdToDelete, deleteApi }: DeleteModalProps): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/selectBox.d.ts
+// -----------------------------------------------------------------------------
+import { type ReactNode } from 'react';
+export interface SelectBoxBaseProps<T> {
+    options: T[] | undefined;
+    optionLabel?: (option: T) => React.ReactNode;
+    /**
+     * Optional grouping. Returns the group heading for an option; options that return the same
+     * heading are rendered together beneath it. Groups appear in order of first occurrence in
+     * `options`, so the caller controls group order by ordering the options accordingly.
+     */
+    groupBy?: (option: T) => string;
+    onBlur?: () => void;
+    onKeyDown?: (e: React.KeyboardEvent, isOpen: boolean) => void;
+    label?: string;
+    placeholder?: string;
+    addNew?: () => void;
+    addNewLabel?: string;
+    disabled?: boolean;
+    filterBy?: string | ((o: T) => string);
+    by?: (keyof T & string) | ((a: T, z: T) => boolean);
+    className?: string;
+    popupClass?: string;
+    isClearable?: boolean;
+    border?: boolean;
+    inline?: boolean;
+    clearIcon?: ReactNode;
+    clearTitle?: string;
+    isLoading?: boolean;
+    /** Show warning when value is not in options list (default: true) */
+    warnOnMissingValue?: boolean;
+    /** Custom warning message when value is not in options */
+    missingValueWarning?: string;
+    /** Accessible name. Defaults to the `label` prop when provided. Required when icon-only. */
+    'aria-label'?: string;
+    /** Id of an element that labels the trigger. Use when there is a visible external label. */
+    'aria-labelledby'?: string;
+    /** Id forwarded to the trigger button. Required for FormItem's auto-wiring to work. */
+    id?: string;
+    /** Ids of elements describing the control (e.g. FormItem helpText/error). Forwarded to the trigger. */
+    'aria-describedby'?: string;
+    /** Marks the control invalid. Forwarded to the trigger and combined with the internal
+     *  missing-value detection (either being truthy yields aria-invalid="true"). */
+    'aria-invalid'?: boolean | 'true' | 'false';
+}
+interface SelectBoxSingleProps<T> extends SelectBoxBaseProps<T> {
+    multiple?: false;
+    value?: T;
+    onChange: (option: T) => void;
+}
+interface SelectBoxMultipleProps<T> extends SelectBoxBaseProps<T> {
+    multiple: true;
+    value?: T[];
+    onChange: (options: T[]) => void;
+}
+type SelectBoxProps<T> = SelectBoxSingleProps<T> | SelectBoxMultipleProps<T>;
+export declare function SelectBox<T = unknown>({ options, optionLabel, groupBy, value, onChange, addNew, addNewLabel, disabled, filterBy, label, placeholder, className, popupClass, isClearable, border, multiple, by, inline, isLoading, warnOnMissingValue, missingValueWarning, clearIcon, clearTitle, 'aria-label': ariaLabelProp, 'aria-labelledby': ariaLabelledByProp, id: idProp, 'aria-describedby': ariaDescribedByProp, 'aria-invalid': ariaInvalidProp, }: Readonly<SelectBoxProps<T>>): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/textarea.d.ts
+// -----------------------------------------------------------------------------
+interface TextareaProps extends React.ComponentProps<'textarea'> {
+    minLines?: number;
+    maxLines?: number;
+}
+declare function Textarea({ className, minLines, maxLines, value, ...props }: TextareaProps): import("react").JSX.Element;
+export type { TextareaProps };
+export { Textarea };
+
+// -----------------------------------------------------------------------------
+// core/components/shadcn/tabs.d.ts
+// -----------------------------------------------------------------------------
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import type { ReactNode } from 'react';
+import * as React from 'react';
+export interface Tab {
+    name: string;
+    current?: boolean;
+    href?: string;
+    label: ReactNode;
+    content: ReactNode;
+    disabled?: boolean;
+    is_allowed?: boolean;
+}
+/**
+ * Guard consulted before switching to another tab. Return `false` to cancel the switch — the active
+ * tab, the URL hash and the browser history are all left untouched, so the guard can hold the user
+ * on a tab that has unsaved changes while a confirmation is shown.
+ *
+ * It is only called when the target tab differs from the active one, but it may be called more than
+ * once for a single attempted switch (a click reaches both the trigger and the Radix root), so any
+ * side effect it performs must be idempotent.
+ */
+export type CanChangeTab = (nextTab: string, currentTab?: string) => boolean;
+interface TabsProps {
+    current?: string | (() => string);
+    tabs: Tab[];
+    defaultValue?: string;
+    className?: string;
+    fullWidth?: boolean;
+    fullHeight?: boolean;
+    children?: React.ReactNode;
+    onTabChange?: (tabName: string) => void;
+    responsive?: boolean;
+    variant?: 'tabs' | 'pills';
+    updateHash?: boolean;
+    canChangeTab?: CanChangeTab;
+}
+declare const Tabs: ({ tabs, defaultValue, current, className, fullWidth, fullHeight, children, onTabChange, responsive, variant, updateHash, canChangeTab, }: TabsProps) => React.JSX.Element;
+interface TabsBarProps {
+    className?: string;
+    sticky?: boolean;
+    direction?: 'vertical' | 'horizontal';
+}
+declare const TabsBar: ({ className, sticky, direction }: TabsBarProps) => React.JSX.Element | null;
+declare const TabsPanel: ({ className }: {
+    className?: string;
+}) => React.JSX.Element | null;
+type TabsListProps = React.ComponentPropsWithoutRef<typeof TabsPrimitive.List> & {
+    size?: number;
+    variant?: 'tabs' | 'pills';
+};
+declare const TabsList: React.ForwardRefExoticComponent<TabsListProps & React.RefAttributes<React.ElementRef<typeof TabsPrimitive.List>>>;
+type TabsTriggerProps = React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> & {
+    href?: string;
+    variant?: 'tabs' | 'pills';
+};
+declare const TabsTrigger: React.ForwardRefExoticComponent<TabsTriggerProps & React.RefAttributes<React.ElementRef<typeof TabsPrimitive.Trigger>>>;
+type TabsContentProps = React.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>;
+declare const TabsContent: React.ForwardRefExoticComponent<TabsContentProps & React.RefAttributes<React.ElementRef<typeof TabsPrimitive.Content>>>;
+export { Tabs, TabsBar, TabsContent, TabsList, TabsPanel, TabsTrigger };
+
+// -----------------------------------------------------------------------------
+// core/components/table/index.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+export declare function Table({ className, children, ...others }: React.HTMLProps<HTMLTableElement>): React.JSX.Element;
+interface THeadProps {
+    children: React.ReactNode;
+}
+export declare function THead({ children }: Readonly<THeadProps>): React.JSX.Element;
+export declare function RowSkeleton({ columns }: {
+    columns: number;
+}): React.JSX.Element;
+interface TBodySkeletonProps {
+    isLoading?: boolean;
+    columns: number;
+    rows?: number;
+    children: React.ReactNode;
+}
+export declare function TBody({ isLoading, columns, rows, children }: Readonly<TBodySkeletonProps>): React.JSX.Element;
+export declare function TR({ className, children, ...others }: React.HTMLProps<HTMLTableRowElement>): React.JSX.Element;
+/**
+ * Header cell. Defaults to scope="col" so screen readers associate column
+ * cells with their header. Pass scope="row" for row headers.
+ */
+export declare function TableHeaderCell({ scope, children, ...others }: React.ThHTMLAttributes<HTMLTableCellElement>): React.JSX.Element;
+export type SortDirection = 'ascending' | 'descending' | 'none';
+interface SortableTableHeaderCellProps extends Omit<React.ThHTMLAttributes<HTMLTableCellElement>, 'onClick' | 'aria-sort'> {
+    /** Current sort state. Drives aria-sort on the <th>. */
+    sortDirection?: SortDirection;
+    /** Fired when the user activates the sort trigger (mouse or keyboard). */
+    onSort?: () => void;
+    /** Visual sort indicator rendered after the children. Receives the current direction. */
+    sortIndicator?: (direction: SortDirection) => React.ReactNode;
+    /** Disable the sort trigger; renders children without a button wrapper. */
+    disabled?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * Sortable header cell. Renders the trigger as a real <button> inside the
+ * <th> and exposes the current sort direction via aria-sort on the <th>
+ * (the WAI-ARIA-recommended pattern). The button is keyboard-operable
+ * automatically — no onKeyDown plumbing required.
+ */
+export declare function SortableTableHeaderCell({ sortDirection, onSort, sortIndicator, disabled, children, className, scope, ...others }: SortableTableHeaderCellProps): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/FormItem.d.ts
+// -----------------------------------------------------------------------------
+import { type ReactNode } from 'react';
+interface FormItemProps {
+    label: ReactNode;
+    children: ReactNode;
+    /** Explicit id for the control. When omitted and FormItem can wire a single
+     *  element child, an id is auto-generated via useId(). */
+    childrenId?: string;
+    className?: string;
+    /** Tooltip text rendered on an Info icon next to the label.
+     *  NOTE: this is *not* an a11y substitute for helpText — it is hover-only.
+     *  For persistent helper text linked to the control via aria-describedby,
+     *  use the `helpText` prop instead. */
+    description?: ReactNode;
+    /** Persistent helper text rendered below the control and linked via
+     *  aria-describedby. Use this (not `description`) to give screen-reader
+     *  users guidance on how to fill the field. */
+    helpText?: ReactNode;
+    /** Persistent error message rendered below the control. When set, the
+     *  control gets aria-invalid="true" and the error id is appended to
+     *  aria-describedby. */
+    error?: ReactNode;
+    required?: boolean;
+    direction?: 'row' | 'column' | 'row-reverse';
+    disabled?: boolean;
+    /** When true, the label row stretches to full width. Useful when placing actions (e.g. buttons) inside the label. */
+    fullWidthLabel?: boolean;
+}
+export declare function FormItem({ description, helpText, error, required, label, className, direction, children, disabled, fullWidthLabel, childrenId, }: FormItemProps): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/SelectList.d.ts
+// -----------------------------------------------------------------------------
+import { type ReactNode } from 'react';
+export interface OptionLayout {
+    label?: ReactNode;
+    check?: ReactNode;
+    reverse?: boolean;
+    className?: string;
+}
+export interface SelectListProps<T> {
+    value?: T;
+    options: T[];
+    onChange: (value: T) => void;
+    className?: string;
+    by?: (keyof T & string) | ((o1: T, o2: T) => boolean);
+    optionLayout?: (opt: T, selected: boolean) => OptionLayout;
+    noCheck?: boolean;
+    filterBy?: (filterValue: string) => (opt: T) => boolean;
+}
+export declare function SelectList<T>({ value, options, onChange, className, optionLayout, by, noCheck, filterBy, }: SelectListProps<T>): import("react").JSX.Element;
+
+// -----------------------------------------------------------------------------
+// core/components/ComboBox.d.ts
+// -----------------------------------------------------------------------------
+import React, { type ReactNode } from 'react';
+import { type AlignType, type PopupController } from './popup/index';
+export declare abstract class OptionAdapter<T> {
+    abstract valueOf(item: T): string;
+    abstract idOf(item: T): string;
+    filter(items: T[], text: string): T[];
+    renderOption(item: T): ReactNode;
+    findById(items: T[], id: string): T | undefined;
+    createItem(_value: string): T | null;
+}
+export declare class StringOptionAdapter extends OptionAdapter<string> {
+    valueOf(item: string): string;
+    idOf(item: string): string;
+    static instance: StringOptionAdapter;
+}
+export declare class StringOptionAdapterWithCreate extends StringOptionAdapter {
+    createItem(value: string): string;
+    static instance: StringOptionAdapterWithCreate;
+}
+export interface ComboBoxLayoutProps<T> {
+    buttonRight?: number;
+    buttonWidth?: number;
+    maxMenuHeight?: number;
+    menuClass?: string;
+    inputClass?: string;
+    optionClass?: string;
+    Input?: React.ComponentType<ComboInputProps<T>>;
+    Menu?: React.ComponentType<ComboMenuProps<T>>;
+    Toggle?: React.ComponentType<ComboToggleProps<T>> | null;
+}
+export type ComboBoxLayout<T> = Required<ComboBoxLayoutProps<T>>;
+export declare function getDefaultComboBoxLayout<T>(fullWidth?: boolean, unstyledInput?: boolean): ComboBoxLayout<T>;
+export interface ComboBoxApi<T> {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    inputValue: string;
+    selectedItem: T | null;
+    setInputValue: (value: string) => void;
+    focus: () => void;
+}
+export interface ComboBoxProps<T> {
+    items: T[];
+    adapter: OptionAdapter<T>;
+    unstyledInput?: boolean;
+    fullWidth?: boolean;
+    layout?: ComboBoxLayoutProps<T>;
+    placeholder?: string;
+    api?: React.MutableRefObject<ComboBoxApi<T> | null>;
+    value?: T | null;
+    onSelect?: (value: T | null) => void;
+    zIndex?: number;
+    focusOnMount?: boolean;
+    menuGap?: number;
+    menuAlign?: AlignType;
+    clearable?: boolean;
+    noMatchMessage?: ReactNode;
+    openOnFocus?: boolean;
+}
+export declare function ComboBox<T>({ menuAlign, menuGap, focusOnMount, onSelect, value, zIndex, unstyledInput, fullWidth, api, layout: layoutOpts, adapter, items, placeholder, clearable, noMatchMessage, openOnFocus, }: ComboBoxProps<T>): React.JSX.Element;
+export interface ComboInputProps<T> {
+    layout: ComboBoxLayout<T>;
+    ctrl: ComboboxController<T>;
+    placeholder?: string;
+    boxRef?: React.RefObject<HTMLDivElement | null>;
+    inputRef?: React.RefObject<HTMLInputElement | null>;
+    clearable?: boolean;
+    openOnFocus?: boolean;
+}
+export interface ComboToggleProps<T> {
+    ctrl: ComboboxController<T>;
+    layout: ComboBoxLayout<T>;
+}
+export interface ComboMenuProps<T> {
+    items: T[];
+    layout: ComboBoxLayout<T>;
+    ctrl: ComboboxController<T>;
+    adapter: OptionAdapter<T>;
+    fillWidth: boolean;
+    noMatchMessage?: ReactNode;
+}
+export interface ComboboxControllerProps<ItemT> {
+    adapter: OptionAdapter<ItemT>;
+    items: ItemT[];
+    value?: ItemT | string | null;
+    popupId: string;
+}
+export declare function useComboboxCtrl<ItemT>(props: ComboboxControllerProps<ItemT>): ComboboxController<ItemT>;
+declare class ComboboxController<ItemT> {
+    private popupId;
+    items: ItemT[];
+    private adapter;
+    onSelect?: (item: ItemT | null) => void;
+    private setState?;
+    private _selectedItem;
+    private _filteredItems;
+    private _inputText;
+    private _highlightedIndex;
+    private _isMenuOpen;
+    popupCtrl?: PopupController;
+    constructor({ adapter, items, value, popupId }: ComboboxControllerProps<ItemT>);
+    withState(setState: (ctrl: ComboboxController<ItemT>) => void): this;
+    private clone;
+    private updateState;
+    get filteredItems(): ItemT[];
+    get selectedItem(): ItemT | null;
+    set selectedItem(item: ItemT | null);
+    get isMenuOpen(): boolean;
+    set inputText(inputText: string);
+    get inputText(): string;
+    set highlightedIndex(index: number | null);
+    get highlightedIndex(): number | null;
+    openMenu(): void;
+    closeMenu(_item?: ItemT | null): void;
+    toggleMenu(): void;
+    private highlightIndex;
+    getMenuProps(): {};
+    getToggleButtonProps(): {
+        onClick: () => void;
+    };
+    getItemProps(item: ItemT, index: number): React.HTMLProps<HTMLLIElement>;
+    getInputProps(): {
+        onClick: () => void;
+        onChange: (ev: React.ChangeEvent<HTMLInputElement>) => void;
+        value: string;
+        onKeyDown: (ev: React.KeyboardEvent<HTMLInputElement>) => void;
+    };
+}
+export declare function SimpleCombobox({ options, creatable, ...rest }: Omit<ComboBoxProps<string>, 'adapter' | 'items'> & {
+    options: string[];
+    creatable?: boolean;
+}): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/TagsInput.d.ts
+// -----------------------------------------------------------------------------
+interface TagsInputProps {
+    options: string[];
+    value: string[];
+    onChange: (selected: string[]) => void;
+    onOptionsChange?: (options: string[]) => void;
+    placeholder?: string;
+    className?: string;
+    disabled?: boolean;
+    layout?: 'horizontal' | 'vertical';
+    creatable?: boolean;
+    createText?: string;
+    maxDropdownHeight?: number;
+}
+export declare function TagsInput(props: TagsInputProps): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/NumberInput.d.ts
+// -----------------------------------------------------------------------------
+import React from 'react';
+interface NumberInputProps extends Omit<React.HTMLProps<HTMLInputElement>, 'ref' | 'onChange' | 'value'> {
+    value?: number;
+    onChange?: (value: undefined | number, text: string) => void;
+    noScroll?: boolean;
+    noSpinners?: boolean;
+}
+/**
+ * The value of this input is always a number. It can be undefined or NaN. If NaN the input value will not be updated with the NaN one.
+ * If undefined the input will be updated to be empty.
+ * The onChange callback is called whenever the value changes. If the input cannot be parsed as a number
+ * it will be returned as NaN.
+ */
+declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLInputElement>>;
+export { NumberInput };
+
+// -----------------------------------------------------------------------------
+// core/components/InputList.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+interface InputListProps {
+    value?: string[];
+    onChange: (value: string[]) => void;
+    className?: string;
+    allowSpaces?: boolean;
+    delimiters?: string;
+    placeholder?: string;
+    autoFocus?: boolean;
+    disabled?: boolean;
+}
+export declare function InputList({ value, onChange, className, delimiters, placeholder, autoFocus, disabled, }: InputListProps): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/components/SidePanel.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+interface SidePanelProps {
+    isOpen: boolean;
+    onClose: () => void;
+    children: React.ReactNode;
+    title?: React.ReactNode;
+    panelWidth?: number;
+    backdrop?: boolean;
+    side?: 'left' | 'right';
+    resizable?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+export declare function SidePanel({ isOpen, title, onClose, children, panelWidth, backdrop, side, resizable, className, contentClassName, }: SidePanelProps): React.JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// core/hooks/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './CompositeState.js';
+export * from './PortalContainerProvider.js';
+export * from './SharedState.js';
+export * from './useClickOutside.js';
+export * from './useCopyToClipboard.js';
+export * from './useDarkMode.js';
+export * from './useDebounce';
+export * from './useEventSource.js';
+export * from './useFetch.js';
+export * from './useFlag.js';
+export * from './useIntersectionObserver.js';
+export * from './useIsFistRendering.js';
+export * from './useSafeLayoutEffect.js';
+export * from './useScrollableSearch.js';
+export * from './useSharedValue.js';
+
+// -----------------------------------------------------------------------------
+// layout/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './AppLayout.js';
+export * from './ErrorPage.js';
+export * from './FullHeightLayout.js';
+export * from './Navbar.js';
+export * from './RegionTag.js';
+export * from './Sidebar.js';
+export * from './SidebarContext.js';
+export * from './TitleBar.js';
+
+// -----------------------------------------------------------------------------
+// layout/FullHeightLayout.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+interface FlexibleHeightLayoutProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function FullHeightLayout({ className, children }: FlexibleHeightLayoutProps): React.JSX.Element;
+export declare namespace FullHeightLayout {
+    var Fixed: ({ heightClass, className, children }: FixedProps) => React.JSX.Element;
+    var Body: ({ className, children }: BodyProps) => React.JSX.Element;
+    var VR: () => React.JSX.Element;
+    var HR: () => React.JSX.Element;
+    var Flex: ({ className, children }: BodyProps) => React.JSX.Element;
+    var Tab: ({ children }: {
+        children: React.ReactNode;
+    }) => React.JSX.Element;
+}
+interface FixedProps {
+    children: React.ReactNode;
+    heightClass: string;
+    className?: string;
+}
+interface BodyProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export {};
+
+// -----------------------------------------------------------------------------
+// layout/Sidebar.d.ts
+// -----------------------------------------------------------------------------
+interface SidebarProps {
+    children: React.ReactNode | React.ReactNode[];
+    logo?: React.ReactNode;
+    className?: string;
+}
+export declare function Sidebar({ children, logo, className }: SidebarProps): import("react").JSX.Element;
+interface SidebarSectionProps {
+    children: React.ReactNode | React.ReactNode[];
+    title?: React.ReactNode;
+    action?: React.ReactNode;
+    isFooter?: boolean;
+    className?: string;
+}
+export declare function SidebarSection({ children, title, action, isFooter, className }: SidebarSectionProps): import("react").JSX.Element;
+export declare function SidebarTooltip({ children, text }: {
+    children: React.ReactNode;
+    text?: string;
+}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | null | undefined;
+export interface SidebarItemIconProps {
+    className?: string;
+    'aria-hidden'?: boolean | 'true' | 'false';
+}
+export interface SidebarItemProps {
+    href: string;
+    to?: string;
+    icon?: React.ComponentType<SidebarItemIconProps>;
+    current?: boolean;
+    onClick?: (event: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => void;
+    children: React.ReactNode | React.ReactNode[];
+    tools?: React.ReactNode;
+    className?: string;
+    id?: string;
+    external?: boolean;
+    replace?: boolean;
+    skipStickyParams?: boolean;
+}
+export declare function SidebarItem({ external, className, tools, children, icon: Icon, href, to, current, onClick, replace, skipStickyParams, }: SidebarItemProps): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// router/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './FixLinks.js';
+export * from './HistoryNavigator.js';
+export * from './Nav.js';
+export * from './NestedNavigationContext.js';
+export * from './NestedRouterProvider.js';
+export * from './PathMatcher.js';
+export * as Path from './path.js';
+export * from './Redirect.js';
+export * from './RouteComponent.js';
+export * from './Router.js';
+export * from './RouterProvider.js';
+
+// -----------------------------------------------------------------------------
+// router/RouterProvider.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+import type { LocationChangeEvent } from './HistoryNavigator';
+import { type Route } from './Router';
+interface RouterProviderProps {
+    routes: Route[];
+    /**
+     * The path to use for the root resource. Defaults to '/'. Cannot contains path variables or wildcards
+     */
+    index?: string;
+    children?: React.ReactNode;
+    onChange?: (event: LocationChangeEvent) => void;
+}
+export declare function RouterProvider({ routes, index, onChange, children }: RouterProviderProps): React.JSX.Element | undefined;
+export {};
+
+// -----------------------------------------------------------------------------
+// router/NestedRouterProvider.d.ts
+// -----------------------------------------------------------------------------
+import type React from 'react';
+import { type Route } from './Router';
+interface RouterProviderProps {
+    routes: Route[];
+    /**
+     * The path to use for the root resource. Defaults to '/'. Cannot contains path variables or wildcards
+     */
+    index?: string;
+    children?: React.ReactNode;
+    fixLinks?: boolean;
+}
+export declare function NestedRouterProvider({ routes, index, children, fixLinks }: RouterProviderProps): React.JSX.Element | null | undefined;
+export {};
+
+// -----------------------------------------------------------------------------
+// router/Nav.d.ts
+// -----------------------------------------------------------------------------
+import type { SyntheticEvent } from 'react';
+/**
+ * Wraps a <a href="..."> and perform the navigation to href through the router.
+ */
+interface NavProps {
+    children: React.ReactNode | React.ReactNode[];
+    /**
+     * Optional router navigation target. If omitted, the wrapped anchor href is used.
+     */
+    to?: string;
+    /**
+     * A click was intercepted
+     * @param ev
+     * @returns
+     */
+    onClick?: (ev: SyntheticEvent) => void;
+    /**
+     * If true, use replaceState instead of pushState (no new browser history entry).
+     * Defaults to true for backward compatibility.
+     */
+    replace?: boolean;
+}
+export declare function Nav({ children, to, onClick, replace }: NavProps): import("react").JSX.Element;
+/**
+ * An anchor that navigates via the router. Internal paths are intercepted and carry the active
+ * tenant sticky params (a/p); external URLs and `_blank` targets fall through to the browser.
+ */
+interface NavLinkProps {
+    children: React.ReactNode | React.ReactNode[];
+    href: string;
+    className?: string;
+    target?: string;
+    /**
+     * use the root router to navigate
+     */
+    topLevelNav?: boolean;
+    clearBreadcrumbs?: boolean;
+    replace?: boolean;
+    skipStickyParams?: boolean;
+}
+export declare function NavLink({ children, href, className, target, topLevelNav, clearBreadcrumbs, replace, skipStickyParams, }: NavLinkProps): import("react").JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// session/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './auth/composable';
+export * from './auth/firebase';
+export * from './auth/useAuthState';
+export * from './auth/useCurrentTenant';
+export * from './DevSessionProvider';
+export * from './UserSession';
+export * from './UserSessionProvider';
+export * from './useUXTracking';
+
+// -----------------------------------------------------------------------------
+// session/UserSession.d.ts
+// -----------------------------------------------------------------------------
+import { VertesiaClient } from '@vertesia/client';
+import type { AuthTokenPayload } from '@vertesia/common';
+import { LastSelectedAccountId_KEY, LastSelectedProjectId_KEY } from './constants';
+export { LastSelectedAccountId_KEY, LastSelectedProjectId_KEY };
+export interface UserSessionLoginOptions {
+    loadOnboardingStatus?: boolean;
+}
+declare class UserSession {
+    isLoading: boolean;
+    client: VertesiaClient;
+    authError?: Error;
+    authToken?: AuthTokenPayload;
+    setSession?: (session: UserSession) => void;
+    lastSelectedAccount?: string | null;
+    lastSelectedProject?: string | null;
+    onboardingComplete?: boolean;
+    constructor(client?: VertesiaClient, setSession?: (session: UserSession) => void);
+    get store(): import("@vertesia/client").ZenoClient;
+    get user(): AuthTokenPayload | undefined;
+    get account(): {
+        id: string;
+        name: string;
+    } | undefined;
+    get project(): {
+        account: string;
+        id: string;
+        name: string;
+        restricted?: boolean | undefined;
+    } | undefined;
+    get accounts(): {
+        id: string;
+        name: string;
+    }[] | undefined;
+    get authCallback(): Promise<string>;
+    get rawAuthToken(): Promise<string>;
+    /**
+     * Force a fresh Vertesia JWT from STS, bypassing the in-memory cache.
+     * Use this when the current token's claims (e.g. `apps`) are suspected
+     * stale — STS recomputes the `apps` claim from ACEs on every issuance.
+     */
+    refreshAuthToken(): Promise<AuthTokenPayload>;
+    signOut(): void;
+    getAccount(): {
+        id: string;
+        name: string;
+    } | undefined;
+    login(token: string, options?: UserSessionLoginOptions): Promise<void>;
+    isLoggedIn(): boolean;
+    logout(): void;
+    switchAccount(targetAccountId: string): Promise<void>;
+    switchProject(targetProjectId: string): Promise<void>;
+    fetchAccounts(): Promise<void>;
+    fetchProjects(accountId: string): Promise<void>;
+    fetchOnboardingStatus(): Promise<boolean>;
+    clone(): UserSession;
+}
+declare const UserSessionContext: import("react").Context<UserSession | undefined>;
+export declare function useUserSession(): UserSession;
+export { UserSession, UserSessionContext };
+
+// -----------------------------------------------------------------------------
+// features/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './activity-doc/index.js';
+export * from './agent';
+export * from './document-viewer/index.js';
+export * from './environment/index.js';
+export * from './errors/index.js';
+export * from './facets/index.js';
+export * from './layout/index.js';
+export * from './magic-pdf/index.js';
+export * from './media-viewer/index.js';
+export * from './oauth/index.js';
+export * from './pdf-viewer/index.js';
+export * from './permissions/index.js';
+export * from './store/index.js';
+export * from './user/index.js';
+export * from './utils/index.js';
+export * from './views/index.js';
+
+// -----------------------------------------------------------------------------
+// features/layout/GenericPageNavHeader.d.ts
+// -----------------------------------------------------------------------------
+import type { JSX, ReactElement, ReactNode } from 'react';
+interface GenericPageNavHeaderProps {
+    title?: string | JSX.Element;
+    description?: string | JSX.Element;
+    actions?: ReactNode | ReactNode[];
+    breadcrumbs?: ReactElement<BreadcrumbElementProps>[];
+    isCompact?: boolean;
+    children?: ReactNode;
+    className?: string;
+    useDynamicBreadcrumbs?: boolean;
+}
+interface BreadcrumbElementProps {
+    href?: string;
+    clearBreadcrumbs?: boolean;
+    children?: ReactNode;
+}
+export declare function GenericPageNavHeader({ className, children, title, description, actions, breadcrumbs, useDynamicBreadcrumbs, }: GenericPageNavHeaderProps): JSX.Element;
+export {};
+
+// -----------------------------------------------------------------------------
+// features/agent/chat/ModernAgentConversation.d.ts
+// -----------------------------------------------------------------------------
+import { type AgentMessage, AgentMessageType, type AgentRun, type AgentToolApprovalMode, type ConversationFile, type Plan } from '@vertesia/common';
+import { type AgentResourceResolver } from '@vertesia/ui/widgets';
+import type React from 'react';
+import type { AgentConversationViewMode, AgentInitialRequestTemplate, AgentInitialRequestTemplateContext } from './ModernAgentOutput/AllMessagesMixed';
+import type { BatchProgressPanelClassNames } from './ModernAgentOutput/BatchProgressPanel';
+import { type SelectedDocument, type UploadedFile } from './ModernAgentOutput/MessageInput';
+import type { MessageItemClassNames } from './ModernAgentOutput/MessageItem';
+import type { StreamingMessageClassNames } from './ModernAgentOutput/StreamingMessage';
+import type { ToolCallGroupClassNames } from './ModernAgentOutput/ToolCallGroup';
+export interface StartWorkflowOptions {
+    tool_approval_mode?: AgentToolApprovalMode;
+}
+/** Controls whether a persisted message is included in the rendered conversation transcript. */
+export type AgentMessageFilter = (message: AgentMessage) => boolean;
+export type StartWorkflowFn = (initialMessage?: string, options?: StartWorkflowOptions) => Promise<{
+    agent_run_id: string;
+} | undefined>;
+export type SendAgentMessageFn = (message: string, inputMetadata?: Record<string, unknown>) => void;
+export interface ModernAgentConversationProps {
+    /** Stable AgentRun ID — the primary identifier for all runtime operations. */
+    agentRunId?: string;
+    /**
+     * Optional override for mapping agent resource references (documents, collections, interactions,
+     * ...) to navigation or activation targets in the chat. This overrides an inherited
+     * AgentResourceResolverProvider; without either, resources remain non-interactive.
+     */
+    resourceResolver?: AgentResourceResolver;
+    title?: string;
+    interactive?: boolean;
+    onClose?: () => void;
+    isModal?: boolean;
+    fullWidth?: boolean;
+    initialMessage?: string;
+    startWorkflow?: StartWorkflowFn;
+    startButtonText?: string;
+    placeholder?: string;
+    hideUserInput?: boolean;
+    resetWorkflow?: () => void;
+    /** Called after a restart succeeds — receives the new AgentRun for navigation */
+    onRestart?: (newRun: AgentRun) => void;
+    /** Called after a clone succeeds — receives the new AgentRun for navigation */
+    onClone?: (newRun: AgentRun) => void;
+    /** Called to show run details/internals modal */
+    onShowDetails?: () => void;
+    /** Whether workflow control actions such as cancel should be shown. */
+    allowWorkflowControl?: boolean;
+    /** Called when files are dropped/pasted/selected */
+    onFilesSelected?: (files: File[]) => void;
+    /** Currently uploaded files to display */
+    uploadedFiles?: UploadedFile[];
+    /** Called when user removes an uploaded file */
+    onRemoveFile?: (fileId: string) => void;
+    /** Accepted file types (e.g., ".pdf,.doc,.png") */
+    acceptedFileTypes?: string;
+    /** Max number of files allowed */
+    maxFiles?: number;
+    /** Ref populated with the internal file upload handler for external triggering */
+    fileUploadRef?: React.MutableRefObject<((files: File[]) => void) | null>;
+    /** Ref populated with the internal message sender for document or artifact collaboration controls. */
+    sendMessageRef?: React.MutableRefObject<SendAgentMessageFn | null>;
+    /** Called for each live message delivered after the conversation stream connects. */
+    onMessage?: (message: AgentMessage) => void;
+    /** Called when the main agent turn starts or reaches an idle/terminal state. */
+    onAgentWorkingChange?: (isWorking: boolean) => void;
+    /** Called when processingFiles state changes (for external progress display) */
+    onProcessingFilesChange?: (files: Map<string, ConversationFile>) => void;
+    /** Processing files to display in the right panel Uploads tab */
+    processingFiles?: Map<string, ConversationFile>;
+    /** Called when plans change (for external plan panel) */
+    onPlansChange?: (plans: Array<{
+        plan: Plan;
+        timestamp: number;
+    }>, activePlanIndex: number) => void;
+    /** Called when workstream status changes (for external plan panel) */
+    onWorkstreamStatusChange?: (statusMap: Map<number, Map<string, 'pending' | 'in_progress' | 'completed' | 'skipped'>>) => void;
+    /** Controlled view mode — when provided, overrides internal state */
+    viewMode?: AgentConversationViewMode;
+    /** Called when view mode changes (for external control) */
+    onViewModeChange?: (mode: AgentConversationViewMode) => void;
+    /** Called when follow-up input availability is determined (after messages load) */
+    onShowInputChange?: (canSendFollowUp: boolean) => void;
+    /** Ref populated with the stop handler — call to interrupt the active agent. null when stop unavailable. */
+    stopRef?: React.MutableRefObject<(() => void) | null>;
+    /** Called when the stopping (in-progress) state changes */
+    onStoppingChange?: (isStopping: boolean) => void;
+    /** Render custom document search UI - if provided, shows search button */
+    renderDocumentSearch?: (props: {
+        isOpen: boolean;
+        onClose: () => void;
+        onSelect: (doc: SelectedDocument) => void;
+    }) => React.ReactNode;
+    /** Currently selected documents from search */
+    selectedDocuments?: SelectedDocument[];
+    /** Called when user removes a selected document */
+    onRemoveDocument?: (docId: string) => void;
+    hideObjectLinking?: boolean;
+    /** Hide the internal header (for apps that render their own) */
+    hideHeader?: boolean;
+    /** Header density. Use compact when the surrounding page already identifies the run. */
+    headerVariant?: 'full' | 'compact';
+    /** Start-screen layout. Compact removes empty history; expanded-composer gives that space to the first input. */
+    startViewVariant?: 'default' | 'compact' | 'expanded-composer';
+    /** Hide the internal message input (for apps that render their own) */
+    hideMessageInput?: boolean;
+    /** Custom action shown in place of the input box when the run status is FAILED.
+     *  When omitted, the default "This Workflow is FAILED" message box is shown. */
+    failedAction?: React.ReactNode;
+    /** Hide the internal plan panel (for apps that render their own) */
+    hidePlanPanel?: boolean;
+    /** Hide workstream tabs */
+    hideWorkstreamTabs?: boolean;
+    /** Enable or disable the internal right panel (plan/workstreams/documents/uploads) */
+    showRightPanel?: boolean;
+    /** Hide the default file upload */
+    hideFileUpload?: boolean;
+    /** Show the Artifacts tab in the right panel (default false) */
+    showArtifacts?: boolean;
+    /** Hide the document preview panel that auto-opens on create_document */
+    hideDocumentPanel?: boolean;
+    /** Message types to exclude from the conversation view */
+    hiddenMessageTypes?: AgentMessageType[];
+    /**
+     * Optional presentation-only predicate for transcript messages. Returning false hides the message without
+     * changing the underlying conversation stream, workflow state, plans, or pending input.
+     */
+    messageFilter?: AgentMessageFilter;
+    getAttachedDocs?: () => SelectedDocument[];
+    onAttachmentsSent?: () => void;
+    isUploading?: boolean;
+    getMessageContext?: () => Record<string, unknown> | undefined;
+    /** Additional className for the MessageInput container */
+    inputContainerClassName?: string;
+    /** Additional className for the input field */
+    inputClassName?: string;
+    /** Read-only context rendered immediately above the live conversation composer. */
+    composerContext?: React.ReactNode;
+    /** Additional className for the root container */
+    className?: string;
+    messageItemClassNames?: MessageItemClassNames;
+    /** Sparse MESSAGE_STYLES overrides passed to every MessageItem */
+    messageStyleOverrides?: import('./ModernAgentOutput/MessageItem').MessageItemProps['messageStyleOverrides'];
+    toolCallGroupClassNames?: ToolCallGroupClassNames;
+    /** Hide ToolCallGroup in this view mode */
+    hideToolCallsInViewMode?: AgentConversationViewMode[];
+    streamingMessageClassNames?: StreamingMessageClassNames;
+    batchProgressPanelClassNames?: BatchProgressPanelClassNames;
+    /** className override for the working indicator container */
+    workingIndicatorClassName?: string;
+    /** className override for the message list container */
+    messageListClassName?: string;
+    /** Custom component to render store/document links instead of default NavLink navigation */
+    StoreLinkComponent?: React.ComponentType<{
+        href: string;
+        documentId: string;
+        children: React.ReactNode;
+    }>;
+    /** Custom component to render store/collection links instead of default NavLink navigation */
+    CollectionLinkComponent?: React.ComponentType<{
+        href: string;
+        collectionId: string;
+        children: React.ReactNode;
+    }>;
+    /** Optional message to display as the first user message in the conversation.
+     *  Purely visual/UI — not sent to temporal. Renders as a QUESTION MessageItem before real messages. */
+    prependFriendlyMessage?: string;
+    /** Optional structured request data to render as the first user entry in the conversation. */
+    initialRequestData?: unknown;
+    /** Optional schema used by the default request renderer. */
+    initialRequestSchema?: AgentInitialRequestTemplateContext['schema'];
+    /** Optional label/title for the default structured request renderer. */
+    initialRequestTitle?: string;
+    /** Optional agent-specific request renderer for arbitrary input schemas. */
+    initialRequestTemplate?: AgentInitialRequestTemplate;
+    /**
+     * Data to provide to fusion-fragment code blocks for rendering.
+     * When provided, fusion-fragments in agent responses will display
+     * this data according to their template structure.
+     * @example { fundName: "Tech Growth IV", vintage: 2024, totalCommitments: 500000000 }
+     */
+    fusionData?: Record<string, unknown>;
+    /** Optional payload content to show as a "Payload" tab in the right panel */
+    payloadContent?: React.ReactNode;
+    /** Optional conversation content to show as a "Conversation" tab in the right panel */
+    conversationContent?: React.ReactNode;
+    /** When true, renders the conversation inside the right panel as a "Conversation" tab */
+    conversationTab?: boolean;
+    /** Internal optimistic first message shown while a newly-started run is waiting for persisted messages. */
+    pendingStartMessage?: string;
+    /** Timestamp for the internal optimistic first-message waiting state. */
+    pendingStartTimestamp?: number;
+    /**
+     * Initial approval mode: seeds the start screen for a new interactive run, and is shown
+     * while an existing run's metadata loads. Defaults to `full_control`.
+     */
+    initialToolApprovalMode?: AgentToolApprovalMode;
+    /** Force display playback controls on or off. When omitted, local playback can be toggled from the header. */
+    enablePlayback?: boolean;
+    /** Show the Debug button for local playback controls. Defaults to true; set to false to hide it. */
+    showPlaybackToggle?: boolean;
+}
+export declare function ModernAgentConversation(props: ModernAgentConversationProps): React.JSX.Element;
+
+// -----------------------------------------------------------------------------
+// features/store/objects/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './components';
+export * from './DocumentPreviewPanel';
+export * from './DocumentSearchResults';
+export * from './DocumentSelectionProvider';
+export * from './DocumentTable';
+export * from './ExportPropertiesModal';
+export * from './layout';
+export * from './search';
+export * from './selection';
+export * from './upload';
+
+// -----------------------------------------------------------------------------
+// features/store/objects/search/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './DocumentSearchContext';
+export * from './DocumentSearchProvider';
+
+// -----------------------------------------------------------------------------
+// features/store/objects/components/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './ContentDispositionButton';
+export * from './ContentOverview';
+export * from './DocumentEditingPanel';
+export * from './DocumentIcon';
+export * from './DocumentInput';
+export * from './PropertiesEditorModal';
+export * from './SaveVersionConfirmModal';
+export * from './SelectDocument';
+export * from './SelectDocumentModal';
+export * from './useDownloadFile';
+
+// -----------------------------------------------------------------------------
+// features/store/collections/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './BrowseCollectionView';
+export * from './CollectionsTable';
+export * from './CreateCollection';
+export * from './EditCollectionView';
+export * from './SelectCollection';
+export * from './SharedPropsEditor';
+export * from './SyncMemberHeadsToggle';
+
+// -----------------------------------------------------------------------------
+// widgets/index.d.ts
+// -----------------------------------------------------------------------------
+export * from './form/index.js';
+export * from './json-view/index.js';
+export * from './markdown/index.js';
+export * from './monacoEditor/index.js';
+export * from './Progress.js';
+export * from './properties/index.js';
+export * from './SvgIcon.js';
+export * from './schema-editor/index.js';
+export * from './upload/index.js';
+export * from './xml-viewer/index.js';
+