@hkdigital/lib-core 0.5.17 → 0.5.18

package/dist/app/info.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @typedef {import('./typedef.js').AppInfo} AppInfo
+ */
+/**
+ * Get application information
+ *
+ * @returns {AppInfo} app info
+ *
+ * @example
+ * const appInfo = getAppInfo();
+ * // { appVersion: '1.2.3', buildTimestamp: '2025-01-15T10:30:00Z' }
+ */
+export function getAppInfo(): AppInfo;
+/**
+ * Application version from environment variables
+ *
+ * @type {string}
+ */
+export const appVersion: string;
+/**
+ * Build timestamp from environment variables
+ *
+ * @type {string}
+ */
+export const buildTimestamp: string;
+export type AppInfo = import("./typedef.js").AppInfo;

package/dist/app/info.js

@@ -0,0 +1,33 @@
+/**
+ * Application version from environment variables
+ *
+ * @type {string}
+ */
+export const appVersion = import.meta.env.VITE_APP_VERSION || '0.0.0';
+
+/**
+ * Build timestamp from environment variables
+ *
+ * @type {string}
+ */
+export const buildTimestamp = import.meta.env.VITE_BUILD_TIMESTAMP ?? '';
+
+/**
+ * @typedef {import('./typedef.js').AppInfo} AppInfo
+ */
+
+/**
+ * Get application information
+ *
+ * @returns {AppInfo} app info
+ *
+ * @example
+ * const appInfo = getAppInfo();
+ * // { appVersion: '1.2.3', buildTimestamp: '2025-01-15T10:30:00Z' }
+ */
+export function getAppInfo() {
+  return {
+    appVersion,
+    buildTimestamp
+  };
+}

package/dist/app/typedef.d.ts

@@ -0,0 +1,4 @@
+export type AppInfo = {
+    appVersion: string;
+    buildTimestamp: string;
+};

package/dist/app/typedef.js

@@ -0,0 +1,8 @@
+/**
+ * @typedef {{
+ *   appVersion: string,
+ *   buildTimestamp: string
+ * }} AppInfo
+ */
+
+export {};

package/dist/browser/info/device.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Check if the device is Apple mobile (iPhone, iPod, or iPad)
+ *
+ * @returns {boolean} true if Apple mobile device
+ */
+export function getIsAppleMobile(): boolean;
+/**
+ * Check if the device is Android mobile (phone or tablet)
+ *
+ * @example
+ * // Android phone: true
+ * // Android tablet: true
+ * // Android TV: false
+ * // Desktop, iOS: false
+ *
+ * @returns {boolean} true if Android mobile device
+ */
+export function getIsAndroidMobile(): boolean;
+/**
+ * Check if the device is running iPadOS
+ *
+ * @returns {boolean} true if iPadOS device
+ */
+export function getIsIpadOS(): boolean;
+/**
+ * Check if the device is a tablet
+ *
+ * @example
+ * // iPad, Android tablets: true
+ * // iPhone, Android phones, Desktop: false
+ *
+ * @returns {boolean} true if tablet device
+ */
+export function getIsTablet(): boolean;
+/**
+ * Check if the device is a phone (not tablet)
+ *
+ * @example
+ * // iPhone, Android phones: true
+ * // iPad, tablets, Desktop: false
+ *
+ * @returns {boolean} true if phone device
+ */
+export function getIsPhone(): boolean;
+/**
+ * Check if the device is a mobile phone or tablet
+ *
+ * @example
+ * // iPhone, iPad: true
+ * // Android phone, Android tablet: true
+ * // Android TV, Desktop: false
+ *
+ * @returns {boolean} true if mobile device
+ */
+export function getIsMobile(): boolean;
+/**
+ * Get device type
+ *
+ * @example
+ * // iPhone, Android phone: 'phone'
+ * // iPad, Android tablet: 'tablet'
+ * // Android TV: 'tv'
+ * // Desktop/laptop: 'desktop'
+ *
+ * @returns {'phone'|'tablet'|'tv'|'desktop'} device type
+ */
+export function getDeviceType(): "phone" | "tablet" | "tv" | "desktop";

package/dist/browser/info/device.js

@@ -0,0 +1,183 @@
+
+/**
+ * Check if the device is Apple mobile (iPhone, iPod, or iPad)
+ *
+ * @returns {boolean} true if Apple mobile device
+ */
+export function getIsAppleMobile() {
+  if (/iPad|iPhone|iPod/.test(navigator.platform)) {
+    return true;
+  }
+
+  return getIsIpadOS();
+}
+
+/**
+ * Check if the device is Android mobile (phone or tablet)
+ *
+ * @example
+ * // Android phone: true
+ * // Android tablet: true
+ * // Android TV: false
+ * // Desktop, iOS: false
+ *
+ * @returns {boolean} true if Android mobile device
+ */
+export function getIsAndroidMobile() {
+  const ua = navigator.userAgent;
+
+  // Check for Android
+  if (!/Android/.test(ua)) {
+    return false;
+  }
+
+  // Exclude Android TV and other non-mobile Android devices
+  if (/TV|SmartTV|BRAVIA/.test(ua)) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Check if the device is running iPadOS
+ *
+ * @returns {boolean} true if iPadOS device
+ */
+export function getIsIpadOS() {
+  return (
+    navigator.maxTouchPoints > 2 &&
+    /MacIntel/.test(navigator.platform)
+  );
+}
+
+/**
+ * Check if the device is a tablet
+ *
+ * @example
+ * // iPad, Android tablets: true
+ * // iPhone, Android phones, Desktop: false
+ *
+ * @returns {boolean} true if tablet device
+ */
+export function getIsTablet() {
+  // Must have touch support
+  if (!navigator.maxTouchPoints || navigator.maxTouchPoints === 0) {
+    return false;
+  }
+
+  const ua = navigator.userAgent;
+
+  // iPad or iPadOS
+  if (getIsIpadOS()) {
+    return true;
+  }
+
+  // iPad with older iOS versions
+  if (/iPad/.test(navigator.platform)) {
+    return true;
+  }
+
+  // Android tablets typically don't have "Mobile" in UA
+  if (/Android/.test(ua) && !/Mobile/.test(ua)) {
+    // Exclude Android TV
+    if (/TV|SmartTV|BRAVIA/.test(ua)) {
+      return false;
+    }
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Check if the device is a phone (not tablet)
+ *
+ * @example
+ * // iPhone, Android phones: true
+ * // iPad, tablets, Desktop: false
+ *
+ * @returns {boolean} true if phone device
+ */
+export function getIsPhone() {
+  // Must have touch support
+  if (!navigator.maxTouchPoints || navigator.maxTouchPoints === 0) {
+    return false;
+  }
+
+  const ua = navigator.userAgent;
+
+  // iPhone or iPod (not iPad)
+  if (/iPhone|iPod/.test(navigator.platform)) {
+    return true;
+  }
+
+  // Android with "Mobile" marker (phones have this, tablets don't)
+  if (/Android/.test(ua) && /Mobile/.test(ua)) {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Check if the device is a mobile phone or tablet
+ *
+ * @example
+ * // iPhone, iPad: true
+ * // Android phone, Android tablet: true
+ * // Android TV, Desktop: false
+ *
+ * @returns {boolean} true if mobile device
+ */
+export function getIsMobile() {
+  // @ts-ignore
+  if (navigator?.userAgentData?.mobile !== undefined) {
+    // Modern API - most reliable
+    // @ts-ignore
+    return navigator.userAgentData.mobile;
+  }
+
+  if (getIsAppleMobile()) {
+    return true;
+  }
+
+  if (getIsAndroidMobile()) {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Get device type
+ *
+ * @example
+ * // iPhone, Android phone: 'phone'
+ * // iPad, Android tablet: 'tablet'
+ * // Android TV: 'tv'
+ * // Desktop/laptop: 'desktop'
+ *
+ * @returns {'phone'|'tablet'|'tv'|'desktop'} device type
+ */
+export function getDeviceType() {
+  const ua = navigator.userAgent;
+
+  // Check for TV first
+  if (/TV|SmartTV|BRAVIA/.test(ua)) {
+    return 'tv';
+  }
+
+  // Check for tablet (requires touch)
+  if (getIsTablet()) {
+    return 'tablet';
+  }
+
+  // Check for phone (requires touch)
+  if (getIsPhone()) {
+    return 'phone';
+  }
+
+  // Default to desktop
+  return 'desktop';
+}

package/dist/browser/info/display.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Check if the app is running as a PWA
+ *
+ * @returns {boolean} true if running as PWA
+ */
+export function getIsPwa(): boolean;
+/**
+ * Check if window is in fullscreen mode
+ *
+ * @returns {boolean} true if fullscreen
+ */
+export function getIsFullscreen(): boolean;
+/**
+ * Get screen dimensions (physical screen size)
+ *
+ * @example
+ * // Desktop: {width: 1920, height: 1080}
+ * // iPhone 14: {width: 390, height: 844}
+ * // iPad Pro: {width: 1024, height: 1366}
+ *
+ * @returns {{width: number, height: number}} screen dimensions
+ */
+export function getScreenSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Get viewport dimensions (visible browser area)
+ *
+ * @example
+ * // Full screen: {width: 1920, height: 1080}
+ * // Windowed: {width: 1200, height: 800}
+ * // Mobile with address bar: {width: 390, height: 750}
+ *
+ * @returns {{width: number, height: number}} viewport dimensions
+ */
+export function getViewportSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Get screen orientation
+ *
+ * @example
+ * // Phone held upright: 'portrait'
+ * // Phone rotated: 'landscape'
+ * // Desktop: 'landscape'
+ *
+ * @returns {'portrait'|'landscape'} screen orientation
+ */
+export function getOrientation(): "portrait" | "landscape";
+/**
+ * Get device pixel ratio (retina displays have higher values)
+ *
+ * @example
+ * // Standard display: 1
+ * // Retina/High-DPI: 2 or 3
+ * // iPhone 14 Pro: 3
+ *
+ * @returns {number} device pixel ratio
+ */
+export function getDevicePixelRatio(): number;
+/**
+ * Check if device has touch support
+ *
+ * @example
+ * // Mobile phones/tablets: true
+ * // Desktop with touch screen: true
+ * // Desktop without touch: false
+ *
+ * @returns {boolean} true if touch is supported
+ */
+export function hasTouchSupport(): boolean;

package/dist/browser/info/display.js

@@ -0,0 +1,109 @@
+/**
+ * Check if the app is running as a PWA
+ *
+ * @returns {boolean} true if running as PWA
+ */
+export function getIsPwa() {
+  return window.matchMedia(
+    '(display-mode: fullscreen) or (display-mode: standalone)'
+  ).matches;
+}
+
+/**
+ * Check if window is in fullscreen mode
+ *
+ * @returns {boolean} true if fullscreen
+ */
+export function getIsFullscreen() {
+  if (getIsPwa()) {
+    return true;
+  } else if (document.fullscreenElement) {
+    // Safari
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Get screen dimensions (physical screen size)
+ *
+ * @example
+ * // Desktop: {width: 1920, height: 1080}
+ * // iPhone 14: {width: 390, height: 844}
+ * // iPad Pro: {width: 1024, height: 1366}
+ *
+ * @returns {{width: number, height: number}} screen dimensions
+ */
+export function getScreenSize() {
+  return {
+    width: window.screen.width,
+    height: window.screen.height
+  };
+}
+
+/**
+ * Get viewport dimensions (visible browser area)
+ *
+ * @example
+ * // Full screen: {width: 1920, height: 1080}
+ * // Windowed: {width: 1200, height: 800}
+ * // Mobile with address bar: {width: 390, height: 750}
+ *
+ * @returns {{width: number, height: number}} viewport dimensions
+ */
+export function getViewportSize() {
+  return {
+    width: window.innerWidth,
+    height: window.innerHeight
+  };
+}
+
+/**
+ * Get screen orientation
+ *
+ * @example
+ * // Phone held upright: 'portrait'
+ * // Phone rotated: 'landscape'
+ * // Desktop: 'landscape'
+ *
+ * @returns {'portrait'|'landscape'} screen orientation
+ */
+export function getOrientation() {
+  return window.matchMedia('(orientation: portrait)').matches
+    ? 'portrait'
+    : 'landscape';
+}
+
+/**
+ * Get device pixel ratio (retina displays have higher values)
+ *
+ * @example
+ * // Standard display: 1
+ * // Retina/High-DPI: 2 or 3
+ * // iPhone 14 Pro: 3
+ *
+ * @returns {number} device pixel ratio
+ */
+export function getDevicePixelRatio() {
+  return window.devicePixelRatio || 1;
+}
+
+/**
+ * Check if device has touch support
+ *
+ * @example
+ * // Mobile phones/tablets: true
+ * // Desktop with touch screen: true
+ * // Desktop without touch: false
+ *
+ * @returns {boolean} true if touch is supported
+ */
+export function hasTouchSupport() {
+  return (
+    'ontouchstart' in window ||
+    navigator.maxTouchPoints > 0 ||
+    // @ts-ignore
+    navigator.msMaxTouchPoints > 0
+  );
+}

package/dist/browser/info/engine.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Get browser rendering engine
+ *
+ * @example
+ * // Firefox: 'gecko'
+ * // Chrome, Edge, Brave, Vivaldi, Arc: 'blink'
+ * // Safari: 'webkit'
+ *
+ * @returns {'blink'|'gecko'|'webkit'|'unknown'} browser engine
+ */
+export function getBrowserEngine(): "blink" | "gecko" | "webkit" | "unknown";
+/**
+ * Get simplified browser name
+ *
+ * @example
+ * // 'Firefox', 'Edge', 'Safari', 'Chromium' (Chrome/Brave/Vivaldi/Arc)
+ *
+ * @returns {string} browser name
+ */
+export function getBrowserName(): string;
+/**
+ * Get browser vendor
+ *
+ * @example
+ * // 'Google Inc.', 'Apple Computer, Inc.', ''
+ *
+ * @returns {string} browser vendor
+ */
+export function getVendor(): string;
+/**
+ * Get user agent string
+ *
+ * @example
+ * // 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...'
+ * // 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)...'
+ *
+ * @returns {string} user agent
+ */
+export function getUserAgent(): string;

package/dist/browser/info/engine.js

@@ -0,0 +1,64 @@
+/**
+ * Get browser rendering engine
+ *
+ * @example
+ * // Firefox: 'gecko'
+ * // Chrome, Edge, Brave, Vivaldi, Arc: 'blink'
+ * // Safari: 'webkit'
+ *
+ * @returns {'blink'|'gecko'|'webkit'|'unknown'} browser engine
+ */
+export function getBrowserEngine() {
+  const ua = navigator.userAgent;
+
+  if (ua.includes('Firefox/')) return 'gecko';
+  if (ua.includes('Edg/')) return 'blink';
+  if (ua.includes('Chrome/')) return 'blink';
+  if (ua.includes('Safari/') && !ua.includes('Chrome/')) return 'webkit';
+
+  return 'unknown';
+}
+
+/**
+ * Get simplified browser name
+ *
+ * @example
+ * // 'Firefox', 'Edge', 'Safari', 'Chromium' (Chrome/Brave/Vivaldi/Arc)
+ *
+ * @returns {string} browser name
+ */
+export function getBrowserName() {
+  const ua = navigator.userAgent;
+
+  if (ua.includes('Firefox/')) return 'Firefox';
+  if (ua.includes('Edg/')) return 'Edge';
+  if (ua.includes('Safari/') && !ua.includes('Chrome/')) return 'Safari';
+  if (ua.includes('Chrome/')) return 'Chromium';
+
+  return 'Unknown';
+}
+
+/**
+ * Get browser vendor
+ *
+ * @example
+ * // 'Google Inc.', 'Apple Computer, Inc.', ''
+ *
+ * @returns {string} browser vendor
+ */
+export function getVendor() {
+  return navigator.vendor || '';
+}
+
+/**
+ * Get user agent string
+ *
+ * @example
+ * // 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...'
+ * // 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)...'
+ *
+ * @returns {string} user agent
+ */
+export function getUserAgent() {
+  return navigator.userAgent;
+}

package/dist/browser/info/language.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Get browser language
+ *
+ * @example
+ * // 'en-US', 'nl-NL', 'fr-FR', 'de-DE'
+ *
+ * @returns {string} browser language code
+ */
+export function getLanguage(): string;
+/**
+ * Get all preferred languages
+ *
+ * @example
+ * // ['en-US', 'en', 'nl-NL']
+ *
+ * @returns {string[]} array of language codes
+ */
+export function getLanguages(): string[];

package/dist/browser/info/language.js

@@ -0,0 +1,23 @@
+/**
+ * Get browser language
+ *
+ * @example
+ * // 'en-US', 'nl-NL', 'fr-FR', 'de-DE'
+ *
+ * @returns {string} browser language code
+ */
+export function getLanguage() {
+  return navigator.language || 'en';
+}
+
+/**
+ * Get all preferred languages
+ *
+ * @example
+ * // ['en-US', 'en', 'nl-NL']
+ *
+ * @returns {string[]} array of language codes
+ */
+export function getLanguages() {
+  return navigator.languages || [navigator.language || 'en'];
+}

package/dist/browser/info/system.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Get simplified platform identifier
+ *
+ * @example
+ * // 'macos', 'windows', 'linux', 'ios', 'android', 'unknown'
+ *
+ * @returns {string} platform identifier
+ */
+export function getPlatform(): string;
+/**
+ * Get raw platform string from navigator
+ *
+ * @example
+ * // 'MacIntel', 'Win32', 'Linux x86_64', 'iPhone', 'iPad'
+ *
+ * @returns {string} raw platform identifier
+ */
+export function getPlatformRaw(): string;
+/**
+ * Get number of CPU cores (logical processors)
+ *
+ * @example
+ * // Desktop: 8, 16, 24
+ * // Mobile: 4, 6, 8
+ * // Older devices: 2
+ *
+ * @returns {number} number of logical processors
+ */
+export function getCpuCores(): number;
+/**
+ * Check if device is online
+ *
+ * @example
+ * // true (connected), false (offline)
+ *
+ * @returns {boolean} true if online
+ */
+export function isOnline(): boolean;
+/**
+ * Get connection type if available (experimental API)
+ *
+ * @example
+ * // '4g', '3g', 'slow-2g', 'wifi', null
+ *
+ * @returns {string|null} connection type or null
+ */
+export function getConnectionType(): string | null;