@hkdigital/lib-core 0.3.11 → 0.3.13

package/dist/network/loaders/audio/mocks.js

@@ -1,35 +1,35 @@
-import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http/index.js';
-
-import { AUDIO_WAV } from '../../../constants/mime/audio.js';
-
-// import MockWav from './tiny-silence.wav?raw';
-
-const BASE64_WAV =
-	'UklGRnwAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YVgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA';
-
-/**
- * Create a response value that can be used by a mocked
- * fetch function
- *
- * @returns {Response}
- */
-export function createWavResponse(/* data , options */) {
-	// @note encode as Uint8Array to get the proper byte size of data
-	// const bytes = new TextEncoder().encode(MockWav);
-
-	const binaryString = atob(BASE64_WAV);
-	const bytes = new Uint8Array(binaryString.length);
-
-	for (let i = 0; i < binaryString.length; i++) {
-		bytes[i] = binaryString.charCodeAt(i);
-	}
-
-	const response = new Response(bytes, {
-		headers: new Headers({
-			[CONTENT_TYPE]: AUDIO_WAV,
-			[CONTENT_LENGTH]: String(bytes.length)
-		})
-	});
-
-	return response;
-}
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../../constants/http/index.js';
+
+import { AUDIO_WAV } from '../../../constants/mime/audio.js';
+
+// import MockWav from './tiny-silence.wav?raw';
+
+const BASE64_WAV =
+	'UklGRnwAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YVgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA';
+
+/**
+ * Create a response value that can be used by a mocked
+ * fetch function
+ *
+ * @returns {Response}
+ */
+export function createWavResponse(/* data , options */) {
+	// @note encode as Uint8Array to get the proper byte size of data
+	// const bytes = new TextEncoder().encode(MockWav);
+
+	const binaryString = atob(BASE64_WAV);
+	const bytes = new Uint8Array(binaryString.length);
+
+	for (let i = 0; i < binaryString.length; i++) {
+		bytes[i] = binaryString.charCodeAt(i);
+	}
+
+	const response = new Response(bytes, {
+		headers: new Headers({
+			[CONTENT_TYPE]: AUDIO_WAV,
+			[CONTENT_LENGTH]: String(bytes.length)
+		})
+	});
+
+	return response;
+}

package/dist/network/loaders/audio.js

@@ -1,2 +1,2 @@
-export { default as AudioLoader } from './audio/AudioLoader.svelte.js';
+export { default as AudioLoader } from './audio/AudioLoader.svelte.js';
 export { default as AudioScene } from './audio/AudioScene.svelte.js';

package/dist/network/loaders/image/ImageLoader.svelte.js

@@ -1,44 +1,44 @@
-/** @typedef {import('./typedef.js').ImageMeta} ImageMeta */
-
-import { toSingleImageMeta } from './utils/index.js';
-
-import {
-  NetworkLoader
-} from '../../states/index.js';
-
-/**
- * ImageLoader instance
- * - Loads image data from network
- * - The loading process can be monitored
- */
-export default class ImageLoader extends NetworkLoader {
-  /** @type {ImageMeta} */
-  #imageMeta;
-
-  /**
-   * @param {import('../typedef.js').ImageSource} imageSource
-   */
-  constructor(imageSource) {
-    const imageMeta = toSingleImageMeta(imageSource);
-
-    super({ url: imageMeta.src });
-
-    this.#imageMeta = imageMeta;
-  }
-
-  get imageMeta() {
-    return this.#imageMeta;
-  }
-
-  get url() {
-    return this._url;
-  }
-
-  // /**
-  //  * Get object URL that can be used as src parameter of an HTML image
-  //  *
-  //  * @note the objectURL should be revoked when no longer used
-  //  */
-  // getObjectURL() {}
-  //
-} // end class
+/** @typedef {import('./typedef.js').ImageMeta} ImageMeta */
+
+import { toSingleImageMeta } from './utils/index.js';
+
+import {
+  NetworkLoader
+} from '../../states/index.js';
+
+/**
+ * ImageLoader instance
+ * - Loads image data from network
+ * - The loading process can be monitored
+ */
+export default class ImageLoader extends NetworkLoader {
+  /** @type {ImageMeta} */
+  #imageMeta;
+
+  /**
+   * @param {import('../typedef.js').ImageSource} imageSource
+   */
+  constructor(imageSource) {
+    const imageMeta = toSingleImageMeta(imageSource);
+
+    super({ url: imageMeta.src });
+
+    this.#imageMeta = imageMeta;
+  }
+
+  get imageMeta() {
+    return this.#imageMeta;
+  }
+
+  get url() {
+    return this._url;
+  }
+
+  // /**
+  //  * Get object URL that can be used as src parameter of an HTML image
+  //  *
+  //  * @note the objectURL should be revoked when no longer used
+  //  */
+  // getObjectURL() {}
+  //
+} // end class

package/dist/network/loaders/image/ImageScene.svelte.js

@@ -1,248 +1,248 @@
-/** @typedef {import('./typedef.js').ImageMeta} ImageMeta */
-
-import * as expect from '../../../util/expect/index.js';
-
-import {
-  LoadingStateMachine,
-  STATE_INITIAL,
-  STATE_LOADING,
-  STATE_UNLOADING,
-  STATE_LOADED,
-  STATE_CANCELLED,
-  STATE_ERROR,
-  LOAD,
-  LOADED
-} from '../../../classes/svelte/loading-state-machine/index.js';
-
-import ImageLoader from './ImageLoader.svelte.js';
-
-/**
- * @typedef {object} SourceConfig
- * // property ...
- */
-
-/**
- * @typedef {object} ImageSceneSource
- * @property {string} label
- * @property {ImageLoader} imageLoader
- */
-
-export default class ImageScene {
-  #state = new LoadingStateMachine();
-
-  // @note this exported state is set by $effect's
-  state = $state(STATE_INITIAL);
-
-  // @note this exported state is set by $effect's
-  loaded = $derived.by(() => {
-    return this.state === STATE_LOADED;
-  });
-
-  /** @type {ImageSceneSource[]} */
-  #imageSources = $state([]);
-
-  #progress = $derived.by(() => {
-    // console.log('update progress');
-
-    let totalSize = 0;
-    let totalBytesLoaded = 0;
-    let sourcesLoaded = 0;
-
-    const sources = this.#imageSources;
-    const numberOfSources = sources.length;
-
-    for (let j = 0; j < numberOfSources; j++) {
-      const source = sources[j];
-      const { imageLoader } = source;
-
-      const { bytesLoaded, size, loaded } = imageLoader.progress;
-
-      totalSize += size;
-      totalBytesLoaded += bytesLoaded;
-
-      if (loaded) {
-        sourcesLoaded++;
-      }
-    } // end for
-
-    return {
-      totalBytesLoaded,
-      totalSize,
-      sourcesLoaded,
-      numberOfSources
-    };
-  });
-
-  /**
-   * Construct ImageScene
-   */
-  constructor() {
-    const state = this.#state;
-
-    $effect(() => {
-      if (state.current === STATE_LOADING) {
-        // console.log(
-        //   'progress',
-        //   JSON.stringify($state.snapshot(this.#progress))
-        // );
-
-        const { sourcesLoaded, numberOfSources } = this.#progress;
-
-        if (sourcesLoaded === numberOfSources) {
-          // console.log(`All [${numberOfSources}] sources loaded`);
-          this.#state.send(LOADED);
-        }
-      }
-    });
-
-    $effect(() => {
-      switch (state.current) {
-        case STATE_LOADING:
-          {
-            // console.log('ImageScene:loading');
-            this.#startLoading();
-          }
-          break;
-
-        case STATE_UNLOADING:
-          {
-            // console.log('ImageScene:unloading');
-            // this.#startUnLoading();
-          }
-          break;
-
-        case STATE_LOADED:
-          {
-            // console.log('ImageScene:loaded');
-            // TODO
-            // this.#abortLoading = null;
-          }
-          break;
-
-        case STATE_CANCELLED:
-          {
-            // console.log('ImageScene:cancelled');
-            // TODO
-          }
-          break;
-
-        case STATE_ERROR:
-          {
-            console.log('ImageScene:error', state.error);
-          }
-          break;
-      } // end switch
-
-      this.state = state.current;
-    });
-  }
-
-  destroy() {
-    // TODO: disconnect all image sources?
-    // TODO: Unload ImageLoaders?
-  }
-
-  /**
-   * Add image source
-   * - Uses an ImageLoader instance to load image data from network
-   *
-   * @param {object} _
-   * @param {string} _.label
-   * @param {import('../typedef.js').ImageSource} _.imageSource
-   */
-  defineImage({ label, imageSource }) {
-    expect.notEmptyString(label);
-
-    // expect.notEmptyString(url);
-
-    const imageLoader = new ImageLoader(imageSource);
-
-    this.#imageSources.push({ label, imageLoader });
-  }
-
-  /**
-   * Start loading all image sources
-   */
-  load() {
-    this.#state.send(LOAD);
-
-    // FIXME: in unit test when moved to startloading it hangs!
-
-    for (const { imageLoader } of this.#imageSources) {
-      imageLoader.load();
-    }
-  }
-
-  async #startLoading() {
-    // console.log('#startLoading');
-    // FIXME: in unit test when moved to startloading it hangs!
-    // for (const { audioLoader } of this.#memorySources) {
-    //   audioLoader.load();
-    // }
-  }
-
-  /**
-   * Get Image source
-   *
-   * @param {string} label
-   *
-   * @returns {ImageSceneSource}
-   */
-  #getImageSource(label) {
-    for (const source of this.#imageSources) {
-      if (label === source.label) {
-        return source;
-      }
-    }
-
-    throw new Error(`Source [${label}] has not been defined`);
-  }
-
-  /**
-   * Get image scene loading progress
-   */
-  get progress() {
-    return this.#progress;
-  }
-
-  /**
-   * Get an image loader
-   *
-   * @param {string} label
-   *
-   * @returns {ImageLoader}
-   */
-  getImageLoader(label) {
-    const source = this.#getImageSource(label);
-
-    return source.imageLoader;
-  }
-
-  /**
-   * Get object URL that can be used as src parameter of an HTML image
-   *
-   * @param {string} label
-   *
-   * @returns {ImageMeta}
-   */
-  getImageMeta(label) {
-    const source = this.#getImageSource(label);
-
-    return source.imageMeta;
-  }
-
-  /**
-   * Get object URL that can be used as src parameter of an HTML image
-   *
-   * @param {string} label
-   *
-   * @note the objectURL should be revoked when no longer used
-   *
-   * @returns {string}
-   */
-  getObjectURL(label) {
-    const source = this.#getImageSource(label);
-
-    return source.imageLoader.getObjectURL();
-  }
-}
+/** @typedef {import('./typedef.js').ImageMeta} ImageMeta */
+
+import * as expect from '../../../util/expect/index.js';
+
+import {
+  LoadingStateMachine,
+  STATE_INITIAL,
+  STATE_LOADING,
+  STATE_UNLOADING,
+  STATE_LOADED,
+  STATE_CANCELLED,
+  STATE_ERROR,
+  LOAD,
+  LOADED
+} from '../../../classes/svelte/loading-state-machine/index.js';
+
+import ImageLoader from './ImageLoader.svelte.js';
+
+/**
+ * @typedef {object} SourceConfig
+ * // property ...
+ */
+
+/**
+ * @typedef {object} ImageSceneSource
+ * @property {string} label
+ * @property {ImageLoader} imageLoader
+ */
+
+export default class ImageScene {
+  #state = new LoadingStateMachine();
+
+  // @note this exported state is set by $effect's
+  state = $state(STATE_INITIAL);
+
+  // @note this exported state is set by $effect's
+  loaded = $derived.by(() => {
+    return this.state === STATE_LOADED;
+  });
+
+  /** @type {ImageSceneSource[]} */
+  #imageSources = $state([]);
+
+  #progress = $derived.by(() => {
+    // console.log('update progress');
+
+    let totalSize = 0;
+    let totalBytesLoaded = 0;
+    let sourcesLoaded = 0;
+
+    const sources = this.#imageSources;
+    const numberOfSources = sources.length;
+
+    for (let j = 0; j < numberOfSources; j++) {
+      const source = sources[j];
+      const { imageLoader } = source;
+
+      const { bytesLoaded, size, loaded } = imageLoader.progress;
+
+      totalSize += size;
+      totalBytesLoaded += bytesLoaded;
+
+      if (loaded) {
+        sourcesLoaded++;
+      }
+    } // end for
+
+    return {
+      totalBytesLoaded,
+      totalSize,
+      sourcesLoaded,
+      numberOfSources
+    };
+  });
+
+  /**
+   * Construct ImageScene
+   */
+  constructor() {
+    const state = this.#state;
+
+    $effect(() => {
+      if (state.current === STATE_LOADING) {
+        // console.log(
+        //   'progress',
+        //   JSON.stringify($state.snapshot(this.#progress))
+        // );
+
+        const { sourcesLoaded, numberOfSources } = this.#progress;
+
+        if (sourcesLoaded === numberOfSources) {
+          // console.log(`All [${numberOfSources}] sources loaded`);
+          this.#state.send(LOADED);
+        }
+      }
+    });
+
+    $effect(() => {
+      switch (state.current) {
+        case STATE_LOADING:
+          {
+            // console.log('ImageScene:loading');
+            this.#startLoading();
+          }
+          break;
+
+        case STATE_UNLOADING:
+          {
+            // console.log('ImageScene:unloading');
+            // this.#startUnLoading();
+          }
+          break;
+
+        case STATE_LOADED:
+          {
+            // console.log('ImageScene:loaded');
+            // TODO
+            // this.#abortLoading = null;
+          }
+          break;
+
+        case STATE_CANCELLED:
+          {
+            // console.log('ImageScene:cancelled');
+            // TODO
+          }
+          break;
+
+        case STATE_ERROR:
+          {
+            console.log('ImageScene:error', state.error);
+          }
+          break;
+      } // end switch
+
+      this.state = state.current;
+    });
+  }
+
+  destroy() {
+    // TODO: disconnect all image sources?
+    // TODO: Unload ImageLoaders?
+  }
+
+  /**
+   * Add image source
+   * - Uses an ImageLoader instance to load image data from network
+   *
+   * @param {object} _
+   * @param {string} _.label
+   * @param {import('../typedef.js').ImageSource} _.imageSource
+   */
+  defineImage({ label, imageSource }) {
+    expect.notEmptyString(label);
+
+    // expect.notEmptyString(url);
+
+    const imageLoader = new ImageLoader(imageSource);
+
+    this.#imageSources.push({ label, imageLoader });
+  }
+
+  /**
+   * Start loading all image sources
+   */
+  load() {
+    this.#state.send(LOAD);
+
+    // FIXME: in unit test when moved to startloading it hangs!
+
+    for (const { imageLoader } of this.#imageSources) {
+      imageLoader.load();
+    }
+  }
+
+  async #startLoading() {
+    // console.log('#startLoading');
+    // FIXME: in unit test when moved to startloading it hangs!
+    // for (const { audioLoader } of this.#memorySources) {
+    //   audioLoader.load();
+    // }
+  }
+
+  /**
+   * Get Image source
+   *
+   * @param {string} label
+   *
+   * @returns {ImageSceneSource}
+   */
+  #getImageSource(label) {
+    for (const source of this.#imageSources) {
+      if (label === source.label) {
+        return source;
+      }
+    }
+
+    throw new Error(`Source [${label}] has not been defined`);
+  }
+
+  /**
+   * Get image scene loading progress
+   */
+  get progress() {
+    return this.#progress;
+  }
+
+  /**
+   * Get an image loader
+   *
+   * @param {string} label
+   *
+   * @returns {ImageLoader}
+   */
+  getImageLoader(label) {
+    const source = this.#getImageSource(label);
+
+    return source.imageLoader;
+  }
+
+  /**
+   * Get object URL that can be used as src parameter of an HTML image
+   *
+   * @param {string} label
+   *
+   * @returns {ImageMeta}
+   */
+  getImageMeta(label) {
+    const source = this.#getImageSource(label);
+
+    return source.imageMeta;
+  }
+
+  /**
+   * Get object URL that can be used as src parameter of an HTML image
+   *
+   * @param {string} label
+   *
+   * @note the objectURL should be revoked when no longer used
+   *
+   * @returns {string}
+   */
+  getObjectURL(label) {
+    const source = this.#getImageSource(label);
+
+    return source.imageLoader.getObjectURL();
+  }
+}