@fiddle-digital/string-tune 1.1.23 → 1.1.25

package/dist/index.d.mts

@@ -873,6 +873,18 @@ interface StringContext {
     events: EventManager;
 }
 
+interface ModuleLifecyclePermissionsItem {
+    rebuild: {
+        width: boolean;
+        height: boolean;
+        scrollHeight: boolean;
+    };
+}
+declare class ModuleLifecyclePermissions {
+    desktop: ModuleLifecyclePermissionsItem;
+    mobile: ModuleLifecyclePermissionsItem;
+}
+
 /**
  * Internal class representing a DOM-bound interactive object.
  * Connected to modules and holds its own internal state.
@@ -955,6 +967,7 @@ declare class StringObject {
  * Base interface for scroll/interaction modules in the StringScroll system.
  */
 interface IStringModule {
+    permissions: ModuleLifecyclePermissions;
     /** Cleans up all internal state and detaches from the system. */
     destroy(): void;
     /** Called once when the module is initialized. */
@@ -963,6 +976,8 @@ interface IStringModule {
     onFrame(data: StringData): void;
     /** Called when the window or layout is resized. */
     onResize(): void;
+    /** Called when the layout is resize width. */
+    onResizeWidth(): void;
     /** Called when the system rebuilds the DOM (e.g. after mutations). */
     onDOMRebuild(): void;
     /** Called when scroll position changes. */
@@ -1130,6 +1145,7 @@ declare class StringModule implements IStringModule {
      * Supports custom event emitting, listening, and unsubscription.
      */
     protected events: EventManager;
+    permissions: ModuleLifecyclePermissions;
     constructor(context: StringContext);
     /**
      * Initializes a `StringObject` by mapping attributes from an HTML element
@@ -1243,6 +1259,8 @@ declare class StringModule implements IStringModule {
     onFrame(data: StringData): void;
     /** Called when the window or layout is resized. */
     onResize(): void;
+    /** Called when the layout is resized width. */
+    onResizeWidth(): void;
     /** Called when scroll position changes. */
     onScroll(data: StringData): void;
     /** Called when user changed scroll diraction. */
@@ -1301,28 +1319,17 @@ declare class StringMagnetic extends StringModule {
 
 /**
  * Module that handles lazy-loading of images with `string-lazy` attribute.
- * Automatically loads and applies aspect-ratio once image is loaded.
+ * It loads the image only once, calculates its aspect-ratio to prevent layout shift,
+ * and then displays it.
  */
 declare class StringLazy extends StringModule {
     private isStartLoaded;
     private loadingCount;
     constructor(context: StringContext);
-    /**
-     * Called on module start — preloads all <img string-lazy> in DOM.
-     */
     onInit(): void;
-    /**
-     * Called when an image becomes a managed object.
-     */
     onObjectConnected(object: StringObject): void;
-    /**
-     * Loads image and sets aspect-ratio based on real dimensions.
-     */
     private loadImage;
-    /**
-     * Loads image data to extract real dimensions and apply aspect-ratio style.
-     */
-    private setAspectRatio;
+    private handleLoadingCompletion;
 }
 
 /**
@@ -1489,7 +1496,7 @@ declare class StringScrollbar extends StringModule {
  */
 declare class StringSplit extends StringModule {
     constructor(context: StringContext);
-    onResize(): void;
+    onResizeWidth(): void;
     onObjectConnected(object: StringObject): void;
     split(element: HTMLElement, options: ISplitOptions): {
         fragment: DocumentFragment;

package/dist/index.d.ts

@@ -873,6 +873,18 @@ interface StringContext {
     events: EventManager;
 }
 
+interface ModuleLifecyclePermissionsItem {
+    rebuild: {
+        width: boolean;
+        height: boolean;
+        scrollHeight: boolean;
+    };
+}
+declare class ModuleLifecyclePermissions {
+    desktop: ModuleLifecyclePermissionsItem;
+    mobile: ModuleLifecyclePermissionsItem;
+}
+
 /**
  * Internal class representing a DOM-bound interactive object.
  * Connected to modules and holds its own internal state.
@@ -955,6 +967,7 @@ declare class StringObject {
  * Base interface for scroll/interaction modules in the StringScroll system.
  */
 interface IStringModule {
+    permissions: ModuleLifecyclePermissions;
     /** Cleans up all internal state and detaches from the system. */
     destroy(): void;
     /** Called once when the module is initialized. */
@@ -963,6 +976,8 @@ interface IStringModule {
     onFrame(data: StringData): void;
     /** Called when the window or layout is resized. */
     onResize(): void;
+    /** Called when the layout is resize width. */
+    onResizeWidth(): void;
     /** Called when the system rebuilds the DOM (e.g. after mutations). */
     onDOMRebuild(): void;
     /** Called when scroll position changes. */
@@ -1130,6 +1145,7 @@ declare class StringModule implements IStringModule {
      * Supports custom event emitting, listening, and unsubscription.
      */
     protected events: EventManager;
+    permissions: ModuleLifecyclePermissions;
     constructor(context: StringContext);
     /**
      * Initializes a `StringObject` by mapping attributes from an HTML element
@@ -1243,6 +1259,8 @@ declare class StringModule implements IStringModule {
     onFrame(data: StringData): void;
     /** Called when the window or layout is resized. */
     onResize(): void;
+    /** Called when the layout is resized width. */
+    onResizeWidth(): void;
     /** Called when scroll position changes. */
     onScroll(data: StringData): void;
     /** Called when user changed scroll diraction. */
@@ -1301,28 +1319,17 @@ declare class StringMagnetic extends StringModule {
 
 /**
  * Module that handles lazy-loading of images with `string-lazy` attribute.
- * Automatically loads and applies aspect-ratio once image is loaded.
+ * It loads the image only once, calculates its aspect-ratio to prevent layout shift,
+ * and then displays it.
  */
 declare class StringLazy extends StringModule {
     private isStartLoaded;
     private loadingCount;
     constructor(context: StringContext);
-    /**
-     * Called on module start — preloads all <img string-lazy> in DOM.
-     */
     onInit(): void;
-    /**
-     * Called when an image becomes a managed object.
-     */
     onObjectConnected(object: StringObject): void;
-    /**
-     * Loads image and sets aspect-ratio based on real dimensions.
-     */
     private loadImage;
-    /**
-     * Loads image data to extract real dimensions and apply aspect-ratio style.
-     */
-    private setAspectRatio;
+    private handleLoadingCompletion;
 }
 
 /**
@@ -1489,7 +1496,7 @@ declare class StringScrollbar extends StringModule {
  */
 declare class StringSplit extends StringModule {
     constructor(context: StringContext);
-    onResize(): void;
+    onResizeWidth(): void;
     onObjectConnected(object: StringObject): void;
     split(element: HTMLElement, options: ISplitOptions): {
         fragment: DocumentFragment;