@xingwangzhe/stalux 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 王兴家 (Xingwangzhe)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+[中文文档](./README_CN.md) | English
+
+[![CI](https://github.com/xingwangzhe/stalux/actions/workflows/ci.yml/badge.svg?branch=newMain)](https://github.com/xingwangzhe/stalux/actions/workflows/ci.yml)
+
+# Stalux — Modern Astro Blog Theme
+
+**Dual-mode: Use as a template 📦 or install as a plugin 🔌**
+
+**[stalux.needhelp.icu](https://stalux.needhelp.icu)**
+
+Elegant, high-performance, easily configurable Astro static blog theme.
+
+In terms of design, Stalux draws on minimalism and moderate decoration: it maintains an overall dark tone with subtle glassmorphism textures, and the background uses tiled decorative patterns to enhance visual depth without being distracting.
+
+In terms of experience, Stalux balances SSG's high performance with the smooth feel of page transitions without full reloads. Through view transitions and handling of `astro:page-load` events, the theme keeps the header, footer, and other common components stable during navigation or main content switching.
+
+Content-first is one of the theme's core principles: writing and presentation are considered top priority. The theme supports CommonMark, code highlighting, Mermaid flowcharts, and KaTeX math formulas out of the box.
+
+---
+
+## 🚀 Two Ways to Use
+
+### Option A: Clone Source Code (Template Mode)
+
+Get the full source — modify anything, customize everything:
+
+```bash
+git clone https://github.com/xingwangzhe/stalux.git my-blog
+cd my-blog
+bun install           # or npm install
+bun run dev           # or npm run dev
+```
+
+### Option B: Install as Astro Integration (Plugin Mode)
+
+Keep your project clean — install stalux as a dependency:
+
+```bash
+npm install @xingwangzhe/stalux
+```
+
+Then initialize the content template:
+
+```bash
+npx @xingwangzhe/stalux init
+# or: npm run init
+```
+
+This creates the `stalux/` directory structure with example content in your project. Then add to `astro.config.mjs`:
+
+```ts
+import { defineConfig } from "astro/config";
+import stalux from "@xingwangzhe/stalux";
+
+export default defineConfig({
+  integrations: [stalux({
+    contentDir: "./content",     // customize content directory (default: "stalux")
+    components: {                // optional: override theme components
+      // Navs: "./src/CustomNavs.astro",
+    },
+  })],
+});
+```
+
+Create `src/content.config.ts`:
+
+```ts
+import { defineCollections } from "stalux/schemas";
+export const collections = defineCollections({ contentDir: "./content" });
+```
+
+Then write your content in `./content/posts/`, `./content/config/`, etc.
+
+---
+
+## 📝 Quick Start: Writing Content
+
+Create a markdown file under `stalux/posts/`:
+
+```yaml
+---
+title: Hello World
+abbrlink: hello-world
+date: 2026-07-27 10:00:00
+tags: [Stalux, Getting Started]
+categories: [Blog]
+desc: A brief description of your post.
+---
+Your content here...
+```
+
+**Content Directory Structure:**
+
+```
+stalux/
+├── config/              # YAML configuration files
+│   ├── site.yml         # Site metadata
+│   ├── author.yml       # Author info
+│   ├── navs.yml         # Navigation menu
+│   ├── footer.yml       # Footer badges & copyright
+│   ├── links.yml        # Friend links
+│   ├── comment.yml      # Waline comment config
+│   ├── head.yml         # Analytics & custom head
+│   ├── media-links.yml  # Social media links
+│   ├── promote.yml      # LLM promotion & export
+│   ├── ai-discovery.yml # AI discovery file config
+│   └── typetexts.yml    # Typewriter text snippets
+├── posts/               # Blog posts (Markdown)
+├── about/index.md       # About page
+└── words/               # Quotes / short notes (Markdown)
+```
+
+---
+
+## ✨ Features
+
+- 🌙 **Dark mode** as default, with elegant glassmorphism design
+- 🔍 **Full-text search** via Pagefind (auto-indexed on build)
+- 📡 **RSS & Atom feeds**
+- 🖼️ **PhotoSwipe** image lightbox
+- 📊 **Mermaid** diagrams & flowcharts
+- 📐 **KaTeX / MathML** math rendering
+- 🤖 **LLM discovery files** (llms.txt / llms-full.txt)
+- 💬 **Waline** comment system
+- 📱 **Fully responsive**
+- ⚡ **View transitions** for smooth navigation
+- 🏷️ **Tags, categories, archives**
+- 🌐 **i18n** (zh-CN / en)
+
+---
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+bun install           # recommended
+# npm install
+
+# Start dev server
+bun run dev
+
+# Build
+bun run build
+
+# Preview
+bun run preview
+```
+
+---
+
+## 🎨 Customizing Components
+
+Stalux supports component overrides (like Starlight):
+
+```ts
+import { defineConfig } from "astro/config";
+import stalux from "@xingwangzhe/stalux";
+
+export default defineConfig({
+  integrations: [stalux({
+    components: {
+      Navs: "./src/components/CustomNavs.astro",
+      Footer: "./src/components/CustomFooter.astro",
+      // ... see full list in src/internal/override.ts
+    }
+  })],
+});
+```
+
+Use the `@stalux/component/*` import alias in your custom components:
+
+```astro
+---
+import Navs from "@stalux/component/Navs";
+---
+<Navs />
+```
+
+---
+
+## 📖 Documentation
+
+Full documentation and live demo: **[stalux.needhelp.icu](https://stalux.needhelp.icu)**
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](./LICENSE).
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/xingwangzhe/stalux)
+[![Deploy with EdgeOne Pages](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https://github.com/xingwangzhe/stalux)

package/package.json

@@ -0,0 +1,108 @@
+{
+    "name": "@xingwangzhe/stalux",
+    "version": "1.2.0",
+    "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
+    "type": "module",
+    "license": "MIT",
+    "author": "xingwangzhe",
+    "homepage": "https://stalux.needhelp.icu",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/xingwangzhe/stalux.git"
+    },
+    "bugs": "https://github.com/xingwangzhe/stalux/issues",
+    "keywords": [
+        "astro",
+        "astro-theme",
+        "astro-integration",
+        "blog",
+        "blog-theme",
+        "stalux",
+        "static-site"
+    ],
+    "files": [
+        "src/index.ts",
+        "src/config.ts",
+        "src/components/**/*.astro",
+        "src/components/**/*.ts",
+        "src/layouts/**/*.astro",
+        "src/pages/**/*.astro",
+        "src/pages/**/*.ts",
+        "src/styles/**/*.css",
+        "src/utils/**/*.ts",
+        "src/i18n/**/*.json",
+        "src/schemas/**/*.ts",
+        "src/plugins/**/*.ts",
+        "src/internal/**/*.ts",
+        "src/scripts/**/*.ts",
+        "src/assets/**/*",
+        "scripts/cli.mjs",
+        "template/**/*",
+        "!src/content.config.ts"
+    ],
+    "exports": {
+        ".": "./src/index.ts",
+        "./config": "./src/config.ts",
+        "./schemas": "./src/schemas/config.ts",
+        "./components/*": "./src/components/*",
+        "./layouts/*": "./src/layouts/*",
+        "./pages/*": "./src/pages/*",
+        "./styles/*": "./src/styles/*",
+        "./utils/*": "./src/utils/*",
+        "./i18n/*": "./src/i18n/*",
+        "./plugins/*": "./src/plugins/*",
+        "./internal/*": "./src/internal/*",
+        "./scripts/*": "./src/scripts/*",
+        "./assets/*": "./src/assets/*",
+        "./package.json": "./package.json"
+    },
+    "bin": {
+        "stalux": "scripts/cli.mjs"
+    },
+    "scripts": {
+        "dev": "astro dev ",
+        "prebuild": "bun run scripts/font-subset.ts",
+        "build": "astro build ",
+        "preview": "astro preview ",
+        "astro": "astro",
+        "init": "node scripts/cli.mjs init",
+        "fmt": "oxfmt",
+        "fmt:check": "oxfmt --check",
+        "lint": "oxlint",
+        "lint:fix": "oxlint --fix",
+        "prepare": "git config core.hooksPath scripts/git-hooks"
+    },
+    "dependencies": {
+        "@expressive-code/plugin-line-numbers": "^0.44.1",
+        "@pagefind/component-ui": "^1.5.2",
+        "@waline/client": "3.15.2",
+        "@xingwangzhe/tags-cloud": "^1.2.4",
+        "animejs": "^4.5.0",
+        "astro": "^7.1.3",
+        "pagefind": "^1.5.2",
+        "photoswipe": "^5.4.4"
+    },
+    "peerDependencies": {
+        "astro": "^7.0.0"
+    },
+    "devDependencies": {
+        "@astrojs/rss": "^4.0.19",
+        "@astrojs/sitemap": "^3.7.3",
+        "@lucide/astro": "^1.27.0",
+        "@types/node": "^26.1.1",
+        "@xingwangzhe/satteri-mermaid": "0.7.1",
+        "@xingwangzhe/satteri-photoswipe": "^0.2.0",
+        "astro-expressive-code": "^0.44.1",
+        "astro-seo": "^1.1.0",
+        "astro-typewriter": "^1.2.0",
+        "badge-maker": "^6.0.0",
+        "knip": "^6.29.0",
+        "license-checker-rseidelsohn": "5.0.1",
+        "oxfmt": "^0.60.0",
+        "oxlint": "^1.75.0",
+        "simple-icons": "^16.27.1",
+        "subset-font": "^2.5.0",
+        "temml": "^0.13.3",
+        "typescript": "^7.0.2"
+    }
+}

package/scripts/cli.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+/**
+ * Stalux CLI — 主题初始化工具
+ *
+ * 用法：
+ *   npx stalux init          # 在当前目录初始化内容模板
+ *   npx stalux init my-blog  # 在子目录初始化项目
+ *   npm run init              # 或通过 npm script
+ */
+
+import { existsSync, mkdirSync, cpSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = resolve(__dirname, "..");
+const TEMPLATE_DIR = join(PACKAGE_ROOT, "template");
+
+function copyDir(src, dest, overwrite = false) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    if (entry === "node_modules") continue;
+
+    if (statSync(srcPath).isDirectory()) {
+      copyDir(srcPath, destPath, overwrite);
+    } else {
+      if (!overwrite && existsSync(destPath)) {
+        console.log(`  ⏭  ${entry} (already exists, skipped)`);
+        continue;
+      }
+      cpSync(srcPath, destPath);
+      console.log(`  ✅  ${entry}`);
+    }
+  }
+}
+
+function printHelp() {
+  console.log(`
+  Stalux — Modern Astro Blog Theme
+
+  Usage:
+    stalux init [dir]     Initialize Stalux content template
+    stalux --help         Show this help message
+
+  Examples:
+    npx stalux init              Init content in current directory
+    npx stalux init my-blog      Init content in ./my-blog
+    npm run init                 Init via npm script (after install)
+
+  Source code:
+    git clone https://github.com/xingwangzhe/stalux.git
+`);
+}
+
+function printNextSteps(targetDir) {
+  console.log("");
+  console.log("  📝  Next Steps:");
+  console.log("");
+  console.log(`    1. cd ${targetDir}`);
+  console.log(`    2. npm install stalux`);
+  console.log(`    3. Edit astro.config.mjs to add stalux()`);
+  console.log(`    4. Start writing content in ${targetDir}/stalux/posts/`);
+  console.log(`    5. npm run dev`);
+  console.log("");
+  console.log("  📖  Docs: https://stalux.needhelp.icu");
+  console.log("");
+}
+
+// ---- Main ----
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (!command || command === "--help" || command === "-h") {
+  printHelp();
+  process.exit(0);
+}
+
+if (command === "init") {
+  const targetArg = args[1] || ".";
+  const targetPath = resolve(process.cwd(), targetArg);
+
+  if (!existsSync(TEMPLATE_DIR)) {
+    console.error("❌ Template directory not found. Ensure stalux package is properly installed.");
+    process.exit(1);
+  }
+
+  console.log(`📦 Initializing Stalux content template...`);
+  console.log(`📂 Target: ${targetPath}`);
+  console.log("");
+
+  copyDir(TEMPLATE_DIR, targetPath, false);
+
+  printNextSteps(targetArg);
+  process.exit(0);
+}
+
+// Unknown command
+console.error(`❌ Unknown command: ${command}`);
+console.error(`   Use "stalux init" to initialize Stalux content.`);
+process.exit(1);

package/src/assets/BiCcCircle.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 16 16"><path fill="#cccccc" d="M1 8a7 7 0 1 0 14 0A7 7 0 0 0 1 8m15 0A8 8 0 1 1 0 8a8 8 0 0 1 16 0M5.408 5.89c-.83 0-1.318.64-1.318 1.753v.742c0 1.108.479 1.727 1.318 1.727c.69 0 1.138-.435 1.187-1.05h1.147v.114c-.058 1.147-1.029 1.938-2.343 1.938c-1.612 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75c1.319 0 2.29.812 2.343 1.999v.11H6.595c-.049-.638-.506-1.108-1.187-1.108Zm5.404 0c-.831 0-1.319.64-1.319 1.753v.742c0 1.108.48 1.727 1.319 1.727c.69 0 1.138-.435 1.186-1.05h1.147v.114c-.057 1.147-1.028 1.938-2.342 1.938c-1.613 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75c1.318 0 2.29.812 2.342 1.999v.11h-1.147c-.048-.638-.505-1.108-1.186-1.108Z"/></svg>

package/src/assets/astro.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" width="115" height="48"><path fill="#17191E" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="url(#a)" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="#17191E" d="M.02 30.31s4.02-1.95 8.05-1.95l3.04-9.4c.11-.45.44-.76.82-.76.37 0 .7.31.82.76l3.04 9.4c4.77 0 8.05 1.95 8.05 1.95L17 11.71c-.2-.56-.53-.91-.98-.91H7.83c-.44 0-.76.35-.97.9L.02 30.31Zm42.37-5.97c0 1.64-2.05 2.62-4.88 2.62-1.85 0-2.5-.45-2.5-1.41 0-1 .8-1.49 2.65-1.49 1.67 0 3.09.03 4.73.23v.05Zm.03-2.04a21.37 21.37 0 0 0-4.37-.36c-5.32 0-7.82 1.25-7.82 4.18 0 3.04 1.71 4.2 5.68 4.2 3.35 0 5.63-.84 6.46-2.92h.14c-.03.5-.05 1-.05 1.4 0 1.07.18 1.16 1.06 1.16h4.15a16.9 16.9 0 0 1-.36-4c0-1.67.06-2.93.06-4.62 0-3.45-2.07-5.64-8.56-5.64-2.8 0-5.9.48-8.26 1.19.22.93.54 2.83.7 4.06 2.04-.96 4.95-1.37 7.2-1.37 3.11 0 3.97.71 3.97 2.15v.57Zm11.37 3c-.56.07-1.33.07-2.12.07-.83 0-1.6-.03-2.12-.1l-.02.58c0 2.85 1.87 4.52 8.45 4.52 6.2 0 8.2-1.64 8.2-4.55 0-2.74-1.33-4.09-7.2-4.39-4.58-.2-4.99-.7-4.99-1.28 0-.66.59-1 3.65-1 3.18 0 4.03.43 4.03 1.35v.2a46.13 46.13 0 0 1 4.24.03l.02-.55c0-3.36-2.8-4.46-8.2-4.46-6.08 0-8.13 1.49-8.13 4.39 0 2.6 1.64 4.23 7.48 4.48 4.3.14 4.77.62 4.77 1.28 0 .7-.7 1.03-3.71 1.03-3.47 0-4.35-.48-4.35-1.47v-.13Zm19.82-12.05a17.5 17.5 0 0 1-6.24 3.48c.03.84.03 2.4.03 3.24l1.5.02c-.02 1.63-.04 3.6-.04 4.9 0 3.04 1.6 5.32 6.58 5.32 2.1 0 3.5-.23 5.23-.6a43.77 43.77 0 0 1-.46-4.13c-1.03.34-2.34.53-3.78.53-2 0-2.82-.55-2.82-2.13 0-1.37 0-2.65.03-3.84 2.57.02 5.13.07 6.64.11-.02-1.18.03-2.9.1-4.04-2.2.04-4.65.07-6.68.07l.07-2.93h-.16Zm13.46 6.04a767.33 767.33 0 0 1 .07-3.18H82.6c.07 1.96.07 3.98.07 6.92 0 2.95-.03 4.99-.07 6.93h5.18c-.09-1.37-.11-3.68-.11-5.65 0-3.1 1.26-4 4.12-4 1.33 0 2.28.16 3.1.46.03-1.16.26-3.43.4-4.43-.86-.25-1.81-.41-2.96-.41-2.46-.03-4.26.98-5.1 3.38l-.17-.02Zm22.55 3.65c0 2.5-1.8 3.66-4.64 3.66-2.81 0-4.61-1.1-4.61-3.66s1.82-3.52 4.61-3.52c2.82 0 4.64 1.03 4.64 3.52Zm4.71-.11c0-4.96-3.87-7.18-9.35-7.18-5.5 0-9.23 2.22-9.23 7.18 0 4.94 3.49 7.59 9.21 7.59 5.77 0 9.37-2.65 9.37-7.6Z"/><defs><linearGradient id="a" x1="6.33" x2="19.43" y1="40.8" y2="34.6" gradientUnits="userSpaceOnUse"><stop stop-color="#D83333"/><stop offset="1" stop-color="#F041FF"/></linearGradient></defs></svg>

package/src/assets/background/README.md

@@ -0,0 +1,3 @@
+# Patterns
+
+clone from https://github.com/NeuroNexul/telegram-patterns.git