twd-js 1.5.2 → 1.6.0

package/dist/index.d.ts

@@ -437,6 +437,32 @@ declare interface TWDAPI {
      * ```
      */
     notExists: (selector: string) => Promise<void>;
+    /**
+     * Simulates a viewport size by constraining body dimensions, overriding
+     * `window.innerWidth`/`window.innerHeight` and `window.matchMedia()`, and
+     * rewriting CSS `@media` rules to match the simulated dimensions.
+     * Call with no arguments to reset to the original viewport.
+     *
+     * @param width Viewport width in pixels
+     * @param height Viewport height in pixels (optional — omit to leave height unconstrained)
+     *
+     * @example
+     * ```ts
+     * twd.viewport(375, 667); // mobile
+     * twd.viewport(768);      // tablet width, height unconstrained
+     * twd.viewport();          // reset
+     * ```
+     */
+    viewport: (width?: number, height?: number) => void;
+    /**
+     * Resets the viewport to its original size (undoes a previous `twd.viewport()` call).
+     *
+     * @example
+     * ```ts
+     * twd.resetViewport();
+     * ```
+     */
+    resetViewport: () => void;
 }
 
 /**