@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/utils/cookies.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Cookie Utilities
+ *
+ * Type-safe cookie management with JSON serialization.
+ *
+ * @module utils
+ */
+/**
+ * Cookie options for setting cookies.
+ */
+export interface CookieOptions {
+    /** Enable secure flag (HTTPS only) */
+    secure?: boolean;
+    /** Days until expiration */
+    daysUntilExpiration?: number;
+    /** SameSite policy */
+    sameSite?: 'strict' | 'lax' | 'none';
+    /** Cookie domain */
+    domain?: string;
+    /** Cookie path */
+    path?: string;
+}
+/**
+ * Check if cookies are available.
+ *
+ * @returns {boolean} True if cookies are available
+ */
+export declare function cookiesAvailable(): boolean;
+/**
+ * Get a cookie value with JSON parsing.
+ *
+ * @template T - Type of the stored value
+ * @param {string} key - Cookie name
+ * @returns {T | null} Parsed value or null
+ *
+ * @example
+ * ```ts
+ * const user = getCookie<User>('user');
+ * ```
+ */
+export declare function getCookie<T>(key: string): T | null;
+/**
+ * Set a cookie with JSON serialization.
+ *
+ * @template T - Type of the value
+ * @param {string} key - Cookie name
+ * @param {T} value - Value to store
+ * @param {CookieOptions} [options] - Cookie options
+ *
+ * @example
+ * ```ts
+ * setCookie('user', { name: 'John' }, { daysUntilExpiration: 7 });
+ * ```
+ */
+export declare function setCookie<T>(key: string, value: T, options?: CookieOptions): void;
+/**
+ * Remove a cookie.
+ *
+ * @param {string} key - Cookie name
+ * @param {Pick<CookieOptions, 'domain' | 'path'>} [options] - Cookie options
+ *
+ * @example
+ * ```ts
+ * removeCookie('user');
+ * ```
+ */
+export declare function removeCookie(key: string, options?: Pick<CookieOptions, 'domain' | 'path'>): void;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/utils/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAa1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAqBlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAgCrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAM,GAAG,IAAI,CAcpG"}

package/dist/utils/create-classes.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Class Name Factory
+ *
+ * Creates prefixed CSS class names for consistent component styling.
+ * Uses a configurable prefix to avoid collisions with other libraries.
+ *
+ * @module utils/create-classes
+ */
+/**
+ * Default class prefix for Prism components.
+ * Can be overridden via PRISM_CLASS_PREFIX environment variable.
+ */
+export declare const DEFAULT_CLASS_PREFIX = "prism";
+/**
+ * Set the global class prefix for all Prism components.
+ *
+ * @param prefix - New class prefix to use
+ *
+ * @example
+ * ```ts
+ * setClassPrefix('my-app');
+ * createClasses('button__root'); // => "my-app__button__root"
+ * ```
+ */
+export declare function setClassPrefix(prefix: string): void;
+/**
+ * Get the current class prefix.
+ *
+ * @returns Current class prefix
+ */
+export declare function getClassPrefix(): string;
+/**
+ * Create a prefixed CSS class name.
+ *
+ * @param className - Class name suffix (e.g., "button__root")
+ * @returns Prefixed class name (e.g., "prism__button__root")
+ *
+ * @example
+ * ```ts
+ * createClasses('chart__root')
+ * // => "prism__chart__root"
+ *
+ * createClasses('chart__loading')
+ * // => "prism__chart__loading"
+ * ```
+ */
+export declare function createClasses(className: string): string;
+/**
+ * Create multiple prefixed CSS class names.
+ *
+ * @param classNames - Array of class name suffixes
+ * @returns Object mapping original names to prefixed names
+ *
+ * @example
+ * ```ts
+ * const classes = createClassesObject(['root', 'loading', 'label']);
+ * // => { root: "prism__root", loading: "prism__loading", label: "prism__label" }
+ * ```
+ */
+export declare function createClassesObject<T extends string>(classNames: readonly T[]): Record<T, string>;
+/**
+ * Create a class name factory for a specific component.
+ *
+ * @param componentName - Component name (e.g., "chart", "button")
+ * @returns Function that creates prefixed class names for that component
+ *
+ * @example
+ * ```ts
+ * const chartClass = createComponentClasses('chart');
+ * chartClass('root');    // => "prism__chart__root"
+ * chartClass('loading'); // => "prism__chart__loading"
+ * ```
+ */
+export declare function createComponentClasses(componentName: string): (suffix: string) => string;
+/**
+ * Create a class name object for a specific component with predefined suffixes.
+ *
+ * @param componentName - Component name (e.g., "chart", "button")
+ * @param suffixes - Array of class name suffixes
+ * @returns Object mapping suffix names to prefixed class names
+ *
+ * @example
+ * ```ts
+ * const chartClasses = createComponentClasses('chart', ['root', 'loading', 'label'] as const);
+ * chartClasses.root;    // => "prism__chart__root"
+ * chartClasses.loading; // => "prism__chart__loading"
+ * ```
+ */
+export declare function createComponentClasses<T extends string>(componentName: string, suffixes: readonly T[]): Record<T, string>;
+//# sourceMappingURL=create-classes.d.ts.map

package/dist/utils/create-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-classes.d.ts","sourceRoot":"","sources":["../../src/utils/create-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAI5C;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAQjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Error Handling Utilities
+ *
+ * Comprehensive error handling with i18n support, error classification,
+ * and retry logic for robust frontend applications.
+ *
+ * @module utils
+ */
+/**
+ * Error codes for classification.
+ */
+export type ErrorCode = 'AUTH_REQUIRED' | 'AUTH_EXPIRED' | 'AUTH_INVALID' | 'AUTH_FORBIDDEN' | 'AUTH_MFA_REQUIRED' | 'AUTH_DEVICE_BLOCKED' | 'NETWORK_ERROR' | 'NETWORK_TIMEOUT' | 'NETWORK_OFFLINE' | 'VALIDATION_ERROR' | 'VALIDATION_REQUIRED' | 'VALIDATION_FORMAT' | 'VALIDATION_RANGE' | 'SERVER_ERROR' | 'SERVER_UNAVAILABLE' | 'SERVER_MAINTENANCE' | 'NOT_FOUND' | 'CONFLICT' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'UNKNOWN_ERROR' | string;
+/**
+ * Severity levels for errors.
+ */
+export type ErrorSeverity = 'error' | 'warning' | 'info';
+/**
+ * Error context for i18n.
+ */
+export interface ErrorContext {
+    /** Error code for lookup */
+    code: ErrorCode;
+    /** HTTP status code if applicable */
+    status?: number;
+    /** Field name for validation errors */
+    field?: string;
+    /** Additional interpolation values */
+    values?: Record<string, string | number>;
+    /** Original error message (fallback) */
+    message?: string;
+    /** Retry information */
+    retryAfter?: number;
+    /** Severity level */
+    severity?: ErrorSeverity;
+}
+/**
+ * Translated error result.
+ */
+export interface TranslatedError {
+    /** Translated title */
+    title: string;
+    /** Translated message */
+    message: string;
+    /** Error code */
+    code: ErrorCode;
+    /** Severity */
+    severity: ErrorSeverity;
+    /** Action hint (e.g., "Please log in again") */
+    action?: string;
+    /** Retry after seconds */
+    retryAfter?: number;
+    /** Is this a retryable error */
+    canRetry: boolean;
+}
+/**
+ * Translation function type.
+ */
+export type TranslateFn = (key: string, values?: Record<string, string | number>) => string;
+/**
+ * Error messages dictionary type.
+ */
+export interface ErrorMessages {
+    [code: string]: {
+        title: string;
+        message: string;
+        action?: string;
+    };
+}
+/**
+ * Default error messages in English.
+ * Can be replaced with i18n translations.
+ */
+export declare const DEFAULT_ERROR_MESSAGES: ErrorMessages;
+/**
+ * Classify an error by HTTP status code.
+ */
+export declare function classifyHttpError(status: number): ErrorCode;
+/**
+ * Check if an error is a network error.
+ *
+ * Deciding by the words a message happens to contain cuts the wrong way in
+ * both directions. Matching "network", "connection" or "offline" anywhere in
+ * any message classified "Connection to the payment provider was declined"
+ * and "This network is not supported in your region" — ordinary server
+ * answers — as the user's connection failing, which sends them to check a
+ * router instead of reading what the server said. Against a corpus of the
+ * eight shapes a real network failure takes and five that only mention one,
+ * the old predicate was right 7 times out of 13.
+ *
+ * So: an errno if the error carries one, the engine's own wording if `fetch`
+ * rejected (it rejects with a TypeError and nothing else for a network-level
+ * failure), and axios's exact `Network Error` — which is its whole message,
+ * not a fragment of a sentence.
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Check if an error is retryable.
+ */
+export declare function isRetryableError(code: ErrorCode): boolean;
+/**
+ * Get severity for an error code.
+ */
+export declare function getErrorSeverity(code: ErrorCode): ErrorSeverity;
+/**
+ * Create an error translator with custom messages or i18n function.
+ *
+ * @example
+ * ```tsx
+ * // With custom messages
+ * const translate = createErrorTranslator({
+ *   messages: {
+ *     AUTH_REQUIRED: {
+ *       title: 'Необходима авторизация',
+ *       message: 'Пожалуйста, войдите в систему.',
+ *     },
+ *   },
+ * });
+ *
+ * // With i18n library
+ * const translate = createErrorTranslator({
+ *   t: (key, values) => i18n.t(key, values),
+ * });
+ *
+ * const error = translate({ code: 'AUTH_REQUIRED', status: 401 });
+ * // { title: 'Необходима авторизация', message: '...', ... }
+ * ```
+ */
+export declare function createErrorTranslator(options: {
+    messages?: ErrorMessages;
+    t?: TranslateFn;
+    fallbackMessages?: ErrorMessages;
+}): (context: ErrorContext) => TranslatedError;
+/**
+ * Extract error context from various error types.
+ *
+ * @example
+ * ```tsx
+ * try {
+ *   await api.call();
+ * } catch (error) {
+ *   const context = extractErrorContext(error);
+ *   const translated = translateError(context);
+ *   showNotification(translated);
+ * }
+ * ```
+ */
+export declare function extractErrorContext(error: unknown): ErrorContext;
+/**
+ * Retry configuration.
+ */
+export interface RetryConfig {
+    /** Maximum number of retries */
+    maxRetries?: number;
+    /** Initial delay in ms */
+    initialDelay?: number;
+    /** Maximum delay in ms */
+    maxDelay?: number;
+    /** Exponential backoff factor */
+    backoffFactor?: number;
+    /** Add jitter to delays */
+    jitter?: boolean;
+    /** Custom retry condition */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /** Called before each retry */
+    onRetry?: (error: unknown, attempt: number, delay: number) => void;
+}
+/**
+ * Execute an async operation with automatic retry.
+ *
+ * @example
+ * ```tsx
+ * const result = await withRetry(
+ *   () => fetch('/api/data'),
+ *   {
+ *     maxRetries: 3,
+ *     onRetry: (error, attempt, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms`);
+ *     },
+ *   }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, config?: RetryConfig): Promise<T>;
+/**
+ * Check if error is a chunk load error (code splitting failure).
+ */
+export declare function isChunkLoadError(error: unknown): boolean;
+/**
+ * Check if error is a session expiry error.
+ */
+export declare function isSessionExpiredError(error: unknown): boolean;
+/**
+ * Create a handler for error boundary recovery.
+ */
+export declare function createErrorRecoveryHandler(options: {
+    onChunkError?: () => void;
+    onSessionExpired?: () => void;
+    onNetworkError?: () => void;
+    onGenericError?: (error: unknown) => void;
+}): (error: unknown) => void;
+//# sourceMappingURL=errors.d.ts.map

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

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

package/dist/utils/fetch-interceptor.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Fetch Interceptor Factory
+ *
+ * A flexible fetch wrapper with support for request/response interceptors,
+ * automatic token refresh, and retry logic.
+ *
+ * Designed for production applications that need centralized HTTP handling.
+ *
+ * @module utils
+ */
+import { type AsyncLock } from './async-lock.js';
+import { type RetryConfig } from './errors.js';
+/**
+ * Extended request init with additional options.
+ */
+export interface FetchRequestInit extends RequestInit {
+    /** Skip all interceptors for this request */
+    skipInterceptors?: boolean;
+    /** Skip request interceptors only */
+    skipRequestInterceptors?: boolean;
+    /** Skip response interceptors only */
+    skipResponseInterceptors?: boolean;
+    /** Custom timeout in milliseconds */
+    timeout?: number;
+    /** Enable automatic retry on failure */
+    retry?: boolean | RetryConfig;
+    /** Request metadata for logging/debugging */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Request interceptor context.
+ */
+export interface RequestContext {
+    url: string;
+    init: FetchRequestInit;
+    /** Original request info (can be string or Request) */
+    input: RequestInfo | URL;
+    /** Request metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Response interceptor context.
+ */
+export interface ResponseContext {
+    response: Response;
+    request: RequestContext;
+    /** Time taken for the request in ms */
+    duration: number;
+}
+/**
+ * Error interceptor context.
+ */
+export interface ErrorContext {
+    error: unknown;
+    request: RequestContext;
+    /** Time taken before error in ms */
+    duration: number;
+    /** Number of retry attempts made */
+    retryCount: number;
+}
+/**
+ * Request interceptor function.
+ * Can modify the request or return a new one.
+ */
+export type RequestInterceptor = (ctx: RequestContext) => RequestContext | Promise<RequestContext>;
+/**
+ * Response interceptor function.
+ * Can modify the response or return a new one.
+ */
+export type ResponseInterceptor = (ctx: ResponseContext) => Response | Promise<Response>;
+/**
+ * Error interceptor function.
+ * Can handle the error, retry, or rethrow.
+ */
+export type ErrorInterceptor = (ctx: ErrorContext) => Response | Promise<Response> | never;
+/**
+ * Interceptor configuration.
+ */
+export interface FetchInterceptorConfig {
+    /** Base URL to prepend to relative paths */
+    baseUrl?: string;
+    /** Default headers for all requests */
+    defaultHeaders?: HeadersInit;
+    /** Default timeout in milliseconds (0 = no timeout) */
+    defaultTimeout?: number;
+    /** Request interceptors (run in order) */
+    requestInterceptors?: RequestInterceptor[];
+    /** Response interceptors (run in order) */
+    responseInterceptors?: ResponseInterceptor[];
+    /** Error interceptors (run in order, first to handle wins) */
+    errorInterceptors?: ErrorInterceptor[];
+    /** Default retry configuration */
+    defaultRetry?: RetryConfig | false;
+    /** Credentials mode for all requests */
+    credentials?: RequestCredentials;
+}
+/**
+ * Token refresh handler configuration.
+ */
+export interface TokenRefreshConfig {
+    /** Check if a response indicates token expiration */
+    isTokenExpired: (response: Response) => boolean;
+    /** Refresh the token (called when token is expired) */
+    refreshToken: () => Promise<string | null>;
+    /** Get the current access token */
+    getAccessToken: () => string | null;
+    /** Called when refresh fails (e.g., redirect to login) */
+    onRefreshFailure?: () => void;
+    /** Maximum number of refresh attempts */
+    maxRefreshAttempts?: number;
+}
+/**
+ * Fetch client interface.
+ */
+export interface FetchClient {
+    /** Make a fetch request */
+    fetch: (input: RequestInfo | URL, init?: FetchRequestInit) => Promise<Response>;
+    /** Add a request interceptor */
+    addRequestInterceptor: (interceptor: RequestInterceptor) => () => void;
+    /** Add a response interceptor */
+    addResponseInterceptor: (interceptor: ResponseInterceptor) => () => void;
+    /** Add an error interceptor */
+    addErrorInterceptor: (interceptor: ErrorInterceptor) => () => void;
+    /** Remove all interceptors */
+    clearInterceptors: () => void;
+    /** Get current configuration */
+    getConfig: () => FetchInterceptorConfig;
+}
+/**
+ * Create a fetch client with interceptor support.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * const api = createFetchClient({
+ *   baseUrl: 'https://api.example.com',
+ *   defaultHeaders: { 'Content-Type': 'application/json' },
+ *   defaultTimeout: 30000,
+ * });
+ *
+ * // Add auth header interceptor
+ * api.addRequestInterceptor(async (ctx) => {
+ *   const token = getAccessToken();
+ *   if (token) {
+ *     ctx.init.headers = {
+ *       ...ctx.init.headers,
+ *       Authorization: `Bearer ${token}`,
+ *     };
+ *   }
+ *   return ctx;
+ * });
+ *
+ * // Add response logging
+ * api.addResponseInterceptor(async (ctx) => {
+ *   console.log(`${ctx.request.init.method} ${ctx.request.url} - ${ctx.response.status} (${ctx.duration}ms)`);
+ *   return ctx.response;
+ * });
+ *
+ * // Make requests
+ * const response = await api.fetch('/users');
+ * const data = await response.json();
+ * ```
+ */
+export declare function createFetchClient(config?: FetchInterceptorConfig): FetchClient;
+/**
+ * Create a token refresh interceptor that automatically refreshes
+ * expired tokens and retries failed requests.
+ *
+ * Uses AsyncLock to prevent multiple simultaneous refresh attempts.
+ *
+ * @example
+ * ```tsx
+ * const api = createFetchClient({ baseUrl: '/api' });
+ *
+ * const { addToClient } = createTokenRefreshInterceptor({
+ *   isTokenExpired: (response) => response.status === 401,
+ *   refreshToken: async () => {
+ *     const response = await fetch('/auth/refresh', { method: 'POST' });
+ *     const data = await response.json();
+ *     localStorage.setItem('token', data.accessToken);
+ *     return data.accessToken;
+ *   },
+ *   getAccessToken: () => localStorage.getItem('token'),
+ *   onRefreshFailure: () => {
+ *     localStorage.removeItem('token');
+ *     window.location.href = '/login';
+ *   },
+ * });
+ *
+ * addToClient(api);
+ * ```
+ */
+export declare function createTokenRefreshInterceptor(config: TokenRefreshConfig): {
+    addToClient: (client: FetchClient) => void;
+    refreshLock: AsyncLock;
+};
+/**
+ * Create a simple JSON API client.
+ *
+ * @example
+ * ```tsx
+ * const api = createJsonApiClient({
+ *   baseUrl: 'https://api.example.com',
+ *   getAuthToken: () => localStorage.getItem('token'),
+ * });
+ *
+ * // GET request
+ * const users = await api.get<User[]>('/users');
+ *
+ * // POST request
+ * const newUser = await api.post<User>('/users', { name: 'John' });
+ *
+ * // DELETE request
+ * await api.delete('/users/1');
+ * ```
+ */
+export declare function createJsonApiClient(options: {
+    baseUrl?: string;
+    getAuthToken?: () => string | null;
+    defaultHeaders?: Record<string, string>;
+    timeout?: number;
+}): {
+    client: FetchClient;
+    get: <T>(path: string) => Promise<T | null>;
+    post: <T>(path: string, body?: unknown) => Promise<T | null>;
+    put: <T>(path: string, body?: unknown) => Promise<T | null>;
+    patch: <T>(path: string, body?: unknown) => Promise<T | null>;
+    delete: <T>(path: string) => Promise<T | null>;
+};
+//# sourceMappingURL=fetch-interceptor.d.ts.map

package/dist/utils/fetch-interceptor.d.ts.map

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

package/dist/utils/font.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Font Utilities
+ *
+ * Font family and unit conversion helpers.
+ *
+ * @module utils
+ */
+/**
+ * Create a font family string with fallback stack.
+ *
+ * @param {string} [fontName] - Primary font name
+ * @returns {string} Font family with fallbacks
+ *
+ * @example
+ * ```ts
+ * setFont('Inter'); // '"Inter", -apple-system, ...'
+ * setFont();        // Default system font stack
+ * ```
+ */
+export declare function setFont(fontName?: string): string;
+/**
+ * Convert rem to pixels.
+ *
+ * @param {string | number} value - Rem value (number or string like '1rem')
+ * @returns {number} Value in pixels
+ *
+ * @example
+ * ```ts
+ * remToPx(1);      // 16
+ * remToPx('1rem'); // 16
+ * remToPx(1.5);    // 24
+ * ```
+ */
+export declare function remToPx(value: string | number): number;
+/**
+ * Convert pixels to rem.
+ *
+ * @param {string | number} value - Pixel value (number or string like '16px')
+ * @returns {string} Value in rem with unit
+ *
+ * @example
+ * ```ts
+ * pxToRem(16);      // '1rem'
+ * pxToRem('16px');  // '1rem'
+ * pxToRem(24);      // '1.5rem'
+ * ```
+ */
+export declare function pxToRem(value: string | number): string;
+/**
+ * Create responsive font size based on viewport.
+ *
+ * @param {number} minSize - Minimum font size in px
+ * @param {number} maxSize - Maximum font size in px
+ * @param {number} [minWidth=320] - Minimum viewport width in px
+ * @param {number} [maxWidth=1200] - Maximum viewport width in px
+ * @returns {string} CSS clamp() value
+ *
+ * @example
+ * ```ts
+ * responsiveFontSize(14, 18);
+ * // 'clamp(0.875rem, 0.7955rem + 0.3977vw, 1.125rem)'
+ * ```
+ */
+export declare function responsiveFontSize(minSize: number, maxSize: number, minWidth?: number, maxWidth?: number): string;
+//# sourceMappingURL=font.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../../src/utils/font.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAW5G"}