@celljs/cli 3.0.0

package/templates/microservice/packages/serviceB/README.md

@@ -0,0 +1,92 @@
+# 开发说明
+
+## 安装依赖
+
+以下使用 yarn 工具来说明，你也可以使用 npm。
+
+```bash
+# 通过 cell init 初始化应用的时候已经自动安装了依赖，所以你只需要安装你额外需要的依赖即可
+
+$ yarn add xxxx
+```
+
+## 本地运行
+
+```shell
+# 启动本地服务，端口默认 3000
+# 在终端中会输出本地服务的 URL 链接
+
+$ yarn start  # 或者执行 cell serve 命令
+```
+
+## 构建部署
+
+模板默认提供了四套隔离环境：本地（local）、测试（test）、预发（pre）、线上（prod）。每个环境对应着一个 cell 配置文件（可选），类似 cell-test.yml。而 cell.yml 文件一般用于放所有环境的公共配置。第一次部署的时候可能会提示你填写相关云厂商 ak 信息。如果是 Vercel 云平台的模板，会提示你需要登录到 Vercel 平台。你也可以在项目通过 .env 提供云厂商的 ak 信息。
+
+```bash
+
+$ cell deploy -m scf            # 部署到腾讯云函数测试环境
+$ cell deploy -m scf -m test    # 部署到腾讯云测试环境
+$ cell deploy -m scf -m pre     # 部署到腾讯云预发环境
+$ cell deploy -m scf -m prod    # 部署到腾讯云线上环境
+
+```
+
+## 关于 Cell Framework
+
+Cell 是基于 TypeScript 的 Serverless First、组件化、平台无关的渐进式应用框架。
+
+## 特征
+
+-   约定大于配置，零配置，开箱即用
+-   TypeScript 版 Spring Boot
+-   Serverless First
+-   平台不锁定
+-   支持前后端一体化，前端框架不锁定
+-   支持微服务
+-   组件化，渐进式
+-   命令行工具插件化
+-   依赖注入
+-   面向切面编程（AOP）
+-   集成了流行的 ORM 框架，使用装饰器声明式事务管理
+-   支持 OIDC 认证
+-   支持 OAuth2 授权
+-   使用 rxjs 管理状态
+-   提供 REST 和 RPC 两种接口风格
+
+Cell 名字由来：在我的家乡，谐音“吗啦咕”是小石头的意思，小石头堆砌起来可以建成高楼大厦、道路桥梁，而 Cell 组件编排可以实现千变万化的应用。
+
+## 快速开始
+
+```bash
+# 安装命令行工具
+npm install -g @celljs/cli
+
+# 初始化
+cell init -o project-name
+cd project-name            # 进入项目根目录
+
+# 运行
+cell serve
+
+# 部署
+cell deploy
+```
+
+[![Quick Start](https://asciinema.org/a/474104.svg)](https://asciinema.org/a/474104?speed=2.5&autoplay=1)
+
+### 文档
+
+-   [介绍](https://cell.cellbang.com/guide/%E4%BB%8B%E7%BB%8D)
+-   [创建第一个应用](https://cell.cellbang.com/guide/%E5%88%9B%E5%BB%BA%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%BA%94%E7%94%A8)
+-   [命令行工具](https://cell.cellbang.com/guide/%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
+-   [控制器](https://cell.cellbang.com/guide/%E6%8E%A7%E5%88%B6%E5%99%A8)
+-   [数据库操作](https://cell.cellbang.com/guide/%E6%95%B0%E6%8D%AE%E5%BA%93typeorm)
+-   [微服务](https://cell.cellbang.com/dev/%E5%BE%AE%E6%9C%8D%E5%8A%A1)
+-   [认证与授权](https://cell.cellbang.com/guide/%E8%AE%A4%E8%AF%81%E4%B8%8E%E6%8E%88%E6%9D%83)
+-   [云平台适配](https://cell.cellbang.com/cloud/%E4%BA%91%E5%B9%B3%E5%8F%B0%E9%80%82%E9%85%8D)
+-   [依赖注入](https://cell.cellbang.com/guide/%E4%BE%9D%E8%B5%96%E6%B3%A8%E5%85%A5)
+-   [组件设计](https://cell.cellbang.com/guide/%E7%BB%84%E4%BB%B6%E8%AE%BE%E8%AE%A1)
+-   [前端架构](https://cell.cellbang.com/guide/%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84)
+-   [React 开发](https://cell.cellbang.com/dev/react)
+-   [前后端一体化开发](https://cell.cellbang.com/dev/%E5%89%8D%E5%90%8E%E7%AB%AF%E4%B8%80%E4%BD%93%E5%8C%96%E5%BC%80%E5%8F%91)

package/templates/microservice/packages/serviceB/cell.yml

@@ -0,0 +1,5 @@
+
+cell:
+  cloud:
+    function:
+      name: ServiceB

package/templates/microservice/packages/serviceB/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@microservice/service-b",
+  "keywords": [
+    "cell-component"
+  ],
+  "version": "0.0.0",
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@celljs/core": "{{ version }}",
+    "@celljs/rpc": "{{ version }}",
+    "@microservice/api": "0.0.0"
+  },
+  "devDependencies": {
+    "@celljs/cli": "{{ version }}"
+  },
+  "scripts": {
+    "clean": "rimraf lib dist .cell",
+    "build": "tsc",
+    "start": "cell serve",
+    "deploy": "cell deploy -m scf -m test",
+    "deploy:test": "cell deploy -m scf -m test",
+    "deploy:pre": "cell deploy -m scf -m pre",
+    "deploy:prod": "cell deploy -m scf -m prod"
+  }
+}

package/templates/microservice/packages/serviceB/src/node/module.ts

@@ -0,0 +1,3 @@
+import './service-b';
+import { autoBind } from '@celljs/core';
+export default autoBind();

package/templates/microservice/packages/serviceB/src/node/service-b.ts

@@ -0,0 +1,9 @@
+import { ServiceB } from '@microservice/api';
+import { Rpc } from '@celljs/rpc';
+
+@Rpc(ServiceB)
+export class ServiceBImpl implements ServiceB {
+    say(): Promise<string> {
+        return Promise.resolve('Service B');
+    }
+}

package/templates/microservice/packages/serviceB/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitAny": true,
+    "noEmitOnError": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "target": "ES2017",
+    "lib": [
+      "ES2017"
+    ],
+    "sourceMap": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/microservice/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitAny": true,
+    "noEmitOnError": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "jsx": "react",
+    "target": "ES2017",
+    "lib": [
+      "ES2017",
+      "dom"
+    ],
+    "sourceMap": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/monorepo/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+insert_final_newline = true
+end_of_line = lf
+indent_style = space
+
+[*.{js,ts,md}]
+indent_size = 4
+
+[*.{json,yml}]
+indent_size = 2

package/templates/monorepo/.eslintrc.js

@@ -0,0 +1,18 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+    root: true,
+    extends: [
+        require.resolve('@celljs/component/configs/base.eslintrc.json'),
+        require.resolve('@celljs/component/configs/warnings.eslintrc.json'),
+        require.resolve('@celljs/component/configs/errors.eslintrc.json'),
+        require.resolve('@celljs/component/configs/xss.eslintrc.json')
+    ],
+    ignorePatterns: [
+        '**/{node_modules,lib}',
+        'plugins'
+    ],
+    parserOptions: {
+        tsconfigRootDir: __dirname,
+        project: 'tsconfig.json'
+    }
+};

package/templates/monorepo/.yarnrc

@@ -0,0 +1 @@
+unsafe-disable-integrity-migration true

package/templates/monorepo/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Change 
+
+## 0.0.1
+
+- feat(xxx) xxxxx

package/templates/monorepo/apps/sample-app/package.json

@@ -0,0 +1,33 @@
+{
+  "private": true,
+  "name": "@app/sample-app",
+  "keywords": [
+    "cell-component"
+  ],
+  "version": "0.0.0",
+  "license": "MIT",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@celljs/core": "2.42.0",
+    "@celljs/react": "2.42.0",
+    "@celljs/rpc": "2.42.0",
+    "@celljs/serve-static": "2.42.0",
+    "react": "^18.2.0",
+    "@app/core": "0.0.0"
+  },
+  "devDependencies": {
+    "@celljs/cli": "2.42.0"
+  },
+  "scripts": {
+    "clean": "rimraf lib dist .cell",
+    "build": "cell build",
+    "start": "cell serve",
+    "deploy": "cell deploy -m scf -m test",
+    "deploy:test": "cell deploy -m scf -m test",
+    "deploy:pre": "cell deploy -m scf -m pre",
+    "deploy:prod": "cell deploy -m scf -m prod"
+  }
+}

package/templates/monorepo/apps/sample-app/src/browser/css-shims.d.ts

@@ -0,0 +1,30 @@
+declare module '*.css' {
+    const styles: {
+        [key: string]: string
+    }
+    export default styles
+}
+declare module '*.scss' {
+    const styles: {
+        [key: string]: string
+    }
+    export default styles
+}
+declare module '*.sass' {
+    const styles: {
+        [key: string]: string
+    }
+    export default styles
+}
+declare module '*.less' {
+    const styles: {
+        [key: string]: string
+    }
+    export default styles
+}
+declare module '*.styl' {
+    const styles: {
+        [key: string]: string
+    }
+    export default styles
+}

package/templates/monorepo/apps/sample-app/src/browser/hello.view.tsx

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import { RpcUtil } from '@celljs/rpc/lib/common';
+import { WelcomeServer } from '../common/welcome-protocol';
+import { View } from '@celljs/react';
+import styles from './style/hello.module.scss';
+
+const Hello = () => {
+    const [ response, setResponse ] = React.useState('Loading');
+    React.useEffect(() => {
+        const welcomeServer = RpcUtil.get<WelcomeServer>(WelcomeServer);
+        const init = async () => {
+            setResponse(await welcomeServer.say());
+        }
+        init();
+    }, []);
+
+    return <div className={ styles.hello }>
+            <img alt="cell logo" src="./assets/logo.png"></img>
+            <div className="hello">
+                <h1>{response}</h1>
+                <p>
+                    For a guide and recipes on how to configure / customize this project,<br />
+                check out the <a href="https://cell.cellbang.com/" target="_blank" rel="noopener">cell documentation</a>.
+                </p>
+            </div>
+        </div>
+
+}
+
+@View({ index: true,  component: Hello })
+export default class {}

package/templates/monorepo/apps/sample-app/src/browser/module.ts

@@ -0,0 +1,3 @@
+import './hello.view';
+import { autoBind } from '@celljs/core';
+export default autoBind();

package/templates/monorepo/apps/sample-app/src/browser/style/hello.module.scss

@@ -0,0 +1,4 @@
+.hello {
+  text-align: center;
+  margin-top: 40px
+}

package/templates/monorepo/apps/sample-app/src/common/welcome-protocol.ts

@@ -0,0 +1,5 @@
+export const WelcomeServer = Symbol('WelcomeServer');
+
+export interface WelcomeServer {
+    say(): Promise<string>;
+}

package/templates/monorepo/apps/sample-app/src/node/module.ts

@@ -0,0 +1,3 @@
+import './welcome-server';
+import { autoBind } from '@celljs/core';
+export default autoBind();

package/templates/monorepo/apps/sample-app/src/node/welcome-server.ts

@@ -0,0 +1,9 @@
+import { WelcomeServer } from '../common/welcome-protocol';
+import { Rpc } from '@celljs/rpc';
+
+@Rpc(WelcomeServer)
+export class WelcomeServerImpl implements WelcomeServer {
+    say(): Promise<string> {
+        return Promise.resolve('Welcome to Cell');
+    }
+}

package/templates/monorepo/apps/sample-app/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitAny": true,
+    "noEmitOnError": false,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "strictNullChecks": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "jsx": "react",
+    "target": "ES2017",
+    "lib": [
+      "ES2017",
+      "dom"
+    ],
+    "sourceMap": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "include": [
+    "src"
+  ]
+}

package/templates/monorepo/configs/root-compilation.tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": "@celljs/component/configs/base.tsconfig.json",
+  "include": [],
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "src",
+    "outDir": "lib"
+  },
+  "references": [
+    {
+      "path": "../packages/core/compile.tsconfig.json"
+    }
+  ]
+}

package/templates/monorepo/configs/typedoc-tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../tsconfig",
+  "compilerOptions": {
+    "skipLibCheck": true
+  }
+}

package/templates/monorepo/configs/typedoc.json

@@ -0,0 +1,23 @@
+{
+  "emit": "none",
+  "compilerOptions": {
+    "ignoreCompilerErrors": true,
+    "skipLibCheck": true,
+    "noEmitOnError": true,
+    "allowJs": true
+  },
+  "exclude": [
+    "../+(apps|typings|scripts)/**",
+    "../packages/*/lib/**",
+    "**/node_modules/**",
+    "**/*.tsx",
+    "**/*spec.ts"
+  ],
+  "excludeExternals": true,
+  "external-modulemap": ".*\/(packages)\/([\\w\\-_]+)\/",
+  "hideGenerator": true,
+  "name": "App TypeDoc",
+  "out": "../gh-pages/docs/next",
+  "readme": "../README.md",
+  "entryPointStrategy": "expand"
+}

package/templates/monorepo/lerna.json

@@ -0,0 +1,17 @@
+{
+  "lerna": "2.2.0",
+  "npmClient": "yarn",
+  "useWorkspaces": true,
+  "version": "0.0.0",
+  "command": {
+    "run": {
+      "stream": true
+    },
+    "publish": {
+      "graphType": "all",
+      "forcePublish": true,
+      "skipGit": true,
+      "registry": "https://registry.npmjs.org/"
+    }
+  }
+}

package/templates/monorepo/package.json

@@ -0,0 +1,46 @@
+{
+  "private": true,
+  "name": "monorepo",
+  "version": "0.0.0",
+  "engines": {
+    "yarn": ">=1.7.0 <2",
+    "node": ">=16"
+  },
+  "resolutions": {
+    "**/@types/node": "18"
+  },
+  "devDependencies": {
+    "lerna": "^5.6.2",
+    "typedoc": "^0.23.21",
+    "typedoc-plugin-external-module-map": "~1.3.2",
+    "typedoc-plugin-remove-references": "^0.0.6",
+    "chai": "4.3.4",
+    "chai-spies": "1.0.0",
+    "chai-string": "^1.4.0"
+  },
+  "scripts": {
+    "bootstrap": "lerna bootstrap",
+    "prepare": "yarn run prepare:references && yarn run prepare:build",
+    "prepare:references": "node scripts/compile-references.js",
+    "prepare:build": "yarn build && yarn run lint",
+    "build": "tsc -b configs/root-compilation.tsconfig.json",
+    "watch": "tsc -b configs/root-compilation.tsconfig.json -w",
+    "clean": "yarn lint:clean && lerna run clean",
+    "build:clean": "lerna run prepare",
+    "lint": "lerna run lint",
+    "lint:clean": "rimraf .eslintcache",
+    "lint:oneshot": "node --max-old-space-size=4096 node_modules/eslint/bin/eslint.js --cache=true \"{dev-packages,packages,examples}/**/*.{ts,tsx}\"",
+    "docs": "rimraf gh-pages/docs/next && typedoc --tsconfig tsconfig.json --options configs/typedoc.json .",
+    "test": "yarn test:references && yarn test:app",
+    "test:references": "node scripts/compile-references --dry-run",
+    "test:app": "lerna run test --scope \"@app/*!(-app)\" --stream --concurrency=1",
+    "publish": "yarn && yarn test && yarn publish:latest",
+    "publish:latest": "lerna publish --exact --ignore-scripts --yes --no-push && yarn -s publish:check",
+    "publish:next": "lerna publish preminor --exact --ignore-scripts --canary --preid next --dist-tag next --no-git-reset --no-git-tag-version --no-push --ignore-scripts --yes && yarn publish:check",
+    "publish:check": "node scripts/check-publish.js"
+  },
+  "workspaces": [
+    "packages/*",
+    "apps/*"
+  ]
+}

package/templates/monorepo/packages/core/.eslintrc.js

@@ -0,0 +1,10 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+    extends: [
+        require.resolve('@celljs/component/configs/build.eslintrc.json')
+    ],
+    parserOptions: {
+        tsconfigRootDir: __dirname,
+        project: 'compile.tsconfig.json'
+    }
+};

package/templates/monorepo/packages/core/README.md

@@ -0,0 +1 @@
+# App - Core Component

package/templates/monorepo/packages/core/compile.tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "@celljs/component/configs/base.tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "src",
+    "outDir": "lib",
+    "baseUrl": "."
+  },
+  "include": [
+    "src"
+  ],
+  "references": []
+}

package/templates/monorepo/packages/core/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@app/core",
+  "version": "0.0.0",
+  "description": "",
+  "main": "lib/common/index.js",
+  "typings": "lib/common/index.d.ts",
+  "dependencies": {
+    "@celljs/core": "2.42.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "cell-component"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xxx/app.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xxx/app/issues"
+  },
+  "homepage": "https://github.com/xxx/app",
+  "files": [
+    "lib",
+    "src",
+    "cell.yml"
+  ],
+  "scripts": {
+    "lint": "cell-component lint",
+    "build": "cell-component build",
+    "watch": "cell-component watch",
+    "clean": "cell-component clean",
+    "test": "cell-component test:js"
+  },
+  "devDependencies": {
+    "@celljs/component": "2.42.0"
+  }
+}

package/templates/monorepo/packages/core/src/browser/module.ts

@@ -0,0 +1,4 @@
+import { autoBind } from '@celljs/core';
+import './index';
+
+export default autoBind();

package/templates/monorepo/packages/core/src/common/module.ts

@@ -0,0 +1,4 @@
+import { autoBind } from '@celljs/core';
+import './index';
+
+export default autoBind();

package/templates/monorepo/packages/core/src/node/module.ts

@@ -0,0 +1,4 @@
+import { autoBind } from '@celljs/core';
+import './index';
+
+export default autoBind();

package/templates/monorepo/packages/core/src/package.spec.ts

@@ -0,0 +1,4 @@
+describe('core package', () => {
+
+    it('support code coverage statistics', () => {});
+});