@react-x11/components 0.1.0 → 0.2.1

package/dist/media-player/index.d.ts

@@ -0,0 +1,107 @@
+import type { ReactElement, ReactNode, Ref } from 'react';
+import type { Style } from 'react-x11/style';
+import type { EmbedStatus, ExitInfo, ProcessHost } from '../embed/index.js';
+import type { MediaBackendName } from './backends.js';
+export { MEDIA_BACKENDS, mediaBackendsFor, mpv, vlc } from './backends.js';
+export type { MediaBackend, MediaBackendName, MediaLaunch, } from './backends.js';
+export type { PlayerControl, PlayerEvents } from './control.js';
+/** Where playback is. */
+export interface MediaProgress {
+    /** Seconds from the start. */
+    position: number;
+    /** Seconds, or 0 before the player knows. */
+    duration: number;
+}
+/** What a `ref` on `<MediaPlayer>` gets. */
+export interface MediaPlayerHandle {
+    play(): void;
+    pause(): void;
+    /** Absolute position, in seconds. */
+    seek(seconds: number): void;
+    /** 0–1. */
+    setVolume(volume: number): void;
+    /** Stop playback without stopping the player: the window stays, idle. */
+    stop(): void;
+    /** Stop the player process and start a new one. */
+    restart(): void;
+    signal(signal?: string): boolean;
+    readonly pid: number | null;
+    readonly windowId: number | null;
+    readonly backend: string | null;
+    readonly status: EmbedStatus;
+    /** False under VLC — see `./vlc.ts`. `onProgress` never fires then. */
+    readonly reportsProgress: boolean;
+}
+export interface MediaPlayerProps {
+    /**
+     * A path or a URL. **Changing it does not restart the player** — the new
+     * source is loaded into the running one, so the window never blinks.
+     */
+    src?: string;
+    /** Which player. Default `'auto'`: mpv if it is installed, else VLC. */
+    backend?: MediaBackendName;
+    /** Start playing. Default true. */
+    autoPlay?: boolean;
+    /**
+     * Pause state, if you want to drive it. Leave it out and the player is
+     * uncontrolled — `autoPlay` decides how it starts and the handle's
+     * `play()`/`pause()` move it from there.
+     */
+    paused?: boolean;
+    /** 0–1. Default: the player's own. */
+    volume?: number;
+    muted?: boolean;
+    /** `'16:9'`, `'4:3'`. The player letterboxes inside the element's rect. */
+    aspectRatio?: string;
+    loop?: boolean;
+    /** The player's own on-screen controls. Off by default: they are drawn by
+     *  the player and will not match the app's theme. */
+    osd?: boolean;
+    /** Appended to the player's command line verbatim. */
+    extraArgs?: readonly string[];
+    /** Position and duration, as the player reports them. mpv only. */
+    onProgress?: (progress: MediaProgress) => void;
+    /** The file reached its end. Not fired for `stop()` or a new `src`. */
+    onEnded?: (info: {
+        node: unknown;
+    }) => void;
+    onPlayingChange?: (playing: boolean) => void;
+    /** The player process ended. */
+    onExit?: (info: ExitInfo) => void;
+    /** Spawn failures, control-channel failures, and the
+     *  `BackendUnavailableError` for a machine with neither player installed. */
+    onError?: (err: Error) => void;
+    /** Rendered instead of the surface when no backend is installed. */
+    fallback?: ReactNode;
+    /** False holds off spawning entirely. */
+    enabled?: boolean;
+    /** Sent on unmount and restart. Default `SIGTERM`. */
+    stopSignal?: string;
+    /** Where the process runs. Defaults to this machine, through node. */
+    processes?: ProcessHost;
+    /** A video surface is not a control; default false, unlike `<Terminal>`. */
+    focusable?: boolean;
+    style?: Style | Style[];
+    ref?: Ref<MediaPlayerHandle>;
+    'data-testname'?: string;
+}
+/**
+ * A video surface.
+ *
+ * ```jsx
+ * <MediaPlayer
+ *   src={file}
+ *   aspectRatio="16:9"
+ *   volume={0.8}
+ *   style={{ flexGrow: 1 }}
+ *   onProgress={({ position, duration }) => setScrub(position / duration)}
+ *   onEnded={next}
+ *   fallback={<text>Install mpv to play video.</text>}
+ * />
+ * ```
+ *
+ * The player's window stacks above everything drawn in this one, so nothing 2D
+ * can overlap it — see "Controls" at the top of this file.
+ */
+export declare function MediaPlayer(props: MediaPlayerProps): ReactElement;
+//# sourceMappingURL=index.d.ts.map

package/dist/media-player/index.d.ts.map

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

package/dist/media-player/index.js

@@ -0,0 +1,219 @@
+// <MediaPlayer> — mpv or VLC, drawing into an element.
+//
+// The second XEmbed wrapper, and mechanically the same component as
+// `../terminal/`: a `<foreign>` with no `windowId` adopts whatever is put
+// inside it, the id `onReady` hands over is passed to the player as
+// `--wid=…`, and `../embed/` owns everything about starting, watching and
+// handing back the process.
+//
+// What makes it more than a surface is the control channel. mpv's JSON IPC
+// socket turns `volume`, `paused` and `seek()` into real commands and pushes
+// position back as it changes, so `src` can be swapped inside a running
+// player rather than by respawning one. `./backends.ts` is where that and
+// VLC's much narrower rc interface are reconciled.
+//
+// Registers no element: `<foreign>` is a built-in. Nothing here happens at
+// import time.
+//
+// ### Controls
+//
+// There are none drawn, on purpose. The player's window stacks above
+// everything drawn in ours — the same rule `<glarea>` has — so a transport bar
+// laid over the video cannot be a sibling `<box>`; it has to be a `<popup>`,
+// which is a placement and dismissal problem an app is better placed to solve
+// than a component is. What this exposes instead is the whole of the state a
+// transport bar needs (`onProgress`, `onPlayingChange`, the handle) plus
+// `osd` for the player's own overlay when a quick one will do.
+import React, { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { useTheme } from 'react-x11';
+import { BackendUnavailableError, resolveBackend, useEmbeddedClient, } from '../embed/index.js';
+import { mediaBackendsFor } from './backends.js';
+import { hx } from './hx.js';
+export { MEDIA_BACKENDS, mediaBackendsFor, mpv, vlc } from './backends.js';
+const h = React.createElement;
+/**
+ * A video surface.
+ *
+ * ```jsx
+ * <MediaPlayer
+ *   src={file}
+ *   aspectRatio="16:9"
+ *   volume={0.8}
+ *   style={{ flexGrow: 1 }}
+ *   onProgress={({ position, duration }) => setScrub(position / duration)}
+ *   onEnded={next}
+ *   fallback={<text>Install mpv to play video.</text>}
+ * />
+ * ```
+ *
+ * The player's window stacks above everything drawn in this one, so nothing 2D
+ * can overlap it — see "Controls" at the top of this file.
+ */
+export function MediaPlayer(props) {
+    const { backend = 'auto', enabled = true, focusable, processes, stopSignal, } = props;
+    const theme = useTheme();
+    const control = useRef(null);
+    // Bumped when a control channel opens or closes. The prop-syncing effects
+    // below depend on it, which is what makes "apply `volume` once there is
+    // something to apply it to" a dependency rather than a retry.
+    const [channel, setChannel] = useState(0);
+    // What the player was launched with, so a `src` that has not changed is not
+    // loaded a second time over the top of itself.
+    const loaded = useRef(undefined);
+    // Read through a ref so that the plan's identity — which is the restart
+    // signal — depends only on the launch key below.
+    const latest = useRef(props);
+    latest.current = props;
+    // Only the props that cannot be changed in a running player. `src`,
+    // `volume`, `muted` and `paused` are all live commands, so they are
+    // deliberately absent: including them would respawn the process for a
+    // volume slider.
+    const key = useMemo(() => JSON.stringify([
+        backend,
+        props.aspectRatio ?? null,
+        props.loop ?? false,
+        props.osd ?? false,
+        props.extraArgs ?? null,
+    ]), [backend, props.aspectRatio, props.loop, props.osd, props.extraArgs]);
+    const plan = useMemo(() => async ({ windowId, host }) => {
+        const candidates = mediaBackendsFor(backend);
+        if (candidates.length === 0) {
+            throw new BackendUnavailableError('media player', [backend]);
+        }
+        const chosen = await resolveBackend(host, 'media player', candidates);
+        const scratch = await host.socketPath(`react-x11-${chosen.backend.name}`);
+        const current = latest.current;
+        const launch = {
+            windowId,
+            controlPath: scratch.path,
+            src: current.src,
+            autoPlay: current.autoPlay ?? true,
+            volume: current.volume,
+            muted: current.muted,
+            aspectRatio: current.aspectRatio,
+            loop: current.loop,
+            osd: current.osd,
+            extraArgs: current.extraArgs,
+        };
+        return {
+            command: chosen.path,
+            args: chosen.backend.args(launch),
+            backend: chosen.backend.name,
+            async attach() {
+                const events = {
+                    onProgress: (progress) => latest.current.onProgress?.(progress),
+                    onPlayingChange: (playing) => latest.current.onPlayingChange?.(playing),
+                    onEnded: () => latest.current.onEnded?.({ node: null }),
+                    onError: (err) => latest.current.onError?.(err),
+                };
+                const opened = await chosen.backend.connect(host, scratch.path, events, launch);
+                control.current = opened;
+                loaded.current = launch.src;
+                setChannel((n) => n + 1);
+                return () => {
+                    control.current = null;
+                    loaded.current = undefined;
+                    opened.dispose();
+                    setChannel((n) => n + 1);
+                };
+            },
+            dispose: () => scratch.dispose(),
+        };
+    }, [backend, key]);
+    const client = useEmbeddedClient({
+        plan,
+        host: processes,
+        enabled,
+        stopSignal,
+        onExit: props.onExit,
+        onError: props.onError,
+    });
+    // --- props the control channel applies to a running player ---------------
+    const { src, volume, muted, paused } = props;
+    useEffect(() => {
+        if (!control.current || src === undefined)
+            return;
+        if (src === loaded.current)
+            return;
+        loaded.current = src;
+        control.current.load(src);
+    }, [src, channel]);
+    useEffect(() => {
+        if (!control.current || volume === undefined)
+            return;
+        control.current.setVolume(volume);
+    }, [volume, channel]);
+    useEffect(() => {
+        if (!control.current || muted === undefined)
+            return;
+        control.current.setMuted(muted);
+    }, [muted, channel]);
+    useEffect(() => {
+        if (!control.current || paused === undefined)
+            return;
+        control.current.setPaused(paused);
+    }, [paused, channel]);
+    // --- the handle ---------------------------------------------------------
+    const reportsProgress = useMemo(() => {
+        const [chosen] = mediaBackendsFor(backend).filter((b) => b.name === client.backend);
+        return chosen?.reportsProgress ?? false;
+    }, [backend, client.backend]);
+    const noop = useCallback(() => { }, []);
+    React.useImperativeHandle(props.ref, () => ({
+        play: () => control.current?.setPaused(false) ?? noop(),
+        pause: () => control.current?.setPaused(true) ?? noop(),
+        seek: (seconds) => control.current?.seek(seconds) ?? noop(),
+        setVolume: (value) => control.current?.setVolume(value) ?? noop(),
+        stop: () => control.current?.stop() ?? noop(),
+        restart: client.restart,
+        signal: client.signal,
+        get pid() {
+            return client.pid;
+        },
+        get windowId() {
+            return client.windowId;
+        },
+        get backend() {
+            return client.backend;
+        },
+        get status() {
+            return client.status;
+        },
+        get reportsProgress() {
+            return reportsProgress;
+        },
+    }), [client, noop, reportsProgress]);
+    // Black rather than the theme background: this is a video surface, and what
+    // shows around a letterboxed frame should be what a player would put there.
+    const style = {
+        flexGrow: 1,
+        backgroundColor: String(theme.videoBackground ?? '#000000'),
+    };
+    const styles = [style];
+    if (props.style) {
+        for (const extra of Array.isArray(props.style)
+            ? props.style
+            : [props.style]) {
+            styles.push(extra);
+        }
+    }
+    if (client.status === 'unavailable' && props.fallback !== undefined) {
+        return h(React.Fragment, null, props.fallback);
+    }
+    const foreign = {
+        onReady: client.handleReady,
+        // A video surface is not something to tab to, and an embedded player that
+        // took the focus would swallow the app's own keys while the pointer is
+        // over it.
+        focusable: focusable ?? false,
+        'aria-label': 'Media player',
+        style: styles,
+    };
+    // See the same note in `../terminal/index.ts`: `data-testname` is a runtime
+    // convention react-x11's element declarations do not carry.
+    return hx('foreign', {
+        ...foreign,
+        'data-testname': props['data-testname'],
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/media-player/mpv.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessHost } from '../embed/index.js';
+import type { PlayerControl, PlayerEvents } from './control.js';
+export declare function connectMpv(host: ProcessHost, socketPath: string, events: PlayerEvents): Promise<PlayerControl>;
+//# sourceMappingURL=mpv.d.ts.map

package/dist/media-player/mpv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpv.d.ts","sourceRoot":"","sources":["../../src/media-player/mpv.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAuBhE,wBAAsB,UAAU,CAC9B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAoGxB"}

package/dist/media-player/mpv.js

@@ -0,0 +1,120 @@
+// mpv's JSON IPC, which is what makes `<MediaPlayer>`'s props real control
+// rather than decoration.
+//
+// `--input-ipc-server=PATH` gives a unix socket that speaks newline-delimited
+// JSON in both directions: `{"command":[…]}` out, `{"event":…}` and
+// `{"request_id":…}` back. Two things it buys that a command line cannot:
+//
+//  - **`observe_property`.** Position, duration, pause state and volume are
+//    pushed as they change, so `onProgress` is an event rather than a poll.
+//  - **`loadfile … replace`.** A new `src` swaps the file inside the running
+//    player, so the embedded window never blinks and the process never has to
+//    be respawned.
+//
+// The socket is created by mpv some milliseconds *after* it starts, which is
+// what `connectWhenReady` in `../embed/host.ts` is for.
+import { connectWhenReady } from '../embed/index.js';
+import { lineReader, unitRange } from './control.js';
+/** Observation ids. mpv echoes them back on every property-change, and they
+ *  are ours to choose. */
+const OBSERVE = {
+    position: 1,
+    duration: 2,
+    pause: 3,
+};
+/** mpv's volume is a percentage and goes above 100 (`--volume-max`); the prop
+ *  is 0–1, so this is the whole of the conversion. */
+const VOLUME_SCALE = 100;
+export async function connectMpv(host, socketPath, events) {
+    const socket = await connectWhenReady(host, socketPath);
+    let position = 0;
+    let duration = 0;
+    let disposed = false;
+    const send = (command) => {
+        if (disposed)
+            return;
+        socket.write(`${JSON.stringify({ command })}\n`);
+    };
+    const observe = (id, property) => {
+        send(['observe_property', id, property]);
+    };
+    socket.onData(lineReader((line) => {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            // mpv only ever writes JSON here; a line that is not is a version
+            // saying something we do not understand, and dropping it is right.
+            return;
+        }
+        if (message.event === 'property-change') {
+            if (message.id === OBSERVE.position &&
+                typeof message.data === 'number') {
+                position = message.data;
+                events.onProgress?.({ position, duration });
+            }
+            else if (message.id === OBSERVE.duration &&
+                typeof message.data === 'number') {
+                duration = message.data;
+                events.onProgress?.({ position, duration });
+            }
+            else if (message.id === OBSERVE.pause) {
+                events.onPlayingChange?.(message.data !== true);
+            }
+            return;
+        }
+        // `end-file` fires for every way a file stops, including the ones a
+        // caller must not hear as "the video finished": `stop` is our own
+        // `stop()`, and `redirect` is a playlist indirection mid-load.
+        if (message.event === 'end-file') {
+            if (message.reason === 'eof')
+                events.onEnded?.();
+            return;
+        }
+        if (message.event === 'start-file') {
+            position = 0;
+            duration = 0;
+        }
+    }));
+    socket.onClose(() => {
+        if (disposed)
+            return;
+        disposed = true;
+        // Not an error: mpv closing its socket is mpv exiting, which the process
+        // watch in `useEmbeddedClient` reports with an exit code.
+    });
+    observe(OBSERVE.position, 'time-pos');
+    observe(OBSERVE.duration, 'duration');
+    observe(OBSERVE.pause, 'pause');
+    return {
+        reportsProgress: true,
+        load(src) {
+            // `replace` rather than `append`: the prop names what is playing, so
+            // setting it twice must not build a playlist.
+            send(['loadfile', src, 'replace']);
+        },
+        setPaused(paused) {
+            send(['set_property', 'pause', paused]);
+        },
+        seek(seconds) {
+            if (!Number.isFinite(seconds))
+                return;
+            send(['seek', Math.max(0, seconds), 'absolute']);
+        },
+        setVolume(volume) {
+            send(['set_property', 'volume', unitRange(volume) * VOLUME_SCALE]);
+        },
+        setMuted(muted) {
+            send(['set_property', 'mute', muted]);
+        },
+        stop() {
+            send(['stop']);
+        },
+        dispose() {
+            disposed = true;
+            socket.close();
+        },
+    };
+}
+//# sourceMappingURL=mpv.js.map

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

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

package/dist/media-player/vlc.d.ts

@@ -0,0 +1,8 @@
+import type { ProcessHost } from '../embed/index.js';
+import type { PlayerControl, PlayerEvents } from './control.js';
+export interface VlcConnectOptions {
+    /** What the player was started doing, so the toggle stays in step. */
+    paused: boolean;
+}
+export declare function connectVlc(host: ProcessHost, socketPath: string, events: PlayerEvents, options: VlcConnectOptions): Promise<PlayerControl>;
+//# sourceMappingURL=vlc.d.ts.map

package/dist/media-player/vlc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlc.d.ts","sourceRoot":"","sources":["../../src/media-player/vlc.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKhE,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAyDxB"}

package/dist/media-player/vlc.js

@@ -0,0 +1,83 @@
+// VLC's rc interface, used write-only — and the asymmetry is the point.
+//
+// `--extraintf rc --rc-unix=PATH` gives a unix socket that accepts the same
+// console commands VLC's `rc` module has always accepted: `play`, `pause`,
+// `stop`, `seek N`, `volume N`, `add URI`. That is enough for every control
+// `<MediaPlayer>` exposes.
+//
+// What it is *not* enough for is `onProgress`. The replies to `get_time` and
+// `get_length` are bare numbers with a `>` prompt around them, in a stream
+// that also carries unsolicited status blocks and localised text — there is no
+// request id, so a reply cannot be matched to the question that asked for it
+// except by counting, and a dropped or extra line desynchronises the count
+// permanently. Rather than ship a parser that is wrong in a way nobody
+// notices until a progress bar lies, this backend declares
+// `reportsProgress: false` and the component reports position only under mpv.
+//
+// The other consequence of not reading: `pause` in the rc protocol *toggles*.
+// So the intended state is tracked here, seeded from `autoPlay`, and
+// `setPaused` sends a toggle only when the two disagree. That is exact as long
+// as nobody else is driving the same player, which is the case for a player
+// this component spawned.
+import { connectWhenReady } from '../embed/index.js';
+import { unitRange } from './control.js';
+/** VLC's rc `volume` takes 0–256 for 0–100%. */
+const VOLUME_SCALE = 256;
+export async function connectVlc(host, socketPath, events, options) {
+    const socket = await connectWhenReady(host, socketPath);
+    let paused = options.paused;
+    let volume = 1;
+    let disposed = false;
+    const send = (line) => {
+        if (disposed)
+            return;
+        socket.write(`${line}\n`);
+    };
+    // Read and discard. The stream has to be consumed — an unread socket
+    // eventually stops the writer — and nothing in it is parsed, for the reason
+    // in the file comment.
+    socket.onData(() => { });
+    socket.onClose(() => {
+        disposed = true;
+    });
+    return {
+        reportsProgress: false,
+        load(src) {
+            send(`add ${src}`);
+            paused = false;
+            events.onPlayingChange?.(true);
+        },
+        setPaused(next) {
+            if (next === paused)
+                return;
+            // `pause` toggles; `play` is unambiguous, so resuming uses it and only
+            // pausing needs the toggle.
+            send(next ? 'pause' : 'play');
+            paused = next;
+            events.onPlayingChange?.(!next);
+        },
+        seek(seconds) {
+            if (!Number.isFinite(seconds))
+                return;
+            send(`seek ${Math.max(0, Math.round(seconds))}`);
+        },
+        setVolume(next) {
+            volume = unitRange(next);
+            send(`volume ${Math.round(volume * VOLUME_SCALE)}`);
+        },
+        setMuted(muted) {
+            // rc has no mute: 0 and back is what the command set can express.
+            send(`volume ${muted ? 0 : Math.round(volume * VOLUME_SCALE)}`);
+        },
+        stop() {
+            send('stop');
+            paused = true;
+            events.onPlayingChange?.(false);
+        },
+        dispose() {
+            disposed = true;
+            socket.close();
+        },
+    };
+}
+//# sourceMappingURL=vlc.js.map

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

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

package/dist/richtext/index.d.ts

@@ -0,0 +1,19 @@
+import type { Ref } from 'react';
+import type { RichTextProps } from './node.js';
+export { ELEMENT as RICHTEXT_ELEMENT, registerRichText, RichTextNode, } from './node.js';
+export type { NtkApp, RichTextProps, TextLayoutLike, TextRun } from './node.js';
+export { useSelectionMenu } from './menu.js';
+export type { SelectionMenuHandlers } from './menu.js';
+export { useLinkClicks } from './links.js';
+export type { LinkHandlers } from './links.js';
+declare module 'react-x11/jsx-runtime' {
+    namespace JSX {
+        interface IntrinsicElements {
+            richtext: RichTextProps & {
+                key?: string | number;
+                ref?: Ref<unknown>;
+            };
+        }
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/richtext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM/C,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,gBAAgB,EAChB,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,QAAQ,uBAAuB,CAAC;IACrC,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YACzB,QAAQ,EAAE,aAAa,GAAG;gBAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;gBAAC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;aAAE,CAAC;SACzE;KACF;CACF"}

package/dist/richtext/index.js

@@ -0,0 +1,4 @@
+export { ELEMENT as RICHTEXT_ELEMENT, registerRichText, RichTextNode, } from './node.js';
+export { useSelectionMenu } from './menu.js';
+export { useLinkClicks } from './links.js';
+//# sourceMappingURL=index.js.map

package/dist/richtext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,gBAAgB,EAChB,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/richtext/links.d.ts

@@ -0,0 +1,12 @@
+import type { DrawnNode, MouseEvent as X11MouseEvent } from 'react-x11';
+export interface LinkHandlers {
+    onMouseDown: (ev: X11MouseEvent<DrawnNode>) => void;
+    onMouseUp: (ev: X11MouseEvent<DrawnNode>) => void;
+}
+/**
+ * Mouse handlers for a document root that follows links. Returns handlers
+ * that do nothing when `onLink` is absent — the component never navigates by
+ * itself, and a document with no handler simply has inert link text.
+ */
+export declare function useLinkClicks(onLink?: (href: string, ev: X11MouseEvent<DrawnNode>) => void): LinkHandlers;
+//# sourceMappingURL=links.d.ts.map

package/dist/richtext/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/richtext/links.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAWxE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACpD,SAAS,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,GAC5D,YAAY,CA6Bd"}