@specglass/theme-default 0.0.2

package/dist/islands/SearchResults.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useEffect, useRef } from "react";
+const DEBOUNCE_MS = 150;
+const MAX_RESULTS = 8;
+export function SearchResults() {
+    const [query, setQuery] = useState("");
+    const [results, setResults] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [isUnavailable, setIsUnavailable] = useState(false);
+    const [isFocused, setIsFocused] = useState(false);
+    const pagefindRef = useRef(null);
+    const debounceRef = useRef(null);
+    const inputRef = useRef(null);
+    const resultsRef = useRef(null);
+    const [selectedIndex, setSelectedIndex] = useState(-1);
+    // Load Pagefind JS lazily on first focus
+    const loadPagefind = useCallback(async () => {
+        if (pagefindRef.current)
+            return;
+        try {
+            // Pagefind generates this file at build time in the output directory.
+            // Dynamic concatenation prevents Vite from statically analyzing the path
+            // (the index only exists after `astro build`, not during dev).
+            const pagefindPath = `/pagefind/pagefind.js`;
+            const pf = await import(/* @vite-ignore */ pagefindPath);
+            await pf.init();
+            pagefindRef.current = pf;
+        }
+        catch {
+            // During dev server, the index doesn't exist
+            setIsUnavailable(true);
+        }
+    }, []);
+    // Perform search with debouncing
+    const performSearch = useCallback(async (searchQuery) => {
+        if (!searchQuery.trim()) {
+            setResults([]);
+            setSelectedIndex(-1);
+            return;
+        }
+        if (!pagefindRef.current) {
+            await loadPagefind();
+            if (!pagefindRef.current)
+                return;
+        }
+        setIsLoading(true);
+        try {
+            const response = await pagefindRef.current.search(searchQuery);
+            // Load full data for top results
+            const loaded = await Promise.all(response.results.slice(0, MAX_RESULTS).map((r) => r.data()));
+            setResults(loaded);
+            setSelectedIndex(-1);
+        }
+        catch {
+            setResults([]);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [loadPagefind]);
+    // Handle input changes with debounce
+    const handleInputChange = useCallback((value) => {
+        setQuery(value);
+        if (debounceRef.current) {
+            clearTimeout(debounceRef.current);
+        }
+        debounceRef.current = setTimeout(() => {
+            performSearch(value);
+        }, DEBOUNCE_MS);
+    }, [performSearch]);
+    // Keyboard navigation
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setSelectedIndex((prev) => Math.min(prev + 1, results.length - 1));
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setSelectedIndex((prev) => Math.max(prev - 1, -1));
+        }
+        else if (e.key === "Enter" && selectedIndex >= 0) {
+            e.preventDefault();
+            const result = results[selectedIndex];
+            if (result) {
+                window.location.href = result.url;
+            }
+        }
+        else if (e.key === "Escape") {
+            setQuery("");
+            setResults([]);
+            setSelectedIndex(-1);
+            inputRef.current?.blur();
+        }
+    }, [results, selectedIndex]);
+    // Click outside to close
+    useEffect(() => {
+        const handleClickOutside = (e) => {
+            if (resultsRef.current &&
+                !resultsRef.current.contains(e.target) &&
+                inputRef.current &&
+                !inputRef.current.contains(e.target)) {
+                setIsFocused(false);
+            }
+        };
+        document.addEventListener("mousedown", handleClickOutside);
+        return () => document.removeEventListener("mousedown", handleClickOutside);
+    }, []);
+    // Cleanup debounce on unmount
+    useEffect(() => {
+        return () => {
+            if (debounceRef.current) {
+                clearTimeout(debounceRef.current);
+            }
+        };
+    }, []);
+    const showResults = isFocused && query.trim().length > 0;
+    return (_jsxs("div", { className: "relative", "data-pagefind-ignore": "", children: [_jsxs("div", { className: "relative", children: [_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", className: "absolute left-3 top-1/2 -translate-y-1/2 text-text-muted pointer-events-none", children: [_jsx("circle", { cx: "11", cy: "11", r: "8" }), _jsx("path", { d: "m21 21-4.3-4.3" })] }), _jsx("input", { ref: inputRef, type: "search", value: query, onChange: (e) => handleInputChange(e.target.value), onFocus: () => {
+                            setIsFocused(true);
+                            loadPagefind();
+                        }, onKeyDown: handleKeyDown, placeholder: "Search docs\u2026", "aria-label": "Search documentation", "aria-expanded": showResults, "aria-controls": "search-results", "aria-autocomplete": "list", "aria-activedescendant": selectedIndex >= 0
+                            ? `search-result-${results[selectedIndex]?.id}`
+                            : undefined, role: "combobox", className: "w-full pl-9 pr-3 py-1.5 text-sm rounded-md border border-border bg-surface text-text placeholder-text-muted focus:outline-none focus:ring-2 focus:ring-primary transition-colors" })] }), showResults && (_jsxs("div", { ref: resultsRef, id: "search-results", role: "listbox", "aria-label": "Search results", className: "absolute top-full left-0 right-0 mt-1 max-h-80 overflow-y-auto rounded-lg border border-border bg-surface shadow-lg z-50", style: { minWidth: "320px" }, children: [isUnavailable && (_jsx("div", { className: "px-4 py-3 text-sm text-text-muted", children: "Search available after build" })), isLoading && !isUnavailable && (_jsx("div", { className: "px-4 py-3 text-sm text-text-muted", children: "Searching\u2026" })), !isLoading && !isUnavailable && results.length === 0 && (_jsx("div", { className: "px-4 py-3 text-sm text-text-muted", children: "No results found" })), !isUnavailable &&
+                        results.map((result, index) => (_jsxs("a", { id: `search-result-${result.id}`, href: result.url, role: "option", "aria-selected": index === selectedIndex, className: `block px-4 py-3 text-sm no-underline border-b border-border last:border-b-0 transition-colors ${index === selectedIndex
+                                ? "bg-hover-bg"
+                                : "hover:bg-hover-bg"}`, children: [_jsx("div", { className: "font-medium text-text mb-0.5", children: result.meta?.title ?? "Untitled" }), result.sub_results?.[0]?.title &&
+                                    result.sub_results[0].title !== result.meta?.title && (_jsx("div", { className: "text-xs text-text-muted mb-1", children: result.sub_results[0].title })), _jsx("div", { className: "text-xs text-text-muted line-clamp-2 [&_mark]:bg-primary/20 [&_mark]:text-text [&_mark]:rounded-sm [&_mark]:px-0.5", dangerouslySetInnerHTML: {
+                                        __html: result.sub_results?.[0]?.excerpt ?? result.excerpt ?? "",
+                                    } })] }, result.id)))] }))] }));
+}
+//# sourceMappingURL=SearchResults.js.map

package/dist/islands/SearchResults.js.map

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

package/dist/islands/ThemeToggle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ThemeToggle — React island for switching between dark and light mode.
+ *
+ * Renders as a button with sun/moon icons that crossfade on toggle.
+ * Reads initial state from the DOM (set by the FOUC-prevention inline script),
+ * toggles .dark class on <html>, and persists preference to localStorage.
+ *
+ * Uses inline SVGs — no icon library dependency to keep bundle minimal.
+ * Imports shared utilities from theme-helpers.ts for consistency.
+ */
+export declare function ThemeToggle(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ThemeToggle.d.ts.map

package/dist/islands/ThemeToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/islands/ThemeToggle.tsx"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AAEH,wBAAgB,WAAW,4CAwF1B"}

package/dist/islands/ThemeToggle.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useEffect } from "react";
+import { THEME_STORAGE_KEY, applyTheme, } from "../utils/theme-helpers";
+/**
+ * ThemeToggle — React island for switching between dark and light mode.
+ *
+ * Renders as a button with sun/moon icons that crossfade on toggle.
+ * Reads initial state from the DOM (set by the FOUC-prevention inline script),
+ * toggles .dark class on <html>, and persists preference to localStorage.
+ *
+ * Uses inline SVGs — no icon library dependency to keep bundle minimal.
+ * Imports shared utilities from theme-helpers.ts for consistency.
+ */
+export function ThemeToggle() {
+    const [isDark, setIsDark] = useState(() => {
+        // Read initial state from DOM — FOUC script already set .dark class
+        if (typeof document !== "undefined") {
+            return document.documentElement.classList.contains("dark");
+        }
+        return true; // SSR fallback: default dark
+    });
+    // Sync with external changes (e.g., other tabs via StorageEvent)
+    useEffect(() => {
+        const handleStorage = (e) => {
+            if (e.key === THEME_STORAGE_KEY) {
+                const newTheme = e.newValue === "light" ? "light" : "dark";
+                setIsDark(newTheme === "dark");
+                applyTheme(newTheme);
+            }
+        };
+        window.addEventListener("storage", handleStorage);
+        return () => window.removeEventListener("storage", handleStorage);
+    }, []);
+    const toggleTheme = useCallback(() => {
+        // Read from DOM (source of truth) to avoid stale closure issues
+        const currentlyDark = document.documentElement.classList.contains("dark");
+        const newIsDark = !currentlyDark;
+        setIsDark(newIsDark);
+        applyTheme(newIsDark ? "dark" : "light");
+    }, []);
+    return (_jsx("button", { type: "button", onClick: toggleTheme, "aria-label": isDark ? "Switch to light mode" : "Switch to dark mode", className: "inline-flex items-center justify-center rounded-md p-2 text-text-muted hover:text-(--color-text) hover:bg-hover-bg focus:outline-none focus-visible:ring-2 focus-visible:ring-primary transition-colors", children: _jsxs("span", { className: "relative inline-flex items-center justify-center w-5 h-5", children: [_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "20", height: "20", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", className: `absolute inset-0 transition-transform duration-300 ${isDark ? "rotate-0 scale-100" : "-rotate-90 scale-0"}`, children: [_jsx("circle", { cx: "12", cy: "12", r: "4" }), _jsx("path", { d: "M12 2v2" }), _jsx("path", { d: "M12 20v2" }), _jsx("path", { d: "m4.93 4.93 1.41 1.41" }), _jsx("path", { d: "m17.66 17.66 1.41 1.41" }), _jsx("path", { d: "M2 12h2" }), _jsx("path", { d: "M20 12h2" }), _jsx("path", { d: "m6.34 17.66-1.41 1.41" }), _jsx("path", { d: "m19.07 4.93-1.41 1.41" })] }), _jsx("svg", { xmlns: "http://www.w3.org/2000/svg", width: "20", height: "20", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", className: `absolute inset-0 transition-transform duration-300 ${!isDark ? "rotate-0 scale-100" : "rotate-90 scale-0"}`, children: _jsx("path", { d: "M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z" }) })] }) }));
+}
+//# sourceMappingURL=ThemeToggle.js.map

package/dist/islands/ThemeToggle.js.map

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

package/dist/layouts/DocPage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DocPage.test.d.ts.map

package/dist/layouts/DocPage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocPage.test.d.ts","sourceRoot":"","sources":["../../src/layouts/DocPage.test.ts"],"names":[],"mappings":""}

package/dist/layouts/DocPage.test.js

@@ -0,0 +1,165 @@
+/**
+ * Tests for DocPage layout supporting utilities and contracts.
+ *
+ * Note: .astro components cannot be unit tested directly in Vitest.
+ * These tests verify the shared utils that the layout components import,
+ * and validate data contracts. Build verification confirms rendering.
+ */
+import { describe, it, expect } from "vitest";
+import { filterVisibleItems, isActiveOrAncestor, } from "../utils/sidebar-helpers.js";
+import { filterTocHeadings } from "../utils/toc-helpers.js";
+// ─── Tests ─────────────────────────────────────────────────────────
+describe("Sidebar filtering", () => {
+    it("excludes hidden items", () => {
+        const items = [
+            { title: "Visible", slug: "visible", type: "page" },
+            { title: "Hidden", slug: "hidden", type: "page", hidden: true },
+            { title: "Also Visible", slug: "also-visible", type: "page" },
+        ];
+        const result = filterVisibleItems(items);
+        expect(result).toHaveLength(2);
+        expect(result.map((i) => i.title)).toEqual(["Visible", "Also Visible"]);
+    });
+    it("includes all items when none are hidden", () => {
+        const items = [
+            { title: "A", slug: "a", type: "page" },
+            { title: "B", slug: "b", type: "page" },
+        ];
+        expect(filterVisibleItems(items)).toHaveLength(2);
+    });
+    it("returns empty array for all-hidden items", () => {
+        const items = [
+            { title: "A", slug: "a", type: "page", hidden: true },
+        ];
+        expect(filterVisibleItems(items)).toHaveLength(0);
+    });
+});
+describe("Sidebar active detection", () => {
+    it("detects direct page match", () => {
+        const item = { title: "Guide", slug: "guide", type: "page" };
+        expect(isActiveOrAncestor(item, "guide")).toBe(true);
+        expect(isActiveOrAncestor(item, "other")).toBe(false);
+    });
+    it("detects ancestor section when child is active", () => {
+        const section = {
+            title: "API",
+            slug: "api",
+            type: "section",
+            children: [
+                { title: "Auth", slug: "api/auth", type: "page" },
+                { title: "Users", slug: "api/users", type: "page" },
+            ],
+        };
+        expect(isActiveOrAncestor(section, "api/auth")).toBe(true);
+        expect(isActiveOrAncestor(section, "api/users")).toBe(true);
+        expect(isActiveOrAncestor(section, "other")).toBe(false);
+    });
+    it("handles deeply nested sections", () => {
+        const root = {
+            title: "Docs",
+            slug: "docs",
+            type: "section",
+            children: [
+                {
+                    title: "Advanced",
+                    slug: "docs/advanced",
+                    type: "section",
+                    children: [
+                        {
+                            title: "Plugins",
+                            slug: "docs/advanced/plugins",
+                            type: "page",
+                        },
+                    ],
+                },
+            ],
+        };
+        expect(isActiveOrAncestor(root, "docs/advanced/plugins")).toBe(true);
+        expect(isActiveOrAncestor(root, "other")).toBe(false);
+    });
+    it("ignores external links", () => {
+        const item = {
+            title: "External",
+            slug: "",
+            type: "external-link",
+            href: "https://example.com",
+        };
+        expect(isActiveOrAncestor(item, "")).toBe(false);
+    });
+});
+describe("Table of contents heading filtering", () => {
+    it("includes h2 and h3 headings only", () => {
+        const headings = [
+            { depth: 1, slug: "title", text: "Title" },
+            { depth: 2, slug: "intro", text: "Introduction" },
+            { depth: 3, slug: "detail", text: "Detail" },
+            { depth: 4, slug: "deep", text: "Deep" },
+        ];
+        const result = filterTocHeadings(headings);
+        expect(result).toHaveLength(2);
+        expect(result.map((h) => h.text)).toEqual(["Introduction", "Detail"]);
+    });
+    it("returns empty array when no h2/h3 headings exist", () => {
+        const headings = [
+            { depth: 1, slug: "title", text: "Title" },
+            { depth: 4, slug: "deep", text: "Deep" },
+        ];
+        expect(filterTocHeadings(headings)).toHaveLength(0);
+    });
+    it("handles empty headings array", () => {
+        expect(filterTocHeadings([])).toHaveLength(0);
+    });
+});
+describe("NavigationTree contract", () => {
+    it("matches expected shape for layout props", () => {
+        const tree = {
+            items: [
+                { title: "Getting Started", slug: "getting-started", type: "page" },
+                {
+                    title: "API Reference",
+                    slug: "api",
+                    type: "section",
+                    collapsed: true,
+                    children: [
+                        { title: "Auth", slug: "api/auth", type: "page" },
+                        {
+                            title: "GitHub",
+                            slug: "",
+                            type: "external-link",
+                            href: "https://github.com",
+                        },
+                    ],
+                },
+            ],
+        };
+        expect(tree.items).toHaveLength(2);
+        expect(tree.items[0].type).toBe("page");
+        expect(tree.items[1].type).toBe("section");
+        expect(tree.items[1].collapsed).toBe(true);
+        expect(tree.items[1].children).toHaveLength(2);
+        expect(tree.items[1].children[1].type).toBe("external-link");
+        expect(tree.items[1].children[1].href).toBe("https://github.com");
+    });
+});
+describe("DocPage props contract", () => {
+    it("validates expected frontmatter shape", () => {
+        const frontmatter = {
+            title: "Getting Started",
+            description: "A guide to getting started",
+        };
+        expect(frontmatter.title).toBeDefined();
+        expect(typeof frontmatter.title).toBe("string");
+    });
+    it("headings array has correct shape", () => {
+        const headings = [
+            { depth: 2, slug: "installation", text: "Installation" },
+            { depth: 3, slug: "npm", text: "Using npm" },
+        ];
+        headings.forEach((h) => {
+            expect(typeof h.depth).toBe("number");
+            expect(typeof h.slug).toBe("string");
+            expect(typeof h.text).toBe("string");
+        });
+    });
+});
+//# sourceMappingURL=DocPage.test.js.map

package/dist/layouts/DocPage.test.js.map

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

package/dist/lib/utils.d.ts

@@ -0,0 +1,10 @@
+import { type ClassValue } from "clsx";
+/**
+ * Merge Tailwind CSS classes with clsx and tailwind-merge.
+ * This is the standard shadcn/ui utility function.
+ *
+ * Note: Scaffolding for future shadcn/ui component integration.
+ * Will be used by UI primitives in upcoming stories (e.g., search, dialogs).
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG7C;;;;;;GAMG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/lib/utils.js

@@ -0,0 +1,13 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+/**
+ * Merge Tailwind CSS classes with clsx and tailwind-merge.
+ * This is the standard shadcn/ui utility function.
+ *
+ * Note: Scaffolding for future shadcn/ui component integration.
+ * Will be used by UI primitives in upcoming stories (e.g., search, dialogs).
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/scripts/code-block-enhancer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Client-side enhancer for fenced code blocks.
+ *
+ * The rehype plugin wraps fenced code <pre> elements in:
+ *   <div class="code-block code-block--fenced" data-code="...">
+ *     <div class="code-block-body">
+ *       <pre>...</pre>
+ *     </div>
+ *   </div>
+ *
+ * This script adds a lightweight copy button to each fenced code block
+ * WITHOUT requiring React hydration — keeping fenced blocks zero-JS
+ * until the user actually clicks copy.
+ */
+declare function initCopyButtons(): void;
+//# sourceMappingURL=code-block-enhancer.d.ts.map

package/dist/scripts/code-block-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-enhancer.d.ts","sourceRoot":"","sources":["../../src/scripts/code-block-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,iBAAS,eAAe,SAqCvB"}

package/dist/scripts/code-block-enhancer.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Client-side enhancer for fenced code blocks.
+ *
+ * The rehype plugin wraps fenced code <pre> elements in:
+ *   <div class="code-block code-block--fenced" data-code="...">
+ *     <div class="code-block-body">
+ *       <pre>...</pre>
+ *     </div>
+ *   </div>
+ *
+ * This script adds a lightweight copy button to each fenced code block
+ * WITHOUT requiring React hydration — keeping fenced blocks zero-JS
+ * until the user actually clicks copy.
+ */
+function initCopyButtons() {
+    document
+        .querySelectorAll(".code-block--fenced")
+        .forEach((block) => {
+        // Skip if already enhanced
+        if (block.querySelector(".sg-copy-btn-native"))
+            return;
+        const code = block.getAttribute("data-code") ?? "";
+        const btn = document.createElement("button");
+        btn.type = "button";
+        btn.className = "sg-copy-btn-native sg-copy-btn";
+        btn.setAttribute("aria-label", "Copy code");
+        btn.title = "Copy code";
+        btn.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>`;
+        btn.addEventListener("click", () => {
+            navigator.clipboard.writeText(code).then(() => {
+                btn.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="color:#22c55e"><polyline points="20 6 9 17 4 12"/></svg>`;
+                btn.setAttribute("aria-label", "Copied!");
+                btn.title = "Copied!";
+                setTimeout(() => {
+                    btn.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>`;
+                    btn.setAttribute("aria-label", "Copy code");
+                    btn.title = "Copy code";
+                }, 2000);
+            }).catch(() => {
+                console.warn("[CopyButton] Clipboard API unavailable");
+            });
+        });
+        // Insert into the code-block-body
+        const body = block.querySelector(".code-block-body");
+        if (body) {
+            body.appendChild(btn);
+        }
+    });
+}
+// Run on initial load
+document.addEventListener("DOMContentLoaded", initCopyButtons);
+// Re-run after Astro ViewTransitions page swaps
+document.addEventListener("astro:after-swap", initCopyButtons);
+//# sourceMappingURL=code-block-enhancer.js.map

package/dist/scripts/code-block-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-enhancer.js","sourceRoot":"","sources":["../../src/scripts/code-block-enhancer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AAEH,SAAS,eAAe;IACtB,QAAQ;SACL,gBAAgB,CAAiB,qBAAqB,CAAC;SACvD,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,2BAA2B;QAC3B,IAAI,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC;YAAE,OAAO;QAEvD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEnD,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7C,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;QACpB,GAAG,CAAC,SAAS,GAAG,gCAAgC,CAAC;QACjD,GAAG,CAAC,YAAY,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC5C,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;QACxB,GAAG,CAAC,SAAS,GAAG,wTAAwT,CAAC;QAEzU,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACjC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC5C,GAAG,CAAC,SAAS,GAAG,sPAAsP,CAAC;gBACvQ,GAAG,CAAC,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBAC1C,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC;gBACtB,UAAU,CAAC,GAAG,EAAE;oBACd,GAAG,CAAC,SAAS,GAAG,wTAAwT,CAAC;oBACzU,GAAG,CAAC,YAAY,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;oBAC5C,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC1B,CAAC,EAAE,IAAI,CAAC,CAAC;YACX,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACZ,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAiB,kBAAkB,CAAC,CAAC;QACrE,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,sBAAsB;AACtB,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;AAE/D,gDAAgD;AAChD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC"}

package/dist/ui/command.d.ts

@@ -0,0 +1,87 @@
+import * as React from "react";
+import { type DialogProps } from "@radix-ui/react-dialog";
+declare const Command: React.ForwardRefExoticComponent<Omit<{
+    children?: React.ReactNode;
+} & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+    label?: string;
+    shouldFilter?: boolean;
+    filter?: (value: string, search: string, keywords?: string[]) => number;
+    defaultValue?: string;
+    value?: string;
+    onValueChange?: (value: string) => void;
+    loop?: boolean;
+    disablePointerSelection?: boolean;
+    vimBindings?: boolean;
+} & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+interface CommandDialogProps extends DialogProps {
+    /** Pass false to disable cmdk's built-in filtering (e.g. when using external search like Pagefind) */
+    shouldFilter?: boolean;
+    /** Accessible dialog title (screen-reader only). Defaults to "Search" */
+    dialogTitle?: string;
+}
+declare const CommandDialog: ({ children, shouldFilter, dialogTitle, ...props }: CommandDialogProps) => import("react/jsx-runtime").JSX.Element;
+declare const CommandInput: React.ForwardRefExoticComponent<Omit<Omit<Pick<Pick<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "key" | keyof React.InputHTMLAttributes<HTMLInputElement>> & {
+    ref?: React.Ref<HTMLInputElement>;
+} & {
+    asChild?: boolean;
+}, "key" | "asChild" | keyof React.InputHTMLAttributes<HTMLInputElement>>, "type" | "onChange" | "value"> & {
+    value?: string;
+    onValueChange?: (search: string) => void;
+} & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
+declare const CommandList: React.ForwardRefExoticComponent<Omit<{
+    children?: React.ReactNode;
+} & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+    label?: string;
+} & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const CommandEmpty: React.ForwardRefExoticComponent<Omit<{
+    children?: React.ReactNode;
+} & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const CommandGroup: React.ForwardRefExoticComponent<Omit<{
+    children?: React.ReactNode;
+} & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "heading" | "value"> & {
+    heading?: React.ReactNode;
+    value?: string;
+    forceMount?: boolean;
+} & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const CommandSeparator: React.ForwardRefExoticComponent<Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+    alwaysRender?: boolean;
+} & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const CommandItem: React.ForwardRefExoticComponent<Omit<{
+    children?: React.ReactNode;
+} & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
+    ref?: React.Ref<HTMLDivElement>;
+} & {
+    asChild?: boolean;
+}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "onSelect" | "disabled" | "value"> & {
+    disabled?: boolean;
+    onSelect?: (value: string) => void;
+    value?: string;
+    keywords?: string[];
+    forceMount?: boolean;
+} & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const CommandShortcut: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, };
+//# sourceMappingURL=command.d.ts.map

package/dist/ui/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/ui/command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;sFAYX,CAAC;AAGH,UAAU,kBAAmB,SAAQ,WAAW;IAC9C,sGAAsG;IACtG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,QAAA,MAAM,aAAa,GAAI,mDAKpB,kBAAkB,4CAqBpB,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;;;0FA8BhB,CAAC;AAGH,QAAA,MAAM,WAAW;;;;;;;;sFASf,CAAC;AAGH,QAAA,MAAM,YAAY;;;;;;uJAShB,CAAC;AAGH,QAAA,MAAM,YAAY;;;;;;;;;;sFAYhB,CAAC;AAGH,QAAA,MAAM,gBAAgB;;;;;;sFASpB,CAAC;AAGH,QAAA,MAAM,WAAW;;;;;;;;;;;;sFAYf,CAAC;AAGH,QAAA,MAAM,eAAe;8BAGlB,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;;CAUvC,CAAC;AAGF,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,CAAC"}