stropress 0.0.1

package/dist/theme-default/src/components/SearchInput.astro

@@ -0,0 +1,84 @@
+<div class="site-search-trigger" data-search-open>
+  <button
+    id="site-search-trigger-button"
+    class="site-search-trigger-button"
+    type="button"
+    aria-label="Open search"
+    aria-haspopup="dialog"
+    data-search-trigger
+  >
+    <span class="site-search-trigger-text">Search...</span>
+  </button>
+  <span class="site-search-shortcut" aria-hidden="true">⌘K</span>
+</div>
+
+<style is:global>
+  .site-search-trigger {
+    position: relative;
+    display: flex;
+    align-items: center;
+    width: min(10rem, 20vw);
+  }
+
+  .site-search-trigger-button {
+    width: 100%;
+    border: 1px solid rgba(var(--border-color) / 1);
+    border-radius: var(--border-radius);
+    background: rgba(var(--background-color) / 0.92);
+    color: rgba(var(--foreground-color) / 1);
+    text-align: left;
+    font-size: 0.875rem;
+    line-height: 1;
+    padding: 0.7rem 4.25rem 0.7rem 1rem;
+    cursor: pointer;
+    transition:
+      border-color 160ms ease,
+      box-shadow 160ms ease;
+  }
+
+  .site-search-trigger-text {
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  .site-search-trigger-button:hover,
+  .site-search-trigger-button:focus-visible {
+    border-color: rgba(var(--foreground-color) / 0.35);
+    box-shadow: 0 0 0 4px rgba(var(--foreground-color) / 0.06);
+    outline: none;
+  }
+
+  .site-search-shortcut {
+    position: absolute;
+    right: 0.55rem;
+    top: 50%;
+    transform: translateY(-50%);
+    border-radius: 999px;
+    border: 1px solid rgba(var(--border-color) / 1);
+    padding: 0.2rem 0.5rem;
+    font-size: 0.72rem;
+    color: rgba(var(--muted-color) / 1);
+    background: rgba(var(--background-color) / 0.95);
+    pointer-events: none;
+  }
+
+  .site-search-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    border: 0;
+    padding: 0;
+    white-space: nowrap;
+    clip-path: inset(100%);
+    clip: rect(0 0 0 0);
+    overflow: hidden;
+  }
+
+  @media (max-width: 900px) {
+    .site-search-trigger {
+      width: 100%;
+      max-width: 100%;
+      order: 3;
+    }
+  }
+</style>

package/dist/theme-default/src/components/SearchModal.astro

@@ -0,0 +1,209 @@
+---
+import type { SearchDocument } from "../scripts/search";
+
+interface Props {
+  documents: SearchDocument[];
+}
+
+const { documents } = Astro.props;
+---
+
+<div
+  class="site-search-modal"
+  data-search-modal
+  data-search-documents={JSON.stringify(documents)}
+  data-state="closed"
+  aria-hidden="true"
+>
+  <button
+    class="site-search-modal-backdrop"
+    type="button"
+    aria-label="Close search"
+    data-search-close></button>
+  <section
+    class="site-search-panel"
+    role="dialog"
+    aria-modal="true"
+    aria-labelledby="site-search-title"
+  >
+    <div class="site-search-panel-header">
+      <h2 id="site-search-title">Search Documentation</h2>
+      <button
+        class="site-search-close"
+        type="button"
+        aria-label="Close search"
+        data-search-close
+      >
+        Esc
+      </button>
+    </div>
+
+    <input
+      id="site-search-modal-input"
+      class="site-search-input"
+      type="search"
+      placeholder="Type to search..."
+      autocomplete="off"
+      spellcheck="false"
+      data-search-input
+    />
+
+    <p class="site-search-hint" data-search-hint>
+      Press ↑/↓ to navigate, Enter to open.
+    </p>
+
+    <ul class="site-search-results" data-search-results></ul>
+
+    <p class="site-search-empty" data-search-empty hidden>No results found.</p>
+  </section>
+</div>
+
+<script>
+  import { setupSearch } from "../scripts/search";
+
+  const modal = document.querySelector<HTMLElement>("[data-search-modal]");
+  const rawDocuments = modal?.dataset.searchDocuments || "[]";
+
+  try {
+    const documents = JSON.parse(rawDocuments);
+    if (Array.isArray(documents)) {
+      setupSearch(documents);
+    }
+  } catch {
+    setupSearch([]);
+  }
+</script>
+
+<style is:global>
+  .site-search-modal {
+    position: fixed;
+    inset: 0;
+    z-index: 80;
+    display: none;
+    width: 100vw;
+    height: 100vh;
+  }
+
+  .site-search-modal[data-state="open"] {
+    display: grid;
+    place-items: start center;
+    padding: clamp(1rem, 5vh, 5rem) 1rem 1rem;
+  }
+
+  .site-search-modal-backdrop {
+    position: absolute;
+    inset: 0;
+    border: 0;
+    background: rgba(10 10 10 / 0.44);
+    backdrop-filter: blur(3px);
+    cursor: pointer;
+  }
+
+  .site-search-panel {
+    position: relative;
+    width: min(44rem, 100%);
+    border-radius: 1rem;
+    border: 1px solid rgba(var(--border-color) / 1);
+    background: rgba(var(--background-color) / 1);
+    box-shadow:
+      0 22px 60px rgba(0 0 0 / 0.24),
+      0 1px 0 rgba(255 255 255 / 0.08) inset;
+    overflow: hidden;
+  }
+
+  .site-search-panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 1rem;
+    padding: 1rem 1rem 0.5rem;
+  }
+
+  .site-search-panel-header h2 {
+    margin: 0;
+    font-size: 1rem;
+    font-weight: 650;
+  }
+
+  .site-search-close {
+    border: 1px solid rgba(var(--border-color) / 1);
+    background: transparent;
+    color: rgba(var(--muted-color) / 1);
+    border-radius: 0.5rem;
+    font-size: 0.75rem;
+    padding: 0.25rem 0.5rem;
+    cursor: pointer;
+  }
+
+  .site-search-input {
+    width: calc(100% - 2rem);
+    margin: 0.5rem 1rem 0;
+    border-radius: 0.75rem;
+    border: 1px solid rgba(var(--border-color) / 1);
+    padding: 0.75rem 0.875rem;
+    font-size: 0.95rem;
+    background: rgba(var(--background-color) / 1);
+    color: rgba(var(--foreground-color) / 1);
+  }
+
+  .site-search-input:focus-visible {
+    border-color: rgba(var(--foreground-color) / 0.38);
+    box-shadow: 0 0 0 4px rgba(var(--foreground-color) / 0.08);
+    outline: none;
+  }
+
+  .site-search-hint {
+    margin: 0;
+    padding: 0.55rem 1rem 0.85rem;
+    font-size: 0.78rem;
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  .site-search-results {
+    list-style: none;
+    margin: 0;
+    padding: 0.25rem;
+    max-height: min(26rem, 60vh);
+    overflow-y: auto;
+    border-top: 1px solid rgba(var(--border-color) / 1);
+  }
+
+  .site-search-result-item {
+    margin: 0;
+    border-radius: 0.75rem;
+  }
+
+  .site-search-result-link {
+    display: grid;
+    gap: 0.2rem;
+    padding: 0.7rem 0.8rem;
+    border-radius: 0.75rem;
+    transition: background 120ms ease;
+  }
+
+  .site-search-result-link:hover,
+  .site-search-result-link:focus-visible,
+  .site-search-result-item[data-state="active"] .site-search-result-link {
+    background: rgba(var(--accent-color) / 1);
+    outline: none;
+  }
+
+  .site-search-result-title {
+    font-size: 0.92rem;
+    font-weight: 630;
+  }
+
+  .site-search-result-desc {
+    font-size: 0.82rem;
+    line-height: 1.45;
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  .site-search-empty {
+    margin: 0;
+    padding: 1rem;
+    font-size: 0.88rem;
+    color: rgba(var(--muted-color) / 1);
+    border-top: 1px solid rgba(var(--border-color) / 1);
+  }
+</style>

package/dist/theme-default/src/components/Sidebar.astro

@@ -0,0 +1,101 @@
+---
+import Icon from "./Icon.astro";
+import { getResolvedSiteConfig } from "../lib/config";
+
+const groups = getResolvedSiteConfig(Astro.url.pathname).sidebar;
+const pathname = Astro.url.pathname;
+
+const normalizePath = (input: string) => {
+  if (!input || input === "/") {
+    return "/";
+  }
+
+  return input.endsWith("/") ? input.slice(0, -1) : input;
+};
+
+const currentPath = normalizePath(pathname);
+---
+
+<div class="sidebar">
+  {
+    groups.map((group) => (
+      <section class="sidebar-link-group">
+        <label class="sidebar-link-group-label">{group.label}</label>
+        <ul class="sidebar-link-list">
+          {group.items.map((item) => (
+            <li class="sidebar-link-item">
+              <a
+                href={item.link}
+                class="sidebar-link"
+                data-state={
+                  currentPath === normalizePath(item.link)
+                    ? "active"
+                    : "inactive"
+                }
+              >
+                <span>{item.label}</span>
+              </a>
+            </li>
+          ))}
+        </ul>
+      </section>
+    ))
+  }
+</div>
+
+<style is:global>
+  .sidebar {
+    position: sticky;
+    top: 5.5rem;
+  }
+
+  .sidebar-link-group {
+    font-size: 0.875rem;
+
+    .sidebar-link-group-icon {
+      width: 1.1rem;
+      height: 1.1rem;
+    }
+
+    .sidebar-link-group-label {
+      padding: 0.5rem;
+      font-weight: 700;
+    }
+  }
+
+  .sidebar-icon {
+    width: 0.9rem;
+    height: 0.9rem;
+  }
+
+  .sidebar-link-list {
+    list-style: none;
+    padding: 0.5rem;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+  }
+
+  .sidebar-link {
+    display: flex;
+    align-items: center;
+    gap: 0.45rem;
+    border-radius: 0.25rem;
+    padding: 0.45rem 0.75rem;
+
+    &[data-state="active"],
+    &:hover {
+      background: rgba(var(--accent-color) / 1);
+      color: rgba(var(--foreground-color) / 1);
+    }
+  }
+
+  @media (max-width: 900px) {
+    .sidebar {
+      position: static;
+      padding: 0 0 1.5rem;
+      border-bottom: 1px solid
+        color-mix(in srgb, rgba(var(--foreground-color) / 1) 12%, transparent);
+    }
+  }
+</style>

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

@@ -0,0 +1,195 @@
+---
+title: Configuration
+description: Configure navbar and sidebar
+---
+
+# Configuration
+
+Use `docs/config.json` to define the navigation structure.
+
+- `navbar`: top navigation items
+- `nav`: primary header links shown next to social links
+- `sidebar`: side navigation groups
+- `search`: local search options
+- `markdown`: markdown rendering options
+
+## Site URL
+
+Set `site.url` in `docs/config.json` to control canonical URLs and OG image URLs in generated HTML.
+
+```json
+{
+  "site": {
+    "url": "https://docs.example.com",
+    "title": "Stropress Docs",
+    "description": "Documentation site powered by stropress"
+  }
+}
+```
+
+If `site.url` is omitted, Stropress falls back to `http://localhost:4321` for local development.
+
+## Search
+
+Default search uses local MiniSearch indexing from your markdown content.
+
+You can keep the default behavior or set it explicitly in `docs/config.json`:
+
+```json
+{
+  "search": {
+    "provider": "local"
+  }
+}
+```
+
+## Code Block Theme
+
+Configure code block highlighting theme via `markdown.codeTheme` in `docs/config.json`.
+
+Use a single theme:
+
+```json
+{
+  "markdown": {
+    "codeTheme": "github-dark"
+  }
+}
+```
+
+Or define separate light/dark themes:
+
+```json
+{
+  "markdown": {
+    "codeTheme": {
+      "light": "github-light",
+      "dark": "github-dark"
+    }
+  }
+}
+```
+
+Common theme names (supported by Astro via Shiki, depending on your Astro/Shiki version):
+
+- `github-light`
+- `github-dark`
+- `one-dark-pro`
+- `dracula`
+- `nord`
+- `material-theme-darker`
+- `catppuccin-latte`
+- `catppuccin-frappe`
+- `catppuccin-macchiato`
+- `catppuccin-mocha`
+
+Example with One Dark + Catppuccin:
+
+```json
+{
+  "markdown": {
+    "codeTheme": {
+      "light": "catppuccin-latte",
+      "dark": "one-dark-pro"
+    }
+  }
+}
+```
+
+If a theme name is invalid for your current version, build/dev will report a theme loading error.
+
+## Bilingual Locales
+
+Stropress supports locale blocks inspired by VitePress.
+
+Define `locales` in `docs/config.json`, using path prefixes as keys:
+
+```json
+{
+  "locales": {
+    "/": {
+      "label": "English",
+      "lang": "en-US"
+    },
+    "/zh/": {
+      "label": "简体中文",
+      "lang": "zh-CN",
+      "site": {
+        "title": "Stropress 文档",
+        "description": "使用 Stropress 构建文档站点"
+      },
+      "nav": [
+        {
+          "label": "指南",
+          "link": "/zh/guide/getting-started"
+        }
+      ],
+      "sidebar": [
+        {
+          "label": "指南",
+          "items": [
+            {
+              "label": "快速开始",
+              "link": "/zh/guide/getting-started"
+            }
+          ]
+        }
+      ]
+    }
+  }
+}
+```
+
+Recommendations:
+
+- Put localized markdown under folders such as `docs/zh/...`.
+- Use locale-prefixed links in locale `nav`, `navbar`, and `sidebar`.
+- Add `docs/zh/index.md` to enable a clean `/zh/` landing route.
+
+## Custom Homepage
+
+If JSON-based `home` configuration is too limiting, you can add Astro homepage files next to `config.json`:
+
+```text
+docs/
+  config.json
+  index.astro
+  zh/
+    index.astro
+```
+
+- `docs/index.astro` overrides the root homepage `/`.
+- `docs/zh/index.astro` overrides the localized homepage `/zh/`.
+- If a matching `index.astro` exists, Stropress will prefer it over `home` or `locales[locale].home`.
+
+These files render inside the default docs layout. You can optionally export page metadata from Astro frontmatter:
+
+```astro
+---
+export const title = "Custom Home";
+export const description = "Landing page built with Astro";
+export const sidebar = false;
+---
+
+<section>
+  <h1>Custom homepage</h1>
+</section>
+```
+
+## Global Style Overrides
+
+You can add a root-level stylesheet at `docs/index.css` to override the default theme styles globally.
+
+This file is loaded after the built-in theme CSS, so it can be used to override `:root` variables and any selectors used by the theme.
+
+```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/guide/getting-started.md

@@ -0,0 +1,98 @@
+---
+title: Getting Started
+description: Start your documentation site
+---
+
+# Getting Started
+
+Your markdown files under `docs/` will be rendered into HTML pages.
+
+
+
+## Codeblock
+
+```typescript
+console.log("hello word")
+```
+
+
+> This is a quote
+
+
+
+- This is a list
+- This is a list
+
+
+## TODO LIST
+
+- [ ] todo1
+- [x] todo2
+
+
+This is a [Link](https://xuco.me)
+
+| 配置项       | 必填 | 说明                           | 建议                                   |
+| :----------- | :--: | :----------------------------- | :------------------------------------- |
+| **名称**     |  是  | API Key 的标识名称             | 设置为项目名或用途，如 `Chat-Bot-Prod` |
+| **模型**     |  是  | 选择该 Key 支持调用的模型范围  | **注意**：未勾选的模型将无法发起请求   |
+| **请求上限** |  否  | 设置单次或周期内的请求次数限制 | 用于防止程序异常导致的消耗过快         |
+| **额度**     |  否  | 设置该 Key 可使用的最高额度    | 建议根据项目预算分配独立额度           |
+| **过期时间** |  否  | 设置 Key 的有效期限            | 临时测试建议设置有效期，长期项目可留空 |
+
+> [!IMPORTANT]
+> **关于密钥可见性**
+> 为了保障您的账户安全，所有 API Key 在数据库中均经过**加密处理**。
+>
+> - **仅限创建时查看**：API Key 仅在点击“完成创建”后的弹出窗口中完整显示**一次**。
+> - **后续不可找回**：一旦关闭弹窗，您将无法再次在控制台查看到完整的 Key 内容。
+> - **若丢失怎么办**：如果您遗失了该 Key，将无法找回，必须通过「删除旧 Key 并重新创建」的方式来获取新的密钥。
+
+
+> [!TIP]
+> **遇到 404 错误？**
+> 若页面提示「错误 404」，通常是由于登录状态刷新延迟。请点击页面中的 **「返回控制台」** 按钮，或从侧边导航栏重新进入即可。
+
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+
+## H2
+
+### H3
+
+#### H4
+
+##### H5
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+```typescript
+console.log("hello word")
+```
+
+![Test Image](https://www.xuco.me/images/rag-example/rag-workflow.png)