@nxgt/material 2.4.2 → 2.6.0

package/dist/lib/components/ui/dates/date-range-field/use-date-range-presets.d.ts

@@ -0,0 +1,22 @@
+import { DateRangePresetOption, DateRangeRules, DayRange, PartialDayRange } from '@nxgt/material-core/date-range';
+/** One entry of the preset list, resolved for this render. */
+export type DateRangePresetItem = {
+    key: string;
+    label: string;
+    range: DayRange;
+    /** Its range starts before `minDate`, ends after `maxDate`, or on a disabled day. */
+    disabled: boolean;
+    /** The field's value covers the same days. */
+    active: boolean;
+};
+/**
+ * The presets a `DateRangeField` lists, each with its range at this render,
+ * its label in the provider's language, and its state against the field's
+ * rules and value.
+ */
+export declare function useDateRangePresets({ presets, value, rules, withTime, }: {
+    presets?: readonly DateRangePresetOption[];
+    value?: PartialDayRange;
+    rules: DateRangeRules;
+    withTime?: boolean;
+}): DateRangePresetItem[];

package/dist/lib/components/ui/dates/time-picker/time-picker-utils.d.ts

@@ -1,3 +1,10 @@
 export declare function parseHours(value: string, period: 'AM' | 'PM'): number;
 export declare function parseMinutes(value?: string): number;
 export declare function formatValue(value: number): string;
+/** The half of the day `date` is in. */
+export declare function periodOf(date: Date): 'AM' | 'PM';
+/**
+ * `date` moved into `period`'s half of the day, at the same hour on the
+ * 12-hour clock; a date already in it is returned unchanged (as a copy).
+ */
+export declare function withPeriod(date: Date, period: 'AM' | 'PM'): Date;

package/dist/lib/components/ui/display/chip/chip.d.ts

@@ -7,5 +7,5 @@ export type ChipProps = {
     label: ReactNode;
     active?: boolean;
     onDismiss?: () => void;
-} & Omit<ButtonProps, 'children' | 'type'>;
+} & Omit<ButtonProps, 'children' | 'type' | 'size'>;
 export declare function Chip({ label, leading, trailing, avatar, className, active, variant, onDismiss, disabled, color, onClick, ...props }: ChipProps): import("react").JSX.Element;

package/dist/lib/components/ui/feedback/toast/toast.d.ts

@@ -1,15 +1,20 @@
 import { ReactNode } from 'react';
 import { ExternalToast, toast as sonnerToast, Toaster } from 'sonner';
+/**
+ * A toast's action: a labelled button that runs `onClick` and dismisses the
+ * toast, or a render function given `dismiss` for anything else.
+ */
+export type ToastAction = {
+    label: ReactNode;
+    onClick?: () => void;
+} | ((dismiss: () => void) => ReactNode);
 export type ToastProps = {
     id: string | number;
     title?: ReactNode;
     description?: ReactNode;
     icon?: ReactNode;
     className?: string;
-    action?: {
-        label: ReactNode;
-        onClick?: () => void;
-    } | ((dismiss: () => void) => ReactNode);
+    action?: ToastAction;
 };
 export type ToastMethodProps = Omit<ToastProps, 'id'> & {
     options?: ExternalToast;

package/dist/lib/components/ui/fields/number-field/number-field.d.ts

@@ -20,5 +20,7 @@ export type NumberFieldProps = {
     suffix?: ReactNode;
     /** Names the input when it has no `label` of its own (a part of a larger field). */
     'aria-label'?: string;
+    /** Names the input by another element's id (a part of a larger field). */
+    'aria-labelledby'?: string;
 };
-export declare function NumberField({ label, helperText, error, required, disabled, className, name, id, placeholder, value, defaultValue, onChange, onBlur, min, max, step, hideSteppers, suffix, 'aria-label': ariaLabel, }: NumberFieldProps): import("react").JSX.Element;
+export declare function NumberField({ label, helperText, error, required, disabled, className, name, id, placeholder, value, defaultValue, onChange, onBlur, min, max, step, hideSteppers, suffix, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, }: NumberFieldProps): import("react").JSX.Element;

package/dist/lib/components/ui/fields/otp-field/index.d.ts

@@ -1,2 +1,3 @@
+export * from './input-otp';
 export * from './otp-field';
 export * from './otp-form-field';

package/dist/lib/components/ui/fields/otp-field/input-otp.d.ts

@@ -7,5 +7,5 @@ declare function InputOTPGroup({ className, ...props }: React.ComponentProps<'di
 declare function InputOTPSlot({ index, className, ...props }: React.ComponentProps<'div'> & {
     index: number;
 }): React.JSX.Element;
-declare function InputOTPSeparator({ ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function InputOTPSeparator({ children, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
 export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot };

package/dist/lib/components/ui/fields/slider/slider-header.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+export type SliderHeaderProps = {
+    label?: ReactNode;
+    labelId: string;
+    required?: boolean;
+    showReadout: boolean;
+    values: number[];
+    min: number;
+    max: number;
+    step: number;
+    disabled?: boolean;
+    /** The Slider's own name: it names a single value's readout as it names the thumbs. */
+    ariaLabel?: string;
+    /** As `ariaLabel`, and wins over it, as on the thumbs (`sliderThumbNames`). */
+    ariaLabelledBy?: string;
+    onChange: (values: number[]) => void;
+};
+/** The Label and the value (editable inputs, or text) above the track. */
+export declare function SliderHeader({ label, labelId, required, showReadout, values, min, max, step, disabled, ariaLabel, ariaLabelledBy, onChange, }: SliderHeaderProps): import("react").JSX.Element | null;

package/dist/lib/components/ui/fields/slider/slider-readout.d.ts

@@ -4,6 +4,10 @@ export type SliderReadoutProps = {
     max: number;
     step?: number;
     disabled?: boolean;
+    /** What names a single value's input: an element's id (the field's Label)… */
+    labelledBy?: string;
+    /** …else this name, else "Value". */
+    label?: string;
     onChange: (values: number[]) => void;
 };
-export declare function SliderReadout({ values, min, max, step, disabled, onChange, }: SliderReadoutProps): import("react").JSX.Element;
+export declare function SliderReadout({ values, min, max, step, disabled, labelledBy, label, onChange, }: SliderReadoutProps): import("react").JSX.Element;

package/dist/lib/components/ui/fields/slider/slider.d.ts

@@ -11,3 +11,10 @@ export type SliderProps = {
     showReadout?: boolean;
 } & Omit<ComponentProps<typeof SliderControl>, 'hiddenLabel' | 'labelId'>;
 export declare function Slider({ leading, trailing, label, helperText, error, required, ticks, showReadout, value, defaultValue, onValueChange, min, max, step, orientation, disabled, className, ref, ...props }: SliderProps): import("react").JSX.Element;
+/**
+ * The labelled `Slider` under `@nxgt/material-vue`'s name, so code reads the
+ * same in both libraries. Same component, same props. The names align fully
+ * in 3.0; `Slider` is not deprecated.
+ */
+export declare const SliderField: typeof Slider;
+export type SliderFieldProps = SliderProps;

package/dist/lib/components/ui/fields/switch/switch.d.ts

@@ -7,3 +7,10 @@ export type SwitchProps = {
     placeholder?: ReactNode;
 } & ComponentProps<typeof SwitchPrimitive.Root>;
 export declare function Switch({ error, helperText, label, placeholder, className, ...props }: SwitchProps): import("react").JSX.Element;
+/**
+ * The labelled `Switch` under `@nxgt/material-vue`'s name, so code reads the
+ * same in both libraries. Same component, same props. The names align fully
+ * in 3.0; `Switch` is not deprecated.
+ */
+export declare const SwitchField: typeof Switch;
+export type SwitchFieldProps = SwitchProps;

package/dist/lib/components/ui/layout/stepper/stepper-step.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { StepperState } from './step-state';
+export type StepperStepProps = {
+    id: string;
+    index: number;
+    state: StepperState;
+    current: boolean;
+    hidden: boolean;
+    icon?: ReactNode;
+    label: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    name?: string;
+    onSelect?: () => void;
+};
+/** One `<li>` of a `Stepper`. Internal: not exported from the barrel. */
+export declare function StepperStep({ id, index, state, current, hidden, icon, label, title, description, name, onSelect, }: StepperStepProps): import("react").JSX.Element;

package/dist/lib/components/ui/media/camera/camera-content.d.ts

@@ -1,3 +1,2 @@
-import { ComponentProps } from 'react';
-export type CameraProps = {} & ComponentProps<'div'>;
+import { CameraProps } from './types';
 export declare function CameraContent({ className, ...props }: CameraProps): import("react").JSX.Element;

package/dist/lib/components/ui/media/camera/camera-context.d.ts

@@ -0,0 +1,4 @@
+import { CameraContextValue } from './types';
+export declare const CameraContext: import('react').Context<CameraContextValue | null>;
+/** The camera's refs, state and actions; throws outside `<Camera>`. */
+export declare function useCameraContext(): CameraContextValue;

package/dist/lib/components/ui/media/camera/camera-provider.d.ts

@@ -0,0 +1,2 @@
+import { PropsWithChildren } from 'react';
+export declare function CameraProvider({ children }: PropsWithChildren): import("react").JSX.Element;

package/dist/lib/components/ui/media/camera/camera.d.ts

@@ -1,3 +1,6 @@
-import { ComponentProps } from 'react';
-export type CameraProps = {} & ComponentProps<'div'>;
-export declare function Camera({ ...props }: CameraProps): import("react").JSX.Element;
+/**
+ * Webcam preview with a start / stop toggle and a still capture. It renders
+ * in the browser only, after mount (`getUserMedia` has no server side), as
+ * in `@nxgt/material-vue`.
+ */
+export declare const Camera: import('react').ComponentType<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;

package/dist/lib/components/ui/media/camera/capture-photo.d.ts

@@ -0,0 +1,13 @@
+import { CameraAlert, CameraState } from './types';
+export type CapturePhotoResult = {
+    capturedImage?: string;
+    alert?: CameraAlert;
+    isProcessing: boolean;
+};
+/**
+ * Draws the current frame of `video` onto a canvas sized by
+ * `captureSettings`, mirrored when asked, and returns it as a data URL.
+ * `null` when there is nothing to capture: not streaming, no video, or no
+ * `document` (on the server).
+ */
+export declare function capturePhotoFromVideo(video: HTMLVideoElement | null, state: Pick<CameraState, 'isStreaming' | 'captureSettings'>): CapturePhotoResult | null;

package/dist/lib/components/ui/media/camera/index.d.ts

@@ -1 +1,9 @@
-export {};
+export { Camera } from './camera';
+export { useCameraContext } from './camera-context';
+export type { CapturePhotoResult } from './capture-photo';
+export { capturePhotoFromVideo } from './capture-photo';
+export type { CameraStore } from './state/camera.store';
+export { createCameraStore } from './state/camera.store';
+export type { CameraActions, CameraAlert, CameraContextValue, CameraDeviceInfo, CameraProps, CameraState, CaptureSettings, ImageFormat, } from './types';
+export { useCamera } from './use-camera';
+export { getCameraDevices, isCameraSupported, requestCameraPermissions, } from './utils/camera.utils';

package/dist/lib/components/ui/media/camera/state/camera.reducers.d.ts

@@ -1,5 +1,5 @@
 import { CameraReducerCreators } from './camera.slice';
-export declare const createCapturePhotoReducer: (create: CameraReducerCreators) => import('@reduxjs/toolkit').CaseReducer<import('../types').CameraState, {
+export declare const createCapturePhotoReducer: (create: CameraReducerCreators) => import('@reduxjs/toolkit').CaseReducer<import('..').CameraState, {
     payload: HTMLVideoElement | null;
     type: string;
 }> & {

package/dist/lib/components/ui/media/camera/state/camera.slice.d.ts

@@ -1,8 +1,8 @@
 import { ReducerCreators } from '@reduxjs/toolkit';
-import { CameraAlert, CameraState } from '../types';
+import { CameraAlert, CameraDeviceInfo, CameraState } from '../types';
 export declare const cameraSlice: import('@reduxjs/toolkit').Slice<CameraState, {
     readonly setDevices: import('@reduxjs/toolkit').CaseReducer<CameraState, {
-        payload: MediaDeviceInfo[];
+        payload: CameraDeviceInfo[];
         type: string;
     }> & {
         _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
@@ -49,7 +49,7 @@ export declare const cameraSlice: import('@reduxjs/toolkit').Slice<CameraState,
         cameraSupported: false;
     } | {
         hasPermission: boolean;
-        devices: import('../types').CameraDeviceInfo[];
+        devices: CameraDeviceInfo[];
         cameraSupported: true;
     }, {
         rejectValue: {
@@ -84,7 +84,7 @@ export declare const cameraSlice: import('@reduxjs/toolkit').Slice<CameraState,
             cameraSupported: false;
         } | {
             hasPermission: boolean;
-            devices: import('../types').CameraDeviceInfo[];
+            devices: CameraDeviceInfo[];
             cameraSupported: true;
         }, void, {
             rejectValue: {
@@ -140,9 +140,4 @@ export declare const cameraSlice: import('@reduxjs/toolkit').Slice<CameraState,
         }>;
     };
 }, "camera", "camera", import('@reduxjs/toolkit').SliceSelectors<CameraState>>;
-type CameraSliceActions = typeof cameraSlice.actions;
-export type CameraActions = {
-    [K in keyof CameraSliceActions]: (...args: Parameters<CameraSliceActions[K]>) => void;
-};
 export type CameraReducerCreators = ReducerCreators<CameraState>;
-export {};

package/dist/lib/components/ui/media/camera/state/camera.store.d.ts

@@ -1,10 +1,16 @@
 import { CameraState } from '../types';
-export declare const store: import('@reduxjs/toolkit').EnhancedStore<CameraState, import('redux').UnknownAction, import('@reduxjs/toolkit').Tuple<[import('redux').StoreEnhancer<{
+/**
+ * A store for one `Camera`. Each instance creates its own, never a module
+ * singleton: two cameras on a page, or two requests on a server, would
+ * otherwise share one state.
+ */
+export declare function createCameraStore(preloadedState?: Partial<CameraState>): import('@reduxjs/toolkit').EnhancedStore<CameraState, import('redux').UnknownAction, import('@reduxjs/toolkit').Tuple<[import('redux').StoreEnhancer<{
     dispatch: import('redux-thunk').ThunkDispatch<CameraState, undefined, import('redux').UnknownAction>;
 }>, import('redux').StoreEnhancer]>>;
+export type CameraStore = ReturnType<typeof createCameraStore>;
 export declare const useCameraActions: () => import('@reduxjs/toolkit').CaseReducerActions<{
     readonly setDevices: import('@reduxjs/toolkit').CaseReducer<CameraState, {
-        payload: MediaDeviceInfo[];
+        payload: import('..').CameraDeviceInfo[];
         type: string;
     }> & {
         _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
@@ -28,7 +34,7 @@ export declare const useCameraActions: () => import('@reduxjs/toolkit').CaseRedu
         _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
     };
     readonly setAlert: import('@reduxjs/toolkit').CaseReducer<CameraState, {
-        payload: import('../types').CameraAlert | null;
+        payload: import('..').CameraAlert | null;
         type: string;
     }> & {
         _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
@@ -51,7 +57,7 @@ export declare const useCameraActions: () => import('@reduxjs/toolkit').CaseRedu
         cameraSupported: false;
     } | {
         hasPermission: boolean;
-        devices: import('../types').CameraDeviceInfo[];
+        devices: import('..').CameraDeviceInfo[];
         cameraSupported: true;
     }, {
         rejectValue: {
@@ -86,7 +92,7 @@ export declare const useCameraActions: () => import('@reduxjs/toolkit').CaseRedu
             cameraSupported: false;
         } | {
             hasPermission: boolean;
-            devices: import('../types').CameraDeviceInfo[];
+            devices: import('..').CameraDeviceInfo[];
             cameraSupported: true;
         }, void, {
             rejectValue: {

package/dist/lib/components/ui/media/camera/state/camera.thunks.d.ts

@@ -1,11 +1,11 @@
 import { CameraReducerCreators } from './camera.slice';
-export declare const createRequestPermissionThunk: (create: CameraReducerCreators) => import('@reduxjs/toolkit').AsyncThunkReducers<import('../types').CameraState, void, {
+export declare const createRequestPermissionThunk: (create: CameraReducerCreators) => import('@reduxjs/toolkit').AsyncThunkReducers<import('..').CameraState, void, {
     hasPermission: boolean;
     devices: never[];
     cameraSupported: false;
 } | {
     hasPermission: boolean;
-    devices: import('../types').CameraDeviceInfo[];
+    devices: import('..').CameraDeviceInfo[];
     cameraSupported: true;
 }, {
     rejectValue: {
@@ -40,7 +40,7 @@ export declare const createRequestPermissionThunk: (create: CameraReducerCreator
         cameraSupported: false;
     } | {
         hasPermission: boolean;
-        devices: import('../types').CameraDeviceInfo[];
+        devices: import('..').CameraDeviceInfo[];
         cameraSupported: true;
     }, void, {
         rejectValue: {
@@ -55,7 +55,7 @@ export declare const createRequestPermissionThunk: (create: CameraReducerCreator
         rejectedMeta?: unknown;
     }>;
 };
-export declare const createStartStreamThunk: (create: CameraReducerCreators) => import('@reduxjs/toolkit').AsyncThunkReducers<import('../types').CameraState, (stream: MediaStream) => void, void, {
+export declare const createStartStreamThunk: (create: CameraReducerCreators) => import('@reduxjs/toolkit').AsyncThunkReducers<import('..').CameraState, (stream: MediaStream) => void, void, {
     rejectValue: {
         message: string;
     };

package/dist/lib/components/ui/media/camera/types.d.ts

@@ -1,4 +1,4 @@
-import { CameraActions } from './state/camera.slice';
+import { ComponentProps, RefObject } from 'react';
 export type ImageFormat = 'png' | 'jpeg' | 'webp';
 export type CaptureSettings = {
     resolution: {
@@ -25,14 +25,24 @@ export type CameraState = {
     captureSettings: CaptureSettings;
     alert: CameraAlert | null;
 };
+/** What `useCamera()` / `useCameraContext()` hand a part of the camera. */
+export type CameraActions = {
+    setDevices: (devices: CameraDeviceInfo[]) => void;
+    selectDevice: (deviceId: string | null) => void;
+    setPermission: (hasPermission: boolean) => void;
+    setStreaming: (isStreaming: boolean) => void;
+    setAlert: (alert: CameraAlert | null) => void;
+    setCameraSupported: (cameraSupported: boolean) => void;
+    requestPermission: () => Promise<void>;
+    startStream: () => void;
+    stopStream: () => void;
+    capturePhoto: () => void;
+};
 export type CameraContextValue = {
-    videoRef: React.RefObject<HTMLVideoElement | null>;
-    canvasRef: React.RefObject<HTMLCanvasElement | null>;
-    streamRef: React.RefObject<MediaStream | null>;
+    videoRef: RefObject<HTMLVideoElement | null>;
+    canvasRef: RefObject<HTMLCanvasElement | null>;
+    streamRef: RefObject<MediaStream | null>;
     state: CameraState;
-    actions: Omit<CameraActions, 'startStream' | 'capturePhoto'> & {
-        capturePhoto: () => void;
-        startStream: () => void;
-        stopStream: () => void;
-    };
+    actions: CameraActions;
 };
+export type CameraProps = ComponentProps<'div'>;

package/dist/lib/components/ui/media/camera/use-camera.d.ts

@@ -1,11 +1,5 @@
-export declare function useCamera(): {
-    videoRef: import('react').RefObject<HTMLVideoElement | null>;
-    canvasRef: import('react').RefObject<HTMLCanvasElement | null>;
-    streamRef: import('react').RefObject<MediaStream | null>;
-    state: import('./types').CameraState;
-    actions: Omit<import('./state').CameraActions, "capturePhoto" | "startStream"> & {
-        capturePhoto: () => void;
-        startStream: () => void;
-        stopStream: () => void;
-    };
-};
+/**
+ * The camera's context, plus its lifecycle: asks for permission on mount
+ * and stops the stream on unmount. Inside `<Camera>` only.
+ */
+export declare function useCamera(): import('./types').CameraContextValue;

package/dist/lib/components/ui/media/camera/utils/camera.utils.d.ts

@@ -1,5 +1,4 @@
 import { CameraDeviceInfo } from '../types';
-export * from './camera.utils';
 /**
  * Get available camera devices
  */

package/dist/lib/components/ui/media/file-preview/file-preview-pdf.lazy.d.ts

@@ -0,0 +1,9 @@
+import { ComponentType } from 'react';
+import { PdfReaderProps } from '../pdf-viewer/types';
+/**
+ * `PdfReader`, imported on first use: a page that previews no PDF never
+ * loads the viewer, and an import that fails (a chunk that cannot be
+ * fetched, pdf.js missing from the bundle) rejects, so `FilePreview` falls
+ * back to its file card. A failure is not cached; the next call tries again.
+ */
+export declare function loadPdfReader(): Promise<ComponentType<PdfReaderProps>>;

package/dist/lib/components/ui/media/file-preview/file-preview.d.ts

@@ -0,0 +1,12 @@
+import { FilePreviewProps } from './types';
+export type { FilePreviewProps } from './types';
+/**
+ * Previews a file picked by its MIME type, else its extension: an image, a
+ * PDF (in `PdfReader`, loaded on demand), a video or audio file with the
+ * browser's controls, the text of a text, JSON, CSV or Markdown file, and
+ * for anything else a card with its name, size and a download link.
+ *
+ * Safe on a server: nothing is read and no object URL is made until it has
+ * mounted, and until then it renders a neutral placeholder.
+ */
+export declare function FilePreview({ file, type, name, maxTextBytes, onError, className, ...props }: FilePreviewProps): import("react").JSX.Element | null;

package/dist/lib/components/ui/media/file-preview/index.d.ts

@@ -0,0 +1,3 @@
+export { type FileKind, FilePreviewHttpError, type FilePreviewSource, FilePreviewUnsafeUrlError, fileKind, TEXT_PREVIEW_MAX_BYTES, } from '@nxgt/material-core/file-preview';
+export { FilePreview } from './file-preview';
+export type { FilePreviewProps, FilePreviewStatus } from './types';

package/dist/lib/components/ui/media/file-preview/partials/file-preview-body.d.ts

@@ -0,0 +1,9 @@
+import { DescribedFile } from '@nxgt/material-core/file-preview';
+import { FilePreviewState } from '../use-file-preview';
+/** The part of `FilePreview` that depends on the file's kind and the status. */
+export declare function FilePreviewBody({ state, described, displayName, maxTextBytes, }: {
+    state: FilePreviewState;
+    described: DescribedFile;
+    displayName: string;
+    maxTextBytes?: number;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-preview/partials/file-preview-card.d.ts

@@ -0,0 +1,20 @@
+import { FileKind } from '@nxgt/material-core/file-preview';
+/**
+ * A link that saves the file under `name` (the browser's choice when `''`).
+ * Nothing until `href` is known.
+ */
+export declare function FilePreviewDownload({ href, name, }: {
+    href: string | undefined;
+    name: string;
+}): import("react").JSX.Element | null;
+/** Any other file: its icon, name, size and type, and a download link. */
+export declare function FilePreviewCard({ kind, name, fileName, size, type, href, }: {
+    kind: FileKind;
+    /** What the card shows. */
+    name: string;
+    /** What the download saves as. */
+    fileName: string;
+    size?: number;
+    type: string;
+    href: string | undefined;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-preview/partials/file-preview-media.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An image, a video or an audio file in the browser's own element: `<img>`
+ * named by the file name, `<video controls>` and `<audio controls>` labelled
+ * with it. `onError` fires when the element cannot load `src`.
+ */
+export declare function FilePreviewMedia({ kind, src, name, onError, }: {
+    kind: 'image' | 'video' | 'audio';
+    src: string;
+    name: string;
+    onError: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-preview/partials/file-preview-pdf.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+/**
+ * A PDF in `PdfReader`, loaded lazily; `fallback` (the file card) when the
+ * viewer cannot be loaded.
+ */
+export declare function FilePreviewPdf({ file, fileName, fallback, }: {
+    file: Blob | string;
+    fileName: string;
+    fallback: ReactNode;
+}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;

package/dist/lib/components/ui/media/file-preview/partials/file-preview-status.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+/** The server's and the first render's box: no text, nothing to mismatch. */
+export declare function FilePreviewPlaceholder(): import("react").JSX.Element;
+/**
+ * The live region that announces the loading: always mounted, from the
+ * server's render on, with its text put in while loading. A region that
+ * mounted with its text already in it would not be announced.
+ */
+export declare function FilePreviewAnnouncer({ loading }: {
+    loading: boolean;
+}): import("react").JSX.Element;
+/** What is seen while loading; `FilePreviewAnnouncer` is what is heard. */
+export declare function FilePreviewLoading(): import("react").JSX.Element;
+/** The error message, and below it whatever can still be done (a download). */
+export declare function FilePreviewError({ children }: {
+    children?: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-preview/partials/file-preview-text.d.ts

@@ -0,0 +1,13 @@
+import { FileKind, TextPreview } from '@nxgt/material-core/file-preview';
+/**
+ * A text kind's content: JSON in `JsonViewer` and Markdown rendered when the
+ * whole file was read, else (and for text and CSV) as it is, in a `<pre>`.
+ * What scrolls is a region named after the file, and takes focus so a
+ * keyboard can scroll it.
+ */
+export declare function FilePreviewText({ kind, name, preview, maxBytes, }: {
+    kind: FileKind;
+    name: string;
+    preview: TextPreview;
+    maxBytes: number;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-preview/types.d.ts

@@ -0,0 +1,23 @@
+import { FilePreviewSource } from '@nxgt/material-core/file-preview';
+import { ComponentProps } from 'react';
+/** Where a preview is: server or first render, reading, shown, failed. */
+export type FilePreviewStatus = 'pending' | 'loading' | 'ready' | 'error';
+export type FilePreviewProps = Omit<ComponentProps<'figure'>, 'children' | 'onError'> & {
+    /**
+     * The file: a `File` or `Blob`, or a URL. Nothing renders without one. A
+     * URL must be `http(s):`, relative, `blob:`, or a `data:` URL of an
+     * image, video, audio, plain text, CSV, Markdown, JSON or PDF; any other (`javascript:`, …) shows the error state.
+     */
+    file: FilePreviewSource | null | undefined;
+    /** MIME type; overrides the `Blob`'s. Picks the kind before the extension does. */
+    type?: string;
+    /** Name shown, used as the image's alt text and the download's file name; overrides the `File`'s. */
+    name?: string;
+    /** How much of a text, JSON, CSV or Markdown file is read and shown. 256 KB by default. */
+    maxTextBytes?: number;
+    /**
+     * The file could not be read or shown: `FilePreviewHttpError`, a
+     * `FilePreviewUnsafeUrlError`, or an `Error` for a broken image or video.
+     */
+    onError?: (error: unknown) => void;
+};

package/dist/lib/components/ui/media/file-preview/use-file-preview.d.ts

@@ -0,0 +1,22 @@
+import { DescribedFile } from '@nxgt/material-core/file-preview';
+import { FilePreviewProps, FilePreviewStatus } from './types';
+import { TextPreviewState } from './use-text-preview';
+type Options = Pick<FilePreviewProps, 'file' | 'type' | 'name' | 'maxTextBytes' | 'onError'>;
+export type FilePreviewState = {
+    described: DescribedFile | null;
+    status: FilePreviewStatus;
+    /** What the media element and the download link point at, once known. */
+    href: string | undefined;
+    text: TextPreviewState;
+    /** For an `<img>`, `<video>` or `<audio>` that failed to load `href`. */
+    onMediaError: () => void;
+};
+/**
+ * Everything `FilePreview` decides: the file's kind, the object URL of a
+ * `Blob` (made after mount, revoked on change and unmount), the text of a
+ * text kind, and the status. On a server and in the first client render the
+ * status is `'pending'` and nothing is read; a URL `safePreviewUrl` refuses
+ * is `'error'` everywhere and is never used.
+ */
+export declare function useFilePreview({ file, type, name, maxTextBytes, onError, }: Options): FilePreviewState;
+export {};

package/dist/lib/components/ui/media/file-preview/use-text-preview.d.ts

@@ -0,0 +1,15 @@
+import { TextPreview } from '@nxgt/material-core/file-preview';
+export type TextPreviewState = {
+    status: 'loading';
+} | {
+    status: 'ready';
+    preview: TextPreview;
+} | {
+    status: 'error';
+    error: unknown;
+};
+/**
+ * The first `maxBytes` of `source` as text, read in an effect (never on a
+ * server). A new source aborts the previous read; `undefined` reads nothing.
+ */
+export declare function useTextPreview(source: Blob | string | undefined, maxBytes: number | undefined): TextPreviewState;

package/dist/lib/components/ui/media/index.d.ts

@@ -1,5 +1,7 @@
+export * from './camera';
 export * from './carousel';
 export * from './file-list';
+export * from './file-preview';
 export * from './files-form-field';
 export * from './galleries';
 export * from './image-cropper';

package/dist/lib/components/ui/media/upload/network-upload-field/use-image-preview.d.ts

@@ -1,2 +1,8 @@
+/**
+ * An object URL for `blob`, made in an effect (never on a server) and revoked
+ * when `blob` changes or the component unmounts. `undefined` until made, and
+ * never the previous blob's (already revoked) URL. `FilePreview` uses it.
+ */
+export declare function useBlobUrl(blob: Blob | undefined): string | undefined;
 /** An object URL previewing `file` while it is an image, revoked on change. */
 export declare function useImagePreview(file?: File): string | undefined;

package/dist/lib/components/ui/overlays/dialog/dialog-outside.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A combobox inside a dialog portals its list outside the dialog's content;
+ * a pointer or focus landing there is not "outside" and must not close it.
+ */
+export declare function keepComboboxOverlay(event: Pick<Event, 'target' | 'preventDefault'>): void;