react-os-shell 3.10.0 → 3.11.1

package/dist/index.d.ts

@@ -1512,6 +1512,9 @@ interface FormFieldProps {
     label?: ReactNode;
     /** id of the control, for label-for wiring. */
     htmlFor?: string;
+    /** id for the `<label>` element itself, so a non-labelable control (e.g. a
+     *  `role="group"` wrapper) can name itself via `aria-labelledby`. */
+    labelId?: string;
     /** Greyed helper text below the control. */
     hint?: ReactNode;
     /** Red error text below the control — overrides `hint` when present. */
@@ -1521,7 +1524,7 @@ interface FormFieldProps {
     className?: string;
     children: ReactNode;
 }
-declare function FormField({ label, htmlFor, hint, error, required, className, children, }: FormFieldProps): react_jsx_runtime.JSX.Element;
+declare function FormField({ label, htmlFor, labelId, hint, error, required, className, children, }: FormFieldProps): react_jsx_runtime.JSX.Element;
 
 interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
     /** Append a red asterisk. */
@@ -1529,6 +1532,139 @@ interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
 }
 declare function Label({ required, children, className, ...rest }: LabelProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Internal helpers shared by the media-upload primitives (`MediaUploadField`
+ * single slot + `MediaUploadGrid` gallery) so the filename derivation, the
+ * image-vs-video test, and the upload glyph / spinner live in one place (DRY /
+ * SSoT). Not part of the public API except `mediaFileName`, which the field
+ * re-exports.
+ */
+/**
+ * Derive a human filename from a media URL: drop the query string, strip a
+ * 32-hex upload prefix, and URL-decode.
+ *
+ *   "/media/uploads/9f3…a1_My Clip.mp4?v=2"  →  "My Clip.mp4"
+ */
+declare function mediaFileName(url: string): string;
+
+interface MediaUploadFieldProps {
+    /** The current media URL. Empty string (or null/undefined) = the CTA state. */
+    value?: string | null;
+    /** Controlled channel — the newly-chosen URL, or `''` when cleared (Remove). */
+    onChange: (url: string) => void;
+    /**
+     * Open the consumer's library/upload picker. Fires on click and on drop; the
+     * dropped File (if any) is passed so the consumer can seed an immediate
+     * upload. The consumer resolves the selection back through `onChange`.
+     * Omit to fall back to a hidden native `<input type=file>` that emits an
+     * object-URL (demos, staged-then-submit forms).
+     */
+    onPick?: (droppedFile?: File) => void;
+    /** Label rendered above the control. */
+    label?: ReactNode;
+    /** Greyed helper line below the control. */
+    hint?: ReactNode;
+    /** Red error line — overrides `hint`. */
+    error?: ReactNode;
+    /** Append a red asterisk to the label. */
+    required?: boolean;
+    className?: string;
+    /**
+     * Native `accept` string. Drives the preview kind (image vs video), the
+     * fallback file dialog, and the default empty-state copy. Default `image/*`.
+     */
+    accept?: string;
+    /** `object-fit` for the preview. Default `cover`; use `contain` for logos/SVG. */
+    fit?: 'cover' | 'contain';
+    /** Preview / dropzone height in px (applied via inline style). Default 112. */
+    height?: number;
+    /** Dim prompt line, e.g. "Upload a background video". Default derived from `accept`. */
+    placeholder?: ReactNode;
+    /** The link-style CTA line. Default "Choose from library or upload". */
+    cta?: ReactNode;
+    /** Small kind hint under the CTA, e.g. "PNG · JPG · WEBP". */
+    acceptHint?: ReactNode;
+    /** Overlay the derived filename on the preview. Default true. */
+    showFilename?: boolean;
+    /** Show the Replace button when filled. Default true. */
+    allowReplace?: boolean;
+    /** Show the Remove button when filled. Default true. */
+    allowRemove?: boolean;
+    /** Relabel Replace, e.g. "Change". Default "Replace". */
+    replaceLabel?: ReactNode;
+    /** Relabel Remove, e.g. "Clear". Default "Remove". */
+    removeLabel?: ReactNode;
+    /** Busy: disable controls and show a spinner while the caller's upload runs. */
+    busy?: boolean;
+    /** Busy label. Default "Uploading…". */
+    busyLabel?: ReactNode;
+    /** Fully disable the control (no click, no drop, no actions). */
+    disabled?: boolean;
+}
+
+declare function MediaUploadField({ value, onChange, onPick, label, hint, error, required, className, accept, fit, height, placeholder, cta, acceptHint, showFilename, allowReplace, allowRemove, replaceLabel, removeLabel, busy, busyLabel, disabled, }: MediaUploadFieldProps): react_jsx_runtime.JSX.Element;
+
+interface MediaUploadGridItem {
+    /** Stable key — used for React keys, remove, and reorder. */
+    id: string;
+    /** Preview URL. */
+    url: string;
+    /** `image` | `video`. Inferred from the URL when omitted. */
+    kind?: 'image' | 'video';
+    /** Optional label overlaid on the thumbnail (filename, dimensions, …). */
+    caption?: ReactNode;
+    /** Force the "cover" badge on this item (else `showCover` badges the first). */
+    cover?: boolean;
+}
+interface MediaUploadGridProps {
+    /** The gallery contents, in display order. */
+    items: MediaUploadGridItem[];
+    /**
+     * Open the consumer's library/upload flow. Fires on click of the Add tile /
+     * empty dropzone and on a file drop onto the zone (the dropped File is passed
+     * so the consumer can seed an immediate upload). Without it the gallery is
+     * read-only for additions (no Add tile, no drop).
+     */
+    onPick?: (droppedFile?: File) => void;
+    /** Remove one item. The per-thumb ✕ shows only when this is provided. */
+    onRemove?: (id: string) => void;
+    /**
+     * Reorder within the grid. Enables drag-to-reorder when provided; called with
+     * the source and target indices on drop.
+     */
+    onReorder?: (fromIndex: number, toIndex: number) => void;
+    label?: ReactNode;
+    hint?: ReactNode;
+    error?: ReactNode;
+    required?: boolean;
+    className?: string;
+    /** Native accept string — drives preview kind, the drop filter, and the copy. Default `image/*`. */
+    accept?: string;
+    /** `object-fit` for the thumbnails. Default `cover`. */
+    fit?: 'cover' | 'contain';
+    /** Thumbnail (and Add tile) square size in px. Default 96. */
+    thumbSize?: number;
+    /** Dim prompt line on the empty dropzone. Default derived from `accept`. */
+    placeholder?: ReactNode;
+    /** The link CTA on the empty dropzone. Default "Choose from library or upload". */
+    cta?: ReactNode;
+    /** Small kind hint under the CTA, e.g. "PNG · JPG · WEBP". */
+    acceptHint?: ReactNode;
+    /** Badge the first item (or the one with `cover`) as the gallery cover. Default false. */
+    showCover?: boolean;
+    /** Cover badge text. Default "Cover". */
+    coverLabel?: ReactNode;
+    /** Busy: dim the zone and show a spinner while the caller's upload runs. */
+    busy?: boolean;
+    /** Busy label. Default "Uploading…". */
+    busyLabel?: ReactNode;
+    /** Disable all interaction. */
+    disabled?: boolean;
+    /** View only — thumbnails without Add / remove / reorder affordances. */
+    readOnly?: boolean;
+}
+declare function MediaUploadGrid({ items, onPick, onRemove, onReorder, label, hint, error, required, className, accept, fit, thumbSize, placeholder, cta, acceptHint, showCover, coverLabel, busy, busyLabel, disabled, readOnly, }: MediaUploadGridProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Shared form-control styling — the single source of truth for the kit's
  * text-input look. Promoted out of SearchableSelect so every form control
@@ -2345,4 +2481,4 @@ declare function useNewHotkey(callback: () => void): void;
  */
 declare function useEditHotkey(callback: (() => void) | null): void;
 
-export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, type AccordionItem, type AccordionProps, AuthScreen, type AuthScreenProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Banner, type BannerProps, type BannerTone, BarChart, type BarChartProps, BehaviorPanel, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type BulkColumn, type BulkColumnKind, BulkImportGrid, type BulkImportGridProps, type BulkRow, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, Card, type CardProps, type CellStyle, ChangePasswordForm, type ChangePasswordFormProps, type ChangelogEntry, ChatTemplate, Checkbox, type CheckboxProps, CheckoutTemplate, type ClockCalendarConfig, ColoredBadge, type ColoredBadgeProps, type ColumnDef, ConfirmProvider, ContainerFillChart, type ContainerFillChartProps, type ContainerFillItem, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, type CustomizationSection, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, type DesktopContextMenuItem, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, DonutChart, type DonutChartProps, type DonutSegment, type DuplicateGroup, ENTER, EditableGrid, type EditableGridProps, EmailTemplate, EmptyState, type EmptyStateProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListProps, ErrorPage, type ErrorPageProps, FilterBar, type FilterOption, FormField, type FormFieldProps, FormLayoutPage, GLASS_DIVIDER, GLASS_INPUT_BG, GalleryTemplate, GlobalSearch, type GridColumn, type HealthCheckResult, HelpCenter, type HelpCenterDoc, type HelpCenterProps, INPUT_BASE, ImageAnnotator, type ImageAnnotatorHandle, type ImageAnnotatorProps, Input, type InputProps, Kanban, type KanbanColumn, type KanbanProps, Label, type LabelProps, Layout, type LayoutProps, ListFooter, LoadingSpinner, type LoadingSpinnerProps, MOD, Markdown, type MarkdownProps, type MergeBulkOptions, type MergeBulkResult, type Milestone, type MilestoneKind, MilestoneTimeline, type MilestoneTimelineProps, Modal, ModalActions, NotificationBell, type NotificationsConfig, PageHeader, type PageHeaderProps, type PaginatedResponse, Pagination, type PaginationProps, PdfActionButton, type PdfActionButtonProps, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, Radio, type RadioProps, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SearchableOption, SearchableSelect, type SearchableSelectProps, Select, type SelectOption, type SelectProps, type SemanticGroup, ServerStatusIndicator, type ServerStatusIndicatorProps, type ServerStatusUser, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarActionButton, type SidebarActionButtonProps, SidebarGroupLabel, SidebarLayout, type SidebarLayoutProps, SidebarNavItem, type SortState, SoundsPanel, Sparkline, type SparklineProps, StartMenu, StatCard, type StatCardProps, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, type TodoProvider, type TodoTask, Tooltip, type TooltipProps, TopNav, type TopNavItem, type TopNavProps, VERSION, WidgetManager, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, findDuplicateKeys, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, inputClasses, isDevEnv, isMac, mergeBulkItems, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toast, toggleExposeMode, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, Accordion, type AccordionItem, type AccordionProps, AuthScreen, type AuthScreenProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Banner, type BannerProps, type BannerTone, BarChart, type BarChartProps, BehaviorPanel, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type BulkColumn, type BulkColumnKind, BulkImportGrid, type BulkImportGridProps, type BulkRow, Button, type ButtonProps, type ButtonSize, type ButtonVariant, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, Card, type CardProps, type CellStyle, ChangePasswordForm, type ChangePasswordFormProps, type ChangelogEntry, ChatTemplate, Checkbox, type CheckboxProps, CheckoutTemplate, type ClockCalendarConfig, ColoredBadge, type ColoredBadgeProps, type ColumnDef, ConfirmProvider, ContainerFillChart, type ContainerFillChartProps, type ContainerFillItem, CopyButton, Customization, type CustomizationOmitSection, type CustomizationProps, type CustomizationSection, DEV_BANNER_TEXT, DashboardTemplate, DataTablePage, Desktop, type DesktopContextMenuItem, type DesktopHostConfig, DesktopHostProvider, DevIndicator, DocFavStar, DonutChart, type DonutChartProps, type DonutSegment, type DuplicateGroup, ENTER, EditableGrid, type EditableGridProps, EmailTemplate, EmptyState, type EmptyStateProps, type EntityFetcher, EntityList, type EntityListColumn, type EntityListProps, ErrorPage, type ErrorPageProps, FilterBar, type FilterOption, FormField, type FormFieldProps, FormLayoutPage, GLASS_DIVIDER, GLASS_INPUT_BG, GalleryTemplate, GlobalSearch, type GridColumn, type HealthCheckResult, HelpCenter, type HelpCenterDoc, type HelpCenterProps, INPUT_BASE, ImageAnnotator, type ImageAnnotatorHandle, type ImageAnnotatorProps, Input, type InputProps, Kanban, type KanbanColumn, type KanbanProps, Label, type LabelProps, Layout, type LayoutProps, ListFooter, LoadingSpinner, type LoadingSpinnerProps, MOD, Markdown, type MarkdownProps, MediaUploadField, type MediaUploadFieldProps, MediaUploadGrid, type MediaUploadGridItem, type MediaUploadGridProps, type MergeBulkOptions, type MergeBulkResult, type Milestone, type MilestoneKind, MilestoneTimeline, type MilestoneTimelineProps, Modal, ModalActions, NotificationBell, type NotificationsConfig, PageHeader, type PageHeaderProps, type PaginatedResponse, Pagination, type PaginationProps, PdfActionButton, type PdfActionButtonProps, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, Radio, type RadioProps, ResizableTable, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SearchableOption, SearchableSelect, type SearchableSelectProps, Select, type SelectOption, type SelectProps, type SemanticGroup, ServerStatusIndicator, type ServerStatusIndicatorProps, type ServerStatusUser, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, SidebarActionButton, type SidebarActionButtonProps, SidebarGroupLabel, SidebarLayout, type SidebarLayoutProps, SidebarNavItem, type SortState, SoundsPanel, Sparkline, type SparklineProps, StartMenu, StatCard, type StatCardProps, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, SystemPreferences, type SystemPreferencesProps, type SystemPreferencesSection, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, type TodoProvider, type TodoTask, Tooltip, type TooltipProps, TopNav, type TopNavItem, type TopNavProps, VERSION, WidgetManager, WindowCrashedFallback, WindowErrorBoundary, WindowManagerProvider, WindowRegistry, WindowTitle, applyDevTitle, commitExposeHighlight, confirm, confirmDestructive, createWindowRegistry, exitExposeMode, findDuplicateKeys, formatDate, getActiveWindowRoute, getExposeHighlight, getWindowPosition, glassStyle, inputClasses, isDevEnv, isMac, mediaFileName, mergeBulkItems, prompt, registerModalEscapeInterceptor, setExposeHighlight, setShellApiClient, setShellAuthBridge, setShellNavIcons, setShellTodoProvider, setWindowDefaultPosition, setWindowPosition, subscribeExposeHighlight, toast, toggleExposeMode, useClickOutside, useColumnConfig, useDesktopHost, useEditHotkey, useFilters, useInfiniteScroll, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useSort, useTableNav, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };