baseline-kit 2.0.1 → 3.0.0

package/dist/utils/normalize.d.ts

@@ -14,35 +14,9 @@ export interface NormalizationOptions {
 /**
  * Normalizes CSS values to a consistent format based on base unit.
  *
- * @remarks
- * Handles:
- * - CSS length values
- * - Numeric values
- * - Special values (auto)
- * - Rounding to base unit
- * - Value clamping
- *
  * @param value - Value to normalize
  * @param options - Normalization configuration
  * @returns Normalized numeric value
- *
- * @example
- * ```ts
- * // Base unit normalization
- * normalizeValue(14, { base: 8 })  // => 16
- *
- * // With clamping
- * normalizeValue(14, {
- *   base: 8,
- *   clamp: { min: 8, max: 24 }
- * }) // => 16
- *
- * // Without rounding
- * normalizeValue(14, {
- *   base: 8,
- *   round: false
- * }) // => 14
- * ```
  */
 export declare function normalizeValue(value: string | number | undefined, options?: NormalizationOptions): number;
 /**
@@ -52,14 +26,5 @@ export declare function normalizeValue(value: string | number | undefined, optio
  * @param defaults - Default values if input is undefined
  * @param options - Normalization options
  * @returns Tuple of normalized values
- *
- * @example
- * ```ts
- * normalizeValuePair(
- *   ['14px', '20px'],
- *   [0, 0],
- *   { base: 8 }
- * ) // => [16, 24]
- * ```
  */
 export declare function normalizeValuePair(values: [string | number | undefined, string | number | undefined] | undefined, defaults: [number, number], options?: NormalizationOptions): [number, number];

package/dist/utils/parse.d.ts

@@ -1,28 +1,8 @@
-/**
- * @file parse.ts
- * @description CSS value parsing utilities
- * @module utils
- */
 /**
  * Parses a CSS unit string into its numeric value and unit.
  *
- * @remarks
- * Handles:
- * - Integer and decimal values
- * - All CSS units (px, em, rem, etc.)
- * - Percentage values
- * - Sign prefixes (+ and -)
- *
  * @param value - CSS value string to parse
  * @returns Object with value and unit, or null if parsing fails
- *
- * @example
- * ```ts
- * parseUnit('100px')    // => { value: 100, unit: 'px' }
- * parseUnit('1.5rem')   // => { value: 1.5, unit: 'rem' }
- * parseUnit('-20%')     // => { value: -20, unit: '%' }
- * parseUnit('invalid')  // => null
- * ```
  */
 export declare function parseUnit(value: string): {
     value: number;
@@ -31,22 +11,8 @@ export declare function parseUnit(value: string): {
 /**
  * Formats a value as a valid CSS string.
  *
- * @remarks
- * Handles:
- * - Numbers (adds px suffix)
- * - Special values (auto, 100%, etc.)
- * - Undefined values with defaults
- *
  * @param value - Value to format
  * @param defaultValue - Optional default if value is undefined
  * @returns Formatted CSS string
- *
- * @example
- * ```ts
- * formatValue(14)             // => "14px"
- * formatValue('auto')         // => "auto"
- * formatValue(undefined, 10)  // => "10px"
- * formatValue('1fr')         // => "1fr"
- * ```
  */
 export declare function formatValue(value: string | number | undefined, defaultValue?: number): string;

package/dist/utils/snapping.d.ts

@@ -1,8 +1,3 @@
-/**
- * @file snapping.ts
- * @description Baseline grid snapping utilities
- * @module utils
- */
 import { SnappingMode, Padding, PaddingValue } from '@components';
 /**
  * Calculates spacing adjustments to maintain baseline grid alignment.

package/dist/utils/ssr.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Detects if code is running in a server-side environment
+ */
+export declare const isSSR: boolean;
+/**
+ * Default dimensions to use during server-side rendering
+ */
+export declare const SSR_DIMENSIONS: {
+    width: number;
+    height: number;
+};
+/**
+ * Safe window-using function that works in both server and client
+ * @param clientFn Function that uses window/browser APIs
+ * @param fallback Fallback value to use in SSR environment
+ * @returns Result of clientFn in browser, fallback in SSR
+ */
+export declare function safeClientValue<T>(clientFn: () => T, fallback: T): T;
+/**
+ * Returns a stable value during SSR and initial render, then switches to
+ * the dynamic value after hydration
+ * @param isHydrated Boolean indicating if component is hydrated
+ * @param ssrValue Value to use during SSR/initial render
+ * @param dynamicValue Value to use after hydration
+ */
+export declare function hydratedValue<T>(isHydrated: boolean, ssrValue: T, dynamicValue: T): T;

package/dist/utils/timing.d.ts

@@ -1,8 +1,3 @@
-/**
- * @file timing.ts
- * @description Performance optimization utilities
- * @module utils
- */
 /**
  * Creates a debounced version of a function.
  *

package/package.json

@@ -1,25 +1,24 @@
 {
   "scripts": {
-    "lint": "eslint src/lib --fix",
+    "build": "vite build && bun run build:type && bun run build:combine-css",
     "build:type": "tsc -p tsconfig.build.json",
-    "prepare": "bun run build && bun run build:type",
-    "version": "changeset version",
-    "test:coverage": "vitest run --coverage",
-    "release": "changeset publish",
-    "typecheck": "tsc --noEmit",
-    "test:ui": "vitest --ui",
+    "build:combine-css": "node scripts/combine-css.js",
+    "changeset": "changeset",
     "dev": "vite",
-    "test:ci": "vitest run",
-    "format": "prettier --write \"src/lib/**/*.{ts,tsx,css}\"",
+    "format": "prettier --write \"src/**/*.{ts,tsx,css}\"",
+    "lint": "eslint src --fix",
+    "prepare": "bun run build && bun run build:type",
     "prepublishOnly": "bun run build && bun run build:type",
-    "changeset": "changeset",
+    "release": "changeset publish",
     "test": "vitest",
-    "build": "vite build"
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "version": "changeset version"
   },
   "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0",
-    "typescript": "^5.7.3"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.8.2"
   },
   "main": "dist/index.cjs",
   "engines": {
@@ -48,33 +47,35 @@
     "url": "git+https://github.com/dnvt/baseline-kit.git"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.27.12",
+    "@changesets/cli": "^2.28.1",
+    "@eslint/js": "^9.21.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.2.0",
-    "@types/node": "^22.13.0",
-    "@types/react": "^19.0.8",
-    "@types/react-dom": "^19.0.3",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "@vitejs/plugin-react-swc": "^3.7.2",
-    "@vitest/coverage-v8": "^2.1.8",
+    "@types/node": "^22.13.9",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@typescript-eslint/eslint-plugin": "^8.26.0",
+    "@typescript-eslint/parser": "^8.26.0",
+    "@vitejs/plugin-react-swc": "^3.8.0",
+    "@vitest/coverage-v8": "^3.0.8",
     "autoprefixer": "^10.4.20",
     "cssnano": "^7.0.6",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^9.1.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.3",
     "eslint-plugin-react": "^7.37.4",
-    "eslint-plugin-react-hooks": "^4.6.2",
-    "jsdom": "^25.0.1",
-    "prettier": "^3.4.2",
-    "rollup": "^4.34.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "jsdom": "^26.0.0",
+    "prettier": "^3.5.3",
+    "rollup": "^4.34.9",
     "rollup-plugin-dts": "^6.1.1",
     "rollup-plugin-visualizer": "^5.14.0",
-    "vite": "^6.1.0",
-    "vite-plugin-static-copy": "^2.2.0",
-    "vitest": "^2.1.8"
+    "vite": "6.2.1",
+    "vite-plugin-static-copy": "^2.3.0",
+    "vitest": "3.0.8"
   },
   "name": "baseline-kit",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "type": "module",
   "homepage": "https://github.com/dnvt/baseline-kit#readme",
   "types": "dist/index.d.ts",
@@ -82,9 +83,46 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./styles": {
+      "import": "./dist/styles.css",
+      "require": "./dist/styles.css",
+      "default": "./dist/styles.css"
+    },
+    "./theme": {
+      "import": "./dist/theme.css",
+      "require": "./dist/theme.css",
+      "default": "./dist/theme.css"
+    },
+    "./theme/default": {
+      "import": "./dist/theme/default.css",
+      "require": "./dist/theme/default.css",
+      "default": "./dist/theme/default.css"
+    },
+    "./theme/dark": {
+      "import": "./dist/theme/dark.css",
+      "require": "./dist/theme/dark.css",
+      "default": "./dist/theme/dark.css"
+    },
+    "./theme/tokens": {
+      "import": "./dist/theme/tokens.css",
+      "require": "./dist/theme/tokens.css",
+      "default": "./dist/theme/tokens.css"
+    },
+    "./full": {
+      "import": "./dist/baseline-kit.css",
+      "require": "./dist/baseline-kit.css",
+      "default": "./dist/baseline-kit.css"
     },
-    "./styles.css": "./dist/styles.css"
+    "./dist/styles.css": "./dist/styles.css",
+    "./dist/theme.css": "./dist/theme.css",
+    "./dist/theme/default.css": "./dist/theme/default.css",
+    "./dist/theme/dark.css": "./dist/theme/dark.css",
+    "./dist/theme/tokens.css": "./dist/theme/tokens.css",
+    "./dist/baseline-kit.css": "./dist/baseline-kit.css",
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
@@ -93,7 +131,12 @@
   ],
   "style": "dist/styles.css",
   "sideEffects": [
-    "dist/styles.css"
+    "dist/styles.css",
+    "dist/theme.css",
+    "dist/theme/default.css",
+    "dist/theme/dark.css",
+    "dist/theme/tokens.css",
+    "dist/baseline-kit.css"
   ],
   "bugs": {
     "url": "https://github.com/dnvt/baseline-kit/issues"
@@ -101,13 +144,12 @@
   "license": "MIT",
   "module": "dist/index.mjs",
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "access": "public"
   },
   "author": "Francois Denavaut",
   "description": "Baseline Kit is a lightweight development tool for visualizing and debugging grid systems and spacing in React applications. It provides configurable overlays for both column-based and baseline grids, flexible spacing components, and theme-aware configuration—all optimized for performance and built with TypeScript.",
   "dependencies": {
-    "esbuild": "^0.24.2",
-    "postcss-preset-env": "^10.1.3"
+    "esbuild": "^0.25.0",
+    "postcss-preset-env": "^10.1.5"
   }
 }