@danxbot/ui 15.24.0 → 15.25.0

package/dist/types/components/VideoPlayer.d.ts

@@ -0,0 +1,26 @@
+import { type Ref } from "react";
+export interface VideoTrack {
+    /** URL of a WebVTT file. */
+    src: string;
+    /** Shown in the browser's caption menu — "English". */
+    label: string;
+    /** BCP-47 language tag — "en". */
+    srcLang: string;
+    default?: boolean;
+}
+export interface VideoPlayerProps {
+    src: string;
+    /** The accessible name of the player — usually the file name. */
+    title: string;
+    /** A still shown until playback starts. */
+    poster?: string;
+    muted?: boolean;
+    /** Caption tracks. Rendered as `kind="captions"`. */
+    tracks?: VideoTrack[];
+    /** When passed, the can't-play fallback offers a Download button that calls it. */
+    onDownload?: () => void;
+    /** Sizes the player's frame. A `max-h-*` here caps the video, which then letterboxes. */
+    className?: string;
+    ref?: Ref<HTMLDivElement>;
+}
+export declare function VideoPlayer({ src, title, poster, muted, tracks, onDownload, className, ref, }: VideoPlayerProps): import("react").JSX.Element;

package/dist/types/components/chat/Attachment.d.ts

@@ -93,11 +93,17 @@ export interface AttachmentPreviewProps {
 /**
  * A file, opened.
  *
- * Deliberately narrow about what it displays: images, and anything the
- * consumer hands it through `renderBody`. It does NOT attempt to preview PDFs,
- * office documents or video by embedding them — an iframe pointed at an
- * arbitrary attachment is a security surface, and a half-working preview is
- * worse than an honest "open it" because people trust what they see.
+ * Deliberately narrow about what it displays: images, video, and anything the
+ * consumer hands it through `renderBody`. It does NOT attempt to preview PDFs
+ * or office documents by embedding them — an iframe pointed at an arbitrary
+ * attachment is a security surface, and a half-working preview is worse than an
+ * honest "open it" because people trust what they see.
+ *
+ * VIDEO IS NOT THAT SURFACE. A native `<video>` (through `VideoPlayer`) is the
+ * browser decoding a media stream inside its own sandbox, not a document
+ * embedded from elsewhere, so it is allowed where an iframe or <object> is not.
+ * Video is recognised by mime type OR extension, because attachments from chat
+ * integrations arrive as `application/octet-stream`.
  */
 export declare function AttachmentPreview({ file, onOpenChange, onDownload, renderBody, }: AttachmentPreviewProps): import("react").JSX.Element;
 export interface AttachmentListProps {

package/dist/types/components/chat/FileCover.d.ts

@@ -0,0 +1,14 @@
+import { type Ref } from "react";
+import type { ChatFile } from "./types";
+export interface FileCoverProps {
+    file: ChatFile;
+    /** CSS `aspect-ratio` of the box. */
+    aspect?: number | string;
+    /** Alt text of an image cover. Defaults to the file name. */
+    alt?: string;
+    /** Offered by a video's can't-play fallback. */
+    onDownload?: (file: ChatFile) => void;
+    className?: string;
+    ref?: Ref<HTMLDivElement>;
+}
+export declare function FileCover({ file, aspect, alt, onDownload, className, ref, }: FileCoverProps): import("react").JSX.Element;

package/dist/types/components/chat/file-icon.d.ts

@@ -0,0 +1,17 @@
+import type { IconName } from "../Icon";
+import type { ChatFile } from "./types";
+export type FileIdentity = Pick<ChatFile, "name" | "mimeType">;
+/**
+ * The icon for a file, from its mime type and, when that says nothing, its
+ * extension.
+ *
+ * No mime type is normal — a file dragged from some sources arrives without
+ * one, and chat integrations send `application/octet-stream` for everything.
+ * The extension is the next best signal, and guessing from it beats a generic
+ * icon for the formats people actually attach.
+ */
+export declare function fileIconFor(file: FileIdentity): IconName;
+/** An image by mime type or extension. */
+export declare const isImageFile: (file: FileIdentity) => boolean;
+/** A video by mime type or extension — `circle-play` is the video kind's icon alone. */
+export declare const isVideoFile: (file: FileIdentity) => boolean;

package/dist/types/index.d.ts

@@ -108,6 +108,9 @@ export { MessageScroller, type MessageScrollerProps, } from "./components/chat/M
 export { Composer, type ComposerProps } from "./components/chat/Composer";
 export { StreamingMarkdown, type StreamingMarkdownProps, } from "./components/chat/StreamingMarkdown";
 export { Attachment, AttachmentAction, AttachmentList, AttachmentPreview, type AttachmentProps, type AttachmentActionProps, type AttachmentListProps, type AttachmentPreviewProps, type AttachmentLayout, } from "./components/chat/Attachment";
+export { FileCover, type FileCoverProps } from "./components/chat/FileCover";
+export { fileIconFor, type FileIdentity } from "./components/chat/file-icon";
+export { VideoPlayer, type VideoPlayerProps, type VideoTrack } from "./components/VideoPlayer";
 export { ModelSelector, type ModelSelectorProps, type ChatModel, } from "./components/chat/ModelSelector";
 export { EffortControl, DEFAULT_EFFORT_LEVELS, type EffortControlProps, type EffortLevel, } from "./components/chat/EffortControl";
 export { ContextMeter, ChatStatus, type ContextMeterProps, type ContextSegment, type UsageLimit, type ChatStatusProps, } from "./components/chat/ContextMeter";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.24.0",
+  "version": "15.25.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",