@lickle/docs 0.0.0-dev.1

package/dist/esm/ui/context/markup/shiki.js

@@ -0,0 +1,58 @@
+import { extractCodeBlocks } from "./util.js";
+export const highlighter = async () => {
+    const h = await getHighlighter();
+    const codeToHtml = (options) => {
+        const opts = {
+            lang: options.lang ?? 'ts',
+            themes: { light: 'github-light', dark: 'github-dark' },
+            defaultColor: false,
+            structure: options.structure,
+        };
+        if (options.markdown) {
+            const extracted = extractCodeBlocks(options.text)?.[0];
+            if (extracted) {
+                if (!h || !extracted)
+                    return '';
+                const text = extracted.code ?? options.text;
+                const lang = extracted.lang ?? options.lang ?? 'ts';
+                return h.codeToHtml(text, { ...opts, lang: lang });
+            }
+        }
+        return h.codeToHtml(options.text, opts);
+    };
+    return { codeToHtml };
+};
+/**
+ * Fine-grained Shiki bundle: only the langs/themes below are emitted as chunks.
+ * Importing the default `shiki` entry would code-split every grammar and theme.
+ */
+export const getHighlighter = () => {
+    if (!highlighterPromise)
+        highlighterPromise = buildHighlighter();
+    return highlighterPromise;
+};
+let highlighterPromise = null;
+const buildHighlighter = () => {
+    return Promise.all([
+        import('shiki/core'),
+        import('shiki/engine/javascript'),
+        import('shiki/themes/github-light.mjs'),
+        import('shiki/themes/github-dark.mjs'),
+        Promise.all([
+            import('shiki/langs/typescript.mjs'),
+            import('shiki/langs/tsx.mjs'),
+            import('shiki/langs/javascript.mjs'),
+            import('shiki/langs/jsx.mjs'),
+            import('shiki/langs/json.mjs'),
+            import('shiki/langs/bash.mjs'),
+            import('shiki/langs/html.mjs'),
+            import('shiki/langs/css.mjs'),
+            import('shiki/langs/markdown.mjs'),
+        ]),
+    ]).then(([core, js, light, dark, langs]) => core.createHighlighterCore({
+        engine: js.createJavaScriptRegexEngine(),
+        themes: [light.default, dark.default],
+        langs: langs.map((m) => m.default),
+    }));
+};
+//# sourceMappingURL=shiki.js.map

package/dist/esm/ui/context/markup/shiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.js","sourceRoot":"","sources":["../../../../../src/ui/context/markup/shiki.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAW7C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAA0B,EAAE;IAC1D,MAAM,CAAC,GAAG,MAAM,cAAc,EAAE,CAAA;IAChC,MAAM,UAAU,GAAG,CAAC,OAA0B,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE;YACtD,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,OAAO,CAAC,SAAS;SACpB,CAAA;QAEV,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACtD,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS;oBAAE,OAAO,EAAE,CAAA;gBAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAA;gBAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAA;gBACnD,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACpD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACzC,CAAC,CAAA;IACD,OAAO,EAAE,UAAU,EAAE,CAAA;AACvB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA6B,EAAE;IAC3D,IAAI,CAAC,kBAAkB;QAAE,kBAAkB,GAAG,gBAAgB,EAAE,CAAA;IAChE,OAAO,kBAAkB,CAAA;AAC3B,CAAC,CAAA;AACD,IAAI,kBAAkB,GAAoC,IAAI,CAAA;AAE9D,MAAM,gBAAgB,GAAG,GAA6B,EAAE;IACtD,OAAO,OAAO,CAAC,GAAG,CAAC;QACjB,MAAM,CAAC,YAAY,CAAC;QACpB,MAAM,CAAC,yBAAyB,CAAC;QACjC,MAAM,CAAC,+BAA+B,CAAC;QACvC,MAAM,CAAC,8BAA8B,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC;YACV,MAAM,CAAC,4BAA4B,CAAC;YACpC,MAAM,CAAC,qBAAqB,CAAC;YAC7B,MAAM,CAAC,4BAA4B,CAAC;YACpC,MAAM,CAAC,qBAAqB,CAAC;YAC7B,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,qBAAqB,CAAC;YAC7B,MAAM,CAAC,0BAA0B,CAAC;SACnC,CAAC;KACH,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CACzC,IAAI,CAAC,qBAAqB,CAAC;QACzB,MAAM,EAAE,EAAE,CAAC,2BAA2B,EAAE;QACxC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;QACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACnC,CAAC,CACH,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/ui/context/markup/util.js

@@ -0,0 +1,22 @@
+const CODE_BLOCK_RE = /```([^\n]*)\n([\s\S]*?)```/g;
+export const extractCodeBlocks = (input) => [
+    ...(input?.matchAll(CODE_BLOCK_RE)?.map((m) => ({ lang: m[1], code: m[2] })) ?? []),
+];
+export const firstCodeBlock = (input) => extractCodeBlocks(input)?.[0] ?? { lang: '', code: input };
+export const getUnfencedCode = (code) => firstCodeBlock(code).code;
+const LANGS = ['ts', 'tsx', 'js', 'jsx', 'json', 'bash', 'html', 'css', 'md'];
+export const langOf = (info) => {
+    const raw = (info ?? '').trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+    if (!raw)
+        return 'text';
+    if (LANGS.includes(raw))
+        return raw;
+    if (raw === 'sh' || raw === 'zsh')
+        return 'bash';
+    if (raw === 'typescript')
+        return 'ts';
+    if (raw === 'javascript')
+        return 'js';
+    return 'text';
+};
+//# sourceMappingURL=util.js.map

package/dist/esm/ui/context/markup/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../../src/ui/context/markup/util.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,6BAA6B,CAAA;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAoC,EAAE,CAAC;IACpF,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;CACtF,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAkC,EAAE,CAC9E,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;AAE1E,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;AAC7E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAwB,EAAE,EAAE;IACjD,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACpE,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAA;IACvB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IACnC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,MAAM,CAAA;IAChD,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IACrC,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/esm/ui/context/project/index.jsx

@@ -0,0 +1,27 @@
+import { createContext, createMemo, useContext } from 'solid-js';
+import { ComponentsProvider } from "../components.jsx";
+import { createProject } from "./indexed.js";
+import * as T from "./types.js";
+export * as Types from "./types.js";
+const ProjectCtx = createContext();
+export const ProjectProvider = (props) => {
+    const bag = createMemo(() => createProject(props.json()));
+    return (<ComponentsProvider value={props.components}>
+      <ProjectCtx.Provider value={bag}>{props.children}</ProjectCtx.Provider>
+    </ComponentsProvider>);
+};
+export const useProject = () => {
+    const fn = useContext(ProjectCtx);
+    if (!fn)
+        throw new Error('useProject must be used within <ProjectProvider>');
+    return fn;
+};
+const DeclarationIdContext = createContext(() => undefined);
+/**
+ * Scope a subtree to a reflection id so nested `<Comment>`s pass it to tag
+ * handlers. The id is exposed as a reactive accessor so consumers re-track
+ * when the surrounding route swaps to a new declaration.
+ */
+export const DeclarationScope = (props) => (<DeclarationIdContext.Provider value={() => props.id}>{props.children}</DeclarationIdContext.Provider>);
+export const useDeclarationId = () => useContext(DeclarationIdContext);
+//# sourceMappingURL=index.jsx.map

package/dist/esm/ui/context/project/index.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.jsx","sourceRoot":"","sources":["../../../../../src/ui/context/project/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAA;AAK/E,OAAO,EAAE,kBAAkB,EAAmB,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,OAAO,KAAK,CAAC,MAAM,YAAY,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC,MAAM,UAAU,GAAG,aAAa,EAAuB,CAAA;AASvD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC7D,MAAM,GAAG,GAAG,UAAU,CAAY,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACpE,OAAO,CACL,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAC1C;MAAA,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,QAAQ,CACxE;IAAA,EAAE,kBAAkB,CAAC,CACtB,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,GAAwB,EAAE;IAClD,MAAM,EAAE,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IAC5E,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,aAAa,CAA+B,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAEzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA4C,EAAE,EAAE,CAAC,CAChF,CAAC,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CACvG,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAiC,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA"}

package/dist/esm/ui/context/project/indexed.js

@@ -0,0 +1,47 @@
+import * as Types from "./types.js";
+export const createProject = (json) => {
+    const _byId = new Map();
+    const _bySlug = new Map();
+    const _routesById = new Map();
+    const _routesBySlug = new Map();
+    const _slugByName = new Map();
+    const sourceLink = (src) => {
+        if (!json.repository?.fileUrl)
+            return undefined;
+        return json.repository.fileUrl.replace('{PATH}', src.file).replace('{LINE}', src.line.toString());
+    };
+    for (const declaration of json.declarations) {
+        _byId.set(declaration.id, declaration);
+    }
+    const indexRoute = (r) => {
+        _routesBySlug.set(r.slug, r);
+        // Markdown pages carry no declaration id, so they only resolve by slug.
+        if (r.page.kind !== 'markdown') {
+            _bySlug.set(r.slug, _byId.get(r.page.id));
+            _routesById.set(r.page.id, r);
+            const name = _byId.get(r.page.id)?.name;
+            if (name && !_slugByName.has(name))
+                _slugByName.set(name, r);
+            _slugByName.set(r.page.qualified, r);
+        }
+        for (const child of r.children)
+            indexRoute(child);
+    };
+    for (const route of json.routes)
+        indexRoute(route);
+    const byId = (id) => _byId.get(id);
+    const bySlug = (slug) => _bySlug.get(slug);
+    const routeForId = (id) => _routesById.get(id);
+    const routeForSlug = (slug) => _routesBySlug.get(slug);
+    const routeByName = (name) => _slugByName.get(name);
+    const p = json;
+    hide(p, 'byId', byId);
+    hide(p, 'bySlug', bySlug);
+    hide(p, 'routeForId', routeForId);
+    hide(p, 'routeForSlug', routeForSlug);
+    hide(p, 'routeByName', routeByName);
+    hide(p, 'sourceLink', sourceLink);
+    return p;
+};
+const hide = (obj, key, value) => Object.defineProperty(obj, key, { value, enumerable: false, configurable: true });
+//# sourceMappingURL=indexed.js.map

package/dist/esm/ui/context/project/indexed.js.map

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

package/dist/esm/ui/context/project/types.js

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

package/dist/esm/ui/context/project/types.js.map

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

package/dist/esm/ui/context/theme.jsx

@@ -0,0 +1,36 @@
+import { createContext, createSignal, onMount, useContext } from 'solid-js';
+const STORAGE_KEY = 'lickle-docs-theme';
+const Ctx = createContext();
+const read = () => {
+    if (typeof localStorage === 'undefined')
+        return 'system';
+    const v = localStorage.getItem(STORAGE_KEY);
+    return v === 'light' || v === 'dark' ? v : 'system';
+};
+const apply = (m) => {
+    const el = document.documentElement;
+    if (m === 'system')
+        delete el.dataset['theme'];
+    else
+        el.dataset['theme'] = m;
+};
+export const ThemeProvider = (props) => {
+    const [mode, set] = createSignal(read());
+    onMount(() => apply(mode()));
+    const setMode = (m) => {
+        if (m === 'system')
+            localStorage.removeItem(STORAGE_KEY);
+        else
+            localStorage.setItem(STORAGE_KEY, m);
+        set(m);
+        apply(m);
+    };
+    return <Ctx.Provider value={{ mode, setMode }}>{props.children}</Ctx.Provider>;
+};
+export const useTheme = () => {
+    const ctx = useContext(Ctx);
+    if (!ctx)
+        throw new Error('useTheme must be used within a <ThemeProvider>');
+    return ctx;
+};
+//# sourceMappingURL=theme.jsx.map

package/dist/esm/ui/context/theme.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.jsx","sourceRoot":"","sources":["../../../../src/ui/context/theme.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAI3E,MAAM,WAAW,GAAG,mBAAmB,CAAA;AAOvC,MAAM,GAAG,GAAG,aAAa,EAAY,CAAA;AAErC,MAAM,IAAI,GAAG,GAAc,EAAE;IAC3B,IAAI,OAAO,YAAY,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAA;IACxD,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAC3C,OAAO,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,KAAK,GAAG,CAAC,CAAY,EAAE,EAAE;IAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAA;IACnC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;;QACzC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAgC,EAAE,EAAE;IAChE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,YAAY,CAAY,IAAI,EAAE,CAAC,CAAA;IAEnD,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAE5B,MAAM,OAAO,GAAG,CAAC,CAAY,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,QAAQ;YAAE,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;;YACnD,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACzC,GAAG,CAAC,CAAC,CAAC,CAAA;QACN,KAAK,CAAC,CAAC,CAAC,CAAA;IACV,CAAC,CAAA;IAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;AAChF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAa,EAAE;IACrC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IAC3E,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/dist/esm/ui/hooks/index.js

@@ -0,0 +1,94 @@
+import { createMemo } from 'solid-js';
+import { createSearchEngine } from "../util/search.js";
+import { useProject } from "../context/index.js";
+import { commentSummaryText } from "../util/comment.js";
+// ============================================================================
+// SELECTOR HOOKS
+// Thin readers over the project bag. Components should reach for these instead
+// of pulling `project` apart directly.
+// ============================================================================
+/**
+ * Slug accessors keyed two ways. `byId` is the id-driven path used by render
+ * code; `byName` powers `{@link Foo}` / `<code>Foo</code>` resolution (short
+ * names and qualified names both resolve via the project's name index).
+ */
+export const useSlugFor = () => {
+    const project = useProject();
+    return {
+        byId: (id) => project().routeForId(id)?.slug,
+        byName: (name) => project().routeByName(name)?.slug,
+    };
+};
+export const useReferences = (id) => {
+    const project = useProject();
+    return createMemo(() => buildReferenceRows(project(), id()));
+};
+const buildReferenceRows = (project, id) => {
+    const route = project.routeForId(id);
+    if (!route || route.page.kind === 'markdown')
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const refId of route.page.referencedIn) {
+        if (refId === id || seen.has(refId))
+            continue;
+        seen.add(refId);
+        const refRoute = project.routeForId(refId);
+        const decl = project.byId(refId);
+        if (!refRoute || refRoute.page.kind === 'markdown' || !decl)
+            continue;
+        const qualified = refRoute.page.qualified;
+        const dot = qualified.lastIndexOf('.');
+        out.push({
+            decl,
+            slug: refRoute.slug,
+            module: dot < 0 ? '' : qualified.slice(0, dot),
+            name: dot < 0 ? qualified : qualified.slice(dot + 1),
+            qualified,
+            summary: commentSummaryText(decl.comment),
+        });
+    }
+    return out.sort((a, b) => a.qualified.localeCompare(b.qualified));
+};
+// ============================================================================
+// SEARCH
+// `createSearchEngine` is async (Orama indexing). Cached per project so the
+// palette pays the cost once per session, even if it opens and closes.
+// ============================================================================
+const searchCache = new WeakMap();
+/**
+ * Returns a thunk that builds (or returns the cached) search engine for the
+ * current project. Callers wrap the thunk in their own resource/effect.
+ */
+export const useSearch = () => {
+    const project = useProject();
+    return () => buildSearch(project());
+};
+const buildSearch = (project) => {
+    const cached = searchCache.get(project);
+    if (cached)
+        return cached;
+    const p = createSearchEngine(project);
+    searchCache.set(project, p);
+    return p;
+};
+export const useCommentMarkdown = (comment) => {
+    const slugs = useSlugFor();
+    const slugOf = (name) => slugs.byName(name);
+    return createMemo(() => commentToMarkdown(comment(), slugOf));
+};
+const commentToMarkdown = (comment, slugOf) => {
+    let out = '';
+    for (const p of comment.parts) {
+        if (p.kind === 'text') {
+            out += p.text;
+            continue;
+        }
+        const label = p.text ?? p.target;
+        const slug = slugOf(p.target);
+        const display = p.style === 'code' ? `\`${label}\`` : label;
+        out += slug ? `[${display}](/${slug})` : display;
+    }
+    return out;
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/ui/hooks/index.js.map

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

package/dist/esm/ui/index.js

@@ -0,0 +1,5 @@
+export * from "./components/index.js";
+export * from "./context/index.js";
+export * from "./renderer.jsx";
+export * from "./App.jsx";
+//# sourceMappingURL=index.js.map

package/dist/esm/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA"}

package/dist/esm/ui/renderer.jsx

@@ -0,0 +1,21 @@
+import { createMemo } from 'solid-js';
+import { render } from 'solid-js/web';
+import { App } from "./App.jsx";
+import { getJson, getComponents, setComponents } from "./context/global.js";
+export const renderApp = (props) => {
+    const json = createMemo(() => {
+        const j = typeof props?.json === 'function' ? props?.json() : (props?.json ?? null);
+        if (!j)
+            return getJson();
+        return j;
+    });
+    const components = createMemo(() => {
+        const c = typeof props?.components === 'function' ? props?.components() : (props?.components ?? null);
+        if (!c)
+            return getComponents();
+        return c;
+    });
+    render(() => <App json={json} components={components}/>, props?.root ?? document.getElementById('root'));
+};
+export const registerComponent = (key, Component) => setComponents({ [key]: Component });
+//# sourceMappingURL=renderer.jsx.map

package/dist/esm/ui/renderer.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.jsx","sourceRoot":"","sources":["../../../src/ui/renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAE/B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAG3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAIzB,EAAE,EAAE;IACH,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE;QAC3B,MAAM,CAAC,GAAG,OAAO,KAAK,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,CAAA;QACnF,IAAI,CAAC,CAAC;YAAE,OAAO,OAAO,EAAE,CAAA;QACxB,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;IAEF,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,OAAO,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC,CAAA;QACrG,IAAI,CAAC,CAAC;YAAE,OAAO,aAAa,EAAE,CAAA;QAC9B,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,EAAG,EAAE,KAAK,EAAE,IAAI,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAE,CAAC,CAAA;AAC5G,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA6B,GAAM,EAAE,SAAwB,EAAE,EAAE,CAChG,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA"}

package/dist/esm/ui/util/comment.js

@@ -0,0 +1,14 @@
+/** Single-line plain-text preview of a comment. Used by listings/cards. */
+export const commentSummaryText = (comment) => {
+    if (!comment)
+        return '';
+    let out = '';
+    for (const p of comment.parts) {
+        if (p.kind === 'text')
+            out += p.text;
+        else
+            out += p.text ?? p.target;
+    }
+    return out.trim();
+};
+//# sourceMappingURL=comment.js.map

package/dist/esm/ui/util/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../../src/ui/util/comment.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAkC,EAAU,EAAE;IAC/E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAA;;YAC/B,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAA;IAChC,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;AACnB,CAAC,CAAA"}

package/dist/esm/ui/util/kind.js

@@ -0,0 +1,85 @@
+const LABELS = {
+    module: 'module',
+    namespace: 'namespace',
+    export: 'export',
+    variable: 'variable',
+    function: 'function',
+    class: 'class',
+    interface: 'interface',
+    'type-alias': 'type',
+    enum: 'enum',
+    'enum-member': 'member',
+    property: 'property',
+    method: 'method',
+    parameter: 'parameter',
+    signature: 'signature',
+    'index-signature': 'index signature',
+    record: 'object',
+    unknown: 'unknown',
+};
+export const labelOf = (kind) => LABELS[kind] ?? 'symbol';
+const SHORTS = {
+    module: 'M',
+    namespace: 'N',
+    variable: 'V',
+    function: 'ƒ',
+    class: 'C',
+    interface: 'I',
+    'type-alias': 'T',
+    enum: 'E',
+    property: 'p',
+    method: 'm',
+};
+export const shortOf = (kind) => SHORTS[kind] ?? '·';
+const ROUTABLE = new Set([
+    'module',
+    'namespace',
+    'class',
+    'interface',
+    'function',
+    'variable',
+    'enum',
+    'type-alias',
+]);
+export const isRoutable = (kind) => ROUTABLE.has(kind);
+const PLURAL = {
+    module: 'modules',
+    namespace: 'namespaces',
+    export: 'exports',
+    variable: 'variables',
+    function: 'functions',
+    class: 'classes',
+    interface: 'interfaces',
+    'type-alias': 'types',
+    enum: 'enums',
+    'enum-member': 'members',
+    property: 'properties',
+    method: 'methods',
+    parameter: 'parameters',
+    signature: 'signatures',
+    'index-signature': 'index signatures',
+    record: 'objects',
+    unknown: 'unknown',
+};
+export const pluralLabel = (kind) => PLURAL[kind] ?? `${labelOf(kind)}s`;
+/**
+ * Canonical group ordering: functions → variables → types → everything else.
+ * Unknown titles sort to the end.
+ */
+const GROUP_ORDER = [
+    'modules',
+    'namespaces',
+    'functions',
+    'variables',
+    'types',
+    'classes',
+    'interfaces',
+    'enums',
+    'properties',
+    'methods',
+];
+export const groupOrder = (title) => {
+    const i = GROUP_ORDER.indexOf(title.trim().toLowerCase());
+    return i < 0 ? GROUP_ORDER.length : i;
+};
+//# sourceMappingURL=kind.js.map

package/dist/esm/ui/util/kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind.js","sourceRoot":"","sources":["../../../../src/ui/util/kind.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,GAAyB;IACnC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,MAAM;IACpB,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,QAAQ;IACvB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,iBAAiB;IACpC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAY,CAAC,IAAI,QAAQ,CAAA;AAExF,MAAM,MAAM,GAAkC;IAC5C,MAAM,EAAE,GAAG;IACX,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG;CACZ,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAY,CAAC,IAAI,GAAG,CAAA;AAEnF,MAAM,QAAQ,GAAsB,IAAI,GAAG,CAAC;IAC1C,QAAQ;IACR,WAAW;IACX,OAAO;IACP,WAAW;IACX,UAAU;IACV,UAAU;IACV,MAAM;IACN,YAAY;CACb,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAmB,EAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAY,CAAC,CAAA;AAEtF,MAAM,MAAM,GAAyB;IACnC,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,YAAY;IACvB,YAAY,EAAE,OAAO;IACrB,IAAI,EAAE,OAAO;IACb,aAAa,EAAE,SAAS;IACxB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,iBAAiB,EAAE,kBAAkB;IACrC,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAmB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAY,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAA;AAEvG;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB,SAAS;IACT,YAAY;IACZ,WAAW;IACX,WAAW;IACX,OAAO;IACP,SAAS;IACT,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,SAAS;CACV,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AACvC,CAAC,CAAA"}

package/dist/esm/ui/util/markdown.js

@@ -0,0 +1,66 @@
+import { Marked } from 'marked';
+let highlighterPromise = null;
+const LANGS = ['ts', 'tsx', 'js', 'jsx', 'json', 'bash', 'html', 'css', 'md'];
+export const getHighlighter = () => {
+    if (!highlighterPromise) {
+        highlighterPromise = import('shiki').then((s) => s.createHighlighter({ themes: ['github-light', 'github-dark'], langs: LANGS }));
+    }
+    return highlighterPromise;
+};
+const escape = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+export const langOf = (info) => {
+    const raw = (info ?? '').trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+    if (!raw)
+        return 'text';
+    if (LANGS.includes(raw))
+        return raw;
+    if (raw === 'sh' || raw === 'zsh')
+        return 'bash';
+    if (raw === 'typescript')
+        return 'ts';
+    if (raw === 'javascript')
+        return 'js';
+    return 'text';
+};
+const ID = /^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/;
+const buildMarked = (h, lookup) => {
+    const m = new Marked({
+        gfm: true,
+        breaks: false,
+        renderer: {
+            code({ text, lang }) {
+                const language = langOf(lang);
+                if (h && language !== 'text') {
+                    try {
+                        return h.codeToHtml(text, {
+                            lang: language,
+                            themes: { light: 'github-light', dark: 'github-dark' },
+                            defaultColor: false,
+                        });
+                    }
+                    catch {
+                        /* fall through */
+                    }
+                }
+                return `<pre class="codeblock"><code>${escape(text)}</code></pre>`;
+            },
+            codespan({ text }) {
+                if (lookup && ID.test(text)) {
+                    const slug = lookup(text);
+                    if (slug)
+                        return `<a href="/${slug}" class="codelink"><code>${text}</code></a>`;
+                }
+                return `<code>${text}</code>`;
+            },
+        },
+    });
+    return m;
+};
+export const renderMarkdown = async (src, lookup) => {
+    const h = await getHighlighter().catch(() => null);
+    return buildMarked(h, lookup).parse(src);
+};
+export const renderMarkdownSync = (src, lookup) => {
+    return buildMarked(null, lookup).parse(src);
+};
+//# sourceMappingURL=markdown.js.map

package/dist/esm/ui/util/markdown.js.map

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

package/dist/esm/ui/util/search.js

@@ -0,0 +1,75 @@
+import { create, insert, search } from '@orama/orama';
+import {} from "../context/index.js";
+import {} from "./kind.js";
+/**
+ * Build an in-browser Orama index over every routed page in `project`.
+ * Names are boosted above qualified paths so exact-name hits rank first;
+ * `tolerance: 1` allows one-character typos. Each declaration is indexed once
+ * — re-export routes share a declaration id, so they're de-duplicated here.
+ */
+export const createSearchEngine = async (project) => {
+    const db = await create({
+        // `terms` holds the name/qualified split into sub-words so `provider`
+        // matches `ProjectProvider` and `render error` matches `renderError`.
+        schema: { name: 'string', qualified: 'string', kind: 'string', slug: 'string', file: 'string', terms: 'string' },
+        components: { tokenizer: { stemming: false } },
+    });
+    const seen = new Set();
+    const walk = async (routes) => {
+        for (const r of routes) {
+            if (r.page.kind !== 'markdown' && !seen.has(r.page.id)) {
+                seen.add(r.page.id);
+                const decl = project.byId(r.page.id);
+                const kind = (decl?.kind ?? 'module');
+                await insert(db, {
+                    name: r.label,
+                    qualified: r.page.qualified,
+                    kind,
+                    slug: r.slug,
+                    file: decl?.sources?.[0]?.file ?? '',
+                    terms: termsOf(r.label, r.page.qualified),
+                });
+            }
+            await walk(r.children);
+        }
+    };
+    await walk(project.routes);
+    return {
+        query: async (term, limit = 20) => {
+            const t = term.trim();
+            if (!t)
+                return [];
+            const res = await search(db, {
+                term: t,
+                properties: ['name', 'qualified', 'terms'],
+                boost: { name: 3, qualified: 2, terms: 1 },
+                tolerance: 1,
+                limit,
+            });
+            return res.hits.map((h) => h.document);
+        },
+    };
+};
+/** Sub-words of the indexed strings, so partial / multi-word queries match. */
+const termsOf = (...sources) => {
+    const words = new Set();
+    for (const s of sources)
+        for (const w of splitWords(s))
+            words.add(w);
+    return [...words].join(' ');
+};
+/**
+ * Split an identifier into lowercase words on separators and case boundaries:
+ * `getHTMLParser` -> `get html parser`, `render-error` -> `render error`,
+ * `a.b_c` -> `a b c`.
+ */
+const splitWords = (input) => input
+    .split(/[\s._/\\-]+/)
+    .flatMap((part) => part
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+    .replace(/([A-Za-z])([0-9])/g, '$1 $2')
+    .split(/\s+/))
+    .map((w) => w.toLowerCase())
+    .filter(Boolean);
+//# sourceMappingURL=search.js.map

package/dist/esm/ui/util/search.js.map

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