create-komorebi 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# create-komorebi
+
+## 用法
+
+```bash
+npm create komorebi@latest
+```

package/dist/cli.js

@@ -0,0 +1,414 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import prompts from "prompts";
+const TEMPLATE_TEXT_FILES = [
+    ".gitignore",
+    "README.md",
+    "package.json",
+    "astro.config.ts",
+    "tsconfig.json",
+    "src/content.config.ts",
+    "src/content/about.md",
+    "src/content/blog/hello-world.md",
+];
+const ASCII_LOGO = [
+    "  _  __                              _     _ ",
+    " | |/ /___  _ __ ___   ___  _ __ ___| |__ (_)",
+    " | ' // _ \\| '_ ` _ \\ / _ \\| '__/ _ \\ '_ \\| |",
+    " | . \\ (_) | | | | | | (_) | | |  __/ |_) | |",
+    " |_|\\_\\___/|_| |_| |_|\\___/|_|  \\___|_.__/|_|",
+];
+const HELP_TEXT = `create-komorebi
+
+用法：
+  npm create komorebi@latest`;
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(scriptDir, "..");
+const templateDir = resolve(packageRoot, "template");
+await main();
+async function main() {
+    validateArgs(process.argv.slice(2));
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        fail("当前版本需要在交互式终端中运行，请直接在终端执行 `npm create komorebi@latest`。");
+    }
+    const packageManager = detectPackageManager();
+    printBanner(packageManager);
+    const answers = await promptProjectAnswers(packageManager);
+    const targetDir = resolve(process.cwd(), answers.projectDir);
+    const projectName = normalizeProjectName(basename(targetDir));
+    const shouldInstall = answers.installMode === "install";
+    const createdDate = formatCurrentDate();
+    printSummary({
+        packageManager,
+        shouldInstall,
+        siteTitle: answers.siteTitle,
+        siteUrl: answers.siteUrl,
+        targetDir,
+    });
+    printStep("写入模板");
+    copyTemplate(templateDir, targetDir);
+    const replacements = {
+        ...getReadmeCommandReplacements(packageManager),
+        "__PROJECT_NAME__": projectName,
+        "__SITE_TITLE__": answers.siteTitle,
+        "__SITE_TITLE_JSON__": JSON.stringify(answers.siteTitle),
+        "__SITE_URL_BLOCK__": answers.siteUrl
+            ? `\n  site: ${JSON.stringify(answers.siteUrl)},`
+            : "",
+        "__CONTENT_DATE__": createdDate,
+        "__ABOUT_TITLE_YAML__": JSON.stringify(`关于 ${answers.siteTitle}`),
+        "__ABOUT_DESCRIPTION_YAML__": JSON.stringify(`${answers.siteTitle} 的关于页面。`),
+        "__HELLO_DESCRIPTION_YAML__": JSON.stringify(`${answers.siteTitle} 的第一篇文章。`),
+    };
+    for (const relativePath of TEMPLATE_TEXT_FILES) {
+        const filePath = join(targetDir, relativePath);
+        const content = readFileSync(filePath, "utf-8");
+        writeFileSync(filePath, applyReplacements(content, replacements), "utf-8");
+    }
+    let installSucceeded = false;
+    if (shouldInstall) {
+        installSucceeded = installDependencies(targetDir, packageManager);
+    }
+    printSuccess({
+        packageManager,
+        shouldInstall,
+        installSucceeded,
+        targetDir,
+    });
+}
+function validateArgs(argv) {
+    const args = argv.filter((arg) => arg !== "--");
+    if (args.length === 0) {
+        return;
+    }
+    if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+        console.log(HELP_TEXT);
+        process.exit(0);
+    }
+    fail("请直接运行 `npm create komorebi@latest`。");
+}
+function printBanner(packageManager) {
+    console.log("");
+    for (const line of ASCII_LOGO) {
+        console.log(pc.cyan(line));
+    }
+    console.log(pc.dim("  create-komorebi · 木漏れ日 Astro 博客初始化"));
+    console.log(pc.dim(`  ${packageManager} · astro@^5`));
+    console.log("");
+}
+async function promptProjectAnswers(packageManager) {
+    const answers = await prompts([
+        {
+            type: "text",
+            name: "projectDir",
+            message: "项目目录",
+            validate: validateProjectDir,
+            format: (value) => value.trim(),
+        },
+        {
+            type: "text",
+            name: "siteTitle",
+            message: "博客标题",
+            validate: validateSiteTitle,
+            format: (value) => value.trim(),
+        },
+        {
+            type: "text",
+            name: "siteUrl",
+            message: "站点地址（可留空）",
+            validate: validateSiteUrl,
+            format: formatSiteUrl,
+        },
+        {
+            type: "select",
+            name: "installMode",
+            message: `依赖安装（${packageManager}）`,
+            hint: "使用方向键选择，回车确认",
+            initial: 0,
+            choices: [
+                {
+                    title: "立即安装",
+                    description: "安装 astro@^5、komorebi-theme、@astrojs/check、typescript",
+                    value: "install",
+                },
+                {
+                    title: "仅生成文件",
+                    description: "稍后手动安装依赖",
+                    value: "skip",
+                },
+            ],
+        },
+    ], {
+        onCancel: () => cancel(),
+    });
+    return answers;
+}
+function validateProjectDir(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return "请输入项目目录";
+    }
+    const targetDir = resolve(process.cwd(), trimmed);
+    if (existsSync(targetDir) && !isEffectivelyEmpty(targetDir)) {
+        return "目录已存在且不为空";
+    }
+    return true;
+}
+function validateSiteTitle(value) {
+    if (!value.trim()) {
+        return "请输入博客标题";
+    }
+    return true;
+}
+function validateSiteUrl(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return true;
+    }
+    try {
+        normalizeSiteUrl(trimmed);
+        return true;
+    }
+    catch (error) {
+        return getErrorMessage(error);
+    }
+}
+function formatSiteUrl(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    return normalizeSiteUrl(trimmed);
+}
+function isEffectivelyEmpty(dir) {
+    return readdirSync(dir).every((entry) => entry === ".git" || entry === ".DS_Store");
+}
+function copyTemplate(sourceDir, targetDir) {
+    mkdirSync(targetDir, { recursive: true });
+    for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+        cpSync(join(sourceDir, entry.name), join(targetDir, entry.name), {
+            recursive: entry.isDirectory(),
+        });
+    }
+}
+function normalizeProjectName(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized || "komorebi-site";
+}
+function normalizeSiteUrl(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error(`站点地址无效：${value}`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`站点地址必须以 http:// 或 https:// 开头：${value}`);
+    }
+    return parsed.toString().replace(/\/$/, "");
+}
+function formatCurrentDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+function applyReplacements(content, replacements) {
+    let output = content;
+    for (const [token, value] of Object.entries(replacements)) {
+        output = output.replaceAll(token, value);
+    }
+    return output;
+}
+function detectPackageManager() {
+    const userAgent = process.env.npm_config_user_agent ?? "";
+    if (userAgent.startsWith("pnpm")) {
+        return "pnpm";
+    }
+    if (userAgent.startsWith("yarn")) {
+        return "yarn";
+    }
+    if (userAgent.startsWith("bun")) {
+        return "bun";
+    }
+    return "npm";
+}
+function installDependencies(targetDir, packageManager) {
+    const commands = getInstallCommands(packageManager);
+    printStep("安装运行依赖");
+    const runtimeInstalled = runCommand(packageManager, commands.runtime, targetDir);
+    if (!runtimeInstalled) {
+        console.log("");
+        console.log(pc.yellow("安装中断，项目文件已创建。"));
+        console.log("");
+        return false;
+    }
+    printStep("安装开发依赖");
+    const devInstalled = runCommand(packageManager, commands.dev, targetDir);
+    if (!devInstalled) {
+        console.log("");
+        console.log(pc.yellow("安装中断，项目文件已创建。"));
+        console.log("");
+        return false;
+    }
+    return true;
+}
+function getInstallCommands(packageManager) {
+    if (packageManager === "pnpm") {
+        return {
+            runtime: ["add", "astro@^5", "komorebi-theme"],
+            dev: ["add", "-D", "@astrojs/check", "typescript"],
+        };
+    }
+    if (packageManager === "yarn") {
+        return {
+            runtime: ["add", "astro@^5", "komorebi-theme"],
+            dev: ["add", "-D", "@astrojs/check", "typescript"],
+        };
+    }
+    if (packageManager === "bun") {
+        return {
+            runtime: ["add", "astro@^5", "komorebi-theme"],
+            dev: ["add", "-d", "@astrojs/check", "typescript"],
+        };
+    }
+    return {
+        runtime: ["install", "astro@^5", "komorebi-theme"],
+        dev: ["install", "-D", "@astrojs/check", "typescript"],
+    };
+}
+function runCommand(command, args, cwd) {
+    const result = spawnSync(command, args, {
+        cwd,
+        stdio: "inherit",
+    });
+    if (result.error) {
+        console.log(getErrorMessage(result.error));
+        return false;
+    }
+    return result.status === 0;
+}
+function printSuccess(options) {
+    const relativeTarget = formatTargetDir(options.targetDir);
+    const devCommand = getDevCommand(options.packageManager);
+    const installCommands = getManualInstallHints(options.packageManager);
+    console.log(pc.green(pc.bold("◆ 创建完成")));
+    console.log(pc.dim(`  ${relativeTarget}`));
+    console.log("");
+    console.log(pc.bold("下一步"));
+    if (relativeTarget !== ".") {
+        console.log(`  cd ${relativeTarget}`);
+    }
+    if (!options.shouldInstall || !options.installSucceeded) {
+        console.log(`  ${installCommands.runtime}`);
+        console.log(`  ${installCommands.dev}`);
+    }
+    console.log(`  ${devCommand}`);
+    console.log("");
+}
+function getManualInstallHints(packageManager) {
+    if (packageManager === "pnpm") {
+        return {
+            runtime: "pnpm add astro@^5 komorebi-theme",
+            dev: "pnpm add -D @astrojs/check typescript",
+        };
+    }
+    if (packageManager === "yarn") {
+        return {
+            runtime: "yarn add astro@^5 komorebi-theme",
+            dev: "yarn add -D @astrojs/check typescript",
+        };
+    }
+    if (packageManager === "bun") {
+        return {
+            runtime: "bun add astro@^5 komorebi-theme",
+            dev: "bun add -d @astrojs/check typescript",
+        };
+    }
+    return {
+        runtime: "npm install astro@^5 komorebi-theme",
+        dev: "npm install -D @astrojs/check typescript",
+    };
+}
+function getDevCommand(packageManager) {
+    if (packageManager === "pnpm" || packageManager === "yarn") {
+        return `${packageManager} dev`;
+    }
+    if (packageManager === "bun") {
+        return "bun run dev";
+    }
+    return "npm run dev";
+}
+function getReadmeCommandReplacements(packageManager) {
+    const installCommands = getManualInstallHints(packageManager);
+    return {
+        "__INSTALL_RUNTIME_COMMAND__": installCommands.runtime,
+        "__INSTALL_DEV_COMMAND__": installCommands.dev,
+        "__DEV_COMMAND__": getDevCommand(packageManager),
+    };
+}
+function printSummary(options) {
+    const rows = [
+        ["目录", formatTargetDir(options.targetDir)],
+        ["标题", options.siteTitle],
+        ["站点", options.siteUrl ?? "未设置"],
+        [
+            "安装",
+            options.shouldInstall
+                ? `立即安装（${options.packageManager}）`
+                : "仅生成文件",
+        ],
+    ];
+    console.log(pc.cyan("┌  配置"));
+    for (const [label, value] of rows) {
+        console.log(`${pc.cyan("│")}  ${pc.dim(label)}  ${value}`);
+    }
+    console.log(pc.cyan("└"));
+    console.log("");
+}
+function printStep(label) {
+    console.log(pc.cyan(`◆ ${label}`));
+    console.log("");
+}
+function relativeFromCwd(targetDir) {
+    const relativeTarget = relative(process.cwd(), targetDir);
+    if (!relativeTarget) {
+        return ".";
+    }
+    return relativeTarget;
+}
+function formatTargetDir(targetDir) {
+    const relativeTarget = relativeFromCwd(targetDir);
+    if (relativeTarget === ".") {
+        return ".";
+    }
+    if (relativeTarget.startsWith("..")) {
+        return targetDir;
+    }
+    return relativeTarget;
+}
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function cancel() {
+    console.log("");
+    console.log(pc.yellow("已取消"));
+    console.log("");
+    process.exit(0);
+}
+function fail(message) {
+    console.error("");
+    console.error(pc.red(message));
+    console.error("");
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-komorebi",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-komorebi": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build"
+  },
+  "files": [
+    "dist",
+    "template",
+    "README.md"
+  ],
+  "keywords": [
+    "astro",
+    "blog",
+    "create",
+    "komorebi",
+    "starter"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=18.20.8"
+  }
+}

package/template/README.md

@@ -0,0 +1,15 @@
+# __SITE_TITLE__
+
+## 开发
+
+```bash
+__INSTALL_RUNTIME_COMMAND__
+__INSTALL_DEV_COMMAND__
+__DEV_COMMAND__
+```
+
+## 内容入口
+
+- 编辑 `src/content/blog/*.md` 发布文章
+- 编辑 `src/content/about.md` 更新关于页
+- 编辑 `astro.config.ts` 修改站点标题与地址

package/template/astro.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from "astro/config";
+import komorebi from "komorebi-theme";
+
+export default defineConfig({__SITE_URL_BLOCK__
+  integrations: [
+    komorebi({
+      title: __SITE_TITLE_JSON__,
+    }),
+  ],
+});

package/template/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "__PROJECT_NAME__",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "check": "astro check",
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview"
+  }
+}

package/template/public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

package/template/src/content/about.md

@@ -0,0 +1,9 @@
+---
+title: __ABOUT_TITLE_YAML__
+description: __ABOUT_DESCRIPTION_YAML__
+pubDate: __CONTENT_DATE__
+---
+
+欢迎来到 __SITE_TITLE__。
+
+这里适合记录想法、经验，以及那些值得慢慢回看的内容。

package/template/src/content/blog/hello-world.md

@@ -0,0 +1,9 @@
+---
+title: 你好，世界
+description: __HELLO_DESCRIPTION_YAML__
+pubDate: __CONTENT_DATE__
+---
+
+你好，世界。
+
+这是 `komorebi-theme` 为你准备的第一篇文章。接下来，就开始写作吧。

package/template/src/content.config.ts

@@ -0,0 +1,7 @@
+import { defineCollection } from "astro:content";
+import { blogConfig, specialConfig } from "komorebi-theme/collections";
+
+export const collections = {
+  blog: defineCollection(blogConfig()),
+  special: defineCollection(specialConfig()),
+};

package/template/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strictest",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}