create-zeropress-theme 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# create-zeropress-theme
+
+ZeroPress 테마 프로젝트를 생성하는 scaffolding CLI입니다.
+
+## Quick Start
+
+```bash
+npx create-zeropress-theme my-theme
+```
+
+## Usage
+
+```bash
+npx create-zeropress-theme <name> [options]
+```
+
+### Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--template <name>` | 템플릿 선택 (`minimal`, `blog`, `magazine`) | `minimal` |
+| `--with-devtools` | 개발 편의 `package.json` 포함 | - |
+
+### Examples
+
+```bash
+# 기본 테마 생성
+npx create-zeropress-theme my-theme
+
+# 템플릿 지정
+npx create-zeropress-theme my-theme --template blog
+
+# devtools 포함
+npx create-zeropress-theme my-theme --with-devtools
+```
+
+> 현재 v0.1에서는 모든 템플릿이 동일한 starter 구조를 생성합니다. 향후 버전에서 차등 제공 예정입니다.
+
+## 생성되는 구조
+
+```
+my-theme/
+  theme.json
+  layout.html
+  index.html
+  post.html
+  page.html
+  archive.html
+  category.html
+  tag.html
+  404.html
+  partials/
+    header.html
+    footer.html
+  assets/
+    style.css
+```
+
+## --with-devtools
+
+`--with-devtools` 옵션을 사용하면 테마 폴더에 `package.json`이 추가됩니다.
+
+```bash
+npx create-zeropress-theme my-theme --with-devtools
+cd my-theme
+npm run dev       # 프리뷰 서버
+npm run validate  # 테마 검증
+npm run pack      # zip 패키징
+```
+
+내부적으로 `zeropress-theme` CLI를 호출하는 thin wrapper이며, 별도 의존성이나 lockfile은 생성하지 않습니다. 테마 런타임 스펙 자체를 변경하지 않으므로 업로드 패키지는 순수 테마 파일 기준으로 검증됩니다.
+
+## Requirements
+
+- Node.js >= 18.18.0
+- ESM only
+
+## Related
+
+- [zeropress-theme](https://www.npmjs.com/package/zeropress-theme) — 테마 개발/검증/패키징 toolkit
+- [ZeroPress Theme Spec](https://github.com/user/zeropress/blob/main/theme_guide_v2/THEME_SPEC.md)
+
+## License
+
+MIT

package/bin/create-zeropress-theme.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { run } from '../src/index.js';
+
+run(process.argv.slice(2)).catch((error) => {
+  console.error(`[create-zeropress-theme] ${error.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "create-zeropress-theme",
+  "version": "0.1.0",
+  "description": "ZeroPress theme scaffolding CLI",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "create-zeropress-theme": "./bin/create-zeropress-theme.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "engines": {
+    "node": ">=18.18.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,188 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const TEMPLATES = new Set(['minimal', 'blog', 'magazine']);
+
+export async function run(argv) {
+  const { name, template, withDevtools } = parseArgs(argv);
+  const targetDir = path.resolve(process.cwd(), name);
+
+  await ensureEmptyDirectory(targetDir);
+  await scaffoldTheme(targetDir, name);
+
+  if (withDevtools) {
+    await writeDevtoolsPackageJson(targetDir);
+  }
+
+  console.log(`Created ZeroPress theme at ${targetDir}`);
+  console.log(`Template: ${template} (current v0.1 behavior uses same starter files for all templates)`);
+  if (withDevtools) {
+    console.log('Devtools enabled: npm run dev / npm run validate / npm run pack');
+  }
+}
+
+function parseArgs(argv) {
+  if (argv.length === 0) {
+    throw new Error('Usage: create-zeropress-theme <name> [--template <minimal|blog|magazine>] [--with-devtools]');
+  }
+
+  const positional = [];
+  let template = 'minimal';
+  let withDevtools = false;
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (!arg.startsWith('--')) {
+      positional.push(arg);
+      continue;
+    }
+
+    if (arg === '--with-devtools') {
+      withDevtools = true;
+      continue;
+    }
+
+    if (arg === '--template') {
+      const value = argv[i + 1];
+      if (!value) {
+        throw new Error('--template requires a value');
+      }
+      if (!TEMPLATES.has(value)) {
+        throw new Error(`Invalid template "${value}". Allowed: minimal, blog, magazine`);
+      }
+      template = value;
+      i += 1;
+      continue;
+    }
+
+    throw new Error(`Unknown option: ${arg}`);
+  }
+
+  if (positional.length !== 1) {
+    throw new Error('Expected exactly one theme directory name');
+  }
+
+  const name = positional[0];
+  if (!name || name.includes('..') || path.isAbsolute(name)) {
+    throw new Error('Theme name must be a relative directory name');
+  }
+
+  return { name, template, withDevtools };
+}
+
+async function ensureEmptyDirectory(targetDir) {
+  try {
+    const stat = await fs.stat(targetDir);
+    if (!stat.isDirectory()) {
+      throw new Error(`Path exists and is not a directory: ${targetDir}`);
+    }
+    const entries = await fs.readdir(targetDir);
+    if (entries.length > 0) {
+      throw new Error(`Directory is not empty: ${targetDir}`);
+    }
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      await fs.mkdir(targetDir, { recursive: true });
+      return;
+    }
+    throw error;
+  }
+}
+
+async function scaffoldTheme(targetDir, name) {
+  await fs.mkdir(path.join(targetDir, 'partials'), { recursive: true });
+  await fs.mkdir(path.join(targetDir, 'assets'), { recursive: true });
+
+  const files = {
+    'theme.json': JSON.stringify(
+      {
+        name,
+        version: '0.1.0',
+        author: 'Author Name',
+        description: 'ZeroPress theme',
+      },
+      null,
+      2
+    ) + '\n',
+    'layout.html': `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{site.title}}</title>
+    <meta name="description" content="{{site.description}}" />
+    <link rel="stylesheet" href="/assets/style.css" />
+  </head>
+  <body>
+    <header>{{slot:header}}</header>
+    <main>{{slot:content}}</main>
+    <footer>{{slot:footer}}</footer>
+  </body>
+</html>
+`,
+    'index.html': `<section>
+  <h1>{{site.title}}</h1>
+  <p>{{site.description}}</p>
+  <div>{{posts}}</div>
+  <nav>{{pagination}}</nav>
+</section>
+`,
+    'post.html': `<article>
+  <h1>{{post.title}}</h1>
+  <div>{{post.html}}</div>
+</article>
+`,
+    'page.html': `<article>
+  <h1>{{page.title}}</h1>
+  <div>{{page.html}}</div>
+</article>
+`,
+    'archive.html': `<section>
+  <h1>Archive</h1>
+  <div>{{posts}}</div>
+</section>
+`,
+    'category.html': `<section>
+  <h1>Category</h1>
+  <div>{{posts}}</div>
+</section>
+`,
+    'tag.html': `<section>
+  <h1>Tag</h1>
+  <div>{{posts}}</div>
+</section>
+`,
+    '404.html': `<section>
+  <h1>404</h1>
+  <p>Not Found</p>
+</section>
+`,
+    'partials/header.html': '<a href="/">Home</a>\n',
+    'partials/footer.html': '<small>Powered by ZeroPress</small>\n',
+    'assets/style.css': `:root { font-family: system-ui, sans-serif; }
+body { margin: 0; padding: 2rem; line-height: 1.5; }
+h1 { margin-top: 0; }
+`,
+  };
+
+  await Promise.all(
+    Object.entries(files).map(([filePath, content]) =>
+      fs.writeFile(path.join(targetDir, filePath), content, 'utf8')
+    )
+  );
+}
+
+async function writeDevtoolsPackageJson(targetDir) {
+  const pkg = {
+    name: path.basename(targetDir),
+    private: true,
+    version: '0.1.0',
+    type: 'module',
+    scripts: {
+      dev: 'zeropress-theme dev',
+      validate: 'zeropress-theme validate',
+      pack: 'zeropress-theme pack',
+    },
+  };
+  await fs.writeFile(path.join(targetDir, 'package.json'), `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+}