@xaui/core 0.1.7 → 0.1.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bamory grams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -269,12 +269,61 @@ const blue500 = colors.blue[500]
 const red600 = colors.red[600]
 ```
 
+## Spacing Tokens
+
+Access the spacing scale for consistent layout:
+
+```typescript
+import { spacing } from '@xaui/core/tokens'
+
+const smallGap = spacing.sm // 8
+const mediumGap = spacing.md // 16
+const largeGap = spacing.lg // 24
+```
+
+## Border Radius Tokens
+
+Access border radius tokens:
+
+```typescript
+import { borderRadius } from '@xaui/core/tokens'
+
+const smallRadius = borderRadius.sm // 4
+const mediumRadius = borderRadius.md // 8
+const largeRadius = borderRadius.lg // 12
+const fullRadius = borderRadius.full // 9999
+```
+
+## Typography Tokens
+
+Access typography tokens:
+
+```typescript
+import { fontSizes, fontWeights, fontFamilies } from '@xaui/core/tokens'
+
+const headingSize = fontSizes['2xl'] // 24
+const boldWeight = fontWeights.bold // 700
+const bodyFont = fontFamilies.body // 'System'
+```
+
+## Shadow Tokens
+
+Access shadow tokens for elevation:
+
+```typescript
+import { shadows } from '@xaui/core/tokens'
+
+const cardShadow = shadows.md
+// { shadowColor: '#000', shadowOffset: { width: 0, height: 2 }, shadowOpacity: 0.1, shadowRadius: 4, elevation: 2 }
+```
+
 ## TypeScript Support
 
 All exports are fully typed for excellent IntelliSense support:
 
 ```typescript
-import type { XUITheme } from '@xaui/core/theme'
+import type { XUITheme, DeepPartial } from '@xaui/core/theme'
+import type { ColorRole, SpacingScale } from '@xaui/core/tokens'
 ```
 
 ## Theme Structure

package/dist/index.cjs

@@ -21,16 +21,362 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   getSafeThemeColor: () => getSafeThemeColor,
-  withOpacity: () => withOpacity
+  withOpacity: () => withOpacity,
+  withPaletteNumber: () => withPaletteNumber
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/tokens/index.ts
+var colors = {
+  slate: {
+    50: "#f8fafc",
+    100: "#f1f5f9",
+    200: "#e2e8f0",
+    300: "#cbd5e1",
+    400: "#94a3b8",
+    500: "#64748b",
+    600: "#475569",
+    700: "#334155",
+    800: "#1e293b",
+    900: "#0f172a",
+    950: "#020617"
+  },
+  gray: {
+    50: "#f9fafb",
+    100: "#f3f4f6",
+    200: "#e5e7eb",
+    300: "#d1d5db",
+    400: "#9ca3af",
+    500: "#6b7280",
+    600: "#4b5563",
+    700: "#374151",
+    800: "#1f2937",
+    900: "#111827",
+    950: "#030712"
+  },
+  zinc: {
+    50: "#fafafa",
+    100: "#f4f4f5",
+    200: "#e4e4e7",
+    300: "#d4d4d8",
+    400: "#a1a1aa",
+    500: "#71717a",
+    600: "#52525b",
+    700: "#3f3f46",
+    800: "#27272a",
+    900: "#18181b",
+    950: "#09090b"
+  },
+  neutral: {
+    50: "#fafafa",
+    100: "#f5f5f5",
+    200: "#e5e5e5",
+    300: "#d4d4d4",
+    400: "#a3a3a3",
+    500: "#737373",
+    600: "#525252",
+    700: "#404040",
+    800: "#262626",
+    900: "#171717",
+    950: "#0a0a0a"
+  },
+  stone: {
+    50: "#fafaf9",
+    100: "#f5f5f4",
+    200: "#e7e5e4",
+    300: "#d6d3d1",
+    400: "#a8a29e",
+    500: "#78716c",
+    600: "#57534e",
+    700: "#44403c",
+    800: "#292524",
+    900: "#1c1917",
+    950: "#0c0a09"
+  },
+  red: {
+    50: "#fef2f2",
+    100: "#fee2e2",
+    200: "#fecaca",
+    300: "#fca5a5",
+    400: "#f87171",
+    500: "#ef4444",
+    600: "#dc2626",
+    700: "#b91c1c",
+    800: "#991b1b",
+    900: "#7f1d1d",
+    950: "#450a0a"
+  },
+  orange: {
+    50: "#fff7ed",
+    100: "#ffedd5",
+    200: "#fed7aa",
+    300: "#fdba74",
+    400: "#fb923c",
+    500: "#f97316",
+    600: "#ea580c",
+    700: "#c2410c",
+    800: "#9a3412",
+    900: "#7c2d12",
+    950: "#431407"
+  },
+  amber: {
+    50: "#fffbeb",
+    100: "#fef3c7",
+    200: "#fde68a",
+    300: "#fcd34d",
+    400: "#fbbf24",
+    500: "#f59e0b",
+    600: "#d97706",
+    700: "#b45309",
+    800: "#92400e",
+    900: "#78350f",
+    950: "#451a03"
+  },
+  yellow: {
+    50: "#fefce8",
+    100: "#fef9c3",
+    200: "#fef08a",
+    300: "#fde047",
+    400: "#facc15",
+    500: "#eab308",
+    600: "#ca8a04",
+    700: "#a16207",
+    800: "#854d0e",
+    900: "#713f12",
+    950: "#422006"
+  },
+  lime: {
+    50: "#f7fee7",
+    100: "#ecfccb",
+    200: "#d9f99d",
+    300: "#bef264",
+    400: "#a3e635",
+    500: "#84cc16",
+    600: "#65a30d",
+    700: "#4d7c0f",
+    800: "#3f6212",
+    900: "#365314",
+    950: "#1a2e05"
+  },
+  green: {
+    50: "#f0fdf4",
+    100: "#dcfce7",
+    200: "#bbf7d0",
+    300: "#86efac",
+    400: "#4ade80",
+    500: "#22c55e",
+    600: "#16a34a",
+    700: "#15803d",
+    800: "#166534",
+    900: "#14532d",
+    950: "#052e16"
+  },
+  emerald: {
+    50: "#ecfdf5",
+    100: "#d1fae5",
+    200: "#a7f3d0",
+    300: "#6ee7b7",
+    400: "#34d399",
+    500: "#10b981",
+    600: "#059669",
+    700: "#047857",
+    800: "#065f46",
+    900: "#064e3b",
+    950: "#022c22"
+  },
+  teal: {
+    50: "#f0fdfa",
+    100: "#ccfbf1",
+    200: "#99f6e4",
+    300: "#5eead4",
+    400: "#2dd4bf",
+    500: "#14b8a6",
+    600: "#0d9488",
+    700: "#0f766e",
+    800: "#115e59",
+    900: "#134e4a",
+    950: "#042f2e"
+  },
+  cyan: {
+    50: "#ecfeff",
+    100: "#cffafe",
+    200: "#a5f3fc",
+    300: "#67e8f9",
+    400: "#22d3ee",
+    500: "#06b6d4",
+    600: "#0891b2",
+    700: "#0e7490",
+    800: "#155e75",
+    900: "#164e63",
+    950: "#083344"
+  },
+  sky: {
+    50: "#f0f9ff",
+    100: "#e0f2fe",
+    200: "#bae6fd",
+    300: "#7dd3fc",
+    400: "#38bdf8",
+    500: "#0ea5e9",
+    600: "#0284c7",
+    700: "#0369a1",
+    800: "#075985",
+    900: "#0c4a6e",
+    950: "#082f49"
+  },
+  blue: {
+    50: "#eff6ff",
+    100: "#dbeafe",
+    200: "#bfdbfe",
+    300: "#93c5fd",
+    400: "#60a5fa",
+    500: "#3b82f6",
+    600: "#2563eb",
+    700: "#1d4ed8",
+    800: "#1e40af",
+    900: "#1e3a8a",
+    950: "#172554"
+  },
+  indigo: {
+    50: "#eef2ff",
+    100: "#e0e7ff",
+    200: "#c7d2fe",
+    300: "#a5b4fc",
+    400: "#818cf8",
+    500: "#6366f1",
+    600: "#4f46e5",
+    700: "#4338ca",
+    800: "#3730a3",
+    900: "#312e81",
+    950: "#1e1b4b"
+  },
+  violet: {
+    50: "#f5f3ff",
+    100: "#ede9fe",
+    200: "#ddd6fe",
+    300: "#c4b5fd",
+    400: "#a78bfa",
+    500: "#8b5cf6",
+    600: "#7c3aed",
+    700: "#6d28d9",
+    800: "#5b21b6",
+    900: "#4c1d95",
+    950: "#2e1065"
+  },
+  purple: {
+    50: "#faf5ff",
+    100: "#f3e8ff",
+    200: "#e9d5ff",
+    300: "#d8b4fe",
+    400: "#c084fc",
+    500: "#a855f7",
+    600: "#9333ea",
+    700: "#7e22ce",
+    800: "#6b21a8",
+    900: "#581c87",
+    950: "#3b0764"
+  },
+  fuchsia: {
+    50: "#fdf4ff",
+    100: "#fae8ff",
+    200: "#f5d0fe",
+    300: "#f0abfc",
+    400: "#e879f9",
+    500: "#d946ef",
+    600: "#c026d3",
+    700: "#a21caf",
+    800: "#86198f",
+    900: "#701a75",
+    950: "#4a044e"
+  },
+  pink: {
+    50: "#fdf2f8",
+    100: "#fce7f3",
+    200: "#fbcfe8",
+    300: "#f9a8d4",
+    400: "#f472b6",
+    500: "#ec4899",
+    600: "#db2777",
+    700: "#be185d",
+    800: "#9d174d",
+    900: "#831843",
+    950: "#500724"
+  },
+  rose: {
+    50: "#fff1f2",
+    100: "#ffe4e6",
+    200: "#fecdd3",
+    300: "#fda4af",
+    400: "#fb7185",
+    500: "#f43f5e",
+    600: "#e11d48",
+    700: "#be123c",
+    800: "#9f1239",
+    900: "#881337",
+    950: "#4c0519"
+  },
+  black: "#000000",
+  white: "#ffffff",
+  transparent: "transparent"
+};
+
 // src/utils/colors-utils.ts
 function withOpacity(color, opacity) {
   const clampedOpacity = Math.max(0, Math.min(1, opacity));
   const alpha = Math.round(clampedOpacity * 255).toString(16).padStart(2, "0");
   return `${color}${alpha}`;
 }
+var normalizeHexColor = (color) => {
+  const normalized = color.trim().toLowerCase();
+  if (!normalized.startsWith("#")) return normalized;
+  if (normalized.length === 9) return normalized.slice(0, 7);
+  if (normalized.length === 5) {
+    const [r, g, b] = normalized.slice(1, 4).split("");
+    return `#${r}${r}${g}${g}${b}${b}`;
+  }
+  return normalized;
+};
+var colorPalettes = Object.values(colors).filter(
+  (value) => typeof value === "object" && value !== null
+);
+var hexToRgb = (color) => {
+  const normalized = normalizeHexColor(color);
+  if (!normalized.startsWith("#") || normalized.length !== 7) return null;
+  const r = parseInt(normalized.slice(1, 3), 16);
+  const g = parseInt(normalized.slice(3, 5), 16);
+  const b = parseInt(normalized.slice(5, 7), 16);
+  return Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b) ? null : [r, g, b];
+};
+var colorDistance = (a, b) => {
+  const dr = a[0] - b[0];
+  const dg = a[1] - b[1];
+  const db = a[2] - b[2];
+  return dr * dr + dg * dg + db * db;
+};
+function withPaletteNumber(color, paletteNumber) {
+  const normalizedInput = normalizeHexColor(color);
+  const inputRgb = hexToRgb(normalizedInput);
+  if (!inputRgb) return color;
+  const exactPalette = colorPalettes.find(
+    (scale) => Object.values(scale).some(
+      (scaleColor) => normalizeHexColor(scaleColor) === normalizedInput
+    )
+  );
+  if (exactPalette) return exactPalette[paletteNumber];
+  let nearestPalette = null;
+  let nearestDistance = Number.POSITIVE_INFINITY;
+  for (const palette of colorPalettes) {
+    for (const swatch of Object.values(palette)) {
+      const swatchRgb = hexToRgb(swatch);
+      if (!swatchRgb) continue;
+      const distance = colorDistance(inputRgb, swatchRgb);
+      if (distance < nearestDistance) {
+        nearestDistance = distance;
+        nearestPalette = palette;
+      }
+    }
+  }
+  return nearestPalette ? nearestPalette[paletteNumber] : color;
+}
 var validThemeColors = [
   "primary",
   "secondary",
@@ -46,5 +392,6 @@ function getSafeThemeColor(themeColor) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getSafeThemeColor,
-  withOpacity
+  withOpacity,
+  withPaletteNumber
 });

package/dist/index.d.cts

@@ -5,8 +5,16 @@
  * @returns Color with opacity
  */
 declare function withOpacity(color: string, opacity: number): string;
+type PaletteNumber = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
+/**
+ * Create opacity variants for a color
+ * @param color - Base color hex
+ * @param paletteNumber - Palette number (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+ * @returns Color from matched (or nearest) palette family at the requested palette number
+ */
+declare function withPaletteNumber(color: string, paletteNumber: PaletteNumber): string;
 declare const validThemeColors: readonly ["primary", "secondary", "tertiary", "danger", "warning", "success", "default"];
 declare function getSafeThemeColor(themeColor: string): ValidThemeColor;
 type ValidThemeColor = (typeof validThemeColors)[number];
 
-export { getSafeThemeColor, withOpacity };
+export { getSafeThemeColor, withOpacity, withPaletteNumber };

package/dist/index.d.ts

@@ -5,8 +5,16 @@
  * @returns Color with opacity
  */
 declare function withOpacity(color: string, opacity: number): string;
+type PaletteNumber = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
+/**
+ * Create opacity variants for a color
+ * @param color - Base color hex
+ * @param paletteNumber - Palette number (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+ * @returns Color from matched (or nearest) palette family at the requested palette number
+ */
+declare function withPaletteNumber(color: string, paletteNumber: PaletteNumber): string;
 declare const validThemeColors: readonly ["primary", "secondary", "tertiary", "danger", "warning", "success", "default"];
 declare function getSafeThemeColor(themeColor: string): ValidThemeColor;
 type ValidThemeColor = (typeof validThemeColors)[number];
 
-export { getSafeThemeColor, withOpacity };
+export { getSafeThemeColor, withOpacity, withPaletteNumber };

package/dist/index.js

@@ -1,9 +1,65 @@
+import {
+  colors
+} from "./chunk-IRULUOQR.js";
+
 // src/utils/colors-utils.ts
 function withOpacity(color, opacity) {
   const clampedOpacity = Math.max(0, Math.min(1, opacity));
   const alpha = Math.round(clampedOpacity * 255).toString(16).padStart(2, "0");
   return `${color}${alpha}`;
 }
+var normalizeHexColor = (color) => {
+  const normalized = color.trim().toLowerCase();
+  if (!normalized.startsWith("#")) return normalized;
+  if (normalized.length === 9) return normalized.slice(0, 7);
+  if (normalized.length === 5) {
+    const [r, g, b] = normalized.slice(1, 4).split("");
+    return `#${r}${r}${g}${g}${b}${b}`;
+  }
+  return normalized;
+};
+var colorPalettes = Object.values(colors).filter(
+  (value) => typeof value === "object" && value !== null
+);
+var hexToRgb = (color) => {
+  const normalized = normalizeHexColor(color);
+  if (!normalized.startsWith("#") || normalized.length !== 7) return null;
+  const r = parseInt(normalized.slice(1, 3), 16);
+  const g = parseInt(normalized.slice(3, 5), 16);
+  const b = parseInt(normalized.slice(5, 7), 16);
+  return Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b) ? null : [r, g, b];
+};
+var colorDistance = (a, b) => {
+  const dr = a[0] - b[0];
+  const dg = a[1] - b[1];
+  const db = a[2] - b[2];
+  return dr * dr + dg * dg + db * db;
+};
+function withPaletteNumber(color, paletteNumber) {
+  const normalizedInput = normalizeHexColor(color);
+  const inputRgb = hexToRgb(normalizedInput);
+  if (!inputRgb) return color;
+  const exactPalette = colorPalettes.find(
+    (scale) => Object.values(scale).some(
+      (scaleColor) => normalizeHexColor(scaleColor) === normalizedInput
+    )
+  );
+  if (exactPalette) return exactPalette[paletteNumber];
+  let nearestPalette = null;
+  let nearestDistance = Number.POSITIVE_INFINITY;
+  for (const palette of colorPalettes) {
+    for (const swatch of Object.values(palette)) {
+      const swatchRgb = hexToRgb(swatch);
+      if (!swatchRgb) continue;
+      const distance = colorDistance(inputRgb, swatchRgb);
+      if (distance < nearestDistance) {
+        nearestDistance = distance;
+        nearestPalette = palette;
+      }
+    }
+  }
+  return nearestPalette ? nearestPalette[paletteNumber] : color;
+}
 var validThemeColors = [
   "primary",
   "secondary",
@@ -18,5 +74,6 @@ function getSafeThemeColor(themeColor) {
 }
 export {
   getSafeThemeColor,
-  withOpacity
+  withOpacity,
+  withPaletteNumber
 };

package/dist/theme/index.cjs

@@ -328,12 +328,12 @@ var themeColors = {
   secondary: {
     main: colors.zinc[500],
     foreground: colors.white,
-    background: colors.purple[200]
+    background: colors.zinc[200]
   },
   tertiary: {
     main: colors.stone[500],
     foreground: colors.white,
-    background: colors.red[100]
+    background: colors.stone[100]
   },
   danger: {
     main: colors.red[700],
@@ -351,8 +351,8 @@ var themeColors = {
     background: colors.green[100]
   },
   default: {
-    main: colors.white,
-    foreground: colors.zinc[900],
+    main: colors.zinc[900],
+    foreground: colors.white,
     background: colors.zinc[200]
   },
   background: colors.white,
@@ -390,8 +390,8 @@ var darkThemeColors = {
     background: colors.green[900]
   },
   default: {
-    main: colors.zinc[900],
-    foreground: colors.stone[200],
+    main: colors.stone[200],
+    foreground: colors.zinc[900],
     background: colors.zinc[700]
   },
   background: colors.zinc[900],
@@ -423,9 +423,9 @@ var baseTheme = {
     none: 0,
     xs: 0.5,
     sm: 1,
-    md: 2,
-    lg: 3,
-    xl: 4
+    md: 1.75,
+    lg: 2.5,
+    xl: 3
   },
   fontSizes: {
     xs: 12,

package/dist/theme/index.d.cts

@@ -121,7 +121,8 @@ interface XUITheme {
     fontFamilies: ThemeFontFamilies;
     shadows: ThemeShadows;
 }
+type PartialXUITheme = Partial<XUITheme>;
 declare const defaultTheme: XUITheme;
 declare const defaultDarkTheme: XUITheme;
 
-export { type XUITheme, defaultDarkTheme, defaultTheme };
+export { type PartialXUITheme, type XUITheme, defaultDarkTheme, defaultTheme };

package/dist/theme/index.d.ts

@@ -121,7 +121,8 @@ interface XUITheme {
     fontFamilies: ThemeFontFamilies;
     shadows: ThemeShadows;
 }
+type PartialXUITheme = Partial<XUITheme>;
 declare const defaultTheme: XUITheme;
 declare const defaultDarkTheme: XUITheme;
 
-export { type XUITheme, defaultDarkTheme, defaultTheme };
+export { type PartialXUITheme, type XUITheme, defaultDarkTheme, defaultTheme };

package/dist/theme/index.js

@@ -12,12 +12,12 @@ var themeColors = {
   secondary: {
     main: colors.zinc[500],
     foreground: colors.white,
-    background: colors.purple[200]
+    background: colors.zinc[200]
   },
   tertiary: {
     main: colors.stone[500],
     foreground: colors.white,
-    background: colors.red[100]
+    background: colors.stone[100]
   },
   danger: {
     main: colors.red[700],
@@ -35,8 +35,8 @@ var themeColors = {
     background: colors.green[100]
   },
   default: {
-    main: colors.white,
-    foreground: colors.zinc[900],
+    main: colors.zinc[900],
+    foreground: colors.white,
     background: colors.zinc[200]
   },
   background: colors.white,
@@ -74,8 +74,8 @@ var darkThemeColors = {
     background: colors.green[900]
   },
   default: {
-    main: colors.zinc[900],
-    foreground: colors.stone[200],
+    main: colors.stone[200],
+    foreground: colors.zinc[900],
     background: colors.zinc[700]
   },
   background: colors.zinc[900],
@@ -107,9 +107,9 @@ var baseTheme = {
     none: 0,
     xs: 0.5,
     sm: 1,
-    md: 2,
-    lg: 3,
-    xl: 4
+    md: 1.75,
+    lg: 2.5,
+    xl: 3
   },
   fontSizes: {
     xs: 12,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaui/core",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "A modern React Native UI library with Flutter-inspired API, smooth animations, and comprehensive design system",
   "keywords": [
     "react-native",