@kuniversedev/design-tokens 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,75 @@
+import { B as BorderWidthTokens, C as ColorTokens, D as DesignTokens, L as LayoutTokens, M as MotionTokens, R as RadiusTokens, S as ShadowTokens, a as SpacingTokens, T as TypographyTokens, Z as ZIndexTokens } from './types-BcWm9ccA.cjs';
+export { b as ColorScale, c as ColorToken, d as ContainerTokens, e as DimensionToken, f as DurationToken, g as DurationTokens, E as EasingToken, h as EasingTokens, F as FontFamilyTokens, i as FontWeightTokens, j as ShadowToken, k as TypeScaleEntry, l as TypeScaleTokens } from './types-BcWm9ccA.cjs';
+
+/**
+ * Primary design tokens export.
+ *
+ * @example
+ * ```typescript
+ * import { tokens } from "@k-universe/design-tokens";
+ *
+ * tokens.colors.background          // '#0A0A0A'
+ * tokens.colors.foreground          // '#FFFFFF'
+ * tokens.colors.secondary           // '#00CC88'
+ * tokens.typography.fontFamily.sans // 'Power Grotesk, ...'
+ * tokens.spacing[15]                // '60px'  — 60px margin principle
+ * tokens.motion.duration.default    // '300ms'
+ * ```
+ */
+declare const tokens: DesignTokens;
+/** Alias for tokens — backwards compatibility. */
+declare const designTokens: DesignTokens;
+/** Shortcut: tokens.colors */
+declare const colors: ColorTokens;
+/** Shortcut: tokens.typography */
+declare const typography: TypographyTokens;
+/** Shortcut: tokens.spacing */
+declare const spacing: SpacingTokens;
+/** Shortcut: tokens.motion */
+declare const motion: MotionTokens;
+/** Shortcut: tokens.layout */
+declare const layout: LayoutTokens;
+/** Shortcut: tokens.radius */
+declare const radius: RadiusTokens;
+/** Shortcut: tokens.shadows */
+declare const shadows: ShadowTokens;
+/** Shortcut: tokens.zIndex */
+declare const zIndex: ZIndexTokens;
+/** Shortcut: tokens.borderWidth */
+declare const borderWidth: BorderWidthTokens;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/**
+ * Deep-merges override tokens into a base token set.
+ * Returns a new object — does not mutate the base.
+ *
+ * @example
+ * ```typescript
+ * import { tokens, mergeTokens } from "@k-universe/design-tokens";
+ *
+ * const theme = mergeTokens(tokens, {
+ *   colors: { primary: '#FF6600' },
+ * });
+ * ```
+ */
+declare function mergeTokens(base: DesignTokens, overrides: DeepPartial<DesignTokens>): DesignTokens;
+/**
+ * Retrieves a token value using dot-notation path access.
+ *
+ * @param obj  - The token object to traverse (typically `tokens`).
+ * @param path - Dot-notation path string, e.g. `'colors.primary'`.
+ * @returns The value at the given path, or `undefined` if not found.
+ *
+ * @example
+ * ```typescript
+ * import { tokens, getTokenByPath } from "@k-universe/design-tokens";
+ *
+ * getTokenByPath(tokens, 'colors.primary')          // '#0066FF'
+ * getTokenByPath(tokens, 'motion.duration.default') // '300ms'
+ * getTokenByPath(tokens, 'spacing.15')              // '60px'
+ * ```
+ */
+declare function getTokenByPath(obj: unknown, path: string): unknown;
+
+export { BorderWidthTokens, ColorTokens, DesignTokens, LayoutTokens, MotionTokens, RadiusTokens, ShadowTokens, SpacingTokens, TypographyTokens, ZIndexTokens, borderWidth, colors, designTokens, getTokenByPath, layout, mergeTokens, motion, radius, shadows, spacing, tokens, typography, zIndex };

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { B as BorderWidthTokens, C as ColorTokens, D as DesignTokens, L as LayoutTokens, M as MotionTokens, R as RadiusTokens, S as ShadowTokens, a as SpacingTokens, T as TypographyTokens, Z as ZIndexTokens } from './types-BcWm9ccA.js';
+export { b as ColorScale, c as ColorToken, d as ContainerTokens, e as DimensionToken, f as DurationToken, g as DurationTokens, E as EasingToken, h as EasingTokens, F as FontFamilyTokens, i as FontWeightTokens, j as ShadowToken, k as TypeScaleEntry, l as TypeScaleTokens } from './types-BcWm9ccA.js';
+
+/**
+ * Primary design tokens export.
+ *
+ * @example
+ * ```typescript
+ * import { tokens } from "@k-universe/design-tokens";
+ *
+ * tokens.colors.background          // '#0A0A0A'
+ * tokens.colors.foreground          // '#FFFFFF'
+ * tokens.colors.secondary           // '#00CC88'
+ * tokens.typography.fontFamily.sans // 'Power Grotesk, ...'
+ * tokens.spacing[15]                // '60px'  — 60px margin principle
+ * tokens.motion.duration.default    // '300ms'
+ * ```
+ */
+declare const tokens: DesignTokens;
+/** Alias for tokens — backwards compatibility. */
+declare const designTokens: DesignTokens;
+/** Shortcut: tokens.colors */
+declare const colors: ColorTokens;
+/** Shortcut: tokens.typography */
+declare const typography: TypographyTokens;
+/** Shortcut: tokens.spacing */
+declare const spacing: SpacingTokens;
+/** Shortcut: tokens.motion */
+declare const motion: MotionTokens;
+/** Shortcut: tokens.layout */
+declare const layout: LayoutTokens;
+/** Shortcut: tokens.radius */
+declare const radius: RadiusTokens;
+/** Shortcut: tokens.shadows */
+declare const shadows: ShadowTokens;
+/** Shortcut: tokens.zIndex */
+declare const zIndex: ZIndexTokens;
+/** Shortcut: tokens.borderWidth */
+declare const borderWidth: BorderWidthTokens;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/**
+ * Deep-merges override tokens into a base token set.
+ * Returns a new object — does not mutate the base.
+ *
+ * @example
+ * ```typescript
+ * import { tokens, mergeTokens } from "@k-universe/design-tokens";
+ *
+ * const theme = mergeTokens(tokens, {
+ *   colors: { primary: '#FF6600' },
+ * });
+ * ```
+ */
+declare function mergeTokens(base: DesignTokens, overrides: DeepPartial<DesignTokens>): DesignTokens;
+/**
+ * Retrieves a token value using dot-notation path access.
+ *
+ * @param obj  - The token object to traverse (typically `tokens`).
+ * @param path - Dot-notation path string, e.g. `'colors.primary'`.
+ * @returns The value at the given path, or `undefined` if not found.
+ *
+ * @example
+ * ```typescript
+ * import { tokens, getTokenByPath } from "@k-universe/design-tokens";
+ *
+ * getTokenByPath(tokens, 'colors.primary')          // '#0066FF'
+ * getTokenByPath(tokens, 'motion.duration.default') // '300ms'
+ * getTokenByPath(tokens, 'spacing.15')              // '60px'
+ * ```
+ */
+declare function getTokenByPath(obj: unknown, path: string): unknown;
+
+export { BorderWidthTokens, ColorTokens, DesignTokens, LayoutTokens, MotionTokens, RadiusTokens, ShadowTokens, SpacingTokens, TypographyTokens, ZIndexTokens, borderWidth, colors, designTokens, getTokenByPath, layout, mergeTokens, motion, radius, shadows, spacing, tokens, typography, zIndex };

package/dist/index.js

@@ -0,0 +1,216 @@
+// src/index.ts
+var colorsImpl = {
+  // Base neutrals
+  black: "#000000",
+  white: "#FFFFFF",
+  gray: {
+    100: "#F5F5F5",
+    300: "#D4D4D4",
+    500: "#737373",
+    700: "#404040",
+    900: "#171717"
+  },
+  // Dark mode semantic surfaces
+  background: "#0A0A0A",
+  surface: "#1A1A1A",
+  foreground: "#FFFFFF",
+  muted: "#2A2A2A",
+  border: "#333333",
+  // Accent / status
+  primary: "#0066FF",
+  secondary: "#00CC88",
+  success: "#00DD77",
+  error: "#FF3333",
+  warning: "#FFAA00"
+};
+var typographyImpl = {
+  fontFamily: {
+    sans: 'Power Grotesk, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+    mono: 'JetBrains Mono, "Fira Code", monospace',
+    display: 'Power Grotesk, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'
+  },
+  scale: {
+    hero: { size: "4rem", lineHeight: "1.125", weight: 700 },
+    // 64px
+    h1: { size: "3rem", lineHeight: "1.167", weight: 700 },
+    // 48px
+    h2: { size: "2rem", lineHeight: "1.25", weight: 600 },
+    // 32px
+    h3: { size: "1.5rem", lineHeight: "1.333", weight: 600 },
+    // 24px
+    body: { size: "1rem", lineHeight: "1.5", weight: 400 },
+    // 16px
+    small: { size: "0.875rem", lineHeight: "1.429", weight: 400 },
+    // 14px
+    tiny: { size: "0.75rem", lineHeight: "1.333", weight: 400 }
+    // 12px
+  },
+  fontWeight: {
+    thin: 200,
+    light: 300,
+    regular: 400,
+    medium: 500,
+    semibold: 600,
+    bold: 700,
+    black: 900
+  }
+};
+var spacingImpl = {
+  0: "0",
+  1: "4px",
+  2: "8px",
+  3: "12px",
+  4: "16px",
+  5: "20px",
+  6: "24px",
+  7: "28px",
+  8: "32px",
+  9: "36px",
+  10: "40px",
+  12: "48px",
+  14: "56px",
+  15: "60px",
+  // K-Universe 60px margin principle
+  16: "64px",
+  18: "72px",
+  20: "80px",
+  24: "96px",
+  32: "128px"
+};
+var motionImpl = {
+  duration: {
+    instant: "100ms",
+    fast: "200ms",
+    default: "300ms",
+    slow: "500ms",
+    crawl: "800ms"
+  },
+  easing: {
+    default: "cubic-bezier(0.4, 0, 0.2, 1)",
+    smooth: "cubic-bezier(0.25, 0.1, 0.25, 1)",
+    sharp: "cubic-bezier(0.4, 0, 0.6, 1)",
+    accelerate: "cubic-bezier(0.4, 0, 1, 1)",
+    decelerate: "cubic-bezier(0, 0, 0.2, 1)"
+  }
+};
+var layoutImpl = {
+  margin: "60px",
+  // primary horizontal landmark
+  sectionSpacing: "96px",
+  container: {
+    sm: "640px",
+    md: "768px",
+    lg: "1024px",
+    xl: "1280px",
+    max: "1320px"
+    // K-Universe max-width
+  },
+  measure: "65ch"
+};
+var radiusImpl = {
+  none: "0",
+  xs: "2px",
+  sm: "4px",
+  md: "6px",
+  lg: "8px",
+  xl: "12px",
+  "2xl": "16px",
+  "3xl": "24px",
+  round: "9999px"
+};
+var shadowsImpl = {
+  xs: "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
+  sm: "0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)",
+  md: "0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)",
+  lg: "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
+  xl: "0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)",
+  "2xl": "0 25px 50px -12px rgba(0, 0, 0, 0.25)",
+  inner: "inset 0 2px 4px 0 rgba(0, 0, 0, 0.05)",
+  cardHover: "0 20px 55px rgba(0, 0, 0, 0.55)",
+  elevated: "0 24px 60px rgba(0, 0, 0, 0.45)"
+};
+var zIndexImpl = {
+  bg: -1,
+  base: 0,
+  content: 10,
+  dropdown: 100,
+  sticky: 200,
+  overlay: 300,
+  modal: 400,
+  popover: 500,
+  tooltip: 600,
+  toast: 700
+};
+var borderWidthImpl = {
+  thin: "1px",
+  base: "2px",
+  thick: "4px"
+};
+var tokens = {
+  colors: colorsImpl,
+  typography: typographyImpl,
+  spacing: spacingImpl,
+  motion: motionImpl,
+  layout: layoutImpl,
+  radius: radiusImpl,
+  shadows: shadowsImpl,
+  zIndex: zIndexImpl,
+  borderWidth: borderWidthImpl
+};
+var designTokens = tokens;
+var colors = tokens.colors;
+var typography = tokens.typography;
+var spacing = tokens.spacing;
+var motion = tokens.motion;
+var layout = tokens.layout;
+var radius = tokens.radius;
+var shadows = tokens.shadows;
+var zIndex = tokens.zIndex;
+var borderWidth = tokens.borderWidth;
+function mergeTokens(base, overrides) {
+  return deepMerge(base, overrides);
+}
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+    const sourceVal = source[key];
+    const targetVal = target[key];
+    if (sourceVal !== null && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal !== null && typeof targetVal === "object" && !Array.isArray(targetVal)) {
+      result[key] = deepMerge(
+        targetVal,
+        sourceVal
+      );
+    } else if (sourceVal !== void 0) {
+      result[key] = sourceVal;
+    }
+  }
+  return result;
+}
+function getTokenByPath(obj, path) {
+  if (!path) return obj;
+  const segments = path.split(".");
+  let current = obj;
+  for (const segment of segments) {
+    if (current === null || current === void 0) return void 0;
+    if (typeof current !== "object") return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+export {
+  borderWidth,
+  colors,
+  designTokens,
+  getTokenByPath,
+  layout,
+  mergeTokens,
+  motion,
+  radius,
+  shadows,
+  spacing,
+  tokens,
+  typography,
+  zIndex
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @k-universe/design-tokens\n *\n * Foundational design token implementation for K-Universe.\n * All values are authoritative — derived from the K-Universe design system spec.\n *\n * @example\n * ```typescript\n * import { tokens } from \"@k-universe/design-tokens\";\n *\n * tokens.colors.background     // '#0A0A0A'\n * tokens.colors.foreground     // '#FFFFFF'\n * tokens.colors.secondary      // '#00CC88'\n * tokens.typography.fontFamily.sans  // 'Power Grotesk, ...'\n * ```\n */\n\n// Re-export all types from the types module\nexport type {\n  ColorToken,\n  DimensionToken,\n  DurationToken,\n  EasingToken,\n  ShadowToken,\n  ColorScale,\n  ColorTokens,\n  TypeScaleEntry,\n  FontFamilyTokens,\n  TypeScaleTokens,\n  FontWeightTokens,\n  TypographyTokens,\n  SpacingTokens,\n  DurationTokens,\n  EasingTokens,\n  MotionTokens,\n  ContainerTokens,\n  LayoutTokens,\n  RadiusTokens,\n  ShadowTokens,\n  ZIndexTokens,\n  BorderWidthTokens,\n  DesignTokens,\n} from './types.js';\n\nimport type { DesignTokens } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Colors\n// ---------------------------------------------------------------------------\n\nconst colorsImpl = {\n  // Base neutrals\n  black: '#000000',\n  white: '#FFFFFF',\n  gray: {\n    100: '#F5F5F5',\n    300: '#D4D4D4',\n    500: '#737373',\n    700: '#404040',\n    900: '#171717',\n  },\n\n  // Dark mode semantic surfaces\n  background: '#0A0A0A',\n  surface: '#1A1A1A',\n  foreground: '#FFFFFF',\n  muted: '#2A2A2A',\n  border: '#333333',\n\n  // Accent / status\n  primary: '#0066FF',\n  secondary: '#00CC88',\n  success: '#00DD77',\n  error: '#FF3333',\n  warning: '#FFAA00',\n} as const satisfies DesignTokens['colors'];\n\n// ---------------------------------------------------------------------------\n// Typography\n// ---------------------------------------------------------------------------\n\nconst typographyImpl = {\n  fontFamily: {\n    sans: 'Power Grotesk, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n    mono: 'JetBrains Mono, \"Fira Code\", monospace',\n    display: 'Power Grotesk, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif',\n  },\n\n  scale: {\n    hero:  { size: '4rem',     lineHeight: '1.125', weight: 700 },  // 64px\n    h1:    { size: '3rem',     lineHeight: '1.167', weight: 700 },  // 48px\n    h2:    { size: '2rem',     lineHeight: '1.25',  weight: 600 },  // 32px\n    h3:    { size: '1.5rem',   lineHeight: '1.333', weight: 600 },  // 24px\n    body:  { size: '1rem',     lineHeight: '1.5',   weight: 400 },  // 16px\n    small: { size: '0.875rem', lineHeight: '1.429', weight: 400 },  // 14px\n    tiny:  { size: '0.75rem',  lineHeight: '1.333', weight: 400 },  // 12px\n  },\n\n  fontWeight: {\n    thin:     200,\n    light:    300,\n    regular:  400,\n    medium:   500,\n    semibold: 600,\n    bold:     700,\n    black:    900,\n  },\n} as const satisfies DesignTokens['typography'];\n\n// ---------------------------------------------------------------------------\n// Spacing — 8px base grid\n// ---------------------------------------------------------------------------\n\nconst spacingImpl = {\n  0:  '0',\n  1:  '4px',\n  2:  '8px',\n  3:  '12px',\n  4:  '16px',\n  5:  '20px',\n  6:  '24px',\n  7:  '28px',\n  8:  '32px',\n  9:  '36px',\n  10: '40px',\n  12: '48px',\n  14: '56px',\n  15: '60px',  // K-Universe 60px margin principle\n  16: '64px',\n  18: '72px',\n  20: '80px',\n  24: '96px',\n  32: '128px',\n} as const satisfies DesignTokens['spacing'];\n\n// ---------------------------------------------------------------------------\n// Motion\n// ---------------------------------------------------------------------------\n\nconst motionImpl = {\n  duration: {\n    instant: '100ms',\n    fast:    '200ms',\n    default: '300ms',\n    slow:    '500ms',\n    crawl:   '800ms',\n  },\n\n  easing: {\n    default:    'cubic-bezier(0.4, 0, 0.2, 1)',\n    smooth:     'cubic-bezier(0.25, 0.1, 0.25, 1)',\n    sharp:      'cubic-bezier(0.4, 0, 0.6, 1)',\n    accelerate: 'cubic-bezier(0.4, 0, 1, 1)',\n    decelerate: 'cubic-bezier(0, 0, 0.2, 1)',\n  },\n} as const satisfies DesignTokens['motion'];\n\n// ---------------------------------------------------------------------------\n// Layout\n// ---------------------------------------------------------------------------\n\nconst layoutImpl = {\n  margin:         '60px',   // primary horizontal landmark\n  sectionSpacing: '96px',\n  container: {\n    sm:  '640px',\n    md:  '768px',\n    lg:  '1024px',\n    xl:  '1280px',\n    max: '1320px',          // K-Universe max-width\n  },\n  measure: '65ch',\n} as const satisfies DesignTokens['layout'];\n\n// ---------------------------------------------------------------------------\n// Border radius\n// ---------------------------------------------------------------------------\n\nconst radiusImpl = {\n  none: '0',\n  xs:   '2px',\n  sm:   '4px',\n  md:   '6px',\n  lg:   '8px',\n  xl:   '12px',\n  '2xl': '16px',\n  '3xl': '24px',\n  round: '9999px',\n} as const satisfies DesignTokens['radius'];\n\n// ---------------------------------------------------------------------------\n// Shadows — neutral black only, no colored glow\n// ---------------------------------------------------------------------------\n\nconst shadowsImpl = {\n  xs:        '0 1px 2px 0 rgba(0, 0, 0, 0.05)',\n  sm:        '0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)',\n  md:        '0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)',\n  lg:        '0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)',\n  xl:        '0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)',\n  '2xl':     '0 25px 50px -12px rgba(0, 0, 0, 0.25)',\n  inner:     'inset 0 2px 4px 0 rgba(0, 0, 0, 0.05)',\n  cardHover: '0 20px 55px rgba(0, 0, 0, 0.55)',\n  elevated:  '0 24px 60px rgba(0, 0, 0, 0.45)',\n} as const satisfies DesignTokens['shadows'];\n\n// ---------------------------------------------------------------------------\n// Z-index\n// ---------------------------------------------------------------------------\n\nconst zIndexImpl = {\n  bg:       -1,\n  base:      0,\n  content:   10,\n  dropdown:  100,\n  sticky:    200,\n  overlay:   300,\n  modal:     400,\n  popover:   500,\n  tooltip:   600,\n  toast:     700,\n} as const satisfies DesignTokens['zIndex'];\n\n// ---------------------------------------------------------------------------\n// Border width\n// ---------------------------------------------------------------------------\n\nconst borderWidthImpl = {\n  thin:  '1px',\n  base:  '2px',\n  thick: '4px',\n} as const satisfies DesignTokens['borderWidth'];\n\n// ---------------------------------------------------------------------------\n// Root tokens object\n// ---------------------------------------------------------------------------\n\n/**\n * Primary design tokens export.\n *\n * @example\n * ```typescript\n * import { tokens } from \"@k-universe/design-tokens\";\n *\n * tokens.colors.background          // '#0A0A0A'\n * tokens.colors.foreground          // '#FFFFFF'\n * tokens.colors.secondary           // '#00CC88'\n * tokens.typography.fontFamily.sans // 'Power Grotesk, ...'\n * tokens.spacing[15]                // '60px'  — 60px margin principle\n * tokens.motion.duration.default    // '300ms'\n * ```\n */\nexport const tokens: DesignTokens = {\n  colors:      colorsImpl,\n  typography:  typographyImpl,\n  spacing:     spacingImpl,\n  motion:      motionImpl,\n  layout:      layoutImpl,\n  radius:      radiusImpl,\n  shadows:     shadowsImpl,\n  zIndex:      zIndexImpl,\n  borderWidth: borderWidthImpl,\n};\n\n// ---------------------------------------------------------------------------\n// Convenience shortcut exports\n// ---------------------------------------------------------------------------\n\n/** Alias for tokens — backwards compatibility. */\nexport const designTokens: DesignTokens = tokens;\n\n/** Shortcut: tokens.colors */\nexport const colors = tokens.colors;\n\n/** Shortcut: tokens.typography */\nexport const typography = tokens.typography;\n\n/** Shortcut: tokens.spacing */\nexport const spacing = tokens.spacing;\n\n/** Shortcut: tokens.motion */\nexport const motion = tokens.motion;\n\n/** Shortcut: tokens.layout */\nexport const layout = tokens.layout;\n\n/** Shortcut: tokens.radius */\nexport const radius = tokens.radius;\n\n/** Shortcut: tokens.shadows */\nexport const shadows = tokens.shadows;\n\n/** Shortcut: tokens.zIndex */\nexport const zIndex = tokens.zIndex;\n\n/** Shortcut: tokens.borderWidth */\nexport const borderWidth = tokens.borderWidth;\n\n// ---------------------------------------------------------------------------\n// Utility: mergeTokens\n// ---------------------------------------------------------------------------\n\ntype DeepPartial<T> = {\n  [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];\n};\n\n/**\n * Deep-merges override tokens into a base token set.\n * Returns a new object — does not mutate the base.\n *\n * @example\n * ```typescript\n * import { tokens, mergeTokens } from \"@k-universe/design-tokens\";\n *\n * const theme = mergeTokens(tokens, {\n *   colors: { primary: '#FF6600' },\n * });\n * ```\n */\nexport function mergeTokens(\n  base: DesignTokens,\n  overrides: DeepPartial<DesignTokens>,\n): DesignTokens {\n  return deepMerge(base, overrides) as DesignTokens;\n}\n\nfunction deepMerge<T extends object>(target: T, source: DeepPartial<T>): T {\n  const result: T = { ...target };\n\n  for (const key in source) {\n    if (!Object.prototype.hasOwnProperty.call(source, key)) continue;\n\n    const sourceVal = source[key as keyof typeof source];\n    const targetVal = target[key as keyof T];\n\n    if (\n      sourceVal !== null &&\n      typeof sourceVal === 'object' &&\n      !Array.isArray(sourceVal) &&\n      targetVal !== null &&\n      typeof targetVal === 'object' &&\n      !Array.isArray(targetVal)\n    ) {\n      (result as Record<string, unknown>)[key] = deepMerge(\n        targetVal as object,\n        sourceVal as DeepPartial<typeof targetVal>,\n      );\n    } else if (sourceVal !== undefined) {\n      (result as Record<string, unknown>)[key] = sourceVal;\n    }\n  }\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Utility: getTokenByPath\n// ---------------------------------------------------------------------------\n\n/**\n * Retrieves a token value using dot-notation path access.\n *\n * @param obj  - The token object to traverse (typically `tokens`).\n * @param path - Dot-notation path string, e.g. `'colors.primary'`.\n * @returns The value at the given path, or `undefined` if not found.\n *\n * @example\n * ```typescript\n * import { tokens, getTokenByPath } from \"@k-universe/design-tokens\";\n *\n * getTokenByPath(tokens, 'colors.primary')          // '#0066FF'\n * getTokenByPath(tokens, 'motion.duration.default') // '300ms'\n * getTokenByPath(tokens, 'spacing.15')              // '60px'\n * ```\n */\nexport function getTokenByPath(\n  obj: unknown,\n  path: string,\n): unknown {\n  if (!path) return obj;\n\n  const segments = path.split('.');\n  let current: unknown = obj;\n\n  for (const segment of segments) {\n    if (current === null || current === undefined) return undefined;\n    if (typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n"],"mappings":"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","names":[]}