Guides Node.js scripts and shared modules in the Handsontable monorepo using .mjs files, native APIs, and asynchronous file operations. It covers task registration, error handling, and compatibility across Linux, macOS, and Windows.
中文简介正在准备中。当前显示英语简介。
Use when creating or modifying any .mjs file in the Handsontable monorepo - scripts, utilities, or library modules. Covers .mjs conventions, native node: imports, top-level await, cross-platform compatibility, and fs/promises async patterns. Trigger on any new .mjs file creation, not just files in scripts/ directories.
安装前可以查看交给 AI 代理的指令内容。
.mjs ModulesAll Node.js-side code (scripts, utilities, library modules, Playwright helpers, build tooling) is ESM .mjs.
.mjs for all Node.js-side code.scripts/ for CLI-invoked scripts, lib/ for shared modules; package-specific paths are fine (performance-tests/lib/, wrappers/react-wrapper/scripts/).node scripts/your-script.mjs from package.json scripts, or as a cmd in handsontable/scripts/tasks.json.handsontable/ uses a unified dispatcher. Put every command in handsontable/scripts/tasks.json and keep a thin shim in package.json:
"my-task": {
"cmd": "node scripts/my-script.mjs",
"deps": ["build:styles"],
"mode": "inherit"
}
"my-task": "node scripts/run.mjs my-task"
| Field | Required | Values | Purpose |
|---|---|---|---|
cmd | yes | shell string | Run via spawn(..., { shell: true }) |
deps | no | task name array | Tasks that must complete first (DAG scheduler in parallel mode, sequential in direct invocation) |
mode | no | quiet (default) | inherit | interactive | quiet = spinner; inherit = stream output (linters); interactive = full TTY pass-through (Jest) |
cwd | no | path relative to handsontable/ | Working directory override |
passthrough | no | boolean | Append extra CLI flags (after --) to the cmd |
note | no | string | Annotation only |
Pipelines go in the pipelines block:
"pipelines": {
"my-pipeline": {
"before": ["clean"],
"tasks": ["my-task", "other-task"],
"after": ["prepare-package-for-publish"]
}
}
before and after run sequentially; tasks run sequentially with --sequential or via DAG with --parallel.
Wrapper packages and performance-tests/, visual-tests/ take scripts directly in their own package.json (no run.mjs dispatcher).
node: (import { readFile } from 'node:fs/promises', node:path, node:url, node:child_process, node:util).await in module scope; wrap in try/catch only for an error boundary.Do not add third-party dependencies for what Node.js does natively.
| Task | Use | Not |
|---|---|---|
| Read/write files | node:fs/promises | fs-extra |
| Delete recursively | rm({ recursive: true, force: true }) | rimraf |
| Move/rename | rename() | mv |
| Run child process | node:child_process + promisify(exec) | execa |
| Parse CLI args | node:util parseArgs() or process.argv | yargs, commander |
| Path manipulation | node:path | slash, normalize-path |
| Glob matching | node:fs readdir + filter (glob/fast-glob only for complex patterns) | glob, fast-glob otherwise |
package.json scripts: use Node helpers in place of bash constructs (if [ ], mv, rm -rf, a && b || c conditionals). Plain && sequencing is fine.node:path join().node:fs/promises (readdir, rename, rm, access).__dirname equivalent: import.meta.dirname (Node 21+) or dirname(fileURLToPath(import.meta.url)).wrappers/react-wrapper/scripts/prepare-types.mjs.Existence check:
const exists = async (path) => access(path).then(() => true, () => false);
process.exitCode = 1 on failure so cleanup finishes.catch with why the error is swallowed.| Script | Purpose |
|---|---|
scripts/sync-skills-to-cursor.mjs | Sync .claude/skills to .cursor/rules |
scripts/translate-to-native-npm.mjs | Workspace command delegation |
scripts/verify-bundles.mjs | Post-build version verification |
scripts/pre-release.mjs | Pre-release version generation |
wrappers/react-wrapper/scripts/prepare-types.mjs | Cross-platform type preparation |
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Develop and modify the Handsontable Angular wrapper with guidance on component lifecycle, settings updates, and NgZone, which controls change detection. It also covers standalone examples, global configuration, and the build and test workflow.
中文简介正在准备中。当前显示英语简介。
Open local or public web pages in BrowserStack Live for checks on real mobile devices or desktop browsers. The skill prepares temporary access to a local server, launches the requested session, and shares its dashboard link.
中文简介正在准备中。当前显示英语简介。
Prepare user-facing changelog entries for source code changes. The skill determines whether an entry is needed, classifies the change, writes a clear title, and uses the project CLI to create a JSON file tied to the pull request.
中文简介正在准备中。当前显示英语简介。
Explore relationships between functions and files using a prebuilt code graph, a map of code dependencies. Trace bugs, inspect callers and execution paths, and assess the impact of refactoring or proposed changes.
中文简介正在准备中。当前显示英语简介。
Work with Handsontable row and column positions by distinguishing source data, displayed order, and rendered cells. It guides index conversion and helps investigate misplaced data when sorting, filtering, hiding, or moving rows and columns.
中文简介正在准备中。当前显示英语简介。
Create Handsontable documentation examples for JavaScript, TypeScript, React, Angular, and Vue. The skill explains source files, generated JavaScript, required imports and license settings, embedding examples in guides, and checking that each framework version displays correctly.
中文简介正在准备中。当前显示英语简介。