@ozdemirburak/morse-code-translator 5.0.3 → 6.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Burak Özdemir
+Copyright (c) 2025 Burak Özdemir
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -23,10 +23,23 @@ const decoded = morse.decode('... --- ...'); // SOS
 const characters = morse.characters(); // {'1': {'A': '.-', ...}, ..., '11': {'ㄱ': '.-..', ...}}
 
 const audio = morse.audio('SOS');
-audio.play(); // play audio
-audio.stop(); // stop audio (cannot resume)
-audio.exportWave(); // download audio wave file (promise)
-const url = await audio.getWaveUrl(); // get audio wave url (promise)
+
+// Playback control
+await audio.play();           // play audio (returns Promise)
+audio.pause();                // pause audio
+await audio.play();           // resume from paused position
+await audio.seek(1.5);        // seek to 1.5 seconds
+audio.stop();                 // stop audio and reset to beginning
+audio.dispose();              // cleanup and dispose audio resources
+
+// Playback state and info
+audio.getState();             // 'ready', 'playing', 'paused', or 'stopped'
+audio.getCurrentTime();       // current playback position in seconds
+audio.getTotalTime();         // total duration in seconds
+
+// Export audio
+await audio.exportWave();     // download audio wave file (promise)
+const url = await audio.getWaveUrl();  // get audio wave url (promise)
 const blob = await audio.getWaveBlob(); // get audio wave blob (promise)
 ```
 
@@ -65,17 +78,28 @@ const arabicAudio = morse.audio('البراق', { // generates the Morse .- .-..
   volume: 100, // the volume in percent (0-100)
   oscillator: {
     type: 'sine', // sine, square, sawtooth, triangle
-    frequency: 500,  // value in hertz
-    onended: function () { // event that fires when the tone stops playing
-      console.log('ended');
-    }
+    frequency: 500  // value in hertz
+  },
+  events: {
+    onready: () => console.log('Audio is ready'),
+    onstarted: () => console.log('Playback started'),
+    onpaused: () => console.log('Playback paused'),
+    onstopped: () => console.log('Playback stopped'),
+    onended: () => console.log('Playback completed naturally'),
+    onseeked: (time) => console.log('Seeked to:', time)
   }
 });
+
+// Access to Web Audio API nodes (for advanced users)
 const oscillator = arabicAudio.oscillator; // OscillatorNode
-const context = arabicAudio.context; // AudioContext;
+const context = arabicAudio.context; // AudioContext
 const gainNode = arabicAudio.gainNode; // GainNode
-arabicAudio.play(); // will start playing Morse audio
-arabicAudio.stop(); // will stop playing Morse audio
+
+// Playback control
+await arabicAudio.play(); // will start playing Morse audio
+arabicAudio.pause();      // will pause Morse audio
+await arabicAudio.play(); // will resume from where it was paused
+arabicAudio.stop();       // will stop and reset to beginning
 ```
 
 ## Contributions
@@ -85,17 +109,16 @@ with extensive feedback and contributions from [numerous developers](https://git
 
 Special thanks to [Chris Jones](https://github.com/chris--jones), who added many great features.
 
-## References
+## License & Attribution
 
-Please consider referencing the website of this project, if you find this package useful for your work.
+[MIT licensed](LICENSE), use it however you want. But if this library saved you time, link back to
+the project homepage. It is how open-source maintainers get credit for their work.
 
 ```html
 <a href="https://morsecodetranslator.com">Morse Code Translator</a>
 ```
 
-## License
-
-The MIT License (MIT). Please see [License File](LICENSE) for more information.
+Takes 30 seconds. Appreciated, not required.
 
   [npm-version]: https://img.shields.io/npm/v/@ozdemirburak/morse-code-translator.svg?style=flat-square
   [npm-downloads]: https://img.shields.io/npm/dm/@ozdemirburak/morse-code-translator.svg?style=flat-square

package/dist/audio.d.ts

@@ -0,0 +1,4 @@
+import { Options, AudioResult } from './types.js';
+declare const audio: (morse: string, options: Options) => AudioResult;
+export default audio;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAyHhF,QAAA,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,SAAS,OAAO,KAAG,WAqQhD,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/characters.d.ts

@@ -0,0 +1,11 @@
+import { Characters, Options } from './types.js';
+declare const getCharacters: (options: Options) => {
+    '0': Record<string, string>;
+    '1': {
+        [x: string]: string;
+    };
+};
+declare const getMappedCharacters: (options: Options, usePriority: boolean) => Characters;
+declare const swapCharacters: (options: Options) => Record<string, string>;
+export { getCharacters, getMappedCharacters, swapCharacters };
+//# sourceMappingURL=characters.d.ts.map

package/dist/characters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../src/characters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAmGtD,QAAA,MAAM,aAAa,GAAI,SAAS,OAAO;;;;;CAOrC,CAAC;AAEH,QAAA,MAAM,mBAAmB,GAAI,SAAS,OAAO,EAAE,aAAa,OAAO,eAgBlE,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,SAAS,OAAO,2BAWvC,CAAC;AAEF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { Options, Characters, AudioResult } from './types.js';
+export declare const encode: (text: string, opts?: Partial<Options>) => string;
+export declare const decode: (morse: string, opts?: Partial<Options>) => string;
+export declare const characters: (options?: Partial<Options>, usePriority?: boolean) => Characters;
+export declare const audio: (text: string, opts?: Partial<Options>, morseString?: string) => AudioResult;
+export type { Options, Characters, AudioResult, Oscillator, AudioState, AudioEvents } from './types.js';
+declare const _default: {
+    encode: (text: string, opts?: Partial<Options>) => string;
+    decode: (morse: string, opts?: Partial<Options>) => string;
+    characters: (options?: Partial<Options>, usePriority?: boolean) => Characters;
+    audio: (text: string, opts?: Partial<Options>, morseString?: string) => AudioResult;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAG,MAgB9D,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAG,MAc/D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,UAAU,OAAO,CAAC,OAAO,CAAC,EAAE,cAAa,OAAe,KAAG,UAErF,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,MAAM,KAAG,WAInF,CAAC;AAGF,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;;mBA7C3E,MAAM,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM;oBAkBvC,MAAM,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM;2BAgBjC,OAAO,CAAC,OAAO,CAAC,gBAAe,OAAO,KAAW,UAAU;kBAIpE,MAAM,SAAS,OAAO,CAAC,OAAO,CAAC,gBAAgB,MAAM,KAAG,WAAW;;AAS/F,wBAKE"}