@egjs/flicking 4.14.2-beta.2 → 4.16.0-beta.0

package/dist/error/codes.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Error codes of {@link FlickingError}.
+ * @remarks
+ * Each error code represents a specific error condition that can occur during Flicking's lifecycle.
+ * Use these codes to identify and handle errors programmatically.
+ *
+ * For detailed documentation of each error code, see {@link FlickingErrors}.
+ * @example
+ * ```typescript
+ * import {FlickingError, ERROR_CODE} from "@egjs/flicking";
+ *
+ * try {
+ *   flicking.moveTo(999);
+ * } catch (err) {
+ *   if (err instancof FlickingError && err.code === ERROR_CODE.INDEX_OUT_OF_RANGE) {
+ *     console.log(err.message);
+ *   }
+ * }
+ * ```
+ * @public
+ * @see {@link FlickingErrors} for detailed documentation of each error code
+ */
+export declare const CODE: {
+    WRONG_TYPE: 0;
+    ELEMENT_NOT_FOUND: 1;
+    VAL_MUST_NOT_NULL: 2;
+    NOT_ATTACHED_TO_FLICKING: 3;
+    WRONG_OPTION: 4;
+    INDEX_OUT_OF_RANGE: 5;
+    POSITION_NOT_REACHABLE: 6;
+    TRANSFORM_NOT_SUPPORTED: 7;
+    STOP_CALLED_BY_USER: 8;
+    ANIMATION_INTERRUPTED: 9;
+    ANIMATION_ALREADY_PLAYING: 10;
+    NOT_ALLOWED_IN_FRAMEWORK: 11;
+    NOT_INITIALIZED: 12;
+    NO_ACTIVE: 13;
+    NOT_ALLOWED_IN_VIRTUAL: 14;
+};
+/**
+ * Error message generators for {@link FlickingError}.
+ * @remarks
+ * These functions generate human-readable error messages for each error code.
+ * Used internally by Flicking to create {@link FlickingError} instances with
+ * contextual information.
+ * @internal
+ */
+export declare const MESSAGE: {
+    WRONG_TYPE: (wrongVal: any, correctTypes: string[]) => string;
+    ELEMENT_NOT_FOUND: (selector: string) => string;
+    VAL_MUST_NOT_NULL: (val: any, name: string) => string;
+    NOT_ATTACHED_TO_FLICKING: string;
+    WRONG_OPTION: (optionName: string, val: any) => string;
+    INDEX_OUT_OF_RANGE: (val: number, min: number, max: number) => string;
+    POSITION_NOT_REACHABLE: (position: number) => string;
+    TRANSFORM_NOT_SUPPORTED: string;
+    STOP_CALLED_BY_USER: string;
+    ANIMATION_INTERRUPTED: string;
+    ANIMATION_ALREADY_PLAYING: string;
+    NOT_ALLOWED_IN_FRAMEWORK: string;
+    NOT_INITIALIZED: string;
+    NO_ACTIVE: string;
+    NOT_ALLOWED_IN_VIRTUAL: string;
+};
+/**
+ * Alias for {@link CODE}.
+ * @remarks
+ * Exported as `ERROR_CODE` for semantic clarity when importing.
+ * @example
+ * ```typescript
+ * import { ERROR_CODE } from "@egjs/flicking";
+ *
+ * if (err.code === ERROR_CODE.INDEX_OUT_OF_RANGE) {
+ *   // Handle index error
+ * }
+ * ```
+ * @public
+ */
+export { CODE as ERROR_CODE };

package/dist/error/groups.d.ts

@@ -0,0 +1,94 @@
+import { ERROR_CODE } from "./codes";
+/**
+ * Error codes that may be thrown during panel movement operations.
+ * @remarks
+ * These errors can occur when using navigation methods like {@link Flicking.prev},
+ * {@link Flicking.next}, or {@link Flicking.moveTo}.
+ *
+ * Common scenarios:
+ *
+ * - `NOT_INITIALIZED`: Attempting to navigate before Flicking is ready
+ *
+ * - `INDEX_OUT_OF_RANGE`: Target panel index doesn't exist
+ *
+ * - `POSITION_NOT_REACHABLE`: Target camera position is invalid
+ *
+ * - `ANIMATION_INTERRUPTED`: User interaction during animation
+ *
+ * - `ANIMATION_ALREADY_PLAYING`: Starting new animation while one is in progress
+ *
+ * - `STOP_CALLED_BY_USER`: User prevented navigation via `event.stop()`
+ *
+ * - `NO_ACTIVE`: No panels available to navigate
+ */
+export declare type MovementErrors = typeof ERROR_CODE.NOT_INITIALIZED | typeof ERROR_CODE.INDEX_OUT_OF_RANGE | typeof ERROR_CODE.POSITION_NOT_REACHABLE | typeof ERROR_CODE.ANIMATION_INTERRUPTED | typeof ERROR_CODE.ANIMATION_ALREADY_PLAYING | typeof ERROR_CODE.STOP_CALLED_BY_USER | typeof ERROR_CODE.NO_ACTIVE;
+/**
+ * Error codes that may be thrown when manipulating the DOM.
+ * @remarks
+ * These errors can occur when using DOM manipulation methods like
+ * {@link Flicking.insert}, {@link Flicking.append}, {@link Flicking.prepend},
+ * {@link Flicking.replace}, or {@link Flicking.remove}.
+ *
+ * Common scenarios:
+ *
+ * - `NOT_ATTACHED_TO_FLICKING`: Component not properly initialized
+ *
+ * - `ELEMENT_NOT_FOUND`: Invalid CSS selector or element doesn't exist
+ *
+ * - `VAL_MUST_NOT_NULL`: Required parameter is null/undefined
+ *
+ * - `WRONG_TYPE`: Invalid parameter type
+ *
+ * - `INDEX_OUT_OF_RANGE`: Target index doesn't exist
+ *
+ * - `NOT_ALLOWED_IN_FRAMEWORK`: Using DOM methods in React/Vue/Angular
+ *
+ * - `NOT_ALLOWED_IN_VIRTUAL`: Using DOM methods with virtual mode enabled
+ * @public
+ */
+export declare type DOMManipulationErrors = typeof ERROR_CODE.NOT_ATTACHED_TO_FLICKING | typeof ERROR_CODE.ELEMENT_NOT_FOUND | typeof ERROR_CODE.VAL_MUST_NOT_NULL | typeof ERROR_CODE.WRONG_TYPE | typeof ERROR_CODE.INDEX_OUT_OF_RANGE | typeof ERROR_CODE.NOT_ALLOWED_IN_FRAMEWORK | typeof ERROR_CODE.NOT_ALLOWED_IN_VIRTUAL;
+/**
+ * Error codes that may be thrown during Flicking initialization.
+ * @remarks
+ * These errors can occur when creating a new Flicking instance or calling {@link Flicking.init}.
+ *
+ * Common scenarios:
+ *
+ * - `ELEMENT_NOT_FOUND`: Viewport element doesn't exist in DOM
+ *
+ * - `WRONG_OPTION`: Invalid configuration option value
+ *
+ * - `TRANSFORM_NOT_SUPPORTED`: Browser doesn't support CSS transforms (IE8 and below)
+ * @public
+ */
+export declare type InitializationErrors = typeof ERROR_CODE.ELEMENT_NOT_FOUND | typeof ERROR_CODE.WRONG_OPTION | typeof ERROR_CODE.TRANSFORM_NOT_SUPPORTED;
+/**
+ * Error codes that may be thrown during animation updates.
+ * @remarks
+ * These errors can occur when calling {@link Flicking.update} to manually update
+ * the animation state.
+ *
+ * Common scenarios:
+ *
+ * - `NOT_INITIALIZED`: Calling update before Flicking is ready
+ *
+ * - `ANIMATION_INTERRUPTED`: User interrupted the animation during update
+ * @public
+ */
+export declare type AnimationUpdateErrors = typeof ERROR_CODE.NOT_INITIALIZED | typeof ERROR_CODE.ANIMATION_INTERRUPTED;
+/**
+ * Error codes that may be thrown when restoring Flicking status.
+ * @remarks
+ * These errors can occur when using {@link Flicking.setStatus} to restore
+ * a previously saved status (from {@link Flicking.getStatus}).
+ *
+ * Common scenarios:
+ *
+ * - `NOT_INITIALIZED`: Attempting to restore before initialization
+ *
+ * - `INDEX_OUT_OF_RANGE`: Saved status references non-existent panel
+ *
+ * - `POSITION_NOT_REACHABLE`: Saved position is no longer valid
+ * @public
+ */
+export declare type StatusRestoreErrors = typeof ERROR_CODE.NOT_INITIALIZED | typeof ERROR_CODE.INDEX_OUT_OF_RANGE | typeof ERROR_CODE.POSITION_NOT_REACHABLE;

package/dist/error/index.d.ts

@@ -0,0 +1,4 @@
+export { CODE, ERROR_CODE, MESSAGE } from "./codes";
+export { default as FlickingError } from "./FlickingError";
+export * from "./groups";
+export * from "./types";

package/dist/error/types.d.ts

@@ -0,0 +1,516 @@
+/**
+ * Documentation interface for Flicking error codes.
+ * @remarks
+ * This interface provides detailed documentation for each error code.
+ * Each property represents an error code with its numeric value and message signature.
+ * @public
+ * @see {@link ERROR_CODE} for usage in error handling
+ */
+export interface FlickingErrors {
+    /**
+     * Parameter type is wrong.
+     * @remarks
+     * This error occurs when a method receives a parameter with an incorrect type.
+     * Common causes include:
+     *
+     * - Passing a number when a string is expected
+     *
+     * - Passing null/undefined to a required parameter
+     *
+     * - Passing a plain object when a specific instance is needed
+     *
+     * **Solution:** Check the method signature in the documentation and ensure you're passing
+     * the correct type for each parameter.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - passing invalid type to align option
+     * new Flicking("#flicking", { align: 123 });
+     *
+     * // ✅ Correct
+     * new Flicking("#flicking", { align: "center" });
+     * ```
+     */
+    WRONG_TYPE: {
+        code: 0;
+        message: (wrongVal: any, correctTypes: string[]) => string;
+    };
+    /**
+     * Element is not found inside page with the given CSS selector.
+     * @remarks
+     * This error occurs during initialization when Flicking cannot find the specified element in the DOM.
+     * Common causes include:
+     *
+     * - CSS selector doesn't match any element
+     *
+     * - Element hasn't been rendered yet (timing issue)
+     *
+     * - Selector syntax error
+     *
+     * - Script runs before DOM is ready
+     *
+     * **Solution:** Ensure the target element exists in the DOM before creating a Flicking instance.
+     * Use `DOMContentLoaded` event or place your script at the end of the body.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - element doesn't exist
+     * new Flicking("#non-existent");
+     *
+     * // ✅ Correct - check element exists first
+     * if (document.querySelector("#flicking")) {
+     *   new Flicking("#flicking");
+     * }
+     *
+     * // ✅ Or wait for DOM ready
+     * document.addEventListener("DOMContentLoaded", () => {
+     *   new Flicking("#flicking");
+     * });
+     * ```
+     * @see {@link Flicking.constructor}
+     */
+    ELEMENT_NOT_FOUND: {
+        code: 1;
+        message: (selector: string) => string;
+    };
+    /**
+     * Expected non-null value, but given `null` or `undefined`.
+     * @remarks
+     * This error occurs when a required parameter or property is null or undefined.
+     * Common causes include:
+     *
+     * - Passing null/undefined to a required parameter
+     *
+     * - Accessing a property before initialization
+     *
+     * - Using optional chaining incorrectly
+     *
+     * **Solution:** Ensure all required parameters have valid values before calling the method.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - passing null to required parameter
+     * flicking.prepend(null);
+     *
+     * // ✅ Correct
+     * const element = document.createElement("div");
+     * flicking.prepend(element);
+     * ```
+     */
+    VAL_MUST_NOT_NULL: {
+        code: 2;
+        message: (val: any, name: string) => string;
+    };
+    /**
+     * Component is not attached to the Flicking instance.
+     * @remarks
+     * This error occurs when trying to use a Flicking component (Camera, Control, Renderer, etc.)
+     * before it has been properly initialized and attached to a Flicking instance.
+     * This is typically an internal error.
+     *
+     * **Solution:** Ensure the component's `init()` method has been called before using it.
+     * If you're creating custom components, make sure to call `init()` after instantiation.
+     * @example
+     * ```typescript
+     * const camera = new Camera();
+     * // ❌ Wrong - using camera before init
+     * camera.updateRange();
+     *
+     * // ✅ Correct - init first
+     * camera.init(flicking);
+     * camera.updateRange();
+     * ```
+     */
+    NOT_ATTACHED_TO_FLICKING: {
+        code: 3;
+        message: string;
+    };
+    /**
+     * One of the options is wrong.
+     * @remarks
+     * This error occurs when initializing Flicking with invalid option values.
+     * Common causes include:
+     *
+     * - Value is out of valid range
+     *
+     * - Value doesn't match expected enum/literal type
+     *
+     * - Invalid combination of options
+     *
+     * **Solution:** Check the documentation for the specific option and ensure the value
+     * meets all requirements (type, range, valid values, etc.).
+     * @example
+     * ```typescript
+     * // ❌ Wrong - invalid duration value
+     * new Flicking("#flicking", { duration: -100 });
+     *
+     * // ✅ Correct - positive duration
+     * new Flicking("#flicking", { duration: 500 });
+     *
+     * // ❌ Wrong - invalid moveType
+     * new Flicking("#flicking", { moveType: "invalid" });
+     *
+     * // ✅ Correct - use valid moveType
+     * new Flicking("#flicking", { moveType: "snap" });
+     * ```
+     * @see {@link FlickingOptions}
+     */
+    WRONG_OPTION: {
+        code: 4;
+        message: (optionName: string, val: any) => string;
+    };
+    /**
+     * The given index is out of possible range.
+     * @remarks
+     * This error occurs when trying to access a panel with an invalid index.
+     * Common causes include:
+     *
+     * - Index is negative
+     *
+     * - Index is greater than or equal to panel count
+     *
+     * - Trying to access panels when there are none
+     *
+     * **Solution:** Ensure the index is within the valid range [0, panelCount - 1].
+     * Check `flicking.panelCount` before accessing panels by index.
+     * @example
+     * ```typescript
+     * const flicking = new Flicking("#flicking");
+     *
+     * // ❌ Wrong - negative index
+     * flicking.moveTo(-1);
+     *
+     * // ❌ Wrong - index too large
+     * flicking.moveTo(999);
+     *
+     * // ✅ Correct - check valid range first
+     * const targetIndex = 5;
+     * if (targetIndex >= 0 && targetIndex < flicking.panelCount) {
+     *   flicking.moveTo(targetIndex);
+     * }
+     * ```
+     * @see {@link Flicking.moveTo}
+     * @see {@link Flicking.panelCount}
+     */
+    INDEX_OUT_OF_RANGE: {
+        code: 5;
+        message: (val: number, min: number, max: number) => string;
+    };
+    /**
+     * Position parameter is out of possible range.
+     * @remarks
+     * This error occurs when trying to move the camera to an unreachable position.
+     * The valid position range depends on:
+     *
+     * - Number of panels
+     *
+     * - Panel sizes
+     *
+     * - Circular mode setting
+     *
+     * - Bound setting
+     *
+     * **Solution:** Use `camera.range` to check the valid position range before moving.
+     * Alternatively, use index-based methods like `moveTo()` instead of position-based methods.
+     * @example
+     * ```typescript
+     * const flicking = new Flicking("#flicking");
+     *
+     * // ❌ Wrong - position out of range
+     * flicking.control.moveToPosition(99999, 0);
+     *
+     * // ✅ Correct - check range first
+     * const { min, max } = flicking.camera.range;
+     * const targetPos = 500;
+     * if (targetPos >= min && targetPos <= max) {
+     *   flicking.control.moveToPosition(targetPos, 0);
+     * }
+     *
+     * // ✅ Or use index-based method
+     * flicking.moveTo(2);
+     * ```
+     * @see {@link Control.moveToPosition}
+     * @see {@link Camera.range}
+     */
+    POSITION_NOT_REACHABLE: {
+        code: 6;
+        message: (position: number) => string;
+    };
+    /**
+     * CSS `transform` property is not available.
+     * @remarks
+     * This error occurs when initializing Flicking in a browser that doesn't support
+     * CSS transforms (IE8 and below). Flicking requires CSS transform support to function.
+     *
+     * **Solution:** Use a modern browser or polyfill CSS transforms. Alternatively,
+     * display a fallback message for unsupported browsers.
+     * @example
+     * ```typescript
+     * // Check transform support before initialization
+     * const supportsTransform = 'transform' in document.createElement('div').style;
+     *
+     * if (supportsTransform) {
+     *   new Flicking("#flicking");
+     * } else {
+     *   console.error("Your browser doesn't support CSS transforms");
+     * }
+     * ```
+     */
+    TRANSFORM_NOT_SUPPORTED: {
+        code: 7;
+        message: string;
+    };
+    /**
+     * The event's `stop()` method was called by user.
+     * @remarks
+     * This is not an actual error, but a signal that the user intentionally stopped
+     * an operation by calling `event.stop()` in an event handler. This "error" is used
+     * to halt the operation flow.
+     *
+     * Common scenarios:
+     *
+     * - Preventing panel change in `willChange` event
+     *
+     * - Canceling animation in `moveStart` event
+     *
+     * - Conditional navigation based on validation
+     *
+     * **Solution:** This is expected behavior. Catch this error if you need to handle
+     * user-initiated cancellations differently from actual errors.
+     * @example
+     * ```typescript
+     * flicking.on("willChange", e => {
+     *   if (!isValidTransition(e.index)) {
+     *     e.stop();  // This throws STOP_CALLED_BY_USER error
+     *   }
+     * });
+     *
+     * try {
+     *   await flicking.next();
+     * } catch (err) {
+     *   if (err.code === ERROR_CODE.STOP_CALLED_BY_USER) {
+     *     console.log("User prevented navigation");
+     *   }
+     * }
+     * ```
+     * @see {@link WillChangeEvent}
+     * @see {@link WillRestoreEvent}
+     */
+    STOP_CALLED_BY_USER: {
+        code: 8;
+        message: string;
+    };
+    /**
+     * The animation was interrupted by user input.
+     * @remarks
+     * This error occurs when an ongoing animation is interrupted by user interaction
+     * (mouse/touch input) or by calling another animation method.
+     *
+     * Common causes:
+     *
+     * - User starts dragging during animation
+     *
+     * - Calling `moveTo()` while previous `moveTo()` is animating
+     *
+     * - User clicks/touches the viewport during transition
+     *
+     * **Solution:** This is normal behavior and usually doesn't need special handling.
+     * If you need to ensure animation completes, use `interruptable: false` option
+     * or prevent user input during animation.
+     * @example
+     * ```typescript
+     * try {
+     *   await flicking.next();
+     * } catch (err) {
+     *   if (err.code === ERROR_CODE.ANIMATION_INTERRUPTED) {
+     *     console.log("Animation was interrupted");
+     *   }
+     * }
+     *
+     * // Prevent interruption with interruptable option
+     * flicking.next({ interruptable: false });
+     * ```
+     * @see {@link Flicking.next}
+     * @see {@link Flicking.prev}
+     * @see {@link Flicking.moveTo}
+     */
+    ANIMATION_INTERRUPTED: {
+        code: 9;
+        message: string;
+    };
+    /**
+     * An animation is already playing.
+     * @remarks
+     * This error occurs when trying to start a new animation while another animation
+     * is currently in progress, and the new animation is not allowed to interrupt.
+     *
+     * Common causes:
+     *
+     * - Calling `moveTo()` rapidly in succession
+     *
+     * - Using `interruptable: false` option
+     *
+     * - Programmatic navigation during user-initiated animation
+     *
+     * **Solution:** Wait for the current animation to finish, or allow interruption
+     * by not using `interruptable: false` option.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - trying to animate while animation is in progress
+     * flicking.next({ interruptable: false });
+     * flicking.prev();  // Throws ANIMATION_ALREADY_PLAYING
+     *
+     * // ✅ Correct - wait for animation to finish
+     * await flicking.next({ interruptable: false });
+     * await flicking.prev();
+     *
+     * // ✅ Or check if animating
+     * if (!flicking.animating) {
+     *   flicking.next();
+     * }
+     * ```
+     * @see {@link Flicking.animating}
+     */
+    ANIMATION_ALREADY_PLAYING: {
+        code: 10;
+        message: string;
+    };
+    /**
+     * The method is not allowed in framework components.
+     * @remarks
+     * This error occurs when calling methods that manipulate the DOM directly
+     * (like `insert`, `remove`, `replace`) from framework components (React, Vue, Angular).
+     * In frameworks, DOM manipulation should be handled by the framework itself.
+     *
+     * **Solution:** Use the framework's built-in methods to manipulate the component tree.
+     * Let the framework handle panel additions/removals through its reactive system.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - in React component
+     * flicking.append("<div>New Panel</div>");
+     *
+     * // ✅ Correct - use React state
+     * const [panels, setPanels] = useState([...]);
+     * setPanels([...panels, newPanel]);
+     *
+     * // Render with framework
+     * <Flicking>
+     *   {panels.map(panel => <div key={panel.id}>{panel.content}</div>)}
+     * </Flicking>
+     * ```
+     * @see {@link Flicking.insert}
+     * @see {@link Flicking.remove}
+     * @see {@link Flicking.replace}
+     */
+    NOT_ALLOWED_IN_FRAMEWORK: {
+        code: 11;
+        message: string;
+    };
+    /**
+     * Flicking is not initialized yet.
+     * @remarks
+     * This error occurs when calling methods that require Flicking to be fully initialized,
+     * before `init()` has been called or completed.
+     *
+     * Common causes:
+     *
+     * - Calling methods immediately after `new Flicking()` without waiting
+     *
+     * - Using methods before async initialization completes
+     *
+     * - Accessing Flicking instance before mount in frameworks
+     *
+     * **Solution:** Wait for the `ready` event or ensure `init()` has completed
+     * before calling other methods.
+     * @example
+     * ```typescript
+     * const flicking = new Flicking("#flicking");
+     *
+     * // ❌ Wrong - calling before initialization
+     * flicking.next();
+     *
+     * // ✅ Correct - wait for ready event
+     * flicking.on("ready", () => {
+     *   flicking.next();
+     * });
+     *
+     * // ✅ Or use async/await
+     * await flicking.init();
+     * flicking.next();
+     * ```
+     * @see {@link Flicking.init}
+     * @see {@link ReadyEvent}
+     */
+    NOT_INITIALIZED: {
+        code: 12;
+        message: string;
+    };
+    /**
+     * There is no active panel.
+     * @remarks
+     * This error occurs when trying to access or operate on the active panel,
+     * but Flicking has no panels or hasn't selected an active panel yet.
+     *
+     * Common causes:
+     *
+     * - Initializing Flicking with an empty container
+     *
+     * - Removing all panels at runtime
+     *
+     * - Accessing `currentPanel` before initialization
+     *
+     * **Solution:** Ensure Flicking has at least one panel, or check for the
+     * existence of an active panel before accessing it.
+     * @example
+     * ```typescript
+     * // ❌ Wrong - no panels in container
+     * const flicking = new Flicking("#empty-flicking");
+     * console.log(flicking.currentPanel);  // Throws NO_ACTIVE
+     *
+     * // ✅ Correct - check panel count first
+     * if (flicking.panelCount > 0) {
+     *   console.log(flicking.currentPanel);
+     * }
+     *
+     * // ✅ Or use optional chaining
+     * const currentIndex = flicking.currentPanel?.index ?? -1;
+     * ```
+     * @see {@link Flicking.currentPanel}
+     * @see {@link Flicking.panelCount}
+     */
+    NO_ACTIVE: {
+        code: 13;
+        message: string;
+    };
+    /**
+     * The method is not allowed when the virtual option is enabled.
+     * @remarks
+     * This error occurs when calling DOM manipulation methods (`insert`, `remove`, `replace`)
+     * while the `virtual` option is enabled. Virtual mode manages panels differently,
+     * and direct DOM manipulation would break its internal state.
+     *
+     * **Solution:** Use Flicking's `renderPanel` callback to manage panel content in virtual mode,
+     * or disable virtual mode if you need direct DOM manipulation.
+     * @example
+     * ```typescript
+     * const flicking = new Flicking("#flicking", {
+     *   virtual: true
+     * });
+     *
+     * // ❌ Wrong - DOM manipulation in virtual mode
+     * flicking.append("<div>New Panel</div>");
+     *
+     * // ✅ Correct - use renderPanel callback
+     * const flicking = new Flicking("#flicking", {
+     *   virtual: {
+     *     renderPanel: (panel, index) => {
+     *       return `<div>Panel ${index}</div>`;
+     *     }
+     *   }
+     * });
+     * ```
+     * @see {@link Flicking.insert}
+     * @see {@link VirtualManager}
+     */
+    NOT_ALLOWED_IN_VIRTUAL: {
+        code: 14;
+        message: string;
+    };
+}