ugly-app 0.1.74 → 0.1.76

package/MIGRATION.md

@@ -0,0 +1,128 @@
+# Migration Guide
+
+## trackKeys Subscriptions + parentId Removal
+
+### What changed
+
+- `meta.parent` renamed to `meta.cascadeFrom` on `CollectionMeta` / `CollectionDef`
+- `meta.trackKeys` added to `CollectionMeta` for scoped real-time subscriptions
+- All `parentId` parameters removed from `TypedDB` methods
+- `trackDocs` wire protocol changed: `filter` replaced by `keys` + `where`
+- Client `socket.trackDocs` signature changed
+
+---
+
+### 1. Rename `parent` → `cascadeFrom` in collection definitions
+
+**Before:**
+```ts
+message: {
+  type: {} as Message,
+  meta: { cache: false, trackable: true, public: true, parent: 'chat' },
+}
+```
+
+**After:**
+```ts
+message: {
+  type: {} as Message,
+  meta: { cache: false, trackable: true, public: true, cascadeFrom: 'chat', trackKeys: ['chatId'] },
+}
+```
+
+---
+
+### 2. Remove `parentId` from all `TypedDB` calls
+
+**Before:**
+```ts
+await ctx.db.setDoc(collections.message, msg, { parentId: chatId });
+await ctx.db.setDocFields(collections.message, msgId, fields, { parentId: chatId });
+await ctx.db.getDocs(collections.message, filter, { parentId: chatId });
+await ctx.db.deleteDoc(collections.message, msgId, { parentId: chatId });
+await ctx.db.deleteQuery(collections.message, match, { parentId: chatId });
+```
+
+**After:**
+```ts
+await ctx.db.setDoc(collections.message, msg);
+await ctx.db.setDocFields(collections.message, msgId, fields);
+await ctx.db.getDocs(collections.message, filter);
+await ctx.db.deleteDoc(collections.message, msgId);
+await ctx.db.deleteQuery(collections.message, match);
+```
+
+Because IDs are globally unique GUIDs, no scoping is needed.
+
+---
+
+### 3. Update `socket.trackDocs` on the client
+
+**Before:**
+```ts
+const unsub = socket.trackDocs(
+  'message',
+  { chatId: '1234' },
+  (messages) => setMessages(messages),
+  { sort: { created: -1 }, limit: 50 },
+);
+```
+
+**After:**
+```ts
+const unsub = socket.trackDocs(
+  collections.message,
+  { keys: { chatId: '1234' }, sort: { created: -1 }, limit: 50 },
+  (messages) => setMessages(messages),
+);
+```
+
+For collections without `trackKeys`, pass `keys: {}` and use `where` for filters:
+```ts
+socket.trackDocs(collections.post, { keys: {}, where: { published: true } }, (posts) => setPosts(posts));
+```
+
+---
+
+### 4. Wire protocol change (client/server must deploy together)
+
+The WebSocket `trackDocs` message shape changed:
+
+| Field | Before | After |
+|-------|--------|-------|
+| `filter` | `Record<string, unknown>` (equality) | removed |
+| `keys` | — | `Record<string, string>` (trackKeys values) |
+| `where` | — | `Record<string, unknown>` (extra equality filters) |
+
+This is a **breaking wire change**. Deploy client and server together.
+
+---
+
+### 5. `trackKeys` immutability constraint
+
+Fields listed in `trackKeys` are assumed immutable after document creation. If a
+`trackKeys` field value changes after insert, subscribers on the old key channel
+will not be notified. Design your data model so `trackKeys` fields never change
+(e.g. `chatId` on a message is set at creation and never updated).
+
+---
+
+### 6. Data migration for existing apps using `parentId`
+
+If your app previously used `parentId` in `setDoc`/`deleteDoc` calls, your MongoDB
+documents may have compound `_id` values in the format `parentId:childId`. These
+documents are no longer addressable by ugly-app's TypedDB after this change.
+
+**Before deploying server changes**, run a migration to convert compound `_id` values
+to plain leaf IDs. Write a migration script that:
+1. Iterates each child collection (those that had `meta.parent` set)
+2. Finds documents whose `_id` contains `:` (compound format: `parentId:childId`)
+3. Inserts a copy with `_id` set to the leaf segment only (`childId`)
+4. Deletes the original compound-ID document
+
+Run the migration against staging first, then production.
+
+Deployment order:
+1. Deploy ugly-app framework update
+2. Run the `_id` migration against your MongoDB
+3. Deploy your app's server code changes (removing `parentId` from TypedDB calls)

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.74";
+export declare const CLI_VERSION = "0.1.76";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.74";
+export const CLI_VERSION = "0.1.76";
 //# sourceMappingURL=version.js.map

package/dist/client/animation/animatedValue.d.ts

@@ -38,4 +38,9 @@ export interface AnimatedValueRef {
 }
 export declare function createAnimatedValue(initial: number): AnimatedValueRef;
 export declare function useAnimatedValue(initial: number): AnimatedValueRef;
+/**
+ * Hook to track an animated value and trigger re-renders.
+ * Use this when you need React to re-render on animation updates.
+ */
+export declare function useAnimatedValueTracker(animatedValue: AnimatedValueRef): number;
 //# sourceMappingURL=animatedValue.d.ts.map

package/dist/client/animation/animatedValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animatedValue.d.ts","sourceRoot":"","sources":["../../../src/client/animation/animatedValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,eAAO,MAAM,eAAe;yBACd,MAAM;0BACL,MAAM;yBACP,MAAM;4BACH,MAAM;+BAEH,MAAM;+BAEN,MAAM;+BAEN,MAAM;uBAEd,MAAM;CACiC,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxD,2DAA2D;IAC3D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kDAAkD;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,IAAI,IAAI,IAAI,CAAC;IACb,yDAAyD;IACzD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC1D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA6GrE;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAWlE"}
+{"version":3,"file":"animatedValue.d.ts","sourceRoot":"","sources":["../../../src/client/animation/animatedValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,eAAO,MAAM,eAAe;yBACd,MAAM;0BACL,MAAM;yBACP,MAAM;4BACH,MAAM;+BAEH,MAAM;+BAEN,MAAM;+BAEN,MAAM;uBAEd,MAAM;CACiC,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxD,2DAA2D;IAC3D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kDAAkD;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,IAAI,IAAI,IAAI,CAAC;IACb,yDAAyD;IACzD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC1D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA6GrE;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAWlE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,CAe/E"}

package/dist/client/animation/animatedValue.js

@@ -107,7 +107,7 @@ export function createAnimatedValue(initial) {
     };
     return ref;
 }
-import { useEffect, useRef } from 'react';
+import { useEffect, useRef, useState } from 'react';
 export function useAnimatedValue(initial) {
     const ref = useRef(null);
     if (!ref.current) {
@@ -120,4 +120,22 @@ export function useAnimatedValue(initial) {
     }, []);
     return ref.current;
 }
+/**
+ * Hook to track an animated value and trigger re-renders.
+ * Use this when you need React to re-render on animation updates.
+ */
+export function useAnimatedValueTracker(animatedValue) {
+    const [, forceUpdate] = useState({});
+    const valueRef = useRef(animatedValue.current);
+    useEffect(() => {
+        const unsubscribe = animatedValue.subscribe((value) => {
+            if (value !== valueRef.current) {
+                valueRef.current = value;
+                forceUpdate({});
+            }
+        });
+        return unsubscribe;
+    }, [animatedValue]);
+    return valueRef.current;
+}
 //# sourceMappingURL=animatedValue.js.map

package/dist/client/animation/animatedValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"animatedValue.js","sourceRoot":"","sources":["../../../src/client/animation/animatedValue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"animatedValue.js","sourceRoot":"","sources":["../../../src/client/animation/animatedValue.ts"],"names":[],"mappings":"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"}

package/dist/client/animation/useAnimatedTransition.d.ts

@@ -0,0 +1,92 @@
+import { AnimatedValueRef, AnimConfig } from './animatedValue.js';
+export type TransitionPhase = 'enter' | 'update' | 'leave';
+export interface TransitionItem<T> {
+    /** The original item */
+    item: T;
+    /** Unique key for this item */
+    key: string | number;
+    /** Current animation phase */
+    phase: TransitionPhase;
+    /** Animated value (0 = exited, 1 = entered) */
+    value: AnimatedValueRef;
+}
+export interface TransitionConfig extends AnimConfig {
+    /** Delay before starting enter animation (ms) */
+    enterDelay?: number;
+    /** Delay before starting leave animation (ms) */
+    leaveDelay?: number;
+    /** Initial value for entering items (default: 0) */
+    from?: number;
+    /** Target value for entered items (default: 1) */
+    to?: number;
+}
+/**
+ * Hook for animating items as they enter and leave.
+ * Similar to react-spring's useTransition but simplified.
+ *
+ * @param items - Array of items to animate
+ * @param keyExtractor - Function to get unique key for each item
+ * @param config - Animation configuration
+ * @returns Array of TransitionItems with animation state
+ *
+ * @example
+ * ```tsx
+ * const items = ['a', 'b', 'c'];
+ * const transitions = useAnimatedTransition(
+ *   items,
+ *   item => item,
+ *   { duration: 300 }
+ * );
+ *
+ * return (
+ *   <>
+ *     {transitions.map(({ item, key, value }) => (
+ *       <Animated.div
+ *         key={key}
+ *         style={{
+ *           opacity: value,
+ *           transform: value.to(v => `translateY(${(1 - v) * 20}px)`),
+ *         }}
+ *       >
+ *         {item}
+ *       </Animated.div>
+ *     ))}
+ *   </>
+ * );
+ * ```
+ */
+export declare function useAnimatedTransition<T>(items: T[], keyExtractor: (item: T) => string | number, config?: TransitionConfig): TransitionItem<T>[];
+/**
+ * Wrapper component for a single animated transition item.
+ * This component owns the animated value for proper React lifecycle.
+ */
+export declare function TransitionItemWrapper<T>({ item, phase, config, children, }: {
+    item: T;
+    phase: TransitionPhase;
+    config?: TransitionConfig;
+    children: (value: AnimatedValueRef, item: T, phase: TransitionPhase) => React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Simplified hook for single item mount/unmount animation.
+ * Use this when you just need to animate a single element in/out.
+ *
+ * @param show - Whether the item should be visible
+ * @param config - Animation configuration
+ * @returns Object with `visible` (whether to render), `value` (animated 0-1)
+ *
+ * @example
+ * ```tsx
+ * const { visible, value } = useAnimatedPresence(isOpen, { duration: 200 });
+ *
+ * return visible ? (
+ *   <Animated.div style={{ opacity: value }}>
+ *     Content
+ *   </Animated.div>
+ * ) : null;
+ * ```
+ */
+export declare function useAnimatedPresence(show: boolean, config?: TransitionConfig): {
+    visible: boolean;
+    value: AnimatedValueRef;
+};
+//# sourceMappingURL=useAnimatedTransition.d.ts.map

package/dist/client/animation/useAnimatedTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedTransition.d.ts","sourceRoot":"","sources":["../../../src/client/animation/useAnimatedTransition.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,UAAU,EAGX,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,wBAAwB;IACxB,IAAI,EAAE,CAAC,CAAC;IACR,+BAA+B;IAC/B,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,8BAA8B;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,EAC1C,MAAM,CAAC,EAAE,gBAAgB,GACxB,cAAc,CAAC,CAAC,CAAC,EAAE,CAqIrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,EACvC,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,CACR,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,eAAe,KACnB,KAAK,CAAC,SAAS,CAAC;CACtB,2CAsBA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,gBAAgB,GACxB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAmC/C"}

package/dist/client/animation/useAnimatedTransition.js

@@ -0,0 +1,235 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { easingFunctions, useAnimatedValue, } from './animatedValue.js';
+/**
+ * Hook for animating items as they enter and leave.
+ * Similar to react-spring's useTransition but simplified.
+ *
+ * @param items - Array of items to animate
+ * @param keyExtractor - Function to get unique key for each item
+ * @param config - Animation configuration
+ * @returns Array of TransitionItems with animation state
+ *
+ * @example
+ * ```tsx
+ * const items = ['a', 'b', 'c'];
+ * const transitions = useAnimatedTransition(
+ *   items,
+ *   item => item,
+ *   { duration: 300 }
+ * );
+ *
+ * return (
+ *   <>
+ *     {transitions.map(({ item, key, value }) => (
+ *       <Animated.div
+ *         key={key}
+ *         style={{
+ *           opacity: value,
+ *           transform: value.to(v => `translateY(${(1 - v) * 20}px)`),
+ *         }}
+ *       >
+ *         {item}
+ *       </Animated.div>
+ *     ))}
+ *   </>
+ * );
+ * ```
+ */
+export function useAnimatedTransition(items, keyExtractor, config) {
+    const duration = config?.duration ?? 300;
+    const easing = config?.easing ?? easingFunctions.springGentle;
+    const enterDelay = config?.enterDelay ?? 0;
+    const leaveDelay = config?.leaveDelay ?? 0;
+    const fromValue = config?.from ?? 0;
+    const toValue = config?.to ?? 1;
+    // Track all active transition items
+    const transitionsRef = useRef(new Map());
+    const [, forceUpdate] = useState({});
+    // Track previous items for comparison
+    const prevItemsRef = useRef([]);
+    // Handle entering, updating, and leaving items
+    useEffect(() => {
+        const prevItems = prevItemsRef.current;
+        const prevKeys = new Set(prevItems.map(keyExtractor));
+        const currentKeys = new Set(items.map(keyExtractor));
+        // Find entering items (in current but not in previous)
+        const enteringKeys = items
+            .map(keyExtractor)
+            .filter((key) => !prevKeys.has(key));
+        // Find leaving items (in previous but not in current)
+        const leavingKeys = prevItems
+            .map(keyExtractor)
+            .filter((key) => !currentKeys.has(key));
+        // Handle entering items
+        enteringKeys.forEach((key, index) => {
+            const item = items.find((i) => keyExtractor(i) === key);
+            const existing = transitionsRef.current.get(key);
+            if (existing) {
+                // Item was leaving but came back - update it
+                existing.item = item;
+                existing.phase = 'enter';
+                setTimeout(() => {
+                    void existing.value.start(toValue, { duration, easing });
+                }, enterDelay + index * 50); // Stagger entering items
+            }
+            else {
+                // New item
+                const transitionItem = {
+                    item,
+                    key,
+                    phase: 'enter',
+                    value: null, // Will be set below
+                };
+                transitionsRef.current.set(key, transitionItem);
+                forceUpdate({});
+            }
+        });
+        // Handle leaving items
+        leavingKeys.forEach((key) => {
+            const existing = transitionsRef.current.get(key);
+            if (existing && existing.phase !== 'leave') {
+                existing.phase = 'leave';
+                setTimeout(() => {
+                    void existing.value
+                        .start(fromValue, { duration, easing })
+                        .then(() => {
+                        // Remove from transitions after leave animation completes
+                        transitionsRef.current.delete(key);
+                        forceUpdate({});
+                    });
+                }, leaveDelay);
+            }
+        });
+        // Update items that stayed
+        items.forEach((item) => {
+            const key = keyExtractor(item);
+            const existing = transitionsRef.current.get(key);
+            if (existing?.phase === 'update') {
+                existing.item = item;
+            }
+            else if (existing?.phase === 'enter') {
+                // Still entering
+                existing.item = item;
+            }
+        });
+        prevItemsRef.current = items;
+    }, [
+        items,
+        keyExtractor,
+        duration,
+        easing,
+        enterDelay,
+        leaveDelay,
+        fromValue,
+        toValue,
+    ]);
+    // Build the result array with proper ordering
+    // Items maintain their order, leaving items go at the end
+    const result = [];
+    // First, add current items in order
+    items.forEach((item) => {
+        const key = keyExtractor(item);
+        let transition = transitionsRef.current.get(key);
+        if (!transition) {
+            // Create new transition item - this is needed on first render
+            transition = {
+                item,
+                key,
+                phase: 'enter',
+                value: null,
+            };
+            transitionsRef.current.set(key, transition);
+        }
+        else {
+            // Update the item reference
+            transition.item = item;
+        }
+        result.push(transition);
+    });
+    // Then add leaving items at the end
+    transitionsRef.current.forEach((transition) => {
+        if (transition.phase === 'leave') {
+            result.push(transition);
+        }
+    });
+    return result;
+}
+/**
+ * Wrapper component for a single animated transition item.
+ * This component owns the animated value for proper React lifecycle.
+ */
+export function TransitionItemWrapper({ item, phase, config, children, }) {
+    const duration = config?.duration ?? 300;
+    const easing = config?.easing ?? easingFunctions.springGentle;
+    const fromValue = config?.from ?? 0;
+    const toValue = config?.to ?? 1;
+    const enterDelay = config?.enterDelay ?? 0;
+    const value = useAnimatedValue(phase === 'enter' ? fromValue : toValue);
+    const hasAnimatedRef = useRef(false);
+    useEffect(() => {
+        if (phase === 'enter' && !hasAnimatedRef.current) {
+            hasAnimatedRef.current = true;
+            setTimeout(() => {
+                void value.start(toValue, { duration, easing });
+            }, enterDelay);
+        }
+        else if (phase === 'leave') {
+            void value.start(fromValue, { duration, easing });
+        }
+    }, [phase, duration, easing, fromValue, toValue, enterDelay, value]);
+    return _jsx(_Fragment, { children: children(value, item, phase) });
+}
+/**
+ * Simplified hook for single item mount/unmount animation.
+ * Use this when you just need to animate a single element in/out.
+ *
+ * @param show - Whether the item should be visible
+ * @param config - Animation configuration
+ * @returns Object with `visible` (whether to render), `value` (animated 0-1)
+ *
+ * @example
+ * ```tsx
+ * const { visible, value } = useAnimatedPresence(isOpen, { duration: 200 });
+ *
+ * return visible ? (
+ *   <Animated.div style={{ opacity: value }}>
+ *     Content
+ *   </Animated.div>
+ * ) : null;
+ * ```
+ */
+export function useAnimatedPresence(show, config) {
+    const duration = config?.duration ?? 300;
+    const easing = config?.easing ?? easingFunctions.springGentle;
+    const fromValue = config?.from ?? 0;
+    const toValue = config?.to ?? 1;
+    const value = useAnimatedValue(show ? toValue : fromValue);
+    const [visible, setVisible] = useState(show);
+    const onRestCallback = useCallback(() => {
+        if (!show) {
+            setVisible(false);
+        }
+        config?.onRest?.();
+    }, [show, config?.onRest]);
+    useEffect(() => {
+        if (show) {
+            setVisible(true);
+            void value.start(toValue, { duration, easing });
+        }
+        else if (visible) {
+            void value.start(fromValue, { duration, easing, onRest: onRestCallback });
+        }
+    }, [
+        show,
+        duration,
+        easing,
+        fromValue,
+        toValue,
+        onRestCallback,
+        value,
+        visible,
+    ]);
+    return { visible, value };
+}
+//# sourceMappingURL=useAnimatedTransition.js.map

package/dist/client/animation/useAnimatedTransition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedTransition.js","sourceRoot":"","sources":["../../../src/client/animation/useAnimatedTransition.tsx"],"names":[],"mappings":"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"}

package/dist/client/animation/useScrollAnimation.d.ts

@@ -0,0 +1,32 @@
+export type ScrollAnimationType = 'fadeIn' | 'slideUp' | 'slideDown' | 'slideLeft' | 'slideRight' | 'scale' | 'none';
+export interface ScrollAnimationConfig {
+    /** Animation type to apply */
+    animation?: ScrollAnimationType;
+    /** Delay before animation starts in ms (default: 0) */
+    delay?: number;
+    /** Animation duration in ms (default: 600) */
+    duration?: number;
+    /** Viewport threshold to trigger animation (0-1, default: 0.2) */
+    threshold?: number;
+    /** Only animate once (default: true) */
+    once?: boolean;
+}
+export interface ScrollAnimationStyle {
+    opacity: number;
+    transform: string;
+    transition?: string;
+}
+export declare function useScrollAnimation<T extends HTMLElement = HTMLDivElement>(config?: ScrollAnimationConfig): {
+    ref: import("react").RefObject<T | null>;
+    style: ScrollAnimationStyle;
+    isVisible: boolean;
+    progress: number;
+};
+export declare function useStaggerAnimation(config: {
+    baseDelay?: number;
+    startDelay?: number;
+    animation?: ScrollAnimationType;
+    duration?: number;
+    threshold?: number;
+}): (index: number) => ScrollAnimationConfig;
+//# sourceMappingURL=useScrollAnimation.d.ts.map

package/dist/client/animation/useScrollAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollAnimation.d.ts","sourceRoot":"","sources":["../../../src/client/animation/useScrollAnimation.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc,EACvE,MAAM,GAAE,qBAA0B;;;;;EAiFnC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,WAUW,MAAM,KAAG,qBAAqB,CAQzC"}