@orz/ui-content 0.0.0-stage → 0.0.0

package/dist/attachment/media-player.js

@@ -0,0 +1,137 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MediaControls } from "@orz/ui/components/media-controls";
+import { cn } from "@orz/ui/lib/utils";
+import { Play } from "lucide-react";
+import { useCallback, useEffect, useRef, useState, } from "react";
+import { useMedia } from "./use-media.js";
+/** A video under the shared control bar, with picture-in-picture and fullscreen where the browser offers them. */
+export function VideoPlayer(props) {
+    // A different file starts over: no position, no error, to carry.
+    return _jsx(MediaFrame, { kind: "video", ...props }, props.src);
+}
+/** An audio file as a header over the shared control bar; the element itself is not drawn. */
+export function AudioPlayer(props) {
+    return _jsx(MediaFrame, { kind: "audio", ...props }, props.src);
+}
+const SEEK_STEP = 5;
+/** Keys a focused control already acts on, which the frame leaves to it. */
+const SLIDER_KEYS = new Set([
+    "ArrowLeft",
+    "ArrowRight",
+    "ArrowUp",
+    "ArrowDown",
+    "Home",
+    "End",
+    "PageUp",
+    "PageDown",
+]);
+const BUTTON_KEYS = new Set([" ", "Enter"]);
+function ownsKey(target, key) {
+    if (!(target instanceof Element))
+        return false;
+    if (target.closest("input, textarea, [role=combobox], [role=listbox], [role=option]") !== null) {
+        return true;
+    }
+    if (target.closest("[role=slider]") !== null)
+        return SLIDER_KEYS.has(key);
+    if (target.closest("button") !== null)
+        return BUTTON_KEYS.has(key);
+    return false;
+}
+const UNPLAYABLE = "This browser can't play this file.";
+function MediaFrame({ kind, src, title, header, autoPlay = false, loop = false, speed = 1, onError, className, }) {
+    const frameRef = useRef(null);
+    const [element, setElement] = useState(null);
+    const [media, actions] = useMedia(element);
+    const [fullscreen, setFullscreen] = useState(false);
+    // Read after mount, so a server render and the first client render agree.
+    const [fullscreenEnabled, setFullscreenEnabled] = useState(false);
+    const [pipEnabled, setPipEnabled] = useState(false);
+    const video = kind === "video";
+    useEffect(() => {
+        if (element === null)
+            return;
+        // A load resets playbackRate to the default, so both are set.
+        element.defaultPlaybackRate = speed;
+        element.playbackRate = speed;
+    }, [element, speed]);
+    const onErrorRef = useRef(onError);
+    onErrorRef.current = onError;
+    useEffect(() => {
+        if (media.failed)
+            onErrorRef.current?.(media.error);
+    }, [media.failed, media.error]);
+    useEffect(() => {
+        if (!video)
+            return;
+        setFullscreenEnabled(document.fullscreenEnabled === true);
+        setPipEnabled(document.pictureInPictureEnabled === true);
+        const onChange = () => setFullscreen(document.fullscreenElement !== null &&
+            document.fullscreenElement === frameRef.current);
+        document.addEventListener("fullscreenchange", onChange);
+        return () => document.removeEventListener("fullscreenchange", onChange);
+    }, [video]);
+    const toggleFullscreen = useCallback(() => {
+        const frame = frameRef.current;
+        if (frame === null || !document.fullscreenEnabled)
+            return;
+        // Refused when the call lacks a user gesture, say; the frame just stays as
+        // it is.
+        const ignore = () => { };
+        if (document.fullscreenElement === frame) {
+            document.exitFullscreen().catch(ignore);
+        }
+        else {
+            frame.requestFullscreen().catch(ignore);
+        }
+    }, []);
+    const known = Number.isFinite(media.duration);
+    const seekBy = (delta) => {
+        const to = Math.max(0, media.time + delta);
+        actions.seek(known ? Math.min(to, media.duration) : to);
+    };
+    const onKeyDown = (event) => {
+        if (event.altKey || event.metaKey || event.ctrlKey)
+            return;
+        if (event.defaultPrevented || ownsKey(event.target, event.key))
+            return;
+        const key = event.key;
+        if (key === " " || key === "k")
+            actions.toggle();
+        else if (key === "ArrowLeft")
+            seekBy(-SEEK_STEP);
+        else if (key === "ArrowRight")
+            seekBy(SEEK_STEP);
+        else if (/^[0-9]$/.test(key) && known) {
+            actions.seek((Number(key) / 10) * media.duration);
+        }
+        else if (key === "m")
+            actions.mute();
+        else if (key === "f" && video && fullscreenEnabled)
+            toggleFullscreen();
+        else
+            return;
+        event.preventDefault();
+    };
+    if (media.failed && onError !== undefined)
+        return null;
+    const unplayable = (_jsx("p", { "data-slot": "media-error", className: "px-3 py-4 text-center text-muted-foreground text-sm", children: UNPLAYABLE }));
+    const controls = (_jsx(MediaControls, { playing: media.playing, time: media.time, duration: media.duration, speed: media.speed, buffered: media.buffered, disabled: element === null || media.failed, portal: fullscreen ? frameRef.current : undefined, onToggle: actions.toggle, onSeek: actions.seek, onSpeed: actions.setSpeed, volume: {
+            level: media.level,
+            muted: media.muted,
+            onLevel: actions.setLevel,
+            onMute: actions.mute,
+        }, fullscreen: video && fullscreenEnabled
+            ? { active: fullscreen, onToggle: toggleFullscreen }
+            : undefined, pictureInPicture: video && pipEnabled
+            ? { active: media.pip, onToggle: actions.togglePip }
+            : undefined, className: cn(!video && "border-t-0") }));
+    return (_jsxs("div", { ref: frameRef, "data-slot": video ? "video-player" : "audio-player", title: title, className: cn("overflow-hidden rounded-lg border [&:fullscreen]:rounded-none [&:fullscreen]:border-0", video ? "bg-black" : "bg-card", fullscreen && "flex flex-col", className), onKeyDown: onKeyDown, children: [header, video ? (_jsx("section", { "data-slot": "media-screen", 
+                // biome-ignore lint/a11y/noNoninteractiveTabindex: the picture is where the keyboard shortcuts start, as a native video's is
+                tabIndex: 0, "aria-label": title, className: cn("relative outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset", fullscreen && "min-h-0 flex-1"), children: media.failed ? (unplayable) : (_jsxs(_Fragment, { children: [_jsx("video", { ref: setElement, src: src, 
+                            // A page of embeds must not download every file.
+                            preload: "metadata", playsInline: true, autoPlay: autoPlay, loop: loop, className: cn("block w-full object-contain", fullscreen && "h-full"), onClick: actions.toggle }), !media.started && element !== null && (_jsx("button", { type: "button", "aria-label": "Play video", 
+                            // The bar's play button is the keyboard's way in.
+                            tabIndex: -1, className: "absolute inset-0 grid cursor-pointer place-items-center bg-black/40 outline-none", onClick: actions.toggle, children: _jsx("span", { className: "grid size-14 place-items-center rounded-full bg-white/85 text-black shadow-md", children: _jsx(Play, { className: "size-6 translate-x-0.5 fill-current" }) }) }))] })) })) : (_jsx("audio", { ref: setElement, src: src, preload: "metadata", autoPlay: autoPlay, loop: loop, "aria-label": title, className: "hidden" })), !video && media.failed ? unplayable : controls] }));
+}
+//# sourceMappingURL=media-player.js.map

package/dist/attachment/media-player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-player.js","sourceRoot":"","sources":["../../src/attachment/media-player.tsx"],"names":[],"mappings":"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"}

package/dist/attachment/use-media.d.ts

@@ -0,0 +1,27 @@
+export type MediaState = {
+    playing: boolean;
+    /** Played, or seeked, at least once: the poster overlay is gone. */
+    started: boolean;
+    time: number;
+    /** Seconds; NaN before the metadata, Infinity for a stream or an unfinished recording. */
+    duration: number;
+    buffered: [start: number, end: number][];
+    level: number;
+    muted: boolean;
+    speed: number;
+    pip: boolean;
+    /** The element failed to load or decode its source. */
+    failed: boolean;
+    error: MediaError | null;
+};
+export type MediaActions = {
+    toggle(): void;
+    seek(time: number): void;
+    setLevel(level: number): void;
+    mute(): void;
+    setSpeed(speed: number): void;
+    togglePip(): void;
+};
+/** The control bar's values, read from a media element's events, and the actions on it. */
+export declare function useMedia(element: HTMLMediaElement | null): [MediaState, MediaActions];
+//# sourceMappingURL=use-media.d.ts.map

package/dist/attachment/use-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media.d.ts","sourceRoot":"","sources":["../../src/attachment/use-media.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,IAAI,IAAI,CAAC;CACnB,CAAC;AA2CF,2FAA2F;AAC3F,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC/B,CAAC,UAAU,EAAE,YAAY,CAAC,CA6F5B"}

package/dist/attachment/use-media.js

@@ -0,0 +1,133 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+const INITIAL = {
+    playing: false,
+    started: false,
+    time: 0,
+    duration: Number.NaN,
+    buffered: [],
+    level: 1,
+    muted: false,
+    speed: 1,
+    pip: false,
+    failed: false,
+    error: null,
+};
+const EVENTS = [
+    "play",
+    "pause",
+    "ended",
+    "timeupdate",
+    "seeked",
+    "loadedmetadata",
+    "durationchange",
+    "progress",
+    "volumechange",
+    "ratechange",
+    "enterpictureinpicture",
+    "leavepictureinpicture",
+];
+/** A refused play() or picture-in-picture request (autoplay policy, an aborted load) changes nothing. */
+const ignore = () => { };
+function rangesOf(ranges) {
+    const pairs = [];
+    if (ranges === undefined)
+        return pairs;
+    for (let i = 0; i < ranges.length; i++) {
+        pairs.push([ranges.start(i), ranges.end(i)]);
+    }
+    return pairs;
+}
+/** The control bar's values, read from a media element's events, and the actions on it. */
+export function useMedia(element) {
+    const [state, setState] = useState(INITIAL);
+    const read = useCallback((media) => {
+        setState((previous) => ({
+            playing: !media.paused,
+            started: previous.started || !media.paused,
+            time: media.currentTime,
+            duration: media.duration,
+            buffered: rangesOf(media.buffered),
+            level: media.volume,
+            muted: media.muted,
+            speed: media.playbackRate,
+            pip: typeof document !== "undefined" &&
+                document.pictureInPictureElement === media,
+            failed: previous.failed,
+            error: previous.error,
+        }));
+    }, []);
+    useEffect(() => {
+        if (element === null)
+            return;
+        const onEvent = () => read(element);
+        const onError = () => setState((previous) => ({
+            ...previous,
+            playing: false,
+            failed: true,
+            error: element.error,
+        }));
+        read(element);
+        for (const name of EVENTS)
+            element.addEventListener(name, onEvent);
+        element.addEventListener("error", onError);
+        return () => {
+            for (const name of EVENTS)
+                element.removeEventListener(name, onEvent);
+            element.removeEventListener("error", onError);
+        };
+    }, [element, read]);
+    useEffect(() => {
+        if (element === null || !state.playing)
+            return;
+        // The cast bar's cadence; timeupdate alone comes about every 250 ms.
+        const interval = setInterval(() => setState((previous) => ({ ...previous, time: element.currentTime })), 100);
+        return () => clearInterval(interval);
+    }, [element, state.playing]);
+    const actions = useMemo(() => ({
+        toggle() {
+            if (element === null)
+                return;
+            if (element.paused) {
+                // Not every implementation returns the promise.
+                element.play()?.catch(ignore);
+            }
+            else {
+                element.pause();
+            }
+        },
+        seek(time) {
+            if (element === null)
+                return;
+            element.currentTime = time;
+            setState((previous) => ({ ...previous, time, started: true }));
+        },
+        setLevel(level) {
+            if (element === null)
+                return;
+            element.volume = level;
+            element.muted = false;
+        },
+        mute() {
+            if (element === null)
+                return;
+            element.muted = !element.muted;
+        },
+        setSpeed(speed) {
+            if (element === null)
+                return;
+            element.playbackRate = speed;
+        },
+        togglePip() {
+            if (!(element instanceof HTMLVideoElement))
+                return;
+            if (document.pictureInPictureElement === element) {
+                document.exitPictureInPicture().catch(ignore);
+            }
+            else {
+                element.requestPictureInPicture().catch(ignore);
+            }
+        },
+    }), [element]);
+    return [state, actions];
+}
+//# sourceMappingURL=use-media.js.map

package/dist/attachment/use-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media.js","sourceRoot":"","sources":["../../src/attachment/use-media.ts"],"names":[],"mappings":"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"}

package/dist/attachment/viewer.d.ts

@@ -0,0 +1,85 @@
+import { type ReactNode } from "react";
+import type { ContentSource } from "../types.ts";
+import { type ImageLook } from "./image-look.ts";
+export type FileSource = Extract<ContentSource, {
+    kind: "file";
+}>;
+/** What the viewer is showing: a set of files and a position in it. */
+export type AttachmentViewerState = {
+    items: FileSource[];
+    index: number;
+};
+export type AttachmentViewerControls = {
+    /** Opens the viewer on `items[index]`, paging through `items`. */
+    open(items: FileSource[], index: number): void;
+    /** Opens the viewer on one file, paging through the set `group` gives it. */
+    show(file: FileSource): void;
+};
+type ViewerImage = {
+    /** Whether the dialog fills the window. */
+    maximized: boolean;
+    look: ImageLook;
+    setLook(look: ImageLook): void;
+    /** The last image's canvas height, so the next one tweens from it. */
+    lastHeight: {
+        current: number | null;
+    };
+    /** The height the canvas keeps while the pointer is on the title-bar controls. */
+    held: number | null;
+};
+/** What the image renderer needs from the viewer around it; null outside one. */
+export declare function useViewerImage(): ViewerImage | null;
+type ImageLookProps = {
+    /** The image background and scaling, controlled. Default: held in memory by the viewer. */
+    imageLook?: ImageLook;
+    /** Called when the reader picks another background or scaling. */
+    onImageLookChange?(look: ImageLook): void;
+};
+export type AttachmentViewerProviderProps = {
+    /** Where a browser tab shows this file; undefined when it would only download. */
+    viewHref?: (file: FileSource) => string | undefined;
+    /** The set paging covers when a single file is opened; null pages nothing. */
+    group?: (file: FileSource) => AttachmentViewerState | null;
+    /**
+     * Text files above this wait for "Preview anyway" and then draw plain. Default 1 MiB. A text
+     * file of unknown size stays a link until its size is known.
+     */
+    textPreviewMaxBytes?: number;
+    /** Text files above this never preview; the viewer says so. Default 10 MiB. */
+    textPreviewHardMaxBytes?: number;
+    children?: ReactNode;
+} & ImageLookProps;
+/**
+ * Owns one viewer dialog for everything below it: link chips, inline images,
+ * list rows and document cards all open this one rather than mounting a
+ * dialog each. A nested provider shadows the outer one.
+ */
+export declare function AttachmentViewerProvider({ viewHref, group, textPreviewMaxBytes, textPreviewHardMaxBytes, imageLook, onImageLookChange, children, }: AttachmentViewerProviderProps): import("react").JSX.Element;
+/** The nearest provider's controls, or null outside one. */
+export declare function useAttachmentViewer(): AttachmentViewerControls | null;
+/** Where an anchor to this file points: the provider's `viewHref`, else the file's `url`. */
+export declare function useViewHref(file: FileSource): string;
+/**
+ * Whether the viewer has something to draw for this file, which is what
+ * decides if a plain click on it is hijacked into the viewer. Text needs a
+ * known size — a file whose size the app does not know yet stays a link
+ * until it does; a size past the limits still opens the viewer, which says
+ * why it shows nothing. HTML has no size cap: the browser streams it into
+ * the iframe instead of this tab highlighting it.
+ */
+export declare function useCanPreview(file: FileSource): boolean;
+export type AttachmentViewerProps = {
+    /** null, or an index outside `items`: closed. */
+    state: AttachmentViewerState | null;
+    onNavigate(index: number): void;
+    onClose(): void;
+} & ImageLookProps;
+/**
+ * The viewer dialog, controlled: one file at a time drawn by the registry in
+ * "viewer" placement, or a download pane when nothing can draw it. A set
+ * pages with ‹ › / arrow keys, and the controls live in the title bar, never
+ * floated over the content.
+ */
+export declare function AttachmentViewer({ state, onNavigate, onClose, imageLook, onImageLookChange, }: AttachmentViewerProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=viewer.d.ts.map

package/dist/attachment/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/attachment/viewer.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAYf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOlE,uEAAuE;AACvE,MAAM,MAAM,qBAAqB,GAAG;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,wBAAwB,GAAG;IACrC,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B,CAAC;AAUF,KAAK,WAAW,GAAG;IACjB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,sEAAsE;IACtE,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvC,kFAAkF;IAClF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAIF,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED,KAAK,cAAc,GAAG;IACpB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,iBAAiB,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,8EAA8E;IAC9E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,qBAAqB,GAAG,IAAI,CAAC;IAC3D;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,cAAc,CAAC;AAEnB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,KAAK,EACL,mBAA4C,EAC5C,uBAAqD,EACrD,SAAS,EACT,iBAAiB,EACjB,QAAQ,GACT,EAAE,6BAA6B,+BAyC/B;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,IAAI,wBAAwB,GAAG,IAAI,CAErE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGpD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAKvD;AAoKD,MAAM,MAAM,qBAAqB,GAAG;IAClC,iDAAiD;IACjD,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,IAAI,IAAI,CAAC;CACjB,GAAG,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,iBAAiB,GAClB,EAAE,qBAAqB,+BA4LvB"}