@react-x11/components 0.1.0 → 0.2.1

package/dist/terminal-output/index.d.ts

@@ -0,0 +1,92 @@
+import type { ReactElement } from 'react';
+import type { DrawnNode, MouseEvent as X11MouseEvent } from 'react-x11';
+import type { Style } from 'react-x11/style';
+import type { AnsiDocument, AnsiInput, AnsiPaletteOptions } from '../ansi/index.js';
+/** What `data` accepts on top of raw bytes: a document parsed elsewhere. */
+export type TerminalOutputSource = AnsiInput | AnsiDocument;
+export interface TerminalOutputProps {
+    /**
+     * The capture.
+     *
+     * **Bytes are preferred over a string.** A `.toString()` on whatever
+     * boundary a reader chose cuts a multi-byte character in half, and no care
+     * downstream repairs it — the same rule `PtyHost.onData` carries for the
+     * live terminal. A `Uint8Array` (a node `Buffer` is one) is decoded across
+     * chunk boundaries, so passing an array of them is safe.
+     *
+     * An **array** is also the incremental path: when it grows and its existing
+     * elements keep their identity, only the new ones are parsed. A growing
+     * *string* is handled too, by prefix, which is cheaper than re-parsing but
+     * not free — push chunks into an array for a live tail.
+     *
+     * An `AnsiDocument` is taken as-is, for an app that parsed off the render
+     * path or is scrubbing a recording.
+     */
+    data: TerminalOutputSource;
+    /**
+     * Which renderer. `'auto'` (the default) and `'flow'` are the same today:
+     * the capture is rendered as a document of styled spans.
+     *
+     * `'screen'` — a real cell grid, for a capture that addressed the cursor —
+     * joins this union in phase 2, at which point `'auto'` starts following the
+     * bytes. Pin `'flow'` if a log should stay a document whatever it contains.
+     */
+    mode?: 'auto' | 'flow';
+    /**
+     * The palette. `<Terminal>`'s `colors` minus `cursor`, which a static
+     * render has no use for — the same object works for both.
+     *
+     * By default the ink is the theme's text colour and the block wears the
+     * same faint tint a `<Code>` block does, so a log sits in a page rather
+     * than punching a dark rectangle into it. Pass `background` and
+     * `foreground` to get a terminal pane instead.
+     */
+    colors?: AnsiPaletteOptions;
+    /** Default 8, the terminal's. */
+    tabWidth?: number;
+    /** Keep only the last N lines. Unbounded by default: the app read the
+     *  file, so the app decided how big it is. */
+    maxLines?: number;
+    /** Wrap long lines instead of scrolling horizontally. Default false —
+     *  a terminal's lines are the length they are. */
+    wrap?: boolean;
+    /** A line-number gutter. Numbers are not part of the selection, so a
+     *  copied log pastes clean. Ignored when `wrap` is on, for the reason
+     *  `<Code>` ignores it: a wrapped line puts the numbering out of register. */
+    lineNumbers?: boolean;
+    /** Mouse selection, Ctrl+A / Ctrl+C, PRIMARY. Default true. */
+    selectable?: boolean;
+    /** Selection band fill. Default: the theme accent at 35% opacity. */
+    selectionColor?: string;
+    /** Default: 0.9 × the theme `fontSize`, matching `<Code>` and
+     *  `<Markdown>`'s fenced blocks. */
+    fontSize?: number;
+    /** Default `'monospace'` — there is no theme token for it, and a capture
+     *  was made in a monospace font whatever the app is set in. */
+    monoFamily?: string;
+    /** An OSC 8 hyperlink was clicked. Without a handler the link text is
+     *  styled and inert; this component never opens anything by itself. */
+    onLink?: (href: string, ev: X11MouseEvent<DrawnNode>) => void;
+    /**
+     * The parse, whenever it changes.
+     *
+     * This is where a capture reports what it could not say in a document:
+     * `needsScreen` is true when the bytes addressed the cursor, entered the
+     * alternate screen or scrolled a region, and `dropped` names every sequence
+     * that went unhonoured with a count. `title` is the OSC 0/2 title, which is
+     * usually what a tab should be called.
+     */
+    onDocument?: (document: AnsiDocument) => void;
+    /** The root `<box>`'s style — width, margins, `flexGrow`. */
+    style?: Style | Style[];
+    'data-testname'?: string;
+}
+/**
+ * A captured terminal session.
+ *
+ * ```jsx
+ * <TerminalOutput data={log} lineNumbers />
+ * ```
+ */
+export declare function TerminalOutput(props: TerminalOutputProps): ReactElement;
+//# sourceMappingURL=index.d.ts.map

package/dist/terminal-output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal-output/index.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAsB1B,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;kDAC8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;sDACkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;kFAE8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;wCACoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;mEAC+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;2EACuE;IACvE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC9D;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA8HvE"}

package/dist/terminal-output/index.js

@@ -0,0 +1,179 @@
+// <TerminalOutput> — a captured terminal session, rendered.
+//
+// The static, read-only sibling of `<Terminal>`, exactly as `<Code>` is the
+// static sibling of `<CodeEditor>`: bytes a program wrote to a pty go in, and
+// what the terminal would have drawn comes out. No pty, no process, no input,
+// no `write()` — there is nothing on the other end to write to.
+//
+// The composition is `<Code>`'s: one `<richtext>` for the whole capture in a
+// horizontally scrolling viewport, plus an optional line-number gutter, all
+// inside a `selectable` root. Selection, copy, Ctrl+A and PRIMARY are core's
+// since react-x11#291; what is left here is saying which parts are chrome, so
+// the gutter is `selectable={false}` and a copied log carries no numbering.
+//
+// Registers no element of its own — `<richtext>` is the shared module's, and
+// this calls `registerRichText()` at module scope the way every component
+// that draws one does.
+//
+// **Why a log is a document rather than a grid** is the design decision
+// behind the whole thing, and it is in `docs/prd-terminal-output.md` along
+// with what this model can and cannot represent. The short version: a build
+// log has lines, not rows, and no column count of its own, so rendering it on
+// a grid means inventing a `cols` the capture never had and then wrapping at
+// it. A capture that genuinely wanted a screen says so — `needsScreen` on the
+// document `onDocument` hands over — and rendering *that* is phase 2.
+import React from 'react';
+import { useTheme } from 'react-x11';
+import { ansiPalette, parseAnsi } from '../ansi/index.js';
+import { registerRichText, RICHTEXT_ELEMENT, useLinkClicks, useSelectionMenu, } from '../richtext/index.js';
+import { codeBlockLook, codeBlockStyle, codeTextStyle, } from '../codeblock/index.js';
+import { documentRuns } from './runs.js';
+import { hx } from './hx.js';
+const h = React.createElement;
+// The shared-module registration, at this component's own module scope — see
+// the note in `../richtext/node.ts`.
+registerRichText();
+function isDocument(source) {
+    return (typeof source === 'object' &&
+        source !== null &&
+        !(source instanceof Uint8Array) &&
+        !Array.isArray(source) &&
+        'lines' in source);
+}
+/** How far into a new value the append check will look before giving up and
+ *  re-parsing. A prefix compare is a memcmp and a parse is not, but neither
+ *  is free, and past this the array form is the answer. */
+const MAX_PREFIX_SCAN = 8 * 1024 * 1024;
+/**
+ * Parse `data`, continuing the previous parse where the new value extends it.
+ *
+ * The two extendable shapes are the two ways a capture grows: an array whose
+ * earlier chunks kept their identity, and a string the app appended to. Both
+ * resume from the held reducer state, so a partial escape sequence or a
+ * half-arrived UTF-8 character at the boundary is carried rather than mangled
+ * — the same rule `<Markdown>` follows for an unterminated tail.
+ */
+function parseIncremental(data, previous, options) {
+    if (isDocument(data))
+        return data;
+    const before = previous?.source;
+    if (Array.isArray(data) &&
+        Array.isArray(before) &&
+        before.length < data.length) {
+        let shared = true;
+        for (let i = 0; i < before.length; i++) {
+            if (before[i] !== data[i]) {
+                shared = false;
+                break;
+            }
+        }
+        if (shared) {
+            return parseAnsi(data.slice(before.length), { from: previous.document });
+        }
+    }
+    if (typeof data === 'string' &&
+        typeof before === 'string' &&
+        before.length > 0 &&
+        before.length < data.length &&
+        before.length <= MAX_PREFIX_SCAN &&
+        data.startsWith(before)) {
+        return parseAnsi(data.slice(before.length), { from: previous.document });
+    }
+    return parseAnsi(data, options);
+}
+/**
+ * A captured terminal session.
+ *
+ * ```jsx
+ * <TerminalOutput data={log} lineNumbers />
+ * ```
+ */
+export function TerminalOutput(props) {
+    const { data, colors, tabWidth, maxLines, wrap = false, selectable = true, selectionColor, onDocument, } = props;
+    const lineNumbers = (props.lineNumbers ?? false) && !wrap;
+    // `Theme` is an interface, so it has no implicit index signature — the same
+    // widening `hx.ts` documents for the `theme` prop.
+    const theme = useTheme();
+    const menu = useSelectionMenu(selectable);
+    const links = useLinkClicks(props.onLink);
+    const cache = React.useRef(null);
+    const document = React.useMemo(() => {
+        const parsed = parseIncremental(data, cache.current, {
+            tabWidth,
+            maxLines,
+        });
+        cache.current = { source: data, document: parsed };
+        return parsed;
+    }, [data, tabWidth, maxLines]);
+    // Reported off the render, and only when it changed: `dropped` and
+    // `needsScreen` are what an app builds a "this recording wanted a screen"
+    // notice out of, and a notice that re-fires every paint is a notice
+    // nobody keeps.
+    const report = React.useRef(onDocument);
+    report.current = onDocument;
+    React.useEffect(() => {
+        report.current?.(document);
+    }, [document]);
+    const look = React.useMemo(() => codeBlockLook(theme, {
+        fontSize: props.fontSize,
+        monoFamily: props.monoFamily,
+    }), [theme, props.fontSize, props.monoFamily]);
+    // The colour maths (dim, inverse, conceal) resolves against the *page*
+    // rather than against the block's tint: the tint is translucent, and an
+    // inverted run should read as a hole in the page, which is what it is.
+    const palette = React.useMemo(() => ansiPalette({
+        ...colors,
+        foreground: colors?.foreground ?? look.color,
+        background: colors?.background ?? String(theme.background ?? '#ffffff'),
+    }), [colors, look.color, theme.background]);
+    const runs = React.useMemo(() => documentRuns(document, { family: look.family, size: look.size }, palette), [document, look.family, look.size, palette]);
+    const outputProps = { runs, style: codeTextStyle(look) };
+    if (!wrap)
+        outputProps.wrap = false;
+    const lineCount = document.lines.length;
+    const gutter = lineNumbers
+        ? h(RICHTEXT_ELEMENT, {
+            // One richtext for all the numbers: same font, same line height, so
+            // it stays in register with the output beside it. `selectable={false}`
+            // is what keeps it out of a drag and out of the copied text.
+            selectable: false,
+            runs: Array.from({ length: lineCount }, (_, i) => ({
+                text: i === lineCount - 1 ? `${i + 1}` : `${i + 1}\n`,
+                family: look.family,
+                size: look.size,
+                color: look.dim,
+            })),
+            wrap: false,
+            style: {
+                lineHeight: look.lineHeight,
+                textAlign: 'right',
+                minWidth: Math.max(String(lineCount).length, 2) * Math.ceil(look.size * 0.62),
+                marginRight: look.padding,
+                flexShrink: 0,
+            },
+        })
+        : null;
+    const rootStyle = {
+        ...codeBlockStyle(look),
+        ...(colors?.background ? { backgroundColor: colors.background } : null),
+        flexDirection: 'row',
+        alignItems: 'stretch',
+    };
+    return hx('box', {
+        style: props.style
+            ? [
+                rootStyle,
+                ...(Array.isArray(props.style) ? props.style : [props.style]),
+            ]
+            : rootStyle,
+        // The whole feature: a drag selects across everything below, a double
+        // click takes a word, Ctrl+C copies, PRIMARY follows the release.
+        selectable,
+        selectionColor,
+        'aria-label': 'Terminal output',
+        ...menu,
+        ...links,
+        'data-testname': props['data-testname'],
+    }, gutter, hx('box', { style: { overflow: 'scroll', flexDirection: 'column', flexGrow: 1 } }, h(RICHTEXT_ELEMENT, outputProps)));
+}
+//# sourceMappingURL=index.js.map

package/dist/terminal-output/index.js.map

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

package/dist/terminal-output/runs.d.ts

@@ -0,0 +1,27 @@
+import type { AnsiDocument, AnsiPalette, AnsiSpan } from '../ansi/index.js';
+import type { TextRun } from '../richtext/index.js';
+/** The font a capture is set in. The palette is separate because it changes
+ *  for a different reason — a theme flip rather than a size prop. */
+export interface OutputFont {
+    family: string;
+    size: number;
+}
+/**
+ * One span as one run.
+ *
+ * `bgFill: 'line'` is the whole reason `../richtext/` grew the field: a
+ * terminal's backgrounds have to abut exactly and fill the row, where an
+ * inline-code chip is inset and padded. Adjacent runs with the chip fill
+ * overlap by two pixels each side, which paints over the neighbour.
+ */
+export declare function spanRun(span: AnsiSpan, font: OutputFont, palette: AnsiPalette): TextRun;
+/**
+ * The whole document as runs, which concatenate to exactly its text.
+ *
+ * The newline between two lines is a run of its own rather than the tail of
+ * the line before it: a line that ends in a coloured background would
+ * otherwise paint that colour across the line break, which is a stripe the
+ * terminal never drew.
+ */
+export declare function documentRuns(document: AnsiDocument, font: OutputFont, palette: AnsiPalette): TextRun[];
+//# sourceMappingURL=runs.d.ts.map

package/dist/terminal-output/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/terminal-output/runs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;qEACqE;AACrE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAuBT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,EAAE,CAYX"}

package/dist/terminal-output/runs.js

@@ -0,0 +1,66 @@
+// A parsed capture, as `<richtext>` runs. Pure — no React, no theme lookup,
+// no element — so what a span becomes is asserted directly.
+//
+// This is the second half of the "colour is intent, not pixels" split: the
+// parser said "ANSI 2", `../ansi/palette.ts` said which pixels that is, and
+// here it becomes a run the text layout can take.
+import { resolveAnsiColors } from '../ansi/index.js';
+/**
+ * One span as one run.
+ *
+ * `bgFill: 'line'` is the whole reason `../richtext/` grew the field: a
+ * terminal's backgrounds have to abut exactly and fill the row, where an
+ * inline-code chip is inset and padded. Adjacent runs with the chip fill
+ * overlap by two pixels each side, which paints over the neighbour.
+ */
+export function spanRun(span, font, palette) {
+    const { fg, bg } = resolveAnsiColors(span, palette);
+    const run = {
+        text: span.text,
+        family: font.family,
+        size: font.size,
+        color: fg,
+    };
+    if (bg !== undefined) {
+        run.bg = bg;
+        run.bgFill = 'line';
+    }
+    if (span.bold)
+        run.weight = 'bold';
+    if (span.italic)
+        run.style = 'italic';
+    if (span.underline) {
+        run.underline = span.underlineColor
+            ? resolveAnsiColors({ fg: span.underlineColor }, palette).fg
+            : fg;
+        run.underlineStyle = span.underline;
+    }
+    if (span.strike)
+        run.strike = fg;
+    if (span.href)
+        run.href = span.href;
+    return run;
+}
+/**
+ * The whole document as runs, which concatenate to exactly its text.
+ *
+ * The newline between two lines is a run of its own rather than the tail of
+ * the line before it: a line that ends in a coloured background would
+ * otherwise paint that colour across the line break, which is a stripe the
+ * terminal never drew.
+ */
+export function documentRuns(document, font, palette) {
+    const runs = [];
+    const { lines } = document;
+    for (let i = 0; i < lines.length; i++) {
+        for (const span of lines[i].spans) {
+            if (span.text)
+                runs.push(spanRun(span, font, palette));
+        }
+        if (i < lines.length - 1) {
+            runs.push({ text: '\n', family: font.family, size: font.size });
+        }
+    }
+    return runs;
+}
+//# sourceMappingURL=runs.js.map

package/dist/terminal-output/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/terminal-output/runs.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4DAA4D;AAC5D,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,kDAAkD;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWrD;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,IAAc,EACd,IAAgB,EAChB,OAAoB;IAEpB,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,GAAG,GAAY;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,EAAE;KACV,CAAC;IACF,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;QACZ,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC;IACtC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc;YACjC,CAAC,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE;YAC5D,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAsB,EACtB,IAAgB,EAChB,OAAoB;IAEpB,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/three/canvas.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from 'react';
+import type { ReactX11Elements } from 'react-x11';
+import type { RootState } from './store.js';
+import { type ThreeEvent } from './events.js';
+type GlAreaProps = ReactX11Elements['glarea'];
+export interface CanvasProps {
+    children?: ReactNode;
+    /** Layout, as any drawn element takes it. */
+    style?: GlAreaProps['style'];
+    /**
+     * Partial settings for the default camera, r3f-shaped:
+     * `{ position: [3, 3, 6], fov: 50, near, far, zoom, up, target }`.
+     * A `<perspectiveCamera makeDefault>` in the scene replaces it wholesale.
+     */
+    camera?: Record<string, unknown>;
+    /** An orthographic default camera instead of the perspective one. */
+    orthographic?: boolean;
+    /**
+     * `'demand'` (the default): render when something changed — a commit, a
+     * resize, an expose, or `invalidate()`. Subscribing to `useFrame` makes
+     * the surface animate, so ported r3f components move without asking.
+     * `'always'` runs the clock continuously; `'never'` renders only on
+     * `invalidate()`. (r3f defaults to `'always'`; a desktop toolkit is the
+     * one place that default wastes a battery, so it is opt-in here.)
+     */
+    frameloop?: 'always' | 'demand' | 'never';
+    /** CSS colour or `[r, g, b, a]` floats (default black). A
+     * `<color attach="background" />` in the scene wins over this. */
+    clearColor?: GlAreaProps['clearColor'];
+    /** Visual spec for the GL window, e.g. `{ DEPTH_SIZE: 24 }`. */
+    glx?: GlAreaProps['glx'];
+    /** Shown in place of the surface when this connection has no GL at all —
+     * an element, or a function of the error (whose `code` says why). */
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    /** Runs once the context exists, with the full root state. */
+    onCreated?: (state: RootState) => void;
+    /** A press that hit no object. */
+    onPointerMissed?: (event: ThreeEvent) => void;
+    onError?: (error: Error) => void;
+    /** Raw GL after the scene draws — the escape hatch `<glarea onDraw>` is.
+     * Branch on `gl.backend`: camelCase ES 2 against PascalCase GL 1.x. */
+    onDraw?: GlAreaProps['onDraw'];
+}
+export declare function Canvas({ children, style, camera, orthographic, frameloop, clearColor, glx, fallback, onCreated, onPointerMissed, onError, onDraw, }: CanvasProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export {};
+//# sourceMappingURL=canvas.d.ts.map

package/dist/three/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/three/canvas.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAO,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAalD,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAKxD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAiB5D,KAAK,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAgB9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1C;sEACkE;IAClE,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,gEAAgE;IAChE,GAAG,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACzB;yEACqE;IACrE,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC;IACrD,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACvC,kCAAkC;IAClC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;2EACuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;CAChC;AAmBD,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,MAAM,EACN,YAAoB,EACpB,SAAoB,EACpB,UAAU,EACV,GAAG,EACH,QAAQ,EACR,SAAS,EACT,eAAe,EACf,OAAO,EACP,MAAM,GACP,EAAE,WAAW,8FAgTb"}