twd-js 1.5.2 → 1.6.1

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;
 }
 
 /**
@@ -470,7 +496,7 @@ declare interface TWDElemAPI {
     should: ShouldFn;
 }
 
-export declare const TWDSidebar: ({ open, position }: TWDSidebarProps) => JSX.Element;
+export declare const TWDSidebar: ({ open, position, search }: TWDSidebarProps) => JSX.Element;
 
 declare interface TWDSidebarProps {
     /**
@@ -485,6 +511,10 @@ declare interface TWDSidebarProps {
      * @default "left"
      */
     position?: "left" | "right";
+    /**
+     * Whether to show the search/filter input
+     */
+    search?: boolean;
 }
 
 /**