@hkdigital/lib-core 0.3.9 → 0.3.11

package/dist/services/internal/service-manager/constants.js

@@ -1,6 +1,6 @@
-
-// Log event names
-export const SERVICE_STATE_CHANGED = 'service:state-changed';
-export const SERVICE_HEALTH_CHANGED = 'service:health-changed';
-export const SERVICE_ERROR = 'service:error';
-export const SERVICE_LOG = 'service:log';
+
+// Log event names
+export const SERVICE_STATE_CHANGED = 'service:state-changed';
+export const SERVICE_HEALTH_CHANGED = 'service:health-changed';
+export const SERVICE_ERROR = 'service:error';
+export const SERVICE_LOG = 'service:log';

package/dist/services/internal/service-manager/typedef.js

@@ -1,90 +1,90 @@
-/**
- * @fileoverview Type definitions for ServiceManager class.
- * 
- * This file contains all TypeScript/JSDoc type definitions used by
- * the ServiceManager class and service registration.
- * 
- * @example
- * // When using ServiceManager
- * import { ServiceManager } from './ServiceManager.js';
- * 
- * // @ typedef {import('./typedef-service-manager.js').ServiceManagerConfig} ServiceManagerConfig
- * // @ typedef {import('./typedef-service-manager.js').ServiceRegistrationOptions} ServiceRegistrationOptions
- * 
- * const config = {
- *   environment: 'development',
- *   stopTimeout: 5000
- * };
- * 
- * const manager = new ServiceManager(config);
- * 
- * const options = {
- *   dependencies: ['database'],
- *   tags: ['critical']
- * };
- * 
- * manager.register('auth', AuthService, {}, options);
- */
-
-// ============================================================================
-// PUBLIC TYPES
-// ============================================================================
-
-/**
- * Options for registering a service
- *
- * @typedef {Object} ServiceRegistrationOptions
- * @property {string[]} [dependencies=[]] - Services this service depends on
- * @property {string[]} [tags=[]] - Tags for grouping services
- * @property {number} [priority=0] - Startup priority (higher starts first)
- */
-
-/**
- * Configuration for ServiceManager
- *
- * @typedef {Object} ServiceManagerConfig
- * @property {boolean} [debug=false] - Debug mode switch
- * @property {boolean} [autoStart=false] - Auto-start services on registration
- * @property {number} [stopTimeout=10000] - Default timeout for stopping services
- * @property {string} [logLevel] - Initial log level for ServiceManager
- * @property {LogConfig} [logConfig={}] - Logging configuration
- */
-
-/**
- * Logging configuration
- *
- * @typedef {Object} LogConfig
- * @property {string} [defaultLevel] - Default log level for services
- * @property {string} [globalLevel] - Override level for all services
- * @property {Object<string, string>} [serviceLevels] - Per-service log levels
- */
-
-/**
- * Result of health check for all services
- * @typedef {Object<string, HealthStatus>} HealthCheckResult
- */
-
-/**
- * Service class constructor type
- *
- * @typedef {new (name: string, options?: ServiceOptions) => ServiceInstance} ServiceConstructor
- */
-
-// ============================================================================
-// INTERNAL TYPES
-// ============================================================================
-
-/**
- * Internal service registry entry
- *
- * @typedef {Object} ServiceEntry
- * @property {ServiceConstructor} ServiceClass - Service class constructor
- * @property {ServiceInstance|null} instance - Service instance (lazy-created)
- * @property {*} config - Service configuration
- * @property {string[]} dependencies - Service dependencies
- * @property {Set<string>} dependents - Services that depend on this one
- * @property {string[]} tags - Service tags
- * @property {number} priority - Startup priority
- */
-
-export {};
+/**
+ * @fileoverview Type definitions for ServiceManager class.
+ * 
+ * This file contains all TypeScript/JSDoc type definitions used by
+ * the ServiceManager class and service registration.
+ * 
+ * @example
+ * // When using ServiceManager
+ * import { ServiceManager } from './ServiceManager.js';
+ * 
+ * // @ typedef {import('./typedef-service-manager.js').ServiceManagerConfig} ServiceManagerConfig
+ * // @ typedef {import('./typedef-service-manager.js').ServiceRegistrationOptions} ServiceRegistrationOptions
+ * 
+ * const config = {
+ *   environment: 'development',
+ *   stopTimeout: 5000
+ * };
+ * 
+ * const manager = new ServiceManager(config);
+ * 
+ * const options = {
+ *   dependencies: ['database'],
+ *   tags: ['critical']
+ * };
+ * 
+ * manager.register('auth', AuthService, {}, options);
+ */
+
+// ============================================================================
+// PUBLIC TYPES
+// ============================================================================
+
+/**
+ * Options for registering a service
+ *
+ * @typedef {Object} ServiceRegistrationOptions
+ * @property {string[]} [dependencies=[]] - Services this service depends on
+ * @property {string[]} [tags=[]] - Tags for grouping services
+ * @property {number} [priority=0] - Startup priority (higher starts first)
+ */
+
+/**
+ * Configuration for ServiceManager
+ *
+ * @typedef {Object} ServiceManagerConfig
+ * @property {boolean} [debug=false] - Debug mode switch
+ * @property {boolean} [autoStart=false] - Auto-start services on registration
+ * @property {number} [stopTimeout=10000] - Default timeout for stopping services
+ * @property {string} [logLevel] - Initial log level for ServiceManager
+ * @property {LogConfig} [logConfig={}] - Logging configuration
+ */
+
+/**
+ * Logging configuration
+ *
+ * @typedef {Object} LogConfig
+ * @property {string} [defaultLevel] - Default log level for services
+ * @property {string} [globalLevel] - Override level for all services
+ * @property {Object<string, string>} [serviceLevels] - Per-service log levels
+ */
+
+/**
+ * Result of health check for all services
+ * @typedef {Object<string, HealthStatus>} HealthCheckResult
+ */
+
+/**
+ * Service class constructor type
+ *
+ * @typedef {new (name: string, options?: ServiceOptions) => ServiceInstance} ServiceConstructor
+ */
+
+// ============================================================================
+// INTERNAL TYPES
+// ============================================================================
+
+/**
+ * Internal service registry entry
+ *
+ * @typedef {Object} ServiceEntry
+ * @property {ServiceConstructor} ServiceClass - Service class constructor
+ * @property {ServiceInstance|null} instance - Service instance (lazy-created)
+ * @property {*} config - Service configuration
+ * @property {string[]} dependencies - Service dependencies
+ * @property {Set<string>} dependents - Services that depend on this one
+ * @property {string[]} tags - Service tags
+ * @property {number} priority - Startup priority
+ */
+
+export {};

package/dist/states/index.js

@@ -1 +1 @@
-export * from './navigation.svelte.js';
+export * from './navigation.svelte.js';

package/dist/states/navigation.svelte.js

@@ -1,55 +1,55 @@
-import { onMount } from 'svelte';
-
-import { lazySingleton } from '../util/singleton/index.js';
-
-import { beforeNavigate, onNavigate, afterNavigate } from '$app/navigation';
-
-import { page } from '$app/stores';
-import { get } from 'svelte/store';
-
-class Navigation {
-	// TODO: complete page type
-
-	/** @type {{ url: { pathname: string } }} */
-	page = $state(get(page));
-
-	/** @type {string} */
-	pathname = $derived(this.page.url.pathname);
-
-	stage = $state.raw({ before: false, navigating: true, after: false });
-
-	constructor() {
-		beforeNavigate(() => {
-			this.stage = { before: true, navigating: false, after: false };
-		});
-
-		onNavigate(() => {
-			this.stage = { before: false, navigating: true, after: false };
-		});
-
-		// onNavigate(async () => {
-		//   console.log('onNavigate can be used to perform async page transitions');
-		//   return new Promise((resolve) => {
-		//     setTimeout(resolve, 1000);
-		//   });
-		// });
-
-		afterNavigate(() => {
-			this.stage = { before: false, navigating: false, after: true };
-		});
-
-		onMount(() => {
-			return page.subscribe((value) => {
-				// console.log('***update page url');
-				this.page = value;
-			});
-		});
-	} // end constructor
-
-	init() {}
-} // end class
-
-/**
- * @note call nav.init() during component initialization phase
- */
-export const nav = lazySingleton({ class: Navigation });
+import { onMount } from 'svelte';
+
+import { lazySingleton } from '../util/singleton/index.js';
+
+import { beforeNavigate, onNavigate, afterNavigate } from '$app/navigation';
+
+import { page } from '$app/stores';
+import { get } from 'svelte/store';
+
+class Navigation {
+	// TODO: complete page type
+
+	/** @type {{ url: { pathname: string } }} */
+	page = $state(get(page));
+
+	/** @type {string} */
+	pathname = $derived(this.page.url.pathname);
+
+	stage = $state.raw({ before: false, navigating: true, after: false });
+
+	constructor() {
+		beforeNavigate(() => {
+			this.stage = { before: true, navigating: false, after: false };
+		});
+
+		onNavigate(() => {
+			this.stage = { before: false, navigating: true, after: false };
+		});
+
+		// onNavigate(async () => {
+		//   console.log('onNavigate can be used to perform async page transitions');
+		//   return new Promise((resolve) => {
+		//     setTimeout(resolve, 1000);
+		//   });
+		// });
+
+		afterNavigate(() => {
+			this.stage = { before: false, navigating: false, after: true };
+		});
+
+		onMount(() => {
+			return page.subscribe((value) => {
+				// console.log('***update page url');
+				this.page = value;
+			});
+		});
+	} // end constructor
+
+	init() {}
+} // end class
+
+/**
+ * @note call nav.init() during component initialization phase
+ */
+export const nav = lazySingleton({ class: Navigation });

package/dist/stores/index.js

@@ -1 +1 @@
-export * as theme from './theme.js';
+export * as theme from './theme.js';

package/dist/stores/theme.js

@@ -1,80 +1,80 @@
-/**
- * @example Set theme color in a layout file
- *
- * // +layout.svelte
- * <script>
- * import { theme as themeStore } from './theme.js';
- *
- * const { metaThemeColorBase, metaThemeColorDark } = themeStore;
- * </script>
- *
- * <svelte:head>
- *   <meta
- *     name="theme-color"
- *     media="(prefers-color-scheme: light)"
- *     content={$metaThemeColorBase}
- *   />
- *   <meta
- *     name="theme-color"
- *     media="(prefers-color-scheme: dark)"
- *     content={$metaThemeColorDark}
- *   />
- * </svelte:head>
- */
-
-import { writable, get } from 'svelte/store';
-
-// > Internals
-
-const DEFAULT_THEME_COLOR_BASE = '#fffffe';
-const DEFAULT_THEME_COLOR_DARK = '#000001';
-
-/** @type {import('svelte/store').Writable<string>} */
-const themeColorBase = writable(DEFAULT_THEME_COLOR_BASE);
-
-/** @type {import('svelte/store').Writable<string|null>} */
-const themeColorDark = writable(DEFAULT_THEME_COLOR_DARK);
-
-// > Exports
-
-/**
- * Set meta theme color for both light and dark mode
- *
- * @param {string} value - HTML Color
- */
-export function setMetaThemeColor(value) {
-	themeColorBase.set(value);
-	themeColorDark.set(value);
-}
-
-/**
- * Set meta theme color for light mode
- *
- * @param {string} value - HTML Color
- */
-export function setMetaThemeColorBase(value) {
-	themeColorBase.set(value);
-}
-
-/**
- * Set meta theme color for dark mode only
- *
- * @param {string} value - HTML Color
- */
-export function setMetaThemeColorDark(value) {
-	themeColorDark.set(value);
-}
-
-export const metaThemeColorBase = {
-	subscribe: themeColorBase.subscribe,
-	get: () => {
-		get(themeColorBase);
-	}
-};
-
-export const metaThemeColorDark = {
-	subscribe: themeColorDark.subscribe,
-	get: () => {
-		get(themeColorDark);
-	}
-};
+/**
+ * @example Set theme color in a layout file
+ *
+ * // +layout.svelte
+ * <script>
+ * import { theme as themeStore } from './theme.js';
+ *
+ * const { metaThemeColorBase, metaThemeColorDark } = themeStore;
+ * </script>
+ *
+ * <svelte:head>
+ *   <meta
+ *     name="theme-color"
+ *     media="(prefers-color-scheme: light)"
+ *     content={$metaThemeColorBase}
+ *   />
+ *   <meta
+ *     name="theme-color"
+ *     media="(prefers-color-scheme: dark)"
+ *     content={$metaThemeColorDark}
+ *   />
+ * </svelte:head>
+ */
+
+import { writable, get } from 'svelte/store';
+
+// > Internals
+
+const DEFAULT_THEME_COLOR_BASE = '#fffffe';
+const DEFAULT_THEME_COLOR_DARK = '#000001';
+
+/** @type {import('svelte/store').Writable<string>} */
+const themeColorBase = writable(DEFAULT_THEME_COLOR_BASE);
+
+/** @type {import('svelte/store').Writable<string|null>} */
+const themeColorDark = writable(DEFAULT_THEME_COLOR_DARK);
+
+// > Exports
+
+/**
+ * Set meta theme color for both light and dark mode
+ *
+ * @param {string} value - HTML Color
+ */
+export function setMetaThemeColor(value) {
+	themeColorBase.set(value);
+	themeColorDark.set(value);
+}
+
+/**
+ * Set meta theme color for light mode
+ *
+ * @param {string} value - HTML Color
+ */
+export function setMetaThemeColorBase(value) {
+	themeColorBase.set(value);
+}
+
+/**
+ * Set meta theme color for dark mode only
+ *
+ * @param {string} value - HTML Color
+ */
+export function setMetaThemeColorDark(value) {
+	themeColorDark.set(value);
+}
+
+export const metaThemeColorBase = {
+	subscribe: themeColorBase.subscribe,
+	get: () => {
+		get(themeColorBase);
+	}
+};
+
+export const metaThemeColorDark = {
+	subscribe: themeColorDark.subscribe,
+	get: () => {
+		get(themeColorDark);
+	}
+};

package/dist/typedef/context.js

@@ -1,6 +1,6 @@
-
-/**
- * @typedef {Symbol|'default'} ContextKey
- */
-
-export default {};
+
+/**
+ * @typedef {Symbol|'default'} ContextKey
+ */
+
+export default {};

package/dist/typedef/drag.js

@@ -1,25 +1,25 @@
-/**
- * @typedef {Object} DragData
- * @property {string} draggableId
- * @property {number} offsetX
- * @property {number} offsetY
- * @property {any} item - The item being dragged
- * @property {string} [source] - Source identifier
- */
-
-/**
- * @typedef {Object} SimulatedDragEvent
- * @property {'dragstart'|'dragover'|'dragleave'|'drop'|'dragend'} type
- * @property {number} clientX
- * @property {number} clientY
- * @property {Object} dataTransfer
- * @property {Array<string>} dataTransfer.types
- * @property {Function} dataTransfer.getData
- * @property {'none'|'copy'|'link'|'move'} dataTransfer.dropEffect
- * @property {'none'|'copy'|'copyLink'|'copyMove'|'link'|'linkMove'|'move'|'all'|'uninitialized'} dataTransfer.effectAllowed
- * @property {FileList|Array} dataTransfer.files
- * @property {Function} preventDefault
- * @property {Function} stopPropagation
- */
-
-export default {}
+/**
+ * @typedef {Object} DragData
+ * @property {string} draggableId
+ * @property {number} offsetX
+ * @property {number} offsetY
+ * @property {any} item - The item being dragged
+ * @property {string} [source] - Source identifier
+ */
+
+/**
+ * @typedef {Object} SimulatedDragEvent
+ * @property {'dragstart'|'dragover'|'dragleave'|'drop'|'dragend'} type
+ * @property {number} clientX
+ * @property {number} clientY
+ * @property {Object} dataTransfer
+ * @property {Array<string>} dataTransfer.types
+ * @property {Function} dataTransfer.getData
+ * @property {'none'|'copy'|'link'|'move'} dataTransfer.dropEffect
+ * @property {'none'|'copy'|'copyLink'|'copyMove'|'link'|'linkMove'|'move'|'all'|'uninitialized'} dataTransfer.effectAllowed
+ * @property {FileList|Array} dataTransfer.files
+ * @property {Function} preventDefault
+ * @property {Function} stopPropagation
+ */
+
+export default {}

package/dist/typedef/drop.js

@@ -1,12 +1,12 @@
-/**
- * @typedef {Object} DropData
- * @property {number} x
- * @property {number} y
- * @property {string} zone
- * @property {string} source
- * @property {any} item
- * @property {import('./drag').DragData} drag
- * @property {{offsetX: number, offsetY: number, target: Element}} drop
- */
-
-export default {};
+/**
+ * @typedef {Object} DropData
+ * @property {number} x
+ * @property {number} y
+ * @property {string} zone
+ * @property {string} source
+ * @property {any} item
+ * @property {import('./drag').DragData} drag
+ * @property {{offsetX: number, offsetY: number, target: Element}} drop
+ */
+
+export default {};

package/dist/typedef/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./context.js";
 export * from "./drag.js";
 export * from "./drop.js";
-export * from "./image.js";

package/dist/typedef/index.js

@@ -1,4 +1,4 @@
-export * from './context.js';
-export * from './drag.js';
-export * from './drop.js';
-export * from './image.js';
+export * from './context.js';
+export * from './drag.js';
+export * from './drop.js';
+export * from '../media/typedef.js';