@mhmo91/schmancy 0.9.4 → 0.9.6

package/types/src/splash-screen/splash-screen.d.ts

@@ -0,0 +1,60 @@
+export type SchmancySplashScreenDoneEvent = CustomEvent<void>;
+declare const SchmancySplashScreen_base: CustomElementConstructor & import("../../mixins").Constructor<import("lit").LitElement> & import("../../mixins").Constructor<import("../../mixins").IBaseMixin>;
+/**
+ * Full-viewport splash overlay that dismisses once a minimum duration has
+ * elapsed and (optionally) an external `ready` signal has fired. The splash
+ * fades out while the underlying app content fades in.
+ *
+ * Bring-your-own visuals: the `splash` slot is empty by default so the
+ * component pulls in no dependencies. Provide a logo, spinner, or
+ * animation from the consumer side.
+ *
+ * @element schmancy-splash-screen
+ * @slot splash - Content rendered on the splash layer (logo, spinner, etc.).
+ * @slot - Default slot for the actual app content, revealed once dismissed.
+ * @fires schmancy-splash-done - `CustomEvent<void>` when the splash dismisses.
+ *
+ * @example
+ * ```html
+ * <schmancy-splash-screen min-duration="1200">
+ *   <my-logo slot="splash"></my-logo>
+ *   <my-app></my-app>
+ * </schmancy-splash-screen>
+ * ```
+ */
+export default class SchmancySplashScreen extends SchmancySplashScreen_base {
+    /**
+     * Minimum duration (ms) the splash layer stays visible. Prevents a flash
+     * when the app loads faster than expected.
+     */
+    minDuration: number;
+    /**
+     * When true, the splash dismisses on the `minDuration` timer alone.
+     * When false (default), it additionally waits for an external ready signal
+     * (a `ready` event on this element, or a call to `this.ready()`).
+     */
+    auto: boolean;
+    /**
+     * When true, the splash starts hidden. Use this for imperative control.
+     */
+    initiallyHidden: boolean;
+    private _visible;
+    connectedCallback(): void;
+    /**
+     * Imperative API: signal that the app is ready and dismiss the splash
+     * after the minimum duration has elapsed.
+     */
+    ready(): void;
+    /**
+     * Force the splash to show again (e.g. between route transitions).
+     */
+    show(): void;
+    private _dismiss;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'schmancy-splash-screen': SchmancySplashScreen;
+    }
+}
+export {};

package/types/src/switch/index.d.ts

@@ -0,0 +1 @@
+export * from './switch';

package/types/src/switch/switch.d.ts

@@ -0,0 +1,54 @@
+import { LitElement } from 'lit';
+export type SchmancySwitchChangeEvent = CustomEvent<{
+    value: boolean;
+}>;
+declare const SchmancySwitch_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+/**
+ * Binary on/off control. Form-associated, keyboard-accessible, semantically a
+ * switch (ARIA role="switch"). Distinct from `schmancy-checkbox`: a switch
+ * represents an immediate state change, a checkbox represents a selection in
+ * a form to be submitted.
+ *
+ * @element schmancy-switch
+ * @fires change - `CustomEvent<{ value: boolean }>` when the state changes.
+ * @attr checked - Initial checked state (also reflected via `value`).
+ * @attr disabled - Disables interaction.
+ * @attr required - Requires the switch to be on for form validity.
+ * @attr name - Form field name for submission.
+ * @csspart track - The background track.
+ * @csspart thumb - The moving thumb.
+ */
+export declare class SchmancySwitch extends SchmancySwitch_base {
+    static formAssociated: boolean;
+    private internals;
+    checked: boolean;
+    disabled: boolean;
+    required: boolean;
+    name: string;
+    value: string;
+    label: string;
+    protected static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    constructor();
+    get form(): HTMLFormElement | null;
+    protected updated(changed: Map<string, unknown>): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    private _toggle;
+    private _onKeydown;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'schmancy-switch': SchmancySwitch;
+    }
+}
+export {};

package/types/src/switch/switch.test.d.ts

@@ -0,0 +1 @@
+import './switch';

package/types/src/test-utils/a11y.d.ts

@@ -0,0 +1,11 @@
+import { type ElementContext, type RunOptions, type Result } from 'axe-core';
+/**
+ * Run axe-core on the given element (or document) and assert no violations.
+ * Throws a readable failure with a summary of violations so test output is
+ * immediately actionable.
+ *
+ * Keep the axe rule set minimal and appropriate for component tests — the
+ * defaults include many rules that only make sense at the page level (e.g.
+ * `region`, `landmark-one-main`). Override via `options.rules` when needed.
+ */
+export declare function expectNoA11yViolations(context?: ElementContext, options?: RunOptions): Promise<Result[]>;

package/types/src/textarea/textarea.d.ts

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, type PropertyValues } from 'lit';
 declare const SchmancyTextarea_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * Textarea component with auto-resize and form integration.
@@ -24,6 +24,7 @@ export default class SchmancyTextarea extends SchmancyTextarea_base {
     static formAssociated: boolean;
     internals: ElementInternals | undefined;
     textareaRef: import("lit-html/directives/ref").Ref<HTMLTextAreaElement>;
+    private readonly _a11yId;
     /**
      * The label of the control.
      * @attr
@@ -141,6 +142,9 @@ export default class SchmancyTextarea extends SchmancyTextarea_base {
     hint: string | undefined;
     error: boolean;
     constructor();
+    protected willUpdate(changed: PropertyValues): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     firstUpdated(): void;
     get form(): HTMLFormElement;
     /** Checks for validity of the control and shows the browser message if it's invalid. */

package/types/src/tooltip/index.d.ts

@@ -1,2 +1 @@
 export * from './tooltip.directive';
-export * from './tooltip';

package/types/src/tree/tree.d.ts

@@ -12,6 +12,11 @@ export declare class SchmancyTree extends SchmancyTree_base {
     toggler: HTMLSlotElement;
     defaultSlot: HTMLSlotElement;
     chevron: HTMLElement;
+    private readonly _a11yId;
+    private get _contentId();
+    /** ElementInternals — broadcasts `:state(open)` for consumer CSS. */
+    private readonly _internals;
+    updated(changed: Map<string, unknown>): void;
     firstUpdated(): void;
     render(): import("lit-html").TemplateResult<1>;
 }

package/types/src/visually-hidden/index.d.ts

@@ -0,0 +1 @@
+export * from './visually-hidden';

package/types/src/visually-hidden/visually-hidden.d.ts

@@ -0,0 +1,21 @@
+declare const SchmancyVisuallyHidden_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+/**
+ * Hides content visually while keeping it in the accessibility tree. Use for
+ * screen-reader-only labels, supplemental descriptions, and live-region text
+ * that sighted users don't need to see.
+ *
+ * Uses the WCAG-recommended clip pattern rather than `display: none` or
+ * `visibility: hidden` so assistive tech still reads the content.
+ *
+ * @element schmancy-visually-hidden
+ * @slot - Content hidden from sighted users but exposed to assistive tech.
+ */
+export declare class SchmancyVisuallyHidden extends SchmancyVisuallyHidden_base {
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'schmancy-visually-hidden': SchmancyVisuallyHidden;
+    }
+}
+export {};

package/types/src/window/window-position.d.ts

@@ -10,7 +10,7 @@
  *   const resolved = resolveOverlap(projected, neighbors, { width: 1440, height: 900 })
  *   // → { left: 144, top: 444, width: 360, height: 500 } (cascaded away from conflict)
  */
-import type { WindowBounds, WindowRecord, SnapCorner } from './window-registry.js';
+import type { WindowBounds, WindowRecord } from './window-registry.js';
 /** Check if two rectangles overlap (edges touching does NOT count as overlap) */
 export declare function rectsOverlap(a: WindowBounds, b: WindowBounds): boolean;
 /**
@@ -21,17 +21,6 @@ export declare function resolveOverlap(candidate: WindowBounds, existing: Window
     width: number;
     height: number;
 }): WindowBounds;
-/**
- * Snap window bounds to a corner with standard edge gap.
- */
-export declare function snapToCorner(bounds: WindowBounds, corner: SnapCorner, viewport: {
-    width: number;
-    height: number;
-}, bottomOffset: number): WindowBounds;
-/**
- * Place a window flush beside a neighbor.
- */
-export declare function snapToNeighbor(bounds: WindowBounds, neighbor: WindowBounds, side: 'left' | 'right'): WindowBounds;
 /**
  * Clamp bounds so the window stays fully within the viewport.
  */
@@ -39,26 +28,3 @@ export declare function clampToViewport(bounds: WindowBounds, viewport: {
     width: number;
     height: number;
 }): WindowBounds;
-/**
- * Convert corner-relative offset (used by the old float) to absolute viewport bounds.
- */
-export declare function cornerOffsetToAbsolute(corner: SnapCorner, offset: {
-    x: number;
-    y: number;
-}, size: {
-    width: number;
-    height: number;
-}, viewport: {
-    width: number;
-    height: number;
-}, bottomOffset: number): WindowBounds;
-/**
- * Convert absolute viewport bounds back to corner-relative offset.
- */
-export declare function absoluteToCornerOffset(corner: SnapCorner, bounds: WindowBounds, viewport: {
-    width: number;
-    height: number;
-}, bottomOffset: number): {
-    x: number;
-    y: number;
-};

package/ai/INDEX.md

@@ -1,72 +0,0 @@
-# Schmancy — Documentation Index
-
-A Web Component UI library on Lit + RxJS + Tailwind CSS.
-
-## Foundations
-
-The framework pieces — touch before components.
-
-- [Area](./area.md) — `<schmancy-area>`, `<schmancy-route>`, `area.push()`, `lazy()` for routing.
-- [Store](./store.md) — `createContext`, `@select`, `@selectItem`, storage backends.
-- [Mixins](./mixins.md) — `$LitElement` base class.
-- [Theme](./theme.md) — `<schmancy-theme>`, color scheme, CSS variables.
-- [Directives](./directives.md) — Lit directives for physics, effects, text, visibility, interaction.
-- [Animation](./animation.md) — Spring presets (`SPRING_SMOOTH`, etc.), `createAnimation`.
-
-## Components by job
-
-### Display
-[Typography](./typography.md) · [Icons](./icons.md) · [Avatar](./avatar.md) · [Divider](./divider.md) · [Badge](./badge.md) · [Code Highlight](./code-highlight.md) · [Typewriter](./typewriter.md) · [JSON](./json.md) · [Iframe](./iframe.md) · [Map](./map.md) · [Charts](./charts.md)
-
-### Surfaces & layout
-[Surface](./surface.md) · [Card](./card.md) · [Scroll / Grid / Flex](./layout.md) · [Page](./page.md) · [Content Drawer](./content-drawer.md) · [Window](./window.md) · [Boat](./boat.md) · [Float](./float.md)
-
-### Forms
-[Form](./form.md) · [Input](./input.md) · [Textarea](./textarea.md) · [Select](./select.md) · [Autocomplete](./autocomplete.md) · [Option](./option.md) · [Checkbox](./checkbox.md) · [Radio Group](./radio-group.md) · [Chips](./chips.md) · [Date Range](./date-range.md) · [Date Range Inline](./date-range-inline.md) · [Range](./range.md) · [Extra (Country/Timezone)](./extra.md)
-
-### Navigation
-[Nav Drawer](./nav-drawer.md) · [Tabs](./tabs.md) · [Navigation Bar](./navigation-bar.md) · [Navigation Rail](./navigation-rail.md) · [Steps](./steps.md) · [Teleport](./teleport.md) · [Theme Button](./theme-button.md)
-
-### Overlays
-[Dialog](./dialog.md) · [Sheet](./sheet.md) · [Notification](./notification.md) · [Menu](./menu.md) · [Dropdown](./dropdown.md) · [Tooltip](./tooltip.md) · [Lightbox](./lightbox.md) · [Expand](./expand.md)
-
-### Interactive
-[Button](./button.md) · [List](./list.md) · [Details](./details.md) · [Table](./table.md) · [Tree](./tree.md) · [Slider](./slider.md) · [QR Scanner](./qr-scanner.md)
-
-### Feedback
-[Progress](./progress.md) · [Busy](./busy.md) · [Connectivity](./connectivity.md) · [Delay](./delay.md)
-
-### Domain
-[Mailbox](./mailbox.md)
-
-## Services (imperative APIs)
-
-| Service | Purpose |
-|---------|---------|
-| `area` | Route navigation (see [area](./area.md)) |
-| `$dialog` | Open dialogs (see [dialog](./dialog.md)) |
-| `$notify` | Toast notifications (see [notification](./notification.md)) |
-| `schmancyContentDrawer` | Side panel (see [content-drawer](./content-drawer.md)) |
-| `theme` | Theme state, `fullscreen$` (see [theme](./theme.md)) |
-| `sound` | Audio feedback (see [audio](./audio.md)) |
-| `overlayStack` | Z-index coordinator (see [utils](./utils.md)) |
-| `windowManager` | Window registry (see [window](./window.md)) |
-
-## Utilities
-
-[Discovery](./discovery.md) — cross-shadow component lookup.
-[RxJS Utils](./rxjs-utils.md) — `waitForElement`, `waitUntil`, `mutationObserver`.
-[Utils](./utils.md) — `similarity`, `numbers`, `overlayStack`, `intersection$`, `hashContent`.
-[Audio](./audio.md) — synthesized feedback sounds.
-
-## Conventions
-
-- Lists use `repeat(items, item => item.id, tpl)`.
-- View switching uses `cache(...)`.
-- Expensive work uses `guard([deps], fn)`.
-- DOM access uses `ref(createRef())`.
-- Conditionals use `when(...)`, `choose(...)`, `ifDefined(...)`.
-- All RxJS subscriptions end with `.pipe(takeUntil(this.disconnecting))`.
-- Don't use `setTimeout` / `setInterval` / `addEventListener` — use RxJS (`timer`, `interval`, `fromEvent`).
-- Colors come from `--schmancy-sys-color-*` CSS vars or Tailwind theme classes.
-- `classMap(...)` must be the sole expression in `class=`; never mix with string interpolation.

package/ai/tooltip.md

@@ -1,38 +0,0 @@
-# tooltip (directive)
-
-> Lit directive that adds a positioned tooltip to any element on hover/focus.
-
-## Usage
-```typescript
-import { tooltip } from '@mhmo91/schmancy'
-
-html`<button ${tooltip('Click to save')}>Save</button>`
-```
-
-## Parameters
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| text | string | required | Tooltip text content |
-| options.position | `'top'\|'right'\|'bottom'\|'left'` | `'top'` | Tooltip placement |
-| options.delay | number | `300` | Show delay in ms |
-| options.showArrow | boolean | `true` | Show arrow indicator |
-
-## Examples
-```html
-<!-- Bottom positioned -->
-<schmancy-icon-button ${tooltip('Delete item', { position: 'bottom' })}>
-  delete
-</schmancy-icon-button>
-
-<!-- No delay, no arrow -->
-<span ${tooltip('Status: Active', { delay: 0, showArrow: false })}>
-  Active
-</span>
-
-<!-- Right positioned -->
-<div ${tooltip('More info here', { position: 'right' })}>
-  Hover me
-</div>
-```
-
-Uses Floating UI for smart positioning with automatic flipping when near viewport edges. Accessible via `aria-describedby`. Closes on Escape key.

package/dist/ai/INDEX.md

@@ -1,72 +0,0 @@
-# Schmancy — Documentation Index
-
-A Web Component UI library on Lit + RxJS + Tailwind CSS.
-
-## Foundations
-
-The framework pieces — touch before components.
-
-- [Area](./area.md) — `<schmancy-area>`, `<schmancy-route>`, `area.push()`, `lazy()` for routing.
-- [Store](./store.md) — `createContext`, `@select`, `@selectItem`, storage backends.
-- [Mixins](./mixins.md) — `$LitElement` base class.
-- [Theme](./theme.md) — `<schmancy-theme>`, color scheme, CSS variables.
-- [Directives](./directives.md) — Lit directives for physics, effects, text, visibility, interaction.
-- [Animation](./animation.md) — Spring presets (`SPRING_SMOOTH`, etc.), `createAnimation`.
-
-## Components by job
-
-### Display
-[Typography](./typography.md) · [Icons](./icons.md) · [Avatar](./avatar.md) · [Divider](./divider.md) · [Badge](./badge.md) · [Code Highlight](./code-highlight.md) · [Typewriter](./typewriter.md) · [JSON](./json.md) · [Iframe](./iframe.md) · [Map](./map.md) · [Charts](./charts.md)
-
-### Surfaces & layout
-[Surface](./surface.md) · [Card](./card.md) · [Scroll / Grid / Flex](./layout.md) · [Page](./page.md) · [Content Drawer](./content-drawer.md) · [Window](./window.md) · [Boat](./boat.md) · [Float](./float.md)
-
-### Forms
-[Form](./form.md) · [Input](./input.md) · [Textarea](./textarea.md) · [Select](./select.md) · [Autocomplete](./autocomplete.md) · [Option](./option.md) · [Checkbox](./checkbox.md) · [Radio Group](./radio-group.md) · [Chips](./chips.md) · [Date Range](./date-range.md) · [Date Range Inline](./date-range-inline.md) · [Range](./range.md) · [Extra (Country/Timezone)](./extra.md)
-
-### Navigation
-[Nav Drawer](./nav-drawer.md) · [Tabs](./tabs.md) · [Navigation Bar](./navigation-bar.md) · [Navigation Rail](./navigation-rail.md) · [Steps](./steps.md) · [Teleport](./teleport.md) · [Theme Button](./theme-button.md)
-
-### Overlays
-[Dialog](./dialog.md) · [Sheet](./sheet.md) · [Notification](./notification.md) · [Menu](./menu.md) · [Dropdown](./dropdown.md) · [Tooltip](./tooltip.md) · [Lightbox](./lightbox.md) · [Expand](./expand.md)
-
-### Interactive
-[Button](./button.md) · [List](./list.md) · [Details](./details.md) · [Table](./table.md) · [Tree](./tree.md) · [Slider](./slider.md) · [QR Scanner](./qr-scanner.md)
-
-### Feedback
-[Progress](./progress.md) · [Busy](./busy.md) · [Connectivity](./connectivity.md) · [Delay](./delay.md)
-
-### Domain
-[Mailbox](./mailbox.md)
-
-## Services (imperative APIs)
-
-| Service | Purpose |
-|---------|---------|
-| `area` | Route navigation (see [area](./area.md)) |
-| `$dialog` | Open dialogs (see [dialog](./dialog.md)) |
-| `$notify` | Toast notifications (see [notification](./notification.md)) |
-| `schmancyContentDrawer` | Side panel (see [content-drawer](./content-drawer.md)) |
-| `theme` | Theme state, `fullscreen$` (see [theme](./theme.md)) |
-| `sound` | Audio feedback (see [audio](./audio.md)) |
-| `overlayStack` | Z-index coordinator (see [utils](./utils.md)) |
-| `windowManager` | Window registry (see [window](./window.md)) |
-
-## Utilities
-
-[Discovery](./discovery.md) — cross-shadow component lookup.
-[RxJS Utils](./rxjs-utils.md) — `waitForElement`, `waitUntil`, `mutationObserver`.
-[Utils](./utils.md) — `similarity`, `numbers`, `overlayStack`, `intersection$`, `hashContent`.
-[Audio](./audio.md) — synthesized feedback sounds.
-
-## Conventions
-
-- Lists use `repeat(items, item => item.id, tpl)`.
-- View switching uses `cache(...)`.
-- Expensive work uses `guard([deps], fn)`.
-- DOM access uses `ref(createRef())`.
-- Conditionals use `when(...)`, `choose(...)`, `ifDefined(...)`.
-- All RxJS subscriptions end with `.pipe(takeUntil(this.disconnecting))`.
-- Don't use `setTimeout` / `setInterval` / `addEventListener` — use RxJS (`timer`, `interval`, `fromEvent`).
-- Colors come from `--schmancy-sys-color-*` CSS vars or Tailwind theme classes.
-- `classMap(...)` must be the sole expression in `class=`; never mix with string interpolation.

package/dist/ai/tooltip.md

@@ -1,38 +0,0 @@
-# tooltip (directive)
-
-> Lit directive that adds a positioned tooltip to any element on hover/focus.
-
-## Usage
-```typescript
-import { tooltip } from '@mhmo91/schmancy'
-
-html`<button ${tooltip('Click to save')}>Save</button>`
-```
-
-## Parameters
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| text | string | required | Tooltip text content |
-| options.position | `'top'\|'right'\|'bottom'\|'left'` | `'top'` | Tooltip placement |
-| options.delay | number | `300` | Show delay in ms |
-| options.showArrow | boolean | `true` | Show arrow indicator |
-
-## Examples
-```html
-<!-- Bottom positioned -->
-<schmancy-icon-button ${tooltip('Delete item', { position: 'bottom' })}>
-  delete
-</schmancy-icon-button>
-
-<!-- No delay, no arrow -->
-<span ${tooltip('Status: Active', { delay: 0, showArrow: false })}>
-  Active
-</span>
-
-<!-- Right positioned -->
-<div ${tooltip('More info here', { position: 'right' })}>
-  Hover me
-</div>
-```
-
-Uses Floating UI for smart positioning with automatic flipping when near viewport edges. Accessible via `aria-describedby`. Closes on Escape key.

package/dist/animation-BK-8BwY8.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"animation-BK-8BwY8.js","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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"}

package/dist/animation-CO_Csq84.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"animation-CO_Csq84.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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"}