flemo 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 김종혁
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+<div align="center">
+<img width="64" height="64" alt="logo_gradient_all_blue_hd" src="https://github.com/user-attachments/assets/131c0626-2730-440e-a802-9fe02e9cf37d" />
+
+<h1>Flemo</h1>
+
+**Bring native app-like screen transitions to the web**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Documentation](https://flemo-web.vercel.app/docs) • [Examples](https://https://flemo-web.vercel.app/docs/examples) • [API Reference](https://flemo-web.vercel.app/docs/api)
+
+</div>
+
+## ✨ Features
+
+- 🎬 **Motion-Powered** - Built on Motion for smooth, native-like transitions
+- 🔒 **Type Safe** - Full TypeScript support with automatic route and parameter inference
+- 🎨 **Custom Transitions** - Create your own transitions with simple or advanced APIs
+
+## 📚 Documentation
+
+Visit our [comprehensive documentation](https://flemo-web.vercel.app/) to learn more:
+
+- [**Getting Started**](https://flemo-web.vercel.app/docs/getting-started) - Installation and basic setup
+- [**Core Concepts**](https://flemo-web.vercel.app/docs/concepts) - Understanding transitions, decorators, and screens
+- [**API Reference**](https://flemo-web.vercel.app/docs/api) - Complete API documentation
+- [**Examples**](https://flemo-web.vercel.app/docs/examples) - Real-world examples and patterns
+
+## 🛣️ Roadmap
+
+- **Shared Element Transitions** - Hero animations between pages
+- **Native UI Components** - App bars and navigation components
+- **Advanced Gesture Support** - Enhanced touch interactions
+- **Developer Tools** - Debug and visualize transitions
+
+## 📄 License
+
+MIT © [kimjh96](https://github.com/kimjh96)
+
+---
+
+<div align="center">
+  <sub>Built with ❤️ for the React community</sub>
+</div>

package/dist/Route.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+import { Path } from 'path-to-regexp';
+export interface RegisterRoute {
+}
+export interface RouteProps {
+    path: Path | Path[];
+    element: ReactNode;
+}
+declare function Route({ element }: RouteProps): ReactNode;
+export default Route;

package/dist/Router.d.ts

@@ -0,0 +1,11 @@
+import { PropsWithChildren } from 'react';
+import { Decorator } from './transition/decorator/typing';
+import { TransitionName, Transition } from './transition/typing';
+interface RouterProps {
+    initPath?: string;
+    defaultTransitionName?: TransitionName;
+    transitions?: Transition[];
+    decorators?: Decorator[];
+}
+declare function Router({ children, initPath, defaultTransitionName, transitions, decorators }: PropsWithChildren<RouterProps>): import("react").JSX.Element;
+export default Router;

package/dist/core/TaskManger.d.ts

@@ -0,0 +1,56 @@
+interface TaskResult<T> {
+    success: boolean;
+    error?: Error;
+    result?: T;
+    taskId?: string;
+    timestamp?: number;
+    instanceId?: string;
+}
+type TaskStatus = "PENDING" | "MANUAL_PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "ROLLEDBACK";
+interface Control {
+    manual?: boolean;
+    delay?: number;
+    condition?: () => Promise<boolean>;
+    signal?: string;
+}
+interface Task<T> {
+    id: string;
+    execute: () => Promise<T>;
+    validate?: () => Promise<boolean>;
+    rollback?: () => Promise<void>;
+    control?: Control;
+    timestamp: number;
+    retryCount: number;
+    status: TaskStatus;
+    dependencies: string[];
+    instanceId: string;
+    manualResolver?: {
+        resolve: (value: TaskResult<T>) => void;
+        reject: (error: Error) => void;
+        result: T;
+    };
+}
+declare class TaskManager {
+    private tasks;
+    private readonly instanceId;
+    private isLocked;
+    private currentTaskId;
+    private taskQueue;
+    private signalListeners;
+    private acquireLock;
+    private releaseLock;
+    generateTaskId(): string;
+    emitSignal(signalName: string): void;
+    addTask<T>(execute: () => Promise<T>, options?: {
+        id?: string;
+        validate?: () => Promise<boolean>;
+        rollback?: () => Promise<void>;
+        dependencies?: string[];
+        control?: Control;
+    }): Promise<TaskResult<T>>;
+    resolveTask(taskId: string): Promise<boolean>;
+    resolveAllPending(): Promise<void>;
+    getManualPendingTasks(): Task<unknown>[];
+}
+declare const instance: TaskManager;
+export default instance;

package/dist/history/HistoryListener.d.ts

@@ -0,0 +1,2 @@
+declare function HistoryListener(): null;
+export default HistoryListener;

package/dist/history/store.d.ts

@@ -0,0 +1,16 @@
+import { TransitionName } from '../transition/typing';
+export interface History {
+    id: string;
+    pathname: string;
+    params: object;
+    transitionName: TransitionName;
+}
+interface HistoryStore {
+    index: number;
+    histories: History[];
+    addHistory: (history: History) => void;
+    replaceHistory: (index: number) => void;
+    popHistory: (index: number) => void;
+}
+declare const useHistoryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<HistoryStore>>;
+export default useHistoryStore;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { default as Router } from './Router';
+export { default as Route, type RegisterRoute } from './Route';
+export { default as useNavigate } from './navigate/useNavigate';
+export { default as useStep } from './navigate/useStep';
+export { default as useScreen } from './screen/useScreen';
+export { default as useParams } from './screen/ParamsProvider/useParams';
+export { default as createTransition } from './transition/createTransition';
+export { default as createRawTransition } from './transition/createRawTransition';
+export { default as createDecorator } from './transition/decorator/createDecorator';
+export { default as createRawDecorator } from './transition/decorator/createRawDecorator';
+export { default as Screen } from './screen/Screen';
+export type { TransitionName, RegisterTransition } from './transition/typing';
+export type { DecoratorName, RegisterDecorator } from './transition/decorator/typing';