@kubit-ui-web/react-charts 1.2.0 → 1.4.0

package/README.md

@@ -55,6 +55,9 @@
 **Customizable**: Flexible styling and granular configurations  
 **Responsive**: Adaptable to different screen sizes  
 **TypeScript**: Fully typed for better developer experience  
+**SSR Ready**: Complete Server-Side Rendering support for Next.js, Remix, Gatsby, and more  
+**Error Handling**: Advanced centralized error management system with detailed debugging  
+**Production Safe**: Built-in logging system that's automatically optimized for production builds  
 **Tested**: Complete coverage with Vitest and Testing Library
 
 ## Installation
@@ -86,6 +89,22 @@ yarn add react react-dom
 - React: ^18.3.1
 - React DOM: ^18.3.1
 
+### Tree-Shaking Support
+
+The library supports granular imports for optimal bundle size:
+
+```typescript
+// Import specific charts only
+import { BarChart } from '@kubit-ui-web/react-charts/charts/barChart';
+import { LineChart } from '@kubit-ui-web/react-charts/charts/lineChart';
+// Import specific components only
+import { Node } from '@kubit-ui-web/react-charts/components/node';
+import { Path } from '@kubit-ui-web/react-charts/components/path';
+// Import specific utilities only
+import { logger } from '@kubit-ui-web/react-charts/utils/logger';
+import { isBrowser } from '@kubit-ui-web/react-charts/utils/ssr';
+```
+
 ## Quick Start
 
 ### Importing Components
@@ -97,6 +116,9 @@ import { BarChart, LineChart, PieChart } from '@kubit-ui-web/react-charts';
 import { Node, Path, Plot } from '@kubit-ui-web/react-charts/components';
 // Import types
 import type { BarOrientation, ChartData } from '@kubit-ui-web/react-charts/types';
+// Import utilities
+import { configureLogger, logger } from '@kubit-ui-web/react-charts/utils';
+import { createSVGElement, isBrowser, safeWindow } from '@kubit-ui-web/react-charts/utils';
 ```
 
 ### LineChart Example
@@ -162,6 +184,67 @@ function MyBarChart() {
 }
 ```
 
+### Error Handling Example
+
+```tsx
+import { LineChart } from '@kubit-ui-web/react-charts';
+import type { ChartErrorCollection } from '@kubit-ui-web/react-charts/types';
+import React from 'react';
+
+function ChartWithErrorHandling() {
+  const handleErrors = (errors: ChartErrorCollection) => {
+    // Centralized error handling
+    console.warn('Chart errors:', errors);
+    // Display user-friendly messages or retry logic
+  };
+
+  return (
+    <LineChart data={data} xKey="year" onErrors={handleErrors} width="100%" height="400px">
+      <LineChart.Path dataKey="sales" stroke="#0078D4" />
+      <LineChart.XAxis position="BOTTOM" />
+      <LineChart.YAxis position="LEFT" />
+    </LineChart>
+  );
+}
+```
+
+### SSR (Server-Side Rendering) Support
+
+```tsx
+import { LineChart, isBrowser, safeWindow } from '@kubit-ui-web/react-charts';
+import React from 'react';
+
+function SSRCompatibleChart() {
+  // Safe browser API access
+  const windowWidth = isBrowser() ? safeWindow()?.innerWidth || 800 : 800;
+
+  return (
+    <LineChart data={data} xKey="year" width={windowWidth} height="400px">
+      <LineChart.Path dataKey="sales" stroke="#0078D4" />
+    </LineChart>
+  );
+}
+```
+
+### Logger Configuration
+
+```tsx
+import { configureLogger, logger } from '@kubit-ui-web/react-charts';
+
+// Configure logger for development
+configureLogger({
+  enabled: true,
+  minLevel: 'debug',
+  prefix: '[MyApp Charts]',
+});
+
+// Use logger in your components
+function MyComponent() {
+  logger.info('Chart rendering started');
+  // Chart implementation
+}
+```
+
 ## Available Components
 
 ### Main Charts
@@ -190,6 +273,19 @@ function MyBarChart() {
 | **`useFocus`** | Focus state management for accessibility |
 | **`useHover`** | Hover detection with callbacks           |
 
+### Utility Functions
+
+| Utility                      | Description                                        |
+| ---------------------------- | -------------------------------------------------- |
+| **`logger`**                 | Production-safe logging with configurable levels   |
+| **`configureLogger`**        | Logger configuration for development/debugging     |
+| **`isBrowser`**              | Environment detection for browser vs SSR           |
+| **`isServer`**               | Check if running in server-side environment        |
+| **`safeWindow`**             | Safe access to window object in SSR environments   |
+| **`safeDocument`**           | Safe access to document object in SSR environments |
+| **`createSVGElement`**       | SSR-compatible SVG element creation                |
+| **`createErrorAccumulator`** | Advanced error management for chart components     |
+
 ## API Reference
 
 For detailed API documentation, component props, and advanced examples, please refer to our individual component READMEs:

package/dist/cjs/components/zoomArea/hooks/useResponsiveCanvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResponsiveCanvas.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/hooks/useResponsiveCanvas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,UAAU,yBAAyB;IACjC,yCAAyC;IACzC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,GAAI,0DAMjC,yBAAyB,KAAG,yBAyF9B,CAAC"}
+{"version":3,"file":"useResponsiveCanvas.d.ts","sourceRoot":"","sources":["../../../../../src/components/zoomArea/hooks/useResponsiveCanvas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,UAAU,yBAAyB;IACjC,yCAAyC;IACzC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,GAAI,0DAMjC,yBAAyB,KAAG,yBA8F9B,CAAC"}

package/dist/cjs/components/zoomArea/hooks/useResponsiveCanvas.js

@@ -2,6 +2,7 @@ import { useEffect, useMemo, useState } from 'react';
 import { buildViewBox } from '../../../components/svgContainer/utils/buildViewBox/buildViewBox';
 import { getCanvasDimensions } from '../../../utils/getCanvasDimensions/getCanvasDimensions';
 import { parseStringToNumberPx } from '../../../utils/parseStringToNumberPx.ts/parseStringToNumberPx';
+import { isBrowser, safeQuerySelector } from '../../../utils/ssr/ssr';
 export const useResponsiveCanvas = ({ canvasConfig, dataTestId, extraSpace = 0, height, width, }) => {
     // State for parsed/calculated dimensions
     const [parsedCanvas, setParsedCanvas] = useState({
@@ -28,8 +29,12 @@ export const useResponsiveCanvas = ({ canvasConfig, dataTestId, extraSpace = 0,
         : undefined;
     // Set up responsive dimensions with ResizeObserver
     useEffect(() => {
+        // SSR-safe: Skip effect if not in browser
+        if (!isBrowser()) {
+            return;
+        }
         // Find the SVG element for this specific component instance
-        const svgElement = document.querySelector(`[data-testid="${dataTestId}"]`);
+        const svgElement = safeQuerySelector(`[data-testid="${dataTestId}"]`);
         if (!svgElement) {
             return;
         }

package/dist/cjs/utils/cssGradientToSvg/cssGradientToSvg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cssGradientToSvg.d.ts","sourceRoot":"","sources":["../../../../src/utils/cssGradientToSvg/cssGradientToSvg.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,EAAE,WAAoB,KAAG,GAAG,CAAC,OA0ChF,CAAC"}
+{"version":3,"file":"cssGradientToSvg.d.ts","sourceRoot":"","sources":["../../../../src/utils/cssGradientToSvg/cssGradientToSvg.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,EAAE,WAAoB,KAAG,GAAG,CAAC,OAwChF,CAAC"}

package/dist/cjs/utils/cssGradientToSvg/cssGradientToSvg.js

@@ -1,4 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { logger } from '../logger/logger';
 /**
  * Converts a CSS linear gradient string into an SVG linear gradient.
  *
@@ -38,8 +39,7 @@ export const cssGradientToSVG = (cssGradient, id = 'gradientePath') => {
             x1 = '100%';
             break;
         default:
-            // eslint-disable-next-line no-console
-            console.error('Unsupported angle');
+            logger.warn(`Unsupported gradient angle: ${angle}°. Supported angles are 90, 180, 270.`);
             return _jsx(_Fragment, {}); // Return an empty fragment for unsupported angles
     }
     return (_jsx("defs", { children: _jsx("linearGradient", { id: id, x1: x1, x2: x2, y1: y1, y2: y2, children: stops.map((stop, index) => (_jsx("stop", { offset: stop.offset, stopColor: stop.color }, `${index}-${stop.offset}`.toString()))) }) }));

package/dist/cjs/utils/getCanvasDimensions/getCanvasDimensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getCanvasDimensions.d.ts","sourceRoot":"","sources":["../../../../src/utils/getCanvasDimensions/getCanvasDimensions.ts"],"names":[],"mappings":"AAyFA,UAAU,wBAAwB;IAChC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED,UAAU,yBAAyB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,4CAIjC,wBAAwB,KAAG,yBAkB7B,CAAC"}
+{"version":3,"file":"getCanvasDimensions.d.ts","sourceRoot":"","sources":["../../../../src/utils/getCanvasDimensions/getCanvasDimensions.ts"],"names":[],"mappings":"AAsGA,UAAU,wBAAwB;IAChC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED,UAAU,yBAAyB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,4CAIjC,wBAAwB,KAAG,yBAkB7B,CAAC"}

package/dist/cjs/utils/getCanvasDimensions/getCanvasDimensions.js

@@ -1,3 +1,4 @@
+import { safeDocument, safeGetComputedStyle } from '../ssr/ssr';
 import { Unit } from '../../types/unit.enum';
 /**
  * A mapping of string representations of units to their corresponding `Unit` enum values.
@@ -62,13 +63,23 @@ const calculatePercentage = (value, dimension, svgElement) => {
 };
 /**
  * Calculates the rem value based on the root font size.
+ * SSR-safe: Returns default 16px if not in browser environment.
  *
  * @param {number} value - The value in rem to be converted to pixels.
  * @returns {number} The calculated pixel value.
  */
 const calculateRem = (value) => {
-    const remValue = parseFloat(getComputedStyle(document.documentElement).fontSize);
-    return value * remValue;
+    const doc = safeDocument();
+    if (!doc) {
+        // SSR fallback: Default browser font size is typically 16px
+        return value * 16;
+    }
+    const style = safeGetComputedStyle(doc.documentElement);
+    if (!style) {
+        return value * 16;
+    }
+    const remValue = parseFloat(style.fontSize);
+    return value * (remValue || 16); // Fallback to 16 if fontSize is invalid
 };
 /**
  * Calculates the dimensions of an SVG element based on the provided width and height values.

package/dist/cjs/utils/index.d.ts

@@ -3,7 +3,9 @@ export * from './buildTickValues/buildTickValues';
 export * from './classNames/classNames';
 export * from './cssGradientToSvg/cssGradientToSvg';
 export * from './cursorNear/isNear';
+export * from './logger';
 export * from './shadowSvg/shadowSvg';
 export * from './shadowSvg/shadowSvg.types';
+export * from './ssr';
 export * from './textBound/textBound';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,OAAO,CAAC;AACtB,cAAc,uBAAuB,CAAC"}

package/dist/cjs/utils/index.js

@@ -3,6 +3,8 @@ export * from './buildTickValues/buildTickValues';
 export * from './classNames/classNames';
 export * from './cssGradientToSvg/cssGradientToSvg';
 export * from './cursorNear/isNear';
+export * from './logger';
 export * from './shadowSvg/shadowSvg';
 export * from './shadowSvg/shadowSvg.types';
+export * from './ssr';
 export * from './textBound/textBound';

package/dist/cjs/utils/logger/index.d.ts

@@ -0,0 +1,2 @@
+export { logger, configureLogger, resetLogger } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/cjs/utils/logger/index.js

@@ -0,0 +1 @@
+export { logger, configureLogger, resetLogger } from './logger';

package/dist/cjs/utils/logger/logger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Logger utility for @kubit/web-ui-charts
+ *
+ * Provides a centralized logging system that:
+ * - Respects NODE_ENV (disabled in production builds)
+ * - Supports different log levels
+ * - Can be configured/disabled by consumers
+ * - Will be stripped out in production builds via terser
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface LoggerConfig {
+    enabled: boolean;
+    minLevel: LogLevel;
+    prefix: string;
+}
+/**
+ * Configure the logger behavior
+ * @param newConfig - Partial configuration to merge with current settings
+ *
+ * @example
+ * ```ts
+ * // Disable all logging
+ * configureLogger({ enabled: false });
+ *
+ * // Enable debug logs in development
+ * configureLogger({ minLevel: 'debug' });
+ * ```
+ */
+export declare const configureLogger: (newConfig: Partial<LoggerConfig>) => void;
+/**
+ * Reset logger to default configuration
+ */
+export declare const resetLogger: () => void;
+/**
+ * Main logger object
+ * Export as singleton to ensure consistent configuration
+ */
+export declare const logger: {
+    debug: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/cjs/utils/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/utils/logger/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AA+BD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,OAAO,CAAC,YAAY,CAAC,KAAG,IAElE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC;AAkFF;;;GAGG;AACH,eAAO,MAAM,MAAM;qBA1DK,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;qBA+CjC,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;oBAhClC,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;oBAgBjC,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;CAgCvD,CAAC"}

package/dist/cjs/utils/logger/logger.js

@@ -0,0 +1,140 @@
+/**
+ * Logger utility for @kubit/web-ui-charts
+ *
+ * Provides a centralized logging system that:
+ * - Respects NODE_ENV (disabled in production builds)
+ * - Supports different log levels
+ * - Can be configured/disabled by consumers
+ * - Will be stripped out in production builds via terser
+ */
+/**
+ * Detect if we're in a production build
+ * Uses globalThis to be compatible with different environments (browser, Node, SSR)
+ */
+const isProduction = () => {
+    // Check if globalThis.process exists (Node/SSR environments)
+    if (typeof globalThis !== 'undefined' && 'process' in globalThis) {
+        const proc = globalThis.process;
+        return proc?.env?.NODE_ENV === 'production';
+    }
+    // In browser or other environments, assume development unless explicitly set
+    return false;
+};
+const DEFAULT_CONFIG = {
+    enabled: !isProduction(),
+    minLevel: 'info',
+    prefix: '[Kubit Charts]',
+};
+let config = { ...DEFAULT_CONFIG };
+const LOG_LEVELS = {
+    debug: 0,
+    error: 3,
+    info: 1,
+    warn: 2,
+};
+/**
+ * Configure the logger behavior
+ * @param newConfig - Partial configuration to merge with current settings
+ *
+ * @example
+ * ```ts
+ * // Disable all logging
+ * configureLogger({ enabled: false });
+ *
+ * // Enable debug logs in development
+ * configureLogger({ minLevel: 'debug' });
+ * ```
+ */
+export const configureLogger = (newConfig) => {
+    config = { ...config, ...newConfig };
+};
+/**
+ * Reset logger to default configuration
+ */
+export const resetLogger = () => {
+    config = { ...DEFAULT_CONFIG };
+};
+/**
+ * Check if a log level should be output based on configuration
+ */
+const shouldLog = (level) => {
+    if (!config.enabled) {
+        return false;
+    }
+    return LOG_LEVELS[level] >= LOG_LEVELS[config.minLevel];
+};
+/**
+ * Format log message with prefix
+ */
+const formatMessage = (message) => {
+    return `${config.prefix} ${message}`;
+};
+/**
+ * Log debug messages (development only)
+ * Useful for detailed debugging information
+ *
+ * @example
+ * ```ts
+ * logger.debug('Chart dimensions calculated', { width: 400, height: 300 });
+ * ```
+ */
+const debug = (message, ...args) => {
+    if (shouldLog('debug')) {
+        // eslint-disable-next-line no-console
+        console.debug(formatMessage(message), ...args);
+    }
+};
+/**
+ * Log informational messages
+ *
+ * @example
+ * ```ts
+ * logger.info('Chart rendered successfully');
+ * ```
+ */
+const info = (message, ...args) => {
+    if (shouldLog('info')) {
+        // eslint-disable-next-line no-console
+        console.info(formatMessage(message), ...args);
+    }
+};
+/**
+ * Log warning messages
+ * Use for non-breaking issues that developers should be aware of
+ *
+ * @example
+ * ```ts
+ * logger.warn('Invalid gradient angle, falling back to default', angle);
+ * ```
+ */
+const warn = (message, ...args) => {
+    if (shouldLog('warn')) {
+        // eslint-disable-next-line no-console
+        console.warn(formatMessage(message), ...args);
+    }
+};
+/**
+ * Log error messages
+ * Use for errors that don't prevent execution but indicate problems
+ *
+ * @example
+ * ```ts
+ * logger.error('Failed to calculate text bounds, using fallback', error);
+ * ```
+ */
+const error = (message, ...args) => {
+    if (shouldLog('error')) {
+        // eslint-disable-next-line no-console
+        console.error(formatMessage(message), ...args);
+    }
+};
+/**
+ * Main logger object
+ * Export as singleton to ensure consistent configuration
+ */
+export const logger = {
+    debug,
+    error,
+    info,
+    warn,
+};

package/dist/cjs/utils/ssr/index.d.ts

@@ -0,0 +1,2 @@
+export { isBrowser, isServer, safeWindow, safeDocument, safeExecute, safeExecuteWithFallback, createSVGElement, safeGetComputedStyle, safeQuerySelector, } from './ssr';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/ssr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/ssr/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,OAAO,CAAC"}

package/dist/cjs/utils/ssr/index.js

@@ -0,0 +1 @@
+export { isBrowser, isServer, safeWindow, safeDocument, safeExecute, safeExecuteWithFallback, createSVGElement, safeGetComputedStyle, safeQuerySelector, } from './ssr';

package/dist/cjs/utils/ssr/ssr.d.ts

@@ -0,0 +1,80 @@
+/**
+ * SSR (Server-Side Rendering) utilities
+ *
+ * Provides safe access to browser APIs when rendering on the server.
+ * Compatible with Next.js, Remix, Gatsby, and other SSR frameworks.
+ */
+/**
+ * Check if code is running in a browser environment
+ * @returns true if window is defined (browser), false otherwise (SSR)
+ */
+export declare const isBrowser: () => boolean;
+/**
+ * Check if code is running in a server environment
+ * @returns true if running on server (no window), false otherwise
+ */
+export declare const isServer: () => boolean;
+/**
+ * Safely access window object
+ * @returns window object if in browser, undefined if on server
+ */
+export declare const safeWindow: () => Window | undefined;
+/**
+ * Safely access document object
+ * @returns document object if in browser, undefined if on server
+ */
+export declare const safeDocument: () => Document | undefined;
+/**
+ * Safely execute code that requires browser APIs
+ * Returns undefined on server, executes callback in browser
+ *
+ * @param callback - Function to execute in browser environment
+ * @returns Result of callback if in browser, undefined if on server
+ *
+ * @example
+ * ```ts
+ * const width = safeExecute(() => window.innerWidth) ?? 0;
+ * ```
+ */
+export declare const safeExecute: <T>(callback: () => T) => T | undefined;
+/**
+ * Safely execute code with a fallback value for SSR
+ *
+ * @param callback - Function to execute in browser environment
+ * @param fallback - Value to return if on server or if callback fails
+ * @returns Result of callback if in browser, fallback otherwise
+ *
+ * @example
+ * ```ts
+ * const fontSize = safeExecuteWithFallback(
+ *   () => parseFloat(getComputedStyle(document.documentElement).fontSize),
+ *   16
+ * );
+ * ```
+ */
+export declare const safeExecuteWithFallback: <T>(callback: () => T, fallback: T) => T;
+/**
+ * Create an SVG element safely (browser-only)
+ * Returns undefined on server
+ *
+ * @param tagName - SVG element tag name
+ * @returns SVG element if in browser, undefined if on server
+ */
+export declare const createSVGElement: <K extends keyof SVGElementTagNameMap>(tagName: K) => SVGElementTagNameMap[K] | undefined;
+/**
+ * Get computed style safely
+ * Returns undefined on server
+ *
+ * @param element - Element to get computed style for
+ * @returns CSSStyleDeclaration if in browser, undefined if on server
+ */
+export declare const safeGetComputedStyle: (element: Element) => CSSStyleDeclaration | undefined;
+/**
+ * Query selector safely
+ * Returns null on server or if not found
+ *
+ * @param selector - CSS selector string
+ * @returns Element if found in browser, null otherwise
+ */
+export declare const safeQuerySelector: <T extends Element = Element>(selector: string) => T | null;
+//# sourceMappingURL=ssr.d.ts.map

package/dist/cjs/utils/ssr/ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../../../src/utils/ssr/ssr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAO,OAE5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAO,OAE3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAAM,GAAG,SAEtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,QAAQ,GAAG,SAE1C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,KAAG,CAAC,GAAG,SAStD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,EAAE,UAAU,CAAC,KAAG,CAE3E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,oBAAoB,EACnE,SAAS,CAAC,KACT,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAM5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,OAAO,KACf,mBAAmB,GAAG,SAMxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3D,UAAU,MAAM,KACf,CAAC,GAAG,IAMN,CAAC"}

package/dist/cjs/utils/ssr/ssr.js

@@ -0,0 +1,117 @@
+/**
+ * SSR (Server-Side Rendering) utilities
+ *
+ * Provides safe access to browser APIs when rendering on the server.
+ * Compatible with Next.js, Remix, Gatsby, and other SSR frameworks.
+ */
+/**
+ * Check if code is running in a browser environment
+ * @returns true if window is defined (browser), false otherwise (SSR)
+ */
+export const isBrowser = () => {
+    return typeof window !== 'undefined' && typeof document !== 'undefined';
+};
+/**
+ * Check if code is running in a server environment
+ * @returns true if running on server (no window), false otherwise
+ */
+export const isServer = () => {
+    return !isBrowser();
+};
+/**
+ * Safely access window object
+ * @returns window object if in browser, undefined if on server
+ */
+export const safeWindow = () => {
+    return isBrowser() ? window : undefined;
+};
+/**
+ * Safely access document object
+ * @returns document object if in browser, undefined if on server
+ */
+export const safeDocument = () => {
+    return isBrowser() ? document : undefined;
+};
+/**
+ * Safely execute code that requires browser APIs
+ * Returns undefined on server, executes callback in browser
+ *
+ * @param callback - Function to execute in browser environment
+ * @returns Result of callback if in browser, undefined if on server
+ *
+ * @example
+ * ```ts
+ * const width = safeExecute(() => window.innerWidth) ?? 0;
+ * ```
+ */
+export const safeExecute = (callback) => {
+    if (!isBrowser()) {
+        return undefined;
+    }
+    try {
+        return callback();
+    }
+    catch (error) {
+        return undefined;
+    }
+};
+/**
+ * Safely execute code with a fallback value for SSR
+ *
+ * @param callback - Function to execute in browser environment
+ * @param fallback - Value to return if on server or if callback fails
+ * @returns Result of callback if in browser, fallback otherwise
+ *
+ * @example
+ * ```ts
+ * const fontSize = safeExecuteWithFallback(
+ *   () => parseFloat(getComputedStyle(document.documentElement).fontSize),
+ *   16
+ * );
+ * ```
+ */
+export const safeExecuteWithFallback = (callback, fallback) => {
+    return safeExecute(callback) ?? fallback;
+};
+/**
+ * Create an SVG element safely (browser-only)
+ * Returns undefined on server
+ *
+ * @param tagName - SVG element tag name
+ * @returns SVG element if in browser, undefined if on server
+ */
+export const createSVGElement = (tagName) => {
+    const doc = safeDocument();
+    if (!doc) {
+        return undefined;
+    }
+    return doc.createElementNS('http://www.w3.org/2000/svg', tagName);
+};
+/**
+ * Get computed style safely
+ * Returns undefined on server
+ *
+ * @param element - Element to get computed style for
+ * @returns CSSStyleDeclaration if in browser, undefined if on server
+ */
+export const safeGetComputedStyle = (element) => {
+    const win = safeWindow();
+    if (!win) {
+        return undefined;
+    }
+    return win.getComputedStyle(element);
+};
+/**
+ * Query selector safely
+ * Returns null on server or if not found
+ *
+ * @param selector - CSS selector string
+ * @returns Element if found in browser, null otherwise
+ */
+export const safeQuerySelector = (selector) => {
+    const doc = safeDocument();
+    if (!doc) {
+        return null;
+    }
+    return doc.querySelector(selector);
+};

package/dist/cjs/utils/textBound/textBound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textBound.d.ts","sourceRoot":"","sources":["../../../../src/utils/textBound/textBound.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,SAAS,GAAI,0DAOvB,cAAc,KAAG,MA0BnB,CAAC"}
+{"version":3,"file":"textBound.d.ts","sourceRoot":"","sources":["../../../../src/utils/textBound/textBound.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,SAAS,GAAI,0DAOvB,cAAc,KAAG,MAwCnB,CAAC"}