@tiny-codes/react-easy 1.4.9 → 1.4.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +30 -0
- package/es/hooks/useUserMedia.d.ts +11 -4
- package/es/hooks/useUserMedia.js +10 -8
- package/es/hooks/useUserMedia.js.map +1 -1
- package/es/utils/AudioPlayer.d.ts +32 -25
- package/es/utils/AudioPlayer.js +103 -79
- package/es/utils/AudioPlayer.js.map +1 -1
- package/es/utils/stream.d.ts +17 -10
- package/es/utils/stream.js +13 -5
- package/es/utils/stream.js.map +1 -1
- package/lib/hooks/useUserMedia.d.ts +11 -4
- package/lib/hooks/useUserMedia.js +9 -7
- package/lib/hooks/useUserMedia.js.map +2 -2
- package/lib/utils/AudioPlayer.d.ts +32 -25
- package/lib/utils/AudioPlayer.js +81 -60
- package/lib/utils/AudioPlayer.js.map +2 -2
- package/lib/utils/stream.d.ts +17 -10
- package/lib/utils/stream.js +9 -4
- package/lib/utils/stream.js.map +2 -2
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/utils/AudioPlayer.ts"],
|
|
4
|
-
"sourcesContent": ["export type AudioSource = string | ReadableStreamDefaultReader<Uint8Array
|
|
5
|
-
"mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8CA,IAAM,cAAN,MAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBhB,YAAY,SAA2B;AAbvC,SAAQ,eAAoC;AAC5C,SAAQ,WAA4B;AACpC,SAAQ,aAAiD;
|
|
4
|
+
"sourcesContent": ["export type AudioSource = string | ReadableStreamDefaultReader<Uint8Array> | ArrayBuffer | Uint8Array | Blob;\n\nexport interface AudioPlayerInit {\n /**\n * - **EN:** Audio source (URL or streaming data)\n * - **CN:** 音频源（URL或流数据）\n */\n source?: AudioSource | (() => AudioSource | Promise<AudioSource>);\n /**\n * - **EN:** Initial volume level (0-1). Default is `0.5`\n * - **CN:** 初始音量级别（0-1）。默认值为`0.5`\n */\n volume?: number;\n /**\n * - **EN:** Callback when audio starts playing\n * - **CN:** 音频开始播放时的回调\n */\n onPlay?: () => void;\n /**\n * - **EN:** Callback when audio is paused\n * - **CN:** 音频暂停时的回调\n */\n onPause?: () => void;\n /**\n * - **EN:** Callback when audio is stopped\n * - **CN:** 音频停止时的回调\n */\n onStop?: () => void;\n\n /**\n * - **EN:** Callback when audio playback ends\n * - **CN:** 音频播放结束时的回调\n */\n onPlayEnd?: () => void;\n /**\n * - **EN:** Callback when an error occurs\n * - **CN:** 发生错误时的回调\n */\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n onError?: (error: any) => void;\n}\n\n/**\n * - **EN:** An audio player class that supports URL or streaming data input\n * - **CN:** 一个音频播放器类，支持URL或流数据输入\n */\nclass AudioPlayer {\n private audio: HTMLAudioElement;\n private _volume: number;\n private audioContext: AudioContext | null = null;\n private gainNode: GainNode | null = null;\n private sourceNode: MediaElementAudioSourceNode | null = null;\n private options: AudioPlayerInit | undefined;\n private onPlayEnd: () => void;\n\n /**\n * - **EN:** Creates an audio player instance\n * - **CN:** 创建音频播放器实例\n *\n * @param source - can be a URL string or ReadableStreamDefaultReader |\n * 可以是URL字符串或ReadableStreamDefaultReader\n */\n constructor(options?: AudioPlayerInit) {\n const { source, volume } = options || {};\n this.options = options;\n this.audio = new Audio();\n this._volume = volume != null ? Math.min(1.0, Math.max(0, volume)) : 0.5; // Default volume 50%\n this.audio.volume = this._volume;\n if (typeof source === 'function') {\n const result = source();\n if (typeof result === 'object' && 'then' in result && typeof result.then === 'function') {\n result.then((data) => this.setAudioSource(data));\n } else {\n this.setAudioSource(result as AudioSource);\n }\n } else {\n this.setAudioSource(source);\n }\n this.onPlayEnd = () => {\n this.options?.onPlayEnd?.();\n };\n this.addEventListener('ended', this.onPlayEnd);\n }\n\n /**\n * - **EN:** Check if audio is currently playing\n * - **CN:** 检查音频是否正在播放\n */\n public get isPlaying() {\n return this.audioContext?.state === 'running';\n }\n /**\n * - **EN:** Get current playback time (seconds)\n * - **CN:** 获取当前播放时间(秒)\n */\n get currentTime(): number {\n return this.audio.currentTime;\n }\n /**\n * - **EN:** Get total audio duration (seconds)\n * - **CN:** 获取音频总时长(秒)\n */\n get duration(): number {\n return this.audio.duration;\n }\n /**\n * - **EN:** Get current volume value (0-1)\n * - **CN:** 获取当前音量值(0-1)\n */\n get volume(): number {\n return this._volume;\n }\n\n /**\n * - **EN:** Play audio. If previously paused, will resume from the pause position\n * - **CN:** 播放音频 如果之前暂停过，将从暂停位置继续播放\n */\n async play(): Promise<void> {\n if (!this.audioContext) {\n this.initAudioContext();\n }\n\n if (this.audioContext?.state === 'suspended') {\n await this.audioContext.resume();\n }\n\n try {\n await this.audio.play();\n this.options?.onPlay?.();\n } catch (error) {\n console.error('Error playing audio:', error);\n this.options?.onError?.(error);\n }\n }\n\n /**\n * - **EN:** Seek forward by a certain number of seconds\n * - **CN:** 向前跳转一定秒数\n *\n * @param seconds - number of seconds to seek forward | 要向前跳转的秒数\n */\n seekForward(seconds: number) {\n if (seconds < 0) {\n return;\n }\n if (!isNaN(this.audio.duration)) {\n this.audio.currentTime = Math.min(this.audio.currentTime + seconds, this.audio.duration);\n } else {\n this.audio.currentTime += seconds;\n }\n }\n /**\n * - **EN:** Seek backward by a certain number of seconds\n * - **CN:** 向后跳转一定秒数\n *\n * @param seconds - number of seconds to seek backward | 要向后跳转的秒数\n */\n seekBackward(seconds: number) {\n if (seconds < 0) {\n return;\n }\n this.audio.currentTime = Math.max(this.audio.currentTime - seconds, 0);\n }\n /**\n * - **EN:** Set current playback time (in seconds)\n * - **CN:** 设置当前播放时间（以秒为单位）\n *\n * @param time - time in seconds | 时间（秒）\n */\n seek(time: number) {\n // Ensure time is not less than 0\n const newTime = Math.max(0, time);\n // Ensure time is not greater than duration (if known)\n if (!isNaN(this.audio.duration)) {\n this.audio.currentTime = Math.min(newTime, this.audio.duration);\n } else {\n this.audio.currentTime = newTime;\n }\n }\n\n /**\n * - **EN:** Pause audio playback. When played again, will continue from current position\n * - **CN:** 暂停音频播放 再次播放时将从当前位置继续\n */\n pause(): void {\n this.audio.pause();\n this.options?.onPause?.();\n }\n\n /**\n * - **EN:** Stop audio playback. Progress will reset to the beginning\n * - **CN:** 停止音频播放 进度会重置到开始位置\n */\n stop(): void {\n this.audio.pause();\n this.audio.currentTime = 0;\n this.options?.onStop?.();\n }\n\n /**\n * - **EN:** Update audio source\n * - **CN:** 更新音频源\n *\n * @param source - can be a URL `string` or `ReadableStreamDefaultReader` |\n * 可以是URL字符串或`ReadableStreamDefaultReader`\n */\n async setAudioSource(source?: AudioSource) {\n this.audio.pause();\n this.audio.src = '';\n\n if (typeof source === 'string') {\n this.audio.src = source;\n } else {\n await this.handleStreamSource(source);\n }\n }\n\n /**\n * - **EN:** Increase volume (by 10% each time)\n * - **CN:** 增加音量（每次增加10%）\n *\n * @param percent - increase percentage (default 10%) | 增加百分比（默认10%）\n */\n volumeUp(percent = 0.1): void {\n this._volume = Math.min(1.0, this._volume + percent);\n this.updateVolume();\n }\n\n /**\n * - **EN:** Decrease volume (by 10% each time)\n * - **CN:** 降低音量（每次降低10%）\n *\n * @param percent - decrease percentage (default 10%) | 降低百分比（默认10%）\n */\n volumeDown(percent = 0.1): void {\n this._volume = Math.max(0, this._volume - percent);\n this.updateVolume();\n }\n\n /**\n * - **EN:** Set volume to a specific value (0-1)\n * - **CN:** 将音量设置为特定值（0-1）\n *\n * @param value - new volume value (0-1) | 新的音量值（0-1）\n */\n setVolume(value: number): void {\n this._volume = Math.min(1.0, Math.max(0, value));\n this.updateVolume();\n }\n\n /**\n * - **EN:** Add audio event listener\n * - **CN:** 添加音频事件监听器\n */\n addEventListener: HTMLAudioElement['addEventListener'] = (\n event: string,\n listener: EventListenerOrEventListenerObject\n ): void => {\n this.audio.addEventListener(event, listener);\n };\n\n /**\n * - **EN:** Remove audio event listener\n * - **CN:** 移除音频事件监听器\n */\n removeEventListener: HTMLAudioElement['removeEventListener'] = (\n event: string,\n listener: EventListenerOrEventListenerObject\n ): void => {\n this.audio.removeEventListener(event, listener);\n };\n\n /**\n * - **EN:** Release resources\n * - **CN:** 释放资源\n */\n dispose(): void {\n this.audio.pause();\n this.audio.src = '';\n this.removeEventListener('ended', this.onPlayEnd);\n\n if (this.audioContext) {\n try {\n this.audioContext.close();\n } catch (error) {\n console.error('Error closing AudioContext:', error);\n }\n this.audioContext = null;\n }\n\n this.sourceNode = null;\n this.gainNode = null;\n }\n\n /** Process streaming data source */\n private async handleStreamSource(source: Exclude<AudioSource, string> | undefined) {\n if (!source) return;\n try {\n let blob: Blob;\n if (source instanceof Blob) {\n blob = source;\n } else if (source instanceof ArrayBuffer || source instanceof Uint8Array) {\n blob = new Blob([source]);\n } else {\n // Create a new ReadableStream to read data from the reader\n const stream = new ReadableStream({\n async pull(controller) {\n try {\n const { done, value } = await source.read();\n if (done) {\n controller.close();\n } else {\n controller.enqueue(value);\n }\n } catch (err) {\n controller.error(err);\n }\n },\n });\n // Convert stream to Blob and create URL\n const response = new Response(stream);\n blob = await response.blob();\n }\n\n const url = URL.createObjectURL(blob);\n\n this.audio.src = url;\n\n // Release Blob URL after audio loads\n this.audio.onload = () => {\n URL.revokeObjectURL(url);\n };\n } catch (error) {\n console.error('Error processing audio stream:', error);\n }\n }\n\n /** Initialize Web Audio API for better volume control */\n private initAudioContext() {\n if (this.audioContext) return;\n\n this.audioContext = new AudioContext();\n this.sourceNode = this.audioContext.createMediaElementSource(this.audio);\n this.gainNode = this.audioContext.createGain();\n\n this.sourceNode.connect(this.gainNode);\n this.gainNode.connect(this.audioContext.destination);\n\n this.gainNode.gain.value = this._volume;\n }\n\n /** Update audio playback volume */\n private updateVolume(): void {\n if (this.gainNode) {\n this.gainNode.gain.value = this._volume;\n } else {\n this.audio.volume = this._volume;\n }\n }\n}\n\nexport default AudioPlayer;\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/lib/utils/stream.d.ts
CHANGED
|
@@ -3,7 +3,8 @@
|
|
|
3
3
|
* - **CN:** 一个数据流时间切片器，用于将音频流分成固定时间段
|
|
4
4
|
*/
|
|
5
5
|
export declare class StreamTimeSlicerClass implements StreamTimeSlicer {
|
|
6
|
-
|
|
6
|
+
sliceMode: StreamTimeSlicerOptions['sliceMode'];
|
|
7
|
+
value: StreamTimeSlicerOptions['value'];
|
|
7
8
|
private readonly onSlice;
|
|
8
9
|
private channelChunks;
|
|
9
10
|
private startTs;
|
|
@@ -18,10 +19,21 @@ export declare class StreamTimeSlicerClass implements StreamTimeSlicer {
|
|
|
18
19
|
}
|
|
19
20
|
export interface StreamTimeSlicerOptions {
|
|
20
21
|
/**
|
|
21
|
-
* - **EN:**
|
|
22
|
-
*
|
|
22
|
+
* - **EN:** Mode of slicing
|
|
23
|
+
*
|
|
24
|
+
* - 'time': slice by time (ms)
|
|
25
|
+
* - 'size': slice by size (bytes)
|
|
26
|
+
* - **CN:** 切片模式
|
|
27
|
+
*
|
|
28
|
+
* - 'time': 按时间切片（毫秒）
|
|
29
|
+
* - 'size': 按大小切片（字节）
|
|
30
|
+
*/
|
|
31
|
+
sliceMode: 'time' | 'size';
|
|
32
|
+
/**
|
|
33
|
+
* - **EN:** Value for slicing (ms or bytes)
|
|
34
|
+
* - **CN:** 切片值（毫秒或字节）
|
|
23
35
|
*/
|
|
24
|
-
|
|
36
|
+
value: number;
|
|
25
37
|
/**
|
|
26
38
|
* - **EN:** Callback when a slice is reached
|
|
27
39
|
* - **CN:** 达到分片时回调
|
|
@@ -36,12 +48,7 @@ export interface StreamTimeSlicerOptions {
|
|
|
36
48
|
* - **EN:** stream time slicer
|
|
37
49
|
* - **CN:** 数据流时间切片器
|
|
38
50
|
*/
|
|
39
|
-
export interface StreamTimeSlicer {
|
|
40
|
-
/**
|
|
41
|
-
* - **EN:** Duration of each slice (ms)
|
|
42
|
-
* - **CN:** 每个分片的时长（毫秒）
|
|
43
|
-
*/
|
|
44
|
-
timeSlice: number;
|
|
51
|
+
export interface StreamTimeSlicer extends Readonly<Pick<StreamTimeSlicerOptions, 'sliceMode'>>, Pick<StreamTimeSlicerOptions, 'value'> {
|
|
45
52
|
/**
|
|
46
53
|
* - **EN:** Push a frame (multi-channel data obtained from the same callback)
|
|
47
54
|
* - **CN:** 推入一帧（同一次回调得到的多通道）
|
package/lib/utils/stream.js
CHANGED
|
@@ -26,7 +26,8 @@ var StreamTimeSlicerClass = class {
|
|
|
26
26
|
constructor(options) {
|
|
27
27
|
this.channelChunks = [];
|
|
28
28
|
this.startTs = null;
|
|
29
|
-
this.
|
|
29
|
+
this.sliceMode = options.sliceMode;
|
|
30
|
+
this.value = options.value;
|
|
30
31
|
this.onSlice = options.onSlice;
|
|
31
32
|
}
|
|
32
33
|
now() {
|
|
@@ -35,9 +36,13 @@ var StreamTimeSlicerClass = class {
|
|
|
35
36
|
shouldEmit(currentTs) {
|
|
36
37
|
if (this.startTs == null)
|
|
37
38
|
return false;
|
|
38
|
-
if (this.
|
|
39
|
+
if (this.value <= 0)
|
|
39
40
|
return true;
|
|
40
|
-
|
|
41
|
+
if (this.sliceMode === "time") {
|
|
42
|
+
return currentTs - this.startTs >= this.value;
|
|
43
|
+
} else {
|
|
44
|
+
return this.channelChunks.reduce((acc, arr) => acc + arr.length, 0) >= this.value;
|
|
45
|
+
}
|
|
41
46
|
}
|
|
42
47
|
emit(force = false) {
|
|
43
48
|
if (this.startTs == null)
|
|
@@ -79,7 +84,7 @@ var StreamTimeSlicerClass = class {
|
|
|
79
84
|
this.channelChunks[i].push(ch);
|
|
80
85
|
});
|
|
81
86
|
this.emit(false);
|
|
82
|
-
if (this.
|
|
87
|
+
if (this.value <= 0)
|
|
83
88
|
this.emit(true);
|
|
84
89
|
}
|
|
85
90
|
flush() {
|
package/lib/utils/stream.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/utils/stream.ts"],
|
|
4
|
-
"sourcesContent": ["/**\n * - **EN:** A stream time slicer for splitting audio streams into fixed time segments\n * - **CN:** 一个数据流时间切片器，用于将音频流分成固定时间段\n */\nexport class StreamTimeSlicerClass implements StreamTimeSlicer {\n
|
|
5
|
-
"mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAM,wBAAN,MAAwD;AAAA,
|
|
4
|
+
"sourcesContent": ["/**\n * - **EN:** A stream time slicer for splitting audio streams into fixed time segments\n * - **CN:** 一个数据流时间切片器，用于将音频流分成固定时间段\n */\nexport class StreamTimeSlicerClass implements StreamTimeSlicer {\n public sliceMode: StreamTimeSlicerOptions['sliceMode'];\n public value: StreamTimeSlicerOptions['value'];\n private readonly onSlice: (channels: Float32Array[], sliceDurationMs: number) => void;\n private channelChunks: Float32Array[][] = [];\n private startTs: number | null = null;\n\n constructor(options: StreamTimeSlicerOptions) {\n this.sliceMode = options.sliceMode;\n this.value = options.value;\n this.onSlice = options.onSlice;\n }\n\n private now() {\n return typeof performance !== 'undefined' ? performance.now() : Date.now();\n }\n\n private shouldEmit(currentTs: number) {\n if (this.startTs == null) return false;\n if (this.value <= 0) return true;\n if (this.sliceMode === 'time') {\n return currentTs - this.startTs >= this.value;\n } else {\n return this.channelChunks.reduce((acc, arr) => acc + arr.length, 0) >= this.value;\n }\n }\n\n private emit(force = false) {\n if (this.startTs == null) return;\n const currentTs = this.now();\n if (!force && !this.shouldEmit(currentTs)) return;\n\n // reset start time\n if (this.channelChunks.length === 0 || this.channelChunks.every((arr) => arr.length === 0)) {\n this.startTs = null;\n for (let i = 0; i < this.channelChunks.length; i++) this.channelChunks[i] = [];\n return;\n }\n\n // Merge each channel\n const merged: Float32Array[] = this.channelChunks.map((chArr) => {\n const total = chArr.reduce((s, a) => s + a.length, 0);\n const out = new Float32Array(total);\n let offset = 0;\n for (const seg of chArr) {\n out.set(seg, offset);\n offset += seg.length;\n }\n return out;\n });\n\n const sliceDur = this.startTs != null ? currentTs - this.startTs : 0;\n this.onSlice(merged, sliceDur);\n\n // Reset start time\n for (let i = 0; i < this.channelChunks.length; i++) this.channelChunks[i] = [];\n this.startTs = null;\n }\n\n push(channels: Float32Array[]) {\n if (!channels || channels.length === 0) return;\n if (this.startTs == null) this.startTs = this.now();\n\n while (this.channelChunks.length < channels.length) {\n this.channelChunks.push([]);\n }\n channels.forEach((ch, i) => {\n this.channelChunks[i].push(ch);\n });\n\n this.emit(false);\n if (this.value <= 0) this.emit(true); // immediate output mode\n }\n\n flush() {\n this.emit(true);\n }\n\n reset() {\n for (let i = 0; i < this.channelChunks.length; i++) this.channelChunks[i] = [];\n this.startTs = null;\n }\n\n duration() {\n return this.startTs == null ? 0 : this.now() - this.startTs;\n }\n}\nexport interface StreamTimeSlicerOptions {\n /**\n * - **EN:** Mode of slicing\n *\n * - 'time': slice by time (ms)\n * - 'size': slice by size (bytes)\n * - **CN:** 切片模式\n *\n * - 'time': 按时间切片（毫秒）\n * - 'size': 按大小切片（字节）\n */\n sliceMode: 'time' | 'size';\n /**\n * - **EN:** Value for slicing (ms or bytes)\n * - **CN:** 切片值（毫秒或字节）\n */\n value: number;\n /**\n * - **EN:** Callback when a slice is reached\n * - **CN:** 达到分片时回调\n *\n * @param channels - Multi-channel data, each channel is a Float32Array | 多通道数据，每个通道是一个\n * Float32Array\n * @param sliceDuration - Duration of the slice (ms) | 分片时长(ms)\n */\n onSlice: (channels: Float32Array[], sliceDuration: number) => void;\n}\n\n/**\n * - **EN:** stream time slicer\n * - **CN:** 数据流时间切片器\n */\nexport interface StreamTimeSlicer\n extends Readonly<Pick<StreamTimeSlicerOptions, 'sliceMode'>>,\n Pick<StreamTimeSlicerOptions, 'value'> {\n /**\n * - **EN:** Push a frame (multi-channel data obtained from the same callback)\n * - **CN:** 推入一帧（同一次回调得到的多通道）\n *\n * @param channels - Multi-channel data, each channel is a Float32Array | 多通道数据，每个通道是一个\n * Float32Array\n */\n push: (channels: Float32Array[]) => void;\n /**\n * - **EN:** Force output the current accumulation (output even if not enough timeSlice)\n * - **CN:** 强制输出当前累积（不足 timeSlice 也输出）\n */\n flush: () => void;\n /**\n * - **EN:** Clear the cache (do not output)\n * - **CN:** 清空缓存（不输出）\n */\n reset: () => void;\n /**\n * - **EN:** Get the accumulated duration from start to current (ms)\n * - **CN:** 获取从开始到当前已累计的时长(ms)\n */\n duration: () => number;\n}\n"],
|
|
5
|
+
"mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAM,wBAAN,MAAwD;AAAA,EAO7D,YAAY,SAAkC;AAH9C,SAAQ,gBAAkC,CAAC;AAC3C,SAAQ,UAAyB;AAG/B,SAAK,YAAY,QAAQ;AACzB,SAAK,QAAQ,QAAQ;AACrB,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEQ,MAAM;AACZ,WAAO,OAAO,gBAAgB,cAAc,YAAY,IAAI,IAAI,KAAK,IAAI;AAAA,EAC3E;AAAA,EAEQ,WAAW,WAAmB;AACpC,QAAI,KAAK,WAAW;AAAM,aAAO;AACjC,QAAI,KAAK,SAAS;AAAG,aAAO;AAC5B,QAAI,KAAK,cAAc,QAAQ;AAC7B,aAAO,YAAY,KAAK,WAAW,KAAK;AAAA,IAC1C,OAAO;AACL,aAAO,KAAK,cAAc,OAAO,CAAC,KAAK,QAAQ,MAAM,IAAI,QAAQ,CAAC,KAAK,KAAK;AAAA,IAC9E;AAAA,EACF;AAAA,EAEQ,KAAK,QAAQ,OAAO;AAC1B,QAAI,KAAK,WAAW;AAAM;AAC1B,UAAM,YAAY,KAAK,IAAI;AAC3B,QAAI,CAAC,SAAS,CAAC,KAAK,WAAW,SAAS;AAAG;AAG3C,QAAI,KAAK,cAAc,WAAW,KAAK,KAAK,cAAc,MAAM,CAAC,QAAQ,IAAI,WAAW,CAAC,GAAG;AAC1F,WAAK,UAAU;AACf,eAAS,IAAI,GAAG,IAAI,KAAK,cAAc,QAAQ;AAAK,aAAK,cAAc,CAAC,IAAI,CAAC;AAC7E;AAAA,IACF;AAGA,UAAM,SAAyB,KAAK,cAAc,IAAI,CAAC,UAAU;AAC/D,YAAM,QAAQ,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,QAAQ,CAAC;AACpD,YAAM,MAAM,IAAI,aAAa,KAAK;AAClC,UAAI,SAAS;AACb,iBAAW,OAAO,OAAO;AACvB,YAAI,IAAI,KAAK,MAAM;AACnB,kBAAU,IAAI;AAAA,MAChB;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,WAAW,KAAK,WAAW,OAAO,YAAY,KAAK,UAAU;AACnE,SAAK,QAAQ,QAAQ,QAAQ;AAG7B,aAAS,IAAI,GAAG,IAAI,KAAK,cAAc,QAAQ;AAAK,WAAK,cAAc,CAAC,IAAI,CAAC;AAC7E,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,KAAK,UAA0B;AAC7B,QAAI,CAAC,YAAY,SAAS,WAAW;AAAG;AACxC,QAAI,KAAK,WAAW;AAAM,WAAK,UAAU,KAAK,IAAI;AAElD,WAAO,KAAK,cAAc,SAAS,SAAS,QAAQ;AAClD,WAAK,cAAc,KAAK,CAAC,CAAC;AAAA,IAC5B;AACA,aAAS,QAAQ,CAAC,IAAI,MAAM;AAC1B,WAAK,cAAc,CAAC,EAAE,KAAK,EAAE;AAAA,IAC/B,CAAC;AAED,SAAK,KAAK,KAAK;AACf,QAAI,KAAK,SAAS;AAAG,WAAK,KAAK,IAAI;AAAA,EACrC;AAAA,EAEA,QAAQ;AACN,SAAK,KAAK,IAAI;AAAA,EAChB;AAAA,EAEA,QAAQ;AACN,aAAS,IAAI,GAAG,IAAI,KAAK,cAAc,QAAQ;AAAK,WAAK,cAAc,CAAC,IAAI,CAAC;AAC7E,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,OAAO,IAAI,KAAK,IAAI,IAAI,KAAK;AAAA,EACtD;AACF;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|