@egjs/flicking 4.10.5-beta.0 → 4.10.5

package/declaration/type/event.d.ts

@@ -1,88 +1,88 @@
-import { OnChange, OnFinish, OnHold, OnRelease } from "@egjs/axes";
-import { ComponentEvent } from "@egjs/component";
-import Flicking from "../Flicking";
-import Panel from "../core/panel/Panel";
-import { EVENTS, DIRECTION } from "../const/external";
-import { ValueOf } from "../type/internal";
-export declare type ReadyEvent<T extends Flicking = Flicking> = ComponentEvent<{}, typeof EVENTS["READY"], T>;
-export interface BeforeResizeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["BEFORE_RESIZE"], T> {
-    width: number;
-    height: number;
-    element: HTMLElement;
-}
-export interface AfterResizeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["AFTER_RESIZE"], T> {
-    width: number;
-    height: number;
-    prev: {
-        width: number;
-        height: number;
-    };
-    sizeChanged: boolean;
-    element: HTMLElement;
-}
-export interface HoldStartEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["HOLD_START"], T> {
-    axesEvent: OnHold;
-}
-export interface HoldEndEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["HOLD_END"], T> {
-    axesEvent: OnRelease;
-}
-export interface MoveStartEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE_START"], T> {
-    isTrusted: boolean;
-    holding: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-    axesEvent: OnChange;
-}
-export interface MoveEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE"], T> {
-    isTrusted: boolean;
-    holding: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-    axesEvent: OnChange;
-}
-export interface MoveEndEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE_END"], T> {
-    isTrusted: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-    axesEvent: OnFinish;
-}
-export interface WillChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["WILL_CHANGE"], T> {
-    index: number;
-    panel: Panel;
-    isTrusted: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-}
-export interface ChangedEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["CHANGED"], T> {
-    index: number;
-    panel: Panel;
-    prevIndex: number;
-    prevPanel: Panel | null;
-    isTrusted: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-}
-export interface WillRestoreEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["WILL_RESTORE"], T> {
-    index: number;
-    panel: Panel;
-    isTrusted: boolean;
-    direction: ValueOf<typeof DIRECTION>;
-}
-export interface RestoredEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["RESTORED"], T> {
-    isTrusted: boolean;
-}
-export interface SelectEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["SELECT"], T> {
-    index: number;
-    panel: Panel;
-    direction: ValueOf<typeof DIRECTION> | null;
-}
-export interface NeedPanelEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["NEED_PANEL"], T> {
-    direction: Exclude<ValueOf<typeof DIRECTION>, null>;
-}
-export interface VisibleChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["VISIBLE_CHANGE"], T> {
-    added: Panel[];
-    removed: Panel[];
-    visiblePanels: Panel[];
-}
-export interface ReachEdgeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["REACH_EDGE"], T> {
-    direction: ValueOf<typeof DIRECTION>;
-}
-export interface PanelChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["PANEL_CHANGE"], T> {
-    added: Panel[];
-    removed: Panel[];
-}
+import { OnChange, OnFinish, OnHold, OnRelease } from "@egjs/axes";
+import { ComponentEvent } from "@egjs/component";
+import Flicking from "../Flicking";
+import Panel from "../core/panel/Panel";
+import { EVENTS, DIRECTION } from "../const/external";
+import { ValueOf } from "../type/internal";
+export declare type ReadyEvent<T extends Flicking = Flicking> = ComponentEvent<{}, typeof EVENTS["READY"], T>;
+export interface BeforeResizeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["BEFORE_RESIZE"], T> {
+    width: number;
+    height: number;
+    element: HTMLElement;
+}
+export interface AfterResizeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["AFTER_RESIZE"], T> {
+    width: number;
+    height: number;
+    prev: {
+        width: number;
+        height: number;
+    };
+    sizeChanged: boolean;
+    element: HTMLElement;
+}
+export interface HoldStartEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["HOLD_START"], T> {
+    axesEvent: OnHold;
+}
+export interface HoldEndEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["HOLD_END"], T> {
+    axesEvent: OnRelease;
+}
+export interface MoveStartEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE_START"], T> {
+    isTrusted: boolean;
+    holding: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+    axesEvent: OnChange;
+}
+export interface MoveEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE"], T> {
+    isTrusted: boolean;
+    holding: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+    axesEvent: OnChange;
+}
+export interface MoveEndEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["MOVE_END"], T> {
+    isTrusted: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+    axesEvent: OnFinish;
+}
+export interface WillChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["WILL_CHANGE"], T> {
+    index: number;
+    panel: Panel;
+    isTrusted: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+}
+export interface ChangedEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["CHANGED"], T> {
+    index: number;
+    panel: Panel;
+    prevIndex: number;
+    prevPanel: Panel | null;
+    isTrusted: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+}
+export interface WillRestoreEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["WILL_RESTORE"], T> {
+    index: number;
+    panel: Panel;
+    isTrusted: boolean;
+    direction: ValueOf<typeof DIRECTION>;
+}
+export interface RestoredEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["RESTORED"], T> {
+    isTrusted: boolean;
+}
+export interface SelectEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["SELECT"], T> {
+    index: number;
+    panel: Panel;
+    direction: ValueOf<typeof DIRECTION> | null;
+}
+export interface NeedPanelEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["NEED_PANEL"], T> {
+    direction: Exclude<ValueOf<typeof DIRECTION>, null>;
+}
+export interface VisibleChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["VISIBLE_CHANGE"], T> {
+    added: Panel[];
+    removed: Panel[];
+    visiblePanels: Panel[];
+}
+export interface ReachEdgeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["REACH_EDGE"], T> {
+    direction: ValueOf<typeof DIRECTION>;
+}
+export interface PanelChangeEvent<T extends Flicking = Flicking> extends ComponentEvent<{}, typeof EVENTS["PANEL_CHANGE"], T> {
+    added: Panel[];
+    removed: Panel[];
+}

package/declaration/type/external.d.ts

@@ -1,31 +1,31 @@
-import Flicking from "../Flicking";
-import { SnapControlOptions, FreeControlOptions, StrictControlOptions } from "../control";
-import { MOVE_TYPE } from "../const/external";
-import { ValueOf } from "../type/internal";
-export declare type ElementLike = string | HTMLElement;
-export interface Plugin {
-    init(flicking: Flicking): void;
-    destroy(): void;
-    update(flicking: Flicking): void;
-}
-export interface Status {
-    index?: number;
-    position?: {
-        panel: number;
-        progressInPanel: number;
-    };
-    visibleOffset?: number;
-    panels: Array<{
-        index: number;
-        html?: string;
-    }>;
-}
-export declare type MoveTypeOptions<T extends ValueOf<typeof MOVE_TYPE>> = T extends typeof MOVE_TYPE.SNAP ? [T] | [T, Partial<SnapControlOptions>] : T extends typeof MOVE_TYPE.FREE_SCROLL ? [T] | [T, Partial<FreeControlOptions>] : T extends typeof MOVE_TYPE.STRICT ? [T] | [T, Partial<StrictControlOptions>] : [T];
-export interface ControlParams {
-    range: {
-        min: number;
-        max: number;
-    };
-    position: number;
-    circular: boolean;
-}
+import Flicking from "../Flicking";
+import { SnapControlOptions, FreeControlOptions, StrictControlOptions } from "../control";
+import { MOVE_TYPE } from "../const/external";
+import { ValueOf } from "../type/internal";
+export declare type ElementLike = string | HTMLElement;
+export interface Plugin {
+    init(flicking: Flicking): void;
+    destroy(): void;
+    update(flicking: Flicking): void;
+}
+export interface Status {
+    index?: number;
+    position?: {
+        panel: number;
+        progressInPanel: number;
+    };
+    visibleOffset?: number;
+    panels: Array<{
+        index: number;
+        html?: string;
+    }>;
+}
+export declare type MoveTypeOptions<T extends ValueOf<typeof MOVE_TYPE>> = T extends typeof MOVE_TYPE.SNAP ? [T] | [T, Partial<SnapControlOptions>] : T extends typeof MOVE_TYPE.FREE_SCROLL ? [T] | [T, Partial<FreeControlOptions>] : T extends typeof MOVE_TYPE.STRICT ? [T] | [T, Partial<StrictControlOptions>] : [T];
+export interface ControlParams {
+    range: {
+        min: number;
+        max: number;
+    };
+    position: number;
+    circular: boolean;
+}

package/declaration/type/internal.d.ts

@@ -1,13 +1,13 @@
-export declare type ValueOf<T> = T[keyof T];
-export declare type LiteralUnion<T extends U, U = string> = T | (Pick<U, never> & {
-    _?: never;
-});
-export interface ArrayLike<T> {
-    [index: number]: T;
-    length: number;
-}
-export declare type Unique<T, U> = Pick<T, Exclude<keyof T, keyof U>>;
-export declare type MergeObject<T, U> = {
-    [K in keyof T & keyof U]: T[K] extends Record<string, unknown> ? U[K] extends Record<string, unknown> ? Merged<T[K], U[K]> : T[K] : T[K];
-};
-export declare type Merged<From, To> = Unique<From, To> & Unique<To, From> & MergeObject<From, To>;
+export declare type ValueOf<T> = T[keyof T];
+export declare type LiteralUnion<T extends U, U = string> = T | (Pick<U, never> & {
+    _?: never;
+});
+export interface ArrayLike<T> {
+    [index: number]: T;
+    length: number;
+}
+export declare type Unique<T, U> = Pick<T, Exclude<keyof T, keyof U>>;
+export declare type MergeObject<T, U> = {
+    [K in keyof T & keyof U]: T[K] extends Record<string, unknown> ? U[K] extends Record<string, unknown> ? Merged<T[K], U[K]> : T[K] : T[K];
+};
+export declare type Merged<From, To> = Unique<From, To> & Unique<To, From> & MergeObject<From, To>;

package/declaration/utils.d.ts

@@ -1,45 +1,45 @@
-import Flicking, { FlickingOptions } from "./Flicking";
-import { ALIGN, DIRECTION } from "./const/external";
-import { LiteralUnion, Merged, ValueOf } from "./type/internal";
-import { ElementLike } from "./type/external";
-export declare const merge: <From extends object, To extends object>(target: From, ...sources: To[]) => Merged<From, To>;
-export declare const getElement: (el: HTMLElement | string | null, parent?: HTMLElement) => HTMLElement;
-export declare const checkExistence: (value: any, nameOnErrMsg: string) => void;
-export declare const clamp: (x: number, min: number, max: number) => number;
-export declare const getFlickingAttached: (val: Flicking | null) => Flicking;
-export declare const toArray: <T>(iterable: ArrayLike<T>) => T[];
-export declare const parseAlign: (align: LiteralUnion<ValueOf<typeof ALIGN>> | number, size: number) => number;
-export declare const parseBounce: (bounce: FlickingOptions["bounce"], size: number) => number[];
-export declare const parseArithmeticSize: (cssValue: number | string, base: number) => number | null;
-export declare const parseArithmeticExpression: (cssValue: number | string) => {
-    percentage: number;
-    absolute: number;
-} | null;
-export declare const parseCSSSizeValue: (val: string | number) => string;
-export declare const parsePanelAlign: (align: FlickingOptions["align"]) => string | number;
-export declare const getDirection: (start: number, end: number) => ValueOf<typeof DIRECTION>;
-export declare const parseElement: (element: ElementLike | ElementLike[]) => HTMLElement[];
-export declare const getMinusCompensatedIndex: (idx: number, max: number) => number;
-export declare const includes: <T>(array: T[], target: any) => target is T;
-export declare const isString: (val: any) => val is string;
-export declare const circulatePosition: (pos: number, min: number, max: number) => number;
-export declare const find: <T>(array: T[], checker: (val: T) => boolean) => T;
-export declare const findRight: <T>(array: T[], checker: (val: T) => boolean) => T;
-export declare const findIndex: <T>(array: T[], checker: (val: T) => boolean) => number;
-export declare const getProgress: (pos: number, prev: number, next: number) => number;
-export declare const getStyle: (el: HTMLElement) => CSSStyleDeclaration;
-export declare const setSize: (el: HTMLElement, { width, height }: Partial<{
-    width: number | string;
-    height: number | string;
-}>) => void;
-export declare const isBetween: (val: number, min: number, max: number) => boolean;
-export declare const circulateIndex: (index: number, max: number) => number;
-export declare const range: (end: number) => number[];
-export declare const getElementSize: ({ el, horizontal, useFractionalSize, useOffset, style }: {
-    el: HTMLElement;
-    horizontal: boolean;
-    useFractionalSize: boolean;
-    useOffset: boolean;
-    style: CSSStyleDeclaration;
-}) => number;
-export declare const setPrototypeOf: (o: any, proto: object) => any;
+import Flicking, { FlickingOptions } from "./Flicking";
+import { ALIGN, DIRECTION } from "./const/external";
+import { LiteralUnion, Merged, ValueOf } from "./type/internal";
+import { ElementLike } from "./type/external";
+export declare const merge: <From extends object, To extends object>(target: From, ...sources: To[]) => Merged<From, To>;
+export declare const getElement: (el: HTMLElement | string | null, parent?: HTMLElement) => HTMLElement;
+export declare const checkExistence: (value: any, nameOnErrMsg: string) => void;
+export declare const clamp: (x: number, min: number, max: number) => number;
+export declare const getFlickingAttached: (val: Flicking | null) => Flicking;
+export declare const toArray: <T>(iterable: ArrayLike<T>) => T[];
+export declare const parseAlign: (align: LiteralUnion<ValueOf<typeof ALIGN>> | number, size: number) => number;
+export declare const parseBounce: (bounce: FlickingOptions["bounce"], size: number) => number[];
+export declare const parseArithmeticSize: (cssValue: number | string, base: number) => number | null;
+export declare const parseArithmeticExpression: (cssValue: number | string) => {
+    percentage: number;
+    absolute: number;
+} | null;
+export declare const parseCSSSizeValue: (val: string | number) => string;
+export declare const parsePanelAlign: (align: FlickingOptions["align"]) => string | number;
+export declare const getDirection: (start: number, end: number) => ValueOf<typeof DIRECTION>;
+export declare const parseElement: (element: ElementLike | ElementLike[]) => HTMLElement[];
+export declare const getMinusCompensatedIndex: (idx: number, max: number) => number;
+export declare const includes: <T>(array: T[], target: any) => target is T;
+export declare const isString: (val: any) => val is string;
+export declare const circulatePosition: (pos: number, min: number, max: number) => number;
+export declare const find: <T>(array: T[], checker: (val: T) => boolean) => T;
+export declare const findRight: <T>(array: T[], checker: (val: T) => boolean) => T;
+export declare const findIndex: <T>(array: T[], checker: (val: T) => boolean) => number;
+export declare const getProgress: (pos: number, prev: number, next: number) => number;
+export declare const getStyle: (el: HTMLElement) => CSSStyleDeclaration;
+export declare const setSize: (el: HTMLElement, { width, height }: Partial<{
+    width: number | string;
+    height: number | string;
+}>) => void;
+export declare const isBetween: (val: number, min: number, max: number) => boolean;
+export declare const circulateIndex: (index: number, max: number) => number;
+export declare const range: (end: number) => number[];
+export declare const getElementSize: ({ el, horizontal, useFractionalSize, useOffset, style }: {
+    el: HTMLElement;
+    horizontal: boolean;
+    useFractionalSize: boolean;
+    useOffset: boolean;
+    style: CSSStyleDeclaration;
+}) => number;
+export declare const setPrototypeOf: (o: any, proto: object) => any;

package/dist/flicking.esm.js

@@ -4,7 +4,7 @@ name: @egjs/flicking
 license: MIT
 author: NAVER Corp.
 repository: https://github.com/naver/egjs-flicking
-version: 4.10.5-beta.0
+version: 4.10.5
 */
 import Component, { ComponentEvent } from '@egjs/component';
 import Axes, { PanInput } from '@egjs/axes';
@@ -667,7 +667,7 @@ var circulatePosition = function (pos, min, max) {
   if (pos < min) {
     var offset = (min - pos) % size;
     pos = max - offset;
-  } else if (pos >= max) {
+  } else if (pos > max) {
     var offset = (pos - max) % size;
     pos = min + offset;
   }
@@ -3319,8 +3319,8 @@ function (_super) {
       // Move to the adjacent panel
       targetAnchor = this._findAdjacentAnchor(position, posDelta, anchorAtCamera);
     } else {
-      // Restore to active panel
-      return this.moveToPanel(activeAnchor.panel, {
+      // Fallback to nearest panel from current camera
+      return this.moveToPanel(anchorAtCamera.panel, {
         duration: duration,
         axesEvent: axesEvent
       });
@@ -3788,9 +3788,17 @@ function (_super) {
       targetPanel = adjacentAnchor.panel;
       targetPos = adjacentAnchor.position;
     } else {
-      // Restore to active panel
-      targetPos = camera.clampToReachablePosition(activePanel.position);
-      targetPanel = activePanel;
+      // Fallback to nearest panel from current camera
+      var anchorAtCamera = camera.findNearestAnchor(camera.position);
+
+      if (!anchorAtCamera) {
+        return Promise.reject(new FlickingError(MESSAGE.POSITION_NOT_REACHABLE(position), CODE.POSITION_NOT_REACHABLE));
+      }
+
+      return this.moveToPanel(anchorAtCamera.panel, {
+        duration: duration,
+        axesEvent: axesEvent
+      });
     }
 
     this._triggerIndexChangeEvent(targetPanel, position, axesEvent);
@@ -8831,7 +8839,7 @@ function (_super) {
    */
 
 
-  Flicking.VERSION = "4.10.5-beta.0";
+  Flicking.VERSION = "4.10.5";
   return Flicking;
 }(Component);