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.
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
.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.
한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.