vevet 4.4.2 → 5.0.0

package/lib/types/components/Snap/types.d.ts

@@ -0,0 +1,128 @@
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base';
+import { SnapSlide } from './Slide';
+import { TEasingType } from '../../utils/math';
+import { ISnapWheelProps } from './Wheel/types';
+import { ISnapSwipeProps } from './Swipe/types';
+import { ISwipeCoords } from '../Swipe';
+import { ITimelineProgressArg } from '../Timeline';
+/** Static properties for the Snap component */
+export interface ISnapStaticProps extends IModuleStaticProps {
+    /** HTML container element where listeners are attached */
+    container: HTMLElement;
+    /**
+     * Default active index
+     * @default 0
+     */
+    activeIndex?: number;
+}
+/** Mutable properties for the Snap component */
+export interface ISnapMutableProps extends IModuleMutableProps, ISnapWheelProps, ISnapSwipeProps {
+    /**
+     * Slides instances. If `false`, all container's children will be considered as slides.
+     * @default false
+     */
+    slides?: (HTMLElement | SnapSlide)[] | false;
+    /**
+     * Sliding direction
+     * @default 'horizontal'
+     */
+    direction?: 'horizontal' | 'vertical';
+    /**
+     * Centered slides
+     * @default false
+     */
+    centered?: boolean;
+    /**
+     * Detects if need to loop the progress
+     * @default false
+     */
+    loop?: boolean;
+    /**
+     * The gap between slides. Supports css units like `px`, `rem`, `vw`, `vh`, `svh`.
+     * @default 0
+     */
+    gap?: number | string;
+    /**
+     * Linear interpolation factor for smooth coordinates updates.
+     * @default 0.2
+     */
+    lerp?: number;
+    /**
+     * Disables `friction` and snapping to the nearest slide.
+     * @default false
+     */
+    freemode?: boolean;
+    /**
+     * Stick to the nearest slide on window resize
+     * @default true
+     */
+    stickOnResize?: boolean;
+    /**
+     * Friction that makes the slides tend to the nearest slide magnet. The value is a number between 0 and 1
+     * which is multiplied by the `lerp` value.
+     * 0 disables friction
+     * @default 0.15
+     */
+    friction?: number;
+    /**
+     * Maximum friction between the final slide and the maximum translation value.
+     * From 0 to 1. The higher value the more resistance is applied.
+     * @default 0.85
+     */
+    edgeFriction?: number;
+    /**
+     * Change slide duration
+     * @default 500
+     */
+    duration?: TSnapDuration;
+    /**
+     * Easing type for timelines
+     * @default EaseOutCubic
+     */
+    easing?: TEasingType;
+}
+/** Callbacks map for the Snap component */
+export interface ISnapCallbacksMap extends IModuleCallbacksMap {
+    /** Fired on resize */
+    resize: undefined;
+    /** Fired on reflow: staticValues update */
+    reflow: undefined;
+    /** Fired during the rendering process */
+    update: undefined;
+    /** Fired after active slide change */
+    activeSlide: SnapSlide;
+    /** Fired on requestAnimationFrame play */
+    rafPlay?: undefined;
+    /** Fired on requestAnimationFrame pause */
+    rafPause?: undefined;
+    /** Fired on wheel start */
+    wheelStart: undefined;
+    /** Fired on wheel event */
+    wheel: WheelEvent;
+    /** Fired on wheel end */
+    wheelEnd: undefined;
+    /** Fired on swipe start */
+    swipeStart: ISwipeCoords;
+    /** Fired on swipe move */
+    swipe: ISwipeCoords;
+    /** Fired on swipe end */
+    swipeEnd: ISwipeCoords;
+    /** Fired on timeline animation start */
+    timelineStart: undefined;
+    /** Fired on timeline animation update */
+    timelineUpdate: ITimelineProgressArg;
+    /** Fired on timeline animation end */
+    timelineEnd: undefined;
+}
+export type TSnapDuration = number | ((distance: number) => number);
+export interface ISnapMagnet {
+    /** Slide */
+    slide: SnapSlide;
+    /** Magnet coordinate */
+    magnetCoord: number;
+    /** Difference between the magnet coodintate and the current track value */
+    magnetDiff: number;
+    /** Static magnet coordinate (as if the slide was never moved) */
+    staticMagnetCoord: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/components/Snap/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Snap/types.ts"],"names":[],"mappings":"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"}

package/lib/types/components/SplitText/index.d.ts

@@ -1,117 +1,108 @@
-import { Component as ComponentClass } from '../../base/Component';
-import { NSplitText } from './types';
 import { wrapLines } from './utils/wrapLines';
-export type { NSplitText };
+import { ISplitTextCallbacksMap, ISplitTextLetterMeta, ISplitTextLineMeta, ISplitTextMutableProps, ISplitTextStaticProps, ISplitTextWordMeta } from './types';
+import { Module } from '../../base';
+import { TRequiredProps } from '../../internal/requiredProps';
+import { saveInitialNodes } from './utils/saveInitialNodes';
+export * from './types';
 /**
- * SplitText is a component that splits your text into lines, words, and letters so that you can animate them.
- * It supports auto-resizing for lines and styled content when using HTML inside your text.
+ * `SplitText` splits text within a container into individual lines, words, and letters.
  *
- * Inspired by GSAP's SplitText plugin and SplitType.
+ * Features:
+ * - Supports resizing, HTML content, and special symbols like emojis.
+ * - Handles multi-line breaks and non-breaking spaces.
+ * - Saves initial nodes and listeners for easy restoration.
+ * - Allows splitting into lines, words, or letters as needed.
  *
- * P.S. Apply `fontKerning: none` to your container to prevent large layout shifts.
+ * **Note**: Apply `fontKerning: none` to prevent layout shifts.
  *
- * @link See examples https://antonbobrov.github.io/vevet-demo/split-text/
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/SplitText)
  *
- * @link See docs https://antonbobrov.github.io/vevet/classes/SplitText.html
- *
- * @see Performance comparison of splitting your text into words: https://measurethat.net/Benchmarks/Show/31805/0/vevetsplittext-splittype-comparison-words-only
- *
- * @see Performance comparison of splitting your text into words and letters: https://measurethat.net/Benchmarks/Show/31806/0/vevetsplittext-splittype-comparison-words-letters
- *
- * @see Performance comparison of splitting your text into words and lines: https://measurethat.net/Benchmarks/Show/31847/0/vevetsplittext-splittype-comparison-words-lines
+ * @group Components
  */
-export declare class SplitText<StaticProps extends NSplitText.IStaticProps = NSplitText.IStaticProps, ChangeableProps extends NSplitText.IChangeableProps = NSplitText.IChangeableProps, CallbacksTypes extends NSplitText.ICallbacksTypes = NSplitText.ICallbacksTypes> extends ComponentClass<StaticProps, ChangeableProps, CallbacksTypes> {
-    protected _getDefaultProps(): {
-        container: string;
-        hasLetters: boolean;
-        hasLines: boolean;
-        letterTag: string;
-        wordTag: string;
-        lineTag: string;
-        viewportTarget: string;
-        resizeDebounce: number;
-    };
-    get prefix(): string;
+export declare class SplitText<CallbacksMap extends ISplitTextCallbacksMap = ISplitTextCallbacksMap, StaticProps extends ISplitTextStaticProps = ISplitTextStaticProps, MutableProps extends ISplitTextMutableProps = ISplitTextMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
     /**
-     * Class name used for individual letters.
+     * Retrieves the default static properties.
      */
-    get letterClassName(): string;
+    _getStatic(): TRequiredProps<StaticProps>;
     /**
-     * Class name used for individual words.
+     * Retrieves the default mutable properties.
      */
-    get wordClassName(): string;
+    _getMutable(): TRequiredProps<MutableProps>;
     /**
-     * Class name used for individual lines.
+     * Classname prefix for styling elements.
      */
-    get lineClassName(): string;
+    get prefix(): string;
     /**
-     * Initial HTML content of the container before splitting.
+     * Saved initial HTML nodes of the container.
      */
-    protected _initialHTML: string;
+    protected _savedNodes: ReturnType<typeof saveInitialNodes>;
     /**
-     * Tracks if the text has already been split into base elements (words & letters).
+     * Tracks whether the text is already split into base elements: words and letters.
      */
     protected _isBaseSplit: boolean;
     /**
-     * The text container where the split text is stored.
+     * List of letters metadata.
+     */
+    protected _lettersMeta: ISplitTextLetterMeta[];
+    /**
+     * Retrieves an array of letters metadata.
      */
-    protected _container: HTMLElement;
+    get lettersMeta(): ISplitTextLetterMeta[];
     /**
-     * Returns the text container element.
+     * Retrieves an array of letter elements.
      */
-    get container(): HTMLElement;
+    get letters(): HTMLElement[];
     /**
-     * List of letter elements generated after splitting.
+     * List of words metadata.
      */
-    protected _letters: NSplitText.ILetter[];
+    protected _wordsMeta: ISplitTextWordMeta[];
     /**
-     * Returns the list of letter elements.
+     * Retrieves an array of words metadata.
      */
-    get letters(): NSplitText.ILetter[];
+    get wordsMeta(): ISplitTextWordMeta[];
     /**
-     * List of word elements generated after splitting.
+     * Retrieves an array of word elements.
      */
-    protected _words: NSplitText.IWord[];
+    get words(): HTMLElement[];
     /**
-     * Returns the list of word elements.
+     * List of lines metadata.
      */
-    get words(): NSplitText.IWord[];
+    protected _linesMeta: ISplitTextLineMeta[];
     /**
-     * List of line elements generated after splitting.
+     * Retrieves an array of lines metadata.
      */
-    protected _lines: NSplitText.ILine[];
+    get linesMeta(): ISplitTextLineMeta[];
     /**
-     * Returns the list of line elements.
+     * Retrieves an array of line elements.
      */
-    get lines(): NSplitText.ILine[];
+    get lines(): HTMLElement[];
     /**
-     * Result from `wrapLines` utility used to manage the split lines.
-     * @ignore
+     * Utility for wrapping words into line containers.
      */
-    protected _lineWrapper?: ReturnType<typeof wrapLines>;
-    constructor(initialProps: StaticProps & ChangeableProps, canInit?: boolean);
+    protected _lineSplitWrapper?: ReturnType<typeof wrapLines>;
     /**
-     * Initializes the component.
+     * Initializes the SplitText instance and saves the initial state.
      */
-    protected _init(): void;
+    constructor(props?: StaticProps & MutableProps);
     /**
-     * Sets up resize events for the component, allowing it to respond to viewport or container size changes.
+     * Sets up event listeners and handles initial splitting.
      */
-    protected _setResize(): void;
+    protected _setup(): void;
     /**
-     * Splits the text in the container into letters, words, and optionally lines, based on the component properties.
+     * Splits the text into letters, words, and optionally lines based on configuration.
      */
-    splitText(): void;
+    split(): void;
     /**
-     * Splits the text into base elements (letters and words).
+     * Splits text into base elements: letters and words.
      */
-    private _splitBase;
+    protected _splitBase(): void;
     /**
-     * Splits the text into lines by wrapping word elements into line containers.
+     * Wraps words into line containers.
      */
-    protected _splitIntoLines(): void;
+    protected _splitLines(): void;
     /**
-     * Destroys the component, restoring the container to its initial HTML state.
+     * Destroys the component.
+     * This method does not restore the initial nodes. For this purpose, use `restore()`.
      */
     protected _destroy(): void;
 }

package/lib/types/components/SplitText/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/SplitText/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS,CACpB,WAAW,SAAS,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,EACrE,eAAe,SACb,UAAU,CAAC,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,EAC3D,cAAc,SACZ,UAAU,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CACzD,SAAQ,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,SAAS,CAAC,gBAAgB;;;;;;;;;;IAc1B,IAAI,MAAM,WAET;IAED;;OAEG;IACH,IAAI,eAAe,WAElB;IAED;;OAEG;IACH,IAAI,aAAa,WAEhB;IAED;;OAEG;IACH,IAAI,aAAa,WAEhB;IAED;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,YAAY,UAAS;IAE/B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,IAAI,SAAS,gBAEZ;IAED;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;IAEzC;;OAEG;IACH,IAAI,OAAO,yBAEV;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAErC;;OAEG;IACH,IAAI,KAAK,uBAER;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAErC;;OAEG;IACH,IAAI,KAAK,uBAER;IAED;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;gBAE1C,YAAY,EAAE,WAAW,GAAG,eAAe,EAAE,OAAO,UAAO;IAuBvE;;OAEG;IACH,SAAS,CAAC,KAAK;IAMf;;OAEG;IACH,SAAS,CAAC,UAAU;IAqBpB;;OAEG;IACI,SAAS;IAYhB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkClB;;OAEG;IACH,SAAS,CAAC,eAAe;IAqBzB;;OAEG;IACH,SAAS,CAAC,QAAQ;CAKnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/SplitText/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,cAAc,SAAS,CAAC;AAExB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS,CACpB,YAAY,SAAS,sBAAsB,GAAG,sBAAsB,EACpE,WAAW,SAAS,qBAAqB,GAAG,qBAAqB,EACjE,YAAY,SAAS,sBAAsB,GAAG,sBAAsB,CACpE,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD;;OAEG;IACI,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAahD;;OAEG;IACI,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IAIlD;;OAEG;IACH,IAAI,MAAM,WAET;IAED;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,YAAY,UAAS;IAE/B;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,oBAAoB,EAAE,CAAM;IAEpD;;OAEG;IACH,IAAI,WAAW,2BAEd;IAED;;OAEG;IACH,IAAI,OAAO,kBAEV;IAED;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,kBAAkB,EAAE,CAAM;IAEhD;;OAEG;IACH,IAAI,SAAS,yBAEZ;IAED;;OAEG;IACH,IAAI,KAAK,kBAER;IAED;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,kBAAkB,EAAE,CAAM;IAEhD;;OAEG;IACH,IAAI,SAAS,yBAEZ;IAED;;OAEG;IACH,IAAI,KAAK,kBAER;IAED;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;IAE3D;;OAEG;gBACS,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAe9C;;OAEG;IACH,SAAS,CAAC,MAAM;IAsBhB;;OAEG;IACI,KAAK;IAYZ;;OAEG;IACH,SAAS,CAAC,UAAU;IAsBpB;;OAEG;IACH,SAAS,CAAC,WAAW;IAuBrB;;;OAGG;IACH,SAAS,CAAC,QAAQ;CAUnB"}

package/lib/types/components/SplitText/types.d.ts

@@ -1,93 +1,93 @@
-import { NComponent } from '../../base/Component/types';
-import { TOnResizeTarget } from '../../utils/listeners/onResize';
-export declare namespace NSplitText {
-    interface IStaticProps extends NComponent.IStaticProps {
-        /**
-         * The text container where the content will be split.
-         * Can be a CSS selector (string) or an actual HTML element.
-         */
-        container: string | Element;
-        /**
-         * Specifies whether the text should be split into individual letters.
-         * @default true
-         */
-        hasLetters?: boolean;
-        /**
-         * Specifies whether the text should be split into lines.
-         * @default false
-         */
-        hasLines?: boolean;
-        /**
-         * HTML tag to wrap each letter.
-         * @default `span`
-         */
-        letterTag?: keyof HTMLElementTagNameMap;
-        /**
-         * HTML tag to wrap each word.
-         * @default `span`
-         */
-        wordTag?: keyof HTMLElementTagNameMap;
-        /**
-         * HTML tag to wrap each line.
-         * @default `span`
-         */
-        lineTag?: keyof HTMLElementTagNameMap;
-        /**
-         * Determines the viewport target for resizing behavior.
-         * @default 'any'
-         */
-        viewportTarget?: TOnResizeTarget;
-        /**
-         * Debounce timeout for the resize event in milliseconds.
-         * @default 0
-         */
-        resizeDebounce?: number;
-    }
-    interface IChangeableProps extends NComponent.IChangeableProps {
-    }
-    interface ICallbacksTypes extends NComponent.ICallbacksTypes {
-        /**
-         * Fired before the text is split.
-         */
-        beforeSplit: undefined;
-        /**
-         * Fired after the text has been split.
-         */
-        split: undefined;
-    }
-    interface ILine {
-        /**
-         * HTML element representing a single line of split text.
-         */
-        element: HTMLElement;
-        /**
-         * Array of word objects within the line.
-         */
-        words: NSplitText.IWord[];
-    }
-    interface IWord {
-        /**
-         * HTML element representing a single word.
-         */
-        element: HTMLElement;
-        /**
-         * The text content of the word.
-         */
-        text: string;
-        /**
-         * Array of letter objects within the word.
-         */
-        letters: NSplitText.ILetter[];
-    }
-    interface ILetter {
-        /**
-         * HTML element representing a single letter.
-         */
-        element: HTMLElement;
-        /**
-         * The text content of the letter.
-         */
-        text: string;
-    }
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base';
+/** Static properties for the SplitText module */
+export interface ISplitTextStaticProps extends IModuleStaticProps {
+    /**
+     * The text container where the text will be split.
+     */
+    container: HTMLElement;
+    /**
+     * Specifies whether the text should be split into individual letters.
+     * @default false
+     */
+    letters?: boolean;
+    /**
+     * Specifies whether the text should be split into lines.
+     * @default false
+     */
+    lines?: boolean;
+    /**
+     * Specifies whether to wrap each line in an additional container.
+     * @default false
+     */
+    linesWrapper?: boolean;
+    /**
+     * HTML tag to wrap each letter.
+     * @default `span`
+     */
+    letterTag?: keyof HTMLElementTagNameMap;
+    /**
+     * HTML tag to wrap each word.
+     * @default `span`
+     */
+    wordTag?: keyof HTMLElementTagNameMap;
+    /**
+     * HTML tag to wrap each line.
+     * @default `span`
+     */
+    lineTag?: keyof HTMLElementTagNameMap;
+    /**
+     * The debounce delay for the resize event in milliseconds.
+     * @default 0
+     */
+    resizeDebounce?: number;
+}
+/** Mutable properties for the SplitText module */
+export interface ISplitTextMutableProps extends IModuleMutableProps {
+}
+/** Callbacks map for the SplitText module */
+export interface ISplitTextCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Called before the text is split.
+     */
+    beforeSplit: undefined;
+    /**
+     * Called after the text has been split.
+     */
+    split: undefined;
+}
+/** SplitText Line Metadata */
+export interface ISplitTextLineMeta {
+    /**
+     * HTML element representing a single line of split text.
+     */
+    element: HTMLElement;
+    /**
+     * HTML element representing a wrapper for the line element. Useful for animating the line with masks.
+     *
+     * The element is created when `props.hasLinesWrapper` is `true`.
+     */
+    wrapper?: HTMLElement;
+    /**
+     * Array of word objects within the line.
+     */
+    words: ISplitTextWordMeta[];
+}
+/** SplitText Word Metadata */
+export interface ISplitTextWordMeta {
+    /**
+     * HTML element representing a single word.
+     */
+    element: HTMLElement;
+    /**
+     * Array of letter objects within the word.
+     */
+    letters: ISplitTextLetterMeta[];
+}
+/** SplitText Letter Metadata */
+export interface ISplitTextLetterMeta {
+    /**
+     * HTML element representing a single letter.
+     */
+    element: HTMLElement;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/types/components/SplitText/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/SplitText/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,yBAAiB,UAAU,CAAC;IAC1B,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;WAGG;QACH,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAE5B;;;WAGG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;QAErB;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,qBAAqB,CAAC;QAExC;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,qBAAqB,CAAC;QAEtC;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,qBAAqB,CAAC;QAEtC;;;WAGG;QACH,cAAc,CAAC,EAAE,eAAe,CAAC;QAEjC;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;KAAG;IAExE,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE;;WAEG;QACH,WAAW,EAAE,SAAS,CAAC;QAEvB;;WAEG;QACH,KAAK,EAAE,SAAS,CAAC;KAClB;IAED,UAAiB,KAAK;QACpB;;WAEG;QACH,OAAO,EAAE,WAAW,CAAC;QAErB;;WAEG;QACH,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;KAC3B;IAED,UAAiB,KAAK;QACpB;;WAEG;QACH,OAAO,EAAE,WAAW,CAAC;QAErB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;KAC/B;IAED,UAAiB,OAAO;QACtB;;WAEG;QACH,OAAO,EAAE,WAAW,CAAC;QAErB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/SplitText/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,QAAQ,CAAC;AAEhB,iDAAiD;AACjD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAEtC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;CAAG;AAEtE,6CAA6C;AAC7C,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE;;OAEG;IACH,WAAW,EAAE,SAAS,CAAC;IAEvB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/lib/types/components/SplitText/utils/saveInitialNodes.d.ts

@@ -0,0 +1,4 @@
+export declare function saveInitialNodes(root: Node): {
+    restore: () => void;
+};
+//# sourceMappingURL=saveInitialNodes.d.ts.map

package/lib/types/components/SplitText/utils/saveInitialNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveInitialNodes.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/saveInitialNodes.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI;;EAqC1C"}

package/lib/types/components/SplitText/utils/splitBase.d.ts

@@ -1,4 +1,4 @@
-import { NSplitText } from '../types';
+import { ISplitTextLetterMeta } from '../types';
 interface IProps {
     container: HTMLElement;
     letterClassName: string;
@@ -11,9 +11,8 @@ interface IProps {
  * Splits text in the container into words and optionally into letters.
  */
 export declare function splitBase({ container, letterClassName, wordClassName, hasLetters, letterTag, wordTag, }: IProps): {
-    helper: HTMLElement;
-    words: NSplitText.IWord[];
-    letters: NSplitText.ILetter[];
+    wordsMeta: import("../types").ISplitTextWordMeta[];
+    lettersMeta: ISplitTextLetterMeta[];
 };
 export {};
 //# sourceMappingURL=splitBase.d.ts.map

package/lib/types/components/SplitText/utils/splitBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"splitBase.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/splitBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,UAAU,MAAM;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,qBAAqB,CAAC;IACvC,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,GACR,EAAE,MAAM;;;;EA6BR"}
+{"version":3,"file":"splitBase.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/splitBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAIhD,UAAU,MAAM;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,qBAAqB,CAAC;IACvC,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,GACR,EAAE,MAAM;;;EA+BR"}

package/lib/types/components/SplitText/utils/wrapLetters.d.ts

@@ -1,14 +1,14 @@
-import { NSplitText } from '../types';
+import { ISplitTextLetterMeta, ISplitTextWordMeta } from '../types';
 interface IProps {
-    words: NSplitText.IWord[];
+    wordsMeta: ISplitTextWordMeta[];
     classname: string;
     tagName: keyof HTMLElementTagNameMap;
 }
 /**
  * Wraps each letter in every word inside the container with the specified HTML tag and class name.
  */
-export declare function wrapLetters({ words, classname, tagName }: IProps): {
-    letters: NSplitText.ILetter[];
+export declare function wrapLetters({ wordsMeta, classname, tagName }: IProps): {
+    lettersMeta: ISplitTextLetterMeta[];
 };
 export {};
 //# sourceMappingURL=wrapLetters.d.ts.map

package/lib/types/components/SplitText/utils/wrapLetters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapLetters.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/wrapLetters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,UAAU,MAAM;IACd,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM;;EAqChE"}
+{"version":3,"file":"wrapLetters.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/wrapLetters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEpE,UAAU,MAAM;IACd,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM;;EAwCpE"}

package/lib/types/components/SplitText/utils/wrapLines.d.ts

@@ -1,19 +1,22 @@
-import { NSplitText } from '../types';
+import { ISplitTextLineMeta, ISplitTextWordMeta } from '../types';
 interface IProps {
     container: HTMLElement;
-    words: NSplitText.IWord[];
-    className: string;
+    hasLinesWrapper: boolean;
+    wordsMeta: ISplitTextWordMeta[];
+    lineClassName: string;
+    lineWrapperClassName: string;
     tagName: keyof HTMLElementTagNameMap;
 }
-interface ILine extends NSplitText.ILine {
+interface ILine extends ISplitTextLineMeta {
     nodes: Node[];
 }
+export declare function childOf(element: Element, parent: Element): boolean;
 /**
  * Wraps each word in the container into lines, based on their vertical position.
  */
-export declare function wrapLines({ container, words, className, tagName }: IProps): {
-    lines: ILine[];
-    destroy: () => void;
+export declare function wrapLines({ container, hasLinesWrapper, wordsMeta, lineClassName, lineWrapperClassName, tagName, }: IProps): {
+    linesMeta: ILine[];
+    destroy: () => boolean;
 };
 export {};
 //# sourceMappingURL=wrapLines.d.ts.map

package/lib/types/components/SplitText/utils/wrapLines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapLines.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/wrapLines.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,UAAU,MAAM;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED,UAAU,KAAM,SAAQ,UAAU,CAAC,KAAK;IACtC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAaD;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM;;;EA0EzE"}
+{"version":3,"file":"wrapLines.d.ts","sourceRoot":"","sources":["../../../../../src/components/SplitText/utils/wrapLines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAElE,UAAU,MAAM;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,qBAAqB,CAAC;CACtC;AAED,UAAU,KAAM,SAAQ,kBAAkB;IACxC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAaD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,WAUxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,OAAO,GACR,EAAE,MAAM;;;EAkGR"}

package/lib/types/components/SplitText/utils/wrapWords.d.ts

@@ -1,4 +1,4 @@
-import { NSplitText } from '../types';
+import { ISplitTextWordMeta } from '../types';
 interface IProps {
     container: ChildNode;
     classname: string;
@@ -7,6 +7,6 @@ interface IProps {
 /**
  * Wraps each word inside the container in an HTML element with the specified tag and class.
  */
-export declare function wrapWords({ container, classname, tagName }: IProps): NSplitText.IWord[];
+export declare function wrapWords({ container, classname, tagName }: IProps): ISplitTextWordMeta[];
 export {};
 //# sourceMappingURL=wrapWords.d.ts.map