@toon-protocol/views 0.2.0

package/dist/atoms/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/atoms/media.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAwB,MAAM,YAAY,CAAC;AAmH7D,eAAO,MAAM,UAAU,EAAE,IAAI,EAO5B,CAAC"}

package/dist/atoms/media.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Media atoms — NIP-68/71 posts + NIP-94 files (read), and the spendy uploader. */
+import { useRef, useState } from 'react';
+import { parseMediaPost, parseFileMetadata, parseInlineMedia } from '../parsers/media.js';
+import {} from '../types.js';
+import {} from './types.js';
+function isVideo(variant) {
+    return variant.mime?.startsWith('video/') ?? false;
+}
+/** Collect renderable media variants from any supported event. */
+function variantsFor(event) {
+    const post = parseMediaPost(event);
+    if (post)
+        return { variants: post.variants, video: post.mediaType === 'video' };
+    const file = parseFileMetadata(event);
+    if (file) {
+        const v = { url: file.url, fallbacks: [] };
+        if (file.mime)
+            v.mime = file.mime;
+        if (file.dim)
+            v.dim = file.dim;
+        return { variants: [v], video: file.mime?.startsWith('video/') ?? false };
+    }
+    return { variants: parseInlineMedia(event), video: false };
+}
+const MediaEmbed = ({ events }) => {
+    const event = events[0];
+    if (!event)
+        return null;
+    const { variants } = variantsFor(event);
+    if (variants.length === 0)
+        return null;
+    return (_jsx("div", { className: "flex flex-col gap-2", children: variants.map((v, i) => isVideo(v) ? (
+        // eslint-disable-next-line jsx-a11y/media-has-caption
+        _jsx("video", { src: v.url, controls: true, className: "max-h-96 w-full rounded-md" }, i)) : (_jsx("img", { src: v.url, alt: v.alt ?? '', className: "max-h-96 w-full rounded-md object-contain" }, i))) }));
+};
+const MediaUploader = ({ props, actions }) => {
+    const label = typeof props['label'] === 'string' ? props['label'] : 'Upload media';
+    const inputRef = useRef(null);
+    const [busy, setBusy] = useState(false);
+    const [uploadedOk, setUploadedOk] = useState(false);
+    const [uploadError, setUploadError] = useState(false);
+    const handleFile = async (file) => {
+        setBusy(true);
+        setUploadedOk(false);
+        setUploadError(false);
+        try {
+            const buf = await new Promise((resolve, reject) => {
+                const reader = new FileReader();
+                reader.onload = () => resolve(reader.result);
+                reader.onerror = () => reject(reader.error);
+                reader.readAsArrayBuffer(file);
+            });
+            const bytes = new Uint8Array(buf);
+            let binary = '';
+            const chunk = 8192;
+            for (let i = 0; i < bytes.length; i += chunk) {
+                binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+            }
+            const dataBase64 = btoa(binary);
+            const outcome = await actions['upload']?.({ dataBase64, mime: file.type || undefined });
+            if (outcome?.ok === false) {
+                setUploadError(true);
+            }
+            else {
+                setUploadedOk(true);
+            }
+        }
+        catch {
+            setUploadError(true);
+        }
+        finally {
+            setBusy(false);
+            if (inputRef.current)
+                inputRef.current.value = '';
+        }
+    };
+    return (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("input", { ref: inputRef, type: "file", accept: "image/*,video/*", className: "sr-only", disabled: busy || !actions['upload'], onChange: (e) => {
+                    const file = e.target.files?.[0];
+                    if (file)
+                        void handleFile(file);
+                } }), _jsxs("button", { type: "button", disabled: busy || !actions['upload'], className: "rounded-md border border-dashed border-border px-3 py-2 text-sm hover:bg-muted disabled:opacity-50", onClick: () => inputRef.current?.click(), children: [busy ? 'Uploading…' : label, ' ', _jsx("span", { className: "text-xs text-muted-foreground", children: "(pays to publish)" })] }), uploadedOk && (_jsx("p", { className: "text-xs text-muted-foreground", children: "Uploaded successfully." })), uploadError && (_jsx("p", { className: "text-xs text-destructive", children: "Upload failed." }))] }));
+};
+export const mediaAtoms = [
+    { id: 'media-embed', kinds: [20, 21, 22, 1063], Component: MediaEmbed },
+    {
+        id: 'media-uploader',
+        writes: [{ name: 'toon_upload_media', spendy: true }],
+        Component: MediaUploader,
+    },
+];
+//# sourceMappingURL=media.js.map

package/dist/atoms/media.js.map

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

package/dist/atoms/onboard.d.ts

@@ -0,0 +1,3 @@
+import { type Atom } from './types.js';
+export declare const onboardAtoms: Atom[];
+//# sourceMappingURL=onboard.d.ts.map

package/dist/atoms/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/atoms/onboard.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,IAAI,EAAwB,MAAM,YAAY,CAAC;AA4C7D,eAAO,MAAM,YAAY,EAAE,IAAI,EAE9B,CAAC"}

package/dist/atoms/onboard.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Onboarding atom — get-started card for new TOON clients.
+ * Walks through identity, payment channel, and first publish.
+ */
+import {} from 'react';
+import { Button } from '@/components/ui/button.js';
+import { MonoId } from '@/components/mono-id.js';
+import {} from './types.js';
+const DEFAULT_STEPS = [
+    'Claim your identity — one mnemonic, every chain.',
+    'Open a payment channel to a TOON apex.',
+    'Publish your first event. Reads stay free.',
+];
+const OnboardCard = ({ props, actions }) => {
+    const pubkey = typeof props['pubkey'] === 'string' ? props['pubkey'] : undefined;
+    const steps = Array.isArray(props['steps'])
+        ? props['steps'].map(String)
+        : DEFAULT_STEPS;
+    const label = typeof props['label'] === 'string' ? props['label'] : 'Publish profile';
+    return (_jsxs("div", { className: "rounded-lg border border-border bg-card p-5", children: [_jsxs("div", { className: "mb-4", children: [_jsx("div", { className: "font-semibold", children: "Get started with TOON" }), pubkey ? (_jsx(MonoId, { value: pubkey, className: "mt-0.5 text-muted-foreground" })) : null] }), _jsx("ol", { className: "mb-4 flex flex-col gap-2", children: steps.map((step, i) => (_jsxs("li", { className: "flex gap-3 text-sm", children: [_jsx("span", { className: "mt-0.5 flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-muted text-xs font-semibold text-muted-foreground", children: i + 1 }), _jsx("span", { className: "text-muted-foreground", children: step })] }, i))) }), actions['publish'] ? (_jsx("div", { className: "flex justify-end", children: _jsx(Button, { size: "sm", onClick: () => void actions['publish']?.(), children: label }) })) : null] }));
+};
+export const onboardAtoms = [
+    { id: 'onboard-card', writes: [{ name: 'toon_publish_unsigned' }], Component: OnboardCard },
+];
+//# sourceMappingURL=onboard.js.map

package/dist/atoms/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/atoms/onboard.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AACH,OAAO,EAAW,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAmC,MAAM,YAAY,CAAC;AAE7D,MAAM,aAAa,GAAG;IACpB,kDAAkD;IAClD,wCAAwC;IACxC,4CAA4C;CAC7C,CAAC;AAEF,MAAM,WAAW,GAAwB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;IAC9D,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAE,KAAK,CAAC,OAAO,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC;QAC3C,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEtF,OAAO,CACL,eAAK,SAAS,EAAC,6CAA6C,aAC1D,eAAK,SAAS,EAAC,MAAM,aACnB,cAAK,SAAS,EAAC,eAAe,sCAA4B,EACzD,MAAM,CAAC,CAAC,CAAC,CACR,KAAC,MAAM,IAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAC,8BAA8B,GAAG,CACnE,CAAC,CAAC,CAAC,IAAI,IACJ,EACN,aAAI,SAAS,EAAC,0BAA0B,YACrC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,cAAY,SAAS,EAAC,oBAAoB,aACxC,eAAM,SAAS,EAAC,4HAA4H,YACzI,CAAC,GAAG,CAAC,GACD,EACP,eAAM,SAAS,EAAC,uBAAuB,YAAE,IAAI,GAAQ,KAJ9C,CAAC,CAKL,CACN,CAAC,GACC,EACJ,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CACpB,cAAK,SAAS,EAAC,kBAAkB,YAC/B,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,YACzD,KAAK,GACC,GACL,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE;CAC5F,CAAC"}

package/dist/atoms/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Atom registry — the vocabulary the agent composes with.
+ *
+ * Keyed two ways: by atom `id` (hand-composition via ViewSpec) and by event
+ * `kind` (auto-render for feeds / `kindAuto` binds). Adding a NIP = add a parser
+ * + an atom here, and both the MCP-app and rig surfaces light up.
+ */
+import { KindRegistry } from '@toon-protocol/client/render';
+import { type Atom } from './types.js';
+import { GENERIC_ATOM_ID } from './fallback.js';
+/** Atom id → Atom. */
+export declare const ATOMS: ReadonlyMap<string, Atom>;
+/** All registered atom ids (the ViewSpec validator allowlist). */
+export declare const ATOM_IDS: ReadonlySet<string>;
+/** The default atom for an event kind, or the generic fallback. */
+export declare function defaultAtomForKind(kind: number): Atom;
+/** The generic fallback atom (used for unknown kinds / invalid nodes). */
+export declare function fallbackAtomFor(): Atom;
+/**
+ * Build the branch-1 native-component {@link KindRegistry} from the catalog's
+ * atom→kind metadata — the `KindRegistry<Atom>` the render trust gradient
+ * (`guardedRenderDispatch`) consults first. A hit is branch 1 (a known kind,
+ * full trust → render the atom natively); a miss falls through to the
+ * unknown-kind branches (A2UI / mcp-ui / generative).
+ *
+ * Each atom is registered under every kind it declares in {@link Atom.kinds},
+ * first-registered-wins (matching {@link KIND_DEFAULT}) so the same atom resolves
+ * for a kind here as via {@link defaultAtomForKind}. The generic fallback atom is
+ * deliberately NOT registered: an unknown kind must miss the registry so the
+ * gradient can route it, not be silently swallowed as "native".
+ */
+export declare function buildKindRegistry(): KindRegistry<Atom>;
+export { GENERIC_ATOM_ID };
+export { type Atom, type AtomRenderProps, type AtomAction, type ActionOutcome } from './types.js';
+//# sourceMappingURL=registry.d.ts.map

package/dist/atoms/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/atoms/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAQvC,OAAO,EAAgB,eAAe,EAAE,MAAM,eAAe,CAAC;AAa9D,sBAAsB;AACtB,eAAO,MAAM,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAA4C,CAAC;AAEzF,kEAAkE;AAClE,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAyB,CAAC;AAYnE,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAAC,IAAI,CAAC,CAStD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/atoms/registry.js

@@ -0,0 +1,77 @@
+/**
+ * Atom registry — the vocabulary the agent composes with.
+ *
+ * Keyed two ways: by atom `id` (hand-composition via ViewSpec) and by event
+ * `kind` (auto-render for feeds / `kindAuto` binds). Adding a NIP = add a parser
+ * + an atom here, and both the MCP-app and rig surfaces light up.
+ */
+import { KindRegistry } from '@toon-protocol/client/render';
+import {} from './types.js';
+import { layoutAtoms } from './layout.js';
+import { socialAtoms } from './social.js';
+import { mediaAtoms } from './media.js';
+import { forgeAtoms } from './forge.js';
+import { interactiveAtoms } from './interactive.js';
+import { defiAtoms } from './defi.js';
+import { onboardAtoms } from './onboard.js';
+import { fallbackAtom, GENERIC_ATOM_ID } from './fallback.js';
+const ALL_ATOMS = [
+    ...layoutAtoms,
+    ...socialAtoms,
+    ...mediaAtoms,
+    ...forgeAtoms,
+    ...interactiveAtoms,
+    ...defiAtoms,
+    ...onboardAtoms,
+    fallbackAtom,
+];
+/** Atom id → Atom. */
+export const ATOMS = new Map(ALL_ATOMS.map((a) => [a.id, a]));
+/** All registered atom ids (the ViewSpec validator allowlist). */
+export const ATOM_IDS = new Set(ATOMS.keys());
+const KIND_DEFAULT = (() => {
+    const map = new Map();
+    for (const atom of ALL_ATOMS) {
+        for (const kind of atom.kinds ?? []) {
+            if (!map.has(kind))
+                map.set(kind, atom);
+        }
+    }
+    return map;
+})();
+/** The default atom for an event kind, or the generic fallback. */
+export function defaultAtomForKind(kind) {
+    return KIND_DEFAULT.get(kind) ?? fallbackAtom;
+}
+/** The generic fallback atom (used for unknown kinds / invalid nodes). */
+export function fallbackAtomFor() {
+    return fallbackAtom;
+}
+/**
+ * Build the branch-1 native-component {@link KindRegistry} from the catalog's
+ * atom→kind metadata — the `KindRegistry<Atom>` the render trust gradient
+ * (`guardedRenderDispatch`) consults first. A hit is branch 1 (a known kind,
+ * full trust → render the atom natively); a miss falls through to the
+ * unknown-kind branches (A2UI / mcp-ui / generative).
+ *
+ * Each atom is registered under every kind it declares in {@link Atom.kinds},
+ * first-registered-wins (matching {@link KIND_DEFAULT}) so the same atom resolves
+ * for a kind here as via {@link defaultAtomForKind}. The generic fallback atom is
+ * deliberately NOT registered: an unknown kind must miss the registry so the
+ * gradient can route it, not be silently swallowed as "native".
+ */
+export function buildKindRegistry() {
+    const registry = new KindRegistry();
+    for (const atom of ALL_ATOMS) {
+        if (atom === fallbackAtom)
+            continue;
+        for (const kind of atom.kinds ?? []) {
+            if (!registry.has(kind))
+                registry.register(kind, atom);
+        }
+    }
+    return registry;
+}
+export { GENERIC_ATOM_ID };
+export {} from './types.js';
+//# sourceMappingURL=registry.js.map

package/dist/atoms/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/atoms/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAa,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,SAAS,GAAW;IACxB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,gBAAgB;IACnB,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,YAAY;CACb,CAAC;AAEF,sBAAsB;AACtB,MAAM,CAAC,MAAM,KAAK,GAA8B,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzF,kEAAkE;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAEnE,MAAM,YAAY,GAA8B,CAAC,GAAG,EAAE;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAgB,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,EAAE,CAAC;AAEL,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;AAChD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAQ,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,YAAY;YAAE,SAAS;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAwE,MAAM,YAAY,CAAC"}

package/dist/atoms/social.d.ts

@@ -0,0 +1,3 @@
+import { type Atom } from './types.js';
+export declare const socialAtoms: Atom[];
+//# sourceMappingURL=social.d.ts.map

package/dist/atoms/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../../src/atoms/social.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,IAAI,EAAwB,MAAM,YAAY,CAAC;AAyG7D,eAAO,MAAM,WAAW,EAAE,IAAI,EAS7B,CAAC"}

package/dist/atoms/social.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Social atoms — NIP-01 profile/note, NIP-25 reactions, NIP-02 follow. */
+import {} from 'react';
+import { Button } from '@/components/ui/button.js';
+import { Badge } from '@/components/ui/badge.js';
+import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar.js';
+import { MonoId } from '@/components/mono-id.js';
+import { parseProfile, parseNote, parseReaction } from '../parsers/social.js';
+import {} from './types.js';
+function displayName(pubkey) {
+    return pubkey.slice(0, 2).toUpperCase();
+}
+const ProfileHeader = ({ events }) => {
+    const profile = events.map(parseProfile).find((p) => p !== null) ?? null;
+    if (!profile)
+        return null;
+    const name = profile.displayName ?? profile.name ?? profile.pubkey;
+    const initials = displayName(profile.pubkey);
+    return (_jsxs("div", { className: "flex items-center gap-3", children: [_jsxs(Avatar, { className: "h-11 w-11", children: [_jsx(AvatarImage, { src: profile.picture, alt: name }), _jsx(AvatarFallback, { className: "text-xs font-semibold", children: initials })] }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate font-semibold leading-tight", children: name }), profile.nip05 ? (_jsx("div", { className: "truncate text-xs text-muted-foreground", children: profile.nip05 })) : (_jsx(MonoId, { value: profile.pubkey, className: "text-muted-foreground" })), profile.about ? (_jsx("p", { className: "mt-1 line-clamp-2 text-sm text-muted-foreground", children: profile.about })) : null] })] }));
+};
+const NoteCard = ({ events, actions }) => {
+    const notes = events.map(parseNote).filter((n) => n !== null);
+    if (notes.length === 0)
+        return null;
+    return (_jsx("div", { className: "flex flex-col divide-y divide-border", children: notes.map((note) => (_jsxs("article", { className: "flex flex-col gap-1.5 py-3 first:pt-0 last:pb-0", children: [_jsxs("header", { className: "flex items-center gap-2", children: [_jsx(MonoId, { value: note.authorPubkey }), note.isReply ? (_jsx(Badge, { variant: "secondary", className: "text-[10px]", children: "reply" })) : null] }), _jsx("p", { className: "whitespace-pre-wrap break-words text-sm leading-relaxed", children: note.content }), actions['reply'] ? (_jsx(Button, { variant: "ghost", size: "sm", className: "self-start h-6 px-0 text-xs text-muted-foreground hover:text-foreground", onClick: () => void actions['reply']?.({ parentId: note.eventId }), children: "Reply" })) : null] }, note.eventId))) }));
+};
+const ReactionBar = ({ events, actions }) => {
+    const counts = new Map();
+    for (const evt of events) {
+        const reaction = parseReaction(evt);
+        if (!reaction)
+            continue;
+        const key = reaction.content || '+';
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [[...counts.entries()].map(([emoji, n]) => (_jsxs(Badge, { variant: "secondary", children: [emoji, " ", n] }, emoji))), actions['react'] ? (_jsx(Button, { variant: "outline", size: "sm", className: "h-6 rounded-full px-2 text-xs", onClick: () => void actions['react']?.({ content: '+' }), children: "+ React" })) : null] }));
+};
+const FollowButton = ({ props, actions }) => {
+    const label = typeof props['label'] === 'string' ? props['label'] : 'Follow';
+    return (_jsx(Button, { disabled: !actions['follow'], size: "sm", onClick: () => void actions['follow']?.(), children: label }));
+};
+export const socialAtoms = [
+    { id: 'profile-header', kinds: [0], Component: ProfileHeader },
+    { id: 'note-card', kinds: [1], Component: NoteCard },
+    { id: 'reaction-bar', kinds: [7], Component: ReactionBar },
+    {
+        id: 'follow-button',
+        writes: [{ name: 'toon_publish_unsigned' }],
+        Component: FollowButton,
+    },
+];
+//# sourceMappingURL=social.js.map

package/dist/atoms/social.js.map

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

package/dist/atoms/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Atom contract.
+ *
+ * Atoms are pure, presentational, single-responsibility React components keyed
+ * by a stable `id`. The runtime resolves a node's data binding (free reads) and
+ * wires its write actions, then hands the atom already-resolved props. Atoms
+ * never call the bridge directly — they invoke the `actions` the runtime built.
+ */
+import { type FC, type ReactNode } from 'react';
+import { type NostrEvent } from '../types.js';
+/**
+ * Outcome of a wired write action, surfaced from the runtime so atoms can render
+ * a receipt with the real published `eventId`. A trimmed projection of the
+ * bridge's `ToolOutcome`: `ok` is `false` when the action was declined (spendy
+ * confirm) or the tool reported failure; `eventId` / `data` carry the publish
+ * response (`structuredContent`) on success.
+ */
+export interface ActionOutcome {
+    ok: boolean;
+    /** Published event id when the tool returned one (e.g. `toon_publish_unsigned`). */
+    eventId?: string;
+    /** Raw structured payload from the tool result. */
+    data?: unknown;
+    /** Error text when `ok` is false. */
+    error?: string;
+}
+/** A wired write action; runtimeArgs are merged over the ViewSpec's static args.
+ * Resolves to an {@link ActionOutcome} (`ok` plus the published `eventId`/`data`),
+ * or `void` if the call site doesn't read it. */
+export type AtomAction = (runtimeArgs?: Record<string, unknown>) => ActionOutcome | void | Promise<ActionOutcome | void>;
+/**
+ * The current pay-to-write status, as surfaced by the `toon_status` tool. Atoms
+ * that show a fee (e.g. the pay-confirm receipt) read it via
+ * {@link AtomRenderProps.readStatus} rather than hardcoding it.
+ */
+export interface AtomStatus {
+    feePerEvent: string;
+    settlementChain: string;
+    asset?: string;
+}
+export interface AtomRenderProps {
+    /** Events resolved from the node's `bind` (empty when there is no binding). */
+    events: NostrEvent[];
+    /** Static props from the ViewSpec node. */
+    props: Record<string, unknown>;
+    /** Write actions declared on the node, wired to the bridge by the runtime. */
+    actions: Record<string, AtomAction>;
+    /** Rendered child nodes. */
+    children: ReactNode;
+    /** Render one event via its kind's default atom (for feeds/lists/kindAuto). */
+    renderEvent: (event: NostrEvent) => ReactNode;
+    /**
+     * Fetch the live pay-to-write status (`toon_status`) — the fee + settlement
+     * chain to show before a paid write. Wired to the bridge by the runtime;
+     * `undefined` only in older render paths / tests that don't provide it. Atoms
+     * never call the bridge directly, so this is the single read seam for the fee.
+     */
+    readStatus?: () => Promise<AtomStatus>;
+}
+/** A registered atom. */
+export interface Atom {
+    id: string;
+    /** Event kinds this atom is the default renderer for (kindAuto / feeds). */
+    kinds?: number[];
+    /** Write tools this atom can fire (informational; the runtime wires them). */
+    writes?: {
+        name: string;
+        spendy?: boolean;
+    }[];
+    Component: FC<AtomRenderProps>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/atoms/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/atoms/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;iDAEiD;AACjD,MAAM,MAAM,UAAU,GAAG,CACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,4BAA4B;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,+EAA+E;IAC/E,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACxC;AAED,yBAAyB;AACzB,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC9C,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC;CAChC"}

package/dist/atoms/types.js

@@ -0,0 +1,11 @@
+/**
+ * Atom contract.
+ *
+ * Atoms are pure, presentational, single-responsibility React components keyed
+ * by a stable `id`. The runtime resolves a node's data binding (free reads) and
+ * wires its write actions, then hands the atom already-resolved props. Atoms
+ * never call the bridge directly — they invoke the `actions` the runtime built.
+ */
+import {} from 'react';
+import {} from '../types.js';
+//# sourceMappingURL=types.js.map

package/dist/atoms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/atoms/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA2B,MAAM,OAAO,CAAC;AAChD,OAAO,EAAmB,MAAM,aAAa,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pure atom catalog — Node-safe metadata (no React).
+ *
+ * This is the single source of truth for which atom ids exist, what kinds they
+ * render, and which writes they expose. The client-side React registry
+ * ({@link ./atoms/registry}) is asserted to match this list in tests, and the
+ * server-side `toon_atoms` tool + ViewSpec validator allowlist read from here so
+ * `@toon-protocol/client-mcp` never imports the React bundle.
+ */
+export interface AtomWriteMeta {
+    name: string;
+    spendy?: boolean;
+}
+export interface AtomMeta {
+    id: string;
+    description: string;
+    /** Event kinds this atom is the default renderer for. */
+    kinds?: number[];
+    /** Write tools this atom can fire. */
+    writes?: AtomWriteMeta[];
+    /** Human/agent-readable hint of the props the atom accepts. */
+    propsSchema?: Record<string, string>;
+}
+export declare const ATOM_CATALOG: AtomMeta[];
+/** All catalog atom ids (the ViewSpec validator allowlist). */
+export declare const CATALOG_ATOM_IDS: ReadonlySet<string>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,YAAY,EAAE,QAAQ,EAsHlC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA0C,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,121 @@
+/**
+ * Pure atom catalog — Node-safe metadata (no React).
+ *
+ * This is the single source of truth for which atom ids exist, what kinds they
+ * render, and which writes they expose. The client-side React registry
+ * ({@link ./atoms/registry}) is asserted to match this list in tests, and the
+ * server-side `toon_atoms` tool + ViewSpec validator allowlist read from here so
+ * `@toon-protocol/client-mcp` never imports the React bundle.
+ */
+import { OPEN_CHANNEL_TOOL, SWAP_TOOL } from './tool-names.js';
+export const ATOM_CATALOG = [
+    // layout
+    {
+        id: 'stack',
+        description: 'Vertical (default) or horizontal stack of child nodes.',
+        propsSchema: { direction: "'row' | 'col'", gap: 'number (tailwind gap step)' },
+    },
+    { id: 'section', description: 'Titled section wrapper.', propsSchema: { title: 'string' } },
+    { id: 'card', description: 'Bordered card container.' },
+    {
+        id: 'tabs',
+        description: 'Tabbed container; one child node per tab. Use for multi-section journeys.',
+        propsSchema: { labels: 'string[] (tab names, in child order)' },
+    },
+    // social
+    { id: 'profile-header', description: 'NIP-01 kind:0 profile header (avatar, name, nip05, bio).', kinds: [0] },
+    { id: 'note-card', description: 'NIP-01 kind:1 text note; optional "reply" action.', kinds: [1] },
+    { id: 'reaction-bar', description: 'NIP-25 kind:7 reaction counts; optional "react" action.', kinds: [7] },
+    {
+        id: 'follow-button',
+        description: 'NIP-02 follow/unfollow (publishes kind:3).',
+        writes: [{ name: 'toon_publish_unsigned' }],
+        propsSchema: { label: 'string' },
+    },
+    {
+        id: 'composer',
+        description: 'Text composer that publishes a note (kind:1) via its "post" action.',
+        writes: [{ name: 'toon_publish_unsigned' }],
+        propsSchema: { placeholder: 'string', label: 'string' },
+    },
+    {
+        id: 'pay-confirm',
+        description: 'Pay-to-write moment: compose a note, then a confirm step shows the live ' +
+            'fee + settlement chain (from toon_status) with Confirm/Cancel. Confirm ' +
+            'fires the "confirm" action (toon_publish_unsigned) and renders a receipt ' +
+            'with the published eventId — "the message is the money".',
+        writes: [{ name: 'toon_publish_unsigned' }],
+        propsSchema: { placeholder: 'string', label: 'string (compose button label)' },
+    },
+    // media
+    {
+        id: 'media-embed',
+        description: 'Render image/video streamed from Arweave (NIP-68/71/94).',
+        kinds: [20, 21, 22, 1063],
+    },
+    {
+        id: 'media-uploader',
+        description: 'Upload media to Arweave then publish a media event. Spendy.',
+        writes: [{ name: 'toon_upload_media', spendy: true }],
+        propsSchema: { label: 'string' },
+    },
+    // forge
+    { id: 'repo-card', description: 'NIP-34 kind:30617 repository card.', kinds: [30617] },
+    {
+        id: 'issue-card',
+        description: 'NIP-34 kind:1621 issue; optional "comment" action.',
+        kinds: [1621],
+        writes: [{ name: 'toon_publish_unsigned' }],
+    },
+    { id: 'pr-card', description: 'NIP-34 kind:1617 patch/PR summary (status, commits, base).', kinds: [1617] },
+    {
+        id: 'comment-thread',
+        description: 'NIP-34 kind:1622 comment list; optional "comment" action.',
+        kinds: [1622],
+        writes: [{ name: 'toon_publish_unsigned' }],
+    },
+    // defi
+    {
+        id: 'channel-card',
+        description: 'Read-only: shows tracked payment channels (channelId, nonce, cumulative ' +
+            'amount). Optional "open" action pre-opens a channel.',
+        kinds: [],
+        writes: [{ name: OPEN_CHANNEL_TOOL }],
+        propsSchema: { destination: 'string (optional ILP destination for "open")' },
+    },
+    {
+        id: 'swap-form',
+        description: 'Interactive: collects swap params and fires a cross-asset swap. Spendy.',
+        writes: [{ name: SWAP_TOOL, spendy: true }],
+        propsSchema: {
+            destination: 'string (mill ILP destination)',
+            millPubkey: 'string (mill 64-char hex Nostr pubkey)',
+            pair: 'SwapPair ({ from, to, rate, … })',
+            chainRecipient: 'string (payout address on pair.to.chain)',
+            label: 'string (submit button label)',
+        },
+    },
+    {
+        id: 'settlement-receipt',
+        description: 'Read-only render of a SwapResponse / SwapClaim[] (target amount, chain ' +
+            'claim, channelId, tx/claim id, nonce). No writes.',
+    },
+    // onboard
+    {
+        id: 'onboard-card',
+        description: 'Onboarding / get-started card: walks a new user through claiming an ' +
+            'identity and opening a payment channel before they pay-to-write. Optional ' +
+            '"publish" action publishes their initial kind:0 profile.',
+        writes: [{ name: 'toon_publish_unsigned' }],
+        propsSchema: {
+            pubkey: 'string (the user’s Nostr pubkey, hex)',
+            steps: 'string[] (optional checklist of get-started steps)',
+            label: 'string (optional publish-profile button label)',
+        },
+    },
+    // fallback
+    { id: 'generic-event', description: 'Fallback: decoded JSON + tags for any kind without a bespoke atom.' },
+];
+/** All catalog atom ids (the ViewSpec validator allowlist). */
+export const CATALOG_ATOM_IDS = new Set(ATOM_CATALOG.map((a) => a.id));
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAkB/D,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,SAAS;IACT;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,4BAA4B,EAAE;KAC/E;IACD,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAC3F,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACvD;QACE,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE,MAAM,EAAE,sCAAsC,EAAE;KAChE;IAED,SAAS;IACT,EAAE,EAAE,EAAE,gBAAgB,EAAE,WAAW,EAAE,0DAA0D,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;IAC7G,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,mDAAmD,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;IACjG,EAAE,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,yDAAyD,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;IAC1G;QACE,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,4CAA4C;QACzD,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC3C,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;KACjC;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,qEAAqE;QAClF,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC3C,WAAW,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;KACxD;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EACT,0EAA0E;YAC1E,yEAAyE;YACzE,2EAA2E;YAC3E,0DAA0D;QAC5D,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC3C,WAAW,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,+BAA+B,EAAE;KAC/E;IAED,QAAQ;IACR;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,0DAA0D;QACvE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;KAC1B;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,6DAA6D;QAC1E,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACrD,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;KACjC;IAED,QAAQ;IACR,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,oCAAoC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE;IACtF;QACE,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,CAAC,IAAI,CAAC;QACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;KAC5C;IACD,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,4DAA4D,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;IAC3G;QACE,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,CAAC,IAAI,CAAC;QACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;KAC5C;IAED,OAAO;IACP;QACE,EAAE,EAAE,cAAc;QAClB,WAAW,EACT,0EAA0E;YAC1E,sDAAsD;QACxD,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QACrC,WAAW,EAAE,EAAE,WAAW,EAAE,8CAA8C,EAAE;KAC7E;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EACT,yEAAyE;QAC3E,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC3C,WAAW,EAAE;YACX,WAAW,EAAE,+BAA+B;YAC5C,UAAU,EAAE,wCAAwC;YACpD,IAAI,EAAE,kCAAkC;YACxC,cAAc,EAAE,0CAA0C;YAC1D,KAAK,EAAE,8BAA8B;SACtC;KACF;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,WAAW,EACT,yEAAyE;YACzE,mDAAmD;KACtD;IAED,UAAU;IACV;QACE,EAAE,EAAE,cAAc;QAClB,WAAW,EACT,sEAAsE;YACtE,4EAA4E;YAC5E,0DAA0D;QAC5D,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC3C,WAAW,EAAE;YACX,MAAM,EAAE,uCAAuC;YAC/C,KAAK,EAAE,oDAAoD;YAC3D,KAAK,EAAE,gDAAgD;SACxD;KACF;IAED,WAAW;IACX,EAAE,EAAE,EAAE,eAAe,EAAE,WAAW,EAAE,oEAAoE,EAAE;CAC3G,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/components/mono-id.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MonoId — renders a protocol address (pubkey, event ID, channel ID) as a
+ * bold·dim·bold split so the head and tail read as distinct identity markers.
+ *
+ *   npub1abc1234…ef56  →  [bold: npub1abc] [dim: …] [bold: ef56]
+ */
+import * as React from 'react';
+interface MonoIdProps {
+    value: string;
+    prefixLen?: number;
+    suffixLen?: number;
+    className?: string;
+}
+export declare function MonoId({ value, prefixLen, suffixLen, className }: MonoIdProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=mono-id.d.ts.map

package/dist/components/mono-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mono-id.d.ts","sourceRoot":"","sources":["../../src/components/mono-id.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,SAAa,EAAE,SAAa,EAAE,SAAS,EAAE,EAAE,WAAW,qBAarF"}