@starasia/admin 14.17.1 → 14.18.0

package/dist/components/AttachmentPreview/AttachmentPreview.d.ts

@@ -0,0 +1,55 @@
+import { default as React } from 'react';
+
+export interface PreviewAttachment {
+    /** Display name shown in the header. */
+    fileName: string;
+    /** Source URL used for the preview (and for "open in new tab"). */
+    fileUrl: string;
+    /** Optional MIME type — improves auto-detection over the URL extension. */
+    mimeType?: string;
+}
+export type AttachmentKind = "image" | "pdf" | "video" | "audio" | "other";
+export interface AttachmentPreviewLabels {
+    download?: string;
+    close?: string;
+    openInNewTab?: string;
+    /** Shown for files that cannot be previewed, above the "open in new tab" action. */
+    unsupported?: string;
+}
+export interface AttachmentPreviewProps {
+    /** The attachment to preview. `null` renders nothing (treated as closed). */
+    attachment: PreviewAttachment | null;
+    /** Called when the dialog is dismissed (close button, backdrop, or Escape). */
+    onClose: () => void;
+    /**
+     * Optional download handler. When provided, a "Download" button appears in the
+     * header — use it for authenticated/tracked downloads. Omit to hide the button.
+     */
+    onDownload?: () => void;
+    /** Marks the download button as busy (spinner + disabled). */
+    isDownloading?: boolean;
+    /** Force the preview kind instead of auto-detecting from mimeType/extension. */
+    kind?: AttachmentKind;
+    /** Dialog max width. Defaults to a wider value for PDFs. */
+    maxWidth?: number | string;
+    /** Overridable text labels (i18n). */
+    labels?: AttachmentPreviewLabels;
+}
+/**
+ * Modal preview for a single file attachment. Renders images, PDFs, video and
+ * audio inline (auto-detected from `mimeType` or the URL extension) and falls
+ * back to an "open in new tab" action for anything else. Built on the design
+ * system `Dialog`, so backdrop, Escape, focus trap and portal are handled.
+ *
+ * Controlled via `attachment`: pass the file to open it, `null` to close.
+ *
+ * ```tsx
+ * <AttachmentPreview
+ *   attachment={selected}
+ *   onClose={() => setSelected(null)}
+ *   onDownload={handleDownload}
+ *   isDownloading={isDownloading}
+ * />
+ * ```
+ */
+export declare const AttachmentPreview: React.FC<AttachmentPreviewProps>;

package/dist/components/AttachmentPreview/index.d.ts

@@ -0,0 +1 @@
+export * from './AttachmentPreview';

package/dist/components/index.d.ts

@@ -31,6 +31,7 @@ export * from './FullSection';
 export * from './SelectButton';
 export * from './LayoutDialog';
 export * from './ImagePreview';
+export * from './AttachmentPreview';
 export * from './SelectionActionBar';
 export * from './EntityCard';
 export * from './Highlight';