@lickle/docs 0.0.0-dev.1

package/dist/esm/ui/components/Comment.jsx

@@ -0,0 +1,176 @@
+import { createMemo, For, Show } from 'solid-js';
+import { createSlot } from "../context/index.js";
+import { useCommentMarkdown } from "../hooks/index.js";
+import { CodeBlock } from "./Code/index.jsx";
+import { Markdown } from "./Markdown.jsx";
+import { Type } from "./Type.jsx";
+import { Link } from "./Link.jsx";
+/**
+ * Render a single doc comment: summary markdown first, then every tag in
+ * source order. Consecutive `@param` (or `@property`) runs are merged into
+ * one labelled table so a five-parameter signature reads as one block.
+ *
+ * Per-tag rendering goes through the component registry — `defaults` from
+ * `theme/tags/`, with user overrides taking precedence. Unknown tags fall
+ * through to {@link UnknownTag}.
+ */
+export const Comment = createSlot('comment', (props) => {
+    return (<Show when={props.comment}>
+      {(c) => {
+            const summary = useCommentMarkdown(c);
+            const groups = createMemo(() => groupTags(c().tags ?? []));
+            return (<Show when={summary() || props.comment?.tags?.length}>
+            <div class={props.class}>
+              <Show when={summary()}>{(c) => <Markdown source={c()}/>}</Show>
+              <For each={groups()}>
+                {(g) => {
+                    if (g.kind === '@param')
+                        return <Parameters tags={g.items}/>;
+                    if (g.kind === '@property')
+                        return <Properties tags={g.items}/>;
+                    if (g.tag.tag === '@module')
+                        return null;
+                    return <Tag tag={g.tag}/>;
+                }}
+              </For>
+            </div>
+          </Show>);
+        }}
+    </Show>);
+});
+const Properties = createSlot('comment.properties', (p) => <NamedTable title="Properties" tags={p.tags}/>);
+const Parameters = createSlot('comment.parameters', (p) => <NamedTable title="Parameters" tags={p.tags}/>);
+const NamedTable = (props) => {
+    return (<section class="mt-6">
+      <div class="flex items-baseline gap-2 mb-2">
+        <h4 class="text-mute uppercase text-[0.7rem] font-semibold tracking-wider">{props.title}</h4>
+      </div>
+      <dl class="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1.5 items-baseline">
+        <For each={props.tags}>{(it) => <NamedRow item={it}/>}</For>
+      </dl>
+    </section>);
+};
+const NamedRow = (props) => (<>
+    <dt class="font-mono text-sm whitespace-nowrap">
+      <span class="font-semibold">{props.item.name}</span>
+      <Show when={props.item.optional}>
+        <span class="text-mute">?</span>
+      </Show>
+      <Show when={props.item.type}>
+        <>
+          <span class="text-mute">: </span>
+          <Type type={props.item.type}/>
+        </>
+      </Show>
+      <Show when={props.item.default}>
+        <span class="text-mute"> = {props.item.default}</span>
+      </Show>
+    </dt>
+    <dd class="text-sm text-mute min-w-0">
+      <Show when={trimLead(props.item.text)}>
+        <Markdown.Inline source={trimLead(props.item.text)}/>
+      </Show>
+    </dd>
+  </>);
+/** Strip a single leading `- ` so `@param foo - desc` collapses cleanly. */
+const trimLead = (s) => (s ?? '').replace(/^\s*-\s*/, '').trim();
+const groupTags = (tags) => {
+    const out = [];
+    const pushRun = (kind, item) => {
+        const last = out[out.length - 1];
+        if (last && last.kind === kind)
+            last.items.push(item);
+        else
+            out.push({ kind, items: [item] });
+    };
+    for (const t of tags) {
+        if (t.tag === '@param')
+            pushRun('@param', t);
+        else if (t.tag === '@property')
+            pushRun('@property', t);
+        else
+            out.push({ kind: 'tag', tag: t });
+    }
+    return out;
+};
+export const Tag = createSlot('tag', (props) => {
+    if (props.tag.tag === '@returns')
+        return <TagReturns tag={props.tag}/>;
+    if (props.tag.tag === '@throws')
+        return <TagThrows tag={props.tag}/>;
+    if (props.tag.tag === '@type')
+        return <TagType tag={props.tag}/>;
+    if (props.tag.tag === '@satisfies')
+        return <TagSatisfies tag={props.tag}/>;
+    if (props.tag.tag === '@example')
+        return <TagExample tag={props.tag}/>;
+    if (props.tag.tag === '@see')
+        return <TagSee tag={props.tag}/>;
+    if (props.tag.tag === '@template')
+        return <TagTemplate tag={props.tag}/>;
+    return <TagOther tag={props.tag}/>;
+});
+/** Section frame shared across tag renderers. */
+export const TagSection = (props) => (<section class="mt-6">
+    <div class="flex items-baseline gap-2 mb-2">
+      <TagTitle tag={props.tag}/>
+      <Show when={props.description}>
+        {(description) => (<div class="text-xs text-mute min-w-0">
+            <Markdown.Inline source={description()}/>
+          </div>)}
+      </Show>
+    </div>
+    {props.children}
+  </section>);
+const TagTitle = (props) => {
+    const title = props.tag.tag.replace(/^@/, '');
+    return <h4 class="text-mute uppercase text-[0.7rem] font-semibold tracking-wider">{title}</h4>;
+};
+export const TagExample = createSlot('tag.example', (props) => (<TagSection tag={props.tag}>
+    <CodeBlock code={props.tag.code}/>
+  </TagSection>));
+export const TagReturns = createSlot('tag.returns', (props) => (<TagSection tag={props.tag}>
+    <Type.Inline type={props.tag.type} text={props.tag.text}/>
+  </TagSection>));
+export const TagSatisfies = createSlot('tag.satisfies', (props) => (<TagSection tag={props.tag}>
+    <Type.Inline type={props.tag.type} text={props.tag.text}/>
+  </TagSection>));
+export const TagSee = createSlot('tag.see', (props) => (<TagSection tag={props.tag}>
+    <Show when={props.tag.target}>
+      <div class="font-mono text-sm mb-1">
+        <Link.ByName name={props.tag.target ?? ''}/>
+      </div>
+    </Show>
+  </TagSection>));
+export const TagTemplate = createSlot('tag.template', (props) => (<TagSection tag={props.tag}>
+    <dl class="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1.5 items-baseline">
+      <For each={props.tag.generics}>
+        {(tp) => (<>
+            <dt class="font-mono text-sm font-semibold">{tp.name}</dt>
+            <dd class="text-sm text-mute">
+              <Show when={tp.constraint}>
+                <>
+                  <span class="text-accent">extends </span>
+                  <Type type={tp.constraint}/>
+                </>
+              </Show>
+            </dd>
+          </>)}
+      </For>
+    </dl>
+    <Show when={props.tag.text?.trim()}>
+      <div class="mt-2">
+        <Markdown.Inline source={props.tag.text}/>
+      </div>
+    </Show>
+  </TagSection>));
+export const TagThrows = createSlot('tag.throws', (props) => (<TagSection tag={props.tag}>
+    <Type.Inline type={props.tag.type} text={props.tag.text}/>
+  </TagSection>));
+export const TagType = createSlot('tag.type', (props) => (<TagSection tag={props.tag}>
+    <Type.Inline type={props.tag.type} text={props.tag.text}/>
+  </TagSection>));
+export const TagOther = createSlot('tag.*', (props) => (<TagSection tag={props.tag}>
+    <Markdown source={props.tag.text ?? ''}/>
+  </TagSection>));
+//# sourceMappingURL=Comment.jsx.map

package/dist/esm/ui/components/Comment.jsx.map

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

package/dist/esm/ui/components/Declaration.jsx

@@ -0,0 +1,147 @@
+import { For, Show } from 'solid-js';
+import { Dynamic } from 'solid-js/web';
+import { createSlot } from "../context/index.js";
+import { Syntax } from "./Syntax.jsx";
+import { Comment } from "./Comment.jsx";
+import { Type } from "./Type.jsx";
+/**
+ * Dispatch a declaration to its per-kind renderer. Implemented via `Dynamic`
+ * (not an `if`/`switch`) so the active sub-component swaps reactively when
+ * `props.decl.kind` changes — otherwise navigating between pages of different
+ * kinds would freeze on the original branch.
+ */
+export const Declaration = createSlot('declaration', (props) => (<Dynamic component={dispatch(props.decl.kind)} decl={props.decl}/>));
+const dispatch = (kind) => RENDERERS[kind];
+/** Heritage line — `extends A, B` / `implements C`. */
+const ExtendsLine = (props) => (<Show when={props.types?.length}>
+    <div class="text-sm text-mute font-mono mt-2">
+      <span class="text-accent">{props.label} </span>
+      <Type.Join sep=", " items={props.types}/>
+    </div>
+  </Show>);
+export const DeclarationFunction = createSlot('declaration.function', (props) => (<div class="mt-2">
+    <For each={props.decl.signatures}>
+      {(sig) => <Type.SignatureLine sig={sig} name={props.decl.name} id={props.decl.id} kind="function"/>}
+    </For>
+    <Comment comment={props.decl.comment}/>
+  </div>));
+export const DeclarationVariable = createSlot('declaration.variable', (props) => (<div>
+    <div class="font-mono text-sm leading-relaxed">
+      <Syntax.Kw>const </Syntax.Kw>
+      <span class="font-semibold">{props.decl.name}</span>
+      <Syntax.Punct>: </Syntax.Punct>
+      <Type type={props.decl.type}/>
+      <Show when={props.decl.defaultValue}>
+        <Syntax.Punct>{` = ${props.decl.defaultValue}`}</Syntax.Punct>
+      </Show>
+    </div>
+    <Comment comment={props.decl.comment}/>
+  </div>));
+export const DeclarationTypeAlias = createSlot('declaration.type-alias', (props) => (<div>
+    <div class="font-mono text-sm leading-relaxed">
+      <Syntax.Kw>type </Syntax.Kw>
+      <span class="font-semibold">{props.decl.name}</span>
+      <Type.Generics generics={props.decl.generics}/>
+      <Syntax.Punct> = </Syntax.Punct>
+      <Type type={props.decl.type}/>
+    </div>
+    <Comment comment={props.decl.comment}/>
+  </div>));
+export const DeclarationClass = createSlot('declaration.class', (props) => (<div>
+    <ExtendsLine label="extends" types={props.decl.extends}/>
+    <ExtendsLine label="implements" types={props.decl.implements}/>
+    <Comment comment={props.decl.comment}/>
+    <Members constructors={props.decl.constructors} properties={props.decl.properties} methods={props.decl.methods} indexSignature={props.decl.indexSignature}/>
+  </div>));
+export const DeclarationInterface = createSlot('declaration.interface', (props) => (<div>
+    <ExtendsLine label="extends" types={props.decl.extends}/>
+    <Comment comment={props.decl.comment}/>
+    <Members properties={props.decl.properties} methods={props.decl.methods} callSignatures={props.decl.callSignatures} constructSignatures={props.decl.constructSignatures} indexSignature={props.decl.indexSignature}/>
+  </div>));
+/** Section heading matching the module-children layout in `Page.tsx`. */
+const MemberSection = (props) => (<Show when={props.when}>
+    <section class="mt-8">
+      <h2 class="text-sm font-semibold mb-3 pb-1.5 border-b border-line capitalize">{props.title}</h2>
+      {props.children}
+    </section>
+  </Show>);
+const PropertyRow = (props) => (<div class="py-2">
+    <div class="font-mono text-sm leading-relaxed">
+      <span class="font-semibold">{props.prop.name}</span>
+      <Show when={props.prop.optional}>
+        <Syntax.Punct>?</Syntax.Punct>
+      </Show>
+      <Syntax.Punct>: </Syntax.Punct>
+      <Type type={props.prop.type}/>
+      <Show when={props.prop.defaultValue}>
+        <Syntax.Punct>{` = ${props.prop.defaultValue}`}</Syntax.Punct>
+      </Show>
+    </div>
+    <Show when={props.prop.comment}>
+      <div class="mt-1">
+        <Comment comment={props.prop.comment}/>
+      </div>
+    </Show>
+  </div>);
+const IndexRow = (props) => (<div class="font-mono text-sm leading-relaxed py-2">
+    <Syntax.Punct>[</Syntax.Punct>
+    <span class="font-semibold">{props.sig.parameter.name}</span>
+    <Syntax.Punct>: </Syntax.Punct>
+    <Type type={props.sig.parameter.type}/>
+    <Syntax.Punct>]: </Syntax.Punct>
+    <Type type={props.sig.type}/>
+  </div>);
+/** Member listing shared by classes and interfaces. */
+const Members = (props) => (<>
+    <MemberSection title="Constructors" when={props.constructors?.length}>
+      <For each={props.constructors}>{(sig) => <Type.Signature sig={sig} name="constructor" kind="constructor"/>}</For>
+    </MemberSection>
+    <MemberSection title="Properties" when={props.properties?.length || props.indexSignature}>
+      <For each={props.properties}>{(p) => <PropertyRow prop={p}/>}</For>
+      <Show when={props.indexSignature}>{(sig) => <IndexRow sig={sig()}/>}</Show>
+    </MemberSection>
+    <MemberSection title="Methods" when={props.methods?.length}>
+      <For each={props.methods}>
+        {(m) => <For each={m.signatures}>{(sig) => <Type.Signature sig={sig} name={m.name} kind="method"/>}</For>}
+      </For>
+    </MemberSection>
+    <MemberSection title="Call Signatures" when={props.callSignatures?.length}>
+      <For each={props.callSignatures}>{(sig) => <Type.Signature sig={sig}/>}</For>
+    </MemberSection>
+    <MemberSection title="Construct Signatures" when={props.constructSignatures?.length}>
+      <For each={props.constructSignatures}>{(sig) => <Type.Signature sig={sig} kind="constructor"/>}</For>
+    </MemberSection>
+  </>);
+export const DeclarationEnum = createSlot('declaration.enum', (props) => (<div>
+    <Comment comment={props.decl.comment}/>
+    <MemberSection title="Members" when={props.decl.members?.length}>
+      <For each={props.decl.members}>{(m) => <EnumMemberRow member={m}/>}</For>
+    </MemberSection>
+  </div>));
+const EnumMemberRow = (props) => (<div class="py-2">
+    <div class="font-mono text-sm leading-relaxed">
+      <span class="font-semibold">{props.member.name}</span>
+      <Show when={props.member.value !== undefined}>
+        <Syntax.Punct>{` = ${typeof props.member.value === 'string' ? `"${props.member.value}"` : props.member.value}`}</Syntax.Punct>
+      </Show>
+    </div>
+    <Show when={props.member.comment}>
+      <div class="mt-1">
+        <Comment comment={props.member.comment}/>
+      </div>
+    </Show>
+  </div>);
+export const DeclarationModule = createSlot('declaration.module', (props) => <Comment comment={props.decl.comment}/>);
+export const DeclarationNamespace = createSlot('declaration.namespace', (props) => (<Comment comment={props.decl.comment}/>));
+const RENDERERS = {
+    class: DeclarationClass,
+    interface: DeclarationInterface,
+    enum: DeclarationEnum,
+    function: DeclarationFunction,
+    variable: DeclarationVariable,
+    'type-alias': DeclarationTypeAlias,
+    module: DeclarationModule,
+    namespace: DeclarationNamespace,
+    export: () => null,
+};
+//# sourceMappingURL=Declaration.jsx.map

package/dist/esm/ui/components/Declaration.jsx.map

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

package/dist/esm/ui/components/Header.jsx

@@ -0,0 +1,66 @@
+import { For, Show, createMemo } from 'solid-js';
+import { A } from '@solidjs/router';
+import { useProject } from "../context/index.js";
+import { createSlot } from "../context/index.js";
+import { ThemeToggle } from "./ThemeToggle.jsx";
+const isMac = () => typeof navigator !== 'undefined' && /mac/i.test(navigator.platform || navigator.userAgent || '');
+const ICON_BY_NAME = {
+    github: 'github-icon',
+    bluesky: 'bluesky-icon',
+    discord: 'discord-icon',
+    x: 'x-icon',
+    twitter: 'x-icon',
+    npm: 'documentation-icon',
+};
+const iconFor = (label) => {
+    const k = label.toLowerCase();
+    return ICON_BY_NAME[k] ?? null;
+};
+export const Header = createSlot('header', (props) => {
+    const project = useProject();
+    const searchHint = createMemo(() => (isMac() ? '\u2318K' : 'Ctrl K'));
+    return (<header class="sticky top-0 z-30 border-b border-line bg-bg/80 backdrop-blur-md backdrop-saturate-150">
+      <div class="flex items-center h-14 px-4 lg:px-6 gap-4">
+        <button type="button" aria-label="Open menu" class="lg:hidden p-1.5 rounded hover:bg-hover cursor-pointer" onClick={() => props.onMenu?.()}>
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
+            <path d="M4 7h16M4 12h16M4 17h16"/>
+          </svg>
+        </button>
+        <A href="/" class="flex items-baseline gap-2 hover:opacity-70 transition-opacity">
+          <span class="font-semibold text-[0.95rem] tracking-tight">{project().name}</span>
+          <Show when={project().version}>
+            <span class="text-xs text-mute font-mono">v{project().version}</span>
+          </Show>
+        </A>
+
+        <button type="button" onClick={() => props.onSearch?.()} aria-label="Search" class="ml-4 flex items-center gap-2 px-2.5 py-1 text-xs text-mute border border-line rounded-md hover:text-fg hover:bg-hover transition-colors cursor-pointer">
+          <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+            <circle cx="11" cy="11" r="7"/>
+            <path d="m20 20-3.5-3.5" stroke-linecap="round"/>
+          </svg>
+          <span class="hidden sm:inline">Search</span>
+          <kbd class="font-mono text-[0.65rem] text-mute">{searchHint()}</kbd>
+        </button>
+
+        <nav class="ml-auto flex items-center gap-1">
+          <For each={project().links}>
+            {({ label, href }) => {
+            const icon = iconFor(label);
+            return (<a href={href} target="_blank" rel="noreferrer" class="flex items-center gap-1.5 px-2 py-1 text-xs text-mute hover:text-fg transition-colors duration-150" title={label}>
+                  <Show when={icon} fallback={<span>{label}</span>}>
+                    <svg width="14" height="14">
+                      <use href={`/icons.svg#${icon}`}/>
+                    </svg>
+                    <span class="sr-only">{label}</span>
+                  </Show>
+                </a>);
+        }}
+          </For>
+          <div class="ml-2">
+            <ThemeToggle />
+          </div>
+        </nav>
+      </div>
+    </header>);
+});
+//# sourceMappingURL=Header.jsx.map

package/dist/esm/ui/components/Header.jsx.map

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

package/dist/esm/ui/components/Layout.jsx

@@ -0,0 +1,44 @@
+import { createSignal, onCleanup, onMount } from 'solid-js';
+import { useLocation } from '@solidjs/router';
+import { createEffect } from 'solid-js';
+import { createSlot } from "../context/index.js";
+import { SearchPalette } from "./SearchPalette.jsx";
+import { Sidebar } from "./Sidebar.jsx";
+import { Header } from "./Header.jsx";
+export const Layout = createSlot('layout', (props) => {
+    const [menuOpen, setMenuOpen] = createSignal(false);
+    const [searchOpen, setSearchOpen] = createSignal(false);
+    const loc = useLocation();
+    createEffect(() => {
+        void loc.pathname;
+        setMenuOpen(false);
+    });
+    onMount(() => {
+        const onKey = (e) => {
+            if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') {
+                e.preventDefault();
+                setSearchOpen((v) => !v);
+            }
+        };
+        window.addEventListener('keydown', onKey);
+        onCleanup(() => window.removeEventListener('keydown', onKey));
+    });
+    return (<div class="min-h-screen flex flex-col">
+      <Header onMenu={() => setMenuOpen((v) => !v)} onSearch={() => setSearchOpen(true)}/>
+
+      <div class="flex-1 grid grid-cols-1 lg:grid-cols-[220px_1fr] max-w-[1400px] w-full mx-auto">
+        <Sidebar class="hidden lg:block border-r border-line sticky top-14 self-start h-[calc(100vh-3.5rem)] overflow-y-auto"/>
+
+        <div class={`lg:hidden fixed inset-0 z-40 bg-black/30 transition-opacity duration-200 ${menuOpen() ? 'opacity-100' : 'opacity-0 pointer-events-none'}`} onClick={() => setMenuOpen(false)}>
+          <div class={`absolute inset-y-0 left-0 w-64 bg-bg border-r border-line overflow-y-auto pt-14 transition-transform duration-200 ease-out ${menuOpen() ? 'translate-x-0' : '-translate-x-full'}`} onClick={(e) => e.stopPropagation()}>
+            <Sidebar onNavigate={() => setMenuOpen(false)}/>
+          </div>
+        </div>
+
+        <main class="min-w-0 px-6 lg:px-12 pt-8 pb-20 max-w-[860px] wrap-break-word">{props.children}</main>
+      </div>
+
+      <SearchPalette open={searchOpen} onClose={() => setSearchOpen(false)}/>
+    </div>);
+});
+//# sourceMappingURL=Layout.jsx.map

package/dist/esm/ui/components/Layout.jsx.map

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

package/dist/esm/ui/components/Link.jsx

@@ -0,0 +1,34 @@
+import { Show } from 'solid-js';
+import { A } from '@solidjs/router';
+import { useSlugFor } from "../hooks/index.js";
+import { Syntax } from "./Syntax.jsx";
+export const Link = (props) => {
+    return (<A href={props.href} class="underline decoration-line underline-offset-[3px] hover:opacity-70">
+      {props.children}
+    </A>);
+};
+/**
+ * Link to an in-project declaration by id, with a fallback rendering when
+ * the target isn't resolvable. The `?` prefix marks anonymous external
+ * references the resolver couldn't anchor to anything.
+ */
+Link.Type = (props) => {
+    const slugs = useSlugFor();
+    const slug = () => (props.id != null ? slugs.byId(props.id) : undefined);
+    return (<>
+      <Show when={props.external === 'anonymous'}>
+        <Syntax.Punct>?</Syntax.Punct>
+      </Show>
+      <Show when={slug()} fallback={<Syntax.Name>{props.name}</Syntax.Name>}>
+        <Link href={`/${slug()}`}>{props.name}</Link>
+      </Show>
+    </>);
+};
+Link.ByName = (props) => {
+    const slugs = useSlugFor();
+    const slug = () => slugs.byName(props.name);
+    return (<Show when={slug()} fallback={<Syntax.Name>{props.name}</Syntax.Name>}>
+      <Link href={`/${slug()}`}>{props.name}</Link>
+    </Show>);
+};
+//# sourceMappingURL=Link.jsx.map

package/dist/esm/ui/components/Link.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.jsx","sourceRoot":"","sources":["../../../../src/ui/components/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAA;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAyC,EAAE,EAAE;IAChE,OAAO,CACL,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,mEAAmE,CAC5F;MAAA,CAAC,KAAK,CAAC,QAAQ,CACjB;IAAA,EAAE,CAAC,CAAC,CACL,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,IAAI,CAAC,IAAI,GAAG,CAAC,KAAsG,EAAE,EAAE;IACrH,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACxE,OAAO,CACL,EACE;MAAA,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC,CACzC;QAAA,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAC/B;MAAA,EAAE,IAAI,CACN;MAAA,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CACpE;QAAA,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAC9C;MAAA,EAAE,IAAI,CACR;IAAA,GAAG,CACJ,CAAA;AACH,CAAC,CAAA;AAED,IAAI,CAAC,MAAM,GAAG,CAAC,KAAuB,EAAE,EAAE;IACxC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CACpE;MAAA,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAC9C;IAAA,EAAE,IAAI,CAAC,CACR,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/ui/components/LivePreview/Example.jsx

@@ -0,0 +1,76 @@
+import { createEffect, createSignal, onCleanup, Show } from 'solid-js';
+import { Sandbox } from "./Sandbox.jsx";
+import { firstCodeBlock, langOf } from "../../context/index.js";
+import { CodeEditor } from "../Code/index.jsx";
+import { TagSection } from "../Comment.jsx";
+export const LiveExample = (props) => {
+    const preview = useWithPreview(props);
+    return (<TagSection tag={props.tag} description={props.tag.caption}>
+      <div class="rounded-lg border border-line">
+        <div class="p-4 bg-code-bg">
+          <CodeEditor lang={props.language ?? langOf(preview.lang)} readonly={props.readonly} value={preview.value} onChange={preview.onChange}/>
+        </div>
+        <div class="relative min-h-12">
+          <Sandbox class="border-t border-line p-4" isolate={props.isolate} ref={preview.onBind}/>
+          <Show when={preview.error()}>
+            {(msg) => (<div class="absolute inset-0 w-full h-full flex items-center justify-start p-4 text-xs text-red-500 border-t border-red-500/30 ">
+                <div class="flex gap-2">
+                  <span aria-hidden="true" class="select-none leading-5">
+                    ⚠
+                  </span>
+                  <pre class="overflow-x-auto whitespace-pre-wrap wrap-break-word font-mono leading-5">{msg()}</pre>
+                </div>
+              </div>)}
+          </Show>
+        </div>
+      </div>
+    </TagSection>);
+};
+const useWithPreview = (props) => {
+    const block = firstCodeBlock(props.tag.code);
+    const [host, setHost] = createSignal(null);
+    const [code, setCode] = createSignal(block.code);
+    const [error, setError] = createSignal();
+    let dispose;
+    const teardown = () => {
+        try {
+            if (typeof dispose === 'function')
+                dispose();
+            host()?.replaceChildren();
+        }
+        catch (err) {
+            console.error('[LiveExample] teardown failed', err);
+        }
+        dispose = undefined;
+    };
+    createEffect(() => {
+        const src = code();
+        const target = host();
+        if (!target)
+            return;
+        teardown();
+        try {
+            dispose = props.run(src, target);
+            setError(undefined);
+        }
+        catch (err) {
+            target.replaceChildren();
+            setError(messageOf(err));
+            if (props.onError)
+                props.onError(err);
+            else
+                console.error('[LiveExample] failed to run', err);
+        }
+    });
+    onCleanup(teardown);
+    const onChange = (code) => setCode(code);
+    const value = () => code();
+    const onBind = (h) => setHost(h);
+    return { onBind, onChange, value, error, lang: block.lang };
+};
+const messageOf = (err) => {
+    if (err instanceof Error)
+        return err.message || err.name;
+    return String(err);
+};
+//# sourceMappingURL=Example.jsx.map

package/dist/esm/ui/components/LivePreview/Example.jsx.map

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