diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..0ffa89f --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,54 @@ +name: pages + +on: + push: + branches: + - main + paths: + - "docs/**" + - "scripts/build-docs-site.mjs" + - "scripts/docs-site-assets.mjs" + - "Makefile" + - ".github/workflows/pages.yml" + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + deploy: + name: Deploy docs + runs-on: ubuntu-latest + timeout-minutes: 10 + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - name: Check out + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + + - name: Set up Node + uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 + with: + node-version: "24" + + - name: Build docs site + run: make docs-site + + - name: Configure Pages + uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0 + + - name: Upload artifact + uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 + with: + path: dist/docs-site + + - name: Deploy + id: deployment + uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0 diff --git a/.gitignore b/.gitignore index aaadf73..c2e84c8 100644 --- a/.gitignore +++ b/.gitignore @@ -30,3 +30,7 @@ go.work.sum # Editor/IDE # .idea/ # .vscode/ + +# Build output +/bin/ +/dist/ diff --git a/CHANGELOG.md b/CHANGELOG.md index 313be40..64aa77d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ ## 0.1.1 - Unreleased - New Clawd style -- Docs: rewritten gogcli-style — plain-markdown pages for install, quickstart, visualizations, palettes, decoding, rendering, pipeline, and CLI; removed custom Jekyll theme so songsee.sh runs on the default GitHub Pages theme +- Docs: rewritten gogcli-style — plain-markdown pages for install, quickstart, visualizations, palettes, decoding, rendering, pipeline, and CLI; new custom static-site builder (`make docs-site`) and `pages.yml` workflow render songsee.sh with a sidebar nav, search, dark-mode toggle, and per-page TOC ## 0.1.0 - 2026-01-02 diff --git a/Makefile b/Makefile index 2f0e15d..bbb5a0e 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,8 @@ -.PHONY: songsee +.PHONY: songsee docs-site songsee: mkdir -p bin go build -o bin/songsee ./cmd/songsee + +docs-site: + @node scripts/build-docs-site.mjs diff --git a/scripts/build-docs-site.mjs b/scripts/build-docs-site.mjs new file mode 100644 index 0000000..3771a2c --- /dev/null +++ b/scripts/build-docs-site.mjs @@ -0,0 +1,708 @@ +#!/usr/bin/env node +import fs from "node:fs"; +import path from "node:path"; + +import { css, faviconSvg, js, preThemeScript, themeToggleHtml } from "./docs-site-assets.mjs"; + +const root = process.cwd(); +const docsDir = path.join(root, "docs"); +const outDir = path.join(root, "dist", "docs-site"); +const repoBase = "https://github.com/openclaw/songsee"; +const repoEditBase = `${repoBase}/edit/main/docs`; +const cname = readCname(); +const siteBase = cname ? `https://${cname}` : ""; + +const productName = "songsee"; +const productTagline = "See sound as living color."; +const productDescription = + "A single Go CLI that turns audio into modern spectrogram and feature-panel images — fast WAV/MP3 decode, ffmpeg fallback, nine visualization modes, six palettes."; +const brewInstall = "brew install steipete/tap/songsee"; +const productEyebrow = "Spectral imaging · One CLI"; +const productSubtitle = "Spectrogram CLI"; +const homeServices = ["spectrogram", "mel", "chroma", "hpss", "selfsim", "loudness", "tempogram", "mfcc", "flux"]; + +const sections = [ + ["Start", ["index.md", "install.md", "quickstart.md"]], + ["Visualize", ["visualizations.md", "palettes.md"]], + ["Audio & Output", ["decoding.md", "rendering.md"]], + ["Reference", ["cli.md", "spec.md", "RELEASING.md"]], +]; + +const buildExcludes = []; + +fs.rmSync(outDir, { recursive: true, force: true }); +fs.mkdirSync(outDir, { recursive: true }); + +const allPages = allMarkdown(docsDir).map((file) => { + const rel = path.relative(docsDir, file).replaceAll(path.sep, "/"); + const raw = fs.readFileSync(file, "utf8"); + const { frontmatter, body } = parseFrontmatter(raw); + const cleaned = stripStrayDirectives(body); + const title = frontmatter.title || firstHeading(cleaned) || titleize(path.basename(rel, ".md")); + return { file, rel, title, outRel: outPath(rel, frontmatter), markdown: cleaned, frontmatter }; +}); + +const pages = allPages.filter((page) => !buildExcludes.some((re) => re.test(page.rel))); +const pageMap = new Map(pages.map((page) => [page.rel, page])); +const permalinkMap = new Map(); +for (const page of pages) { + if (page.frontmatter.permalink) { + permalinkMap.set(normalizePermalink(page.frontmatter.permalink), page); + } +} + +const nav = sections + .map(([name, rels]) => ({ + name, + pages: rels.map((rel) => pageMap.get(rel)).filter(Boolean), + })) + .filter((section) => section.pages.length); + +const sectionByRel = new Map(); +for (const section of nav) for (const page of section.pages) sectionByRel.set(page.rel, section.name); +const orderedPages = nav.flatMap((s) => s.pages); + +for (const page of pages) { + const html = markdownToHtml(page.markdown, page.rel); + const toc = tocFromHtml(html); + const idx = orderedPages.findIndex((p) => p.rel === page.rel); + const prev = idx > 0 ? orderedPages[idx - 1] : null; + const next = idx >= 0 && idx < orderedPages.length - 1 ? orderedPages[idx + 1] : null; + const sectionName = sectionByRel.get(page.rel) || "Reference"; + const pageOut = path.join(outDir, page.outRel); + fs.mkdirSync(path.dirname(pageOut), { recursive: true }); + fs.writeFileSync(pageOut, layout({ page, html, toc, prev, next, sectionName }), "utf8"); +} + +fs.writeFileSync(path.join(outDir, "favicon.svg"), faviconSvg(), "utf8"); +copyStaticAsset("social-card.svg"); +copyStaticAsset("social-card.png"); +fs.writeFileSync(path.join(outDir, ".nojekyll"), "", "utf8"); +if (cname) fs.writeFileSync(path.join(outDir, "CNAME"), cname, "utf8"); +validateLinks(outDir); +console.log(`built docs site: ${path.relative(root, outDir)}`); + +function readCname() { + for (const candidate of [path.join(docsDir, "CNAME"), path.join(root, "CNAME")]) { + if (fs.existsSync(candidate)) return fs.readFileSync(candidate, "utf8").trim(); + } + return ""; +} + +function copyStaticAsset(name) { + const source = path.join(docsDir, name); + if (fs.existsSync(source)) fs.copyFileSync(source, path.join(outDir, name)); +} + +function parseFrontmatter(raw) { + const match = raw.match(/^---\n([\s\S]*?)\n---\n?/); + if (!match) return { frontmatter: {}, body: raw }; + const fm = {}; + for (const line of match[1].split("\n")) { + const m = line.match(/^([A-Za-z0-9_-]+):\s*(.*?)\s*$/); + if (!m) continue; + let value = m[2]; + if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) { + value = value.slice(1, -1); + } + fm[m[1]] = value; + } + return { frontmatter: fm, body: raw.slice(match[0].length) }; +} + +function stripStrayDirectives(body) { + return body + .replace(/\r\n/g, "\n") + .split("\n") + .filter((line) => !/^\s*\{:\s*[^}]*\}\s*$/.test(line)) + .map((line) => line.replace(/\s*\{:\s*[^}]*\}\s*$/, "")) + .join("\n"); +} + +function normalizePermalink(value) { + let v = value.trim(); + if (!v) return "/"; + if (!v.startsWith("/")) v = `/${v}`; + if (v.length > 1 && v.endsWith("/")) v = v.slice(0, -1); + return v; +} + +function allMarkdown(dir) { + return fs + .readdirSync(dir, { withFileTypes: true }) + .flatMap((entry) => { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) return allMarkdown(full); + return entry.name.endsWith(".md") ? [full] : []; + }) + .sort(); +} + +function outPath(rel, frontmatter = {}) { + if (frontmatter.permalink) { + const permalink = normalizePermalink(frontmatter.permalink); + if (permalink === "/") return "index.html"; + return `${permalink.slice(1)}/index.html`; + } + if (rel === "index.md") return "index.html"; + if (rel === "README.md") return "index.html"; + if (rel.endsWith("/README.md")) return rel.replace(/README\.md$/, "index.html"); + return rel.replace(/\.md$/, ".html"); +} + +function firstHeading(markdown) { + return markdown.match(/^#\s+(.+)$/m)?.[1]?.trim(); +} + +function titleize(input) { + return input.replaceAll("-", " ").replace(/\b\w/g, (m) => m.toUpperCase()); +} + +function markdownToHtml(markdown, currentRel) { + const lines = markdown.replace(/\r\n/g, "\n").split("\n"); + const html = []; + let paragraph = []; + let list = null; + let fence = null; + let blockquote = []; + + const flushParagraph = () => { + if (!paragraph.length) return; + html.push(`

${inline(paragraph.join(" "), currentRel)}

`); + paragraph = []; + }; + const closeList = () => { + if (!list) return; + html.push(``); + list = null; + }; + const flushBlockquote = () => { + if (!blockquote.length) return; + const inner = markdownToHtml(blockquote.join("\n"), currentRel); + html.push(`
${inner}
`); + blockquote = []; + }; + const splitRow = (line) => { + let trimmed = line.trim(); + if (trimmed.startsWith("|")) trimmed = trimmed.slice(1); + if (trimmed.endsWith("|") && !trimmed.endsWith("\\|")) trimmed = trimmed.slice(0, -1); + const cells = []; + let current = ""; + for (let idx = 0; idx < trimmed.length; idx++) { + const char = trimmed[idx]; + if (char === "\\" && trimmed[idx + 1] === "|") { + current += "\\|"; + idx += 1; + continue; + } + if (char === "|") { + cells.push(current.trim().replace(/\\\|/g, "|")); + current = ""; + continue; + } + current += char; + } + cells.push(current.trim().replace(/\\\|/g, "|")); + return cells; + }; + const isDivider = (line) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)+\|?\s*$/.test(line); + + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + const fenceMatch = line.match(/^```([\w+-]+)?\s*$/); + if (fenceMatch) { + flushParagraph(); + closeList(); + flushBlockquote(); + if (fence) { + const body = highlightCode(fence.lines.join("\n"), fence.lang); + html.push(`
${body}
`); + fence = null; + } else { + fence = { lang: fenceMatch[1] || "text", lines: [] }; + } + continue; + } + if (fence) { + fence.lines.push(line); + continue; + } + if (/^>\s?/.test(line)) { + flushParagraph(); + closeList(); + blockquote.push(line.replace(/^>\s?/, "")); + continue; + } + flushBlockquote(); + if (!line.trim()) { + flushParagraph(); + closeList(); + continue; + } + if (/^\s*---+\s*$/.test(line)) { + flushParagraph(); + closeList(); + html.push("
"); + continue; + } + const heading = line.match(/^(#{1,4})\s+(.+)$/); + if (heading) { + flushParagraph(); + closeList(); + const level = heading[1].length; + const text = heading[2].trim(); + const id = slug(text); + const inner = inline(text, currentRel); + if (level === 1) { + html.push(`

${inner}

`); + } else { + html.push(`#${inner}`); + } + continue; + } + if (line.trimStart().startsWith("|") && line.includes("|", line.indexOf("|") + 1) && isDivider(lines[i + 1] || "")) { + flushParagraph(); + closeList(); + const header = splitRow(line); + const aligns = splitRow(lines[i + 1]).map((cell) => { + const left = cell.startsWith(":"); + const right = cell.endsWith(":"); + return right && left ? "center" : right ? "right" : left ? "left" : ""; + }); + i += 1; + const rows = []; + while (i + 1 < lines.length && lines[i + 1].trimStart().startsWith("|")) { + i += 1; + rows.push(splitRow(lines[i])); + } + const th = header.map((c, idx) => `${inline(c, currentRel)}`).join(""); + const tb = rows.map((r) => `${r.map((c, idx) => `${inline(c, currentRel)}`).join("")}`).join(""); + html.push(`${th}${tb}
`); + continue; + } + const bullet = line.match(/^\s*-\s+(.+)$/); + const numbered = line.match(/^\s*\d+\.\s+(.+)$/); + if (bullet || numbered) { + flushParagraph(); + const tag = bullet ? "ul" : "ol"; + if (list && list !== tag) closeList(); + if (!list) { + list = tag; + html.push(`<${tag}>`); + } + html.push(`
  • ${inline((bullet || numbered)[1], currentRel)}
    • `); + continue; + } + paragraph.push(line.trim()); + } + flushParagraph(); + closeList(); + flushBlockquote(); + return html.join("\n"); +} + +function inline(text, currentRel) { + const stash = []; + let out = text.replace(/`([^`]+)`/g, (_, code) => { + stash.push(`${escapeHtml(code)}`); + return `\u0000${stash.length - 1}\u0000`; + }); + out = escapeHtml(out) + .replace(/\*\*([^*]+)\*\*/g, "$1") + .replace(/(^|[^*])\*([^*\s][^*]*?)\*(?!\*)/g, "$1$2") + .replace(/(^|[^_])_([^_\s][^_]*?)_(?!_)/g, "$1$2") + .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, label, href) => `${label}`) + .replace(/<(https?:\/\/[^\s<>]+)>/g, '$1'); + out = out.replace(/\\\|/g, "|"); + out = out.replace(/<br>/g, "
    "); + return out.replace(/\u0000(\d+)\u0000/g, (_, i) => stash[Number(i)]); +} + +function rewriteHref(href, currentRel) { + if (/^(https?:|mailto:|tel:|#)/.test(href)) return href; + const [raw, hash = ""] = href.split("#"); + if (!raw) return hash ? `#${hash}` : ""; + if (raw.startsWith("/")) { + const target = permalinkMap.get(normalizePermalink(raw)); + if (target) { + const currentOut = pageMap.get(currentRel)?.outRel || outPath(currentRel); + const out = hrefToOutRel(target.outRel, currentOut); + return hash ? `${out}#${hash}` : out; + } + return href; + } + if (!raw.endsWith(".md")) return href; + const from = path.posix.dirname(currentRel); + const target = path.posix.normalize(path.posix.join(from, raw)); + let rewritten = pageMap.get(target)?.outRel || outPath(target); + const currentOut = pageMap.get(currentRel)?.outRel || outPath(currentRel); + rewritten = hrefToOutRel(rewritten, currentOut); + return `${rewritten}${hash ? `#${hash}` : ""}`; +} + +function tocFromHtml(html) { + const items = []; + const re = /([\s\S]*?)<\/h[23]>/g; + let m; + while ((m = re.exec(html))) { + const text = m[3] + .replace(/]*>.*?<\/a>/, "") + .replace(/<[^>]+>/g, "") + .trim(); + items.push({ level: Number(m[1]), id: m[2], text }); + } + if (items.length < 2) return ""; + return ``; +} + +function isHomePage(page) { + if (page.frontmatter.permalink && normalizePermalink(page.frontmatter.permalink) === "/") return true; + return page.rel === "index.md" || page.rel === "README.md"; +} + +function homeHero(page) { + const description = page.frontmatter.description || productDescription; + const installRel = pageMap.get("install.md")?.outRel + ? hrefToOutRel(pageMap.get("install.md").outRel, page.outRel) + : "install.html"; + const quickstartRel = pageMap.get("quickstart.md")?.outRel + ? hrefToOutRel(pageMap.get("quickstart.md").outRel, page.outRel) + : "quickstart.html"; + return `
    +

    ${escapeHtml(productEyebrow)}

    +

    ${escapeHtml(productTagline)}

    +

    ${escapeHtml(description)}

    +
    + Quickstart + GitHub +
    + + ${escapeHtml(brewInstall)} +
    +
    +
    + ${homeServices.map((s) => `${escapeHtml(s)}`).join("")} +
    +

    Other install options →

    +
    `; +} + +function standardHero(page, sectionName, editUrl) { + return `
    +
    +

    ${escapeHtml(sectionName)}

    +

    ${escapeHtml(page.title)}

    +
    +
    + GitHub + Edit page +
    +
    `; +} + +function layout({ page, html, toc, prev, next, sectionName }) { + const depth = page.outRel.split("/").length - 1; + const rootPrefix = depth ? "../".repeat(depth) : ""; + const editUrl = `${repoEditBase}/${page.rel}`; + const home = isHomePage(page); + const prevNext = !home && (prev || next) ? pageNavHtml(prev, next, page.outRel) : ""; + const heroBlock = home ? homeHero(page) : standardHero(page, sectionName, editUrl); + const articleClass = home ? "doc doc-home" : "doc"; + const tocBlock = home ? "" : toc; + const titleSuffix = home ? `${productName} — ${productTagline}` : `${page.title} — ${productName}`; + const description = page.frontmatter.description || (home ? productDescription : `${page.title} — ${productName} CLI documentation.`); + const canonicalUrl = pageCanonicalUrl(page); + const socialImage = siteBase ? `${siteBase}/social-card.png` : `${rootPrefix}social-card.png`; + const socialMeta = [ + ["link", "rel", "canonical", "href", canonicalUrl], + ["meta", "property", "og:type", "content", "website"], + ["meta", "property", "og:site_name", "content", productName], + ["meta", "property", "og:title", "content", titleSuffix], + ["meta", "property", "og:description", "content", description], + ["meta", "property", "og:url", "content", canonicalUrl], + ["meta", "property", "og:image", "content", socialImage], + ["meta", "property", "og:image:width", "content", "1200"], + ["meta", "property", "og:image:height", "content", "630"], + ["meta", "name", "twitter:card", "content", "summary_large_image"], + ["meta", "name", "twitter:title", "content", titleSuffix], + ["meta", "name", "twitter:description", "content", description], + ["meta", "name", "twitter:image", "content", socialImage], + ].map(tagHtml).join("\n "); + return ` + + + + + ${escapeHtml(titleSuffix)} + + ${socialMeta} + + + + + + + + + +
    + +
    + ${heroBlock} +
    +
    ${html}${prevNext}
    + ${tocBlock} +
    +
    +
    + + +`; +} + +function pageCanonicalUrl(page) { + if (!siteBase) return page.outRel; + if (page.outRel === "index.html") return `${siteBase}/`; + const rel = page.outRel.endsWith("/index.html") ? page.outRel.slice(0, -"index.html".length) : page.outRel; + return `${siteBase}/${rel}`; +} + +function tagHtml([tag, k1, v1, k2, v2]) { + return tag === "link" ? `` : ``; +} + +function pageNavHtml(prev, next, currentOutRel) { + const cell = (page, dir) => { + if (!page) return ""; + return `${dir === "prev" ? "Previous" : "Next"}${escapeHtml(page.title)}`; + }; + return ``; +} + +function navHtml(currentPage) { + return nav + .map((section) => `

    ${escapeHtml(section.name)}

    ${section.pages.map((page) => { + const href = hrefToOutRel(page.outRel, currentPage.outRel); + const active = page.rel === currentPage.rel ? " active" : ""; + return `${escapeHtml(navTitle(page))}`; + }).join("")}
    `) + .join(""); +} + +function navTitle(page) { + if (page.rel === "index.md") return "Overview"; + return page.title; +} + +function hrefToOutRel(targetOutRel, currentOutRel) { + const currentDir = path.posix.dirname(currentOutRel); + if (targetOutRel.endsWith("/index.html")) { + const targetDir = targetOutRel.slice(0, -"index.html".length); + const rel = path.posix.relative(currentDir, targetDir || ".") || "."; + return rel.endsWith("/") ? rel : `${rel}/`; + } + if (targetOutRel === "index.html") { + const rel = path.posix.relative(currentDir, ".") || "."; + return rel.endsWith("/") ? rel : `${rel}/`; + } + return path.posix.relative(currentDir, targetOutRel) || path.posix.basename(targetOutRel); +} + +function slug(text) { + return text.toLowerCase().replace(/`/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, ""); +} + +function escapeHtml(value) { + return String(value ?? "").replace(/[&<>"']/g, (char) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[char]); +} + +function escapeAttr(value) { + return escapeHtml(value); +} + +function highlightCode(code, lang) { + const language = (lang || "text").toLowerCase(); + if (language === "bash" || language === "sh" || language === "shell" || language === "zsh" || language === "console") { + return highlightShell(code); + } + if (language === "json" || language === "json5") return highlightJson(code); + if (language === "ts" || language === "typescript" || language === "js" || language === "javascript" || language === "tsx" || language === "jsx") { + return highlightJs(code); + } + if (language === "go" || language === "golang") return highlightGo(code); + if (language === "yaml" || language === "yml") return highlightYaml(code); + return escapeHtml(code); +} + +function stashToken(idx) { + return String.fromCharCode(0xe000 + idx); +} + +function restoreStashTokens(value, stash) { + return value.replace(/[\ue000-\uf8ff]/g, (token) => { + const idx = token.charCodeAt(0) - 0xe000; + return stash[idx] ?? ""; + }); +} + +function withStash(code, patterns) { + const stash = []; + let working = code; + for (const [re, cls] of patterns) { + working = working.replace(re, (match) => { + const idx = stash.length; + stash.push(`${escapeHtml(match)}`); + return stashToken(idx); + }); + } + return restoreStashTokens(escapeHtml(working), stash); +} + +function highlightShell(code) { + return code + .split("\n") + .map((line) => { + if (/^\s*#/.test(line)) return `${escapeHtml(line)}`; + const promptMatch = line.match(/^(\s*)([$#>])(\s+)(.*)$/); + if (promptMatch) { + const [, lead, sym, gap, rest] = promptMatch; + return `${escapeHtml(lead)}${escapeHtml(sym)}${escapeHtml(gap)}${highlightShellLine(rest)}`; + } + return highlightShellLine(line); + }) + .join("\n"); +} + +function highlightShellLine(line) { + const stash = []; + const stashAdd = (match, cls) => { + const idx = stash.length; + stash.push(`${escapeHtml(match)}`); + return stashToken(idx); + }; + let working = line; + working = working.replace(/(?:'[^']*'|"[^"]*")/g, (m) => stashAdd(m, "hl-s")); + working = working.replace(/\s#.*$/g, (m) => stashAdd(m, "hl-c")); + working = working.replace(/(^|\s)(--?[A-Za-z][A-Za-z0-9-]*)/g, (_, lead, flag) => `${escapeHtml(lead)}${stashAdd(flag, "hl-f")}`); + working = working.replace(/\b(songsee|ffmpeg|brew|go|git|gh|make|sudo|cd|export|cat|curl|find|xargs|parallel|ls|mv|cp|rm|mkdir|tail|node|npm|pnpm|yarn|ssh|imgcat)\b/g, (m) => stashAdd(m, "hl-cmd")); + working = working.replace(/\b(\d+(?:\.\d+)?)\b/g, (m) => stashAdd(m, "hl-n")); + return restoreStashTokens(escapeHtml(working), stash); +} + +function highlightJson(code) { + return withStash(code, [ + [/"(?:\\.|[^"\\])*"\s*:/g, "hl-k"], + [/"(?:\\.|[^"\\])*"/g, "hl-s"], + [/\b(true|false|null)\b/g, "hl-m"], + [/-?\b\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/gi, "hl-n"], + ]); +} + +function highlightJs(code) { + return withStash(code, [ + [/\/\/[^\n]*/g, "hl-c"], + [/\/\*[\s\S]*?\*\//g, "hl-c"], + [/`(?:\\.|[^`\\])*`/g, "hl-s"], + [/"(?:\\.|[^"\\])*"/g, "hl-s"], + [/'(?:\\.|[^'\\])*'/g, "hl-s"], + [/\b(const|let|var|function|return|if|else|for|while|switch|case|break|continue|class|extends|new|import|from|export|default|async|await|try|catch|finally|throw|typeof|instanceof|interface|type|enum|as|of|in|null|undefined|true|false|this)\b/g, "hl-k"], + [/\b(\d+(?:\.\d+)?)\b/g, "hl-n"], + ]); +} + +function highlightGo(code) { + return withStash(code, [ + [/\/\/[^\n]*/g, "hl-c"], + [/\/\*[\s\S]*?\*\//g, "hl-c"], + [/`[^`]*`/g, "hl-s"], + [/"(?:\\.|[^"\\])*"/g, "hl-s"], + [/\b(package|import|func|return|if|else|for|range|switch|case|break|continue|default|type|struct|interface|map|chan|go|defer|select|var|const|nil|true|false|iota)\b/g, "hl-k"], + [/\b(\d+(?:\.\d+)?)\b/g, "hl-n"], + ]); +} + +function highlightYaml(code) { + return code + .split("\n") + .map((line) => { + if (/^\s*#/.test(line)) return `${escapeHtml(line)}`; + const m = line.match(/^(\s*-?\s*)([A-Za-z0-9_.-]+)(\s*:)(.*)$/); + if (m) { + const [, lead, key, colon, rest] = m; + return `${escapeHtml(lead)}${escapeHtml(key)}${escapeHtml(colon)}${highlightYamlValue(rest)}`; + } + return escapeHtml(line); + }) + .join("\n"); +} + +function highlightYamlValue(rest) { + if (!rest.trim()) return escapeHtml(rest); + const trimmed = rest.trim(); + if (/^["'].*["']$/.test(trimmed)) { + return escapeHtml(rest.replace(trimmed, "")) + `${escapeHtml(trimmed)}`; + } + if (/^(true|false|null|~)$/i.test(trimmed)) { + return escapeHtml(rest.replace(trimmed, "")) + `${escapeHtml(trimmed)}`; + } + if (/^-?\d+(\.\d+)?$/.test(trimmed)) { + return escapeHtml(rest.replace(trimmed, "")) + `${escapeHtml(trimmed)}`; + } + return escapeHtml(rest); +} + +function validateLinks(outputDir) { + const failures = []; + for (const file of allHtml(outputDir)) { + const html = fs.readFileSync(file, "utf8"); + for (const match of html.matchAll(/href="([^"]+)"/g)) { + const href = match[1]; + if (/^(#|https?:|mailto:|tel:|javascript:)/.test(href)) continue; + const [rawPath, anchor = ""] = href.split("#"); + const targetPath = rawPath + ? path.resolve(path.dirname(file), rawPath) + : file; + const target = fs.existsSync(targetPath) && fs.statSync(targetPath).isDirectory() + ? path.join(targetPath, "index.html") + : targetPath; + if (!fs.existsSync(target)) { + failures.push(`${path.relative(outputDir, file)}: ${href} -> missing ${path.relative(outputDir, target)}`); + continue; + } + if (anchor) { + const targetHtml = fs.readFileSync(target, "utf8"); + if (!targetHtml.includes(`id="${anchor}"`) && !targetHtml.includes(`name="${anchor}"`)) { + failures.push(`${path.relative(outputDir, file)}: ${href} -> missing anchor`); + } + } + } + } + if (failures.length) { + throw new Error(`broken docs links:\n${failures.join("\n")}`); + } +} + +function allHtml(dir) { + return fs + .readdirSync(dir, { withFileTypes: true }) + .flatMap((entry) => { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) return allHtml(full); + return entry.name.endsWith(".html") ? [full] : []; + }) + .sort(); +} diff --git a/scripts/docs-site-assets.mjs b/scripts/docs-site-assets.mjs new file mode 100644 index 0000000..e82a6d3 --- /dev/null +++ b/scripts/docs-site-assets.mjs @@ -0,0 +1,292 @@ +export function css() { + return ` +:root{ + --ink:#0f1115; + --text:#1f2328; + --muted:#6b7280; + --subtle:#9aa1ab; + --bg:#fafafa; + --paper:#ffffff; + --accent:#6f4cff; + --accent-soft:rgba(111,76,255,.10); + --accent-strong:#5938e5; + --s-violet:#6f4cff;--s-magenta:#e0438a;--s-amber:#ff8b3d;--s-cyan:#36d3c4; + --line:#e5e7eb; + --line-soft:#eef0f3; + --code-bg:#0f172a; + --code-fg:#e6edf3; + --code-inline-fg:#1c2128; + --code-border:#1f2937; + --pill-border:#dbe2eb; + --shadow-card:0 4px 14px rgba(15,17,21,.08); + --scrollbar:#cbd5e1; + --hl-keyword:#7aa2ff; + --hl-string:#9ece6a; + --hl-number:#e0a96d; + --hl-comment:#7c8597; + --hl-flag:#c4a4ff; + --hl-meta:#f08aa0; + --hl-prompt:#64748b; +} +:root[data-theme="dark"]{ + --ink:#f3f5f9; + --text:#cbd2dc; + --muted:#8d96a4; + --subtle:#5d6371; + --bg:#0c0e14; + --paper:#171a23; + --accent:#a48bff; + --accent-soft:rgba(164,139,255,.16); + --accent-strong:#bda8ff; + --line:#262a36; + --line-soft:#1d2029; + --code-bg:#06080d; + --code-fg:#e6edf3; + --code-inline-fg:#e6edf3; + --code-border:#1c2030; + --pill-border:#2a2f3c; + --shadow-card:0 4px 18px rgba(0,0,0,.45); + --scrollbar:#3a4154; + --hl-keyword:#7aa2ff; + --hl-string:#a6e3a1; + --hl-number:#f0a868; + --hl-comment:#6b7388; + --hl-flag:#c4a4ff; + --hl-meta:#ff8aa0; + --hl-prompt:#7e8ba3; +} +:root{color-scheme:light} +:root[data-theme="dark"]{color-scheme:dark} +*{box-sizing:border-box} +html{scroll-behavior:smooth;scroll-padding-top:24px} +body{margin:0;background:var(--bg);color:var(--text);font-family:"Inter",ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;line-height:1.65;overflow-x:hidden;-webkit-font-smoothing:antialiased;font-feature-settings:"cv02","cv03","cv04","cv11";transition:background-color .18s,color .18s} +::selection{background:var(--accent);color:#fff} +a{color:var(--accent);text-decoration:none;transition:color .12s} +a:hover{text-decoration:underline;text-underline-offset:.2em} +.shell{display:grid;grid-template-columns:268px minmax(0,1fr);min-height:100vh} +.sidebar{position:sticky;top:0;height:100vh;overflow:auto;padding:24px 22px;background:var(--paper);border-right:1px solid var(--line);scrollbar-width:thin;scrollbar-color:var(--line) transparent;transition:background-color .18s,border-color .18s} +.sidebar::-webkit-scrollbar{width:6px} +.sidebar::-webkit-scrollbar-thumb{background:var(--line);border-radius:6px} +.sidebar-head{display:flex;align-items:center;gap:10px;margin-bottom:24px} +.brand{display:flex;align-items:center;gap:11px;color:var(--ink);text-decoration:none;flex:1;min-width:0} +.brand:hover{text-decoration:none} +.brand .mark{display:grid;grid-template-columns:repeat(2,12px);grid-template-rows:repeat(2,12px);gap:3px;flex:0 0 27px} +.brand .mark i{display:block;border-radius:3px} +.brand .mark i:nth-child(1){background:var(--s-violet)} +.brand .mark i:nth-child(2){background:var(--s-magenta)} +.brand .mark i:nth-child(3){background:var(--s-cyan)} +.brand .mark i:nth-child(4){background:var(--s-amber)} +.brand strong{display:block;font-size:1.05rem;line-height:1.1;font-weight:600;letter-spacing:0;color:var(--ink)} +.brand small{display:block;color:var(--muted);font-size:.74rem;margin-top:3px;font-weight:400} +.theme-toggle{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;width:34px;height:34px;border-radius:8px;border:1px solid var(--line);background:var(--paper);color:var(--muted);cursor:pointer;padding:0;transition:border-color .15s,color .15s,background-color .15s,transform .12s} +.theme-toggle:hover{border-color:var(--ink);color:var(--ink)} +.theme-toggle:active{transform:scale(.94)} +.theme-toggle svg{width:16px;height:16px;display:block} +.theme-icon-sun{display:none} +:root[data-theme="dark"] .theme-icon-sun{display:block} +:root[data-theme="dark"] .theme-icon-moon{display:none} +.search{display:block;margin:0 0 22px} +.search span{display:block;color:var(--muted);font-size:.7rem;font-weight:600;text-transform:uppercase;letter-spacing:0;margin-bottom:7px} +.search input{width:100%;border:1px solid var(--line);background:var(--paper);border-radius:8px;padding:9px 12px;font:inherit;font-size:.9rem;color:var(--text);outline:none;transition:border-color .15s,box-shadow .15s,background-color .18s} +.search input:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)} +nav section{margin:0 0 18px} +nav h2{font-size:.68rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 6px;font-weight:600} +.nav-link{display:block;color:var(--text);text-decoration:none;border-radius:6px;padding:5px 10px;margin:1px 0;font-size:.9rem;line-height:1.4;transition:background .12s,color .12s} +.nav-link:hover{background:var(--line-soft);color:var(--ink);text-decoration:none} +.nav-link.active{background:var(--accent-soft);color:var(--accent);font-weight:600} +main{min-width:0;padding:32px clamp(20px,4.5vw,56px) 80px;max-width:1180px;margin:0 auto;width:100%} +.hero{display:flex;align-items:flex-end;justify-content:space-between;gap:22px;border-bottom:1px solid var(--line);padding:8px 0 22px;margin-bottom:8px;flex-wrap:wrap} +.hero-text{min-width:0;flex:1 1 320px} +.eyebrow{margin:0 0 8px;color:var(--muted);font-weight:600;text-transform:uppercase;letter-spacing:0;font-size:.7rem} +.hero h1{font-size:2.25rem;line-height:1.1;letter-spacing:0;margin:0;font-weight:700;color:var(--ink)} +.hero-meta{display:flex;gap:8px;flex:0 0 auto;flex-wrap:wrap} +.repo,.edit,.btn-ghost{border:1px solid var(--line);color:var(--text);text-decoration:none;border-radius:7px;padding:6px 11px;font-weight:500;font-size:.83rem;background:var(--paper);transition:border-color .15s,color .15s,background .15s} +.repo:hover,.edit:hover,.btn-ghost:hover{border-color:var(--ink);color:var(--ink);text-decoration:none} +.edit{color:var(--muted)} +.home-hero{padding:14px 0 28px;margin-bottom:8px;border-bottom:1px solid var(--line)} +.home-hero h1{font-size:3.25rem;line-height:1.04;letter-spacing:0;margin:0 0 .35em;font-weight:700;color:var(--ink);background:linear-gradient(120deg,var(--s-violet),var(--s-magenta) 45%,var(--s-amber) 80%,var(--s-cyan));-webkit-background-clip:text;background-clip:text;color:transparent} +.home-hero .lede{font-size:1.18rem;line-height:1.55;color:var(--text);margin:0 0 1.2em;max-width:60ch} +.home-cta{display:flex;flex-wrap:wrap;gap:10px;align-items:center;margin:0 0 18px} +.home-cta .btn{display:inline-flex;align-items:center;gap:7px;border-radius:8px;padding:10px 16px;font-weight:600;font-size:.92rem;text-decoration:none;transition:background .15s,border-color .15s,color .15s,transform .12s} +.home-cta .btn-primary{background:var(--accent);color:#fff;border:1px solid var(--accent)} +.home-cta .btn-primary:hover{background:var(--accent-strong);border-color:var(--accent-strong);text-decoration:none} +.home-cta .btn-ghost{padding:10px 16px} +.home-install{display:flex;align-items:center;gap:12px;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:10px 10px 10px 16px;font:500 .9rem/1.2 "JetBrains Mono","SF Mono",ui-monospace,monospace;max-width:32em;border:1px solid #1f2937} +.home-install .prompt{color:#64748b;user-select:none;flex:0 0 auto} +.home-install code{flex:1;background:transparent;border:0;color:var(--code-fg);font:inherit;padding:0;white-space:pre;overflow:hidden;text-overflow:ellipsis} +.home-install .copy{flex:0 0 auto;background:rgba(255,255,255,.08);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:5px 11px;font:500 .72rem/1 "Inter",sans-serif;cursor:pointer;transition:background .15s,border-color .15s} +.home-install .copy:hover{background:rgba(255,255,255,.16)} +.home-install .copy.copied{background:var(--accent);border-color:var(--accent)} +.home-services{display:flex;flex-wrap:wrap;gap:6px;margin:6px 0 18px} +.home-services span{display:inline-block;padding:3px 9px;border:1px solid var(--line);border-radius:999px;font-size:.78rem;color:var(--muted);background:var(--paper)} +.doc-grid{display:grid;grid-template-columns:minmax(0,1fr);gap:48px;margin-top:24px} +.doc-grid-home{margin-top:8px} +@media(min-width:1180px){.doc-grid{grid-template-columns:minmax(0,72ch) 200px;justify-content:start}.doc-grid-home{grid-template-columns:minmax(0,76ch);justify-content:start}} +.doc{min-width:0;max-width:72ch;overflow-wrap:break-word} +.doc-home{max-width:76ch} +.doc h1{font-size:2.6rem;line-height:1.08;letter-spacing:0;margin:0 0 .4em;font-weight:700;color:var(--ink)} +body:not(.home) .doc>h1:first-child{display:none} +.doc h2{font-size:1.45rem;line-height:1.2;margin:2em 0 .5em;font-weight:600;letter-spacing:0;color:var(--ink);position:relative} +.doc h3{font-size:1.1rem;margin:1.7em 0 .35em;position:relative;font-weight:600;color:var(--ink);letter-spacing:0} +.doc h4{font-size:.98rem;margin:1.4em 0 .25em;color:var(--ink);position:relative;font-weight:600} +.doc h2:first-child,.doc h3:first-child,.doc h4:first-child{margin-top:.2em} +.doc :is(h2,h3,h4) .anchor{position:absolute;left:-1.05em;top:0;color:var(--subtle);opacity:0;text-decoration:none;font-weight:400;padding-right:.3em;transition:opacity .12s,color .12s} +.doc :is(h2,h3,h4):hover .anchor{opacity:.7} +.doc :is(h2,h3,h4) .anchor:hover{opacity:1;color:var(--accent);text-decoration:none} +.doc p{margin:0 0 1.05em} +.doc ul,.doc ol{padding-left:1.3rem;margin:0 0 1.15em} +.doc li{margin:.25em 0} +.doc li>p{margin:0 0 .4em} +.doc strong{font-weight:600;color:var(--ink)} +.doc em{font-style:italic} +.doc code{font-family:"JetBrains Mono","SF Mono",ui-monospace,monospace;font-size:.84em;background:var(--line-soft);border:1px solid var(--line);border-radius:5px;padding:.08em .35em;color:var(--code-inline-fg)} +.doc pre{position:relative;overflow:auto;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:14px 18px;margin:1.3em 0;font-size:.85em;line-height:1.6;scrollbar-width:thin;scrollbar-color:#334155 transparent;border:1px solid var(--code-border)} +.doc pre::-webkit-scrollbar{height:8px;width:8px} +.doc pre::-webkit-scrollbar-thumb{background:#334155;border-radius:8px} +.doc pre code{display:block;background:transparent;border:0;color:inherit;padding:0;font-size:1em;white-space:pre} +.doc pre .copy{position:absolute;top:8px;right:8px;background:rgba(255,255,255,.06);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:3px 9px;font:500 .7rem/1 "Inter",sans-serif;cursor:pointer;opacity:0;transition:opacity .15s,background .15s,border-color .15s} +.doc pre:hover .copy,.doc pre .copy:focus{opacity:1} +.doc pre .copy:hover{background:rgba(255,255,255,.12)} +.doc pre .copy.copied{background:var(--accent);border-color:var(--accent);opacity:1} +.doc pre .hl-c{color:var(--hl-comment);font-style:italic} +.doc pre .hl-s{color:var(--hl-string)} +.doc pre .hl-n{color:var(--hl-number)} +.doc pre .hl-k{color:var(--hl-keyword);font-weight:600} +.doc pre .hl-f{color:var(--hl-flag)} +.doc pre .hl-m{color:var(--hl-meta);font-weight:600} +.doc pre .hl-p{color:var(--hl-prompt);user-select:none} +.doc pre .hl-cmd{color:var(--hl-keyword);font-weight:600} +.doc blockquote{margin:1.4em 0;padding:10px 16px;border-left:3px solid var(--accent);background:var(--accent-soft);border-radius:0 8px 8px 0;color:var(--text)} +.doc blockquote p:last-child{margin-bottom:0} +.doc table{width:100%;border-collapse:collapse;margin:1.2em 0;font-size:.92em} +.doc th,.doc td{border-bottom:1px solid var(--line);padding:9px 10px;text-align:left;vertical-align:top} +.doc th{font-weight:600;color:var(--ink);background:var(--line-soft);border-bottom:1px solid var(--line)} +.doc hr{border:0;border-top:1px solid var(--line);margin:2.2em 0} +.toc{position:sticky;top:24px;align-self:start;font-size:.84rem;padding-left:14px;border-left:1px solid var(--line);max-height:calc(100vh - 48px);overflow:auto;scrollbar-width:thin;scrollbar-color:var(--line) transparent} +.toc::-webkit-scrollbar{width:5px} +.toc::-webkit-scrollbar-thumb{background:var(--line);border-radius:5px} +.toc h2{font-size:.66rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 10px;font-weight:600} +.toc a{display:block;color:var(--muted);text-decoration:none;padding:4px 0 4px 10px;line-height:1.35;border-left:2px solid transparent;margin-left:-12px;transition:color .12s,border-color .12s} +.toc a:hover{color:var(--ink);text-decoration:none} +.toc a.active{color:var(--accent);border-left-color:var(--accent);font-weight:500} +.toc-l3{padding-left:22px!important;font-size:.94em} +@media(max-width:1179px){.toc{display:none}} +.page-nav{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:48px;border-top:1px solid var(--line);padding-top:20px} +.page-nav>a{display:block;border:1px solid var(--line);background:var(--paper);border-radius:9px;padding:13px 16px;text-decoration:none;color:var(--text);transition:border-color .15s,transform .15s,box-shadow .15s,background-color .18s} +.page-nav>a:hover{border-color:var(--accent);text-decoration:none;color:var(--ink)} +.page-nav small{display:block;color:var(--muted);font-size:.7rem;text-transform:uppercase;letter-spacing:0;margin-bottom:5px;font-weight:600} +.page-nav span{display:block;font-weight:600;line-height:1.3;color:var(--ink)} +.page-nav-prev{text-align:left} +.page-nav-next{text-align:right;grid-column:2} +.page-nav-prev:only-child{grid-column:1} +.nav-toggle{display:none;position:fixed;top:14px;right:14px;top:calc(14px + env(safe-area-inset-top, 0px));right:calc(14px + env(safe-area-inset-right, 0px));z-index:20;width:40px;height:40px;border-radius:9px;background:var(--paper);border:1px solid var(--line);color:var(--ink);cursor:pointer;padding:10px 9px;flex-direction:column;align-items:stretch;justify-content:space-between;box-shadow:var(--shadow-card)} +.nav-toggle span{display:block;width:100%;height:2px;flex:0 0 2px;background:currentColor;border-radius:2px;transition:transform .2s,opacity .2s} +.nav-toggle[aria-expanded="true"] span:nth-child(1){transform:translateY(8px) rotate(45deg)} +.nav-toggle[aria-expanded="true"] span:nth-child(2){opacity:0} +.nav-toggle[aria-expanded="true"] span:nth-child(3){transform:translateY(-8px) rotate(-45deg)} +@media(max-width:900px){ + .shell{display:block} + .sidebar{position:fixed;inset:0 30% 0 0;max-width:320px;height:100vh;z-index:15;transform:translateX(-100%);transition:transform .25s ease,background-color .18s,border-color .18s;box-shadow:0 18px 40px rgba(0,0,0,.18);background:var(--paper);pointer-events:none} + .sidebar.open{transform:translateX(0);pointer-events:auto} + .nav-toggle{display:flex} + main{padding:64px 18px 56px} + .hero{padding-top:6px} + .hero h1{font-size:1.8rem} + .home-hero h1{font-size:2.45rem} + .doc h1{font-size:2.1rem} + .hero-meta{width:100%;justify-content:flex-start} + .home-hero{padding-top:8px} + .doc{padding:0} + .doc-grid{margin-top:18px;gap:24px} + .doc :is(h2,h3,h4) .anchor{display:none} +} +@media(max-width:520px){ + main{padding:60px 14px 48px} + .doc pre{margin-left:-14px;margin-right:-14px;border-radius:0;border-left:0;border-right:0} + .home-install{flex-wrap:wrap} +} +`; +} + +export function js() { + return ` +const themeRoot=document.documentElement; +function applyTheme(mode){themeRoot.dataset.theme=mode;document.querySelectorAll('[data-theme-toggle]').forEach(b=>b.setAttribute('aria-pressed',mode==='dark'?'true':'false'))} +function storedTheme(){try{return localStorage.getItem('theme')}catch(e){return null}} +function persistTheme(mode){try{localStorage.setItem('theme',mode)}catch(e){}} +applyTheme(themeRoot.dataset.theme==='dark'?'dark':'light'); +document.querySelectorAll('[data-theme-toggle]').forEach(btn=>{btn.addEventListener('click',()=>{const next=themeRoot.dataset.theme==='dark'?'light':'dark';applyTheme(next);persistTheme(next)})}); +const systemDark=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)'); +function onSystemChange(e){if(storedTheme())return;applyTheme(e.matches?'dark':'light')} +if(systemDark){if(systemDark.addEventListener)systemDark.addEventListener('change',onSystemChange);else if(systemDark.addListener)systemDark.addListener(onSystemChange)} +const sidebar=document.querySelector('.sidebar'); +const toggle=document.querySelector('.nav-toggle'); +const mobileNav=window.matchMedia('(max-width: 900px)'); +const sidebarFocusable='a[href],button,input,select,textarea,[tabindex]'; +function setSidebarFocusable(enabled){ + sidebar?.querySelectorAll(sidebarFocusable).forEach((el)=>{ + if(enabled){ + if(el.dataset.sidebarTabindex!==undefined){ + if(el.dataset.sidebarTabindex)el.setAttribute('tabindex',el.dataset.sidebarTabindex); + else el.removeAttribute('tabindex'); + delete el.dataset.sidebarTabindex; + } + }else if(el.dataset.sidebarTabindex===undefined){ + el.dataset.sidebarTabindex=el.getAttribute('tabindex')??''; + el.setAttribute('tabindex','-1'); + } + }); +} +function setSidebarOpen(open){ + if(!sidebar||!toggle)return; + sidebar.classList.toggle('open',open); + toggle.setAttribute('aria-expanded',open?'true':'false'); + if(mobileNav.matches){ + sidebar.inert=!open; + if(open)sidebar.removeAttribute('aria-hidden'); + else sidebar.setAttribute('aria-hidden','true'); + setSidebarFocusable(open); + }else{ + sidebar.inert=false; + sidebar.removeAttribute('aria-hidden'); + setSidebarFocusable(true); + } +} +setSidebarOpen(false); +toggle?.addEventListener('click',()=>setSidebarOpen(!sidebar?.classList.contains('open'))); +document.addEventListener('click',(e)=>{if(!sidebar?.classList.contains('open'))return;if(sidebar.contains(e.target)||toggle?.contains(e.target))return;setSidebarOpen(false)}); +document.addEventListener('keydown',(e)=>{if(e.key==='Escape')setSidebarOpen(false)}); +const syncSidebarForViewport=()=>setSidebarOpen(sidebar?.classList.contains('open')??false); +if(mobileNav.addEventListener)mobileNav.addEventListener('change',syncSidebarForViewport); +else mobileNav.addListener?.(syncSidebarForViewport); +const input=document.getElementById('doc-search'); +input?.addEventListener('input',()=>{const q=input.value.trim().toLowerCase();document.querySelectorAll('nav section').forEach(sec=>{let any=false;sec.querySelectorAll('.nav-link').forEach(a=>{const m=!q||a.textContent.toLowerCase().includes(q);a.style.display=m?'block':'none';if(m)any=true});sec.style.display=any?'block':'none'})}); +function attachCopy(target,getText){const btn=document.createElement('button');btn.type='button';btn.className='copy';btn.textContent='Copy';btn.addEventListener('click',async()=>{try{await navigator.clipboard.writeText(getText());btn.textContent='Copied';btn.classList.add('copied');setTimeout(()=>{btn.textContent='Copy';btn.classList.remove('copied')},1400)}catch{btn.textContent='Failed';setTimeout(()=>{btn.textContent='Copy'},1400)}});target.appendChild(btn)} +document.querySelectorAll('.doc pre').forEach(pre=>attachCopy(pre,()=>pre.querySelector('code')?.textContent??'')); +document.querySelectorAll('.home-install').forEach(el=>attachCopy(el,()=>el.querySelector('code')?.textContent??'')); +const tocLinks=document.querySelectorAll('.toc a'); +if(tocLinks.length){const map=new Map();tocLinks.forEach(a=>{const id=a.getAttribute('href').slice(1);const el=document.getElementById(id);if(el)map.set(el,a)});const setActive=l=>{tocLinks.forEach(x=>x.classList.remove('active'));l.classList.add('active')};const obs=new IntersectionObserver(entries=>{const visible=entries.filter(e=>e.isIntersecting).sort((a,b)=>a.boundingClientRect.top-b.boundingClientRect.top);if(visible.length){const link=map.get(visible[0].target);if(link)setActive(link)}},{rootMargin:'-15% 0px -65% 0px',threshold:0});map.forEach((_,el)=>obs.observe(el))} +`; +} + +export function preThemeScript() { + return `(function(){var s;try{s=localStorage.getItem('theme')}catch(e){}var d=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=s||(d?'dark':'light')})();`; +} + +export function themeToggleHtml() { + return ``; +} + +export function faviconSvg() { + return ` + + + + + + +`; +}