refactor!: v3.0.0 major overhaul

- Hook: stabilize useCodeExecution (refs, stable execute, updateCode alias)

- Tests: fix TypeScript matchers and marked renderer signature; remove unused vars

- Docs: README requirements, hook example, CI/CD notes

- CI: Node 18 + PNPM, cache; turbo scripts; gh-pages publish docs/dist

- Publish: Changesets + npm provenance (OIDC), remove NODE_AUTH_TOKEN

- Misc: align workspace configs

Author: simonguo

.eslintrc.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json.schemastore.org/eslintrc.json",
+  "root": true,
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    "prettier"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaFeatures": {
+      "jsx": true
+    },
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint", "react", "react-hooks"],
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  },
+  "rules": {
+    "react/react-in-jsx-scope": "off",
+    "react/prop-types": "off",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
+  },
+  "ignorePatterns": ["dist", "node_modules", "*.js", "*.cjs"]
+}

.github/workflows/gh-pages.yml

@@ -18,20 +18,26 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 'lts/*'
+          node-version: '18.x'
+          cache: 'pnpm'
 
       - name: Install
-        run: npm install
+        run: pnpm install --frozen-lockfile
 
       - name: Build
-        run: npm run build:docs
+        run: pnpm docs:build
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
         if: github.ref == 'refs/heads/main'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/assets
+          publish_dir: ./docs/dist

.github/workflows/nodejs-ci.yml

@@ -12,13 +12,33 @@ on:
       - main
 jobs:
   test:
-    name: 'Test'
+    name: 'Build & Test'
     runs-on: ubuntu-latest
-    container: node:16
 
     steps:
-      - uses: actions/checkout@v2
-      - env:
+      - uses: actions/checkout@v4
+
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18.x'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+        env:
           HUSKY: 0
-        run: npm install
-      - run: npm test
+
+      - name: Typecheck
+        run: pnpm -w typecheck
+
+      - name: Build
+        run: pnpm -w build
+
+      - name: Test
+        run: pnpm -w test --reporter verbose

.github/workflows/nodejs-publish.yml

@@ -1,30 +1,44 @@
 # see https://help.github.com/cn/actions/language-and-framework-guides/publishing-nodejs-packages
 
-name: Node.js Package
+name: Release Packages
 
 on:
+  workflow_dispatch: {}
   push:
-    tags: ['*']
+    tags:
+      - 'v*'
 
 jobs:
   publish:
-    name: 'Publish'
+    name: 'Publish to npm'
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
     steps:
-      - uses: actions/checkout@v2
-      # Setup .npmrc file to publish to npm
-      - uses: actions/setup-node@v1
+      - uses: actions/checkout@v4
+
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '18.x'
           registry-url: 'https://registry.npmjs.org'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm install
+        run: pnpm install --frozen-lockfile
+        env:
+          HUSKY: 0
 
       - name: Build
-        run: npm run build
+        run: pnpm -w build
 
-      - name: Npm Publish
-        run: npm publish dist
+      - name: Publish with Changesets
+        run: pnpm release
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true

.gitignore

@@ -1,33 +1,36 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-karma-*
-
-# Runtime data
-pids
-*.pid
-*.seed
+# Dependencies
+node_modules/
+.pnpm-store/
 
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+# Build outputs
+dist/
+*.tsbuildinfo
 
-# Coverage directory used by tools like istanbul
-coverage
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
 
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
+# OS
+.DS_Store
+Thumbs.db
 
-# node-waf configuration
-.lock-wscript
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
 
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
+# Test coverage
+coverage/
 
-# Dependency directory
-node_modules
+# Turbo
+.turbo/
 
-# Optional npm cache directory
+# Environment
+.env
+.env.local
+.env.*.local
 .npm
 
 # Optional REPL history

.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "none",
+  "printWidth": 100,
+  "arrowParens": "avoid"
+}