@mapples/action 0.0.0

package/README.md

@@ -0,0 +1,196 @@
+# @mapples/action
+
+A React Native action management package that provides a centralized way to handle and track user actions throughout your application using RxJS observables.
+
+## Features
+
+- 🎯 **Action Tracking**: Centralized action store using RxJS Subject for reactive action handling
+- 🔒 **Type Safety**: Full TypeScript support with comprehensive type definitions
+- ⚛️ **React Integration**: Seamless integration with React hooks and context
+- 🎁 **Flexible Payload**: Support for custom action payloads and event data
+- 🏗️ **Provider Pattern**: Easy setup with ActionProvider component
+
+## Installation
+
+```bash
+npm install @mapples/action
+# or
+yarn add @mapples/action
+```
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+
+- `react`: ~19.0.0
+- `react-native`: ~0.79.0
+- `rxjs`: For observable functionality
+
+## Usage
+
+### Basic Setup
+
+Wrap your app with the `ActionProvider` to enable action tracking:
+
+```tsx
+import React from 'react';
+import ActionProvider from '@mapples/action';
+
+function App() {
+  const handleAction = (action) => {
+    console.log('Action triggered:', action);
+    // Handle the action (e.g., analytics, logging, state updates)
+  };
+
+  return (
+    <ActionProvider onAction={handleAction}>
+      {/* Your app components */}
+    </ActionProvider>
+  );
+}
+```
+
+### Using the Action Store
+
+Access the action store in your components using the `useActionStore` hook:
+
+```tsx
+import React from 'react';
+import { useActionStore } from '@mapples/action';
+
+function MyComponent() {
+  const actionStore = useActionStore();
+
+  const handleButtonPress = () => {
+    // Emit an action
+    actionStore.next({
+      time: Date.now(),
+      type: 'BUTTON_PRESSED',
+      payload: {
+        data: { buttonId: 'submit' },
+        originalEventData: ['button', 'press'],
+      },
+    });
+  };
+
+  return <button onPress={handleButtonPress}>Submit</button>;
+}
+```
+
+### Action Types
+
+The package provides the following TypeScript interfaces:
+
+```typescript
+interface Action {
+  time: number; // Timestamp when action occurred
+  type?: string; // Action type identifier
+  payload?: ActionPayload; // Optional payload data
+}
+
+interface ActionPayload {
+  originalEventData?: any[]; // Original event data
+  data?: any; // Custom data payload
+}
+```
+
+## API Reference
+
+### ActionProvider
+
+A React context provider that manages the action store and handles action subscriptions.
+
+**Props:**
+
+- `onAction: (action: Action) => void` - Callback function called when an action is emitted
+- `children: ReactNode` - Child components
+
+### useActionStore
+
+A React hook that provides access to the action store.
+
+**Returns:**
+
+- `Subject<Action>` - RxJS Subject for emitting and subscribing to actions
+
+**Example:**
+
+```tsx
+const actionStore = useActionStore();
+
+// Emit an action
+actionStore.next({
+  time: Date.now(),
+  type: 'USER_LOGIN',
+  payload: { data: { userId: '123' } },
+});
+
+// Subscribe to actions (if needed)
+useEffect(() => {
+  const subscription = actionStore.subscribe((action) => {
+    console.log('New action:', action);
+  });
+
+  return () => subscription.unsubscribe();
+}, [actionStore]);
+```
+
+## Advanced Usage
+
+### Custom Action Types
+
+Define custom action types for better type safety:
+
+```tsx
+type CustomActionType =
+  | 'USER_LOGIN'
+  | 'USER_LOGOUT'
+  | 'BUTTON_PRESSED'
+  | 'FORM_SUBMITTED';
+
+interface CustomAction extends Action {
+  type: CustomActionType;
+  payload: {
+    data: any;
+    originalEventData?: any[];
+  };
+}
+```
+
+### Action Middleware
+
+You can create middleware to process actions before they reach the main handler:
+
+```tsx
+function createActionMiddleware(store: Subject<Action>) {
+  return store.pipe(
+    // Add timestamp if missing
+    map((action) => ({
+      ...action,
+      time: action.time || Date.now(),
+    })),
+    // Filter out invalid actions
+    filter((action) => action.type && action.type.length > 0),
+  );
+}
+```
+
+## Best Practices
+
+1. **Consistent Action Types**: Use consistent naming conventions for action types (e.g., `COMPONENT_ACTION` format)
+
+2. **Meaningful Payloads**: Include relevant data in action payloads for better debugging and analytics
+
+3. **Error Handling**: Always handle potential errors in your action handlers
+
+4. **Performance**: Be mindful of action frequency to avoid performance issues
+
+5. **Testing**: Test your action flows to ensure they work as expected
+
+## License
+
+MIT
+
+## Author
+
+Oleksandr Soloviov - [mapples.org](https://mapples.org/people/olek_soloviov)

package/dist/ActionProvider.d.ts

@@ -0,0 +1,35 @@
+import { FC, PropsWithChildren } from 'react';
+import { ActionProviderProps } from './types';
+/**
+ * ActionProvider component that manages the action store and provides it to child components.
+ *
+ * This component:
+ * - Creates and manages an RxJS Subject for action emissions
+ * - Subscribes to actions and calls the provided onAction callback
+ * - Provides the action store to child components via React context
+ * - Automatically cleans up subscriptions when the component unmounts
+ *
+ * @component
+ * @param props - The component props
+ * @param props.children - Child components that will have access to the action store
+ * @param props.onAction - Callback function called whenever an action is emitted
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const handleAction = (action: Action) => {
+ *     console.log('Action received:', action);
+ *     // Handle analytics, logging, etc.
+ *   };
+ *
+ *   return (
+ *     <ActionProvider onAction={handleAction}>
+ *       <MyApp />
+ *     </ActionProvider>
+ *   );
+ * }
+ * ```
+ */
+declare const ActionProvider: FC<PropsWithChildren<ActionProviderProps>>;
+export default ActionProvider;
+//# sourceMappingURL=ActionProvider.d.ts.map

package/dist/ActionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionProvider.d.ts","sourceRoot":"","sources":["../src/ActionProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAqB,MAAM,OAAO,CAAC;AAMjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,cAAc,EAAE,EAAE,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAkB9D,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/ActionProvider.js

@@ -0,0 +1,47 @@
+import { useEffect, useRef } from 'react';
+import { Subject } from 'rxjs';
+import { ActionContextProvider } from './context';
+/**
+ * ActionProvider component that manages the action store and provides it to child components.
+ *
+ * This component:
+ * - Creates and manages an RxJS Subject for action emissions
+ * - Subscribes to actions and calls the provided onAction callback
+ * - Provides the action store to child components via React context
+ * - Automatically cleans up subscriptions when the component unmounts
+ *
+ * @component
+ * @param props - The component props
+ * @param props.children - Child components that will have access to the action store
+ * @param props.onAction - Callback function called whenever an action is emitted
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const handleAction = (action: Action) => {
+ *     console.log('Action received:', action);
+ *     // Handle analytics, logging, etc.
+ *   };
+ *
+ *   return (
+ *     <ActionProvider onAction={handleAction}>
+ *       <MyApp />
+ *     </ActionProvider>
+ *   );
+ * }
+ * ```
+ */
+const ActionProvider = ({ children, onAction, }) => {
+    const ActionStore = useRef(new Subject());
+    useEffect(() => {
+        const subscription = ActionStore.current.subscribe(onAction);
+        return () => {
+            return subscription.unsubscribe();
+        };
+    }, [onAction]);
+    return (<ActionContextProvider value={{ actionStore: ActionStore.current }}>
+      {children}
+    </ActionContextProvider>);
+};
+export default ActionProvider;
+//# sourceMappingURL=ActionProvider.js.map

package/dist/ActionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionProvider.js","sourceRoot":"","sources":["../src/ActionProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyB,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGjE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,cAAc,GAA+C,CAAC,EAClE,QAAQ,EACR,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,OAAO,EAAU,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7D,OAAO,GAAG,EAAE;YACV,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,CACL,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CACjE;MAAA,CAAC,QAAQ,CACX;IAAA,EAAE,qBAAqB,CAAC,CACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,18 @@
+import { ActionContextType } from './types';
+/**
+ * React context for managing action store throughout the application.
+ * This context provides access to the RxJS Subject that handles action emissions and subscriptions.
+ *
+ * @constant ActionContext
+ */
+declare const ActionContext: import("react").Context<ActionContextType>;
+/**
+ * Provider component for the Action context.
+ * This is the actual React context provider that should be used to wrap components
+ * that need access to the action store.
+ *
+ * @constant ActionContextProvider
+ */
+export declare const ActionContextProvider: import("react").Provider<ActionContextType>;
+export default ActionContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,QAAA,MAAM,aAAa,4CAEjB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,6CAAyB,CAAC;AAE5D,eAAe,aAAa,CAAC"}

package/dist/context.js

@@ -0,0 +1,21 @@
+import { createContext } from 'react';
+import { Subject } from 'rxjs';
+/**
+ * React context for managing action store throughout the application.
+ * This context provides access to the RxJS Subject that handles action emissions and subscriptions.
+ *
+ * @constant ActionContext
+ */
+const ActionContext = createContext({
+    actionStore: new Subject(),
+});
+/**
+ * Provider component for the Action context.
+ * This is the actual React context provider that should be used to wrap components
+ * that need access to the action store.
+ *
+ * @constant ActionContextProvider
+ */
+export const ActionContextProvider = ActionContext.Provider;
+export default ActionContext;
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,aAAa,GAAG,aAAa,CAAoB;IACrD,WAAW,EAAE,IAAI,OAAO,EAAE;CAC3B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,QAAQ,CAAC;AAE5D,eAAe,aAAa,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+import useActionStore from './useActionStore';
+export { useActionStore };
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+import useActionStore from './useActionStore';
+export { useActionStore };
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/useActionStore.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Hook that provides access to the action store from the Action context.
+ *
+ * This hook allows components to:
+ * - Emit new actions using `actionStore.next(action)`
+ * - Subscribe to actions using `actionStore.subscribe(callback)`
+ * - Access the RxJS Subject for advanced reactive operations
+ *
+ * @returns {Subject<Action>} The RxJS Subject that manages action emissions and subscriptions
+ *
+ * @throws {Error} Throws an error if used outside of an ActionProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const actionStore = useActionStore();
+ *
+ *   const handleButtonPress = () => {
+ *     // Emit an action
+ *     actionStore.next({
+ *       time: Date.now(),
+ *       type: 'BUTTON_PRESSED',
+ *       payload: {
+ *         data: { buttonId: 'submit' }
+ *       }
+ *     });
+ *   };
+ *
+ *   return <button onPress={handleButtonPress}>Submit</button>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * function ActionLogger() {
+ *   const actionStore = useActionStore();
+ *
+ *   useEffect(() => {
+ *     const subscription = actionStore.subscribe(action => {
+ *       console.log('Action logged:', action);
+ *     });
+ *
+ *     return () => subscription.unsubscribe();
+ *   }, [actionStore]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+declare const useActionStore: () => import("rxjs").Subject<import("@mapples/types").Action>;
+export default useActionStore;
+//# sourceMappingURL=useActionStore.d.ts.map

package/dist/hooks/useActionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionStore.d.ts","sourceRoot":"","sources":["../../src/hooks/useActionStore.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,QAAA,MAAM,cAAc,+DAInB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/hooks/useActionStore.js

@@ -0,0 +1,57 @@
+import { useContext } from 'react';
+import ActionContext from '../context';
+/**
+ * Hook that provides access to the action store from the Action context.
+ *
+ * This hook allows components to:
+ * - Emit new actions using `actionStore.next(action)`
+ * - Subscribe to actions using `actionStore.subscribe(callback)`
+ * - Access the RxJS Subject for advanced reactive operations
+ *
+ * @returns {Subject<Action>} The RxJS Subject that manages action emissions and subscriptions
+ *
+ * @throws {Error} Throws an error if used outside of an ActionProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const actionStore = useActionStore();
+ *
+ *   const handleButtonPress = () => {
+ *     // Emit an action
+ *     actionStore.next({
+ *       time: Date.now(),
+ *       type: 'BUTTON_PRESSED',
+ *       payload: {
+ *         data: { buttonId: 'submit' }
+ *       }
+ *     });
+ *   };
+ *
+ *   return <button onPress={handleButtonPress}>Submit</button>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * function ActionLogger() {
+ *   const actionStore = useActionStore();
+ *
+ *   useEffect(() => {
+ *     const subscription = actionStore.subscribe(action => {
+ *       console.log('Action logged:', action);
+ *     });
+ *
+ *     return () => subscription.unsubscribe();
+ *   }, [actionStore]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+const useActionStore = () => {
+    const { actionStore } = useContext(ActionContext);
+    return actionStore;
+};
+export default useActionStore;
+//# sourceMappingURL=useActionStore.js.map

package/dist/hooks/useActionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionStore.js","sourceRoot":"","sources":["../../src/hooks/useActionStore.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,aAAa,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAElD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import ActionProvider from './ActionProvider';
+/**
+ * @fileoverview Main entry point for the @mapples/action package.
+ *
+ * This package provides a centralized action management system for React Native applications
+ * using RxJS observables. It allows you to track user actions, handle analytics, and manage
+ * application state through a reactive action store.
+ *
+ * @packageDocumentation
+ */
+export * from './types';
+export * from './hooks';
+/**
+ * Default export: ActionProvider component
+ *
+ * The main component that should be used to wrap your application or specific parts
+ * that need action tracking capabilities.
+ *
+ * @example
+ * ```tsx
+ * import ActionProvider from '@mapples/action';
+ *
+ * function App() {
+ *   return (
+ *     <ActionProvider onAction={(action) => console.log(action)}>
+ *       <YourApp />
+ *     </ActionProvider>
+ *   );
+ * }
+ * ```
+ */
+export default ActionProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;GAQG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import ActionProvider from './ActionProvider';
+/**
+ * @fileoverview Main entry point for the @mapples/action package.
+ *
+ * This package provides a centralized action management system for React Native applications
+ * using RxJS observables. It allows you to track user actions, handle analytics, and manage
+ * application state through a reactive action store.
+ *
+ * @packageDocumentation
+ */
+// Export all types for external use
+export * from './types';
+// Export all hooks for external use
+export * from './hooks';
+/**
+ * Default export: ActionProvider component
+ *
+ * The main component that should be used to wrap your application or specific parts
+ * that need action tracking capabilities.
+ *
+ * @example
+ * ```tsx
+ * import ActionProvider from '@mapples/action';
+ *
+ * function App() {
+ *   return (
+ *     <ActionProvider onAction={(action) => console.log(action)}>
+ *       <YourApp />
+ *     </ActionProvider>
+ *   );
+ * }
+ * ```
+ */
+export default ActionProvider;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;GAQG;AAEH,oCAAoC;AACpC,cAAc,SAAS,CAAC;AAExB,oCAAoC;AACpC,cAAc,SAAS,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAe,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import { Action } from '@mapples/types';
+import { Subject } from 'rxjs';
+/**
+ * Context type for the Action context provider.
+ * Contains the RxJS Subject that manages action emissions and subscriptions.
+ *
+ * @interface ActionContextType
+ */
+export interface ActionContextType {
+    /** RxJS Subject for emitting and subscribing to actions */
+    actionStore: Subject<Action>;
+}
+/**
+ * Props for the ActionProvider component.
+ *
+ * @interface ActionProviderProps
+ */
+export interface ActionProviderProps {
+    /** Callback function that will be called whenever an action is emitted */
+    onAction?: (action: Action) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC"}

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@mapples/action",
+  "version": "0.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "author": {
+    "name": "Oleksandr Soloviov",
+    "url": "https://mapples.org/people/olek_soloviov"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapplesorg/mapples-open-kit.git",
+    "directory": "packages/@mapples/action"
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0 <20.0.0",
+    "react-native": ">=0.71.0"
+  },
+  "devDependencies": {
+    "@types/react": "~19.0.10",
+    "typescript": "~5.8.3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ]
+}