@spcsn/taro-cli 0.1.0

package/templates/default/package.json.tmpl

@@ -0,0 +1,52 @@
+{
+  "name": "{{ projectName }}",
+  "version": "1.0.0",
+  "private": true,
+  "description": "{{ description }}",
+  "templateInfo": {
+    "name": "{{ template }}",
+    "typescript": {{ typescript }},
+    "css": "{{ css }}",
+    "framework": "{{ framework }}"
+  },
+  "scripts": {
+    "new": "taro new",
+    "build:weapp": "taro build --type weapp",
+    "dev:weapp": "npm run build:weapp -- --watch"
+  },
+  {{#if buildEs5 }}
+  "browserslist": {
+    "development": [
+      "defaults and fully supports es6-module",
+      "maintained node versions"
+    ],
+    "production": [
+      "last 3 versions",
+      "Android >= 4.1",
+      "ios >= 8"
+    ]
+  },
+  {{else}}
+  "browserslist": [
+    "defaults and fully supports es6-module",
+    "maintained node versions"
+  ],
+  {{/if}}
+  "author": "",
+  "dependencies": {
+    "@spcsn/taro-components": "{{ version }}",
+    "@spcsn/taro": "{{ version }}",
+    "react-dom": "^19.2.0",
+    "react": "^19.2.0"
+  },
+  "devDependencies": {
+    "@spcsn/taro-cli": "{{ version }}",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",{{#if (eq css "Sass") }}
+    "sass": "^1.75.0",{{/if}}{{#if (eq css "Less") }}
+    "less": "^4.2.0",{{/if}}{{#if (eq css "Stylus") }}
+    "stylus": "^0.63.0",{{/if}}{{#if typescript }}
+    "typescript": "^5.9.3",{{/if}}
+    "@types/minimatch": "^5"
+  }
+}

package/templates/default/project.config.json

@@ -0,0 +1,15 @@
+{
+  "miniprogramRoot": "./dist",
+  "projectname": "{{ projectName }}",
+  "description": "{{ description }}",
+  "appid": "touristappid",
+  "setting": {
+    "urlCheck": true,
+    "es6": false,
+    "enhance": false,
+    "compileHotReLoad": false,
+    "postcss": false,
+    "minified": false
+  },
+  "compileType": "miniprogram"
+}

package/templates/default/src/app.config.js

@@ -0,0 +1,11 @@
+export default defineAppConfig({
+  pages: [
+    'pages/index/index'
+  ],
+  window: {
+    backgroundTextStyle: 'light',
+    navigationBarBackgroundColor: '#fff',
+    navigationBarTitleText: 'WeChat',
+    navigationBarTextStyle: 'black'
+  }
+})

package/templates/default/src/app.js

@@ -0,0 +1,15 @@
+{{#if typescript }}import { PropsWithChildren } from 'react'{{/if}}
+import { useLaunch } from '@spcsn/taro'
+
+import './app.{{ cssExt }}'
+
+function App({ children }{{#if typescript }}: PropsWithChildren<any>{{/if}}) {
+  useLaunch(() => {
+    console.log('App launched.')
+  })
+
+  // children 是将要会渲染的页面
+  return children
+}
+
+export default App

package/templates/default/src/pages/index/index.config.js

@@ -0,0 +1,3 @@
+export default definePageConfig({
+  navigationBarTitleText: '首页'
+})

package/templates/default/src/pages/index/index.jsx

@@ -0,0 +1,15 @@
+import { View, Text } from '@spcsn/taro-components'
+import { useLoad } from '@spcsn/taro'
+import './index.{{ cssExt }}'
+
+export default function {{ to_pascal_case pageName }} () {
+  useLoad(() => {
+    console.log('Page loaded.')
+  })
+
+  return (
+    <View className='{{ pageName }}'>
+      <Text>Hello world!</Text>
+    </View>
+  )
+}

package/templates/default/template_creator.js

@@ -0,0 +1,61 @@
+const path = require('path')
+
+function createWhenTs (err, params) {
+  return !!params.typescript
+}
+
+function normalizePath (path) {
+  return path.replace(/\\/g, '/').replace(/\/{2,}/g, '/')
+}
+
+const SOURCE_ENTRY = '/src'
+const PAGES_ENTRY = '/src/pages'
+
+const handler = {
+  '/tsconfig.json': createWhenTs,
+  '/types/global.d.ts': createWhenTs,
+  '/src/pages/index/index.jsx' (err, { pageDir = '', pageName = '', subPkg = '' }) {
+    return {
+      setPageName: normalizePath(path.join(PAGES_ENTRY, pageDir, pageName, 'index.jsx')),
+      setSubPkgName: normalizePath(path.join(SOURCE_ENTRY, subPkg, pageDir, pageName, 'index.jsx'))
+    }
+  },
+  '/src/pages/index/index.css' (err, { pageDir = '', pageName = '', subPkg = '' }) {
+    return {
+      setPageName: normalizePath(path.join(PAGES_ENTRY, pageDir, pageName, 'index.css')),
+      setSubPkgName: normalizePath(path.join(SOURCE_ENTRY, subPkg, pageDir, pageName, 'index.css'))
+    }
+  },
+  '/src/pages/index/index.config.js' (err, { pageDir = '', pageName = '', subPkg = '' }) {
+    return {
+      setPageName: normalizePath(path.join(PAGES_ENTRY, pageDir, pageName, 'index.config.js')),
+      setSubPkgName: normalizePath(path.join(SOURCE_ENTRY, subPkg, pageDir, pageName, 'index.config.js'))
+    }
+  },
+  '/_editorconfig' () {
+    return { setPageName: `/.editorconfig` }
+  },
+  '/_env.development' () {
+    return { setPageName: `/.env.development` }
+  },
+  '/_env.production' () {
+    return { setPageName: `/.env.production` }
+  },
+  '/_env.test' () {
+    return { setPageName: `/.env.test` }
+  },
+  '/_gitignore' () {
+    return { setPageName: `/.gitignore` }
+  }
+}
+
+const basePageFiles = [
+  '/src/pages/index/index.jsx',
+  '/src/pages/index/index.css',
+  '/src/pages/index/index.config.js'
+]
+
+module.exports = {
+  handler,
+  basePageFiles
+}

package/templates/default/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "es2017",
+    "module": "commonjs",
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "noImplicitAny": false,
+    "allowSyntheticDefaultImports": true,
+    "outDir": "lib",
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strictNullChecks": true,
+    "sourceMap": true,
+    "rootDir": ".",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "typeRoots": [
+      "node_modules/@types"
+    ],
+    "paths": {
+      // TS5090 leading './'
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["./src", "./types", "./config"],
+  "compileOnSave": false
+}

package/templates/default/types/global.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="@spcsn/taro" />
+
+declare module '*.png';
+declare module '*.gif';
+declare module '*.jpg';
+declare module '*.jpeg';
+declare module '*.svg';
+declare module '*.css';
+declare module '*.less';
+declare module '*.scss';
+declare module '*.sass';
+declare module '*.styl';
+
+declare namespace NodeJS {
+  interface ProcessEnv {
+    /** NODE 内置环境变量, 会影响到最终构建生成产物 */
+    NODE_ENV: 'development' | 'production',
+    /** 当前构建的平台（当前 fork 仅支持 weapp） */
+    TARO_ENV: 'weapp'
+    /**
+     * 当前构建的小程序 appid
+     * @description 若不同环境有不同的小程序，可通过在 env 文件中配置环境变量`TARO_APP_ID`来方便快速切换 appid， 而不必手动去修改 dist/project.config.json 文件
+     * @see https://taro-docs.jd.com/docs/next/env-mode-config#特殊环境变量-taro_app_id
+     */
+    TARO_APP_ID: string
+  }
+}

package/templates/global-config/index.json

@@ -0,0 +1,4 @@
+{
+  "plugins": [],
+  "presets": []
+}

package/templates/global-config/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "taro-global-config",
+  "description": "taro-global-config",
+  "license": "ISC"
+}

package/templates/plugin-compile/README.md

@@ -0,0 +1,32 @@
+# {{ projectName }}
+
+> {{ description }}
+
+## 使用
+
+### 安装
+```
+npm i {{ projectName }} -D
+```
+
+### 使用插件
+`/config/index.js`
+
+```js
+{{#if (eq pluginType "plugin-template") }}
+/**插件参数为 IPluginOpts {
+ *  installPath: string 安装的路径
+ *  css?: 'none' | 'sass' | 'stylus' | 'less'
+ *  typescript?: boolean
+ *  compiler?: 'webpack5' | 'vite'
+ * }
+ * 这些参数后续会被模版文件解析所用
+ * 如果不传，会从 package.json 的 templateInfo
+ */
+{{/if}}
+const config = {
+  plugins: [
+    ["{{ projectName }}"{{#if (eq pluginType "plugin-template") }}, { installPath:'/xxx/xx/x' }{{/if}}]
+  ]
+}
+```

package/templates/plugin-compile/index.js

@@ -0,0 +1,3 @@
+module.exports = require('./dist/index.js').default
+
+module.exports.default = module.exports

package/templates/plugin-compile/package.json.tmpl

@@ -0,0 +1,43 @@
+{
+  "name": "{{ projectName }}",
+  "version": "1.0.0",
+  "description": "{{ description }}",
+  "keywords": [
+    "Taro",
+    "Plugin"
+  ],
+  "author": "",
+  "homepage": "",
+  "license": "MIT",
+  "main": "index.js",
+  "typings": "types/index.d.ts",
+  "files": [
+    "dist",
+    "index.js",
+    "types"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w"
+  },
+  "bugs": {
+    "url": ""
+  },
+  "dependencies": {
+    "@spcsn/taro-service": "^{{ version }}"{{#if (eq pluginType "plugin-build") }},
+    "webpack-chain": "^6.5.1"{{/if}}{{#if (eq pluginType "plugin-template") }},
+    "download": "^8.0.0",
+    "fs-extra": "^11.2.0",
+    "unzip": "^0.1.11"{{/if}}
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19"
+  }{{#if (eq pluginType "plugin-template") }},
+  "resolutions": {
+    "graceful-fs": "^4.2.11"
+  }{{/if}}
+}

package/templates/plugin-compile/src/index.ts

@@ -0,0 +1,153 @@
+import type { IPluginContext } from '@spcsn/taro-service'
+{{#if (eq pluginType "plugin-build") }}
+import webpackChain from 'webpack-chain'
+
+/**
+ * 编译过程扩展
+ */
+export default (ctx: IPluginContext, pluginOpts) => {
+  ctx.onBuildStart(() => {
+    console.log('插件入参：', pluginOpts)
+    console.log('编译开始')
+  })
+
+  ctx.modifyWebpackChain(({ chain }: { chain: webpackChain }) => {
+    console.log('这里可以修改webpack配置')
+    // 示例：利用webpackChain向html中插入脚本
+    if (process.env.TARO_ENV !== 'h5') return
+    chain
+      .plugin('htmlWebpackPlugin')
+      .tap(([pluginConfig]) => {
+        return [
+          {
+            ...pluginConfig,
+            script: pluginConfig.script + 'console.log("向html中插入代码");'
+          }
+        ]
+      })
+  })
+
+  ctx.onBuildComplete(() => {
+    console.log('Taro 构建完成！')
+  })
+
+  ctx.modifyBuildAssets(({ assets }) => {
+    console.log('修改编译后的结果')
+    // 示例：修改html产物内容
+    const indexHtml = assets['index.html']
+    if (indexHtml && indexHtml._value) {
+      indexHtml._value = indexHtml._value.replace(/<title>(.*?)<\/title>/,'<title>被插件修改过的标题</title>')
+    }
+  })
+
+  ctx.onBuildFinish(() => {
+    console.log('Webpack 编译结束！')
+  })
+}
+{{/if}}
+{{#if (eq pluginType "plugin-command") }}
+
+/**
+ * 命令行扩展
+ */
+export default (ctx: IPluginContext, pluginOpts) => {
+  ctx.registerCommand({
+    // 命令名
+    name: 'say',
+    // 参数说明，执行 taro say --help 时输出的 options 信息
+    optionsMap: {
+      '--msg': '输出的信息',
+    },
+    // 执行 taro say --help 时输出的使用例子的信息
+    synopsisList: ['taro say --msg Hello!'],
+    // 命令钩子
+    async fn() {
+      console.log('插件入参：', pluginOpts)
+      const { msg } = ctx.runOpts.options
+      console.log('Taro say:', msg)
+    },
+  })
+}
+{{/if}}
+{{#if (eq pluginType "plugin-template") }}
+import * as fs from 'fs-extra'
+const path = require('path')
+const download = require('download')
+const unzip = require("unzip")
+/**
+ * 创建 page 自定义模版
+ */
+
+interface ITemplateInfo {
+  css: 'none' | 'sass' | 'stylus' | 'less'
+  typescript?: boolean
+  compiler?: 'webpack5' | 'vite'
+  template?: string
+}
+
+type TCustomTemplateInfo = Omit<ITemplateInfo & {
+  isCustomTemplate?: boolean
+  customTemplatePath?: string
+}, 'template'>
+
+type TSetCustomTemplateConfig = (customTemplateConfig: TCustomTemplateInfo) => void
+
+interface IPluginOpts extends ITemplateInfo {
+  installPath: string
+}
+
+export default (ctx: IPluginContext, pluginOpts:IPluginOpts) => {
+ ctx.modifyCreateTemplate(async (setCustomTemplateConfig: TSetCustomTemplateConfig)=> {
+  const { installPath, css, typescript, compiler } = pluginOpts
+  const templateName = 'mobx'
+  const templatePath = path.join(installPath, templateName)
+  const customTemplateConfig = {
+    //自定义模版路径
+    customTemplatePath: templatePath,
+    css,
+    typescript,
+    compiler
+  }
+
+   /**
+    * 下载模版到电脑本地，可以自行进行判断，看是否需要重新下载
+    * 从哪里下载，如何下载，taro 官方不做限定
+    * 模版格式和社区模版一样
+    * 只要保证下载后的文件目录为 `${templatePath}` 即可，taro 会在该目录下获取模版
+    * 如果下载模版失败，请不要调用 setCustomTemplateConfig，taro 会根据默认流程进行兜底创建
+    */
+   if (!fs.existsSync(templatePath)) {
+    //如果文件不存在，就下载文件到指定路径
+     await downloadTemplate(customTemplateConfig)
+  }
+
+   if (fs.existsSync(templatePath)) {
+    //如果文件下载成功，调用 setCustomTemplateConfig
+     setCustomTemplateConfig(customTemplateConfig)
+   }
+ })
+}
+
+
+const downloadTemplate = async (customTemplateConfig) => {
+  return new Promise<void>(async (resolve, reject)=>{
+    const url = 'https://storage.360buyimg.com/olympic-models-test/mobx.zip'
+    const { name, templatePath } = customTemplateConfig
+    const zipName = `${name}.zip`
+    const zipPath = path.join(templatePath, zipName)
+    fs.writeFileSync(zipPath, await download(url))
+    const extract = unzip.Extract({ path: templatePath })
+    fs.createReadStream(zipPath).pipe(extract)
+    extract.on('close', function () {
+      console.log("解压完成!!")
+      //删除
+       fs.unlinkSync(zipPath)
+      resolve()
+    })
+    extract.on('error', function (err) {
+      console.log(err)
+      reject()
+    })
+  })
+}
+{{/if}}

package/templates/plugin-compile/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compileOnSave": true,
+  "compilerOptions": {
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "noImplicitAny": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "removeComments": false,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "target": "ES2017",
+    "module": "commonjs",
+    "preserveConstEnums": true,
+    "outDir": "./dist",
+    "traceResolution": false,
+    "sourceMap": true,
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationDir": "types"
+  },
+  "include": ["./src"],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}