@hkdigital/lib-core 0.3.3 → 0.3.5

package/dist/components/index.d.ts

@@ -0,0 +1,11 @@
+export { default as ButtonGroup } from "./button-group/ButtonGroup.svelte";
+export { default as CompareLeftRight } from "./compare-left-right/CompareLeftRight.svelte";
+export { default as GameBox } from "./game-box/GameBox.svelte";
+export { default as HkAppLayout } from "./hk-app-layout/HkAppLayout.svelte";
+export { default as ImageBox } from "./image-box/ImageBox.svelte";
+export { default as Presenter } from "./presenter/Presenter.svelte";
+export { default as ImageSlide } from "./presenter/ImageSlide.svelte";
+export { default as VirtualViewport } from "./virtual-viewport/VirtualViewport.svelte";
+export * from "./button-group/typedef.js";
+export * from "./presenter/typedef.js";
+export { createOrGetState as createOrGetAppLayoutState, createState as createAppLayoutState, getState as getAppLayoutState } from "./hk-app-layout/HkAppLayout.state.svelte.js";

package/dist/components/index.js

@@ -1,2 +1,23 @@
-// export * as area from "./area/index.js";
-// export * as icon from "./icon/index.js";
+export { default as ButtonGroup } from './button-group/ButtonGroup.svelte';
+export { default as CompareLeftRight } from './compare-left-right/CompareLeftRight.svelte';
+export { default as GameBox } from './game-box/GameBox.svelte';
+
+export {
+  createOrGetState as createOrGetAppLayoutState,
+  createState as createAppLayoutState,
+  getState as getAppLayoutState
+} from './hk-app-layout/HkAppLayout.state.svelte.js';
+
+export { default as HkAppLayout } from './hk-app-layout/HkAppLayout.svelte';
+
+export { default as ImageBox } from './image-box/ImageBox.svelte';
+
+export { default as Presenter } from './presenter/Presenter.svelte';
+export { default as ImageSlide } from './presenter/ImageSlide.svelte';
+
+export { default as VirtualViewport } from './virtual-viewport/VirtualViewport.svelte';
+
+// > Types
+
+export * from './button-group/typedef.js';
+export * from './presenter/typedef.js';

package/dist/{features → components}/presenter/Presenter.svelte

@@ -1,7 +1,7 @@
 <script>
   import { onMount } from 'svelte';
 
-  import { GridLayers } from '../../components/layout/index.js';
+  import { GridLayers } from '../../primitives/layout/index.js';
 
   import { PresenterState } from './Presenter.state.svelte.js';
   import { cssBefore, cssDuring, waitForRender } from './util.js';

package/dist/logging/index.d.ts

@@ -1,5 +1,4 @@
-export { createServerLogger } from "./factories/server.js";
-export { createClientLogger } from "./factories/client.js";
-export { createLogger } from "./factories/universal.js";
-export * from "../classes/logging/typedef.js";
-export { DEBUG, INFO, WARN, ERROR, NONE, LEVELS } from "./constants.js";
+export { createServerLogger } from "./internal/factories/server.js";
+export { createClientLogger } from "./internal/factories/client.js";
+export { createLogger } from "./internal/factories/universal.js";
+export * from "./internal/unified-logger/index.js";

package/dist/logging/index.js

@@ -1,8 +1,7 @@
-export { DEBUG, INFO, WARN, ERROR, NONE, LEVELS } from './constants.js';
-
 // Factories
-export { createServerLogger } from './factories/server.js';
-export { createClientLogger } from './factories/client.js';
-export { createLogger } from './factories/universal.js';
+export { createServerLogger } from './internal/factories/server.js';
+export { createClientLogger } from './internal/factories/client.js';
+export { createLogger } from './internal/factories/universal.js';
 
-export * from '../classes/logging/typedef.js';
+// Logger, constants and typedefs
+export * from './internal/unified-logger/index.js';

package/dist/logging/{adapters → internal/adapters}/console.js

@@ -1,4 +1,4 @@
-import { LEVELS } from '../constants.js';
+import { LEVELS } from '../unified-logger/constants.js';
 
 /**
  * (Browser) console adapter that uses native DevTools styling

package/dist/logging/internal/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./console.js";
+export * from "./pino.js";

package/dist/logging/internal/adapters/index.js

@@ -0,0 +1,2 @@
+export * from './console.js';
+export * from './pino.js';

package/dist/logging/{factories → internal/factories}/client.d.ts

@@ -7,4 +7,4 @@
  * @returns {Logger} Configured logger instance
  */
 export function createClientLogger(name: string, level?: string, consoleOptions?: any): Logger;
-import { Logger } from '../../classes/logging';
+import { Logger } from '../unified-logger';

package/dist/logging/{factories → internal/factories}/client.js

@@ -1,6 +1,6 @@
-import { Logger } from '../../classes/logging';
+import { Logger } from '../unified-logger';
 import { ConsoleAdapter } from '../adapters/console.js';
-import { INFO } from '../constants.js';
+import { INFO } from '../unified-logger/constants.js';
 
 /**
  * Create a client-side logger with console adapter

package/dist/logging/{factories → internal/factories}/server.d.ts

@@ -7,4 +7,4 @@
  * @returns {Logger} Configured logger instance
  */
 export function createServerLogger(name: string, level?: string, pinoOptions?: any): Logger;
-import { Logger } from '../../classes/logging';
+import { Logger } from '../unified-logger';

package/dist/logging/{factories → internal/factories}/server.js

@@ -1,7 +1,7 @@
-import { Logger } from '../../classes/logging';
+import { Logger } from '../unified-logger';
 
 import { PinoAdapter } from '../adapters/pino.js';
-import { INFO } from '../constants.js';
+import { INFO } from '../unified-logger/constants.js';
 
 /**
  * Create a server-side logger with pino adapter

package/dist/{classes/logging → logging/internal/unified-logger}/Logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * Logger class for consistent logging across services
+ * Logger class for consistent logging
  * @extends EventEmitter
  */
 export default class Logger extends EventEmitter {
@@ -64,7 +64,7 @@ export default class Logger extends EventEmitter {
      */
     context(namespace: string, additionalContext: any): Logger;
     /**
-     * Log an event from an event emitter of type LogEvent
+     * Log an LogEvent emitted by an event emitter
      *
      * E.g. an event that was created by another Logger instance and should be
      * forwarded to this logger.
@@ -75,4 +75,4 @@ export default class Logger extends EventEmitter {
     logFromEvent(eventName: string, eventData: import("./typedef.js").LogEventData): boolean;
     #private;
 }
-import { EventEmitter } from '../events';
+import { EventEmitter } from '../../../classes/event-emitter';

package/dist/{classes/logging → logging/internal/unified-logger}/Logger.js

@@ -8,7 +8,7 @@
  *
  * @example
  * // Basic usage
- * import { Logger, INFO, DEBUG } from './Logger.js';
+ * import { Logger, LOG, INFO, DEBUG } from '@hkdigital/lib-core/logger/index.js';
  *
  * const logger = new Logger('myService', INFO);
  *
@@ -18,7 +18,7 @@
  * logger.warn('Unusual condition detected');           // Will be logged
  *
  * // Listen to log events
- * logger.on('log', (logEvent) => {
+ * logger.on(LOG, (logEvent) => {
  *   // Process all log events
  *   saveToLogFile(logEvent);
  * });
@@ -32,12 +32,19 @@
  * logger.setLevel(DEBUG); // Now debug messages will also be logged
  */
 
-import { EventEmitter } from '../events';
+import { EventEmitter } from '../../../classes/event-emitter';
 
-import { DEBUG, INFO, WARN, ERROR, LEVELS } from './constants.js';
+import {
+  DEBUG,
+  INFO,
+  WARN,
+  ERROR,
+  LEVELS,
+  LOG
+} from './constants.js';
 
 /**
- * Logger class for consistent logging across services
+ * Logger class for consistent logging
  * @extends EventEmitter
  */
 export default class Logger extends EventEmitter {
@@ -131,7 +138,7 @@ export default class Logger extends EventEmitter {
    * @returns {Logger} New logger instance with merged context
    */
   context(namespace, additionalContext) {
-    if( typeof namespace !== "string" ) {
+    if (typeof namespace !== 'string') {
       throw new Error('Invalid namespace');
     }
 
@@ -144,7 +151,7 @@ export default class Logger extends EventEmitter {
   }
 
   /**
-   * Log an event from an event emitter of type LogEvent
+   * Log an LogEvent emitted by an event emitter
    *
    * E.g. an event that was created by another Logger instance and should be
    * forwarded to this logger.
@@ -152,7 +159,7 @@ export default class Logger extends EventEmitter {
    * @param {string} eventName
    * @param {import('./typedef.js').LogEventData} eventData
    */
-  logFromEvent( eventName, eventData ) {
+  logFromEvent(eventName, eventData) {
     const level = eventData.level;
 
     // Check if this log level should be filtered
@@ -160,7 +167,7 @@ export default class Logger extends EventEmitter {
       return false; // Below threshold, don't emit
     }
 
-    this.#logEvent( { ...eventData, eventName });
+    this.#logEvent({ ...eventData, eventName });
   }
 
   /**
@@ -188,9 +195,9 @@ export default class Logger extends EventEmitter {
       details: details ?? null
     };
 
-    // Emit as both specific level event and generic 'log' event
+    // Emit as both specific level event and generic LOG event
     this.emit(level, logEvent);
-    this.emit('log', logEvent);
+    this.emit(LOG, logEvent);
 
     return true;
   }
@@ -203,7 +210,7 @@ export default class Logger extends EventEmitter {
   #logEvent(logEvent) {
     // Emit as both specific level event and generic 'log' event
     this.emit(logEvent.level, logEvent);
-    this.emit('log', logEvent);
+    this.emit(LOG, logEvent);
 
     return true;
   }

package/dist/{classes/logging → logging/internal/unified-logger}/constants.d.ts

@@ -10,3 +10,4 @@ export namespace LEVELS {
     let error: number;
     let none: number;
 }
+export const LOG: "log";

package/dist/{classes/logging → logging/internal/unified-logger}/constants.js

@@ -1,9 +1,11 @@
 
-// Log level names
+// Log level and log event names
 export const DEBUG = 'debug';
 export const INFO = 'info';
 export const WARN = 'warn';
 export const ERROR = 'error';
+
+// Use NONE to set log level to disable all logging
 export const NONE = 'none';
 
 // Level values for filtering (higher = more important)
@@ -12,5 +14,9 @@ export const LEVELS = {
   [INFO]: 2,
   [WARN]: 3,
   [ERROR]: 4,
-  [NONE]: 6
+  [NONE]: 5
 };
+
+// Event name for generic events
+export const LOG = 'log';
+

package/dist/{classes/logging → logging/internal/unified-logger}/index.d.ts

@@ -1,2 +1,3 @@
 export { default as Logger } from "./Logger.js";
 export * from "./constants.js";
+export * from "./typedef.js";

package/dist/{classes/logging → logging/internal/unified-logger}/index.js

@@ -1,4 +1,6 @@
 
 export { default as Logger } from './Logger.js';
 
+// Constants and typedefs
 export * from './constants.js';
+export * from './typedef.js';

package/dist/{components → primitives}/buttons/button/Button.svelte.d.ts

@@ -41,4 +41,4 @@ declare const Button: import("svelte").Component<{
     snippetLoading?: import("svelte").Snippet;
     snippetError?: import("svelte").Snippet;
     children: import("svelte").Snippet;
-}, {}, "error" | "loading" | "active" | "selected" | "disabled">;
+}, {}, "error" | "loading" | "selected" | "disabled" | "active">;

package/dist/{components → primitives}/drag-drop/DropZoneArea.svelte.d.ts

@@ -9,7 +9,7 @@ type DropZoneArea = {
         accepts?: (item: any) => boolean;
         fillContainer?: boolean;
         aspectRatio?: string;
-        overflow?: "scroll" | "auto" | "hidden" | "visible";
+        overflow?: "scroll" | "auto" | "visible" | "hidden";
         base?: string;
         classes?: string;
         children?: Snippet<[]>;

package/dist/primitives/index.js

@@ -0,0 +1,2 @@
+// export * as area from "./area/index.js";
+// export * as icon from "./icon/index.js";

package/dist/{components → primitives}/layout/grid-layers/util.js

@@ -1,4 +1,4 @@
-// lib/components/layout/gridLayers.utils.js
+// lib/primitives/layout/gridLayers.utils.js
 
 /**
  * Sets up a ResizeObserver on the target layer

package/dist/{components → primitives}/rows/panel-grid-row/PanelGridRow.svelte.d.ts

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

package/dist/{components → primitives}/rows/panel-row-2/PanelRow2.svelte.d.ts

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

package/dist/services/index.d.ts

@@ -0,0 +1 @@
+export * from "./internal/index.js";

package/dist/services/index.js

@@ -0,0 +1 @@
+export * from './internal/index.js';

package/dist/services/internal/index.d.ts

@@ -0,0 +1,6 @@
+export { default as ServiceBase } from "./service-base/ServiceBase.js";
+export { default as ServiceManager } from "./service-manager/ServiceManager.js";
+export * from "./service-base/constants.js";
+export * from "./service-manager/constants.js";
+export * from "./service-base/typedef.js";
+export * from "./service-manager/typedef.js";

package/dist/services/internal/index.js

@@ -0,0 +1,8 @@
+export { default as ServiceBase } from './service-base/ServiceBase.js';
+export { default as ServiceManager } from './service-manager/ServiceManager.js';
+
+export * from './service-base/constants.js';
+export * from './service-manager/constants.js';
+
+export * from './service-base/typedef.js';
+export * from './service-manager/typedef.js';

package/dist/{classes/services → services/internal/service-base}/ServiceBase.d.ts

@@ -1,5 +1,4 @@
 /**
- * @typedef {import('./typedef.js').ServiceConfig} ServiceConfig
  * @typedef {import('./typedef.js').ServiceOptions} ServiceOptions
  * @typedef {import('./typedef.js').StopOptions} StopOptions
  * @typedef {import('./typedef.js').HealthStatus} HealthStatus
@@ -34,11 +33,11 @@ export class ServiceBase extends EventEmitter {
     /**
      * Initialize the service with configuration
      *
-     * @param {ServiceConfig} [config={}] - Service-specific configuration
+     * @param {*} [config={}] - Service-specific configuration
      *
      * @returns {Promise<boolean>} True if initialization succeeded
      */
-    initialize(config?: ServiceConfig): Promise<boolean>;
+    initialize(config?: any): Promise<boolean>;
     /**
      * Start the service
      *
@@ -83,11 +82,11 @@ export class ServiceBase extends EventEmitter {
      * Initialize the service (override in subclass)
      *
      * @protected
-     * @param {ServiceConfig} config - Service configuration
+     * @param {*} config - Service configuration
      *
      * @returns {Promise<void>}
      */
-    protected _init(config: ServiceConfig): Promise<void>;
+    protected _init(config: any): Promise<void>;
     /**
      * Start the service (override in subclass)
      *
@@ -152,12 +151,11 @@ export class ServiceBase extends EventEmitter {
     private _setError;
 }
 export default ServiceBase;
-export type ServiceConfig = import("./typedef.js").ServiceConfig;
 export type ServiceOptions = import("./typedef.js").ServiceOptions;
 export type StopOptions = import("./typedef.js").StopOptions;
 export type HealthStatus = import("./typedef.js").HealthStatus;
 export type StateChangeEvent = import("./typedef.js").StateChangeEvent;
 export type HealthChangeEvent = import("./typedef.js").HealthChangeEvent;
 export type ServiceErrorEvent = import("./typedef.js").ServiceErrorEvent;
-import { EventEmitter } from '../events';
-import { Logger } from '../logging';
+import { EventEmitter } from '../../../classes/event-emitter';
+import { Logger } from '../../../logging/internal/unified-logger';

package/dist/{classes/services → services/internal/service-base}/ServiceBase.js

@@ -50,8 +50,8 @@
  * }
  */
 
-import { EventEmitter } from '../events';
-import { Logger, INFO } from '../logging';
+import { EventEmitter } from '../../../classes/event-emitter';
+import { Logger, INFO } from '../../../logging/internal/unified-logger';
 
 import {
   CREATED,
@@ -65,10 +65,9 @@ import {
   DESTROYED,
   ERROR as ERROR_STATE,
   RECOVERING
-} from './service-states.js';
+} from './constants.js';
 
 /**
- * @typedef {import('./typedef.js').ServiceConfig} ServiceConfig
  * @typedef {import('./typedef.js').ServiceOptions} ServiceOptions
  * @typedef {import('./typedef.js').StopOptions} StopOptions
  * @typedef {import('./typedef.js').HealthStatus} HealthStatus
@@ -113,7 +112,7 @@ export class ServiceBase extends EventEmitter {
   /**
    * Initialize the service with configuration
    *
-   * @param {ServiceConfig} [config={}] - Service-specific configuration
+   * @param {*} [config={}] - Service-specific configuration
    *
    * @returns {Promise<boolean>} True if initialization succeeded
    */
@@ -335,7 +334,7 @@ export class ServiceBase extends EventEmitter {
    * Initialize the service (override in subclass)
    *
    * @protected
-   * @param {ServiceConfig} config - Service configuration
+   * @param {*} config - Service configuration
    *
    * @returns {Promise<void>}
    */

package/dist/{classes/services/service-states.d.ts → services/internal/service-base/constants.d.ts}

@@ -1,36 +1,3 @@
-/**
- * Check if a state transition is valid
- *
- * @param {string} fromState - Current state
- * @param {string} toState - Desired state
- *
- * @returns {boolean} True if transition is valid
- */
-export function isValidTransition(fromState: string, toState: string): boolean;
-/**
- * Check if a service is in an operational state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if operational
- */
-export function isOperational(state: string): boolean;
-/**
- * Check if a service is in a transitional state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if transitioning
- */
-export function isTransitioning(state: string): boolean;
-/**
- * Check if a service is in an inactive state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if inactive
- */
-export function isInactive(state: string): boolean;
 /**
  * @fileoverview Service state constants for the service management system.
  *
@@ -129,31 +96,3 @@ export const ERROR: "error";
  * @const {string}
  */
 export const RECOVERING: "recovering";
-export namespace VALID_TRANSITIONS {
-    let created: string[];
-    let initializing: string[];
-    let initialized: string[];
-    let starting: string[];
-    let running: string[];
-    let stopping: string[];
-    let stopped: string[];
-    let destroying: string[];
-    let destroyed: string[];
-    let error: string[];
-    let recovering: string[];
-}
-/**
- * States that indicate the service is operational
- * @const {string[]}
- */
-export const OPERATIONAL_STATES: string[];
-/**
- * States that indicate the service is transitioning
- * @const {string[]}
- */
-export const TRANSITIONAL_STATES: string[];
-/**
- * States that indicate the service is not operational
- * @const {string[]}
- */
-export const INACTIVE_STATES: string[];

package/dist/{classes/services/service-states.js → services/internal/service-base/constants.js}

@@ -108,98 +108,3 @@ export const ERROR = 'error';
  * @const {string}
  */
 export const RECOVERING = 'recovering';
-
-/**
- * Valid state transitions map
- * Maps each state to the states it can transition to
- * @const {Object<string, string[]>}
- */
-export const VALID_TRANSITIONS = {
-  [CREATED]: [INITIALIZING, DESTROYING],
-  [INITIALIZING]: [INITIALIZED, ERROR, DESTROYING],
-  [INITIALIZED]: [STARTING, DESTROYING],
-  [STARTING]: [RUNNING, ERROR, STOPPING],
-  [RUNNING]: [STOPPING, ERROR],
-  [STOPPING]: [STOPPED, ERROR],
-  [STOPPED]: [STARTING, DESTROYING, INITIALIZING],
-  [DESTROYING]: [DESTROYED, ERROR],
-  [DESTROYED]: [CREATED], // Can be recreated
-  [ERROR]: [RECOVERING, STOPPING, DESTROYING],
-  [RECOVERING]: [RUNNING, STOPPED, ERROR]
-};
-
-/**
- * States that indicate the service is operational
- * @const {string[]}
- */
-export const OPERATIONAL_STATES = [RUNNING];
-
-/**
- * States that indicate the service is transitioning
- * @const {string[]}
- */
-export const TRANSITIONAL_STATES = [
-  INITIALIZING,
-  STARTING,
-  STOPPING,
-  DESTROYING,
-  RECOVERING
-];
-
-/**
- * States that indicate the service is not operational
- * @const {string[]}
- */
-export const INACTIVE_STATES = [
-  CREATED,
-  INITIALIZED,
-  STOPPED,
-  DESTROYED,
-  ERROR
-];
-
-/**
- * Check if a state transition is valid
- *
- * @param {string} fromState - Current state
- * @param {string} toState - Desired state
- *
- * @returns {boolean} True if transition is valid
- */
-export function isValidTransition(fromState, toState) {
-  const validStates = VALID_TRANSITIONS[fromState];
-  return validStates ? validStates.includes(toState) : false;
-}
-
-/**
- * Check if a service is in an operational state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if operational
- */
-export function isOperational(state) {
-  return OPERATIONAL_STATES.includes(state);
-}
-
-/**
- * Check if a service is in a transitional state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if transitioning
- */
-export function isTransitioning(state) {
-  return TRANSITIONAL_STATES.includes(state);
-}
-
-/**
- * Check if a service is in an inactive state
- *
- * @param {string} state - Current state
- *
- * @returns {boolean} True if inactive
- */
-export function isInactive(state) {
-  return INACTIVE_STATES.includes(state);
-}

package/dist/services/internal/service-base/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ServiceBase.js";
+export * from "./constants.js";
+export * from "./typedef.js";

package/dist/services/internal/service-base/index.js

@@ -0,0 +1,3 @@
+export * from './ServiceBase.js';
+export * from './constants.js';
+export * from './typedef.js';