@hkdigital/lib-core 0.4.59 → 0.4.61

package/dist/media/services/client/AudioService.svelte.d.ts

@@ -0,0 +1,71 @@
+/** @typedef {import('../../../network/loaders/typedef.js').SceneLoadingProgress} SceneLoadingProgress */
+export default class AudioService extends ServiceBase {
+    /** @type {Record<string, AudioScene>} */
+    scenes: Record<string, AudioScene>;
+    muted: boolean;
+    mute(): void;
+    unmute(): void;
+    /**
+     * Play a sound from the specified audio scene
+     *
+     * @param {string} sceneLabel
+     * @param {string} soundLabel
+     * @param {{delay?:number, loop?:boolean}} options
+     *
+     * @returns {Promise<{stop: ()=>void, sourceNode:AudioBufferSourceNode}>}
+     */
+    playSound(sceneLabel: string, soundLabel: string, options?: {
+        delay?: number;
+        loop?: boolean;
+    }): Promise<{
+        stop: () => void;
+        sourceNode: AudioBufferSourceNode;
+    }>;
+    /**
+     * Get an audio scene
+     *
+     * @param {string} sceneLabel
+     * @param {import('../../../network/loaders/typedef.js').MemorySourceParams[]} memorySources
+     *
+     * @returns {AudioScene}
+     */
+    createScene(sceneLabel: string, memorySources: import("../../../network/loaders/typedef.js").MemorySourceParams[]): AudioScene;
+    /**
+     * Get an audio scene
+     *
+     * @param {string} label
+     */
+    destroyScene(label: string): void;
+    /**
+     * Get an audio scene
+     *
+     * @param {string} label
+     *
+     * @param {object} [options]
+     * @param {number} [options.timeoutMs=10000]
+     *   Timeout in milliseconds
+     * @param {(progress: SceneLoadingProgress) => void} [options.onProgress]
+     *   Progress callback function
+     *
+     * @returns {{promise: Promise<AudioScene>, abort: Function}}
+     *   Object with promise that resolves when loaded and abort function
+     */
+    preloadScene(label: string, options?: {
+        timeoutMs?: number | undefined;
+        onProgress?: ((progress: SceneLoadingProgress) => void) | undefined;
+    }): {
+        promise: Promise<AudioScene>;
+        abort: Function;
+    };
+    /**
+     * Get an audio scene
+     *
+     * @param {string} label
+     *
+     * @returns {AudioScene}
+     */
+    getScene(label: string): AudioScene;
+}
+export type SceneLoadingProgress = import("../../../network/loaders/typedef.js").SceneLoadingProgress;
+import { ServiceBase } from '../../../services/index.js';
+import { AudioScene } from '../../../network/loaders.js';

package/dist/media/services/client/AudioService.svelte.js

@@ -0,0 +1,168 @@
+import { ServiceBase } from '../../../services/index.js';
+
+import { AudioScene } from '../../../network/loaders.js';
+
+/** @typedef {import('../../../network/loaders/typedef.js').SceneLoadingProgress} SceneLoadingProgress */
+
+export default class AudioService extends ServiceBase {
+  /** @type {Record<string, AudioScene>} */
+  scenes = {};
+
+  muted = $state(false);
+
+  /**
+   * Configure the service (handles both initial config and reconfiguration)
+   *
+   * @param {any} newConfig - Configuration to apply
+   * @param {any} [oldConfig=null] - Previous config (null = initial setup)
+   */
+  // eslint-disable-next-line no-unused-vars
+  async _configure(newConfig, oldConfig) {
+    // console.debug('Configure AudioService');
+  }
+
+  mute() {
+    //this.logger.debug('mute all');
+
+    for (const label in this.scenes) {
+      const scene = this.scenes[label];
+      scene.mute();
+    }
+
+    this.muted = true;
+  }
+
+  unmute() {
+    // this.logger.debug('unmute all');
+
+    for (const label in this.scenes) {
+      const scene = this.scenes[label];
+      scene.unmute();
+    }
+
+    this.muted = false;
+  }
+
+  /**
+   * Play a sound from the specified audio scene
+   *
+   * @param {string} sceneLabel
+   * @param {string} soundLabel
+   * @param {{delay?:number, loop?:boolean}} options
+   *
+   * @returns {Promise<{stop: ()=>void, sourceNode:AudioBufferSourceNode}>}
+   */
+  async playSound(sceneLabel, soundLabel, options = {}) {
+    const audioScene = await this.getScene(sceneLabel);
+
+    const sourceNode = await audioScene.getSourceNode(soundLabel);
+
+    const { delay = 0, loop = false } = options;
+
+    sourceNode.loop = loop;
+
+    let started = false;
+
+    /** @type {ReturnType<typeof setTimeout>|null} */
+    let timer = setTimeout(() => {
+      // console.debug('playSound', soundLabel);
+      sourceNode.start();
+      started = true;
+    }, delay);
+
+    return {
+      stop: () => {
+        if (timer) {
+          clearTimeout(timer);
+          timer = null;
+        }
+
+        if (started) {
+          sourceNode.stop();
+          started = false;
+        }
+      },
+      sourceNode
+    };
+  }
+
+  /**
+   * Get an audio scene
+   *
+   * @param {string} sceneLabel
+   * @param {import('../../../network/loaders/typedef.js').MemorySourceParams[]} memorySources
+   *
+   * @returns {AudioScene}
+   */
+  createScene(sceneLabel, memorySources) {
+    let audioScene = this.scenes[sceneLabel];
+
+    if (audioScene) {
+      // Scene already created
+      // => Do nothing
+      return audioScene;
+    }
+
+    audioScene = new AudioScene();
+
+    for (const memorySource of memorySources) {
+      audioScene.defineMemorySource(memorySource);
+    }
+
+    this.scenes[sceneLabel] = audioScene;
+
+    return audioScene;
+  }
+
+  /**
+   * Get an audio scene
+   *
+   * @param {string} label
+   */
+  destroyScene(label) {
+    const scene = this.scenes[label];
+
+    if (scene) {
+      scene.destroy();
+      delete this.scenes[label];
+    }
+  }
+
+  /**
+   * Get an audio scene
+   *
+   * @param {string} label
+   *
+   * @param {object} [options]
+   * @param {number} [options.timeoutMs=10000]
+   *   Timeout in milliseconds
+   * @param {(progress: SceneLoadingProgress) => void} [options.onProgress]
+   *   Progress callback function
+   *
+   * @returns {{promise: Promise<AudioScene>, abort: Function}}
+   *   Object with promise that resolves when loaded and abort function
+   */
+  preloadScene(label, options) {
+    const audioScene = this.getScene(label);
+
+    // @ts-ignore (AudioScene extends SceneBase)
+    return audioScene.preload(options);
+  }
+
+  /**
+   * Get an audio scene
+   *
+   * @param {string} label
+   *
+   * @returns {AudioScene}
+   */
+  getScene(label) {
+    const audioScene = this.scenes[label];
+
+    if (!audioScene) {
+      throw new Error(`AudioScene [${label}] not found`);
+    }
+
+    return audioScene;
+  }
+}

package/dist/media/services/client/ImageService.svelte.d.ts

@@ -0,0 +1,73 @@
+/** @typedef {import('../../../network/loaders/typedef.js').SceneLoadingProgress} SceneLoadingProgress */
+export default class ImageService extends ServiceBase {
+    /** @type {Record<string, ImageScene>} */
+    scenes: Record<string, ImageScene>;
+    /**
+     * Get an image from the specified image scene
+     *
+     * @param {string} sceneLabel
+     * @param {string} imageLabel
+     *
+     * @returns {string} Object URL for the image
+     */
+    getObjectURL(sceneLabel: string, imageLabel: string): string;
+    /**
+     * Get image metadata from the specified image scene
+     *
+     * @param {string} sceneLabel
+     * @param {string} imageLabel
+     *
+     * @returns {import('../../../network/loaders/image/typedef.js').ImageMeta}
+     */
+    getImageMeta(sceneLabel: string, imageLabel: string): import("../../../network/loaders/image/typedef.js").ImageMeta;
+    /**
+     * Create an image scene
+     *
+     * @param {string} sceneLabel
+     * @param {Array<{label: string, imageSource: import('../../../config/typedef.js').ImageSource}>} imageSources
+     *
+     * @returns {ImageScene}
+     */
+    createScene(sceneLabel: string, imageSources: Array<{
+        label: string;
+        imageSource: import("../../../config/typedef.js").ImageSource;
+    }>): ImageScene;
+    /**
+     * Destroy an image scene
+     *
+     * @param {string} label
+     */
+    destroyScene(label: string): void;
+    /**
+     * Get an image scene
+     *
+     * @param {string} label
+     *
+     * @param {object} [options]
+     * @param {number} [options.timeoutMs=10000]
+     *   Timeout in milliseconds
+     * @param {(progress: SceneLoadingProgress) => void} [options.onProgress]
+     *   Progress callback function
+     *
+     * @returns {{promise: Promise<ImageScene>, abort: Function}}
+     *   Object with promise that resolves when loaded and abort function
+     */
+    preloadScene(label: string, options?: {
+        timeoutMs?: number | undefined;
+        onProgress?: ((progress: SceneLoadingProgress) => void) | undefined;
+    }): {
+        promise: Promise<ImageScene>;
+        abort: Function;
+    };
+    /**
+     * Get an image scene
+     *
+     * @param {string} label
+     *
+     * @returns {ImageScene}
+     */
+    getScene(label: string): ImageScene;
+}
+export type SceneLoadingProgress = import("../../../network/loaders/typedef.js").SceneLoadingProgress;
+import { ServiceBase } from '../../../services/index.js';
+import { ImageScene } from '../../../network/loaders.js';

package/dist/media/services/client/ImageService.svelte.js

@@ -0,0 +1,127 @@
+import { ServiceBase } from '../../../services/index.js';
+
+import { ImageScene } from '../../../network/loaders.js';
+
+/** @typedef {import('../../../network/loaders/typedef.js').SceneLoadingProgress} SceneLoadingProgress */
+
+export default class ImageService extends ServiceBase {
+  /** @type {Record<string, ImageScene>} */
+  scenes = {};
+
+  /**
+   * Configure the service (handles both initial config and reconfiguration)
+   *
+   * @param {any} newConfig - Configuration to apply
+   * @param {any} [oldConfig=null] - Previous config (null = initial setup)
+   */
+  // eslint-disable-next-line no-unused-vars
+  async _configure(newConfig, oldConfig) {
+    // console.debug('Configure ImageService');
+  }
+
+  /**
+   * Get an image from the specified image scene
+   *
+   * @param {string} sceneLabel
+   * @param {string} imageLabel
+   *
+   * @returns {string} Object URL for the image
+   */
+  getObjectURL(sceneLabel, imageLabel) {
+    const imageScene = this.getScene(sceneLabel);
+    return imageScene.getObjectURL(imageLabel);
+  }
+
+  /**
+   * Get image metadata from the specified image scene
+   *
+   * @param {string} sceneLabel
+   * @param {string} imageLabel
+   *
+   * @returns {import('../../../network/loaders/image/typedef.js').ImageMeta}
+   */
+  getImageMeta(sceneLabel, imageLabel) {
+    const imageScene = this.getScene(sceneLabel);
+    return imageScene.getImageMeta(imageLabel);
+  }
+
+  /**
+   * Create an image scene
+   *
+   * @param {string} sceneLabel
+   * @param {Array<{label: string, imageSource: import('../../../config/typedef.js').ImageSource}>} imageSources
+   *
+   * @returns {ImageScene}
+   */
+  createScene(sceneLabel, imageSources) {
+    let imageScene = this.scenes[sceneLabel];
+
+    if (imageScene) {
+      // Scene already created
+      // => Do nothing
+      return imageScene;
+    }
+
+    imageScene = new ImageScene();
+
+    for (const imageSource of imageSources) {
+      imageScene.defineImage(imageSource);
+    }
+
+    this.scenes[sceneLabel] = imageScene;
+
+    return imageScene;
+  }
+
+  /**
+   * Destroy an image scene
+   *
+   * @param {string} label
+   */
+  destroyScene(label) {
+    const scene = this.scenes[label];
+
+    if (scene) {
+      scene.destroy();
+      delete this.scenes[label];
+    }
+  }
+
+  /**
+   * Get an image scene
+   *
+   * @param {string} label
+   *
+   * @param {object} [options]
+   * @param {number} [options.timeoutMs=10000]
+   *   Timeout in milliseconds
+   * @param {(progress: SceneLoadingProgress) => void} [options.onProgress]
+   *   Progress callback function
+   *
+   * @returns {{promise: Promise<ImageScene>, abort: Function}}
+   *   Object with promise that resolves when loaded and abort function
+   */
+  preloadScene(label, options) {
+    const imageScene = this.getScene(label);
+
+    // @ts-ignore (ImageScene extends SceneBase)
+    return imageScene.preload(options);
+  }
+
+  /**
+   * Get an image scene
+   *
+   * @param {string} label
+   *
+   * @returns {ImageScene}
+   */
+  getScene(label) {
+    const imageScene = this.scenes[label];
+
+    if (!imageScene) {
+      throw new Error(`ImageScene [${label}] not found`);
+    }
+
+    return imageScene;
+  }
+}

package/dist/media/services/client.d.ts

@@ -0,0 +1 @@
+export { default as AudioService } from "./client/AudioService.svelte.js";

package/dist/media/services/client.js

@@ -0,0 +1 @@
+export { default as AudioService } from './client/AudioService.svelte.js';

package/dist/network/loaders/base/SceneBase.svelte.js

@@ -64,11 +64,24 @@ export default class SceneBase {
       }
     }
 
+    let percentageLoaded;
+    if (totalSize > 0) {
+      // Byte-based progress
+      percentageLoaded = Math.round((totalBytesLoaded / totalSize) * 100);
+    } else if (numberOfSources > 0) {
+      // Source-based progress
+      percentageLoaded = Math.round((sourcesLoaded / numberOfSources) * 100);
+    } else {
+      // No sources to load
+      percentageLoaded = 0;
+    }
+
     return {
       totalBytesLoaded,
       totalSize,
       sourcesLoaded,
-      numberOfSources
+      numberOfSources,
+      percentageLoaded
     };
   });
 
@@ -201,7 +214,7 @@ export default class SceneBase {
       // Set up progress tracking with polling
       if (onProgress) {
         progressIntervalId = setInterval(() => {
-          if (!isAborted) {
+          if (!isAborted && this.state === STATE_LOADING) {
             const currentProgress = this.progress;
             lastSentProgress = currentProgress;
             onProgress(currentProgress);
@@ -234,17 +247,16 @@ export default class SceneBase {
           }
 
           if (progressIntervalId) {
+            clearInterval(progressIntervalId);
+            progressIntervalId = null;
+            
             if (onProgress) {
               const finalProgress = this.progress;
-              // Only send final update if progress has changed
-              if (!lastSentProgress || 
-                  finalProgress.sourcesLoaded !== lastSentProgress.sourcesLoaded ||
-                  finalProgress.totalBytesLoaded !== lastSentProgress.totalBytesLoaded) {
+              // Always send final progress when loading completes
+              if (this.loaded) {
                 onProgress(finalProgress);
               }
             }
-            clearInterval(progressIntervalId);
-            progressIntervalId = null;
           }
 
           if (isAborted || this.state === STATE_ABORTED) {

package/dist/network/loaders/base/typedef.d.ts

@@ -17,4 +17,8 @@ export type SceneLoadingProgress = {
      * - Total number of sources
      */
     numberOfSources: number;
+    /**
+     * - Loading percentage (0-100)
+     */
+    percentageLoaded: number;
 };

package/dist/network/loaders/base/typedef.js

@@ -4,6 +4,7 @@
  * @property {number} totalSize - Total size across all sources
  * @property {number} sourcesLoaded - Number of sources fully loaded
  * @property {number} numberOfSources - Total number of sources
+ * @property {number} percentageLoaded - Loading percentage (0-100)
  */
 
 export default {};

package/dist/ui/components/rows/panel-grid-row/PanelGridRow.svelte.d.ts

@@ -4,8 +4,8 @@ type PanelGridRow = {
     $set?(props: Partial<{
         base?: string | undefined;
         bg?: string | undefined;
-        justify?: "normal" | "center" | "start" | "end" | "between" | "around" | "evenly" | "stretch" | undefined;
-        justifyItems?: "center" | "start" | "end" | "stretch" | undefined;
+        justify?: "normal" | "start" | "center" | "end" | "between" | "around" | "evenly" | "stretch" | undefined;
+        justifyItems?: "start" | "center" | "end" | "stretch" | undefined;
         gap?: string | undefined;
         classes?: string | undefined;
         children?: Snippet<[]> | undefined;

package/dist/ui/components/rows/panel-row-2/PanelRow2.svelte.d.ts

@@ -4,8 +4,8 @@ type PanelRow2 = {
     $set?(props: Partial<{
         base?: string | undefined;
         bg?: string | undefined;
-        justify?: "normal" | "center" | "start" | "end" | "between" | "around" | "evenly" | "stretch" | undefined;
-        justifyItems?: "center" | "start" | "end" | "stretch" | undefined;
+        justify?: "normal" | "start" | "center" | "end" | "between" | "around" | "evenly" | "stretch" | undefined;
+        justifyItems?: "start" | "center" | "end" | "stretch" | undefined;
         gap?: string | undefined;
         classes?: string | undefined;
         children?: Snippet<[]> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.59",
+	"version": "0.4.61",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"