@quvel-kit/core 1.1.0

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAyB,MAAM,2BAA2B,CAAC;AAClG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC3B,eAAe,CAmBjB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CASvD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAQtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAE,QAAwB,GAAG,OAAO,CAE7F"}

package/dist/utils/logging.js

@@ -0,0 +1,54 @@
+import { ConsoleLogger } from '../services/logger/ConsoleLogger.js';
+import { NullLogger } from '../services/logger/NullLogger.js';
+import { LogLevel as LogLevelEnum, LoggerType as LoggerTypeEnum } from '../types/logging.types.js';
+/**
+ * Create a logger instance based on configuration
+ */
+export function createLogger(config) {
+    const loggerType = import.meta.env.VITE_LOGGER || LoggerTypeEnum.NULL;
+    const logLevel = getLogLevel();
+    const traceInfo = config?.trace ?? {
+        id: '',
+        timestamp: new Date().toISOString(),
+        environment: import.meta.env.MODE || 'development',
+        tenant: null,
+        runtime: 'client',
+    };
+    switch (loggerType.toLowerCase()) {
+        case LoggerTypeEnum.CONSOLE:
+            return new ConsoleLogger(traceInfo, logLevel);
+        case LoggerTypeEnum.NULL:
+        default:
+            return new NullLogger(traceInfo);
+    }
+}
+/**
+ * Log level priority mapping (higher number = higher priority)
+ */
+export const LOG_LEVEL_PRIORITY = {
+    [LogLevelEnum.EMERGENCY]: 8,
+    [LogLevelEnum.ALERT]: 7,
+    [LogLevelEnum.CRITICAL]: 6,
+    [LogLevelEnum.ERROR]: 5,
+    [LogLevelEnum.WARNING]: 4,
+    [LogLevelEnum.NOTICE]: 3,
+    [LogLevelEnum.INFO]: 2,
+    [LogLevelEnum.DEBUG]: 1,
+};
+/**
+ * Get the current log level from environment variables
+ * Defaults to INFO if not specified or invalid
+ */
+export function getLogLevel() {
+    const configLevel = import.meta.env.VITE_LOG_LEVEL?.toLowerCase();
+    if (configLevel && Object.values(LogLevelEnum).includes(configLevel)) {
+        return configLevel;
+    }
+    return LogLevelEnum.INFO;
+}
+/**
+ * Determine if a log level should be displayed based on the configured level
+ */
+export function shouldLog(level, configuredLevel = getLogLevel()) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[configuredLevel];
+}

package/dist/utils/notify.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Notification Utility
+ *
+ * Wrapper for Quasars Notify plugin with standardized behavior
+ */
+import { QNotifyCreateOptions } from 'quasar';
+/**
+ * Show a standardized notification
+ *
+ * @param type - Notification type
+ * @param message - Message to display
+ * @param options - Additional Quasar notify options
+ */
+export declare function showNotification(type: 'negative' | 'warning' | 'positive' | 'info', message: string, options?: QNotifyCreateOptions): void;
+//# sourceMappingURL=notify.d.ts.map

package/dist/utils/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/utils/notify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,EAClD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAkBN"}

package/dist/utils/notify.js

@@ -0,0 +1,30 @@
+/**
+ * Notification Utility
+ *
+ * Wrapper for Quasars Notify plugin with standardized behavior
+ */
+import { Notify } from 'quasar';
+/**
+ * Show a standardized notification
+ *
+ * @param type - Notification type
+ * @param message - Message to display
+ * @param options - Additional Quasar notify options
+ */
+export function showNotification(type, message, options = {}) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    const iconMap = {
+        negative: 'error',
+        warning: 'warning',
+        positive: 'check_circle',
+        info: 'info',
+    };
+    Notify.create({
+        ...options,
+        icon: iconMap[type] || 'info',
+        type,
+        message,
+    });
+}

package/dist/utils/object.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Object Utility Functions
+ *
+ * Helper functions for working with objects and resolvable values
+ */
+/**
+ * A value that can be a direct value or a function returning a value
+ */
+export type Resolvable<T = unknown> = T | (() => T) | (() => Promise<T>);
+/**
+ * Resolve a value that could be:
+ * - A primitive (returned directly)
+ * - A synchronous function (executed and its result returned)
+ * - An asynchronous function (awaited and its result returned)
+ *
+ * @param value - The value to resolve
+ * @returns A promise that resolves to the resolved value
+ */
+export declare function resolveValue<T>(value: Resolvable<T>): Promise<T | undefined>;
+/**
+ * Safely retrieve a nested value from an object using dot notation
+ *
+ * @param obj - The object to retrieve the value from
+ * @param path - The path in dot notation (e.g., "a.b.c")
+ * @returns The value at the specified path or undefined if not found
+ */
+export declare function getSafe<T = unknown>(obj: unknown, path: string): T | undefined;
+//# sourceMappingURL=object.d.ts.map

package/dist/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/utils/object.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAUlF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAc9E"}

package/dist/utils/object.js

@@ -0,0 +1,48 @@
+/**
+ * Object Utility Functions
+ *
+ * Helper functions for working with objects and resolvable values
+ */
+/**
+ * Resolve a value that could be:
+ * - A primitive (returned directly)
+ * - A synchronous function (executed and its result returned)
+ * - An asynchronous function (awaited and its result returned)
+ *
+ * @param value - The value to resolve
+ * @returns A promise that resolves to the resolved value
+ */
+export async function resolveValue(value) {
+    try {
+        if (typeof value === 'function') {
+            const result = value();
+            return result instanceof Promise ? await result : result;
+        }
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Safely retrieve a nested value from an object using dot notation
+ *
+ * @param obj - The object to retrieve the value from
+ * @param path - The path in dot notation (e.g., "a.b.c")
+ * @returns The value at the specified path or undefined if not found
+ */
+export function getSafe(obj, path) {
+    try {
+        if (path === '')
+            return obj;
+        return path.split('.').reduce((acc, key) => {
+            if (acc !== null && typeof acc === 'object' && key in acc) {
+                return acc[key];
+            }
+            return undefined;
+        }, obj);
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,60 @@
+import type { CursorPaginatorResponse, CursorState, LengthAwarePaginatorResponse, LengthAwareState, PaginatedModuleState, PaginationActions, PaginationGetters, PaginationOptions, SimplePaginatorResponse, SimpleState, CursorMeta, LengthAwareMeta, SimpleMeta } from '../types/laravel.types.js';
+/**
+ * Checks if an object is a cursor paginator
+ */
+export declare function isCursorPagination(meta: unknown): meta is CursorMeta;
+/**
+ * Checks if an object is a length-aware paginator
+ */
+export declare function isLengthAwarePagination(meta: unknown): meta is LengthAwareMeta;
+/**
+ * Checks if an object is a simple paginator
+ */
+export declare function isSimplePagination(meta: unknown): meta is SimpleMeta;
+/**
+ * Creates pagination getters for Pinia stores
+ */
+export declare function createPaginationGetters<Key extends string, Model, State extends PaginatedModuleState<Model>>(key: Key): PaginationGetters<Key, Model, State>;
+/**
+ * Creates generic pagination actions for Pinia stores
+ */
+export declare function createPaginationActions<Key extends string, Response, State extends PaginatedModuleState<unknown>>(options: PaginationOptions<Key, Response, State> & {
+    transform: (state: State, response: Response) => void;
+}): PaginationActions<Key, State>;
+/**
+ * Creates initial state for length-aware pagination
+ */
+export declare function createLengthAwareState<T>(): LengthAwareState<T>;
+/**
+ * Creates pagination actions for length-aware paginator
+ */
+export declare function createLengthAwareActions<Key extends string, Model = unknown>(options: PaginationOptions<Key, LengthAwarePaginatorResponse<Model>, LengthAwareState<Model>>): PaginationActions<Key, LengthAwareState<Model>>;
+/**
+ * Creates pagination getters for length-aware paginator
+ */
+export declare function createLengthAwareGetters<Key extends string, Model>(key: Key): PaginationGetters<Key, Model, LengthAwareState<Model>>;
+/**
+ * Creates initial state for simple pagination
+ */
+export declare function createSimpleState<T>(): SimpleState<T>;
+/**
+ * Creates pagination actions for a simple paginator
+ */
+export declare function createSimpleActions<Key extends string, Model = unknown>(options: PaginationOptions<Key, SimplePaginatorResponse<Model>, SimpleState<Model>>): PaginationActions<Key, SimpleState<Model>>;
+/**
+ * Creates pagination getters for simple paginator
+ */
+export declare function createSimpleGetters<Key extends string, Model>(key: Key): PaginationGetters<Key, Model, SimpleState<Model>>;
+/**
+ * Creates initial state for cursor pagination
+ */
+export declare function createCursorState<T>(): CursorState<T>;
+/**
+ * Creates pagination actions for cursor paginator
+ */
+export declare function createCursorActions<Key extends string, Model = unknown>(options: PaginationOptions<Key, CursorPaginatorResponse<Model>, CursorState<Model>>): PaginationActions<Key, CursorState<Model>>;
+/**
+ * Creates pagination getters for cursor paginator
+ */
+export declare function createCursorGetters<Key extends string, Model>(key: Key): PaginationGetters<Key, Model, CursorState<Model>>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"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"}

package/dist/utils/pagination.js

@@ -0,0 +1,252 @@
+import { capitalize } from 'vue';
+/* -----------------------------------
+ * Type Guards
+ * ----------------------------------- */
+/**
+ * Checks if an object is a cursor paginator
+ */
+export function isCursorPagination(meta) {
+    return !!meta && typeof meta === 'object' && 'next_cursor' in meta && 'prev_cursor' in meta;
+}
+/**
+ * Checks if an object is a length-aware paginator
+ */
+export function isLengthAwarePagination(meta) {
+    return !!meta && typeof meta === 'object' && 'total' in meta && 'last_page' in meta;
+}
+/**
+ * Checks if an object is a simple paginator
+ */
+export function isSimplePagination(meta) {
+    return (!!meta &&
+        typeof meta === 'object' &&
+        'current_page' in meta &&
+        !('total' in meta) &&
+        !('next_cursor' in meta));
+}
+/* -----------------------------------
+ * Pagination Getters Factory
+ * ----------------------------------- */
+/**
+ * Creates pagination getters for Pinia stores
+ */
+export function createPaginationGetters(key) {
+    const capitalizedKey = capitalize(key);
+    return {
+        [`get${capitalizedKey}`]: (state) => state[key].data,
+        [`has${capitalizedKey}`]: (state) => state[key].data.length > 0,
+    };
+}
+/* -----------------------------------
+ * Generic Pagination Action Factory
+ * ----------------------------------- */
+/**
+ * Creates generic pagination actions for Pinia stores
+ */
+export function createPaginationActions(options) {
+    const { stateKey, fetcher, transform } = options;
+    const fetchKey = `${stateKey}Fetch`;
+    const nextKey = `${stateKey}Next`;
+    const prevKey = `${stateKey}Previous`;
+    const reloadKey = `${stateKey}Reload`;
+    return {
+        async [fetchKey](options = {}, clearPrevious = true) {
+            const state = this[stateKey];
+            if (clearPrevious)
+                state.data = [];
+            state.isLoadingMore = true;
+            try {
+                const response = await fetcher.call(this, options);
+                if (!response) {
+                    throw new Error('Failed to fetch data');
+                }
+                state.hasLoaded = true;
+                transform(state, response);
+            }
+            catch {
+                if (clearPrevious) {
+                    state.data = [];
+                    if (state.meta) {
+                        state.meta = {
+                            current_page: 1,
+                            from: null,
+                            last_page: 1,
+                            links: [],
+                            path: '',
+                            per_page: 10,
+                            to: null,
+                            total: 0,
+                        };
+                    }
+                }
+            }
+            finally {
+                state.isLoadingMore = false;
+            }
+        },
+        async [nextKey]() {
+            const state = this[stateKey];
+            if (!state.hasMore || state.isLoadingMore)
+                return;
+            await this[fetchKey]({ page: state.currentPage + 1 }, false);
+        },
+        async [prevKey]() {
+            const state = this[stateKey];
+            if (state.currentPage <= 1)
+                return;
+            await this[fetchKey]({ page: state.currentPage - 1 }, false);
+        },
+        async [reloadKey]() {
+            await this[fetchKey]({ page: 1 });
+        },
+    };
+}
+/* -----------------------------------
+ * Length-Aware Pagination
+ * ----------------------------------- */
+/**
+ * Creates initial state for length-aware pagination
+ */
+export function createLengthAwareState() {
+    return {
+        data: [],
+        currentPage: 1,
+        hasMore: true,
+        isLoadingMore: false,
+        hasLoaded: false,
+        meta: {
+            current_page: 1,
+            from: 1,
+            last_page: 1,
+            per_page: 10,
+            to: 1,
+            total: 1,
+            links: [],
+            path: '',
+        },
+        links: {
+            first: null,
+            last: null,
+            prev: null,
+            next: null,
+        },
+    };
+}
+/**
+ * Creates pagination actions for length-aware paginator
+ */
+export function createLengthAwareActions(options) {
+    return createPaginationActions({
+        ...options,
+        transform: (state, res) => {
+            state.data = res.data;
+            state.meta = res.meta;
+            state.links = res.links;
+            state.currentPage = res.meta.current_page;
+            state.hasMore = res.meta.current_page < res.meta.last_page;
+        },
+    });
+}
+/**
+ * Creates pagination getters for length-aware paginator
+ */
+export function createLengthAwareGetters(key) {
+    return createPaginationGetters(key);
+}
+/* -----------------------------------
+ * Simple Pagination
+ * ----------------------------------- */
+/**
+ * Creates initial state for simple pagination
+ */
+export function createSimpleState() {
+    return {
+        data: [],
+        currentPage: 1,
+        hasMore: true,
+        isLoadingMore: false,
+        hasLoaded: false,
+        meta: {
+            current_page: 1,
+            from: null,
+            path: '',
+            per_page: 10,
+            to: null,
+        },
+        links: {
+            first: null,
+            last: null,
+            prev: null,
+            next: null,
+        },
+    };
+}
+/**
+ * Creates pagination actions for a simple paginator
+ */
+export function createSimpleActions(options) {
+    return createPaginationActions({
+        ...options,
+        transform: (state, res) => {
+            state.data = res.data;
+            state.meta = res.meta;
+            state.links = res.links;
+            state.currentPage = res.meta.current_page;
+            state.hasMore = true;
+        },
+    });
+}
+/**
+ * Creates pagination getters for simple paginator
+ */
+export function createSimpleGetters(key) {
+    return createPaginationGetters(key);
+}
+/* -----------------------------------
+ * Cursor Pagination
+ * ----------------------------------- */
+/**
+ * Creates initial state for cursor pagination
+ */
+export function createCursorState() {
+    return {
+        data: [],
+        currentPage: 1,
+        hasMore: true,
+        isLoadingMore: false,
+        hasLoaded: false,
+        meta: {
+            path: '',
+            per_page: 10,
+            next_cursor: null,
+            prev_cursor: null,
+        },
+        links: {
+            first: null,
+            last: null,
+            prev: null,
+            next: null,
+        },
+    };
+}
+/**
+ * Creates pagination actions for cursor paginator
+ */
+export function createCursorActions(options) {
+    return createPaginationActions({
+        ...options,
+        transform: (state, res) => {
+            state.data = res.data;
+            state.meta = res.meta;
+            state.links = res.links;
+            state.currentPage++;
+            state.hasMore = !!res.meta.next_cursor;
+        },
+    });
+}
+/**
+ * Creates pagination getters for cursor paginator
+ */
+export function createCursorGetters(key) {
+    return createPaginationGetters(key);
+}

package/dist/utils/paths.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Path Utilities for Module Resource Resolution
+ *
+ * Provides consistent path generation for module resources
+ * used by Quasar build system (boot files, CSS, etc.)
+ */
+/**
+ * Options for module resource path generation
+ */
+export interface ModuleResourceOptions {
+    /** Base modules directory (default: 'modules') */
+    modulesDir?: string;
+    /** Prefix for the path (default: '..') - relative from src/boot/ */
+    prefix?: string;
+    /** File extension to append */
+    extension?: string;
+}
+/**
+ * Generates the correct relative path for module resources
+ *
+ * Quasar requires specific relative paths for boot files and CSS imports.
+ * This helper ensures consistent path generation across all modules.
+ *
+ * @param moduleName - Name of the module (e.g., 'Core', 'Auth')
+ * @param resourcePath - Path within the module (e.g., 'boot/setup', 'css/styles.scss')
+ * @param options - Path generation options
+ * @returns Properly formatted relative path for Quasar
+ *
+ * @example
+ * ```ts
+ * moduleResource('core', 'boot/container')
+ * // Returns: '../modules/core/boot/container'
+ *
+ * moduleResource('auth', 'css/auth.scss')
+ * // Returns: '../modules/auth/css/auth.scss'
+ * ```
+ */
+export declare function moduleResource(moduleName: string, resourcePath: string, options?: ModuleResourceOptions): string;
+/**
+ * Generates paths for multiple resources from the same module
+ *
+ * @param moduleName - Name of the module
+ * @param resourcePaths - Array of resource paths within the module
+ * @param options - Path generation options
+ * @returns Array of properly formatted relative paths
+ *
+ * @example
+ * ```ts
+ * moduleResources('core', ['boot/container', 'boot/app-config'])
+ * // Returns: ['../modules/core/boot/container', '../modules/core/boot/app-config']
+ * ```
+ */
+export declare function moduleResources(moduleName: string, resourcePaths: string[], options?: ModuleResourceOptions): string[];
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAUR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAEV"}

package/dist/utils/paths.js

@@ -0,0 +1,48 @@
+/**
+ * Path Utilities for Module Resource Resolution
+ *
+ * Provides consistent path generation for module resources
+ * used by Quasar build system (boot files, CSS, etc.)
+ */
+/**
+ * Generates the correct relative path for module resources
+ *
+ * Quasar requires specific relative paths for boot files and CSS imports.
+ * This helper ensures consistent path generation across all modules.
+ *
+ * @param moduleName - Name of the module (e.g., 'Core', 'Auth')
+ * @param resourcePath - Path within the module (e.g., 'boot/setup', 'css/styles.scss')
+ * @param options - Path generation options
+ * @returns Properly formatted relative path for Quasar
+ *
+ * @example
+ * ```ts
+ * moduleResource('core', 'boot/container')
+ * // Returns: '../modules/core/boot/container'
+ *
+ * moduleResource('auth', 'css/auth.scss')
+ * // Returns: '../modules/auth/css/auth.scss'
+ * ```
+ */
+export function moduleResource(moduleName, resourcePath, options = {}) {
+    const { modulesDir = 'modules', prefix = '..', extension, } = options;
+    const basePath = `${prefix}/${modulesDir}/${moduleName}/${resourcePath}`;
+    return extension ? `${basePath}.${extension}` : basePath;
+}
+/**
+ * Generates paths for multiple resources from the same module
+ *
+ * @param moduleName - Name of the module
+ * @param resourcePaths - Array of resource paths within the module
+ * @param options - Path generation options
+ * @returns Array of properly formatted relative paths
+ *
+ * @example
+ * ```ts
+ * moduleResources('core', ['boot/container', 'boot/app-config'])
+ * // Returns: ['../modules/core/boot/container', '../modules/core/boot/app-config']
+ * ```
+ */
+export function moduleResources(moduleName, resourcePaths, options) {
+    return resourcePaths.map((path) => moduleResource(moduleName, path, options));
+}

package/dist/utils/platform.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Platform Detection Utilities
+ *
+ * Detects platform tags from Quasar Platform and Screen APIs
+ * and formats them for the X-Platform header.
+ */
+/**
+ * Detect all platform tags and return as comma-separated string
+ *
+ * @returns Comma-separated platform tags (e.g., "capacitor,ios,mobile,screen:sm")
+ *
+ * @example
+ * ```typescript
+ * // iPhone in Capacitor
+ * detectPlatformTags() // "capacitor,ios,mobile,screen:sm"
+ *
+ * // iPad in Safari
+ * detectPlatformTags() // "web,ios,tablet,screen:lg"
+ *
+ * // Electron on macOS
+ * detectPlatformTags() // "electron,macos,desktop,screen:xl"
+ * ```
+ */
+export declare function detectPlatformTags(): string;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAiC3C"}