create-rainynest-ext 0.0.0-stage → 0.1.0

package/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// create-rainynest-ext — RainyNest 扩展脚手架
+// 用法：
+//   npm create rainynest-ext my-plugin          （生成插件工程）
+//   npm create rainynest-ext my-theme --theme   （生成主题工程）
+const fs = require('node:fs');
+const path = require('node:path');
+
+const args = process.argv.slice(2);
+const themeFlag = args.includes('--theme');
+const positional = args.find((a) => !a.startsWith('-'));
+const kind = themeFlag ? 'theme' : 'plugin';
+const name = positional || (themeFlag ? 'my-theme' : 'my-plugin');
+
+if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+  console.error(`[create] 无效名称 "${name}"：只允许小写字母/数字/连字符`);
+  process.exit(1);
+}
+
+const dest = path.join(process.cwd(), name);
+if (fs.existsSync(dest)) {
+  console.error(`[create] 目录已存在: ${dest}`);
+  process.exit(1);
+}
+
+const tplDir = path.join(__dirname, 'templates', kind);
+
+function copyTpl(src, d) {
+  fs.mkdirSync(d, { recursive: true });
+  for (const item of fs.readdirSync(src)) {
+    const s = path.join(src, item);
+    const t = path.join(d, item);
+    if (fs.statSync(s).isDirectory()) {
+      copyTpl(s, t);
+      continue;
+    }
+    const content = fs.readFileSync(s, 'utf-8').replace(/__SLUG__/g, name);
+    fs.writeFileSync(t, content);
+  }
+}
+
+copyTpl(tplDir, dest);
+
+console.log(`[create] ✓ 已生成${kind === 'plugin' ? '插件' : '主题'}工程: ${dest}`);
+console.log('  下一步:');
+console.log(`    cd ${name}`);
+console.log('    npm install');
+console.log('    npm run dev   # 联调热更新（需要 RainyNest 站点的 EXT_DEV_TOKEN）');
+console.log('    npm run pack  # 产出发布包，到后台「系统 → 插件/主题」上传安装');

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "create-rainynest-ext",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "RainyNest 扩展脚手架：npm create rainynest-ext my-plugin 生成插件/主题模板工程",
+  "bin": {
+    "create-rainynest-ext": "index.js"
+  },
+  "files": [
+    "index.js",
+    "templates/"
+  ],
+  "keywords": [
+    "rainynest",
+    "plugin",
+    "theme",
+    "scaffold"
+  ],
+  "license": "MIT"
+}

package/templates/plugin/README.md

@@ -0,0 +1,17 @@
+# __SLUG__
+
+RainyNest 插件。
+
+## 开发
+
+```bash
+npm install
+npm run dev    # 联调热更新，需要 RainyNest 主项目 .env 里的 EXT_DEV_TOKEN
+```
+
+## 发布
+
+```bash
+npm run pack
+# 产出 dist/__SLUG__.zip.rainy-plugin，到 RainyNest 后台「系统 → 插件」上传安装
+```

package/templates/plugin/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "private": true,
+  "description": "RainyNest 插件 __SLUG__",
+  "scripts": {
+    "dev": "ext dev . --site http://localhost:3000",
+    "build": "ext build . -o dist",
+    "pack": "ext build . -o dist && ext pack dist"
+  },
+  "devDependencies": {
+    "@rainynest/ext": "^0.1.0",
+    "@rainynest/plugin-types": "^0.1.0",
+    "@types/react": "^19.1.0",
+    "typescript": "^5.8.0"
+  }
+}

package/templates/plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "slug": "__SLUG__",
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "description": "插件描述",
+  "author": "",
+  "specVersion": "1.0",
+  "requiresCore": ">=1.0.0",
+  "entry": "index.ts",
+  "permissions": [],
+  "roleTemplates": [],
+  "database": { "enabled": false },
+  "configSchema": {
+    "basic": {
+      "label": "基础",
+      "fields": {
+        "enabled": { "type": "switch", "label": "启用", "default": true }
+      }
+    }
+  }
+}

package/templates/plugin/src/admin.tsx

@@ -0,0 +1,11 @@
+// src/admin.tsx — 可选后台页面（customAdminRoutes 引用）
+import React from 'react';
+
+export default function AdminPage() {
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-bold">__SLUG__</h1>
+      <p className="text-sm text-gray-500">插件管理页</p>
+    </div>
+  );
+}

package/templates/plugin/src/index.ts

@@ -0,0 +1,12 @@
+// src/index.ts — __SLUG__ 插件入口
+import type { PluginContext, ExtensionHandlers } from '@rainynest/plugin-types';
+
+export default function createPlugin(ctx: PluginContext): ExtensionHandlers {
+  ctx.logger.info('__SLUG__ 已加载，版本', ctx.version);
+
+  return {
+    // 在这里实现扩展点，例如：
+    // onMount(ctx) {},
+    // injectFooter() { return []; },
+  };
+}

package/templates/plugin/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/templates/theme/README.md

@@ -0,0 +1,17 @@
+# __SLUG__
+
+RainyNest 主题。
+
+## 开发
+
+```bash
+npm install
+npm run dev    # 联调热更新，需要 RainyNest 主项目 .env 里的 EXT_DEV_TOKEN
+```
+
+## 发布
+
+```bash
+npm run pack
+# 产出 dist/__SLUG__.gz.rainy-theme，到 RainyNest 后台「系统 → 主题」上传安装
+```

package/templates/theme/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "private": true,
+  "description": "RainyNest 主题 __SLUG__",
+  "scripts": {
+    "dev": "ext dev . --site http://localhost:3000",
+    "build": "ext build . -o dist",
+    "pack": "ext build . -o dist && ext pack dist"
+  },
+  "devDependencies": {
+    "@rainynest/ext": "^0.1.0",
+    "@rainynest/plugin-types": "^0.1.0",
+    "typescript": "^5.8.0"
+  }
+}

package/templates/theme/src/theme.ts

@@ -0,0 +1,8 @@
+// src/theme.ts — 配置值 → CSS 变量
+export function configToCssVariables(config: Record<string, any>): Record<string, string> {
+  const vars: Record<string, string> = {};
+  if (config?.basic?.accentColor) {
+    vars['--color-primary'] = config.basic.accentColor;
+  }
+  return vars;
+}

package/templates/theme/theme.css

@@ -0,0 +1 @@
+/* theme.css — __SLUG__ 主题样式 */

package/templates/theme/theme.json

@@ -0,0 +1,26 @@
+{
+  "slug": "__SLUG__",
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "description": "主题描述",
+  "author": "",
+  "specVersion": "1.0",
+  "minRainyNestVersion": ">=1.0.0",
+  "preview": "preview.png",
+  "supports": ["posts", "pages", "moments", "gallery", "links"],
+  "configSchema": {
+    "basic": {
+      "label": "基础",
+      "fields": {
+        "accentColor": { "type": "color", "label": "强调色", "default": "#3b82f6" }
+      }
+    },
+    "advanced": {
+      "label": "高级",
+      "fields": {
+        "customCss": { "type": "textarea", "label": "自定义 CSS", "default": "" },
+        "customJs": { "type": "textarea", "label": "自定义 JS", "default": "" }
+      }
+    }
+  }
+}

package/templates/theme/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.