morse-code-encode-decode

Encode and decode Morse code (ITU standard). Zero runtime dependencies. TypeScript-first.

Features

• Encodes plain text → Morse code and decodes back
• Supports all 26 Latin letters, digits 0–9, and common punctuation
• ITU / international standard codes
• Written in TypeScript — ships with full type declarations
• Zero runtime dependencies
• Works in Node.js, browsers (via bundler), Deno, Bun
• ESM and CommonJS — use import or require()
• TypeScript — types included (.d.ts / .d.cts)

Where it works

Environment	How
Node.js (ESM)	import { encode, decode } from 'morse-code-encode-decode'
Node.js (CommonJS)	const { encode, decode } = require('morse-code-encode-decode')
Bundlers (Vite, Webpack, Rollup, etc.)	Same as Node ESM; tree-shakeable
Browser (no bundler)	Use a CDN that serves ESM (e.g. esm.sh, unpkg with ?module) or bundle in your app
Deno	import { encode, decode } from 'npm:morse-code-encode-decode'
Bun	Same as Node (ESM or require)

Install

npm install morse-code-encode-decode
# or
pnpm add morse-code-encode-decode
# or
yarn add morse-code-encode-decode

Usage

import { encode, decode } from 'morse-code-encode-decode'

// Encode
encode('SOS')         // '... --- ...'
encode('HELLO')       // '.... . .-.. .-.. ---'
encode('Hello World') // '.... . .-.. .-.. --- / .-- --- .-. .-.. -..'
encode('73')          // '--... ...--'

// Decode
decode('... --- ...')            // 'SOS'
decode('.... . .-.. .-.. ---')   // 'HELLO'
decode('.... . .-.. .-.. --- / .-- --- .-. .-.. -..') // 'HELLO WORLD'

CommonJS (require) is also supported:

const { encode, decode } = require('morse-code-encode-decode')

API

encode(text: string): string

Converts a plain-text string to Morse code.

Detail	Behaviour
Case	Input is case-insensitive — 'sos' and 'SOS' produce the same result
Letter separator	Letters within a word are separated by a single space
Word separator	Words are separated by / (space-slash-space)
Unknown chars	Characters not in the Morse table are passed through unchanged
Empty / non-string	Returns ''

decode(morse: string): string

Converts a Morse code string back to plain text (uppercase).

Detail	Behaviour
Letter separator	Morse letters must be separated by a single space
Word separator	Morse words must be separated by /
Unknown codes	Unrecognised sequences are passed through unchanged
Empty / non-string	Returns ''

Supported Characters

Category	Characters
Letters	A–Z (case-insensitive)
Digits	0–9
Punctuation	. , ? ' ! / ( ) & : ; = + - _ " $ @

Development

git clone https://github.com/MaxGrushevsky/morse-code-encode-decode.git
cd morse-code-encode-decode
npm install

npm run build       # compile to dist/
npm test            # run tests once
npm run test:watch  # run tests in watch mode
npm run typecheck   # TypeScript type-check only

License

MIT