@hkdigital/lib-core 0.4.39 → 0.4.40

package/dist/network/loaders/audio/AudioScene.svelte.d.ts

@@ -29,16 +29,9 @@ export default class AudioScene extends SceneBase {
      * Add in-memory audio source
      * - Uses an AudioLoader instance to load audio data from network
      *
-     * @param {object} _
-     * @param {string} _.label
-     * @param {string} _.url
-     * @param {SourceConfig} [_.config]
+     * @param {import('./typedef.js').MemorySourceParams} params
      */
-    defineMemorySource({ label, url, config }: {
-        label: string;
-        url: string;
-        config?: object | undefined;
-    }): void;
+    defineMemorySource({ label, url, config }: import("./typedef.js").MemorySourceParams): void;
     /**
      * Get a source that can be used to play the audio once
      *
@@ -63,9 +56,9 @@ export default class AudioScene extends SceneBase {
      */
     setTargetGain(value: number): void;
     /**
-     * Get the current target gain (volume level)
+     * Get the current target gain
      *
-     * @returns {number} Target gain value (0.0 to 1.0+)
+     * @returns {number}
      */
     getTargetGain(): number;
     /**

package/dist/network/loaders/audio/AudioScene.svelte.js

@@ -25,19 +25,16 @@ export default class AudioScene extends SceneBase {
 
 	targetGain = $derived( this.#targetGain );
 
-	/** @type {AudioContext|null} */
-	#audioContext = null;
+	/** @type {AudioContext|undefined} */
+	#audioContext;
 
-	/** {GainNode} */
-	#targetGainNode = null;
+	/** @type {GainNode|undefined} */
+	#targetGainNode;
 
 	/** @type {MemorySource[]} */
 	#memorySources = $state([]);
 
 
-	/**
-	 * Construct AudioScene
-	 */
 	constructor() {
 		super();
 	}
@@ -71,10 +68,7 @@ export default class AudioScene extends SceneBase {
 	 * Add in-memory audio source
 	 * - Uses an AudioLoader instance to load audio data from network
 	 *
-	 * @param {object} _
-	 * @param {string} _.label
-	 * @param {string} _.url
-	 * @param {SourceConfig} [_.config]
+	 * @param {import('./typedef.js').MemorySourceParams} params
 	 */
 	defineMemorySource({ label, url, config }) {
 		expect.notEmptyString(label);
@@ -95,8 +89,10 @@ export default class AudioScene extends SceneBase {
 	 * @returns {Promise<AudioBufferSourceNode>}
 	 */
 	async getSourceNode(label) {
+
 		// @note Gain setup
-		// https://stackoverflow.com/questions/46203191/should-i-disconnect-nodes-that-cant-be-used-anymore
+		// https://stackoverflow.com/
+		//   questions/46203191/should-i-disconnect-nodes-that-cant-be-used-anymore
 
 		const { audioLoader /*, config */ } = this.#getMemorySource(label);
 
@@ -149,9 +145,9 @@ export default class AudioScene extends SceneBase {
 	}
 
 	/**
-	 * Get the current target gain (volume level)
+	 * Get the current target gain
 	 *
-	 * @returns {number} Target gain value (0.0 to 1.0+)
+	 * @returns {number}
 	 */
 	getTargetGain()
 	{
@@ -191,6 +187,11 @@ export default class AudioScene extends SceneBase {
 
 	/* ==== Internals */
 
+	/**
+	 * Get or create the master gain node
+	 *
+	 * @returns {GainNode}
+	 */
 	#getGainNode()
 	{
 		if( !this.#targetGainNode )
@@ -205,6 +206,11 @@ export default class AudioScene extends SceneBase {
 		return this.#targetGainNode;
 	}
 
+	/**
+	 * Get or create the audio context
+	 *
+	 * @returns {AudioContext}
+	 */
 	#getAudioContext()
 	{
 		if( !this.#audioContext )
@@ -216,7 +222,7 @@ export default class AudioScene extends SceneBase {
 	}
 
 	/**
-	 * Get memory source
+	 * Find memory source by label
 	 *
 	 * @param {string} label
 	 *

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

@@ -0,0 +1,20 @@
+declare const _default: {};
+export default _default;
+export type MemorySourceParams = {
+    /**
+     * - Source identifier
+     */
+    label: string;
+    /**
+     * - Audio file URL
+     */
+    url: string;
+    /**
+     * - Optional source configuration
+     */
+    config?: object | undefined;
+};
+/**
+ * // property ...
+ */
+export type SourceConfig = object;

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

@@ -0,0 +1,13 @@
+/**
+ * @typedef {object} MemorySourceParams
+ * @property {string} label - Source identifier
+ * @property {string} url - Audio file URL
+ * @property {SourceConfig} [config] - Optional source configuration
+ */
+
+/**
+ * @typedef {object} SourceConfig
+ * // property ...
+ */
+
+export default {};

package/dist/network/loaders/image/ImageLoader.svelte.d.ts

@@ -8,7 +8,7 @@ export default class ImageLoader extends NetworkLoader {
      * @param {import('../../../config/typedef.js').ImageSource} imageSource
      */
     constructor(imageSource: import("../../../config/typedef.js").ImageSource);
-    get imageMeta(): import("./typedef.js").ImageMeta;
+    get imageMeta(): import("../../../config/typedef.js").ImageMeta;
     get url(): string | null;
     #private;
 }

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

@@ -1,16 +1,3 @@
 declare const _default: {};
 export default _default;
-export type ImageMeta = {
-    /**
-     * - URL of the image
-     */
-    src: string;
-    /**
-     * - Width of the image
-     */
-    width: number;
-    /**
-     * - Height of the image
-     */
-    height: number;
-};
+export type ImageMeta = import("../../../config/typedef.js").ImageMeta;

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

@@ -1,8 +1,3 @@
-/**
- * @typedef {Object} ImageMeta
- * @property {string} src - URL of the image
- * @property {number} width - Width of the image
- * @property {number} height - Height of the image
- */
+/** @typedef {import('../../../config/typedef.js').ImageMeta} ImageMeta */
 
 export default {};

package/dist/services/service-manager/ServiceManager.js

@@ -422,7 +422,7 @@ export class ServiceManager extends EventEmitter {
       if (!result.ok) {
         // Create detailed error with the actual service failure
         const detailedError = new DetailedError(
-          `Failed to start service [${name}], stopping`,
+          `Failed to start service [${name}]`,
           null,
           result.error
         );

package/package.json

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