@mulsense/xnew 0.4.5 → 0.4.6

package/dist/xnew.d.ts

@@ -56,6 +56,9 @@ interface Internal {
     parent: Unit | null;
     target: Object | null;
     props?: Object;
+    config: {
+        protect: boolean;
+    };
     baseElement: UnitElement;
     baseContext: Context;
     baseComponent: Function;
@@ -65,7 +68,6 @@ interface Internal {
     anchor: UnitElement | null;
     state: string;
     tostart: boolean;
-    protected: boolean;
     ancestors: Unit[];
     children: Unit[];
     promises: UnitPromise[];
@@ -274,7 +276,6 @@ declare const xnew$1: CreateUnit & {
      * }, 300)
      */
     transition(transition: Function, duration?: number, easing?: string): any;
-    protect(): void;
 };
 
 declare function Accordion(unit: Unit, { open, duration, easing }?: {
@@ -297,6 +298,14 @@ declare function Screen(unit: Unit, { width, height, fit }?: {
     resize(width: number, height: number): void;
 };
 
+declare function Modal(unit: Unit, { duration, easing }?: {
+    duration?: number;
+    easing?: string;
+}): {
+    state: number;
+    close(): void;
+};
+
 declare function AnalogStick(unit: Unit, { stroke, strokeOpacity, strokeWidth, strokeLinejoin, fill, fillOpacity }?: {
     stroke?: string;
     strokeOpacity?: number;
@@ -322,19 +331,66 @@ declare function TextStream(unit: Unit, { text, speed, fade }?: {
     fade?: number;
 }): void;
 
+type SynthesizerOptions = {
+    oscillator: OscillatorOptions;
+    amp: AmpOptions;
+    filter?: FilterOptions;
+    reverb?: ReverbOptions;
+    bpm?: number;
+};
+type OscillatorOptions = {
+    type: OscillatorType;
+    envelope?: Envelope;
+    LFO?: LFO;
+};
+type FilterOptions = {
+    type: BiquadFilterType;
+    cutoff: number;
+};
+type AmpOptions = {
+    envelope: Envelope;
+};
+type ReverbOptions = {
+    time: number;
+    mix: number;
+};
+type Envelope = {
+    amount: number;
+    ADSR: [number, number, number, number];
+};
+type LFO = {
+    amount: number;
+    type: OscillatorType;
+    rate: number;
+};
+declare class Synthesizer {
+    props: SynthesizerOptions;
+    constructor(props: SynthesizerOptions);
+    press(frequency: number | string, duration?: number | string, wait?: number): {
+        release: () => void;
+    } | undefined;
+}
+
 declare const basics: {
     Screen: typeof Screen;
-    Modal: any;
+    Modal: typeof Modal;
     Accordion: typeof Accordion;
     TextStream: typeof TextStream;
     AnalogStick: typeof AnalogStick;
     DirectionalPad: typeof DirectionalPad;
 };
+
+declare const audio: {
+    load(path: string): UnitPromise;
+    synthesizer(props: SynthesizerOptions): Synthesizer;
+    volume: number;
+};
 declare namespace xnew {
     type Unit = InstanceType<typeof Unit>;
 }
 declare const xnew: (typeof xnew$1) & {
     basics: typeof basics;
+    audio: typeof audio;
 };
 
 export { xnew as default };

package/dist/xnew.js

@@ -529,7 +529,7 @@
     //----------------------------------------------------------------------------------------------------
     class Unit {
         constructor(parent, ...args) {
-            var _a;
+            var _a, _b;
             let target;
             if (args[0] instanceof HTMLElement || args[0] instanceof SVGElement) {
                 target = args.shift(); // an existing html element
@@ -548,6 +548,7 @@
             }
             const component = args.shift();
             const props = args.shift();
+            const config = args.shift();
             let baseElement;
             if (target instanceof HTMLElement || target instanceof SVGElement) {
                 baseElement = target;
@@ -569,7 +570,8 @@
                 baseComponent = (unit) => { };
             }
             const baseContext = (_a = parent === null || parent === void 0 ? void 0 : parent._.currentContext) !== null && _a !== void 0 ? _a : { stack: null };
-            this._ = { parent, target, baseElement, baseContext, baseComponent, props };
+            const protect = (_b = config === null || config === void 0 ? void 0 : config.protect) !== null && _b !== void 0 ? _b : false;
+            this._ = { parent, target, baseElement, baseContext, baseComponent, props, config: { protect } };
             parent === null || parent === void 0 ? void 0 : parent._.children.push(this);
             Unit.initialize(this, null);
         }
@@ -608,7 +610,6 @@
                 anchor,
                 state: 'invoked',
                 tostart: true,
-                protected: false,
                 ancestors: [...(unit._.parent ? [unit._.parent] : []), ...((_b = (_a = unit._.parent) === null || _a === void 0 ? void 0 : _a._.ancestors) !== null && _b !== void 0 ? _b : [])],
                 children: [],
                 elements: [],
@@ -838,7 +839,7 @@
             if (type[0] === '+') {
                 (_a = Unit.type2units.get(type)) === null || _a === void 0 ? void 0 : _a.forEach((unit) => {
                     var _a;
-                    const find = [unit, ...unit._.ancestors].find(u => u._.protected === true);
+                    const find = [unit, ...unit._.ancestors].find(u => u._.config.protect === true);
                     if (find === undefined || current._.ancestors.includes(find) === true || current === find) {
                         (_a = unit._.listeners.get(type)) === null || _a === void 0 ? void 0 : _a.forEach((item) => item.execute(...args));
                     }
@@ -1157,19 +1158,12 @@
         transition(transition, duration = 0, easing = 'linear') {
             return new UnitTimer({ transition, duration, easing, iterations: 1 });
         },
-        protect() {
-            Unit.currentUnit._.protected = true;
-        }
     });
 
     function Accordion(unit, { open = false, duration = 200, easing = 'ease' } = {}) {
         xnew$1.context('xnew.accordion', unit);
-        unit.on('-transition', ({ state }) => {
-            unit.state = state;
-        });
-        xnew$1.timeout(() => {
-            xnew$1.emit('-transition', { state: open ? 1.0 : 0.0 });
-        });
+        unit.on('-transition', ({ state }) => unit.state = state);
+        xnew$1.timeout(() => xnew$1.emit('-transition', { state: open ? 1.0 : 0.0 }));
         return {
             state: open ? 1.0 : 0.0,
             toggle() {
@@ -1244,9 +1238,8 @@
         xnew$1.context('xnew.modalframe', unit);
         xnew$1.nest('<div style="position: fixed; inset: 0; z-index: 1000;">');
         unit.on('click', ({ event }) => unit.close());
-        xnew$1.transition((x) => {
-            xnew$1.emit('-transition', { state: x });
-        }, duration, easing);
+        unit.on('-transition', ({ state }) => unit.state = state);
+        xnew$1.transition((x) => xnew$1.emit('-transition', { state: x }), duration, easing);
         return {
             state: 0.0,
             close() {
@@ -1293,7 +1286,7 @@
             const d = Math.min(1.0, Math.sqrt(x * x + y * y) / (newsize / 4));
             const a = (y !== 0 || x !== 0) ? Math.atan2(y, x) : 0;
             const vector = { x: Math.cos(a) * d, y: Math.sin(a) * d };
-            target.element.style.filter = 'brightness(90%)';
+            target.element.style.filter = 'brightness(80%)';
             target.element.style.left = `${vector.x * newsize / 4}px`;
             target.element.style.top = `${vector.y * newsize / 4}px`;
             const nexttype = { dragstart: '-down', dragmove: '-move' }[type];
@@ -1357,10 +1350,10 @@
                 vector.x = 0;
                 vector.y = Math.abs(vector.y) > 0.5 ? Math.sign(vector.y) : 0;
             }
-            targets[0].element.style.filter = (vector.y < 0) ? 'brightness(90%)' : '';
-            targets[1].element.style.filter = (vector.y > 0) ? 'brightness(90%)' : '';
-            targets[2].element.style.filter = (vector.x < 0) ? 'brightness(90%)' : '';
-            targets[3].element.style.filter = (vector.x > 0) ? 'brightness(90%)' : '';
+            targets[0].element.style.filter = (vector.y < 0) ? 'brightness(80%)' : '';
+            targets[1].element.style.filter = (vector.y > 0) ? 'brightness(80%)' : '';
+            targets[2].element.style.filter = (vector.x < 0) ? 'brightness(80%)' : '';
+            targets[3].element.style.filter = (vector.x > 0) ? 'brightness(80%)' : '';
             const nexttype = { dragstart: '-down', dragmove: '-move' }[type];
             xnew$1.emit(nexttype, { type: nexttype, vector });
         });
@@ -1419,6 +1412,230 @@
         }
     }
 
+    const context = new window.AudioContext();
+    const master = context.createGain();
+    //----------------------------------------------------------------------------------------------------
+    // master volume
+    //----------------------------------------------------------------------------------------------------
+    master.gain.value = 0.1;
+    master.connect(context.destination);
+    //----------------------------------------------------------------------------------------------------
+    // audio file
+    //----------------------------------------------------------------------------------------------------
+    class AudioFile {
+        constructor(path) {
+            this.promise = fetch(path)
+                .then((response) => response.arrayBuffer())
+                .then((response) => context.decodeAudioData(response))
+                .then((response) => { this.buffer = response; })
+                .catch(() => {
+                console.warn(`"${path}" could not be loaded.`);
+            });
+            this.amp = context.createGain();
+            this.amp.gain.value = 1.0;
+            this.amp.connect(master);
+            this.fade = context.createGain();
+            this.fade.gain.value = 1.0;
+            this.fade.connect(this.amp);
+            this.source = null;
+            this.start = null;
+        }
+        set volume(value) {
+            this.amp.gain.value = value;
+        }
+        get volume() {
+            return this.amp.gain.value;
+        }
+        play({ offset = 0, fade = 0, loop = false } = {}) {
+            if (this.buffer !== undefined && this.start === null) {
+                this.source = context.createBufferSource();
+                this.source.buffer = this.buffer;
+                this.source.loop = loop;
+                this.source.connect(this.fade);
+                this.start = context.currentTime;
+                this.source.playbackRate.value = 1;
+                this.source.start(context.currentTime, offset / 1000);
+                // Apply fade-in effect if fade duration is specified
+                if (fade > 0) {
+                    this.fade.gain.setValueAtTime(0, context.currentTime);
+                    this.fade.gain.linearRampToValueAtTime(1.0, context.currentTime + fade / 1000);
+                }
+                this.source.onended = () => {
+                    var _a;
+                    this.start = null;
+                    (_a = this.source) === null || _a === void 0 ? void 0 : _a.disconnect();
+                    this.source = null;
+                };
+            }
+        }
+        pause({ fade = 0 } = {}) {
+            var _a, _b;
+            if (this.buffer !== undefined && this.start !== null) {
+                const elapsed = (context.currentTime - this.start) % this.buffer.duration * 1000;
+                // Apply fade-out effect if fade duration is specified
+                if (fade > 0) {
+                    this.fade.gain.setValueAtTime(1.0, context.currentTime);
+                    this.fade.gain.linearRampToValueAtTime(0, context.currentTime + fade / 1000);
+                    (_a = this.source) === null || _a === void 0 ? void 0 : _a.stop(context.currentTime + fade / 1000);
+                }
+                else {
+                    (_b = this.source) === null || _b === void 0 ? void 0 : _b.stop(context.currentTime);
+                }
+                this.start = null;
+                return elapsed;
+            }
+        }
+        clear() {
+            var _a;
+            this.amp.disconnect();
+            this.fade.disconnect();
+            (_a = this.source) === null || _a === void 0 ? void 0 : _a.disconnect();
+        }
+    }
+    const keymap = {
+        'A0': 27.500, 'A#0': 29.135, 'B0': 30.868,
+        'C1': 32.703, 'C#1': 34.648, 'D1': 36.708, 'D#1': 38.891, 'E1': 41.203, 'F1': 43.654, 'F#1': 46.249, 'G1': 48.999, 'G#1': 51.913, 'A1': 55.000, 'A#1': 58.270, 'B1': 61.735,
+        'C2': 65.406, 'C#2': 69.296, 'D2': 73.416, 'D#2': 77.782, 'E2': 82.407, 'F2': 87.307, 'F#2': 92.499, 'G2': 97.999, 'G#2': 103.826, 'A2': 110.000, 'A#2': 116.541, 'B2': 123.471,
+        'C3': 130.813, 'C#3': 138.591, 'D3': 146.832, 'D#3': 155.563, 'E3': 164.814, 'F3': 174.614, 'F#3': 184.997, 'G3': 195.998, 'G#3': 207.652, 'A3': 220.000, 'A#3': 233.082, 'B3': 246.942,
+        'C4': 261.626, 'C#4': 277.183, 'D4': 293.665, 'D#4': 311.127, 'E4': 329.628, 'F4': 349.228, 'F#4': 369.994, 'G4': 391.995, 'G#4': 415.305, 'A4': 440.000, 'A#4': 466.164, 'B4': 493.883,
+        'C5': 523.251, 'C#5': 554.365, 'D5': 587.330, 'D#5': 622.254, 'E5': 659.255, 'F5': 698.456, 'F#5': 739.989, 'G5': 783.991, 'G#5': 830.609, 'A5': 880.000, 'A#5': 932.328, 'B5': 987.767,
+        'C6': 1046.502, 'C#6': 1108.731, 'D6': 1174.659, 'D#6': 1244.508, 'E6': 1318.510, 'F6': 1396.913, 'F#6': 1479.978, 'G6': 1567.982, 'G#6': 1661.219, 'A6': 1760.000, 'A#6': 1864.655, 'B6': 1975.533,
+        'C7': 2093.005, 'C#7': 2217.461, 'D7': 2349.318, 'D#7': 2489.016, 'E7': 2637.020, 'F7': 2793.826, 'F#7': 2959.955, 'G7': 3135.963, 'G#7': 3322.438, 'A7': 3520.000, 'A#7': 3729.310, 'B7': 3951.066,
+        'C8': 4186.009,
+    };
+    const notemap = {
+        '1m': 4.000, '2n': 2.000, '4n': 1.000, '8n': 0.500, '16n': 0.250, '32n': 0.125,
+    };
+    class Synthesizer {
+        constructor(props) { this.props = props; }
+        press(frequency, duration, wait) {
+            var _a;
+            const props = this.props;
+            const fv = typeof frequency === 'string' ? keymap[frequency] : frequency;
+            const dv = typeof duration === 'string' ? (notemap[duration] * 60 / ((_a = props.bpm) !== null && _a !== void 0 ? _a : 120)) : (typeof duration === 'number' ? (duration / 1000) : 0);
+            const start = context.currentTime + (wait !== null && wait !== void 0 ? wait : 0) / 1000;
+            const nodes = {};
+            nodes.oscillator = context.createOscillator();
+            nodes.oscillator.type = props.oscillator.type;
+            nodes.oscillator.frequency.value = fv;
+            if (props.oscillator.LFO) {
+                nodes.oscillatorLFO = context.createOscillator();
+                nodes.oscillatorLFODepth = context.createGain();
+                nodes.oscillatorLFODepth.gain.value = fv * (Math.pow(2.0, props.oscillator.LFO.amount / 12.0) - 1.0);
+                nodes.oscillatorLFO.type = props.oscillator.LFO.type;
+                nodes.oscillatorLFO.frequency.value = props.oscillator.LFO.rate;
+                nodes.oscillatorLFO.start(start);
+                nodes.oscillatorLFO.connect(nodes.oscillatorLFODepth);
+                nodes.oscillatorLFODepth.connect(nodes.oscillator.frequency);
+            }
+            nodes.amp = context.createGain();
+            nodes.amp.gain.value = 0.0;
+            nodes.target = context.createGain();
+            nodes.target.gain.value = 1.0;
+            nodes.amp.connect(nodes.target);
+            nodes.target.connect(master);
+            if (props.filter) {
+                nodes.filter = context.createBiquadFilter();
+                nodes.filter.type = props.filter.type;
+                nodes.filter.frequency.value = props.filter.cutoff;
+                nodes.oscillator.connect(nodes.filter);
+                nodes.filter.connect(nodes.amp);
+            }
+            else {
+                nodes.oscillator.connect(nodes.amp);
+            }
+            if (props.reverb) {
+                nodes.convolver = context.createConvolver();
+                nodes.convolver.buffer = impulseResponse({ time: props.reverb.time });
+                nodes.convolverDepth = context.createGain();
+                nodes.convolverDepth.gain.value = 1.0;
+                nodes.convolverDepth.gain.value *= props.reverb.mix;
+                nodes.target.gain.value *= (1.0 - props.reverb.mix);
+                nodes.amp.connect(nodes.convolver);
+                nodes.convolver.connect(nodes.convolverDepth);
+                nodes.convolverDepth.connect(master);
+            }
+            if (props.oscillator.envelope) {
+                const amount = fv * (Math.pow(2.0, props.oscillator.envelope.amount / 12.0) - 1.0);
+                startEnvelope(nodes.oscillator.frequency, fv, amount, props.oscillator.envelope.ADSR);
+            }
+            if (props.amp.envelope) {
+                startEnvelope(nodes.amp.gain, 0.0, props.amp.envelope.amount, props.amp.envelope.ADSR);
+            }
+            nodes.oscillator.start(start);
+            if (dv > 0) {
+                release();
+            }
+            else {
+                return { release };
+            }
+            function release() {
+                let stop = null;
+                const end = dv > 0 ? dv : (context.currentTime - start);
+                if (props.amp.envelope) {
+                    const ADSR = props.amp.envelope.ADSR;
+                    const adsr = [ADSR[0] / 1000, ADSR[1] / 1000, ADSR[2], ADSR[3] / 1000];
+                    const rate = adsr[0] === 0.0 ? 1.0 : Math.min(end / (adsr[0] + 0.001), 1.0);
+                    stop = start + Math.max((adsr[0] + adsr[1]) * rate, end) + adsr[3];
+                }
+                else {
+                    stop = start + end;
+                }
+                if (nodes.oscillatorLFO) {
+                    nodes.oscillatorLFO.stop(stop);
+                }
+                if (props.oscillator.envelope) {
+                    const amount = fv * (Math.pow(2.0, props.oscillator.envelope.amount / 12.0) - 1.0);
+                    stopEnvelope(nodes.oscillator.frequency, fv, amount, props.oscillator.envelope.ADSR);
+                }
+                if (props.amp.envelope) {
+                    stopEnvelope(nodes.amp.gain, 0.0, props.amp.envelope.amount, props.amp.envelope.ADSR);
+                }
+                nodes.oscillator.stop(stop);
+                setTimeout(() => {
+                    var _a, _b, _c, _d, _e;
+                    nodes.oscillator.disconnect();
+                    nodes.amp.disconnect();
+                    nodes.target.disconnect();
+                    (_a = nodes.oscillatorLFO) === null || _a === void 0 ? void 0 : _a.disconnect();
+                    (_b = nodes.oscillatorLFODepth) === null || _b === void 0 ? void 0 : _b.disconnect();
+                    (_c = nodes.filter) === null || _c === void 0 ? void 0 : _c.disconnect();
+                    (_d = nodes.convolver) === null || _d === void 0 ? void 0 : _d.disconnect();
+                    (_e = nodes.convolverDepth) === null || _e === void 0 ? void 0 : _e.disconnect();
+                }, 2000);
+            }
+            function stopEnvelope(param, base, amount, ADSR) {
+                const end = dv > 0 ? dv : (context.currentTime - start);
+                const rate = ADSR[0] === 0.0 ? 1.0 : Math.min(end / (ADSR[0] / 1000), 1.0);
+                if (rate < 1.0) {
+                    param.cancelScheduledValues(start);
+                    param.setValueAtTime(base, start);
+                    param.linearRampToValueAtTime(base + amount * rate, start + ADSR[0] / 1000 * rate);
+                    param.linearRampToValueAtTime(base + amount * rate * ADSR[2], start + (ADSR[0] + ADSR[1]) / 1000 * rate);
+                }
+                param.linearRampToValueAtTime(base + amount * rate * ADSR[2], start + Math.max((ADSR[0] + ADSR[1]) / 1000 * rate, dv));
+                param.linearRampToValueAtTime(base, start + Math.max((ADSR[0] + ADSR[1]) / 1000 * rate, end) + ADSR[3] / 1000);
+            }
+            function startEnvelope(param, base, amount, ADSR) {
+                param.value = base;
+                param.setValueAtTime(base, start);
+                param.linearRampToValueAtTime(base + amount, start + ADSR[0] / 1000);
+                param.linearRampToValueAtTime(base + amount * ADSR[2], start + (ADSR[0] + ADSR[1]) / 1000);
+            }
+            function impulseResponse({ time, decay = 2.0 }) {
+                const length = context.sampleRate * time / 1000;
+                const impulse = context.createBuffer(2, length, context.sampleRate);
+                const ch0 = impulse.getChannelData(0);
+                const ch1 = impulse.getChannelData(1);
+                for (let i = 0; i < length; i++) {
+                    ch0[i] = (2 * Math.random() - 1) * Math.pow(1 - i / length, decay);
+                    ch1[i] = (2 * Math.random() - 1) * Math.pow(1 - i / length, decay);
+                }
+                return impulse;
+            }
+        }
+    }
+
     const basics = {
         Screen,
         Modal,
@@ -1427,7 +1644,34 @@
         AnalogStick,
         DirectionalPad,
     };
-    const xnew = Object.assign(xnew$1, { basics });
+    const audio = {
+        load(path) {
+            const music = new AudioFile(path);
+            const object = {
+                play(options = {}) {
+                    const unit = xnew();
+                    if (music.start === null) {
+                        music.play(options);
+                        unit.on('finalize', () => music.pause({ fade: options.fade }));
+                    }
+                },
+                pause(options = {}) {
+                    music.pause(options);
+                }
+            };
+            return xnew.promise(music.promise).then(() => object);
+        },
+        synthesizer(props) {
+            return new Synthesizer(props);
+        },
+        get volume() {
+            return master.gain.value;
+        },
+        set volume(value) {
+            master.gain.value = value;
+        }
+    };
+    const xnew = Object.assign(xnew$1, { basics, audio });
 
     return xnew;
 

package/dist/xnew.mjs

@@ -523,7 +523,7 @@ function pointer(element, event) {
 //----------------------------------------------------------------------------------------------------
 class Unit {
     constructor(parent, ...args) {
-        var _a;
+        var _a, _b;
         let target;
         if (args[0] instanceof HTMLElement || args[0] instanceof SVGElement) {
             target = args.shift(); // an existing html element
@@ -542,6 +542,7 @@ class Unit {
         }
         const component = args.shift();
         const props = args.shift();
+        const config = args.shift();
         let baseElement;
         if (target instanceof HTMLElement || target instanceof SVGElement) {
             baseElement = target;
@@ -563,7 +564,8 @@ class Unit {
             baseComponent = (unit) => { };
         }
         const baseContext = (_a = parent === null || parent === void 0 ? void 0 : parent._.currentContext) !== null && _a !== void 0 ? _a : { stack: null };
-        this._ = { parent, target, baseElement, baseContext, baseComponent, props };
+        const protect = (_b = config === null || config === void 0 ? void 0 : config.protect) !== null && _b !== void 0 ? _b : false;
+        this._ = { parent, target, baseElement, baseContext, baseComponent, props, config: { protect } };
         parent === null || parent === void 0 ? void 0 : parent._.children.push(this);
         Unit.initialize(this, null);
     }
@@ -602,7 +604,6 @@ class Unit {
             anchor,
             state: 'invoked',
             tostart: true,
-            protected: false,
             ancestors: [...(unit._.parent ? [unit._.parent] : []), ...((_b = (_a = unit._.parent) === null || _a === void 0 ? void 0 : _a._.ancestors) !== null && _b !== void 0 ? _b : [])],
             children: [],
             elements: [],
@@ -832,7 +833,7 @@ class Unit {
         if (type[0] === '+') {
             (_a = Unit.type2units.get(type)) === null || _a === void 0 ? void 0 : _a.forEach((unit) => {
                 var _a;
-                const find = [unit, ...unit._.ancestors].find(u => u._.protected === true);
+                const find = [unit, ...unit._.ancestors].find(u => u._.config.protect === true);
                 if (find === undefined || current._.ancestors.includes(find) === true || current === find) {
                     (_a = unit._.listeners.get(type)) === null || _a === void 0 ? void 0 : _a.forEach((item) => item.execute(...args));
                 }
@@ -1151,19 +1152,12 @@ const xnew$1 = Object.assign(function (...args) {
     transition(transition, duration = 0, easing = 'linear') {
         return new UnitTimer({ transition, duration, easing, iterations: 1 });
     },
-    protect() {
-        Unit.currentUnit._.protected = true;
-    }
 });
 
 function Accordion(unit, { open = false, duration = 200, easing = 'ease' } = {}) {
     xnew$1.context('xnew.accordion', unit);
-    unit.on('-transition', ({ state }) => {
-        unit.state = state;
-    });
-    xnew$1.timeout(() => {
-        xnew$1.emit('-transition', { state: open ? 1.0 : 0.0 });
-    });
+    unit.on('-transition', ({ state }) => unit.state = state);
+    xnew$1.timeout(() => xnew$1.emit('-transition', { state: open ? 1.0 : 0.0 }));
     return {
         state: open ? 1.0 : 0.0,
         toggle() {
@@ -1238,9 +1232,8 @@ function Modal(unit, { duration = 200, easing = 'ease' } = {}) {
     xnew$1.context('xnew.modalframe', unit);
     xnew$1.nest('<div style="position: fixed; inset: 0; z-index: 1000;">');
     unit.on('click', ({ event }) => unit.close());
-    xnew$1.transition((x) => {
-        xnew$1.emit('-transition', { state: x });
-    }, duration, easing);
+    unit.on('-transition', ({ state }) => unit.state = state);
+    xnew$1.transition((x) => xnew$1.emit('-transition', { state: x }), duration, easing);
     return {
         state: 0.0,
         close() {
@@ -1287,7 +1280,7 @@ function AnalogStick(unit, { stroke = 'currentColor', strokeOpacity = 0.8, strok
         const d = Math.min(1.0, Math.sqrt(x * x + y * y) / (newsize / 4));
         const a = (y !== 0 || x !== 0) ? Math.atan2(y, x) : 0;
         const vector = { x: Math.cos(a) * d, y: Math.sin(a) * d };
-        target.element.style.filter = 'brightness(90%)';
+        target.element.style.filter = 'brightness(80%)';
         target.element.style.left = `${vector.x * newsize / 4}px`;
         target.element.style.top = `${vector.y * newsize / 4}px`;
         const nexttype = { dragstart: '-down', dragmove: '-move' }[type];
@@ -1351,10 +1344,10 @@ function DirectionalPad(unit, { diagonal = true, stroke = 'currentColor', stroke
             vector.x = 0;
             vector.y = Math.abs(vector.y) > 0.5 ? Math.sign(vector.y) : 0;
         }
-        targets[0].element.style.filter = (vector.y < 0) ? 'brightness(90%)' : '';
-        targets[1].element.style.filter = (vector.y > 0) ? 'brightness(90%)' : '';
-        targets[2].element.style.filter = (vector.x < 0) ? 'brightness(90%)' : '';
-        targets[3].element.style.filter = (vector.x > 0) ? 'brightness(90%)' : '';
+        targets[0].element.style.filter = (vector.y < 0) ? 'brightness(80%)' : '';
+        targets[1].element.style.filter = (vector.y > 0) ? 'brightness(80%)' : '';
+        targets[2].element.style.filter = (vector.x < 0) ? 'brightness(80%)' : '';
+        targets[3].element.style.filter = (vector.x > 0) ? 'brightness(80%)' : '';
         const nexttype = { dragstart: '-down', dragmove: '-move' }[type];
         xnew$1.emit(nexttype, { type: nexttype, vector });
     });
@@ -1413,6 +1406,230 @@ function TextStream(unit, { text = '', speed = 50, fade = 300 } = {}) {
     }
 }
 
+const context = new window.AudioContext();
+const master = context.createGain();
+//----------------------------------------------------------------------------------------------------
+// master volume
+//----------------------------------------------------------------------------------------------------
+master.gain.value = 0.1;
+master.connect(context.destination);
+//----------------------------------------------------------------------------------------------------
+// audio file
+//----------------------------------------------------------------------------------------------------
+class AudioFile {
+    constructor(path) {
+        this.promise = fetch(path)
+            .then((response) => response.arrayBuffer())
+            .then((response) => context.decodeAudioData(response))
+            .then((response) => { this.buffer = response; })
+            .catch(() => {
+            console.warn(`"${path}" could not be loaded.`);
+        });
+        this.amp = context.createGain();
+        this.amp.gain.value = 1.0;
+        this.amp.connect(master);
+        this.fade = context.createGain();
+        this.fade.gain.value = 1.0;
+        this.fade.connect(this.amp);
+        this.source = null;
+        this.start = null;
+    }
+    set volume(value) {
+        this.amp.gain.value = value;
+    }
+    get volume() {
+        return this.amp.gain.value;
+    }
+    play({ offset = 0, fade = 0, loop = false } = {}) {
+        if (this.buffer !== undefined && this.start === null) {
+            this.source = context.createBufferSource();
+            this.source.buffer = this.buffer;
+            this.source.loop = loop;
+            this.source.connect(this.fade);
+            this.start = context.currentTime;
+            this.source.playbackRate.value = 1;
+            this.source.start(context.currentTime, offset / 1000);
+            // Apply fade-in effect if fade duration is specified
+            if (fade > 0) {
+                this.fade.gain.setValueAtTime(0, context.currentTime);
+                this.fade.gain.linearRampToValueAtTime(1.0, context.currentTime + fade / 1000);
+            }
+            this.source.onended = () => {
+                var _a;
+                this.start = null;
+                (_a = this.source) === null || _a === void 0 ? void 0 : _a.disconnect();
+                this.source = null;
+            };
+        }
+    }
+    pause({ fade = 0 } = {}) {
+        var _a, _b;
+        if (this.buffer !== undefined && this.start !== null) {
+            const elapsed = (context.currentTime - this.start) % this.buffer.duration * 1000;
+            // Apply fade-out effect if fade duration is specified
+            if (fade > 0) {
+                this.fade.gain.setValueAtTime(1.0, context.currentTime);
+                this.fade.gain.linearRampToValueAtTime(0, context.currentTime + fade / 1000);
+                (_a = this.source) === null || _a === void 0 ? void 0 : _a.stop(context.currentTime + fade / 1000);
+            }
+            else {
+                (_b = this.source) === null || _b === void 0 ? void 0 : _b.stop(context.currentTime);
+            }
+            this.start = null;
+            return elapsed;
+        }
+    }
+    clear() {
+        var _a;
+        this.amp.disconnect();
+        this.fade.disconnect();
+        (_a = this.source) === null || _a === void 0 ? void 0 : _a.disconnect();
+    }
+}
+const keymap = {
+    'A0': 27.500, 'A#0': 29.135, 'B0': 30.868,
+    'C1': 32.703, 'C#1': 34.648, 'D1': 36.708, 'D#1': 38.891, 'E1': 41.203, 'F1': 43.654, 'F#1': 46.249, 'G1': 48.999, 'G#1': 51.913, 'A1': 55.000, 'A#1': 58.270, 'B1': 61.735,
+    'C2': 65.406, 'C#2': 69.296, 'D2': 73.416, 'D#2': 77.782, 'E2': 82.407, 'F2': 87.307, 'F#2': 92.499, 'G2': 97.999, 'G#2': 103.826, 'A2': 110.000, 'A#2': 116.541, 'B2': 123.471,
+    'C3': 130.813, 'C#3': 138.591, 'D3': 146.832, 'D#3': 155.563, 'E3': 164.814, 'F3': 174.614, 'F#3': 184.997, 'G3': 195.998, 'G#3': 207.652, 'A3': 220.000, 'A#3': 233.082, 'B3': 246.942,
+    'C4': 261.626, 'C#4': 277.183, 'D4': 293.665, 'D#4': 311.127, 'E4': 329.628, 'F4': 349.228, 'F#4': 369.994, 'G4': 391.995, 'G#4': 415.305, 'A4': 440.000, 'A#4': 466.164, 'B4': 493.883,
+    'C5': 523.251, 'C#5': 554.365, 'D5': 587.330, 'D#5': 622.254, 'E5': 659.255, 'F5': 698.456, 'F#5': 739.989, 'G5': 783.991, 'G#5': 830.609, 'A5': 880.000, 'A#5': 932.328, 'B5': 987.767,
+    'C6': 1046.502, 'C#6': 1108.731, 'D6': 1174.659, 'D#6': 1244.508, 'E6': 1318.510, 'F6': 1396.913, 'F#6': 1479.978, 'G6': 1567.982, 'G#6': 1661.219, 'A6': 1760.000, 'A#6': 1864.655, 'B6': 1975.533,
+    'C7': 2093.005, 'C#7': 2217.461, 'D7': 2349.318, 'D#7': 2489.016, 'E7': 2637.020, 'F7': 2793.826, 'F#7': 2959.955, 'G7': 3135.963, 'G#7': 3322.438, 'A7': 3520.000, 'A#7': 3729.310, 'B7': 3951.066,
+    'C8': 4186.009,
+};
+const notemap = {
+    '1m': 4.000, '2n': 2.000, '4n': 1.000, '8n': 0.500, '16n': 0.250, '32n': 0.125,
+};
+class Synthesizer {
+    constructor(props) { this.props = props; }
+    press(frequency, duration, wait) {
+        var _a;
+        const props = this.props;
+        const fv = typeof frequency === 'string' ? keymap[frequency] : frequency;
+        const dv = typeof duration === 'string' ? (notemap[duration] * 60 / ((_a = props.bpm) !== null && _a !== void 0 ? _a : 120)) : (typeof duration === 'number' ? (duration / 1000) : 0);
+        const start = context.currentTime + (wait !== null && wait !== void 0 ? wait : 0) / 1000;
+        const nodes = {};
+        nodes.oscillator = context.createOscillator();
+        nodes.oscillator.type = props.oscillator.type;
+        nodes.oscillator.frequency.value = fv;
+        if (props.oscillator.LFO) {
+            nodes.oscillatorLFO = context.createOscillator();
+            nodes.oscillatorLFODepth = context.createGain();
+            nodes.oscillatorLFODepth.gain.value = fv * (Math.pow(2.0, props.oscillator.LFO.amount / 12.0) - 1.0);
+            nodes.oscillatorLFO.type = props.oscillator.LFO.type;
+            nodes.oscillatorLFO.frequency.value = props.oscillator.LFO.rate;
+            nodes.oscillatorLFO.start(start);
+            nodes.oscillatorLFO.connect(nodes.oscillatorLFODepth);
+            nodes.oscillatorLFODepth.connect(nodes.oscillator.frequency);
+        }
+        nodes.amp = context.createGain();
+        nodes.amp.gain.value = 0.0;
+        nodes.target = context.createGain();
+        nodes.target.gain.value = 1.0;
+        nodes.amp.connect(nodes.target);
+        nodes.target.connect(master);
+        if (props.filter) {
+            nodes.filter = context.createBiquadFilter();
+            nodes.filter.type = props.filter.type;
+            nodes.filter.frequency.value = props.filter.cutoff;
+            nodes.oscillator.connect(nodes.filter);
+            nodes.filter.connect(nodes.amp);
+        }
+        else {
+            nodes.oscillator.connect(nodes.amp);
+        }
+        if (props.reverb) {
+            nodes.convolver = context.createConvolver();
+            nodes.convolver.buffer = impulseResponse({ time: props.reverb.time });
+            nodes.convolverDepth = context.createGain();
+            nodes.convolverDepth.gain.value = 1.0;
+            nodes.convolverDepth.gain.value *= props.reverb.mix;
+            nodes.target.gain.value *= (1.0 - props.reverb.mix);
+            nodes.amp.connect(nodes.convolver);
+            nodes.convolver.connect(nodes.convolverDepth);
+            nodes.convolverDepth.connect(master);
+        }
+        if (props.oscillator.envelope) {
+            const amount = fv * (Math.pow(2.0, props.oscillator.envelope.amount / 12.0) - 1.0);
+            startEnvelope(nodes.oscillator.frequency, fv, amount, props.oscillator.envelope.ADSR);
+        }
+        if (props.amp.envelope) {
+            startEnvelope(nodes.amp.gain, 0.0, props.amp.envelope.amount, props.amp.envelope.ADSR);
+        }
+        nodes.oscillator.start(start);
+        if (dv > 0) {
+            release();
+        }
+        else {
+            return { release };
+        }
+        function release() {
+            let stop = null;
+            const end = dv > 0 ? dv : (context.currentTime - start);
+            if (props.amp.envelope) {
+                const ADSR = props.amp.envelope.ADSR;
+                const adsr = [ADSR[0] / 1000, ADSR[1] / 1000, ADSR[2], ADSR[3] / 1000];
+                const rate = adsr[0] === 0.0 ? 1.0 : Math.min(end / (adsr[0] + 0.001), 1.0);
+                stop = start + Math.max((adsr[0] + adsr[1]) * rate, end) + adsr[3];
+            }
+            else {
+                stop = start + end;
+            }
+            if (nodes.oscillatorLFO) {
+                nodes.oscillatorLFO.stop(stop);
+            }
+            if (props.oscillator.envelope) {
+                const amount = fv * (Math.pow(2.0, props.oscillator.envelope.amount / 12.0) - 1.0);
+                stopEnvelope(nodes.oscillator.frequency, fv, amount, props.oscillator.envelope.ADSR);
+            }
+            if (props.amp.envelope) {
+                stopEnvelope(nodes.amp.gain, 0.0, props.amp.envelope.amount, props.amp.envelope.ADSR);
+            }
+            nodes.oscillator.stop(stop);
+            setTimeout(() => {
+                var _a, _b, _c, _d, _e;
+                nodes.oscillator.disconnect();
+                nodes.amp.disconnect();
+                nodes.target.disconnect();
+                (_a = nodes.oscillatorLFO) === null || _a === void 0 ? void 0 : _a.disconnect();
+                (_b = nodes.oscillatorLFODepth) === null || _b === void 0 ? void 0 : _b.disconnect();
+                (_c = nodes.filter) === null || _c === void 0 ? void 0 : _c.disconnect();
+                (_d = nodes.convolver) === null || _d === void 0 ? void 0 : _d.disconnect();
+                (_e = nodes.convolverDepth) === null || _e === void 0 ? void 0 : _e.disconnect();
+            }, 2000);
+        }
+        function stopEnvelope(param, base, amount, ADSR) {
+            const end = dv > 0 ? dv : (context.currentTime - start);
+            const rate = ADSR[0] === 0.0 ? 1.0 : Math.min(end / (ADSR[0] / 1000), 1.0);
+            if (rate < 1.0) {
+                param.cancelScheduledValues(start);
+                param.setValueAtTime(base, start);
+                param.linearRampToValueAtTime(base + amount * rate, start + ADSR[0] / 1000 * rate);
+                param.linearRampToValueAtTime(base + amount * rate * ADSR[2], start + (ADSR[0] + ADSR[1]) / 1000 * rate);
+            }
+            param.linearRampToValueAtTime(base + amount * rate * ADSR[2], start + Math.max((ADSR[0] + ADSR[1]) / 1000 * rate, dv));
+            param.linearRampToValueAtTime(base, start + Math.max((ADSR[0] + ADSR[1]) / 1000 * rate, end) + ADSR[3] / 1000);
+        }
+        function startEnvelope(param, base, amount, ADSR) {
+            param.value = base;
+            param.setValueAtTime(base, start);
+            param.linearRampToValueAtTime(base + amount, start + ADSR[0] / 1000);
+            param.linearRampToValueAtTime(base + amount * ADSR[2], start + (ADSR[0] + ADSR[1]) / 1000);
+        }
+        function impulseResponse({ time, decay = 2.0 }) {
+            const length = context.sampleRate * time / 1000;
+            const impulse = context.createBuffer(2, length, context.sampleRate);
+            const ch0 = impulse.getChannelData(0);
+            const ch1 = impulse.getChannelData(1);
+            for (let i = 0; i < length; i++) {
+                ch0[i] = (2 * Math.random() - 1) * Math.pow(1 - i / length, decay);
+                ch1[i] = (2 * Math.random() - 1) * Math.pow(1 - i / length, decay);
+            }
+            return impulse;
+        }
+    }
+}
+
 const basics = {
     Screen,
     Modal,
@@ -1421,6 +1638,33 @@ const basics = {
     AnalogStick,
     DirectionalPad,
 };
-const xnew = Object.assign(xnew$1, { basics });
+const audio = {
+    load(path) {
+        const music = new AudioFile(path);
+        const object = {
+            play(options = {}) {
+                const unit = xnew();
+                if (music.start === null) {
+                    music.play(options);
+                    unit.on('finalize', () => music.pause({ fade: options.fade }));
+                }
+            },
+            pause(options = {}) {
+                music.pause(options);
+            }
+        };
+        return xnew.promise(music.promise).then(() => object);
+    },
+    synthesizer(props) {
+        return new Synthesizer(props);
+    },
+    get volume() {
+        return master.gain.value;
+    },
+    set volume(value) {
+        master.gain.value = value;
+    }
+};
+const xnew = Object.assign(xnew$1, { basics, audio });
 
 export { xnew as default };

package/package.json

@@ -4,7 +4,7 @@
   "keywords": [
     "Component-Oriented Programming"
   ],
-  "version": "0.4.5",
+  "version": "0.4.6",
   "main": "dist/xnew.js",
   "module": "dist/xnew.mjs",
   "types": "dist/xnew.d.ts",