@flemo/core 1.0.0

package/dist/navigate/__tests__/selfPopGuard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/navigate/selfPopGuard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Marks that flemo itself is about to call `window.history.back()`. The
+ * `popstate` it produces is then consumed by `consumeSelfInducedPop` so the
+ * popstate listener doesn't re-process a pop the navigation queue already owns.
+ */
+export declare function markSelfInducedPop(): void;
+/**
+ * Returns `true` once for each prior `markSelfInducedPop` call, balancing
+ * flemo-initiated `history.back()` calls against incoming `popstate` events.
+ * A genuine browser back/forward press is the event that overflows the count.
+ */
+export declare function consumeSelfInducedPop(): boolean;

package/dist/navigate/store.d.ts

@@ -0,0 +1,9 @@
+export type NavigateStatus = "IDLE" | "PUSHING" | "REPLACING" | "POPPING" | "COMPLETED";
+interface NavigateStore {
+    status: NavigateStatus;
+    transitionTaskId: string | null;
+    setStatus: (status: NavigateStatus) => void;
+    setTransitionTaskId: (transitionTaskId: string | null) => void;
+}
+declare const useNavigateStore: import('zustand').UseBoundStore<import('zustand').StoreApi<NavigateStore>>;
+export default useNavigateStore;

package/dist/transition/__tests__/compileTransitionStyles.test.d.ts

@@ -0,0 +1,7 @@
+declare module '../typing' {
+    interface RegisterTransition {
+        "custom-fade-blur": "custom-fade-blur";
+        "custom-slide-fade": "custom-slide-fade";
+    }
+}
+export {};

package/dist/transition/compileTransitionStyles.d.ts

@@ -0,0 +1,13 @@
+import { AnimationOptions, InitialTarget } from './cssTypes';
+import { Transition, TransitionVariant, TransitionVariantValue } from './typing';
+import { Decorator } from './decorator/typing';
+export type CssDecl = {
+    property: string;
+    value: string;
+};
+export declare const collectAnimatedProperties: (transition: Transition) => string[];
+export declare const targetToDecls: (target: TransitionVariantValue["value"] | InitialTarget) => CssDecl[];
+export declare const easingToCss: (ease: AnimationOptions["ease"] | undefined) => string;
+export declare const animationName: (scope: "screen" | "decorator", name: string, variant: TransitionVariant) => string;
+export declare const compileTransitionStyles: (transitions: Iterable<Transition>, decorators: Iterable<Decorator>) => string;
+export declare const variantHasAnimation: (transitionLike: Pick<Transition, "initial" | "variants">, variant: TransitionVariant) => boolean;

package/dist/transition/createRawTransition.d.ts

@@ -0,0 +1,18 @@
+import { InitialTarget } from './cssTypes';
+import { TransitionOptions, Transition, TransitionVariantValue, TransitionName } from './typing';
+interface CreateRawTransitionProps {
+    name: TransitionName;
+    initial: InitialTarget;
+    idle: TransitionVariantValue;
+    pushOnEnter: TransitionVariantValue;
+    pushOnExit: TransitionVariantValue;
+    replaceOnEnter: TransitionVariantValue;
+    replaceOnExit: TransitionVariantValue;
+    popOnEnter: TransitionVariantValue;
+    popOnExit: TransitionVariantValue;
+    completedOnEnter: TransitionVariantValue;
+    completedOnExit: TransitionVariantValue;
+    options?: TransitionOptions;
+}
+export default function createRawTransition({ name, initial, idle, pushOnEnter, pushOnExit, replaceOnEnter, replaceOnExit, popOnEnter, popOnExit, completedOnExit, completedOnEnter, options }: CreateRawTransitionProps): Transition;
+export {};

package/dist/transition/createTransition.d.ts

@@ -0,0 +1,14 @@
+import { InitialTarget } from './cssTypes';
+import { TransitionOptions, Transition, TransitionVariantValue, TransitionName } from './typing';
+interface CreateTransitionProps {
+    name: TransitionName;
+    initial: InitialTarget;
+    idle: TransitionVariantValue;
+    enter: TransitionVariantValue;
+    enterBack: TransitionVariantValue;
+    exit: TransitionVariantValue;
+    exitBack: TransitionVariantValue;
+    options?: TransitionOptions;
+}
+export default function createTransition({ name, initial, idle, enter, enterBack, exit, exitBack, options }: CreateTransitionProps): Transition;
+export {};

package/dist/transition/cssTypes.d.ts

@@ -0,0 +1,22 @@
+export type AnimationEasing = string | readonly [number, number, number, number] | [number, number, number, number];
+export interface AnimationOptions {
+    duration?: number;
+    ease?: AnimationEasing;
+    delay?: number;
+}
+export interface TransitionTarget {
+    x?: string | number;
+    y?: string | number;
+    z?: string | number;
+    scale?: string | number;
+    scaleX?: string | number;
+    scaleY?: string | number;
+    rotate?: string | number;
+    rotateX?: string | number;
+    rotateY?: string | number;
+    rotateZ?: string | number;
+    opacity?: number | string;
+    backgroundColor?: string;
+    [key: string]: string | number | undefined;
+}
+export type InitialTarget = TransitionTarget;

package/dist/transition/cupertino.d.ts

@@ -0,0 +1,2 @@
+declare const cupertino: import('./typing').Transition;
+export default cupertino;

package/dist/transition/decorator/createDecorator.d.ts

@@ -0,0 +1,12 @@
+import { InitialTarget } from '../cssTypes';
+import { TransitionVariantValue } from '../typing';
+import { DecoratorName, Decorator, DecoratorOptions } from './typing';
+interface CreateDecoratorProps {
+    name: DecoratorName;
+    initial: InitialTarget;
+    enter: TransitionVariantValue;
+    exit: TransitionVariantValue;
+    options?: DecoratorOptions;
+}
+export default function createDecorator({ name, initial, enter, exit, options }: CreateDecoratorProps): Decorator;
+export {};

package/dist/transition/decorator/createRawDecorator.d.ts

@@ -0,0 +1,19 @@
+import { InitialTarget } from '../cssTypes';
+import { TransitionVariantValue } from '../typing';
+import { DecoratorName, Decorator, DecoratorOptions } from './typing';
+interface CreateRawDecoratorProps {
+    name: DecoratorName;
+    initial: InitialTarget;
+    idle: TransitionVariantValue;
+    pushOnEnter: TransitionVariantValue;
+    pushOnExit: TransitionVariantValue;
+    replaceOnEnter: TransitionVariantValue;
+    replaceOnExit: TransitionVariantValue;
+    popOnEnter: TransitionVariantValue;
+    popOnExit: TransitionVariantValue;
+    completedOnEnter: TransitionVariantValue;
+    completedOnExit: TransitionVariantValue;
+    options?: DecoratorOptions;
+}
+export default function createRawDecorator({ name, initial, idle, pushOnEnter, pushOnExit, replaceOnEnter, replaceOnExit, popOnEnter, popOnExit, completedOnEnter, completedOnExit, options }: CreateRawDecoratorProps): Decorator;
+export {};

package/dist/transition/decorator/decorator.d.ts

@@ -0,0 +1,2 @@
+import { Decorator } from './typing';
+export declare const decoratorMap: Map<"overlay", Decorator>;

package/dist/transition/decorator/overlay.d.ts

@@ -0,0 +1,2 @@
+declare const overlay: import('./typing').Decorator;
+export default overlay;

package/dist/transition/decorator/typing.d.ts

@@ -0,0 +1,24 @@
+import { BaseTransition, SwipeAnimate } from '../typing';
+export interface RegisterDecorator {
+}
+export type DecoratorName = RegisterDecorator[keyof RegisterDecorator] | "overlay";
+export type DecoratorOptions = {
+    onSwipeStart?: (triggered: boolean, options: {
+        animate: SwipeAnimate;
+        currentDecorator: HTMLDivElement;
+        prevDecorator: HTMLDivElement;
+    }) => void;
+    onSwipe?: (triggered: boolean, progress: number, options: {
+        animate: SwipeAnimate;
+        currentDecorator: HTMLDivElement;
+        prevDecorator: HTMLDivElement;
+    }) => void;
+    onSwipeEnd?: (triggered: boolean, options: {
+        animate: SwipeAnimate;
+        currentDecorator: HTMLDivElement;
+        prevDecorator: HTMLDivElement;
+    }) => void;
+};
+export interface Decorator extends Omit<BaseTransition, "name">, DecoratorOptions {
+    name: DecoratorName;
+}

package/dist/transition/layout.d.ts

@@ -0,0 +1,2 @@
+declare const layout: import('./typing').Transition;
+export default layout;

package/dist/transition/material.d.ts

@@ -0,0 +1,2 @@
+declare const material: import('./typing').Transition;
+export default material;

package/dist/transition/none.d.ts

@@ -0,0 +1,2 @@
+declare const none: import('./typing').Transition;
+export default none;

package/dist/transition/store.d.ts

@@ -0,0 +1,7 @@
+import { TransitionName } from './typing';
+interface TransitionStore {
+    defaultTransitionName: TransitionName;
+    setDefaultTransitionName: (defaultTransitionName: TransitionName) => void;
+}
+declare const useTransitionStore: import('zustand').UseBoundStore<import('zustand').StoreApi<TransitionStore>>;
+export default useTransitionStore;

package/dist/transition/transition.d.ts

@@ -0,0 +1,2 @@
+import { TransitionName, Transition } from './typing';
+export declare const transitionMap: Map<TransitionName, Transition>;

package/dist/transition/typing.d.ts

@@ -0,0 +1,61 @@
+import { NavigateStatus } from '../navigate/store';
+import { AnimationOptions, InitialTarget, TransitionTarget } from './cssTypes';
+import { DecoratorName } from './decorator/typing';
+export interface RegisterTransition {
+}
+export type TransitionName = RegisterTransition[keyof RegisterTransition] | "none" | "cupertino" | "material" | "layout";
+export type TransitionVariant = `${NavigateStatus}-${boolean}`;
+export type TransitionVariantValue = {
+    value: TransitionTarget;
+    options: AnimationOptions;
+};
+export interface SwipeInfo {
+    point: {
+        x: number;
+        y: number;
+    };
+    offset: {
+        x: number;
+        y: number;
+    };
+    velocity: {
+        x: number;
+        y: number;
+    };
+    delta: {
+        x: number;
+        y: number;
+    };
+}
+export type SwipeAnimate = (target: HTMLElement, value: TransitionTarget, options?: AnimationOptions) => Promise<void>;
+export type TransitionOptions = {
+    decoratorName?: DecoratorName;
+    swipeDirection: "x" | "y";
+    onSwipeStart: (event: PointerEvent, info: SwipeInfo, options: {
+        animate: SwipeAnimate;
+        currentScreen: HTMLDivElement;
+        prevScreen: HTMLDivElement;
+        onStart?: (triggered: boolean) => void;
+    }) => Promise<boolean>;
+    onSwipe: (event: PointerEvent, info: SwipeInfo, options: {
+        animate: SwipeAnimate;
+        currentScreen: HTMLDivElement;
+        prevScreen: HTMLDivElement;
+        onProgress?: (triggered: boolean, progress: number) => void;
+    }) => number;
+    onSwipeEnd: (event: PointerEvent, info: SwipeInfo, options: {
+        animate: SwipeAnimate;
+        currentScreen: HTMLDivElement;
+        prevScreen: HTMLDivElement;
+        onStart?: (triggered: boolean) => void;
+    }) => Promise<boolean>;
+} | {
+    decoratorName?: DecoratorName;
+    swipeDirection?: never;
+};
+export interface BaseTransition {
+    name: TransitionName;
+    initial: InitialTarget;
+    variants: Record<TransitionVariant, TransitionVariantValue>;
+}
+export type Transition = BaseTransition & TransitionOptions;

package/dist/utils/__tests__/findScrollable.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/__tests__/getMatchedPathPattern.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/__tests__/getParams.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/__tests__/isServer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/findScrollable.d.ts

@@ -0,0 +1,21 @@
+export default function findScrollable(startTarget: EventTarget | null, options?: {
+    direction?: "y" | "x";
+    markerSelector?: string;
+    depthLimit?: number;
+    verifyByScroll?: boolean;
+}): {
+    element: HTMLElement | null;
+    hasMarker: boolean;
+};
+/** Whether the element's content overflows the given axis (sub-pixel safe). */
+export declare function overflowsAxis(element: HTMLElement, direction: "y" | "x"): boolean;
+/**
+ * Whether the element actually scrolls on the given axis.
+ *
+ * Reads `overflowX` / `overflowY` from computed style — fast, read-only,
+ * and free of side effects. The previous implementation probed by writing
+ * to `scrollTop` / `scrollLeft` and reverting, which fired scroll events
+ * and interfered with `scroll-snap` / `scroll-behavior: smooth` consumers
+ * on every pointerdown that flowed through `findScrollable`.
+ */
+export declare function canProgrammaticallyScroll(element: HTMLElement, direction: "y" | "x"): boolean;

package/dist/utils/getMatchedPathPattern.d.ts

@@ -0,0 +1,2 @@
+import { Path } from 'path-to-regexp';
+export default function getMatchedPathPattern(paths: Path | Path[], pathname: string): Path;

package/dist/utils/getParams.d.ts

@@ -0,0 +1,4 @@
+import { Path } from 'path-to-regexp';
+export default function getParams(paths: Path | Path[], path: string, search: string): {
+    [x: string]: string;
+};

package/dist/utils/isServer.d.ts

@@ -0,0 +1 @@
+export default function isServer(): boolean;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@flemo/core",
+  "version": "1.0.0",
+  "description": "Framework-agnostic primitives for flemo: history, navigation, transitions, task manager.",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "flemo",
+    "router",
+    "transition",
+    "framework-agnostic"
+  ],
+  "author": {
+    "name": "kimjh96",
+    "email": "kimjhs@kakao.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kimjh96/flemo.git",
+    "directory": "packages/flemo-core"
+  },
+  "bugs": {
+    "url": "https://github.com/kimjh96/flemo/issues",
+    "email": "kimjhs@kakao.com"
+  },
+  "homepage": "https://flemo-web.vercel.app",
+  "license": "MIT",
+  "dependencies": {
+    "path-to-regexp": "^8.2.0",
+    "zustand": "^5.0.11"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "eslint": "^9.33.0",
+    "jsdom": "^25.0.1",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^2.1.8",
+    "@flemo/eslint-config": "0.0.0",
+    "@flemo/tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "watch": "vite build --watch",
+    "dev": "vite build --watch",
+    "lint": "eslint \"**/*.{js,mjs,ts,jsx,tsx,mts}\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist .turbo"
+  }
+}