JSY Node

1.6.6 verified Fri May 01 auth: no javascript maintenance

Runtime require hook for the JSY (Offside indention) syntax transpiler, enabling Node.js to load .jsy files directly. Version 1.6.6 is current. Maintenance only; no active development. Key differentiator: automatic registration via require or CLI -r flag, supports Mocha, and provides jsy-node binary. Alternative to manual JSY compilation steps.

Common errors

error Error: Cannot find module 'jsy-transpile' ↓

cause Missing peer dependency jsy-transpile

fix

npm install jsy-transpile

error SyntaxError: Unexpected token import ↓

cause Using ESM syntax in a .jsy file that is not transpiled

fix

Ensure jsy-node is required before importing .jsy files

error Error: Cannot find module './file.jsy' ↓

cause Relative path incorrect or file not found

fix

Check file path and extension (.jsy)

Warnings

deprecated Package is in maintenance mode; no new features. ↓

fix Consider alternative for new projects.

breaking ESM modules cannot use require hook; module must be CommonJS. ↓

fix Use CommonJS or transpile manually.

gotcha The require hook modifies Node's module loader globally. ↓

fix Only use in controlled environments.

gotcha jsy-node/all loads all extensions; may conflict with other hooks. ↓

fix Use jsy-node directly if only .jsy is needed.

Install

npm install jsy-node

yarn add jsy-node

pnpm add jsy-node

Imports

jsy-node
wrong
```
import 'jsy-node'
```
correct
```
require('jsy-node')
```
ESM import not supported; use CommonJS require() to register the hook.
jsy-node/all
wrong
```
require('jsy-node')
```
correct
```
require('jsy-node/all')
```
Use 'jsy-node/all' to load all JSY extensions (e.g., .jsy, .jsy.js).
jsy-node (binary)
wrong
```
node script.jsv
```
correct
```
jsy-node script.jsv
```
Run jsy-node as a CLI tool instead of node -r jsy-node to execute .jsy files.

Quickstart

Install jsy-node and run a .jsy file directly via CLI or node require hook.

// Install globally or locally
npm install -g jsy-node

// Create hello.jsy
// Transpile on execution
jsy-node hello.jsy

// Alternatively, use require hook
node -r jsy-node hello.jsy