stropress 0.0.1

package/dist/theme-default/src/content/docs/guide/search.mdx

@@ -0,0 +1,41 @@
+---
+title: Search
+description: Configure and use search in your Stropress documentation site
+---
+
+# Search
+
+Stropress has built-in search that works out of the box — no configuration required.  
+Search is powered by local MiniSearch.
+
+## How it works
+
+A search button is displayed in the header. Clicking it opens a modal where you can type to find pages across your docs.
+
+**Keyboard shortcuts**
+
+| Key             | Action               |
+| :-------------- | :------------------- |
+| `⌘K` / `Ctrl K` | Open search          |
+| `↑` / `↓`       | Navigate results     |
+| `Enter`         | Open selected result |
+| `Esc`           | Close search         |
+
+## Local search (default)
+
+By default, Stropress indexes all your `.md` and `.mdx` pages at build time using [MiniSearch](https://lucaong.github.io/minisearch/).  
+No extra setup is needed.
+
+```json
+{
+  "search": {
+    "provider": "local"
+  }
+}
+```
+
+The `provider: "local"` line is optional — local search is enabled even without a `search` field.
+
+## Notes
+
+Search indexes your markdown content and runs fully on the client.

package/dist/theme-default/src/content/docs/index.md

@@ -0,0 +1,6 @@
+---
+title: Home
+description: Welcome to stropress
+---
+
+Home page content is driven by `docs/config.json#home`.

package/dist/theme-default/src/content/docs/zh/guide/configuration.mdx

@@ -0,0 +1,149 @@
+---
+title: 配置
+description: 配置导航、侧边栏和双语
+---
+
+# 配置
+
+使用 `docs/config.json` 配置站点信息与导航结构。
+
+- `navbar`：顶部导航
+- `nav`：显示在社交链接旁边的主导航
+- `sidebar`：侧边栏分组
+- `search`：本地搜索选项
+- `markdown`：Markdown 渲染选项
+- `locales`：多语言配置
+
+## 搜索
+
+默认搜索使用内置 MiniSearch，无需额外依赖。
+
+```json
+{
+  "search": {
+    "provider": "local"
+  }
+}
+```
+
+## 代码块主题
+
+你可以在 `docs/config.json` 中通过 `markdown.codeTheme` 配置代码块高亮主题。
+
+使用单一主题：
+
+```json
+{
+  "markdown": {
+    "codeTheme": "github-dark"
+  }
+}
+```
+
+或分别配置亮色/暗色主题：
+
+```json
+{
+  "markdown": {
+    "codeTheme": {
+      "light": "github-light",
+      "dark": "github-dark"
+    }
+  }
+}
+```
+
+常见主题名（由 Astro 通过 Shiki 提供，具体可用性取决于 Astro/Shiki 版本）：
+
+- `github-light`
+- `github-dark`
+- `one-dark-pro`
+- `dracula`
+- `nord`
+- `material-theme-darker`
+- `catppuccin-latte`
+- `catppuccin-frappe`
+- `catppuccin-macchiato`
+- `catppuccin-mocha`
+
+One Dark + Catppuccin 示例：
+
+```json
+{
+  "markdown": {
+    "codeTheme": {
+      "light": "catppuccin-latte",
+      "dark": "one-dark-pro"
+    }
+  }
+}
+```
+
+如果主题名在当前版本不可用，`dev/build` 会提示主题加载错误。
+
+## 双语配置
+
+推荐将中文文档放在 `docs/zh/...` 目录下，并在 `locales` 中配置 `/zh/`：
+
+```json
+{
+  "locales": {
+    "/": {
+      "label": "English",
+      "lang": "en-US"
+    },
+    "/zh/": {
+      "label": "简体中文",
+      "lang": "zh-CN"
+    }
+  }
+}
+```
+
+## 自定义首页
+
+如果 `config.json` 里的 `home` 配置不够灵活，可以直接在 `config.json` 同目录放置 Astro 首页文件：
+
+```text
+docs/
+  config.json
+  index.astro
+  zh/
+    index.astro
+```
+
+- `docs/index.astro` 会覆盖根路径 `/` 的首页。
+- `docs/zh/index.astro` 会覆盖 `/zh/` 的多语言首页。
+- 只要存在匹配的 `index.astro`，Stropress 就会优先使用它，而不是 `home` 或 `locales[locale].home`。
+
+这些文件会渲染在默认文档布局内部。你也可以在 Astro frontmatter 中导出一些可选元信息：
+
+```astro
+---
+export const title = "自定义首页";
+export const description = "使用 Astro 编写的首页";
+export const sidebar = false;
+---
+
+<section>
+  <h1>自定义首页</h1>
+</section>
+```
+
+## 全局样式覆盖
+
+你可以在根目录增加 `docs/index.css`，用来全局覆盖默认主题样式。
+
+这份文件会在内置主题 CSS 之后加载，因此适合用来重写 `:root` 变量，或者覆盖主题里的选择器。
+
+```css
+:root {
+  --background-color: 250 247 240;
+  --foreground-color: 28 28 28;
+  --primary-color: 176 78 44;
+}
+
+.topbar {
+  backdrop-filter: blur(20px);
+}
+```

package/dist/theme-default/src/content/docs/zh/guide/getting-started.md

@@ -0,0 +1,31 @@
+---
+title: 快速开始
+description: 快速启动你的文档站点
+---
+
+# 快速开始
+
+`docs/` 目录下的 Markdown 文件会被渲染为静态页面。
+
+## 运行开发环境
+
+```bash
+bun run dev --dir=docs
+```
+
+## 构建生产版本
+
+```bash
+bun run build --dir=docs
+```
+
+## 目录建议
+
+```text
+docs/
+  config.json
+  index.md
+  guide/
+    getting-started.md
+    configuration.mdx
+```

package/dist/theme-default/src/content/docs/zh/guide/search.mdx

@@ -0,0 +1,23 @@
+---
+title: 搜索
+description: 配置与使用站点搜索
+---
+
+# 搜索
+
+Stropress 内置本地搜索，开箱即用。
+
+## 使用方式
+
+在 Header 点击搜索按钮，输入关键词即可检索文档内容。
+
+快捷键：
+
+- `⌘K` / `Ctrl K`：打开搜索
+- `↑` / `↓`：切换结果
+- `Enter`：打开结果
+- `Esc`：关闭弹窗
+
+## 说明
+
+搜索会索引当前语言下的文档内容，并在前端完成查询。

package/dist/theme-default/src/content/docs/zh/index.astro

@@ -0,0 +1,75 @@
+---
+export const title = "自定义首页";
+export const description = "用于验证 docs/zh/index.astro 是否生效的示例首页";
+export const sidebar = false;
+---
+
+<section class="custom-home">
+  <p class="eyebrow">Custom Astro Home</p>
+  <h1>这是 docs/zh/index.astro</h1>
+  <p class="lead">
+    如果你现在访问 <code>/zh/</code
+    >，看到的是这块内容，就说明多语言自定义首页已经生效。
+  </p>
+
+  <div class="actions">
+    <a class="action primary" href="/zh/guide/getting-started">快速开始</a>
+    <a class="action secondary" href="/zh/guide/configuration">查看配置</a>
+  </div>
+</section>
+
+<style>
+  .custom-home {
+    padding: 2rem 1rem 3rem;
+  }
+
+  .eyebrow {
+    margin: 0 0 0.75rem;
+    font-size: 0.85rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  h1 {
+    margin: 0;
+    font-size: clamp(2.5rem, 7vw, 4.5rem);
+    line-height: 1;
+  }
+
+  .lead {
+    max-width: 42rem;
+    margin: 1rem 0 0;
+    font-size: 1.05rem;
+    line-height: 1.8;
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  .actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.75rem;
+    margin-top: 1.75rem;
+  }
+
+  .action {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0.85rem 1.15rem;
+    font-weight: 700;
+    text-decoration: none;
+    border: 1px solid rgba(var(--border-color) / 1);
+  }
+
+  .action.primary {
+    background: rgba(var(--primary-color) / 1);
+    border-color: rgba(var(--primary-color) / 1);
+    color: rgba(var(--primary-foreground-color) / 1);
+  }
+
+  .action.secondary {
+    color: rgba(var(--foreground-color) / 1);
+  }
+</style>

package/dist/theme-default/src/content/docs/zh/index.md

@@ -0,0 +1,6 @@
+---
+title: 首页
+description: 欢迎使用 Stropress
+---
+
+首页内容由 `docs/config.json` 中的 `locales["/zh/"].home` 驱动。

package/dist/theme-default/src/content.config.ts

@@ -0,0 +1,14 @@
+import { defineCollection, z } from "astro:content";
+import { glob } from "astro/loaders";
+
+const docs = defineCollection({
+  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/content/docs" }),
+  schema: z.object({
+    title: z.string(),
+    description: z.string().optional(),
+  }),
+});
+
+export const collections = {
+  docs,
+};

package/dist/theme-default/src/env.d.ts

@@ -0,0 +1,15 @@
+declare module "@lucide/astro" {
+  export type LucideIconComponent = (props: Record<string, unknown>) => any;
+  export const icons: Record<string, LucideIconComponent>;
+}
+
+declare module "copy-to-clipboard" {
+  interface Options {
+    debug?: boolean;
+    message?: string;
+    format?: string;
+    onCopy?: (clipboardData: object) => void;
+  }
+  const copy: (text: string, options?: Options) => boolean;
+  export default copy;
+}

package/dist/theme-default/src/layouts/DocsLayout.astro

@@ -0,0 +1,278 @@
+---
+import NavBar from "../components/NavBar.astro";
+import Sidebar from "../components/Sidebar.astro";
+import DocToc from "../components/DocToc.astro";
+import BaseHead from "../components/BaseHead.astro";
+import { getResolvedSiteConfig } from "../lib/config";
+import { customGlobalStyle } from "../lib/custom-style";
+import "../styles/global.css";
+import "../styles/markdown.css";
+
+interface Props {
+  title?: string;
+  description?: string;
+  sidebar?: boolean;
+  contentClass?: string;
+  tocHeadings?: Array<{
+    depth: number;
+    slug: string;
+    text: string;
+  }>;
+}
+
+const {
+  title,
+  description,
+  sidebar = true,
+  contentClass = "",
+  tocHeadings = [],
+} = Astro.props;
+const resolvedConfig = getResolvedSiteConfig(Astro.url.pathname);
+const pageTitle = title
+  ? `${title} | ${resolvedConfig.siteTitle}`
+  : resolvedConfig.siteTitle;
+const pageDescription = description || resolvedConfig.siteDescription;
+const ogImagePath =
+  Astro.url.pathname === "/"
+    ? "/og/index.png"
+    : `/og${Astro.url.pathname.endsWith("/") ? Astro.url.pathname.slice(0, -1) : Astro.url.pathname}.png`;
+const tocItems = tocHeadings.filter(
+  (heading) => heading.depth >= 2 && heading.depth <= 3,
+);
+---
+
+<!doctype html>
+<html lang={resolvedConfig.localeLang}>
+  <head>
+    <BaseHead
+      title={pageTitle}
+      description={pageDescription}
+      lang={resolvedConfig.localeLang}
+      image={ogImagePath}
+      ogType={sidebar ? "article" : "website"}
+    />
+    {customGlobalStyle && <style is:global set:html={customGlobalStyle} />}
+  </head>
+  <body>
+    <NavBar showSidebarToggle={sidebar} />
+    <div class:list={["wrapper", !sidebar && "wrapper-without-sidebar"]}>
+      {
+        sidebar && (
+          <>
+            <button
+              type="button"
+              class="sider-backdrop"
+              data-sidebar-backdrop
+              data-state="closed"
+              aria-label="Close navigation menu"
+            />
+            <aside
+              id="sidebar-drawer"
+              class="sider"
+              data-sidebar-drawer
+              data-state="closed"
+            >
+              <Sidebar />
+            </aside>
+          </>
+        )
+      }
+      <main class:list={["content", contentClass]}>
+        <div
+          class:list={[
+            "docs-main",
+            tocItems.length > 0 && "docs-main-with-toc",
+          ]}
+        >
+          <div class="docs-main-content">
+            <slot />
+          </div>
+          <DocToc items={tocItems} />
+        </div>
+      </main>
+    </div>
+    <script>
+      import { setupCodeCopyButtons } from "../scripts/code-copy";
+
+      setupCodeCopyButtons();
+
+      let sidebarCleanup: (() => void) | null = null;
+
+      const setupSidebarDrawer = () => {
+        if (typeof sidebarCleanup === "function") {
+          sidebarCleanup();
+          sidebarCleanup = null;
+        }
+
+        const drawer = document.querySelector<HTMLElement>(
+          "[data-sidebar-drawer]",
+        );
+        const backdrop = document.querySelector<HTMLElement>(
+          "[data-sidebar-backdrop]",
+        );
+        const toggle = document.querySelector<HTMLElement>(
+          "[data-sidebar-toggle]",
+        );
+
+        if (!drawer || !backdrop || !toggle) {
+          return;
+        }
+
+        const linkElements = Array.from(
+          drawer.querySelectorAll<HTMLAnchorElement>("a"),
+        );
+
+        const setOpen = (open: boolean) => {
+          drawer.dataset.state = open ? "open" : "closed";
+          backdrop.dataset.state = open ? "open" : "closed";
+          toggle.setAttribute("aria-expanded", open ? "true" : "false");
+          document.body.style.overflow = open ? "hidden" : "";
+        };
+
+        const close = () => setOpen(false);
+        const onToggle = () => setOpen(drawer.dataset.state !== "open");
+
+        toggle.addEventListener("click", onToggle);
+        backdrop.addEventListener("click", close);
+        linkElements.forEach((element: HTMLAnchorElement) =>
+          element.addEventListener("click", close),
+        );
+
+        const onKeydown = (event: KeyboardEvent) => {
+          if (event.key === "Escape") {
+            close();
+          }
+        };
+
+        const onResize = () => {
+          if (window.innerWidth > 900) {
+            close();
+          }
+        };
+
+        document.addEventListener("keydown", onKeydown);
+        window.addEventListener("resize", onResize);
+
+        sidebarCleanup = () => {
+          toggle.removeEventListener("click", onToggle);
+          backdrop.removeEventListener("click", close);
+          linkElements.forEach((element: HTMLAnchorElement) =>
+            element.removeEventListener("click", close),
+          );
+          document.removeEventListener("keydown", onKeydown);
+          window.removeEventListener("resize", onResize);
+          document.body.style.overflow = "";
+        };
+      };
+
+      setupSidebarDrawer();
+      document.addEventListener("astro:page-load", setupSidebarDrawer);
+    </script>
+  </body>
+</html>
+
+<style is:global>
+  body {
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+  }
+
+  .sider {
+    flex-shrink: 0;
+    width: 16rem;
+  }
+
+  .sider-backdrop {
+    display: none;
+  }
+
+  .wrapper {
+    display: flex;
+    flex-direction: row;
+    width: 100%;
+    max-width: 80rem;
+    margin: 0 auto;
+    flex: 1;
+    min-height: 0;
+  }
+
+  .content {
+    flex: 1;
+    min-width: 0;
+  }
+
+  .docs-main {
+    width: 100%;
+    min-width: 0;
+  }
+
+  .wrapper-without-sidebar {
+    width: 100%;
+    border-width: 0 1px 0 1px;
+    border-style: solid;
+    border-color: rgba(var(--border-color) / 1);
+  }
+
+  @media (min-width: 1200px) {
+    .docs-main-with-toc {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) 15rem;
+      gap: 2rem;
+      align-items: start;
+    }
+  }
+
+  @media (max-width: 900px) {
+    .wrapper {
+      flex-direction: column;
+    }
+
+    .wrapper-without-sidebar {
+      border-width: 0 0 0 0;
+    }
+
+    .sider-backdrop {
+      display: block;
+      position: fixed;
+      inset: 0;
+      z-index: 20;
+      border: 0;
+      background: rgba(0 0 0 / 0.4);
+      opacity: 0;
+      pointer-events: none;
+      transition: opacity 180ms ease;
+    }
+
+    .sider-backdrop[data-state="open"] {
+      opacity: 1;
+      pointer-events: auto;
+    }
+
+    .sider {
+      position: fixed;
+      left: 0;
+      top: 0;
+      z-index: 30;
+      width: min(84vw, 18rem);
+      height: 100dvh;
+      transform: translateX(-100%);
+      transition: transform 220ms ease;
+      background: rgba(var(--background-color) / 1);
+      border-right: 1px solid rgba(var(--border-color) / 1);
+      padding: 5rem 0.5rem 1rem;
+      overflow-y: auto;
+    }
+
+    .sider[data-state="open"] {
+      transform: translateX(0);
+    }
+
+    .content {
+      border-left: 0;
+      padding-inline: 0;
+      padding-bottom: 0;
+      padding-top: 1.5rem;
+    }
+  }
+</style>