@react-x11/components 0.1.0 → 0.2.1

package/dist/internal/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAEpE,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,UAAU,CAQtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAIxD"}

package/dist/internal/timers.js

@@ -0,0 +1,22 @@
+const g = globalThis;
+/** Run `fn` after the layout pass this commit will cause. */
+export function afterLayout(fn) {
+    // `setImmediate` is the check-phase callback, which runs after the frame
+    // work node has already queued. `setTimeout(0)` is the fallback for a host
+    // that has no `setImmediate` — a browser-shaped global object, or a
+    // stripped-down runtime — and lands in the same place for this purpose.
+    if (g.setImmediate)
+        return { immediate: true, id: g.setImmediate(fn) };
+    if (g.setTimeout)
+        return { immediate: false, id: g.setTimeout(fn, 0) };
+    return null;
+}
+export function cancelAfterLayout(tick) {
+    if (!tick)
+        return;
+    if (tick.immediate)
+        g.clearImmediate?.(tick.id);
+    else
+        g.clearTimeout?.(tick.id);
+}
+//# sourceMappingURL=timers.js.map

package/dist/internal/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,GAAG,UAAsB,CAAC;AAIjC,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,yEAAyE;IACzE,2EAA2E;IAC3E,oEAAoE;IACpE,wEAAwE;IACxE,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,IAAI,CAAC,SAAS;QAAE,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;QAC3C,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/internal/widget.d.ts

@@ -0,0 +1,40 @@
+import type { RefObject } from 'react';
+/** The `target` a {@link WidgetChangeEvent} carries. */
+export interface ChangeTarget<T> {
+    type: string;
+    name: string | undefined;
+    value: T;
+}
+/**
+ * The change event the value widgets hand their `onChange`.
+ *
+ * One signature across react-x11's widgets, and this keeps to it so that
+ * `onChange={formik.handleChange}` works here too: a form library reads the
+ * field out of `ev.target`, and `{ type, name, value }` is exactly the shape
+ * formik's `handleChange` and react-hook-form's event reader destructure.
+ * `type` is what tells them a date from a text field, which is why it is set
+ * even though nothing in react-x11 reads it.
+ *
+ * `target` is a plain descriptor rather than a node: a widget is a composition
+ * of nodes with no single element holding its value, so there is nothing
+ * honest to point at. There is no `preventDefault` either — the value has
+ * already changed by the time the handler runs.
+ */
+export interface WidgetChangeEvent<T> {
+    type: 'change';
+    target: ChangeTarget<T>;
+    currentTarget: ChangeTarget<T>;
+    name: string | undefined;
+    value: T;
+}
+export declare function changeEvent<T>(type: string, name: string | undefined, value: T): WidgetChangeEvent<T>;
+/**
+ * Close a popup when the *window* loses focus.
+ *
+ * A trigger keeps its own focus while its override-redirect popup is up, so
+ * the trigger's `onBlur` never hears that the application went to the
+ * background — and a menu or a calendar left floating over another app's
+ * window is the bug that follows.
+ */
+export declare function useDismissOnWindowBlur(ref: RefObject<unknown>, active: boolean, onDismiss: () => void): void;
+//# sourceMappingURL=widget.d.ts.map

package/dist/internal/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../src/internal/widget.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,wDAAwD;AACxD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC;CACV;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC;CACV;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,CAAC,GACP,iBAAiB,CAAC,CAAC,CAAC,CAGtB;AAWD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,IAAI,GACpB,IAAI,CAYN"}

package/dist/internal/widget.js

@@ -0,0 +1,44 @@
+// The bits of react-x11 that a value widget needs and react-x11 does not
+// export — the change event every one of them emits, and the dismiss-on-blur
+// subscription every popup one needs.
+//
+// It lived in `src/calendar/` while the calendar was the only widget out
+// here; `<ColorPicker>` is the second, which is exactly the promotion
+// `AGENTS.md` describes for `src/internal/`.
+//
+// Everything else these widgets stand on is public — `useTheme`,
+// `createStyles`, `useAnchor`/`useAnchorTracking`, the `XK_*` keysyms, the
+// host elements, and `tint` off `react-x11/style`, which used to be vendored
+// here and is not any more. These two are what is left, and they are
+// collected here rather than scattered so the list stays short and visible.
+// Each is small and pure; if core ever puts one on its exports map, delete it
+// from here and import it, the way `tint` was deleted.
+import { useEffect, useRef } from 'react';
+export function changeEvent(type, name, value) {
+    const target = { type, name, value };
+    return { type: 'change', target, currentTarget: target, name, value };
+}
+/**
+ * Close a popup when the *window* loses focus.
+ *
+ * A trigger keeps its own focus while its override-redirect popup is up, so
+ * the trigger's `onBlur` never hears that the application went to the
+ * background — and a menu or a calendar left floating over another app's
+ * window is the bug that follows.
+ */
+export function useDismissOnWindowBlur(ref, active, onDismiss) {
+    const onDismissRef = useRef(onDismiss);
+    onDismissRef.current = onDismiss;
+    useEffect(() => {
+        if (!active)
+            return undefined;
+        const root = ref.current?.root;
+        if (!root?.onWindowFocusChange)
+            return undefined;
+        return root.onWindowFocusChange((focused) => {
+            if (!focused)
+                onDismissRef.current?.();
+        });
+    }, [active, ref]);
+}
+//# sourceMappingURL=widget.js.map

package/dist/internal/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../src/internal/widget.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,6EAA6E;AAC7E,sCAAsC;AACtC,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,6CAA6C;AAC7C,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAC3E,6EAA6E;AAC7E,qEAAqE;AACrE,4EAA4E;AAC5E,8EAA8E;AAC9E,uDAAuD;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAiC1C,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,IAAwB,EACxB,KAAQ;IAER,MAAM,MAAM,GAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACtD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxE,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAuB,EACvB,MAAe,EACf,SAAqB;IAErB,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,IAAI,GAAI,GAAG,CAAC,OAA+B,EAAE,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,EAAE,mBAAmB;YAAE,OAAO,SAAS,CAAC;QACjD,OAAO,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAgB,EAAE,EAAE;YACnD,IAAI,CAAC,OAAO;gBAAE,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/markdown/ast.d.ts

@@ -0,0 +1,126 @@
+/** Inline content, inside a paragraph, heading, list item or table cell. */
+export type InlineNode = TextInline | CodeInline | EmphasisInline | LinkInline | BreakInline | ComponentInline;
+/** A run of plain text. Softbreaks arrive collapsed to spaces. */
+export interface TextInline {
+    type: 'text';
+    text: string;
+}
+/** An inline code span. */
+export interface CodeInline {
+    type: 'code';
+    text: string;
+}
+/** `strong` is `**`, `em` is `*`, `del` is `~~`. */
+export interface EmphasisInline {
+    type: 'strong' | 'em' | 'del';
+    children: InlineNode[];
+}
+/**
+ * A link, or an image rendered as its alt text (this component draws no
+ * remote bitmaps — see index.ts). `href: null` is a link still streaming
+ * in: the text is styled as a link but there is nothing to navigate to yet.
+ */
+export interface LinkInline {
+    type: 'link';
+    href: string | null;
+    /** True when this was `![alt](src)` — the href is the image source. */
+    image: boolean;
+    children: InlineNode[];
+}
+/** A hard line break (two trailing spaces, or a trailing backslash). */
+export interface BreakInline {
+    type: 'break';
+}
+/**
+ * Reserved for MDX: `<Chart data={…} />` would parse to one of these. The
+ * current parser never emits it; the renderer maps unknown names to plain
+ * text so a future parser upgrade cannot crash an older renderer.
+ */
+export interface ComponentInline {
+    type: 'component';
+    name: string;
+    attributes: Record<string, string>;
+    children: InlineNode[];
+}
+/** Block-level content. */
+export type BlockNode = ParagraphBlock | HeadingBlock | CodeBlock | QuoteBlock | ListBlock | TableBlock | RuleBlock;
+export interface ParagraphBlock {
+    type: 'paragraph';
+    children: InlineNode[];
+}
+export interface HeadingBlock {
+    type: 'heading';
+    /** 1–6. Setext `===` is 1, `---` is 2. */
+    depth: number;
+    children: InlineNode[];
+}
+/** A fenced or indented code block. Text has no trailing newline. */
+export interface CodeBlock {
+    type: 'code';
+    /** First word of the info string, lowercased — `''` when absent. */
+    lang: string;
+    text: string;
+    /**
+     * False when the closing fence has not arrived. During streaming that is
+     * the normal state of the last block and not worth signalling to the
+     * user; a renderer could badge it if it wanted to.
+     */
+    closed: boolean;
+}
+export interface QuoteBlock {
+    type: 'quote';
+    children: BlockNode[];
+}
+export interface ListBlock {
+    type: 'list';
+    ordered: boolean;
+    /** Start number of an ordered list; 1 for bullet lists. */
+    start: number;
+    /**
+     * A tight list renders items without paragraph spacing between them —
+     * the CommonMark distinction, decided by blank lines in the source.
+     */
+    tight: boolean;
+    items: ListItem[];
+}
+export interface ListItem {
+    /** `null` for a plain item; true/false for a GFM task checkbox. */
+    checked: boolean | null;
+    children: BlockNode[];
+}
+export type TableAlign = 'left' | 'center' | 'right' | null;
+export interface TableBlock {
+    type: 'table';
+    /** One entry per column, from the delimiter row. */
+    align: TableAlign[];
+    /** Header cells. Always exactly `align.length` long. */
+    header: InlineNode[][];
+    /** Body rows, each padded or truncated to `align.length` cells. */
+    rows: InlineNode[][][];
+}
+export interface RuleBlock {
+    type: 'rule';
+}
+/** What `parse` returns. */
+export interface Document {
+    blocks: BlockNode[];
+    /**
+     * The raw source of each top-level block, index-aligned with `blocks`.
+     * This is the streaming cache key: a block whose raw text did not change
+     * between two parses produced an equal AST, so a renderer can reuse
+     * everything it derived from it (see index.ts).
+     */
+    raws: string[];
+}
+export interface ParseOptions {
+    /**
+     * Treat the end of input as "more is coming" (default true): unclosed
+     * emphasis, code spans and links that reach the end of the source are
+     * completed instead of falling back to literal text, half-arrived
+     * constructs (`![alt](…`, a lone trailing `**`, a bare `#`) are hidden,
+     * and an ambiguous final line (`---` that could still become a setext
+     * underline or a rule) is held back. Pass false for text that is final.
+     */
+    partial?: boolean;
+}
+//# sourceMappingURL=ast.d.ts.map

package/dist/markdown/ast.d.ts.map

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

package/dist/markdown/ast.js

@@ -0,0 +1,8 @@
+// The markdown AST `parse.ts` produces and `index.ts` renders. Deliberately
+// small: it is the GFM constructs this component draws, not a general
+// mdast — but it is shaped so that growing it stays additive. In particular
+// `component` is reserved for the MDX direction: a parser extension can emit
+// one without the renderer, the selection model or the caches changing shape
+// (see "MDX" in index.ts).
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/markdown/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/markdown/ast.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sEAAsE;AACtE,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,2BAA2B"}

package/dist/markdown/hx.d.ts

@@ -0,0 +1,24 @@
+import type { Key, ReactElement, ReactNode } from 'react';
+import type { ReactX11Elements, Theme } from 'react-x11';
+/** The host elements, by name. */
+export type Host = ReactX11Elements;
+/**
+ * What every element takes on top of its own props.
+ *
+ * `theme` is honoured by **every** node — `Node.theme` merges `props.theme`
+ * over the inherited palette, whatever the kind — but react-x11's element
+ * declarations only put it on `<window>`. A widget re-declares the theme it
+ * read from context onto its own root so that `$token` values still resolve
+ * inside a `<popup>`, which is a separate window and does not inherit the
+ * trigger's node tree. So the prop is real; only the declaration is narrow.
+ */
+interface CommonProps {
+    key?: Key;
+    /** `Theme` is listed alongside the record because it is an interface, and
+     *  an interface has no implicit index signature — so the palette `useTheme`
+     *  hands back is not assignable to the record react-x11 declares. */
+    theme?: Theme | Record<string, string | number>;
+}
+export declare function hx<K extends keyof Host>(type: K, props?: (Omit<Host[K], 'theme'> & CommonProps) | null, ...children: ReactNode[]): ReactElement;
+export {};
+//# sourceMappingURL=hx.d.ts.map

package/dist/markdown/hx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.d.ts","sourceRoot":"","sources":["../../src/markdown/hx.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEzD,kCAAkC;AAClC,MAAM,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAEpC;;;;;;;;;GASG;AACH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;yEAEqE;IACrE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACjD;AAED,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,IAAI,EACrC,IAAI,EAAE,CAAC,EAIP,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,EACrD,GAAG,QAAQ,EAAE,SAAS,EAAE,GACvB,YAAY,CAKd"}

package/dist/markdown/hx.js

@@ -0,0 +1,25 @@
+// `React.createElement`, typed against react-x11's host elements.
+//
+// The library writes `h(...)` rather than JSX — a convention inherited from
+// core, and worth keeping so moving code between the two repos stays a
+// rename. But `React.createElement`'s own overloads are `@types/react`'s, and
+// they describe the DOM: a `<box onKeyDown>` handler is checked against
+// React's `KeyboardEvent`, not react-x11's, and the whole props object is
+// measured against `DOMAttributes`. Everything interesting fails.
+//
+// So the element name is looked up in react-x11's own element table instead.
+// `hx('box', …)` gets `<box>`'s real props — `ev.keysym` on a key handler,
+// `onDraw` on a `<canvas>` — and `hx('div', …)` is an error, which is the
+// same guarantee the JSX namespace gives `examples/` and `test/types/`.
+import React from 'react';
+export function hx(type, 
+// `theme` is dropped from the element's own props before the merge:
+// `<window>` and `<popup>` already declare it, narrower, and intersecting
+// the two would demand a value satisfying both.
+props, ...children) {
+    // The cast is the whole point of the wrapper: `createElement`'s string
+    // overload insists on DOM props, and the signature above has already
+    // checked these against the element that will actually receive them.
+    return React.createElement(type, props, ...children);
+}
+//# sourceMappingURL=hx.js.map

package/dist/markdown/hx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.js","sourceRoot":"","sources":["../../src/markdown/hx.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,wEAAwE;AACxE,0EAA0E;AAC1E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAyB1B,MAAM,UAAU,EAAE,CAChB,IAAO;AACP,oEAAoE;AACpE,0EAA0E;AAC1E,gDAAgD;AAChD,KAAqD,EACrD,GAAG,QAAqB;IAExB,uEAAuE;IACvE,qEAAqE;IACrE,qEAAqE;IACrE,OAAO,KAAK,CAAC,aAAa,CAAC,IAAc,EAAE,KAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/markdown/index.d.ts

@@ -0,0 +1,90 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { DrawnNode, MouseEvent as X11MouseEvent } from 'react-x11';
+import type { Style } from 'react-x11/style';
+import type { Language } from '../code-language/index.js';
+export type { BlockNode, InlineNode, Document as MarkdownDocument, ParseOptions, } from './ast.js';
+export { parse, parseInline } from './parse.js';
+/** What a fence renderer is handed — see `MarkdownProps.fences`. */
+export interface FenceInfo {
+    /** The fence's info string, lowercased — the key it was looked up by. */
+    lang: string;
+    /** The fence's content, as it stands. */
+    text: string;
+    /** True while this fence is the live tail of a streaming document —
+     *  its `text` is still growing. */
+    partial: boolean;
+}
+export interface MarkdownProps {
+    /** The markdown text. Append to it as chunks stream in. */
+    source: string;
+    /**
+     * Whether more source may still arrive (default true). While true, the
+     * live tail is rendered friendly: unclosed emphasis/code close
+     * implicitly, half-arrived constructs are hidden or held. Set false when
+     * the stream ends, and the tail is re-read under final-document rules.
+     */
+    partial?: boolean;
+    /** Mouse selection, Ctrl+A / Ctrl+C, PRIMARY. Default true. */
+    selectable?: boolean;
+    /**
+     * A link was activated. Absent means clicks do nothing — this component
+     * never navigates by itself. Images render as their alt text linked to
+     * the image source, so they arrive here too.
+     */
+    onLink?: (href: string, ev: X11MouseEvent<DrawnNode>) => void;
+    /** Base text style. Defaults: theme `fontSize` (14), `sans-serif`. */
+    fontSize?: number;
+    fontFamily?: string;
+    /** Code font. Default `'monospace'` — there is no theme token for it. */
+    monoFamily?: string;
+    /** Selection band fill. Default: theme accent at 35% opacity. */
+    selectionColor?: string;
+    /** Syntax colouring in fenced code. Default true. */
+    highlight?: boolean;
+    /**
+     * A `Language` for a fence tag the built-in tokenizers do not cover —
+     * js/ts/jsx/tsx, json, shell, sql and glsl are built in, and this is where
+     * everything else comes from. `hljsLanguage` is the ready-made one:
+     *
+     * ```tsx
+     * import hljs from 'highlight.js/lib/common';
+     * <Markdown resolveLanguage={(tag) => hljsLanguage({ hljs, name: tag })} />
+     * ```
+     *
+     * A tag it does not know is `null`, and the fence paints plain. Give it a
+     * stable identity — a new closure per render defeats the block cache, the
+     * same way a new `fences` map does.
+     */
+    resolveLanguage?: (tag: string) => Language | null;
+    /**
+     * Custom renderers for fenced blocks, keyed by the fence's language
+     * (lowercased). A fence whose language has an entry renders through it
+     * instead of as a code block — how a ```math fence becomes a `<Formula>`
+     * — and the seam is a map so this component never imports the components
+     * it hosts. Streaming keeps working: the live tail's fence re-renders as
+     * its text grows, with `partial` true until the document ends. The
+     * renderer's text joins the document's selection if what it returns
+     * answers core's text accessors (docs/extending.md); it is handed a
+     * keyed slot, so it does not need a `key` of its own. Give the map a
+     * stable identity — a new object per render defeats the block cache.
+     */
+    fences?: Record<string, (fence: FenceInfo) => ReactNode>;
+    /** The root `<box>`'s style — width, padding, margins, `overflow`. */
+    style?: Style | Style[];
+    'data-testname'?: string;
+}
+/**
+ * A markdown document. Feed it a growing `source` while `partial` and it
+ * renders each chunk as it arrives without flashing raw syntax; text is
+ * selectable across every block — mouse (double/triple click for
+ * word/block), Ctrl+A, Ctrl+C, and X11 PRIMARY on release.
+ *
+ * ```jsx
+ * <box style={{ overflow: 'scroll', flexGrow: 1 }}>
+ *   <Markdown source={streamed} partial={stillStreaming}
+ *             onLink={(href) => openInBrowser(href)} />
+ * </box>
+ * ```
+ */
+export declare function Markdown(props: MarkdownProps): ReactElement;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAExE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAsB7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAQ1D,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,IAAI,gBAAgB,EAC5B,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAYhD,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb;uCACmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC9D,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;IACnD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC;IACzD,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA8YD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAiH3D"}