@orz/ui-content 0.0.0-stage → 0.1.0

package/dist/registry.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, } from "react";
+/**
+ * The fallback, as a component, for renderers that decide to step aside: a plain `<pre><code>`
+ * for inline text, and a download link (or the bare name when there is no `url`) for a file.
+ */
+export function ContentFallback({ source, className }) {
+    if (source.kind === "inline") {
+        return (_jsx("pre", { className: className, children: _jsx("code", { className: source.lang === undefined ? undefined : `language-${source.lang}`, children: source.text }) }));
+    }
+    if (source.url === undefined) {
+        return _jsx("span", { className: className, children: source.name });
+    }
+    return (_jsx("a", { className: className, href: source.url, download: source.name, children: source.name }));
+}
+/**
+ * One component per position, built once per list: a renderer's `Next` has to be the same
+ * component type on every render, or React remounts everything the renderer drew below it and a
+ * live text selection in there collapses (T-60).
+ */
+function stepsFor(renderers) {
+    const steps = [];
+    steps[renderers.length] = ContentFallback;
+    for (let i = renderers.length - 1; i >= 0; i--) {
+        steps[i] = function ContentStep(props) {
+            for (let j = i; j < renderers.length; j++) {
+                const renderer = renderers[j];
+                if (renderer?.accepts(props.source, props.placement)) {
+                    const Next = steps[j + 1] ?? ContentFallback;
+                    return _jsx(renderer.Component, { ...props, Next: Next });
+                }
+            }
+            return _jsx(ContentFallback, { ...props });
+        };
+    }
+    return steps;
+}
+const EMPTY = [];
+const RegistryContext = createContext({
+    renderers: EMPTY,
+    steps: stepsFor(EMPTY),
+    maxDepth: undefined,
+});
+const DepthContext = createContext(0);
+/**
+ * Registers renderers for every `<Content>` below. The list is ordered and the first renderer
+ * that accepts a source draws it, so a narrow renderer goes before a broad one. A nested provider
+ * puts its renderers in front of the outer ones.
+ *
+ * Keep `renderers` stable (a module constant or a memo): a new array rebuilds every `Next`, and
+ * React remounts whatever the renderers drew.
+ */
+export function ContentRenderers({ renderers, maxDepth, children, }) {
+    const outer = useContext(RegistryContext);
+    const merged = useMemo(() => outer.renderers.length === 0
+        ? renderers
+        : [...renderers, ...outer.renderers], [renderers, outer.renderers]);
+    const steps = useMemo(() => stepsFor(merged), [merged]);
+    const resolvedMaxDepth = maxDepth ?? outer.maxDepth;
+    const value = useMemo(() => ({ renderers: merged, steps, maxDepth: resolvedMaxDepth }), [merged, steps, resolvedMaxDepth]);
+    return (_jsx(RegistryContext.Provider, { value: value, children: children }));
+}
+function firstAccepting(renderers, source, placement) {
+    return renderers.find((renderer) => renderer.accepts(source, placement));
+}
+/**
+ * Draws a source with the first registered renderer that accepts it, or the fallback.
+ *
+ * A file source a renderer draws raises `useContentDepth()` by one for everything below it, once
+ * per `<Content>`: a renderer that wraps the file and hands it on through `Next` does not count
+ * it twice.
+ */
+export function Content(props) {
+    const { renderers, steps } = useContext(RegistryContext);
+    const depth = useContext(DepthContext);
+    const First = steps[0] ?? ContentFallback;
+    const drawn = props.source.kind === "file" &&
+        firstAccepting(renderers, props.source, props.placement) !== undefined;
+    if (!drawn)
+        return _jsx(First, { ...props });
+    return (_jsx(DepthContext.Provider, { value: depth + 1, children: _jsx(First, { ...props }) }));
+}
+/**
+ * How the renderer that would draw this source lays out, without rendering anything: `"block"`,
+ * `"inline"`, or `null` when nothing registered accepts it.
+ */
+export function useContentDisplay(source, placement) {
+    return useContentDisplayOf()(source, placement);
+}
+/**
+ * `useContentDisplay` as a function, for a caller that asks about a varying number of sources in
+ * one render, such as a paragraph checking each of its images.
+ */
+export function useContentDisplayOf() {
+    const { renderers } = useContext(RegistryContext);
+    return useCallback((source, placement) => {
+        const renderer = firstAccepting(renderers, source, placement);
+        return renderer === undefined ? null : (renderer.display ?? "block");
+    }, [renderers]);
+}
+/** How many file sources, each drawn by a renderer, enclose this point. */
+export function useContentDepth() {
+    return useContext(DepthContext);
+}
+/** The nearest `<ContentRenderers maxDepth>`, for renderers that limit nesting. */
+export function useContentMaxDepth() {
+    return useContext(RegistryContext).maxDepth;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/source-text.d.ts

@@ -0,0 +1,29 @@
+import type { ContentSource } from "./types.ts";
+export type SourceText = ({
+    status: "loading";
+    text?: undefined;
+    error?: undefined;
+} | {
+    status: "ready";
+    text: string;
+    error?: undefined;
+} | {
+    status: "error";
+    text?: undefined;
+    error: Error;
+}) & {
+    /** Runs the load again; what a renderer's Retry button calls. */
+    retry: () => void;
+};
+/**
+ * The text of a source. Inline text is ready at once. A file calls `load` when it has one and
+ * fetches `url` otherwise, and the load is aborted on unmount and when the source changes.
+ *
+ * A file counts as changed when its `name` or `url` does, or, for a file with no `url`, when its
+ * `load` function does. A `load` beside a `url` is read from the latest render instead, so a
+ * resolver that builds a fresh closure on every render does not restart the load each time.
+ *
+ * Size caps are the caller's.
+ */
+export declare function useSourceText(source: ContentSource): SourceText;
+//# sourceMappingURL=source-text.d.ts.map

package/dist/source-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-text.d.ts","sourceRoot":"","sources":["../src/source-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,CACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAC1D;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CACtD,GAAG;IACF,iEAAiE;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAiF/D"}

package/dist/source-text.js

@@ -0,0 +1,101 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+function sameKey(a, b) {
+    return (a.name === b.name &&
+        a.url === b.url &&
+        a.load === b.load &&
+        a.attempt === b.attempt);
+}
+async function fetchText(url, signal) {
+    const response = await fetch(url, { signal });
+    if (!response.ok) {
+        throw new Error(`${response.status} ${response.statusText}`.trim());
+    }
+    return response.text();
+}
+/**
+ * The text of a source. Inline text is ready at once. A file calls `load` when it has one and
+ * fetches `url` otherwise, and the load is aborted on unmount and when the source changes.
+ *
+ * A file counts as changed when its `name` or `url` does, or, for a file with no `url`, when its
+ * `load` function does. A `load` beside a `url` is read from the latest render instead, so a
+ * resolver that builds a fresh closure on every render does not restart the load each time.
+ *
+ * Size caps are the caller's.
+ */
+export function useSourceText(source) {
+    const [attempt, setAttempt] = useState(0);
+    const retry = useCallback(() => setAttempt((n) => n + 1), []);
+    const file = source.kind === "file" ? source : undefined;
+    const latestLoad = useRef(file?.load);
+    latestLoad.current = file?.load;
+    const key = file === undefined
+        ? undefined
+        : {
+            name: file.name,
+            url: file.url,
+            load: file.url === undefined ? file.load : undefined,
+            attempt,
+        };
+    const [settled, setSettled] = useState();
+    const name = key?.name;
+    const url = key?.url;
+    const keyLoad = key?.load;
+    useEffect(() => {
+        if (name === undefined)
+            return;
+        const forKey = { name, url, load: keyLoad, attempt };
+        const load = latestLoad.current ??
+            (url === undefined
+                ? undefined
+                : (signal) => fetchText(url, signal));
+        if (load === undefined) {
+            setSettled({
+                key: forKey,
+                result: {
+                    status: "error",
+                    error: new Error(`${name}: nothing to load`),
+                },
+            });
+            return;
+        }
+        const controller = new AbortController();
+        let pending;
+        try {
+            pending = load(controller.signal);
+        }
+        catch (error) {
+            // A load that throws before returning its promise has still failed to
+            // load; it must not escape the effect and take the host document down.
+            pending = Promise.reject(error);
+        }
+        pending.then((text) => {
+            if (controller.signal.aborted)
+                return;
+            setSettled({ key: forKey, result: { status: "ready", text } });
+        }, (error) => {
+            // An abort is this hook letting go of the load, not the load failing.
+            if (controller.signal.aborted)
+                return;
+            setSettled({
+                key: forKey,
+                result: {
+                    status: "error",
+                    error: error instanceof Error ? error : new Error(String(error)),
+                },
+            });
+        });
+        return () => controller.abort();
+    }, [name, url, keyLoad, attempt]);
+    if (source.kind === "inline") {
+        return { status: "ready", text: source.text, retry };
+    }
+    // A result settled for an earlier key is stale: report loading until this key's load settles,
+    // rather than the previous file's text for one render.
+    if (settled === undefined ||
+        key === undefined ||
+        !sameKey(settled.key, key)) {
+        return { status: "loading", retry };
+    }
+    return { ...settled.result, retry };
+}
+//# sourceMappingURL=source-text.js.map

package/dist/source-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-text.js","sourceRoot":"","sources":["../src/source-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAwBjE,SAAS,OAAO,CAAC,CAAM,EAAE,CAAM;IAC7B,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACjB,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;QACf,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACjB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CACxB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,MAAmB;IACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,UAAU,CAAC,OAAO,GAAG,IAAI,EAAE,IAAI,CAAC;IAEhC,MAAM,GAAG,GACP,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACpD,OAAO;SACR,CAAC;IACR,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,EAAiC,CAAC;IAExE,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC;IACrB,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,MAAM,MAAM,GAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC1D,MAAM,IAAI,GACR,UAAU,CAAC,OAAO;YAClB,CAAC,GAAG,KAAK,SAAS;gBAChB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,CAAC,MAAmB,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC;gBACT,GAAG,EAAE,MAAM;gBACX,MAAM,EAAE;oBACN,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,IAAI,KAAK,CAAC,GAAG,IAAI,mBAAmB,CAAC;iBAC7C;aACF,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,OAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sEAAsE;YACtE,uEAAuE;YACvE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CACV,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACtC,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,sEAAsE;YACtE,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACtC,UAAU,CAAC;gBACT,GAAG,EAAE,MAAM;gBACX,MAAM,EAAE;oBACN,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBACjE;aACF,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAElC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;IACD,8FAA8F;IAC9F,uDAAuD;IACvD,IACE,OAAO,KAAK,SAAS;QACrB,GAAG,KAAK,SAAS;QACjB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAC1B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/dist/title-bar.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+import type { ContentSource } from "./types.ts";
+/**
+ * Lends a spot in a surface's title bar to the renderer that draws `source` below, for controls
+ * that belong next to the surface's own (a patch's file list, an image's zoom).
+ *
+ * Keyed by the source object rather than by nesting: a renderer hands a nested source a new
+ * object (a markdown fence, an embedded file), so only the one drawing `source` itself sees the
+ * spot, and a `diff` fence inside a markdown card never takes over the card's bar.
+ */
+export declare function ContentTitleBar({ source, target, children, }: {
+    source: ContentSource;
+    /** The element the controls portal into; null until it has mounted. */
+    target: HTMLElement | null;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Where this source's controls go: an element to portal into, null while the title bar is still
+ * mounting, or undefined when no surface lent one for it, in which case the renderer draws a bar
+ * of its own if it needs one.
+ */
+export declare function useContentTitleBar(source: ContentSource): HTMLElement | null | undefined;
+//# sourceMappingURL=title-bar.d.ts.map

package/dist/title-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-bar.d.ts","sourceRoot":"","sources":["../src/title-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;IACtB,uEAAuE;IACvE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,+BAMA;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,GACpB,WAAW,GAAG,IAAI,GAAG,SAAS,CAGhC"}

package/dist/title-bar.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const TitleBarContext = createContext(null);
+/**
+ * Lends a spot in a surface's title bar to the renderer that draws `source` below, for controls
+ * that belong next to the surface's own (a patch's file list, an image's zoom).
+ *
+ * Keyed by the source object rather than by nesting: a renderer hands a nested source a new
+ * object (a markdown fence, an embedded file), so only the one drawing `source` itself sees the
+ * spot, and a `diff` fence inside a markdown card never takes over the card's bar.
+ */
+export function ContentTitleBar({ source, target, children, }) {
+    return (_jsx(TitleBarContext.Provider, { value: { source, target }, children: children }));
+}
+/**
+ * Where this source's controls go: an element to portal into, null while the title bar is still
+ * mounting, or undefined when no surface lent one for it, in which case the renderer draws a bar
+ * of its own if it needs one.
+ */
+export function useContentTitleBar(source) {
+    const slot = useContext(TitleBarContext);
+    return slot !== null && slot.source === source ? slot.target : undefined;
+}
+//# sourceMappingURL=title-bar.js.map

package/dist/title-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-bar.js","sourceRoot":"","sources":["../src/title-bar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAC;AAKlE,MAAM,eAAe,GAAG,aAAa,CAAc,IAAI,CAAC,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,MAAM,EACN,MAAM,EACN,QAAQ,GAMT;IACC,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAChD,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAqB;IAErB,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACzC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+import type { ComponentType } from "react";
+export type ContentSource = {
+    kind: "inline";
+    text: string;
+    lang?: string;
+} | {
+    kind: "file";
+    name: string;
+    mime?: string;
+    size?: number;
+    /** Where the bytes live; what an `<img>`, an `<iframe>` or the download link uses. */
+    url?: string;
+    /** The text, for renderers that need it; useSourceText falls back to fetching url. */
+    load?: (signal: AbortSignal) => Promise<string>;
+    /**
+     * The file was deleted. Links and embeds of it draw it struck through, as deleted, instead
+     * of a link to nothing or a broken image.
+     */
+    deleted?: boolean;
+};
+/** "document": inside a flow of other content (a fence, an embed). "viewer": owns the surface. */
+export type Placement = "document" | "viewer";
+export type ContentProps = {
+    source: ContentSource;
+    placement: Placement;
+    /**
+     * Put on the renderer's root element. Decoration passes mark the element a source was
+     * written as (an embedded `<img>`), and the class has to survive the swap to a renderer.
+     */
+    className?: string;
+};
+export type ContentDisplay = "block" | "inline";
+export type ContentRenderer = {
+    name: string;
+    /**
+     * Synchronous and pure: decided from the descriptor alone. Layout decisions upstream
+     * (a paragraph becoming a `<div>`) are made from it during render and must not flip
+     * when data arrives later.
+     */
+    accepts(source: ContentSource, placement: Placement): boolean;
+    /** "block" content cannot sit inside a `<p>`. Default "block". */
+    display?: ContentDisplay;
+    /** `Next` draws the same source with the renderers after this one. */
+    Component: ComponentType<ContentProps & {
+        Next: ComponentType<ContentProps>;
+    }>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEN,kGAAkG;AAClG,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9D,kEAAkE;IAClE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,SAAS,EAAE,aAAa,CACtB,YAAY,GAAG;QAAE,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;KAAE,CACrD,CAAC;CACH,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@orz/ui-content",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "A registry where content packages contribute renderers and any surface asks for content to be drawn",
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orzFly/ui.git",
+    "directory": "packages/ui-content"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "@orz/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./attachment": {
+      "@orz/source": "./src/attachment/index.ts",
+      "types": "./dist/attachment/index.d.ts",
+      "default": "./dist/attachment/index.js"
+    },
+    "./styles.css": "./styles.css"
+  },
+  "files": [
+    "dist",
+    "styles.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "lucide-react": "^1",
+    "react": "^19",
+    "react-dom": "^19",
+    "@orz/ui": "^0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "happy-dom": "^21.0.3",
+    "lucide-react": "^1.31.0",
+    "radix-ui": "^1.6.7",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "vitest": "^5.0.5",
+    "@orz/ui": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }

package/styles.css

@@ -0,0 +1,4 @@
+/* Tailwind resolves an imported file's @source against that file, so a
+   consumer importing this stylesheet scans the classes in the package's
+   shipped JS without writing an @source of its own. */
+@source "./dist";