pixelize-design-library 2.4.2-beta.42 → 2.4.2-beta.44

package/dist/esm/Components/MediaViewer/components/MediaAudioPlayer.js

@@ -0,0 +1,133 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Box, Flex, IconButton, Menu, MenuButton, MenuItemOption, MenuList, MenuOptionGroup, Slider, SliderFilledTrack, SliderThumb, SliderTrack, Text, } from "@chakra-ui/react";
+import { ChevronDown, Download, Music, Pause, Play, SkipBack, SkipForward, Volume2, VolumeX } from "lucide-react";
+import { settleBetween } from "../../../Theme/tokens/builders/focusRing.js";
+import { formatClock, isTypingTarget, PLAYBACK_SPEEDS, SEEK_STEP_SECONDS } from "../mediaItems.js";
+import { useViewerChrome } from "../useViewerChrome.js";
+import MediaScrubber from "./MediaScrubber.js";
+import MediaStatusPanel from "./MediaStatusPanel.js";
+import ViewerIconButton from "./ViewerIconButton.js";
+import { defaultMediaAudioPlayerLabels } from "./MediaAudioPlayerProps.js";
+const ARROW_SEEK_SECONDS = 5;
+const ARROW_VOLUME_STEP = 0.1;
+const MediaAudioPlayer = ({ item, label, onTimeChange, labels: labelOverrides }) => {
+    const labels = { ...defaultMediaAudioPlayerLabels, ...labelOverrides };
+    const chrome = useViewerChrome();
+    const shellRef = useRef(null);
+    const audioRef = useRef(null);
+    const [playing, setPlaying] = useState(false);
+    const [current, setCurrent] = useState(0);
+    const [duration, setDuration] = useState(0);
+    const [volume, setVolume] = useState(1);
+    const [muted, setMuted] = useState(false);
+    const [rate, setRate] = useState(1);
+    const [failed, setFailed] = useState(false);
+    const [buffered, setBuffered] = useState([]);
+    const [volumeHover, setVolumeHover] = useState(false);
+    const ring = settleBetween(chrome.accent, [chrome.stage, chrome.raised, chrome.hover]);
+    const audio = () => audioRef.current;
+    const togglePlay = () => {
+        const a = audio();
+        if (!a)
+            return;
+        if (a.paused)
+            void a.play().catch(() => setPlaying(false));
+        else
+            a.pause();
+    };
+    const seekTo = (seconds) => {
+        const a = audio();
+        if (!a)
+            return;
+        const max = Number.isFinite(a.duration) ? a.duration : seconds;
+        a.currentTime = Math.min(max, Math.max(0, seconds));
+        setCurrent(a.currentTime);
+    };
+    const seekBy = (delta) => { var _a, _b; return seekTo(((_b = (_a = audio()) === null || _a === void 0 ? void 0 : _a.currentTime) !== null && _b !== void 0 ? _b : 0) + delta); };
+    const toggleMute = () => {
+        const a = audio();
+        if (!a)
+            return;
+        a.muted = !a.muted;
+        if (!a.muted && a.volume === 0)
+            a.volume = 0.5;
+    };
+    const changeVolume = (value) => {
+        const a = audio();
+        if (!a)
+            return;
+        a.volume = value / 100;
+        a.muted = value === 0;
+    };
+    const changeRate = (value) => {
+        const a = audio();
+        if (a)
+            a.playbackRate = value;
+        setRate(value);
+    };
+    const actions = useRef({ togglePlay, seekBy, toggleMute, changeVolume });
+    useEffect(() => {
+        actions.current = { togglePlay, seekBy, toggleMute, changeVolume };
+    });
+    useEffect(() => {
+        const onKey = (event) => {
+            var _a, _b, _c, _d, _e, _f;
+            if (event.ctrlKey || event.metaKey || event.altKey || isTypingTarget(event.target))
+                return;
+            const a = actions.current;
+            const key = event.key.toLowerCase();
+            const playerHasFocus = (_b = (_a = shellRef.current) === null || _a === void 0 ? void 0 : _a.contains(document.activeElement)) !== null && _b !== void 0 ? _b : false;
+            if (!playerHasFocus && key !== " " && key !== "k")
+                return;
+            if (key === " " || key === "k")
+                a.togglePlay();
+            else if (key === "j")
+                a.seekBy(-SEEK_STEP_SECONDS);
+            else if (key === "l")
+                a.seekBy(SEEK_STEP_SECONDS);
+            else if (key === "m")
+                a.toggleMute();
+            else if (event.key === "ArrowRight")
+                a.seekBy(ARROW_SEEK_SECONDS);
+            else if (event.key === "ArrowLeft")
+                a.seekBy(-ARROW_SEEK_SECONDS);
+            else if (event.key === "ArrowUp")
+                a.changeVolume(Math.min(100, ((_d = (_c = audio()) === null || _c === void 0 ? void 0 : _c.volume) !== null && _d !== void 0 ? _d : 0) * 100 + ARROW_VOLUME_STEP * 100));
+            else if (event.key === "ArrowDown")
+                a.changeVolume(Math.max(0, ((_f = (_e = audio()) === null || _e === void 0 ? void 0 : _e.volume) !== null && _f !== void 0 ? _f : 0) * 100 - ARROW_VOLUME_STEP * 100));
+            else
+                return;
+            event.preventDefault();
+        };
+        const el = audioRef.current;
+        window.addEventListener("keydown", onKey);
+        return () => {
+            window.removeEventListener("keydown", onKey);
+            el === null || el === void 0 ? void 0 : el.pause();
+        };
+    }, []);
+    useEffect(() => {
+        setPlaying(false);
+        setCurrent(0);
+        setDuration(0);
+        setRate(1);
+        setFailed(false);
+        setBuffered([]);
+        if (audioRef.current)
+            audioRef.current.playbackRate = 1;
+    }, [item.key]);
+    const clock = (seconds) => formatClock(seconds);
+    const effectiveVolume = muted ? 0 : Math.round(volume * 100);
+    return (_jsxs(Box, { ref: shellRef, as: "section", "aria-label": `${labels.audioPlayer}: ${label}`, position: "absolute", inset: 0, bg: chrome.stage, children: [_jsx("audio", { ref: audioRef, src: item.src, preload: "metadata", onPlay: () => setPlaying(true), onPause: () => setPlaying(false), onEnded: () => setPlaying(false), onError: () => setFailed(true), onProgress: (e) => {
+                    const ranges = e.currentTarget.buffered;
+                    setBuffered(Array.from({ length: ranges.length }, (_, i) => ({ start: ranges.start(i), end: ranges.end(i) })));
+                }, onTimeUpdate: (e) => {
+                    setCurrent(e.currentTarget.currentTime);
+                    onTimeChange === null || onTimeChange === void 0 ? void 0 : onTimeChange(e.currentTarget.currentTime);
+                }, onLoadedMetadata: (e) => setDuration(e.currentTarget.duration), onDurationChange: (e) => setDuration(e.currentTarget.duration), onVolumeChange: (e) => {
+                    setVolume(e.currentTarget.volume);
+                    setMuted(e.currentTarget.muted);
+                }, "data-testid": "media-audio" }), failed ? (_jsx(MediaStatusPanel, { icon: _jsx(VolumeX, {}), label: label, message: labels.audioError, downloadHref: item.src, downloadLabel: labels.download, tone: "warning", testId: "media-audio-error" })) : (_jsxs(Flex, { direction: "column", align: "center", justify: "center", h: "100%", px: { base: 4, md: 10 }, gap: 6, children: [_jsx(Flex, { boxSize: { base: "96px", md: "140px" }, borderRadius: "full", bg: chrome.raised, align: "center", justify: "center", color: chrome.accent, children: _jsx(Music, { size: 48, "aria-hidden": true }) }), _jsx(Text, { fontSize: "sm", fontWeight: 600, color: chrome.ink, noOfLines: 1, maxW: "480px", textAlign: "center", children: label }), _jsxs(Box, { w: "100%", maxW: "480px", children: [_jsx(MediaScrubber, { value: Math.min(current, duration || current), max: duration > 0 ? duration : 0, buffered: buffered, onSeek: seekTo, ariaLabel: labels.seek, ariaValueText: (v) => labels.seekValue(clock(v), clock(duration)), formatTime: clock, isDisabled: duration <= 0, testId: "media-audio-seek" }), _jsxs(Flex, { role: "toolbar", "aria-label": labels.audioControls, align: "center", justify: "space-between", gap: 2, wrap: "wrap", mt: 1, children: [_jsxs(Flex, { align: "center", gap: 1, wrap: "wrap", children: [_jsx(IconButton, { "aria-label": playing ? labels.pause : labels.play, icon: playing ? _jsx(Pause, { size: 20 }) : _jsx(Play, { size: 20 }), onClick: togglePlay, isRound: true, variant: "ghost", bg: chrome.raised, color: chrome.accent, _hover: { bg: chrome.hover }, _focusVisible: { boxShadow: `0 0 0 2px ${ring}` }, "data-testid": "media-audio-toggle" }), _jsx(ViewerIconButton, { label: labels.rewind, hint: "J", icon: _jsx(SkipBack, { size: 16 }), onClick: () => seekBy(-SEEK_STEP_SECONDS), testId: "media-audio-rewind" }), _jsx(ViewerIconButton, { label: labels.forward, hint: "L", icon: _jsx(SkipForward, { size: 16 }), onClick: () => seekBy(SEEK_STEP_SECONDS), testId: "media-audio-forward" }), _jsxs(Flex, { align: "center", onMouseEnter: () => setVolumeHover(true), onMouseLeave: () => setVolumeHover(false), sx: { "&:focus-within": { "--volume-w": "88px" } }, children: [_jsx(ViewerIconButton, { label: muted || volume === 0 ? labels.unmute : labels.mute, hint: "M", icon: muted || volume === 0 ? _jsx(VolumeX, { size: 18 }) : _jsx(Volume2, { size: 18 }), onClick: toggleMute, pressed: muted, testId: "media-audio-mute" }), _jsx(Box, { w: volumeHover ? "88px" : "0px", overflow: "hidden", px: volumeHover ? 1 : 0, transition: "width 0.2s ease-out", sx: { "&:focus-within": { width: "88px", paddingInline: "4px" } }, children: _jsxs(Slider, { "aria-label": labels.volume, min: 0, max: 100, step: 5, value: effectiveVolume, onChange: changeVolume, focusThumbOnChange: false, getAriaValueText: (v) => `${v}%`, children: [_jsx(SliderTrack, { bg: chrome.track, h: "4px", borderRadius: "full", children: _jsx(SliderFilledTrack, { bg: chrome.ink }) }), _jsx(SliderThumb, { bg: chrome.ink, boxSize: "12px", _focusVisible: { boxShadow: `0 0 0 2px ${ring}` } })] }) })] }), _jsxs(Text, { as: "span", ml: 2, fontSize: "sm", fontWeight: 500, color: chrome.ink, sx: { fontVariantNumeric: "tabular-nums" }, "data-testid": "media-audio-time", children: [clock(current), _jsx(Text, { as: "span", color: chrome.muted, children: ` / ${clock(duration)}` })] })] }), _jsxs(Flex, { align: "center", gap: 1, children: [_jsxs(Menu, { placement: "top-end", children: [_jsx(MenuButton, { "aria-label": labels.speed, h: "32px", px: 3, borderRadius: "full", borderWidth: "1px", borderColor: chrome.track, bg: chrome.raised, color: chrome.ink, fontSize: "sm", fontWeight: 600, _hover: { bg: chrome.hover }, _focusVisible: { boxShadow: `0 0 0 2px ${ring}` }, "data-testid": "media-audio-speed", children: _jsxs(Flex, { as: "span", align: "center", gap: 1, children: [`${rate}x`, _jsx(ChevronDown, { size: 14, "aria-hidden": true })] }) }), _jsx(MenuList, { minW: "160px", bg: chrome.raised, zIndex: 1500, children: _jsx(MenuOptionGroup, { type: "radio", title: labels.speed, value: String(rate), onChange: (value) => changeRate(Number(value)), children: PLAYBACK_SPEEDS.map((speed) => (_jsx(MenuItemOption, { value: String(speed), bg: chrome.raised, color: chrome.ink, _hover: { bg: chrome.hover }, _focus: { bg: chrome.hover }, children: speed === 1 ? `1x - ${labels.normalSpeed}` : `${speed}x` }, speed))) }) })] }), _jsx(ViewerIconButton, { label: labels.download, icon: _jsx(Download, { size: 18 }), href: item.src, testId: "media-audio-download" })] })] })] })] }))] }));
+};
+export default MediaAudioPlayer;

package/dist/esm/Components/MediaViewer/components/MediaAudioPlayerProps.js

@@ -0,0 +1,18 @@
+export const defaultMediaAudioPlayerLabels = {
+    audioPlayer: "Audio player",
+    audioError: "This audio could not be played",
+    play: "Play",
+    pause: "Pause",
+    audioControls: "Audio controls",
+    seek: "Seek",
+    rewind: "Back 10 seconds",
+    forward: "Forward 10 seconds",
+    unmute: "Unmute",
+    mute: "Mute",
+    volume: "Volume",
+    speed: "Playback speed",
+    normalSpeed: "Normal",
+    download: "Download",
+    seekValue: (current, total) => `${current} of ${total}`,
+    loading: "Loading",
+};

package/dist/esm/Components/MediaViewer/components/MediaDocumentStage.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Box, Flex, Spinner, Text } from "@chakra-ui/react";
+import PdfViewer from "../../PdfViewer/PdfViewer.js";
+import { useViewerChrome } from "../useViewerChrome.js";
+import { iconForKind, warningIcon } from "./mediaKindIcon.js";
+import MediaStatusPanel from "./MediaStatusPanel.js";
+import { sanitizeDocxHrefs } from "./sanitizeDocxHrefs.js";
+import { defaultMediaDocumentStageLabels, } from "./MediaDocumentStageProps.js";
+const DOCX_EXT_RE = /\.docx(?:[?#].*)?$/i;
+const isDocxSource = (item) => { var _a; return DOCX_EXT_RE.test((_a = item.name) !== null && _a !== void 0 ? _a : "") || DOCX_EXT_RE.test(item.src); };
+function PdfStage({ url, label }) {
+    return (_jsx(Box, { position: "absolute", inset: 0, px: { base: 0, md: 20 }, py: { base: 0, md: 4 }, sx: {
+            "& > div": { height: "100%", display: "flex", flexDirection: "column" },
+            "& embed": { flex: 1, height: "100%" },
+        }, "data-testid": "media-pdf", children: _jsx(PdfViewer, { pdfUrl: url, fileName: label, height: "100%", showToolbar: false }) }));
+}
+const DOCX_PREVIEW = "docx-preview";
+const loadDocxPreview = () => import(/* @vite-ignore */ DOCX_PREVIEW);
+function WordStage({ itemKey, url, blob, label, labels }) {
+    const chrome = useViewerChrome();
+    const hostRef = useRef(null);
+    const [failed, setFailed] = useState(false);
+    useEffect(() => {
+        setFailed(false);
+        const host = hostRef.current;
+        if (!host)
+            return;
+        let live = true;
+        loadDocxPreview()
+            .then(({ renderAsync }) => renderAsync(blob, host, undefined, { inWrapper: true, ignoreLastRenderedPageBreak: true }))
+            .then(() => {
+            if (live)
+                sanitizeDocxHrefs(host);
+        })
+            .catch(() => {
+            if (live)
+                setFailed(true);
+        });
+        return () => {
+            live = false;
+            host.replaceChildren();
+        };
+    }, [itemKey, blob]);
+    if (failed) {
+        return (_jsx(MediaStatusPanel, { icon: iconForKind("doc"), label: label, message: labels.noPreview, hint: labels.noPreviewHint, downloadHref: url, downloadLabel: labels.download, testId: "media-file", downloadTestId: "media-file-download" }));
+    }
+    return (_jsx(Box, { ref: hostRef, position: "absolute", inset: 0, overflow: "auto", sx: { "& .docx-wrapper": { background: chrome.stage, padding: { base: 2, md: 6 } } }, "data-testid": "media-doc" }));
+}
+function TextStage({ itemKey, url, blob, label, labels }) {
+    const chrome = useViewerChrome();
+    const [state, setState] = useState({
+        status: "loading",
+    });
+    useEffect(() => {
+        let live = true;
+        setState({ status: "loading" });
+        const load = blob ? blob.text() : fetch(url).then((res) => (res.ok ? res.text() : Promise.reject(new Error("fetch failed"))));
+        load
+            .then((text) => {
+            if (live)
+                setState({ status: "ready", text });
+        })
+            .catch(() => {
+            if (live)
+                setState({ status: "error" });
+        });
+        return () => {
+            live = false;
+        };
+    }, [itemKey, url, blob]);
+    if (state.status === "loading") {
+        return (_jsx(Flex, { position: "absolute", inset: 0, align: "center", justify: "center", "data-testid": "media-text-loading", children: _jsx(Spinner, { size: "lg", label: labels.loadingFile, color: chrome.ink }) }));
+    }
+    if (state.status === "error") {
+        return (_jsx(MediaStatusPanel, { icon: warningIcon(), label: label, message: labels.textLoadError, downloadHref: url, downloadLabel: labels.download, tone: "warning", testId: "media-text-error" }));
+    }
+    return (_jsx(Box, { position: "absolute", inset: 0, overflow: "auto", px: { base: 3, md: 8 }, py: 4, "data-testid": "media-text", children: _jsx(Text, { as: "pre", fontFamily: "mono", fontSize: "sm", whiteSpace: "pre-wrap", wordBreak: "break-word", color: chrome.ink, children: state.text }) }));
+}
+export const MediaDocumentStage = ({ item, label, resolveDocument, labels: labelOverrides, }) => {
+    const labels = { ...defaultMediaDocumentStageLabels, ...labelOverrides };
+    const chrome = useViewerChrome();
+    const resolution = resolveDocument(item);
+    if (resolution.status === "loading") {
+        return (_jsx(Flex, { position: "absolute", inset: 0, align: "center", justify: "center", "data-testid": "media-file-loading", children: _jsx(Spinner, { size: "lg", label: labels.loadingFile, color: chrome.ink }) }));
+    }
+    if (resolution.status === "missing" || resolution.status === "error") {
+        return (_jsx(MediaStatusPanel, { label: label, message: labels.fileError, downloadLabel: labels.download, icon: warningIcon(), tone: "warning", testId: "media-file-missing" }));
+    }
+    if (item.kind === "pdf")
+        return _jsx(PdfStage, { url: resolution.url, label: label });
+    if (item.kind === "text") {
+        return _jsx(TextStage, { itemKey: item.key, url: resolution.url, blob: resolution.blob, label: label, labels: labels });
+    }
+    if (item.kind === "spreadsheet" || item.kind === "presentation" || item.kind === "archive") {
+        return (_jsx(MediaStatusPanel, { icon: iconForKind(item.kind), label: label, message: labels.noPreview, hint: labels.noPreviewHint, downloadHref: resolution.url, downloadLabel: labels.download, testId: `media-${item.kind}` }));
+    }
+    if (item.kind === "doc") {
+        if (!isDocxSource(item)) {
+            return (_jsx(MediaStatusPanel, { icon: iconForKind("doc"), label: label, message: labels.noPreview, hint: labels.noPreviewHint, downloadHref: resolution.url, downloadLabel: labels.download, testId: "media-file", downloadTestId: "media-file-download" }));
+        }
+        if (!resolution.blob) {
+            return (_jsx(MediaStatusPanel, { label: label, message: labels.fileError, downloadLabel: labels.download, icon: warningIcon(), tone: "warning", testId: "media-file-missing" }));
+        }
+        return _jsx(WordStage, { itemKey: item.key, url: resolution.url, blob: resolution.blob, label: label, labels: labels });
+    }
+    return (_jsx(MediaStatusPanel, { icon: iconForKind("file"), label: label, message: labels.noPreview, hint: labels.noPreviewHint, downloadHref: resolution.url, downloadLabel: labels.download, testId: "media-file", downloadTestId: "media-file-download" }));
+};
+export default MediaDocumentStage;

package/dist/esm/Components/MediaViewer/components/MediaDocumentStageProps.js

@@ -0,0 +1,8 @@
+export const defaultMediaDocumentStageLabels = {
+    download: "Download",
+    noPreview: "This file can't be previewed here",
+    noPreviewHint: "Download it to open it on your device.",
+    loadingFile: "Loading file…",
+    fileError: "This file could not be loaded. It may have been moved or deleted.",
+    textLoadError: "This file's contents could not be loaded.",
+};

package/dist/esm/Components/MediaViewer/components/MediaImageViewer.js

@@ -0,0 +1,98 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Box, Flex, Image, Text } from "@chakra-ui/react";
+import { Maximize, Minimize, RotateCw, Scan, ZoomIn, ZoomOut } from "lucide-react";
+import { useFullscreen } from "../../../Hooks/useFullscreen.js";
+import { clampZoom, isTypingTarget, isUnsupportedImageSrc, MAX_ZOOM, MIN_ZOOM, ZOOM_STEP } from "../mediaItems.js";
+import { useViewerChrome } from "../useViewerChrome.js";
+import { iconForKind, warningIcon } from "./mediaKindIcon.js";
+import MediaStatusPanel from "./MediaStatusPanel.js";
+import ViewerIconButton from "./ViewerIconButton.js";
+import { defaultMediaImageViewerLabels } from "./MediaImageViewerProps.js";
+const ORIGIN = { x: 0, y: 0 };
+const MediaImageViewer = ({ item, label, onZoomChange, onNaturalSize, labels: labelOverrides, }) => {
+    const labels = { ...defaultMediaImageViewerLabels, ...labelOverrides };
+    const chrome = useViewerChrome();
+    const stageRef = useRef(null);
+    const drag = useRef(null);
+    const [zoom, setZoom] = useState(100);
+    const [rotation, setRotation] = useState(0);
+    const [pan, setPan] = useState(ORIGIN);
+    const [failed, setFailed] = useState(false);
+    const [dragging, setDragging] = useState(false);
+    const { isFullscreen, toggle: toggleFullscreen, isSupported: fullscreenSupported } = useFullscreen(stageRef);
+    useEffect(() => {
+        onZoomChange === null || onZoomChange === void 0 ? void 0 : onZoomChange(zoom);
+    }, [zoom, onZoomChange]);
+    // Defense in depth: a parent that reuses this instance across items (no key remount) must not carry state over.
+    useEffect(() => {
+        setZoom(100);
+        setRotation(0);
+        setPan(ORIGIN);
+        setFailed(false);
+    }, [item.key]);
+    const zoomBy = (delta) => {
+        const next = clampZoom(zoom + delta);
+        setZoom(next);
+        if (next <= 100)
+            setPan(ORIGIN);
+    };
+    const reset = () => {
+        setZoom(100);
+        setRotation(0);
+        setPan(ORIGIN);
+    };
+    const rotate = () => setRotation((r) => (r + 90) % 360);
+    const actions = useRef({ zoomBy, reset, rotate, toggleFullscreen });
+    useEffect(() => {
+        actions.current = { zoomBy, reset, rotate, toggleFullscreen };
+    });
+    useEffect(() => {
+        const onKey = (event) => {
+            if (event.ctrlKey || event.metaKey || event.altKey || isTypingTarget(event.target))
+                return;
+            const a = actions.current;
+            if (event.key === "+" || event.key === "=")
+                a.zoomBy(ZOOM_STEP);
+            else if (event.key === "-" || event.key === "_")
+                a.zoomBy(-ZOOM_STEP);
+            else if (event.key === "0")
+                a.reset();
+            else if (event.key === "r" || event.key === "R")
+                a.rotate();
+            else if (event.key === "f" || event.key === "F")
+                void a.toggleFullscreen();
+            else
+                return;
+            event.preventDefault();
+        };
+        window.addEventListener("keydown", onKey);
+        return () => window.removeEventListener("keydown", onKey);
+    }, []);
+    const unsupported = isUnsupportedImageSrc(item.src);
+    const onPointerDown = (event) => {
+        if (zoom <= 100)
+            return;
+        event.currentTarget.setPointerCapture(event.pointerId);
+        drag.current = { start: { x: event.clientX, y: event.clientY }, from: pan };
+        setDragging(true);
+    };
+    const onPointerMove = (event) => {
+        const d = drag.current;
+        if (!d)
+            return;
+        setPan({ x: d.from.x + event.clientX - d.start.x, y: d.from.y + event.clientY - d.start.y });
+    };
+    const endDrag = () => {
+        drag.current = null;
+        setDragging(false);
+    };
+    if (unsupported) {
+        return (_jsx(Box, { position: "absolute", inset: 0, bg: chrome.stage, children: _jsx(MediaStatusPanel, { icon: iconForKind("image"), label: label, message: labels.unsupportedFormat, hint: labels.unsupportedFormatHint, downloadHref: item.src, downloadLabel: labels.download, tone: "warning", testId: "media-image-unsupported" }) }));
+    }
+    return (_jsxs(Box, { ref: stageRef, position: "absolute", inset: 0, bg: chrome.stage, overflow: "hidden", children: [_jsx(Flex, { position: "absolute", inset: 0, align: "center", justify: "center", p: { base: 2, md: 6 }, pb: { base: 20, md: 24 }, cursor: zoom > 100 ? (dragging ? "grabbing" : "grab") : "default", onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: endDrag, onPointerCancel: endDrag, sx: { touchAction: zoom > 100 ? "none" : "pan-y" }, children: failed ? (_jsx(MediaStatusPanel, { icon: warningIcon(), label: label, message: labels.imageError, downloadLabel: labels.download, downloadHref: item.src, tone: "warning", testId: "media-image-error" })) : (_jsx(Image, { src: item.src, alt: label, maxW: "100%", maxH: "100%", objectFit: "contain", draggable: false, userSelect: "none", onError: () => setFailed(true), onLoad: (event) => onNaturalSize === null || onNaturalSize === void 0 ? void 0 : onNaturalSize({
+                        width: event.currentTarget.naturalWidth,
+                        height: event.currentTarget.naturalHeight,
+                    }), transform: `translate(${pan.x}px, ${pan.y}px) scale(${zoom / 100}) rotate(${rotation}deg)`, transition: dragging ? "none" : "transform 0.15s ease-out", "data-testid": "media-image" })) }), _jsxs(Flex, { role: "toolbar", "aria-label": labels.imageControls, position: "absolute", bottom: 4, left: "50%", transform: "translateX(-50%)", align: "center", gap: 1, p: 1, borderRadius: "12px", bg: chrome.raised, borderWidth: "1px", borderColor: chrome.hover, maxW: "calc(100% - 16px)", overflowX: "auto", children: [_jsx(ViewerIconButton, { label: labels.zoomOut, hint: "-", icon: _jsx(ZoomOut, { size: 18 }), onClick: () => zoomBy(-ZOOM_STEP), isDisabled: zoom <= MIN_ZOOM, testId: "media-zoom-out" }), _jsx(Text, { as: "output", "aria-live": "polite", "aria-label": labels.zoomLevel, minW: "56px", textAlign: "center", fontSize: "sm", fontWeight: 600, color: chrome.ink, "data-testid": "media-zoom-level", children: `${zoom}%` }), _jsx(ViewerIconButton, { label: labels.zoomIn, hint: "+", icon: _jsx(ZoomIn, { size: 18 }), onClick: () => zoomBy(ZOOM_STEP), isDisabled: zoom >= MAX_ZOOM, testId: "media-zoom-in" }), _jsx(ViewerIconButton, { label: labels.fitLabel, hint: "0", icon: _jsx(Scan, { size: 16, "aria-hidden": true }), onClick: reset, testId: "media-fit" }), _jsx(Box, { w: "1px", h: "24px", bg: chrome.hover, mx: 1, "aria-hidden": true }), _jsx(ViewerIconButton, { label: labels.rotate, hint: "R", icon: _jsx(RotateCw, { size: 18 }), onClick: rotate, testId: "media-rotate" }), fullscreenSupported ? (_jsx(ViewerIconButton, { label: isFullscreen ? labels.exitFullscreen : labels.fullscreen, hint: "F", icon: isFullscreen ? _jsx(Minimize, { size: 18 }) : _jsx(Maximize, { size: 18 }), onClick: () => void toggleFullscreen(), pressed: isFullscreen, testId: "media-fullscreen" })) : null] })] }));
+};
+export default MediaImageViewer;

package/dist/esm/Components/MediaViewer/components/MediaImageViewerProps.js

@@ -0,0 +1,15 @@
+export const defaultMediaImageViewerLabels = {
+    imageError: "This photo could not be loaded",
+    imageControls: "Image controls",
+    zoomOut: "Zoom out",
+    zoomLevel: "Zoom level",
+    zoomIn: "Zoom in",
+    fitLabel: "Fit to screen",
+    fit: "Fit",
+    rotate: "Rotate",
+    exitFullscreen: "Exit fullscreen",
+    fullscreen: "Fullscreen",
+    download: "Download",
+    unsupportedFormat: "This photo format can't be previewed here",
+    unsupportedFormatHint: "Download it to view it on your device.",
+};

package/dist/esm/Components/MediaViewer/components/MediaScrubber.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from "react";
+import { Box } from "@chakra-ui/react";
+import { settleBetween } from "../../../Theme/tokens/builders/focusRing.js";
+import { useViewerChrome } from "../useViewerChrome.js";
+const STEP_SECONDS = 5;
+const BIG_STEP_SECONDS = 30;
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+/** Shared scrubber for video and audio — buffered range, hover/drag time tooltip, full keyboard slider semantics. */
+const MediaScrubber = ({ value, max, buffered = [], onSeek, onPreview, ariaLabel, ariaValueText, formatTime, isDisabled = false, testId, }) => {
+    const chrome = useViewerChrome();
+    const trackRef = useRef(null);
+    const dragging = useRef(false);
+    const [hovering, setHovering] = useState(false);
+    const [previewX, setPreviewX] = useState(null);
+    const ring = settleBetween(chrome.accent, [chrome.stage, chrome.raised, chrome.hover]);
+    const disabled = isDisabled || !Number.isFinite(max) || max <= 0;
+    const fraction = disabled ? 0 : clamp(value / max, 0, 1);
+    const fractionAt = (clientX) => {
+        var _a;
+        const rect = (_a = trackRef.current) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+        if (!rect || rect.width === 0)
+            return 0;
+        return clamp((clientX - rect.left) / rect.width, 0, 1);
+    };
+    const previewAt = (clientX) => {
+        const f = fractionAt(clientX);
+        setPreviewX(f * 100);
+        onPreview === null || onPreview === void 0 ? void 0 : onPreview(f * max);
+    };
+    const endPreview = () => {
+        setPreviewX(null);
+        onPreview === null || onPreview === void 0 ? void 0 : onPreview(null);
+    };
+    const onPointerDown = (event) => {
+        if (disabled)
+            return;
+        event.currentTarget.setPointerCapture(event.pointerId);
+        dragging.current = true;
+        previewAt(event.clientX);
+    };
+    const onPointerMove = (event) => {
+        if (disabled)
+            return;
+        if (dragging.current)
+            previewAt(event.clientX);
+        else if (hovering)
+            previewAt(event.clientX);
+    };
+    const onPointerUp = (event) => {
+        if (disabled || !dragging.current)
+            return;
+        dragging.current = false;
+        onSeek(fractionAt(event.clientX) * max);
+        if (!hovering)
+            endPreview();
+    };
+    const onKeyDown = (event) => {
+        if (disabled)
+            return;
+        let next = null;
+        if (event.key === "ArrowRight" || event.key === "ArrowUp")
+            next = value + STEP_SECONDS;
+        else if (event.key === "ArrowLeft" || event.key === "ArrowDown")
+            next = value - STEP_SECONDS;
+        else if (event.key === "PageUp")
+            next = value + BIG_STEP_SECONDS;
+        else if (event.key === "PageDown")
+            next = value - BIG_STEP_SECONDS;
+        else if (event.key === "Home")
+            next = 0;
+        else if (event.key === "End")
+            next = max;
+        if (next === null)
+            return;
+        event.preventDefault();
+        onSeek(clamp(next, 0, max));
+    };
+    const trackH = hovering || dragging.current ? "6px" : "4px";
+    const previewLabel = previewX !== null ? formatTime((previewX / 100) * max) : null;
+    return (_jsxs(Box, { position: "relative", py: 2, cursor: disabled ? "default" : "pointer", onMouseEnter: () => setHovering(true), onMouseLeave: () => {
+            setHovering(false);
+            if (!dragging.current)
+                endPreview();
+        }, children: [previewLabel !== null ? (_jsx(Box, { position: "absolute", bottom: "100%", left: `${previewX}%`, transform: "translateX(-50%)", mb: 1, px: 2, py: 0.5, borderRadius: "4px", bg: chrome.raised, color: chrome.ink, fontSize: "xs", fontWeight: 600, whiteSpace: "nowrap", pointerEvents: "none", sx: { fontVariantNumeric: "tabular-nums" }, "data-testid": testId ? `${testId}-tooltip` : undefined, children: previewLabel })) : null, _jsxs(Box, { ref: trackRef, role: "slider", tabIndex: disabled ? -1 : 0, "aria-label": ariaLabel, "aria-orientation": "horizontal", "aria-valuemin": 0, "aria-valuemax": disabled ? 0 : max, "aria-valuenow": disabled ? 0 : value, "aria-valuetext": disabled ? undefined : ariaValueText(value), "aria-disabled": disabled || undefined, position: "relative", h: trackH, borderRadius: "full", bg: chrome.track, transition: "height 0.12s ease-out", onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onPointerCancel: onPointerUp, onKeyDown: onKeyDown, _focusVisible: { boxShadow: `0 0 0 2px ${ring}` }, "data-testid": testId, children: [buffered.map((range, i) => (_jsx(Box, { position: "absolute", top: 0, bottom: 0, left: `${disabled ? 0 : clamp(range.start / max, 0, 1) * 100}%`, width: `${disabled ? 0 : (clamp(range.end / max, 0, 1) - clamp(range.start / max, 0, 1)) * 100}%`, bg: chrome.hover, borderRadius: "full" }, i))), _jsx(Box, { position: "absolute", top: 0, bottom: 0, left: 0, width: `${fraction * 100}%`, bg: chrome.accent, borderRadius: "full" }), _jsx(Box, { position: "absolute", top: "50%", left: `${fraction * 100}%`, transform: "translate(-50%, -50%)", boxSize: hovering || dragging.current ? "14px" : "0px", borderRadius: "full", bg: chrome.ink, transition: "width 0.12s ease-out, height 0.12s ease-out", pointerEvents: "none" })] })] }));
+};
+export default MediaScrubber;

package/dist/esm/Components/MediaViewer/components/MediaScrubberProps.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/Components/MediaViewer/components/MediaStatusPanel.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement } from "react";
+import { Box, Button, Flex, Link, Text } from "@chakra-ui/react";
+import { Download } from "lucide-react";
+import { useViewerChrome } from "../useViewerChrome.js";
+/** One panel for every non-preview stage state — loading/error/missing/no-preview — icon and wording vary, layout never does. */
+const MediaStatusPanel = ({ icon, label, message, hint, downloadHref, downloadLabel, tone = "neutral", testId, downloadTestId, }) => {
+    const chrome = useViewerChrome();
+    const warning = tone === "warning";
+    return (_jsxs(Flex, { position: "absolute", inset: 0, direction: "column", align: "center", justify: "center", gap: 3, px: { base: 14, md: 16 }, textAlign: "center", color: chrome.ink, role: warning ? "alert" : undefined, "data-testid": testId, children: [_jsx(Box, { color: warning ? chrome.accent : chrome.muted, children: cloneElement(icon, { size: 48, "aria-hidden": true }) }), _jsx(Text, { fontWeight: 600, wordBreak: "break-word", children: label }), _jsx(Text, { fontSize: "sm", color: chrome.muted, children: message }), hint ? (_jsx(Text, { fontSize: "sm", color: chrome.muted, children: hint })) : null, downloadHref ? (_jsx(Button, { as: Link, href: downloadHref, download: label, size: "sm", colorScheme: "primary", leftIcon: _jsx(Download, { size: 16, "aria-hidden": true }), "data-testid": downloadTestId !== null && downloadTestId !== void 0 ? downloadTestId : (testId ? `${testId}-download` : undefined), children: downloadLabel })) : null] }));
+};
+export default MediaStatusPanel;

package/dist/esm/Components/MediaViewer/components/MediaStatusPanelProps.js

@@ -0,0 +1 @@
+export {};