@mhmo91/schmancy 0.10.41 → 0.10.43

package/dist/agent/schmancy.manifest.json

@@ -230,7 +230,7 @@
                 "surface"
               ],
               "default": "'primary'",
-              "description": "The color variant of the badge"
+              "description": "The semantic color of the badge."
             },
             {
               "name": "size",
@@ -240,11 +240,10 @@
               "values": [
                 "xs",
                 "sm",
-                "md",
-                "lg"
+                "md"
               ],
               "default": "'md'",
-              "description": "The size of the badge"
+              "description": "The size of the badge."
             },
             {
               "name": "shape",
@@ -252,12 +251,11 @@
                 "text": "BadgeShape"
               },
               "values": [
-                "square",
-                "rounded",
-                "pill"
+                "pill",
+                "rounded"
               ],
               "default": "'pill'",
-              "description": "The shape of the badge"
+              "description": "The corner shape of the badge."
             },
             {
               "name": "outlined",
@@ -265,33 +263,13 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the badge has an outlined style"
-            },
-            {
-              "name": "icon",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Custom icon name to display (if no icon slot is provided)"
-            },
-            {
-              "name": "pulse",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether to make the badge pulse to draw attention"
+              "description": "Outlined style: transparent fill, the color's strong tone for text and border."
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "The content of the badge (text or HTML)"
-            },
-            {
-              "name": "icon",
-              "description": "Optional icon to display before the content"
+              "description": "The content of the badge (text or short HTML)"
             }
           ],
           "cssParts": [
@@ -302,10 +280,6 @@
             {
               "name": "content",
               "description": "The content container"
-            },
-            {
-              "name": "icon",
-              "description": "The icon container"
             }
           ]
         },
@@ -722,6 +696,163 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "calendar/calendar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "SchmancyCalendar",
+          "tagName": "schmancy-calendar",
+          "description": "A presentational calendar primitive with continuous vertical month-scroll. Supports single-date and date-range selection. No form-association.",
+          "attributes": [
+            {
+              "name": "mode",
+              "type": {
+                "text": "\"single\" | \"range\""
+              },
+              "values": [
+                "single",
+                "range"
+              ],
+              "default": "'single'"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "\"date\" | \"datetime-local\""
+              },
+              "values": [
+                "date",
+                "datetime-local"
+              ],
+              "default": "'date'"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "start",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "end",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "min",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "max",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "month",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "description": "BCP-47 locale tag; week-start derived from it. Stored as `calLocale` to avoid conflicting with the base-class `locale` getter."
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            }
+          ],
+          "events": [
+            {
+              "name": "input",
+              "description": "Every provisional change (incl. range hover-preview)"
+            },
+            {
+              "name": "change",
+              "description": "Committed change: single click | second range endpoint | clear"
+            },
+            {
+              "name": "navigate",
+              "description": "Dominant in-view month changed while scrolling"
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "scroll",
+              "description": "The scrollable container"
+            },
+            {
+              "name": "month-label",
+              "description": "Sticky month/year label"
+            },
+            {
+              "name": "weekday",
+              "description": "Weekday header cell"
+            },
+            {
+              "name": "grid",
+              "description": "Day grid for a month"
+            },
+            {
+              "name": "day",
+              "description": "Individual day cell"
+            },
+            {
+              "name": "day-selected",
+              "description": "A selected day (single mode, or both endpoints)"
+            },
+            {
+              "name": "day-range-start",
+              "description": "Range start day"
+            },
+            {
+              "name": "day-range-end",
+              "description": "Range end day"
+            },
+            {
+              "name": "day-in-range",
+              "description": "Day inside the selected range (exclusive of endpoints)"
+            },
+            {
+              "name": "day-preview",
+              "description": "Day inside the hover-preview range"
+            },
+            {
+              "name": "day-today",
+              "description": "Today's date"
+            },
+            {
+              "name": "day-disabled",
+              "description": "Disabled (out-of-bounds) day"
+            }
+          ]
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "card/actions.ts",
@@ -1046,7 +1177,7 @@
           "kind": "class",
           "name": "SchmancyDateRangeInline",
           "tagName": "schmancy-date-range-inline",
-          "description": "Smart inline date range picker that handles all the heavy lifting.\r Auto-corrects invalid ranges, provides smart defaults, and validates dates.",
+          "description": "Smart inline date range picker that handles all the heavy lifting. Auto-corrects invalid ranges, provides smart defaults, and validates dates.",
           "attributes": [
             {
               "name": "type",
@@ -1452,11 +1583,6 @@
                 "surface",
                 "outlined",
                 "info",
-                "solid",
-                "subtle",
-                "glass",
-                "luminous",
-                "transparent",
                 "surfaceDim",
                 "surfaceBright",
                 "containerLowest",
@@ -1464,9 +1590,9 @@
                 "container",
                 "containerHigh",
                 "containerHighest",
-                "glassOforim"
+                "transparent"
               ],
-              "default": "'solid'"
+              "default": "'containerLowest'"
             }
           ]
         }
@@ -1886,11 +2012,6 @@
                 "surface",
                 "outlined",
                 "info",
-                "solid",
-                "subtle",
-                "glass",
-                "luminous",
-                "transparent",
                 "surfaceDim",
                 "surfaceBright",
                 "containerLowest",
@@ -1898,7 +2019,7 @@
                 "container",
                 "containerHigh",
                 "containerHighest",
-                "glassOforim"
+                "transparent"
               ]
             },
             {
@@ -1969,11 +2090,6 @@
                 "surface",
                 "outlined",
                 "info",
-                "solid",
-                "subtle",
-                "glass",
-                "luminous",
-                "transparent",
                 "surfaceDim",
                 "surfaceBright",
                 "containerLowest",
@@ -1981,7 +2097,7 @@
                 "container",
                 "containerHigh",
                 "containerHighest",
-                "glassOforim"
+                "transparent"
               ],
               "description": "Defines the type or color of the surface used by the component. This value is provided to descendant components via context."
             },
@@ -3294,7 +3410,7 @@
           "kind": "class",
           "name": "SchmancySurface",
           "tagName": "schmancy-surface",
-          "description": "`<schmancy-surface>` component  Styled container that supports rounding, elevation, and background/text color variants. Sizing is the consumer's responsibility — use Tailwind utilities (`class=\"w-full h-full\"`) on the element directly.  SurfaceMixin automatically provides surfaceStyles CSS.",
+          "description": "`<schmancy-surface>` component  Color-variant container that paints a background and establishes the inherited text color for descendants. Corner radius, shadow depth, and cursor behavior are the consumer's responsibility — apply stock Tailwind classes directly on the element.  Sizing is the consumer's responsibility — use Tailwind utilities (`class=\"w-full h-full\"`) on the element directly.",
           "attributes": [
             {
               "name": "type",
@@ -3311,11 +3427,6 @@
                 "surface",
                 "outlined",
                 "info",
-                "solid",
-                "subtle",
-                "glass",
-                "luminous",
-                "transparent",
                 "surfaceDim",
                 "surfaceBright",
                 "containerLowest",
@@ -3323,9 +3434,9 @@
                 "container",
                 "containerHigh",
                 "containerHighest",
-                "glassOforim"
+                "transparent"
               ],
-              "default": "'subtle'",
+              "default": "'containerLow'",
               "description": "Specifies the surface type for styling. Provided to descendant components via context."
             }
           ],
@@ -3336,7 +3447,7 @@
             }
           ],
           "examples": [
-            "<schmancy-surface class=\"w-full h-full\" rounded=\"all\" elevation=\"3\" type=\"surfaceBright\" scroller>\n  <p>Your scrollable content here</p>\n</schmancy-surface>"
+            "<schmancy-surface type=\"surfaceBright\" class=\"rounded-2xl shadow-lg w-full\">\n  <p>Content here</p>\n</schmancy-surface>"
           ],
           "contexts": [
             {
@@ -4408,7 +4519,7 @@
           "kind": "class",
           "name": "SchmancyDateRangeDialog",
           "tagName": "schmancy-date-range-dialog",
-          "description": "Dialog content component for date range selection  Redesigned with chip-based horizontal flow layout: - Quick Select: Today, Yesterday, This Week, This Month - Days: Last 7/14/30/60/90 Days - Periods: Last Week, Last Month, Last Quarter, Last Year - Year to Date: This Week, This Month, This Quarter, This Year, YTD - Custom Range: Manual date inputs at the bottom",
+          "description": "Picker panel for `<schmancy-date-range>`.  Layout: sticky chip quick-rail → continuous-scroll calendar → secondary typed path. Emits composed events that `<schmancy-date-range>` bridges into its own `input`/`change` events.",
           "attributes": [
             {
               "name": "type",
@@ -4422,45 +4533,59 @@
               "default": "'date'"
             },
             {
-              "name": "dateFrom",
+              "name": "start",
               "type": {
-                "text": "{ label: string; value: string; }"
+                "text": "string"
               },
-              "default": "{ label: 'From', value: '' }"
+              "default": "null"
             },
             {
-              "name": "dateTo",
+              "name": "end",
               "type": {
-                "text": "{ label: string; value: string; }"
+                "text": "string"
               },
-              "default": "{ label: 'To', value: '' }"
+              "default": "null"
             },
             {
-              "name": "minDate",
+              "name": "min",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "maxDate",
+              "name": "max",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "activePreset",
+              "name": "preset",
               "type": {
                 "text": "string"
               },
               "default": "null"
             },
             {
-              "name": "presetCategories",
+              "name": "presets",
               "type": {
-                "text": "PresetCategory[]"
+                "text": "DateRangeDialogPreset[]"
               },
               "default": "[]"
             }
+          ],
+          "events": [
+            {
+              "name": "calendar-input",
+              "description": "Provisional sweep from the calendar { start, end }"
+            },
+            {
+              "name": "calendar-change",
+              "description": "Committed endpoint from the calendar { start, end }"
+            },
+            {
+              "name": "preset-select",
+              "description": "A chip was clicked { id, label, start, end }"
+            }
           ]
         }
       ]
@@ -4473,7 +4598,7 @@
           "kind": "class",
           "name": "SchmancyDateRange",
           "tagName": "schmancy-date-range",
-          "description": "A date range selector that supports presets and manual date input.",
+          "description": "A date range selector composing `<schmancy-calendar mode=\"range\">` with a sticky preset chip quick-rail and a secondary typed-entry path.  Public API: flat ISO `start`/`end`, `preset` read-back, `presets` array. FormData: `${name}.start` / `${name}.end` (empty endpoint omitted).",
           "attributes": [
             {
               "name": "type",
@@ -4487,40 +4612,42 @@
               "default": "'date'"
             },
             {
-              "name": "dateFrom",
+              "name": "start",
               "type": {
-                "text": "{ label: string; value: string; }"
+                "text": "string"
               },
-              "default": "{ label: 'From', value: '' }"
+              "default": "null"
             },
             {
-              "name": "dateTo",
+              "name": "end",
               "type": {
-                "text": "{ label: string; value: string; }"
+                "text": "string"
               },
-              "default": "{ label: 'To', value: '' }"
+              "default": "null"
             },
             {
-              "name": "minDate",
+              "name": "presets",
               "type": {
-                "text": "string"
-              }
+                "text": "DateRangeDialogPreset[]"
+              },
+              "default": "buildDefaultPresets()"
             },
             {
-              "name": "maxDate",
+              "name": "preset",
               "type": {
                 "text": "string"
-              }
+              },
+              "default": "null",
+              "description": "Selected preset id; null = custom range. Reflects to attribute."
             },
             {
-              "name": "customPresets",
+              "name": "min",
               "type": {
-                "text": "{ label: string; dateFrom: string; dateTo: string; }[]"
-              },
-              "default": "[]"
+                "text": "string"
+              }
             },
             {
-              "name": "format",
+              "name": "max",
               "type": {
                 "text": "string"
               }
@@ -4551,13 +4678,17 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, collapses to just an icon button on mobile screens"
+              "description": "Collapses to an icon-only button on narrow viewports."
             }
           ],
           "events": [
+            {
+              "name": "input",
+              "description": "Provisional sweep preview { start, end }"
+            },
             {
               "name": "change",
-              "description": "Fired when the date range changes with dateFrom and dateTo values"
+              "description": "Committed range change { start, end, preset }"
             }
           ]
         }

package/dist/animation-CCOIW4wJ.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"animation-CCOIW4wJ.cjs","names":[],"sources":["../src/utils/animation.ts"],"sourcesContent":["/**\n * Blackbird Animation System\n *\n * A comprehensive animation system using spring physics for natural,\n * organic motion. Named after the smooth, arcing flight patterns of birds.\n *\n * Features:\n * - Spring physics via CSS linear() (88% browser support)\n * - Cubic-bezier fallbacks for older browsers\n * - Typed interfaces for Web Animations API\n * - CSS custom properties for Tailwind integration\n * - Multiple presets: smooth, snappy, bouncy\n *\n * @see https://www.joshwcomeau.com/animation/linear-timing-function/\n * @see https://developer.chrome.com/docs/css-ui/css-linear-easing-function\n */\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/** Spring configuration parameters */\nexport interface SpringConfig {\n\t/** Spring stiffness (higher = faster) */\n\tstiffness: number\n\t/** Damping ratio (higher = less bounce) */\n\tdamping: number\n\t/** Mass (higher = slower) */\n\tmass: number\n}\n\n/** Animation preset with all timing values */\nexport interface AnimationPreset {\n\t/** Human-readable name */\n\tname: string\n\t/** Duration in milliseconds */\n\tduration: number\n\t/** CSS linear() easing function (modern browsers) */\n\teasing: string\n\t/** Cubic-bezier fallback (all browsers) */\n\teasingFallback: string\n\t/** Spring configuration used to generate this preset */\n\tspring: SpringConfig\n}\n\n/** Keyframe options for Web Animations API */\nexport interface BlackbirdKeyframes {\n\t/** Starting state */\n\tfrom: Keyframe\n\t/** Ending state */\n\tto: Keyframe\n}\n\n/** Complete animation configuration */\nexport interface BlackbirdAnimation {\n\tkeyframes: Keyframe[]\n\toptions: KeyframeAnimationOptions\n}\n\n// =============================================================================\n// SPRING PRESETS\n// =============================================================================\n\n/**\n * Smooth preset - Apple-style, subtle overshoot\n * Best for: Details, accordions, content reveals\n */\nexport const SPRING_SMOOTH: AnimationPreset = {\n\tname: 'smooth',\n\tduration: 500,\n\teasing: `linear(\n\t\t0, 0.006, 0.025 2.8%, 0.101 6.1%, 0.539 18.9%, 0.721 25.3%, 0.849 31.5%,\n\t\t0.937 38.1%, 0.968 41.8%, 0.991 45.7%, 1.006 50%, 1.015 54.8%,\n\t\t1.017 63.3%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n\tspring: { stiffness: 100, damping: 15, mass: 1 },\n}\n\n/**\n * Snappy preset - Quick with minimal overshoot\n * Best for: Buttons, toggles, quick interactions\n */\nexport const SPRING_SNAPPY: AnimationPreset = {\n\tname: 'snappy',\n\tduration: 300,\n\teasing: `linear(\n\t\t0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 15.5%, 0.938 23.8%,\n\t\t1.017 30.2%, 1.041 37.3%, 1.026 52.4%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.22, 1.25, 0.36, 1)',\n\tspring: { stiffness: 200, damping: 20, mass: 1 },\n}\n\n/**\n * Bouncy preset - Playful with noticeable overshoot\n * Best for: Notifications, celebrations, attention-grabbing\n */\nexport const SPRING_BOUNCY: AnimationPreset = {\n\tname: 'bouncy',\n\tduration: 600,\n\teasing: `linear(\n\t\t0, 0.004, 0.016 2.3%, 0.065 4.8%, 0.258 9.9%, 0.489 15%,\n\t\t0.683 20.1%, 0.847 25.4%, 0.963 30.6%, 1.039 36%, 1.086 41.8%,\n\t\t1.107 48.1%, 1.101 55.1%, 1.064 73.1%, 1.026 85.2%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.34, 1.8, 0.64, 1)',\n\tspring: { stiffness: 100, damping: 10, mass: 1 },\n}\n\n/**\n * Gentle preset - Slow, smooth, no overshoot\n * Best for: Page transitions, modal backgrounds, subtle reveals\n */\nexport const SPRING_GENTLE: AnimationPreset = {\n\tname: 'gentle',\n\tduration: 700,\n\teasing: `linear(\n\t\t0, 0.002, 0.009 2.6%, 0.036 5.3%, 0.153 11.3%, 0.352 18.5%,\n\t\t0.554 25.4%, 0.733 32.6%, 0.865 40.2%, 0.945 48.5%,\n\t\t0.984 58.2%, 0.997 70.5%, 1\n\t)`,\n\teasingFallback: 'cubic-bezier(0.4, 0, 0.2, 1)',\n\tspring: { stiffness: 80, damping: 25, mass: 1.2 },\n}\n\n// =============================================================================\n// LEGACY EXPORTS (backwards compatibility)\n// =============================================================================\n\n/** @deprecated Use SPRING_SMOOTH.easingFallback instead */\nexport const BLACKBIRD_EASING = SPRING_SMOOTH.easingFallback\n\n/** Standard easing for smooth transitions */\nexport const EASE_OUT = 'ease-out'\nexport const EASE_IN = 'ease-in'\n\n/** Standard durations */\nexport const DURATION_ENTER = SPRING_SNAPPY.duration\nexport const DURATION_EXIT = 150\nexport const DURATION_BACKDROP = 200\n\n// =============================================================================\n// CSS CUSTOM PROPERTIES\n// =============================================================================\n\n/**\n * CSS custom properties for use in stylesheets.\n * These can be injected into :root or a component's styles.\n *\n * @example\n * ```css\n * :root {\n *   ${ANIMATION_CSS_VARS}\n * }\n *\n * .element {\n *   transition: transform var(--blackbird-duration-smooth) var(--blackbird-easing-smooth);\n * }\n * ```\n */\nexport const ANIMATION_CSS_VARS = `\n\t/* Blackbird Animation System - Spring Physics */\n\n\t/* Smooth preset (Apple-style) */\n\t--blackbird-duration-smooth: ${SPRING_SMOOTH.duration}ms;\n\t--blackbird-easing-smooth: ${SPRING_SMOOTH.easingFallback};\n\t--blackbird-easing-smooth-spring: ${SPRING_SMOOTH.easing};\n\n\t/* Snappy preset (quick interactions) */\n\t--blackbird-duration-snappy: ${SPRING_SNAPPY.duration}ms;\n\t--blackbird-easing-snappy: ${SPRING_SNAPPY.easingFallback};\n\t--blackbird-easing-snappy-spring: ${SPRING_SNAPPY.easing};\n\n\t/* Bouncy preset (playful) */\n\t--blackbird-duration-bouncy: ${SPRING_BOUNCY.duration}ms;\n\t--blackbird-easing-bouncy: ${SPRING_BOUNCY.easingFallback};\n\t--blackbird-easing-bouncy-spring: ${SPRING_BOUNCY.easing};\n\n\t/* Gentle preset (subtle) */\n\t--blackbird-duration-gentle: ${SPRING_GENTLE.duration}ms;\n\t--blackbird-easing-gentle: ${SPRING_GENTLE.easingFallback};\n\t--blackbird-easing-gentle-spring: ${SPRING_GENTLE.easing};\n`\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\n/**\n * Get the appropriate easing function based on browser support.\n * Uses linear() if supported, falls back to cubic-bezier.\n */\nexport function getEasing(preset: AnimationPreset): string {\n\t// Feature detect linear() support\n\tif (typeof CSS !== 'undefined' && CSS.supports?.('animation-timing-function', 'linear(0, 1)')) {\n\t\treturn preset.easing\n\t}\n\treturn preset.easingFallback\n}\n\n/**\n * Check if the browser supports reduced motion preference.\n */\nexport function prefersReducedMotion(): boolean {\n\treturn typeof window !== 'undefined' && window.matchMedia('(prefers-reduced-motion: reduce)').matches\n}\n\n/**\n * Create a Web Animations API animation configuration.\n *\n * @example\n * ```ts\n * const anim = createAnimation(SPRING_SMOOTH, {\n *   from: { opacity: 0, transform: 'translateY(-16px)' },\n *   to: { opacity: 1, transform: 'translateY(0)' }\n * })\n *\n * element.animate(anim.keyframes, anim.options)\n * ```\n */\nexport function createAnimation(preset: AnimationPreset, keyframes: BlackbirdKeyframes): BlackbirdAnimation {\n\t// Respect reduced motion preference\n\tif (prefersReducedMotion()) {\n\t\treturn {\n\t\t\tkeyframes: [keyframes.to],\n\t\t\toptions: { duration: 0, fill: 'forwards' },\n\t\t}\n\t}\n\n\treturn {\n\t\tkeyframes: [keyframes.from, keyframes.to],\n\t\toptions: {\n\t\t\tduration: preset.duration,\n\t\t\teasing: preset.easingFallback, // Web Animations API doesn't support linear() well\n\t\t\tfill: 'forwards',\n\t\t},\n\t}\n}\n\n/**\n * Create a reveal animation (fade in + slide up).\n * Common pattern for content appearing.\n */\nexport function createRevealAnimation(\n\tpreset: AnimationPreset = SPRING_SMOOTH,\n\tdistance = 16,\n): BlackbirdAnimation {\n\treturn createAnimation(preset, {\n\t\tfrom: { opacity: 0, transform: `translateY(-${distance}px) scale(0.96)` },\n\t\tto: { opacity: 1, transform: 'translateY(0) scale(1)' },\n\t})\n}\n\n/**\n * Create a dismiss animation (fade out + slide up).\n * Common pattern for content disappearing.\n */\nexport function createDismissAnimation(\n\tpreset: AnimationPreset = SPRING_SMOOTH,\n\tdistance = 12,\n): BlackbirdAnimation {\n\tconst anim = createAnimation(preset, {\n\t\tfrom: { opacity: 1, transform: 'translateY(0) scale(1)' },\n\t\tto: { opacity: 0, transform: `translateY(-${distance}px) scale(0.97)` },\n\t})\n\n\t// Dismiss is slightly faster\n\tif (anim.options.duration) {\n\t\tanim.options.duration = (anim.options.duration as number) * 0.7\n\t}\n\n\treturn anim\n}\n\n/**\n * Create a scale animation (pop in/out).\n * Common pattern for buttons and interactive elements.\n */\nexport function createScaleAnimation(\n\tpreset: AnimationPreset = SPRING_SNAPPY,\n\tfromScale = 0.9,\n\ttoScale = 1,\n): BlackbirdAnimation {\n\treturn createAnimation(preset, {\n\t\tfrom: { opacity: fromScale < toScale ? 0 : 1, transform: `scale(${fromScale})` },\n\t\tto: { opacity: fromScale < toScale ? 1 : 0, transform: `scale(${toScale})` },\n\t})\n}\n\n// =============================================================================\n// TAILWIND UTILITIES (for use in tailwind.config.js)\n// =============================================================================\n\n/**\n * Tailwind CSS animation utilities configuration.\n * Import this into your tailwind.config.js to add Blackbird animations.\n *\n * @example\n * ```js\n * // tailwind.config.js\n * const { tailwindAnimations } = require('@mhmo91/schmancy/utils/animation')\n *\n * module.exports = {\n *   theme: {\n *     extend: {\n *       ...tailwindAnimations\n *     }\n *   }\n * }\n * ```\n */\nexport const tailwindAnimations = {\n\ttransitionTimingFunction: {\n\t\t'spring-smooth': SPRING_SMOOTH.easingFallback,\n\t\t'spring-snappy': SPRING_SNAPPY.easingFallback,\n\t\t'spring-bouncy': SPRING_BOUNCY.easingFallback,\n\t\t'spring-gentle': SPRING_GENTLE.easingFallback,\n\t},\n\ttransitionDuration: {\n\t\t'spring-smooth': `${SPRING_SMOOTH.duration}ms`,\n\t\t'spring-snappy': `${SPRING_SNAPPY.duration}ms`,\n\t\t'spring-bouncy': `${SPRING_BOUNCY.duration}ms`,\n\t\t'spring-gentle': `${SPRING_GENTLE.duration}ms`,\n\t},\n\tkeyframes: {\n\t\t'blackbird-reveal': {\n\t\t\t'0%': { opacity: '0', transform: 'translateY(-16px) scale(0.96)' },\n\t\t\t'100%': { opacity: '1', transform: 'translateY(0) scale(1)' },\n\t\t},\n\t\t'blackbird-dismiss': {\n\t\t\t'0%': { opacity: '1', transform: 'translateY(0) scale(1)' },\n\t\t\t'100%': { opacity: '0', transform: 'translateY(-12px) scale(0.97)' },\n\t\t},\n\t\t'blackbird-scale-in': {\n\t\t\t'0%': { opacity: '0', transform: 'scale(0.9)' },\n\t\t\t'100%': { opacity: '1', transform: 'scale(1)' },\n\t\t},\n\t\t'blackbird-scale-out': {\n\t\t\t'0%': { opacity: '1', transform: 'scale(1)' },\n\t\t\t'100%': { opacity: '0', transform: 'scale(0.9)' },\n\t\t},\n\t\t'blackbird-slide-up': {\n\t\t\t'0%': { transform: 'translateY(100%)' },\n\t\t\t'100%': { transform: 'translateY(0)' },\n\t\t},\n\t\t'blackbird-slide-down': {\n\t\t\t'0%': { transform: 'translateY(0)' },\n\t\t\t'100%': { transform: 'translateY(100%)' },\n\t\t},\n\t},\n\tanimation: {\n\t\t'blackbird-reveal': `blackbird-reveal ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-dismiss': `blackbird-dismiss ${SPRING_SMOOTH.duration * 0.7}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-scale-in': `blackbird-scale-in ${SPRING_SNAPPY.duration}ms ${SPRING_SNAPPY.easingFallback} forwards`,\n\t\t'blackbird-scale-out': `blackbird-scale-out ${SPRING_SNAPPY.duration * 0.7}ms ${SPRING_SNAPPY.easingFallback} forwards`,\n\t\t'blackbird-slide-up': `blackbird-slide-up ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-slide-down': `blackbird-slide-down ${SPRING_SMOOTH.duration * 0.7}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t},\n}\n\n// =============================================================================\n// CSS-IN-JS UTILITIES (for Lit components)\n// =============================================================================\n\n/**\n * CSS string with spring-based grid animation for details/accordions.\n * Use with grid-template-rows for smooth height animation.\n *\n * @example\n * ```ts\n * import { css } from 'lit'\n * import { GRID_ANIMATION_CSS } from '@mhmo91/schmancy'\n *\n * static styles = css`\n *   ${GRID_ANIMATION_CSS}\n *\n *   .content {\n *     display: grid;\n *     grid-template-rows: 0fr;\n *   }\n *   .content[data-open='true'] {\n *     grid-template-rows: 1fr;\n *   }\n * `\n * ```\n */\nexport const GRID_ANIMATION_CSS = `\n\t/* Grid-based height animation with spring physics */\n\t.blackbird-grid {\n\t\tdisplay: grid;\n\t\tgrid-template-rows: 0fr;\n\t\toverflow: hidden;\n\t\ttransition: grid-template-rows ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback};\n\t}\n\n\t/* Use spring easing when linear() is supported */\n\t@supports (animation-timing-function: linear(0, 1)) {\n\t\t.blackbird-grid {\n\t\t\ttransition: grid-template-rows ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easing};\n\t\t}\n\t}\n\n\t.blackbird-grid[data-open='true'],\n\t.blackbird-grid.open {\n\t\tgrid-template-rows: 1fr;\n\t}\n\n\t.blackbird-grid > * {\n\t\toverflow: hidden;\n\t}\n\n\t@media (prefers-reduced-motion: reduce) {\n\t\t.blackbird-grid {\n\t\t\ttransition: none;\n\t\t}\n\t}\n`\n"],"mappings":"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"}
+{"version":3,"file":"animation-CCOIW4wJ.cjs","names":[],"sources":["../src/utils/animation.ts"],"sourcesContent":["/**\n * Blackbird Animation System\n *\n * A comprehensive animation system using spring physics for natural,\n * organic motion. Named after the smooth, arcing flight patterns of birds.\n *\n * Features:\n * - Spring physics via CSS linear() (88% browser support)\n * - Cubic-bezier fallbacks for older browsers\n * - Typed interfaces for Web Animations API\n * - CSS custom properties for Tailwind integration\n * - Multiple presets: smooth, snappy, bouncy\n *\n * @see https://www.joshwcomeau.com/animation/linear-timing-function/\n * @see https://developer.chrome.com/docs/css-ui/css-linear-easing-function\n */\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/** Spring configuration parameters */\nexport interface SpringConfig {\n\t/** Spring stiffness (higher = faster) */\n\tstiffness: number\n\t/** Damping ratio (higher = less bounce) */\n\tdamping: number\n\t/** Mass (higher = slower) */\n\tmass: number\n}\n\n/** Animation preset with all timing values */\nexport interface AnimationPreset {\n\t/** Human-readable name */\n\tname: string\n\t/** Duration in milliseconds */\n\tduration: number\n\t/** CSS linear() easing function (modern browsers) */\n\teasing: string\n\t/** Cubic-bezier fallback (all browsers) */\n\teasingFallback: string\n\t/** Spring configuration used to generate this preset */\n\tspring: SpringConfig\n}\n\n/** Keyframe options for Web Animations API */\nexport interface BlackbirdKeyframes {\n\t/** Starting state */\n\tfrom: Keyframe\n\t/** Ending state */\n\tto: Keyframe\n}\n\n/** Complete animation configuration */\nexport interface BlackbirdAnimation {\n\tkeyframes: Keyframe[]\n\toptions: KeyframeAnimationOptions\n}\n\n// =============================================================================\n// SPRING PRESETS\n// =============================================================================\n\n/**\n * Smooth preset - Apple-style, subtle overshoot\n * Best for: Details, accordions, content reveals\n */\nexport const SPRING_SMOOTH: AnimationPreset = {\n\tname: 'smooth',\n\tduration: 500,\n\teasing: `linear(\n\t\t0, 0.006, 0.025 2.8%, 0.101 6.1%, 0.539 18.9%, 0.721 25.3%, 0.849 31.5%,\n\t\t0.937 38.1%, 0.968 41.8%, 0.991 45.7%, 1.006 50%, 1.015 54.8%,\n\t\t1.017 63.3%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n\tspring: { stiffness: 100, damping: 15, mass: 1 },\n}\n\n/**\n * Snappy preset - Quick with minimal overshoot\n * Best for: Buttons, toggles, quick interactions\n */\nexport const SPRING_SNAPPY: AnimationPreset = {\n\tname: 'snappy',\n\tduration: 300,\n\teasing: `linear(\n\t\t0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 15.5%, 0.938 23.8%,\n\t\t1.017 30.2%, 1.041 37.3%, 1.026 52.4%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.22, 1.25, 0.36, 1)',\n\tspring: { stiffness: 200, damping: 20, mass: 1 },\n}\n\n/**\n * Bouncy preset - Playful with noticeable overshoot\n * Best for: Notifications, celebrations, attention-grabbing\n */\nexport const SPRING_BOUNCY: AnimationPreset = {\n\tname: 'bouncy',\n\tduration: 600,\n\teasing: `linear(\n\t\t0, 0.004, 0.016 2.3%, 0.065 4.8%, 0.258 9.9%, 0.489 15%,\n\t\t0.683 20.1%, 0.847 25.4%, 0.963 30.6%, 1.039 36%, 1.086 41.8%,\n\t\t1.107 48.1%, 1.101 55.1%, 1.064 73.1%, 1.026 85.2%, 1.001\n\t)`,\n\teasingFallback: 'cubic-bezier(0.34, 1.8, 0.64, 1)',\n\tspring: { stiffness: 100, damping: 10, mass: 1 },\n}\n\n/**\n * Gentle preset - Slow, smooth, no overshoot\n * Best for: Page transitions, modal backgrounds, subtle reveals\n */\nexport const SPRING_GENTLE: AnimationPreset = {\n\tname: 'gentle',\n\tduration: 700,\n\teasing: `linear(\n\t\t0, 0.002, 0.009 2.6%, 0.036 5.3%, 0.153 11.3%, 0.352 18.5%,\n\t\t0.554 25.4%, 0.733 32.6%, 0.865 40.2%, 0.945 48.5%,\n\t\t0.984 58.2%, 0.997 70.5%, 1\n\t)`,\n\teasingFallback: 'cubic-bezier(0.4, 0, 0.2, 1)',\n\tspring: { stiffness: 80, damping: 25, mass: 1.2 },\n}\n\n// =============================================================================\n// LEGACY EXPORTS (backwards compatibility)\n// =============================================================================\n\n/** @deprecated Use SPRING_SMOOTH.easingFallback instead */\nexport const BLACKBIRD_EASING = SPRING_SMOOTH.easingFallback\n\n/** Standard easing for smooth transitions */\nexport const EASE_OUT = 'ease-out'\nexport const EASE_IN = 'ease-in'\n\n/** Standard durations */\nexport const DURATION_ENTER = SPRING_SNAPPY.duration\nexport const DURATION_EXIT = 150\nexport const DURATION_BACKDROP = 200\n\n// =============================================================================\n// CSS CUSTOM PROPERTIES\n// =============================================================================\n\n/**\n * CSS custom properties for use in stylesheets.\n * These can be injected into :root or a component's styles.\n *\n * @example\n * ```css\n * :root {\n *   ${ANIMATION_CSS_VARS}\n * }\n *\n * .element {\n *   transition: transform var(--blackbird-duration-smooth) var(--blackbird-easing-smooth);\n * }\n * ```\n */\nexport const ANIMATION_CSS_VARS = `\n\t/* Blackbird Animation System - Spring Physics */\n\n\t/* Smooth preset (Apple-style) */\n\t--blackbird-duration-smooth: ${SPRING_SMOOTH.duration}ms;\n\t--blackbird-easing-smooth: ${SPRING_SMOOTH.easingFallback};\n\t--blackbird-easing-smooth-spring: ${SPRING_SMOOTH.easing};\n\n\t/* Snappy preset (quick interactions) */\n\t--blackbird-duration-snappy: ${SPRING_SNAPPY.duration}ms;\n\t--blackbird-easing-snappy: ${SPRING_SNAPPY.easingFallback};\n\t--blackbird-easing-snappy-spring: ${SPRING_SNAPPY.easing};\n\n\t/* Bouncy preset (playful) */\n\t--blackbird-duration-bouncy: ${SPRING_BOUNCY.duration}ms;\n\t--blackbird-easing-bouncy: ${SPRING_BOUNCY.easingFallback};\n\t--blackbird-easing-bouncy-spring: ${SPRING_BOUNCY.easing};\n\n\t/* Gentle preset (subtle) */\n\t--blackbird-duration-gentle: ${SPRING_GENTLE.duration}ms;\n\t--blackbird-easing-gentle: ${SPRING_GENTLE.easingFallback};\n\t--blackbird-easing-gentle-spring: ${SPRING_GENTLE.easing};\n`\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\n/**\n * Get the appropriate easing function based on browser support.\n * Uses linear() if supported, falls back to cubic-bezier.\n */\nexport function getEasing(preset: AnimationPreset): string {\n\t// Feature detect linear() support\n\tif (typeof CSS !== 'undefined' && CSS.supports?.('animation-timing-function', 'linear(0, 1)')) {\n\t\treturn preset.easing\n\t}\n\treturn preset.easingFallback\n}\n\n/**\n * Check if the browser supports reduced motion preference.\n */\nexport function prefersReducedMotion(): boolean {\n\treturn typeof window !== 'undefined' && window.matchMedia('(prefers-reduced-motion: reduce)').matches\n}\n\n/**\n * Create a Web Animations API animation configuration.\n *\n * @example\n * ```ts\n * const anim = createAnimation(SPRING_SMOOTH, {\n *   from: { opacity: 0, transform: 'translateY(-16px)' },\n *   to: { opacity: 1, transform: 'translateY(0)' }\n * })\n *\n * element.animate(anim.keyframes, anim.options)\n * ```\n */\nexport function createAnimation(preset: AnimationPreset, keyframes: BlackbirdKeyframes): BlackbirdAnimation {\n\t// Respect reduced motion preference\n\tif (prefersReducedMotion()) {\n\t\treturn {\n\t\t\tkeyframes: [keyframes.to],\n\t\t\toptions: { duration: 0, fill: 'forwards' },\n\t\t}\n\t}\n\n\treturn {\n\t\tkeyframes: [keyframes.from, keyframes.to],\n\t\toptions: {\n\t\t\tduration: preset.duration,\n\t\t\teasing: preset.easingFallback, // Web Animations API doesn't support linear() well\n\t\t\tfill: 'forwards',\n\t\t},\n\t}\n}\n\n/**\n * Create a reveal animation (fade in + slide up).\n * Common pattern for content appearing.\n */\nexport function createRevealAnimation(preset: AnimationPreset = SPRING_SMOOTH, distance = 16): BlackbirdAnimation {\n\treturn createAnimation(preset, {\n\t\tfrom: { opacity: 0, transform: `translateY(-${distance}px) scale(0.96)` },\n\t\tto: { opacity: 1, transform: 'translateY(0) scale(1)' },\n\t})\n}\n\n/**\n * Create a dismiss animation (fade out + slide up).\n * Common pattern for content disappearing.\n */\nexport function createDismissAnimation(preset: AnimationPreset = SPRING_SMOOTH, distance = 12): BlackbirdAnimation {\n\tconst anim = createAnimation(preset, {\n\t\tfrom: { opacity: 1, transform: 'translateY(0) scale(1)' },\n\t\tto: { opacity: 0, transform: `translateY(-${distance}px) scale(0.97)` },\n\t})\n\n\t// Dismiss is slightly faster\n\tif (anim.options.duration) {\n\t\tanim.options.duration = (anim.options.duration as number) * 0.7\n\t}\n\n\treturn anim\n}\n\n/**\n * Create a scale animation (pop in/out).\n * Common pattern for buttons and interactive elements.\n */\nexport function createScaleAnimation(\n\tpreset: AnimationPreset = SPRING_SNAPPY,\n\tfromScale = 0.9,\n\ttoScale = 1,\n): BlackbirdAnimation {\n\treturn createAnimation(preset, {\n\t\tfrom: { opacity: fromScale < toScale ? 0 : 1, transform: `scale(${fromScale})` },\n\t\tto: { opacity: fromScale < toScale ? 1 : 0, transform: `scale(${toScale})` },\n\t})\n}\n\n// =============================================================================\n// TAILWIND UTILITIES (for use in tailwind.config.js)\n// =============================================================================\n\n/**\n * Tailwind CSS animation utilities configuration.\n * Import this into your tailwind.config.js to add Blackbird animations.\n *\n * @example\n * ```js\n * // tailwind.config.js\n * const { tailwindAnimations } = require('@mhmo91/schmancy/utils/animation')\n *\n * module.exports = {\n *   theme: {\n *     extend: {\n *       ...tailwindAnimations\n *     }\n *   }\n * }\n * ```\n */\nexport const tailwindAnimations = {\n\ttransitionTimingFunction: {\n\t\t'spring-smooth': SPRING_SMOOTH.easingFallback,\n\t\t'spring-snappy': SPRING_SNAPPY.easingFallback,\n\t\t'spring-bouncy': SPRING_BOUNCY.easingFallback,\n\t\t'spring-gentle': SPRING_GENTLE.easingFallback,\n\t},\n\ttransitionDuration: {\n\t\t'spring-smooth': `${SPRING_SMOOTH.duration}ms`,\n\t\t'spring-snappy': `${SPRING_SNAPPY.duration}ms`,\n\t\t'spring-bouncy': `${SPRING_BOUNCY.duration}ms`,\n\t\t'spring-gentle': `${SPRING_GENTLE.duration}ms`,\n\t},\n\tkeyframes: {\n\t\t'blackbird-reveal': {\n\t\t\t'0%': { opacity: '0', transform: 'translateY(-16px) scale(0.96)' },\n\t\t\t'100%': { opacity: '1', transform: 'translateY(0) scale(1)' },\n\t\t},\n\t\t'blackbird-dismiss': {\n\t\t\t'0%': { opacity: '1', transform: 'translateY(0) scale(1)' },\n\t\t\t'100%': { opacity: '0', transform: 'translateY(-12px) scale(0.97)' },\n\t\t},\n\t\t'blackbird-scale-in': {\n\t\t\t'0%': { opacity: '0', transform: 'scale(0.9)' },\n\t\t\t'100%': { opacity: '1', transform: 'scale(1)' },\n\t\t},\n\t\t'blackbird-scale-out': {\n\t\t\t'0%': { opacity: '1', transform: 'scale(1)' },\n\t\t\t'100%': { opacity: '0', transform: 'scale(0.9)' },\n\t\t},\n\t\t'blackbird-slide-up': {\n\t\t\t'0%': { transform: 'translateY(100%)' },\n\t\t\t'100%': { transform: 'translateY(0)' },\n\t\t},\n\t\t'blackbird-slide-down': {\n\t\t\t'0%': { transform: 'translateY(0)' },\n\t\t\t'100%': { transform: 'translateY(100%)' },\n\t\t},\n\t},\n\tanimation: {\n\t\t'blackbird-reveal': `blackbird-reveal ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-dismiss': `blackbird-dismiss ${SPRING_SMOOTH.duration * 0.7}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-scale-in': `blackbird-scale-in ${SPRING_SNAPPY.duration}ms ${SPRING_SNAPPY.easingFallback} forwards`,\n\t\t'blackbird-scale-out': `blackbird-scale-out ${SPRING_SNAPPY.duration * 0.7}ms ${SPRING_SNAPPY.easingFallback} forwards`,\n\t\t'blackbird-slide-up': `blackbird-slide-up ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t\t'blackbird-slide-down': `blackbird-slide-down ${SPRING_SMOOTH.duration * 0.7}ms ${SPRING_SMOOTH.easingFallback} forwards`,\n\t},\n}\n\n// =============================================================================\n// CSS-IN-JS UTILITIES (for Lit components)\n// =============================================================================\n\n/**\n * CSS string with spring-based grid animation for details/accordions.\n * Use with grid-template-rows for smooth height animation.\n *\n * @example\n * ```ts\n * import { css } from 'lit'\n * import { GRID_ANIMATION_CSS } from '@mhmo91/schmancy'\n *\n * static styles = css`\n *   ${GRID_ANIMATION_CSS}\n *\n *   .content {\n *     display: grid;\n *     grid-template-rows: 0fr;\n *   }\n *   .content[data-open='true'] {\n *     grid-template-rows: 1fr;\n *   }\n * `\n * ```\n */\nexport const GRID_ANIMATION_CSS = `\n\t/* Grid-based height animation with spring physics */\n\t.blackbird-grid {\n\t\tdisplay: grid;\n\t\tgrid-template-rows: 0fr;\n\t\toverflow: hidden;\n\t\ttransition: grid-template-rows ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easingFallback};\n\t}\n\n\t/* Use spring easing when linear() is supported */\n\t@supports (animation-timing-function: linear(0, 1)) {\n\t\t.blackbird-grid {\n\t\t\ttransition: grid-template-rows ${SPRING_SMOOTH.duration}ms ${SPRING_SMOOTH.easing};\n\t\t}\n\t}\n\n\t.blackbird-grid[data-open='true'],\n\t.blackbird-grid.open {\n\t\tgrid-template-rows: 1fr;\n\t}\n\n\t.blackbird-grid > * {\n\t\toverflow: hidden;\n\t}\n\n\t@media (prefers-reduced-motion: reduce) {\n\t\t.blackbird-grid {\n\t\t\ttransition: none;\n\t\t}\n\t}\n`\n"],"mappings":"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"}