@lukso/core 0.1.0-dev.0f1bea5

package/dist/services/intl.d.cts

@@ -0,0 +1,170 @@
+import { FormatNumberOptions, IntlConfig } from '@formatjs/intl';
+
+/**
+ * Internationalization Service
+ *
+ * Provides locale-aware formatting for messages, numbers, dates, and times.
+ */
+
+/**
+ * Translation messages object type
+ * Maps translation keys to their corresponding string values
+ */
+type IntlMessages = Record<string, string>;
+/**
+ * Intl service interface
+ */
+interface IntlService {
+    /**
+     * Translate a string based on the key
+     *
+     * @param key - translation key
+     * @param options - optional options for formatMessage (for variable interpolation)
+     * @returns - translated string
+     */
+    formatMessage: (key: string, options?: Record<string, string>) => string;
+    /**
+     * Number formatting based on the locale
+     *
+     * @param value - number to format
+     * @param options - options for formatNumber
+     * @returns - formatted number
+     */
+    formatNumber: (value: number | string | bigint, options?: FormatNumberOptions) => string;
+    /**
+     * Date formatting based on the locale
+     *
+     * @param date - date to format
+     * @returns - formatted date
+     */
+    formatDate: (date?: string | number | Date) => string | undefined;
+    /**
+     * Time formatting based on the locale
+     *
+     * @param date - date to format
+     * @returns - formatted time
+     */
+    formatTime: (date?: string | number | Date) => string | undefined;
+    /**
+     * Timestamp formatting based on the locale
+     *
+     * @param timestamp - UNIX timestamp in seconds or milliseconds
+     * @param options - formatting options (predefined format name or custom Intl.DateTimeFormat options)
+     * @returns - formatted date & time string
+     *
+     * @example
+     * ```typescript
+     * const intl = getIntlService();
+     *
+     * // Use predefined shortDateTime format
+     * intl.formatTimestamp(1733251200, 'shortDateTime'); // "Wed, Dec 3, 2025, 16:07"
+     *
+     * // Use custom format options
+     * intl.formatTimestamp(1733251200, { year: '2-digit', month: '2-digit', day: '2-digit' });
+     * // "12/03/25"
+     *
+     * // No options (basic format)
+     * intl.formatTimestamp(1733251200);
+     * ```
+     */
+    formatTimestamp: (timestamp?: number | string, options?: Intl.DateTimeFormatOptions | string) => string;
+    /**
+     * Change the locale and optionally update messages
+     *
+     * @param locale - new locale code (e.g., 'en-US', 'de-DE')
+     * @param messages - optional new messages object for the locale
+     */
+    setLocale: (locale: string, messages?: IntlMessages) => void;
+    /**
+     * Get the current locale
+     *
+     * @returns - current locale code (e.g., 'en-US', 'de-DE')
+     */
+    getLocale: () => string;
+    /**
+     * Set fallback translations to use when a translation key is missing
+     * Useful when the host app's intl service doesn't have all translations
+     *
+     * @param fallbackMessages - translations to use as fallback
+     *
+     * @example
+     * ```typescript
+     * // After intl service is initialized by host app
+     * intl.setFallbackTranslations(defaultMessages);
+     * ```
+     */
+    setFallbackTranslations: (fallbackMessages: IntlMessages) => void;
+    /**
+     * Signal that tracks locale changes
+     * Use this signal to reactively update UI when locale changes
+     */
+    localeChanged: {
+        value: number;
+    };
+}
+/**
+ * Default configuration for intl
+ */
+declare const defaultConfig: IntlConfig;
+/**
+ * Create a new intl service instance
+ *
+ * @param config - intl configuration with locale and messages
+ * @returns IntlService instance with formatting methods
+ *
+ * @example
+ * ```typescript
+ * import { createIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = createIntlService({
+ *   locale: 'en-US',
+ *   messages: customMessages,
+ * });
+ *
+ * const translated = intl.formatMessage('app.title');
+ * const formatted = intl.formatNumber(1234.56);
+ * const currentLocale = intl.getLocale(); // 'en-US'
+ *
+ * // Change locale
+ * intl.setLocale('de-DE', germanMessages);
+ * console.log(intl.getLocale()); // 'de-DE'
+ * ```
+ */
+declare function createIntlService(config?: IntlConfig): IntlService;
+/**
+ * Set the global intl service
+ * Call this once from your app initialization
+ *
+ * @param service - IntlService instance
+ *
+ * @example
+ * ```typescript
+ * import { setIntlService, createIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = createIntlService(config);
+ * setIntlService(intl);
+ * ```
+ */
+declare function setIntlService(service: IntlService): void;
+/**
+ * Get the current global intl service
+ * Returns null if no service has been set
+ *
+ * @example
+ * ```typescript
+ * import { getIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = getIntlService();
+ * if (intl) {
+ *   console.log(intl.getLocale());
+ * }
+ * ```
+ */
+declare function getIntlService(): IntlService | null;
+/**
+ * Clear the global intl service
+ * Useful for testing or cleanup
+ */
+declare function clearIntlService(): void;
+
+export { type IntlMessages, type IntlService, clearIntlService, createIntlService, defaultConfig, getIntlService, setIntlService };

package/dist/services/intl.d.ts

@@ -0,0 +1,170 @@
+import { FormatNumberOptions, IntlConfig } from '@formatjs/intl';
+
+/**
+ * Internationalization Service
+ *
+ * Provides locale-aware formatting for messages, numbers, dates, and times.
+ */
+
+/**
+ * Translation messages object type
+ * Maps translation keys to their corresponding string values
+ */
+type IntlMessages = Record<string, string>;
+/**
+ * Intl service interface
+ */
+interface IntlService {
+    /**
+     * Translate a string based on the key
+     *
+     * @param key - translation key
+     * @param options - optional options for formatMessage (for variable interpolation)
+     * @returns - translated string
+     */
+    formatMessage: (key: string, options?: Record<string, string>) => string;
+    /**
+     * Number formatting based on the locale
+     *
+     * @param value - number to format
+     * @param options - options for formatNumber
+     * @returns - formatted number
+     */
+    formatNumber: (value: number | string | bigint, options?: FormatNumberOptions) => string;
+    /**
+     * Date formatting based on the locale
+     *
+     * @param date - date to format
+     * @returns - formatted date
+     */
+    formatDate: (date?: string | number | Date) => string | undefined;
+    /**
+     * Time formatting based on the locale
+     *
+     * @param date - date to format
+     * @returns - formatted time
+     */
+    formatTime: (date?: string | number | Date) => string | undefined;
+    /**
+     * Timestamp formatting based on the locale
+     *
+     * @param timestamp - UNIX timestamp in seconds or milliseconds
+     * @param options - formatting options (predefined format name or custom Intl.DateTimeFormat options)
+     * @returns - formatted date & time string
+     *
+     * @example
+     * ```typescript
+     * const intl = getIntlService();
+     *
+     * // Use predefined shortDateTime format
+     * intl.formatTimestamp(1733251200, 'shortDateTime'); // "Wed, Dec 3, 2025, 16:07"
+     *
+     * // Use custom format options
+     * intl.formatTimestamp(1733251200, { year: '2-digit', month: '2-digit', day: '2-digit' });
+     * // "12/03/25"
+     *
+     * // No options (basic format)
+     * intl.formatTimestamp(1733251200);
+     * ```
+     */
+    formatTimestamp: (timestamp?: number | string, options?: Intl.DateTimeFormatOptions | string) => string;
+    /**
+     * Change the locale and optionally update messages
+     *
+     * @param locale - new locale code (e.g., 'en-US', 'de-DE')
+     * @param messages - optional new messages object for the locale
+     */
+    setLocale: (locale: string, messages?: IntlMessages) => void;
+    /**
+     * Get the current locale
+     *
+     * @returns - current locale code (e.g., 'en-US', 'de-DE')
+     */
+    getLocale: () => string;
+    /**
+     * Set fallback translations to use when a translation key is missing
+     * Useful when the host app's intl service doesn't have all translations
+     *
+     * @param fallbackMessages - translations to use as fallback
+     *
+     * @example
+     * ```typescript
+     * // After intl service is initialized by host app
+     * intl.setFallbackTranslations(defaultMessages);
+     * ```
+     */
+    setFallbackTranslations: (fallbackMessages: IntlMessages) => void;
+    /**
+     * Signal that tracks locale changes
+     * Use this signal to reactively update UI when locale changes
+     */
+    localeChanged: {
+        value: number;
+    };
+}
+/**
+ * Default configuration for intl
+ */
+declare const defaultConfig: IntlConfig;
+/**
+ * Create a new intl service instance
+ *
+ * @param config - intl configuration with locale and messages
+ * @returns IntlService instance with formatting methods
+ *
+ * @example
+ * ```typescript
+ * import { createIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = createIntlService({
+ *   locale: 'en-US',
+ *   messages: customMessages,
+ * });
+ *
+ * const translated = intl.formatMessage('app.title');
+ * const formatted = intl.formatNumber(1234.56);
+ * const currentLocale = intl.getLocale(); // 'en-US'
+ *
+ * // Change locale
+ * intl.setLocale('de-DE', germanMessages);
+ * console.log(intl.getLocale()); // 'de-DE'
+ * ```
+ */
+declare function createIntlService(config?: IntlConfig): IntlService;
+/**
+ * Set the global intl service
+ * Call this once from your app initialization
+ *
+ * @param service - IntlService instance
+ *
+ * @example
+ * ```typescript
+ * import { setIntlService, createIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = createIntlService(config);
+ * setIntlService(intl);
+ * ```
+ */
+declare function setIntlService(service: IntlService): void;
+/**
+ * Get the current global intl service
+ * Returns null if no service has been set
+ *
+ * @example
+ * ```typescript
+ * import { getIntlService } from '@lukso/core/services/intl';
+ *
+ * const intl = getIntlService();
+ * if (intl) {
+ *   console.log(intl.getLocale());
+ * }
+ * ```
+ */
+declare function getIntlService(): IntlService | null;
+/**
+ * Clear the global intl service
+ * Useful for testing or cleanup
+ */
+declare function clearIntlService(): void;
+
+export { type IntlMessages, type IntlService, clearIntlService, createIntlService, defaultConfig, getIntlService, setIntlService };

package/dist/services/intl.js

@@ -0,0 +1,15 @@
+import {
+  clearIntlService,
+  createIntlService,
+  defaultConfig,
+  getIntlService,
+  setIntlService
+} from "../chunk-4TNWG4ME.js";
+export {
+  clearIntlService,
+  createIntlService,
+  defaultConfig,
+  getIntlService,
+  setIntlService
+};
+//# sourceMappingURL=intl.js.map

package/dist/services/intl.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/index.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkMBIRTPNMcjs = require('../chunk-MBIRTPNM.cjs');
+
+
+
+
+exports.EXTENSION_STORE_LINKS = _chunkMBIRTPNMcjs.EXTENSION_STORE_LINKS; exports.browserInfo = _chunkMBIRTPNMcjs.browserInfo; exports.slug = _chunkMBIRTPNMcjs.slug;
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/service-auth-simple/service-auth-simple/packages/core/dist/utils/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACF,oKAAC","file":"/home/runner/work/service-auth-simple/service-auth-simple/packages/core/dist/utils/index.cjs"}

package/dist/utils/index.d.cts

@@ -0,0 +1,32 @@
+import { DeviceService } from '../services/device.cjs';
+import 'ua-parser-js';
+
+type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'brave';
+type BrowserInfo = {
+    id: BrowserName;
+    name: string;
+    icon: string;
+    storeLink: string;
+};
+declare const EXTENSION_STORE_LINKS: {
+    chrome: string;
+    brave: string;
+    edge: string;
+    opera: string;
+    safari: string;
+    firefox: string;
+};
+/**
+ * Expose browser info to the app
+ */
+declare const browserInfo: (deviceService: DeviceService) => BrowserInfo;
+
+/**
+ * Make slug from text
+ *
+ * @param value
+ * @returns
+ */
+declare const slug: (value?: string) => string;
+
+export { type BrowserInfo, type BrowserName, EXTENSION_STORE_LINKS, browserInfo, slug };

package/dist/utils/index.d.ts

@@ -0,0 +1,32 @@
+import { DeviceService } from '../services/device.js';
+import 'ua-parser-js';
+
+type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'brave';
+type BrowserInfo = {
+    id: BrowserName;
+    name: string;
+    icon: string;
+    storeLink: string;
+};
+declare const EXTENSION_STORE_LINKS: {
+    chrome: string;
+    brave: string;
+    edge: string;
+    opera: string;
+    safari: string;
+    firefox: string;
+};
+/**
+ * Expose browser info to the app
+ */
+declare const browserInfo: (deviceService: DeviceService) => BrowserInfo;
+
+/**
+ * Make slug from text
+ *
+ * @param value
+ * @returns
+ */
+declare const slug: (value?: string) => string;
+
+export { type BrowserInfo, type BrowserName, EXTENSION_STORE_LINKS, browserInfo, slug };

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+import {
+  EXTENSION_STORE_LINKS,
+  browserInfo,
+  slug
+} from "../chunk-DKXHVRHM.js";
+export {
+  EXTENSION_STORE_LINKS,
+  browserInfo,
+  slug
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@lukso/core",
+  "version": "0.1.0-dev.0f1bea5",
+  "description": "Core utilities, services, and mixins for LUKSO web components and applications",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.js",
+      "require": "./dist/services/index.cjs"
+    },
+    "./services/device": {
+      "types": "./dist/services/device.d.ts",
+      "import": "./dist/services/device.js",
+      "require": "./dist/services/device.cjs"
+    },
+    "./services/intl": {
+      "types": "./dist/services/intl.d.ts",
+      "import": "./dist/services/intl.js",
+      "require": "./dist/services/intl.cjs"
+    },
+    "./mixins": {
+      "types": "./dist/mixins/index.d.ts",
+      "import": "./dist/mixins/index.js",
+      "require": "./dist/mixins/index.cjs"
+    },
+    "./mixins/device": {
+      "types": "./dist/mixins/device.d.ts",
+      "import": "./dist/mixins/device.js",
+      "require": "./dist/mixins/device.cjs"
+    },
+    "./mixins/intl": {
+      "types": "./dist/mixins/intl.d.ts",
+      "import": "./dist/mixins/intl.js",
+      "require": "./dist/mixins/intl.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "lukso",
+    "lit",
+    "web-components",
+    "mixins",
+    "services",
+    "device-detection",
+    "internationalization",
+    "i18n",
+    "utilities"
+  ],
+  "author": "LUKSO",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lukso-network/up-connector.git"
+  },
+  "dependencies": {
+    "@formatjs/intl": "^3.1.8",
+    "@preact/signals-core": "^1.12.1",
+    "lit": "^3.3.1",
+    "ua-parser-js": "^2.0.6"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15"
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts",
+      "src/services/index.ts",
+      "src/services/device.ts",
+      "src/services/intl.ts",
+      "src/mixins/index.ts",
+      "src/mixins/device.ts",
+      "src/mixins/intl.ts",
+      "src/utils/index.ts"
+    ],
+    "format": [
+      "cjs",
+      "esm"
+    ],
+    "dts": true,
+    "splitting": true,
+    "sourcemap": true,
+    "clean": false,
+    "minify": false
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "dev-alt": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "check": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * @lukso/core
+ *
+ * Core utilities, services, and mixins for LUKSO web components and applications
+ */
+
+// Re-export all services and mixins
+export * from './mixins/index.js'
+export * from './services/index.js'
+export * from './utils/index.js'