@axle-lang/ui 0.1.0

package/dist/components/nav/PrevNext.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+  // Prev / Next footer for doc pages.
+  let {
+    prev,
+    next
+  }: {
+    prev?: { label: string; href: string };
+    next?: { label: string; href: string };
+  } = $props();
+</script>
+
+<div class="mt-14 pt-6 border-t border-line flex items-center justify-between">
+  {#if prev}
+    <a href={prev.href} class="flex flex-col gap-1 text-[13px] text-muted hover:text-fg">
+      <span class="text-faint">Previous</span>
+      <span class="font-medium">← {prev.label}</span>
+    </a>
+  {:else}
+    <span></span>
+  {/if}
+  {#if next}
+    <a href={next.href} class="flex flex-col gap-1 text-right text-[13px] text-muted hover:text-fg">
+      <span class="text-faint">Next</span>
+      <span class="font-medium text-accent">{next.label} →</span>
+    </a>
+  {/if}
+</div>

package/dist/components/nav/PrevNext.svelte.d.ts

@@ -0,0 +1,13 @@
+type $$ComponentProps = {
+    prev?: {
+        label: string;
+        href: string;
+    };
+    next?: {
+        label: string;
+        href: string;
+    };
+};
+declare const PrevNext: import("svelte").Component<$$ComponentProps, {}, "">;
+type PrevNext = ReturnType<typeof PrevNext>;
+export default PrevNext;

package/dist/components/nav/RightRail.svelte

@@ -0,0 +1,30 @@
+<script lang="ts">
+  import Icon from '../atoms/Icon.svelte';
+
+  // Right "On this page" table of contents.
+  let {
+    items = [],
+    editHref = '#'
+  }: { items?: { id: string; label: string; sub?: boolean }[]; editHref?: string } = $props();
+</script>
+
+<aside
+  class="hidden xl:block w-[232px] shrink-0 sticky top-14 self-start h-[calc(100vh-3.5rem)] overflow-y-auto axle-scroll py-10 px-6"
+>
+  <div class="text-[11px] font-semibold uppercase tracking-[0.08em] text-faint mb-3">
+    On this page
+  </div>
+  {#each items as t}
+    <a
+      href={`#${t.id}`}
+      class="block py-1.5 text-[13px] text-muted hover:text-fg transition-colors {t.sub
+        ? 'pl-3 text-[12.5px]'
+        : ''}">{t.label}</a
+    >
+  {/each}
+  <div class="mt-6 pt-5 border-t border-line">
+    <a href={editHref} class="flex items-center gap-2 text-[13px] text-muted hover:text-fg">
+      <Icon name="edit" size={15} /> Suggest an edit
+    </a>
+  </div>
+</aside>

package/dist/components/nav/RightRail.svelte.d.ts

@@ -0,0 +1,11 @@
+type $$ComponentProps = {
+    items?: {
+        id: string;
+        label: string;
+        sub?: boolean;
+    }[];
+    editHref?: string;
+};
+declare const RightRail: import("svelte").Component<$$ComponentProps, {}, "">;
+type RightRail = ReturnType<typeof RightRail>;
+export default RightRail;

package/dist/components/nav/Sidebar.svelte

@@ -0,0 +1,33 @@
+<script lang="ts">
+  import { page } from '$app/state';
+  import { getSite, type NavSection } from '../../site/site.js';
+  import { navItem } from '../../utils/variants.js';
+
+  // Sidebar sections come from the site context (generated from
+  // docs/src/SUMMARY.md by gen-nav). The active item is derived from
+  // the current URL — no prop to thread through every page.
+  const { nav } = getSite();
+  const sections: NavSection[] = nav ?? [];
+
+  const norm = (p: string) => (p === '/' ? '/' : p.replace(/\/$/, ''));
+
+  const itemClass = (href: string, indent?: boolean) =>
+    navItem({ active: norm(page.url.pathname) === norm(href), indent: !!indent });
+</script>
+
+<aside
+  class="hidden lg:block w-[280px] shrink-0 sticky top-14 self-start h-[calc(100vh-3.5rem)] overflow-y-auto axle-scroll border-r border-line px-4 py-6"
+>
+  {#each sections as sec}
+    <div class="mb-1">
+      <div
+        class="px-3 mt-4 mb-1.5 text-[11px] font-semibold uppercase tracking-[0.08em] text-faint"
+      >
+        {sec.title}
+      </div>
+      {#each sec.items as it}
+        <a href={it.href} class={itemClass(it.href, it.indent)}>{it.label}</a>
+      {/each}
+    </div>
+  {/each}
+</aside>

package/dist/components/nav/Sidebar.svelte.d.ts

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const Sidebar: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type Sidebar = InstanceType<typeof Sidebar>;
+export default Sidebar;

package/dist/components/reference/MethodDetail.svelte

@@ -0,0 +1,72 @@
+<script lang="ts">
+  import { t } from 'svelte-i18n';
+  import { K } from '../../i18n/index.js';
+  import type { DocMethod } from '../../utils/types.js';
+
+  /**
+   * Full per-method detail block (signature, params, returns, throws).
+   */
+  let { methods = [] }: { methods: DocMethod[] } = $props();
+
+  const anchorId = (m: DocMethod) => 'fn-' + m.name.toLowerCase();
+</script>
+
+<h3 class="mt-12 text-[18px] font-semibold tracking-tight" id="detail">
+  {$t(K.method.detail)}
+</h3>
+
+{#each methods as m}
+  <div id={anchorId(m)} class="scroll-mt-20 border-t border-line pt-7 mt-7 first:mt-5">
+    <h4 class="group flex items-center gap-2 text-[16px] font-mono font-medium">
+      <span class="text-line group-hover:text-accent transition-colors select-none">#</span>{m.name}
+    </h4>
+
+    <div
+      class="mt-3 rounded-lg border border-line bg-surface px-4 py-3 font-mono text-[13.5px] overflow-x-auto axle-scroll"
+    >
+      {m.sig}
+    </div>
+    <p class="mt-3 text-[14.5px] leading-relaxed text-muted">{m.desc}</p>
+
+    {#if m.params?.length}
+      <div class="mt-4">
+        <div class="text-[11px] font-semibold uppercase tracking-wider text-faint mb-1">
+          {$t(K.method.parameters)}
+        </div>
+        {#each m.params as p}
+          <div class="flex gap-3 py-1.5 border-t border-line text-[13.5px]">
+            <code class="font-mono text-accent shrink-0">{p.name}</code>
+            <span class="text-muted leading-relaxed">{p.desc}</span>
+          </div>
+        {/each}
+      </div>
+    {/if}
+
+    {#if m.returns}
+      <div class="mt-4 flex gap-3 text-[13.5px]">
+        <span
+          class="text-[11px] font-semibold uppercase tracking-wider text-faint shrink-0 w-[68px] pt-0.5"
+          >{$t(K.method.returns)}</span
+        >
+        <span class="text-muted leading-relaxed">{m.returns}</span>
+      </div>
+    {/if}
+
+    {#if m.throws?.length}
+      <div class="mt-4">
+        <div class="text-[11px] font-semibold uppercase tracking-wider text-faint mb-1.5">
+          {$t(K.method.throws)}
+        </div>
+        {#each m.throws as th}
+          <div class="flex gap-2.5 py-1.5 border-t border-line text-[13.5px] items-baseline">
+            <code
+              class="font-mono text-[12.5px] rounded-md bg-[#dc2626]/10 text-[#dc2626] dark:text-[#f87171] dark:bg-[#f87171]/10 px-2 py-0.5 shrink-0"
+              >{th.type}</code
+            >
+            <span class="text-muted leading-relaxed">{th.desc}</span>
+          </div>
+        {/each}
+      </div>
+    {/if}
+  </div>
+{/each}

package/dist/components/reference/MethodDetail.svelte.d.ts

@@ -0,0 +1,7 @@
+import type { DocMethod } from '../../utils/types.js';
+type $$ComponentProps = {
+    methods: DocMethod[];
+};
+declare const MethodDetail: import("svelte").Component<$$ComponentProps, {}, "">;
+type MethodDetail = ReturnType<typeof MethodDetail>;
+export default MethodDetail;

package/dist/components/reference/MethodSummary.svelte

@@ -0,0 +1,41 @@
+<script lang="ts">
+  import Code from '../code/Code.svelte';
+  import { t } from 'svelte-i18n';
+  import { K } from '../../i18n/index.js';
+  import type { DocMethod } from '../../utils/types.js';
+
+  /**
+   * Method summary table (Type | Method and description).
+   */
+  let { methods = [], dense = false }: { methods: DocMethod[]; dense?: boolean } = $props();
+
+  const pad = $derived(dense ? 'py-2 px-4' : 'py-3 px-4');
+  const anchorId = (m: DocMethod) => 'fn-' + m.name.toLowerCase();
+  const shortSig = (m: DocMethod) => m.sig.split(' ! ')[0];
+</script>
+
+<div class="rounded-xl border border-line overflow-hidden overflow-x-auto axle-scroll">
+  <table class="w-full text-[13px] border-separate border-spacing-0">
+    <thead>
+      <tr class="bg-surface text-left text-[12px] uppercase tracking-wider text-faint">
+        <th class="font-semibold py-2.5 px-4 w-[1%] whitespace-nowrap">{$t(K.method.type)}</th>
+        <th class="font-semibold py-2.5 px-4">{$t(K.method.summary)}</th>
+      </tr>
+    </thead>
+    <tbody>
+      {#each methods as m}
+        <tr class="align-top hover:bg-surface/60 transition-colors">
+          <td class="{pad} border-t border-line font-mono text-[12px] whitespace-nowrap">
+            <Code code={m.ret} fontSize={12} lineHeight={18} class="!overflow-visible" />
+          </td>
+          <td class="{pad} border-t border-line">
+            <a href={`#${anchorId(m)}`} class="font-mono text-[13px] text-accent hover:underline"
+              >{shortSig(m)}</a
+            >
+            <span class="block text-muted mt-0.5 text-[13px] leading-snug">{m.desc}</span>
+          </td>
+        </tr>
+      {/each}
+    </tbody>
+  </table>
+</div>

package/dist/components/reference/MethodSummary.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { DocMethod } from '../../utils/types.js';
+type $$ComponentProps = {
+    methods: DocMethod[];
+    dense?: boolean;
+};
+declare const MethodSummary: import("svelte").Component<$$ComponentProps, {}, "">;
+type MethodSummary = ReturnType<typeof MethodSummary>;
+export default MethodSummary;

package/dist/i18n/index.d.ts

@@ -0,0 +1,47 @@
+export declare function initI18n(): void;
+export type Keys<T> = {
+    [P in keyof T]: T[P] extends object ? Keys<T[P]> : string;
+};
+export declare function keysOf<T extends Record<string, unknown>>(obj: T, prefix?: string): Keys<T>;
+export declare const K: Keys<{
+    nav: {
+        guide: string;
+        reference: string;
+        benchmarks: string;
+        recipes: string;
+        getStarted: string;
+    };
+    search: {
+        docs: string;
+    };
+    footer: {
+        docs: string;
+        project: string;
+        language: string;
+        link: {
+            guide: string;
+            reference: string;
+            recipes: string;
+            repo: string;
+            roadmap: string;
+            issues: string;
+            memory: string;
+            simd: string;
+            ffi: string;
+        };
+        tagline: string;
+        note: string;
+    };
+    bench: {
+        variant: string;
+        source: string;
+    };
+    method: {
+        type: string;
+        summary: string;
+        detail: string;
+        parameters: string;
+        returns: string;
+        throws: string;
+    };
+}>;

package/dist/i18n/index.js

@@ -0,0 +1,23 @@
+import { addMessages, init } from 'svelte-i18n';
+import en from './messages/en.js';
+// Register synchronously (not async `register`) so `$t` is ready during
+// SSR / prerender without a `waitLocale`. Idempotent — safe to call from
+// every app layout.
+let started = false;
+export function initI18n() {
+    if (started)
+        return;
+    started = true;
+    addMessages('en', en);
+    init({ fallbackLocale: 'en', initialLocale: 'en' });
+}
+export function keysOf(obj, prefix = '') {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${k}` : k;
+        out[k] =
+            v !== null && typeof v === 'object' ? keysOf(v, path) : path;
+    }
+    return out;
+}
+export const K = keysOf(en);

package/dist/i18n/messages/en.d.ts

@@ -0,0 +1,43 @@
+declare const _default: {
+    nav: {
+        guide: string;
+        reference: string;
+        benchmarks: string;
+        recipes: string;
+        getStarted: string;
+    };
+    search: {
+        docs: string;
+    };
+    footer: {
+        docs: string;
+        project: string;
+        language: string;
+        link: {
+            guide: string;
+            reference: string;
+            recipes: string;
+            repo: string;
+            roadmap: string;
+            issues: string;
+            memory: string;
+            simd: string;
+            ffi: string;
+        };
+        tagline: string;
+        note: string;
+    };
+    bench: {
+        variant: string;
+        source: string;
+    };
+    method: {
+        type: string;
+        summary: string;
+        detail: string;
+        parameters: string;
+        returns: string;
+        throws: string;
+    };
+};
+export default _default;

package/dist/i18n/messages/en.js

@@ -0,0 +1,50 @@
+// English chrome catalog for @axle-lang/ui — ONLY the labels the components in
+// this package render themselves (their own vocabulary). Page-level copy
+// (titles, leads, intros) lives with the pages in the consuming apps,
+// merged into the same locale via svelte-i18n `addMessages`.
+//
+// Call sites use the `K` keys object ($t(K.nav.guide)), never raw strings.
+export default {
+    nav: {
+        guide: 'Guide',
+        reference: 'Reference',
+        benchmarks: 'Benchmarks',
+        recipes: 'Recipes',
+        getStarted: 'Get started'
+    },
+    search: {
+        docs: 'Search docs'
+    },
+    footer: {
+        docs: 'Docs',
+        project: 'Project',
+        language: 'Language',
+        link: {
+            guide: 'Guide',
+            reference: 'Stdlib reference',
+            recipes: 'Recipes',
+            repo: 'GitLab',
+            roadmap: 'Roadmap',
+            issues: 'Issues',
+            memory: 'Memory model',
+            simd: 'SIMD',
+            ffi: 'FFI'
+        },
+        tagline: 'TypeScript-grade ergonomics, compiled to the machine code a careful C programmer would have written by hand.',
+        note: 'escape analysis included'
+    },
+    // BenchExplorer table chrome.
+    bench: {
+        variant: 'Variant',
+        source: 'Source'
+    },
+    // MethodSummary / MethodDetail table chrome (stdlib reference).
+    method: {
+        type: 'Type',
+        summary: 'Method and description',
+        detail: 'Method detail',
+        parameters: 'Parameters',
+        returns: 'Returns',
+        throws: 'Throws'
+    }
+};

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { default as Icon } from './components/atoms/Icon.svelte';
+export { default as Logo } from './components/atoms/Logo.svelte';
+export { default as Button } from './components/atoms/Button.svelte';
+export { default as Badge } from './components/atoms/Badge.svelte';
+export { default as Kbd } from './components/atoms/Kbd.svelte';
+export { default as CodeChip } from './components/atoms/CodeChip.svelte';
+export { default as Eyebrow } from './components/atoms/Eyebrow.svelte';
+export { default as Callout } from './components/atoms/Callout.svelte';
+export { default as HandNote } from './components/atoms/HandNote.svelte';
+export { default as ThemeToggle } from './components/atoms/ThemeToggle.svelte';
+export { default as SearchButton } from './components/atoms/SearchButton.svelte';
+export { default as Tag } from './components/atoms/Tag.svelte';
+export { default as Code } from './components/code/Code.svelte';
+export { default as CodeWindow } from './components/code/CodeWindow.svelte';
+export { default as CopyCommand } from './components/code/CopyCommand.svelte';
+export { default as DataTable } from './components/molecules/DataTable.svelte';
+export { default as PageHeading } from './components/molecules/PageHeading.svelte';
+export { default as Section } from './components/molecules/Section.svelte';
+export { default as SectionHeading } from './components/molecules/SectionHeading.svelte';
+export { default as Card } from './components/molecules/Card.svelte';
+export { default as Header } from './components/nav/Header.svelte';
+export { default as DocHeader } from './components/nav/DocHeader.svelte';
+export { default as Sidebar } from './components/nav/Sidebar.svelte';
+export { default as RightRail } from './components/nav/RightRail.svelte';
+export { default as PrevNext } from './components/nav/PrevNext.svelte';
+export { default as Footer } from './components/nav/Footer.svelte';
+export { default as DocLayout } from './components/layout/DocLayout.svelte';
+export { default as PageShell } from './components/layout/PageShell.svelte';
+export { default as Hero } from './components/landing/Hero.svelte';
+export { default as RecipeDeck } from './components/landing/RecipeDeck.svelte';
+export { default as ComparisonPanel } from './components/landing/ComparisonPanel.svelte';
+export { default as FeatureGrid } from './components/landing/FeatureGrid.svelte';
+export { default as FeatureCard } from './components/landing/FeatureCard.svelte';
+export { default as BenchExplorer } from './components/landing/BenchExplorer.svelte';
+export { default as CTASection } from './components/landing/CTASection.svelte';
+export { default as MethodSummary } from './components/reference/MethodSummary.svelte';
+export { default as MethodDetail } from './components/reference/MethodDetail.svelte';
+export { buildSite, createRoute, setSite, getSite, DEFAULT_DOMAINS } from './site/site.js';
+export { default as Seo } from './components/Seo.svelte';
+export { initI18n, K, keysOf } from './i18n/index.js';
+export type { Keys } from './i18n/index.js';
+export { cn } from './utils/cn.js';
+export { highlight } from './utils/tokenizer.js';
+export { icons } from './utils/icons.js';
+export type { IconName } from './utils/icons.js';
+export type { DocMethod, DocParam, DocThrow, Metric, BenchResult, BenchProgram, BenchCategory, BenchData } from './utils/types.js';
+export type { NavItem, NavSection, Site, RouteFn, RouteConfig } from './site/site.js';

package/dist/index.js

@@ -0,0 +1,54 @@
+// Atoms
+export { default as Icon } from './components/atoms/Icon.svelte';
+export { default as Logo } from './components/atoms/Logo.svelte';
+export { default as Button } from './components/atoms/Button.svelte';
+export { default as Badge } from './components/atoms/Badge.svelte';
+export { default as Kbd } from './components/atoms/Kbd.svelte';
+export { default as CodeChip } from './components/atoms/CodeChip.svelte';
+export { default as Eyebrow } from './components/atoms/Eyebrow.svelte';
+export { default as Callout } from './components/atoms/Callout.svelte';
+export { default as HandNote } from './components/atoms/HandNote.svelte';
+export { default as ThemeToggle } from './components/atoms/ThemeToggle.svelte';
+export { default as SearchButton } from './components/atoms/SearchButton.svelte';
+export { default as Tag } from './components/atoms/Tag.svelte';
+// Code
+export { default as Code } from './components/code/Code.svelte';
+export { default as CodeWindow } from './components/code/CodeWindow.svelte';
+export { default as CopyCommand } from './components/code/CopyCommand.svelte';
+// Molecules
+export { default as DataTable } from './components/molecules/DataTable.svelte';
+export { default as PageHeading } from './components/molecules/PageHeading.svelte';
+export { default as Section } from './components/molecules/Section.svelte';
+export { default as SectionHeading } from './components/molecules/SectionHeading.svelte';
+export { default as Card } from './components/molecules/Card.svelte';
+// Navigation
+export { default as Header } from './components/nav/Header.svelte';
+export { default as DocHeader } from './components/nav/DocHeader.svelte';
+export { default as Sidebar } from './components/nav/Sidebar.svelte';
+export { default as RightRail } from './components/nav/RightRail.svelte';
+export { default as PrevNext } from './components/nav/PrevNext.svelte';
+export { default as Footer } from './components/nav/Footer.svelte';
+// Layout
+export { default as DocLayout } from './components/layout/DocLayout.svelte';
+export { default as PageShell } from './components/layout/PageShell.svelte';
+// Landing (shells — the route fills them with content)
+export { default as Hero } from './components/landing/Hero.svelte';
+export { default as RecipeDeck } from './components/landing/RecipeDeck.svelte';
+export { default as ComparisonPanel } from './components/landing/ComparisonPanel.svelte';
+export { default as FeatureGrid } from './components/landing/FeatureGrid.svelte';
+export { default as FeatureCard } from './components/landing/FeatureCard.svelte';
+export { default as BenchExplorer } from './components/landing/BenchExplorer.svelte';
+export { default as CTASection } from './components/landing/CTASection.svelte';
+// Reference (business)
+export { default as MethodSummary } from './components/reference/MethodSummary.svelte';
+export { default as MethodDetail } from './components/reference/MethodDetail.svelte';
+// Site / routing (cross-domain links + injected version via context)
+export { buildSite, createRoute, setSite, getSite, DEFAULT_DOMAINS } from './site/site.js';
+export { default as Seo } from './components/Seo.svelte';
+// i18n (chrome catalog; keys via K; keysOf lets apps build keys for their
+// own page-level messages, merged into the locale with addMessages)
+export { initI18n, K, keysOf } from './i18n/index.js';
+// Utilities & data
+export { cn } from './utils/cn.js';
+export { highlight } from './utils/tokenizer.js';
+export { icons } from './utils/icons.js';

package/dist/site/site.d.ts

@@ -0,0 +1,45 @@
+/** Built-in production domains; apps override via env. */
+export declare const DEFAULT_DOMAINS: {
+    readonly landing: "https://axle-lang.dev";
+    readonly docs: "https://doc.axle-lang.dev";
+};
+type SiteKind = 'landing' | 'docs';
+/** Resolver returned by `createRoute`: maps a route key to an href. */
+export type RouteFn = (key: string) => string;
+export interface RouteConfig {
+    landing?: string;
+    docs?: string;
+    /**
+     * The site this app *is*, so same-site links stay relative (work in
+     * local dev) and cross-site links go absolute to the configured domain.
+     */
+    current?: SiteKind;
+}
+/** Build a `route(key)` resolver. */
+export declare function createRoute({ landing, docs, current }?: RouteConfig): RouteFn;
+export interface NavItem {
+    label: string;
+    href: string;
+    indent?: boolean;
+}
+export interface NavSection {
+    title: string;
+    items: NavItem[];
+}
+/** The injected site config consumed via context by the components. */
+export interface Site {
+    version: string;
+    origin: string;
+    route: RouteFn;
+    nav?: NavSection[];
+}
+/**
+ * Per-app site config from `PUBLIC_*` env. Keeps the domain/version
+ * resolution in one place so each app's `$lib/site.ts` is a one-liner.
+ */
+export declare function buildSite(env: Record<string, string | undefined>, current: SiteKind): Omit<Site, 'nav'>;
+/** Provide `{ route, version, origin, nav }` to descendant components. */
+export declare function setSite(site: Site): void;
+/** Read the site config; falls back to defaults when none was set. */
+export declare function getSite(): Site;
+export {};

package/dist/site/site.js

@@ -0,0 +1,66 @@
+// Centralised, injectable site config: the version badge and every
+// link. Components never hardcode an href — they call `route(key)`,
+// which resolves cross-domain (landing vs docs) from the domains the
+// app injects, and a version string, both provided via Svelte context
+// (`setSite` in the app layout, `getSite` in the component).
+import { getContext, setContext } from 'svelte';
+/** Built-in production domains; apps override via env. */
+export const DEFAULT_DOMAINS = {
+    landing: 'https://axle-lang.dev',
+    docs: 'https://doc.axle-lang.dev'
+};
+/** Canonical source repository — single source for repo/issues/roadmap links. */
+const REPO = 'https://gitlab.com/axle-lang/axle';
+/**
+ * Route table. Each key resolves to either an internal page on the
+ * landing or docs site, or an external link (used verbatim).
+ */
+const ROUTES = {
+    home: { site: 'landing', path: '/' },
+    benchmarks: { site: 'landing', path: '/benchmarks' },
+    guide: { site: 'docs', path: '/guide' },
+    reference: { site: 'docs', path: '/reference' },
+    recipes: { site: 'docs', path: '/recipes' },
+    memory: { site: 'docs', path: '/memory' },
+    simd: { site: 'docs', path: '/simd' },
+    ffi: { site: 'docs', path: '/ffi' },
+    repo: { url: REPO },
+    issues: { url: `${REPO}/-/issues` },
+    roadmap: { url: REPO }
+};
+/** Build a `route(key)` resolver. */
+export function createRoute({ landing = DEFAULT_DOMAINS.landing, docs = DEFAULT_DOMAINS.docs, current = 'landing' } = {}) {
+    const origin = { landing, docs };
+    return function route(key) {
+        const r = ROUTES[key];
+        if (!r)
+            return '#';
+        if ('url' in r)
+            return r.url;
+        return r.site === current ? r.path : origin[r.site] + r.path;
+    };
+}
+/**
+ * Per-app site config from `PUBLIC_*` env. Keeps the domain/version
+ * resolution in one place so each app's `$lib/site.ts` is a one-liner.
+ */
+export function buildSite(env, current) {
+    const landing = env.PUBLIC_LANDING_DOMAIN || DEFAULT_DOMAINS.landing;
+    const docs = env.PUBLIC_DOCS_DOMAIN || DEFAULT_DOMAINS.docs;
+    return {
+        // The version badge is the app's to provide — the design system holds
+        // no compiler version. Empty when the app injects none.
+        version: env.PUBLIC_AXLE_VERSION ?? '',
+        origin: current === 'docs' ? docs : landing,
+        route: createRoute({ landing, docs, current })
+    };
+}
+const SITE_KEY = Symbol('axle.site');
+/** Provide `{ route, version, origin, nav }` to descendant components. */
+export function setSite(site) {
+    setContext(SITE_KEY, site);
+}
+/** Read the site config; falls back to defaults when none was set. */
+export function getSite() {
+    return getContext(SITE_KEY) ?? { route: createRoute(), version: '', origin: '' };
+}

package/dist/utils/cn.d.ts

@@ -0,0 +1,6 @@
+import { type ClassValue } from 'clsx';
+/**
+ * Merge class names: clsx for conditionals, tailwind-merge to resolve
+ * conflicting Tailwind utilities (the later one wins).
+ */
+export declare function cn(...inputs: ClassValue[]): string;