lumina-slides 8.9.4 → 9.0.0

package/src/style/main.css

@@ -0,0 +1,462 @@
+@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@100..900&family=Inter:wght@100..900&display=swap');
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* ============================================================================
+   LUMINA ENGINE - BASE STYLES & CSS CUSTOM PROPERTIES
+   Modern, Refined, Dynamic Design System v9
+   ============================================================================ */
+
+:root {
+  /* === COLORS === */
+  --lumina-color-primary: #3b82f6;
+  --lumina-color-secondary: #8b5cf6;
+  --lumina-color-accent: #06b6d4;
+  --lumina-color-background: #030303;
+  --lumina-color-surface: #0a0a0a;
+  --lumina-color-text: #ffffff;
+  --lumina-color-text-secondary: #e5e7eb;
+  --lumina-color-muted: #9ca3af;
+  --lumina-color-success: #10b981;
+  --lumina-color-warning: #f59e0b;
+  --lumina-color-danger: #ef4444;
+  --lumina-color-info: #3b82f6;
+  --lumina-color-border: rgba(255, 255, 255, 0.1);
+  --lumina-color-border-subtle: rgba(255, 255, 255, 0.05);
+  --lumina-color-shadow: #000000;
+  --lumina-color-overlay: rgba(0, 0, 0, 0.5);
+  --lumina-color-highlight: rgba(59, 130, 246, 0.2);
+  --lumina-color-gradient-from: #3b82f6;
+  --lumina-color-gradient-to: #8b5cf6;
+
+  /* RGB Values for alpha usage */
+  --lumina-color-primary-rgb: 59, 130, 246;
+  --lumina-color-secondary-rgb: 139, 92, 246;
+  --lumina-color-background-rgb: 3, 3, 3;
+  --lumina-color-text-rgb: 255, 255, 255;
+
+  /* === TYPOGRAPHY === */
+  --lumina-font-heading: 'Inter', system-ui, sans-serif;
+  --lumina-font-body: 'Inter', system-ui, sans-serif;
+  --lumina-font-mono: ui-monospace, SFMono-Regular, monospace;
+
+  --lumina-text-xs: 0.75rem;
+  --lumina-text-sm: 0.875rem;
+  --lumina-text-base: 1rem;
+  --lumina-text-lg: 1.125rem;
+  --lumina-text-xl: 1.25rem;
+  --lumina-text-2xl: 1.5rem;
+  --lumina-text-3xl: 1.875rem;
+  --lumina-text-4xl: 2.25rem;
+  --lumina-text-5xl: 3rem;
+  --lumina-text-6xl: 3.75rem;
+  --lumina-text-7xl: 4.5rem;
+
+  --lumina-font-weight-light: 300;
+  --lumina-font-weight-normal: 400;
+  --lumina-font-weight-medium: 500;
+  --lumina-font-weight-semibold: 600;
+  --lumina-font-weight-bold: 800;
+  --lumina-font-weight-extrabold: 900;
+
+  --lumina-leading-tight: 1.1;
+  --lumina-leading-snug: 1.25;
+  --lumina-leading-normal: 1.5;
+  --lumina-leading-relaxed: 1.625;
+  --lumina-leading-loose: 2;
+
+  --lumina-tracking-tighter: -0.05em;
+  --lumina-tracking-tight: -0.025em;
+  --lumina-tracking-normal: 0;
+  --lumina-tracking-wide: 0.025em;
+  --lumina-tracking-wider: 0.05em;
+  --lumina-tracking-widest: 0.1em;
+
+  /* === SPACING === */
+  --lumina-space-none: 0;
+  --lumina-space-xs: 0.25rem;
+  --lumina-space-sm: 0.5rem;
+  --lumina-space-md: 1rem;
+  --lumina-space-lg: 1.5rem;
+  --lumina-space-xl: 2rem;
+  --lumina-space-2xl: 3rem;
+  --lumina-space-3xl: 4rem;
+  --lumina-space-4xl: 6rem;
+
+  /* === BORDER RADIUS === */
+  --lumina-radius-none: 0;
+  --lumina-radius-sm: 0.25rem;
+  --lumina-radius-md: 0.5rem;
+  --lumina-radius-lg: 0.75rem;
+  --lumina-radius-xl: 1rem;
+  --lumina-radius-2xl: 1.5rem;
+  --lumina-radius-3xl: 2rem;
+  --lumina-radius-full: 9999px;
+
+  /* === MODERN SHADOWS (Layered for depth) === */
+  --lumina-shadow-sm: 
+    0 1px 2px rgba(0, 0, 0, 0.1);
+  --lumina-shadow-md: 
+    0 4px 6px -1px rgba(0, 0, 0, 0.15),
+    0 2px 4px -2px rgba(0, 0, 0, 0.1);
+  --lumina-shadow-lg: 
+    0 10px 15px -3px rgba(0, 0, 0, 0.2),
+    0 4px 6px -4px rgba(0, 0, 0, 0.1);
+  --lumina-shadow-xl: 
+    0 20px 25px -5px rgba(0, 0, 0, 0.25),
+    0 8px 10px -6px rgba(0, 0, 0, 0.1);
+  --lumina-shadow-2xl: 
+    0 25px 50px -12px rgba(0, 0, 0, 0.4);
+  --lumina-shadow-glow: 
+    0 0 40px rgba(var(--lumina-color-primary-rgb), 0.3);
+  --lumina-shadow-inner-glow:
+    inset 0 1px 0 rgba(255, 255, 255, 0.1),
+    inset 0 -1px 0 rgba(0, 0, 0, 0.1);
+
+  /* === EFFECTS === */
+  --lumina-use-gradients: 1;
+  --lumina-use-shadows: 1;
+  --lumina-use-glass: 1;
+  --lumina-use-orb: 1;
+  --lumina-use-animations: 1;
+
+  --lumina-gradient-direction: to bottom;
+  --lumina-shadow-intensity: md;
+  --lumina-shadow-color: rgba(0, 0, 0, 0.4);
+
+  --lumina-glass-opacity: 0.08;
+  --lumina-glass-blur: 24px;
+  --lumina-glass-border-opacity: 0.1;
+
+  --lumina-orb-opacity: 0.20;
+  --lumina-orb-blur: 120px;
+  --lumina-orb-size: 80vw;
+
+  --lumina-transition-duration: 0.3s;
+  --lumina-transition-easing: cubic-bezier(0.16, 1, 0.3, 1);
+  /* Apply flags to values */
+  --lumina-orb-opacity-effective: calc(var(--lumina-orb-opacity) * var(--lumina-use-orb));
+  --lumina-glass-opacity-effective: calc(var(--lumina-glass-opacity) * var(--lumina-use-glass));
+  --lumina-glass-line-opacity-effective: calc(var(--lumina-glass-border-opacity) * var(--lumina-use-glass));
+  --lumina-glass-blur-effective: calc(var(--lumina-glass-blur) * var(--lumina-use-glass));
+  --lumina-duration-effective: calc(var(--lumina-transition-duration) * var(--lumina-use-animations));
+
+  /* Gradient Text Control */
+  --lumina-gradient-text-fill: transparent;
+  --lumina-gradient-bg-clip: text;
+
+
+  /* === COMPONENTS === */
+  --lumina-button-radius: 9999px;
+  --lumina-button-padding: 0.875rem 1.75rem;
+  --lumina-button-font-weight: 600;
+
+  --lumina-card-radius: 1.25rem;
+  --lumina-card-padding: 1.75rem;
+  --lumina-card-border-width: 1px;
+
+  --lumina-timeline-node-size: 0.875rem;
+  --lumina-timeline-line-width: 2px;
+
+  --lumina-tag-padding: 0.375rem 1rem;
+  --lumina-tag-radius: 9999px;
+  --lumina-tag-font-size: 0.75rem;
+
+  /* Legacy compat */
+  --lumina-bg: var(--lumina-color-background);
+  --lumina-colors-primary: var(--lumina-color-primary);
+  --lumina-colors-background: var(--lumina-color-background);
+  --lumina-colors-text: var(--lumina-color-text);
+  --lumina-colors-muted: var(--lumina-color-muted);
+
+  --ease-expo: var(--lumina-transition-easing);
+
+  --lumina-safe-area-bottom: 0px;
+}
+
+/* === RESPONSIVE TYPOGRAPHY === */
+@media (max-width: 1023px) {
+  :root {
+    /* Aggressive size reduction for mobile */
+    --lumina-text-3xl: 1.25rem;   /* 20px */
+    --lumina-text-4xl: 1.5rem;    /* 24px */
+    --lumina-text-5xl: 1.75rem;   /* 28px */
+    --lumina-text-6xl: 2rem;      /* 32px - effectively smaller than original clamp */
+    --lumina-text-7xl: 2.5rem;    /* 40px */
+
+    /* Tighter spacing for "compressed" look */
+    --lumina-space-md: 0.75rem;
+    --lumina-space-lg: 1rem;
+    --lumina-space-xl: 1.5rem;
+    --lumina-space-2xl: 2rem;
+    --lumina-space-3xl: 2.5rem;
+
+    --lumina-leading-tight: 1.1;
+    --lumina-tracking-tighter: -0.05em;
+
+    /* Mobile Navigation Safe Area */
+    --lumina-safe-area-bottom: 6rem;
+  }
+}
+
+@media (max-width: 639px) {
+  :root {
+    /* Even smaller sizes for phones */
+    --lumina-text-3xl: 1rem !important;      /* 16px */
+    --lumina-text-4xl: 1.5rem !important;  /* 18px */
+    --lumina-text-5xl: 2rem !important;   /* 20px */
+    --lumina-text-6xl: 2.5rem !important;    /* 24px */
+    --lumina-text-7xl: 3rem !important;   /* 28px */
+    
+    --lumina-space-md: 0.5rem;
+    --lumina-space-lg: 0.75rem;
+    --lumina-space-xl: 1rem;
+  }
+}
+
+/* === BASE STYLES === */
+body {
+  background-color: var(--lumina-color-background);
+  color: var(--lumina-color-text);
+  font-family: var(--lumina-font-body);
+  overflow-x: hidden;
+  overflow-y: auto;
+  margin: 0;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* === ENHANCED GLASS PANEL === */
+.glass-panel {
+  background: linear-gradient(
+    135deg,
+    rgba(var(--lumina-color-text-rgb), calc(var(--lumina-glass-opacity-effective) * 1.5)) 0%,
+    rgba(var(--lumina-color-text-rgb), var(--lumina-glass-opacity-effective)) 100%
+  );
+  backdrop-filter: blur(var(--lumina-glass-blur-effective));
+  -webkit-backdrop-filter: blur(var(--lumina-glass-blur-effective));
+  border: var(--lumina-card-border-width) solid rgba(var(--lumina-color-text-rgb), var(--lumina-glass-line-opacity-effective));
+  box-shadow: 
+    var(--lumina-shadow-lg),
+    inset 0 1px 0 rgba(255, 255, 255, 0.08);
+  transition: all var(--lumina-duration-effective) var(--lumina-transition-easing);
+}
+
+.glass-panel:hover {
+  transform: translateY(-2px);
+  box-shadow: 
+    var(--lumina-shadow-xl),
+    inset 0 1px 0 rgba(255, 255, 255, 0.12);
+  border-color: rgba(var(--lumina-color-text-rgb), calc(var(--lumina-glass-line-opacity-effective) + 0.05));
+}
+
+/* === SCROLLBAR === */
+::-webkit-scrollbar { width: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { 
+  background: rgba(var(--lumina-color-text-rgb), 0.15); 
+  border-radius: 10px; 
+}
+::-webkit-scrollbar-thumb:hover {
+  background: rgba(var(--lumina-color-text-rgb), 0.25);
+}
+
+/* === AMBIENT ORB === */
+.ambient-orb {
+  position: absolute;
+  border-radius: 50%;
+  filter: blur(var(--lumina-orb-blur));
+  opacity: var(--lumina-orb-opacity-effective);
+  transition: all 2s var(--lumina-transition-easing);
+  z-index: 0;
+  pointer-events: none;
+}
+
+/* === TIMELINE SCROLL MASK === */
+.timeline-scroll {
+  mask-image: linear-gradient(to right, transparent, black 5%, black 95%, transparent);
+}
+
+/* === TRANSITIONS === */
+.slide-fade-enter-active {
+  transition: all 0.5s var(--lumina-transition-easing);
+}
+
+.slide-fade-leave-active {
+  transition: all 0.3s ease-out;
+}
+
+.slide-fade-enter-from,
+.slide-fade-leave-to {
+  transform: translateX(20px);
+  opacity: 0;
+}
+
+.fade-enter-active,
+.fade-leave-active {
+  transition: opacity var(--lumina-transition-duration) ease;
+}
+
+.fade-enter-from,
+.fade-leave-to {
+  opacity: 0;
+}
+
+/* === MICRO-ANIMATIONS === */
+@keyframes pulse-glow {
+  0%, 100% { 
+    box-shadow: 0 0 20px rgba(var(--lumina-color-primary-rgb), 0.4); 
+  }
+  50% { 
+    box-shadow: 0 0 35px rgba(var(--lumina-color-primary-rgb), 0.6); 
+  }
+}
+
+@keyframes float {
+  0%, 100% { transform: translateY(0); }
+  50% { transform: translateY(-6px); }
+}
+
+@keyframes shimmer {
+  0% { background-position: -200% center; }
+  100% { background-position: 200% center; }
+}
+
+.animate-pulse-glow {
+  animation: pulse-glow 2s ease-in-out infinite;
+}
+
+.animate-float {
+  animation: float 3s ease-in-out infinite;
+}
+
+/* === UTILITY CLASSES === */
+
+/* Typography */
+.font-heading { 
+  font-family: var(--lumina-font-heading); 
+  font-weight: var(--lumina-font-weight-extrabold, 900);
+}
+.font-body { font-family: var(--lumina-font-body); }
+.font-mono { font-family: var(--lumina-font-mono); }
+
+/* Colors */
+.text-primary { color: var(--lumina-color-primary); }
+.text-secondary { color: var(--lumina-color-secondary); }
+.text-muted { color: var(--lumina-color-muted); }
+.bg-primary { background-color: var(--lumina-color-primary); }
+.bg-surface { background-color: var(--lumina-color-surface); }
+.border-theme { border-color: var(--lumina-color-border); }
+
+/* Gradient text */
+.text-gradient {
+  background: linear-gradient(
+    var(--lumina-gradient-direction),
+    var(--lumina-color-gradient-from),
+    var(--lumina-color-gradient-to)
+  );
+  -webkit-background-clip: var(--lumina-gradient-bg-clip);
+  -webkit-text-fill-color: var(--lumina-gradient-text-fill);
+  background-clip: var(--lumina-gradient-bg-clip);
+}
+
+/* Gradient background */
+.bg-gradient-theme {
+  background: linear-gradient(
+    var(--lumina-gradient-direction),
+    var(--lumina-color-gradient-from),
+    var(--lumina-color-gradient-to)
+  );
+}
+
+/* Modern button styles */
+.btn-primary {
+  background: linear-gradient(
+    135deg,
+    var(--lumina-color-primary) 0%,
+    var(--lumina-color-secondary) 100%
+  );
+  color: white;
+  padding: var(--lumina-button-padding);
+  border-radius: var(--lumina-button-radius);
+  font-weight: var(--lumina-button-font-weight);
+  border: none;
+  cursor: pointer;
+  transition: all var(--lumina-duration-effective) var(--lumina-transition-easing);
+  box-shadow: var(--lumina-shadow-md);
+}
+
+.btn-primary:hover {
+  transform: translateY(-2px) scale(1.02);
+  box-shadow: 
+    var(--lumina-shadow-lg),
+    0 0 30px rgba(var(--lumina-color-primary-rgb), 0.4);
+}
+
+/* Shadow utilities */
+.shadow-soft { box-shadow: var(--lumina-shadow-md); }
+.shadow-elevated { box-shadow: var(--lumina-shadow-xl); }
+.shadow-glow { box-shadow: var(--lumina-shadow-glow); }
+
+/* Interactive card hover */
+.card-interactive {
+  transition: all var(--lumina-duration-effective) var(--lumina-transition-easing);
+}
+
+.card-interactive:hover {
+  transform: translateY(-4px);
+  box-shadow: var(--lumina-shadow-xl);
+}
+
+/* Icon container with glow */
+.icon-glow {
+  position: relative;
+}
+
+.icon-glow::after {
+  content: '';
+  position: absolute;
+  inset: -4px;
+  border-radius: inherit;
+  background: radial-gradient(
+    circle,
+    rgba(var(--lumina-color-primary-rgb), 0.3) 0%,
+    transparent 70%
+  );
+  opacity: 0;
+  transition: opacity var(--lumina-transition-duration) ease;
+}
+
+.icon-glow:hover::after {
+  opacity: 1;
+}
+
+
+/* === DECK VIEWPORT (mobile: avoid container > 100vh, 100dvh when supported) === */
+.lumina-deck-root {
+  height: 100vh;
+  overflow: hidden;
+}
+@supports (height: 100dvh) {
+  .lumina-deck-root {
+    height: 100dvh;
+    max-height: 100dvh;
+  }
+}
+
+/* === ANIMATION FOUC PREVENTION === */
+/* Hide elements that are explicitly expected to be revealed by GSAP.
+   Scoped to current slide content only. */
+.reveal-up, 
+.reveal-zoom, 
+.reveal-card, 
+.reveal-left, 
+.reveal-right,
+.reveal-img,
+.reveal-char,
+.reveal-child,
+[data-split-text] {
+    opacity: 0;
+}

package/src/utils/deep.ts

@@ -0,0 +1,127 @@
+/**
+ * LUMINA DEEP UTILS
+ * Provides immutable operations for complex nested data structures.
+ * 
+ * Design Principles:
+ * 1. Immutability: All operations return a NEW object reference for the modified branch.
+ * 2. Safety: Path traversal checks for existence.
+ * 3. Performance: Structural sharing is preserved for unchanged branches.
+ */
+
+/**
+ * Retrieves a value from a nested object using dot notation.
+ * @param obj - The source object.
+ * @param path - Dot-separated path (e.g., "slides.0.elements.1").
+ * @returns The value at path or undefined.
+ */
+export function getByPath(obj: any, path: string): any {
+    if (!obj || !path) return undefined;
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) return undefined;
+        current = current[part];
+    }
+    return current;
+}
+
+/**
+ * Sets a value deep in a nested object, returning a new object (immutable).
+ * Handles array updates efficiently.
+ * 
+ * @param obj - The source object.
+ * @param path - Dot-separated path.
+ * @param value - The new value to set.
+ * @returns A new object with the updated value.
+ */
+export function setByPath(obj: any, path: string, value: any): any {
+    if (!obj) return obj;
+    if (!path) return value; // Root replacement logic could go here, but usually assume obj is root.
+
+    const parts = path.split('.');
+    const head = parts[0];
+    const tail = parts.slice(1).join('.');
+
+    // Handle Array
+    if (Array.isArray(obj)) {
+        const index = parseInt(head, 10);
+        if (isNaN(index)) return obj; // Invalid array usage
+
+        const newArray = [...obj];
+        if (parts.length === 1) {
+            newArray[index] = value;
+        } else {
+            newArray[index] = setByPath(obj[index], tail, value);
+        }
+        return newArray;
+    }
+
+    // Handle Object
+    const newObj = { ...obj };
+    if (parts.length === 1) {
+        newObj[head] = value;
+    } else {
+        newObj[head] = setByPath(obj[head] || {}, tail, value);
+    }
+    return newObj;
+}
+
+/**
+ * Inserts an item into an array at a specific deep path.
+ * 
+ * @param obj - The root object.
+ * @param arrayPath - Path to the array itself (e.g., "slides.0.elements").
+ * @param index - Index to insert at.
+ * @param item - The item to insert.
+ * @returns New root object.
+ */
+export function insertByPath(obj: any, arrayPath: string, index: number, item: any): any {
+    const targetArray = getByPath(obj, arrayPath);
+    if (!Array.isArray(targetArray)) {
+        console.warn(`[Lumina Deep] Insert failed: Target at '${arrayPath}' is not an array.`);
+        return obj;
+    }
+
+    const newArray = [...targetArray];
+    newArray.splice(index, 0, item);
+    return setByPath(obj, arrayPath, newArray);
+}
+
+/**
+ * Removes an item from an array at a specific deep path.
+ * 
+ * @param obj - The root object.
+ * @param arrayPath - Path to the array.
+ * @param index - Index to remove.
+ * @returns New root object.
+ */
+export function removeByPath(obj: any, arrayPath: string, index: number): any {
+    const targetArray = getByPath(obj, arrayPath);
+    if (!Array.isArray(targetArray)) {
+        console.warn(`[Lumina Deep] Remove failed: Target at '${arrayPath}' is not an array.`);
+        return obj;
+    }
+
+    const newArray = [...targetArray];
+    newArray.splice(index, 1);
+    return setByPath(obj, arrayPath, newArray);
+}
+
+/**
+ * Moves an item within a specific array (reordering).
+ * 
+ * @param obj - Root object
+ * @param arrayPath - Path to the array
+ * @param fromIndex - Source index
+ * @param toIndex - Destination index
+ */
+export function moveByPath(obj: any, arrayPath: string, fromIndex: number, toIndex: number): any {
+    const targetArray = getByPath(obj, arrayPath);
+    if (!Array.isArray(targetArray)) return obj;
+
+    const newArray = [...targetArray];
+    const [movedItem] = newArray.splice(fromIndex, 1);
+    newArray.splice(toIndex, 0, movedItem);
+
+    return setByPath(obj, arrayPath, newArray);
+}