@simplysm/core-browser 13.0.75 → 13.0.77

package/README.md

@@ -2,7 +2,7 @@
 
 Simplysm package - Core module (browser)
 
-Browser-only utilities including DOM element extensions, file download helpers, fetch utilities, and file dialog helpers.
+Browser-only utilities including DOM element extensions, file download helpers, fetch utilities, file dialog helpers, and IndexedDB wrappers.
 
 ## Installation
 
@@ -22,7 +22,7 @@ import "@simplysm/core-browser";
 
 Extends the global `Element` interface with utility methods. These are activated as side effects when the package is imported.
 
-### `element.findAll<T>(selector)`
+### `element.findAll<TEl>(selector)`
 
 Finds all child elements matching a CSS selector.
 
@@ -37,12 +37,12 @@ const items = containerEl.findAll<HTMLLIElement>("li.active");
 **Signature:**
 
 ```ts
-findAll<T extends Element = Element>(selector: string): T[]
+findAll<TEl extends Element = Element>(selector: string): TEl[]
 ```
 
 ---
 
-### `element.findFirst<T>(selector)`
+### `element.findFirst<TEl>(selector)`
 
 Finds the first child element matching a CSS selector.
 
@@ -57,12 +57,12 @@ const input = formEl.findFirst<HTMLInputElement>("input[name='email']");
 **Signature:**
 
 ```ts
-findFirst<T extends Element = Element>(selector: string): T | undefined
+findFirst<TEl extends Element = Element>(selector: string): TEl | undefined
 ```
 
 ---
 
-### `element.prependChild<T>(child)`
+### `element.prependChild<TEl>(child)`
 
 Inserts a child element as the first child of the element.
 
@@ -76,7 +76,7 @@ containerEl.prependChild(newEl);
 **Signature:**
 
 ```ts
-prependChild<T extends Element>(child: T): T
+prependChild<TEl extends Element>(child: TEl): TEl
 ```
 
 ---
@@ -429,6 +429,116 @@ function openFileDialog(options?: {
 
 ---
 
+## IndexedDB Store
+
+### `IndexedDbStore`
+
+A thin wrapper around the browser `IndexedDB` API for typed key-value object stores. Opens a versioned database, auto-creates stores on upgrade, and closes the connection after each operation.
+
+```ts
+import { IndexedDbStore } from "@simplysm/core-browser";
+
+const db = new IndexedDbStore("my-db", 1, [
+  { name: "users", keyPath: "id" },
+]);
+
+await db.put("users", { id: 1, name: "Alice" });
+const user = await db.get<{ id: number; name: string }>("users", 1);
+const all = await db.getAll<{ id: number; name: string }>("users");
+```
+
+**Constructor:**
+
+```ts
+new IndexedDbStore(
+  dbName: string,
+  dbVersion: number,
+  storeConfigs: StoreConfig[],
+)
+```
+
+**Methods:**
+
+```ts
+open(): Promise<IDBDatabase>
+
+withStore<TResult>(
+  storeName: string,
+  mode: IDBTransactionMode,
+  fn: (store: IDBObjectStore) => Promise<TResult>,
+): Promise<TResult>
+
+get<TValue>(storeName: string, key: IDBValidKey): Promise<TValue | undefined>
+
+put(storeName: string, value: unknown): Promise<void>
+
+getAll<TItem>(storeName: string): Promise<TItem[]>
+```
+
+- `open()` — opens the database and returns the raw `IDBDatabase`. Creates missing object stores declared in `storeConfigs`. Rejects if the connection is blocked.
+- `withStore()` — executes `fn` inside a single transaction on `storeName`. Aborts the transaction if `fn` throws. Closes the database when the transaction completes.
+- `get()` — retrieves one record by `key` from `storeName`. Returns `undefined` if not found.
+- `put()` — inserts or updates a record in `storeName`.
+- `getAll()` — retrieves all records from `storeName`.
+
+---
+
+## IndexedDB Virtual Filesystem
+
+### `IndexedDbVirtualFs`
+
+A virtual filesystem built on top of `IndexedDbStore`. Each entry is stored as a flat key (slash-separated path string) with a kind (`"file"` or `"dir"`) and optional base64 data payload.
+
+```ts
+import { IndexedDbStore, IndexedDbVirtualFs } from "@simplysm/core-browser";
+
+const db = new IndexedDbStore("my-fs-db", 1, [
+  { name: "fs", keyPath: "fullKey" },
+]);
+const vfs = new IndexedDbVirtualFs(db, "fs", "fullKey");
+
+await vfs.putEntry("/docs/readme.txt", "file", btoa("hello"));
+const entry = await vfs.getEntry("/docs/readme.txt");
+const children = await vfs.listChildren("/docs/");
+await vfs.deleteByPrefix("/docs");
+```
+
+**Constructor:**
+
+```ts
+new IndexedDbVirtualFs(
+  db: IndexedDbStore,
+  storeName: string,
+  keyField: string,
+)
+```
+
+- `db` — an `IndexedDbStore` instance to use for persistence.
+- `storeName` — the object store name within the database.
+- `keyField` — the field name used as the primary key in stored records.
+
+**Methods:**
+
+```ts
+getEntry(fullKey: string): Promise<VirtualFsEntry | undefined>
+
+putEntry(fullKey: string, kind: "file" | "dir", dataBase64?: string): Promise<void>
+
+deleteByPrefix(keyPrefix: string): Promise<boolean>
+
+listChildren(prefix: string): Promise<{ name: string; isDirectory: boolean }[]>
+
+ensureDir(fullKeyBuilder: (path: string) => string, dirPath: string): Promise<void>
+```
+
+- `getEntry()` — retrieves the entry for `fullKey`. Returns `undefined` if not found.
+- `putEntry()` — writes or overwrites an entry with the given `kind` and optional base64 data.
+- `deleteByPrefix()` — deletes all entries whose key equals `keyPrefix` or starts with `keyPrefix + "/"`. Returns `true` if at least one entry was deleted.
+- `listChildren()` — lists the immediate children under `prefix`. Each result includes `name` (the path segment) and `isDirectory`.
+- `ensureDir()` — creates directory entries for every path segment in `dirPath` if they do not already exist. `fullKeyBuilder` maps a path string to the full store key.
+
+---
+
 ## Types
 
 ### `ElementBounds`
@@ -464,3 +574,33 @@ interface DownloadProgress {
   contentLength: number;
 }
 ```
+
+---
+
+### `StoreConfig`
+
+Configuration for a single object store within an `IndexedDbStore`.
+
+```ts
+interface StoreConfig {
+  /** Object store name */
+  name: string;
+  /** Primary key field path */
+  keyPath: string;
+}
+```
+
+---
+
+### `VirtualFsEntry`
+
+A single entry stored in the `IndexedDbVirtualFs`.
+
+```ts
+interface VirtualFsEntry {
+  /** Entry kind: "file" or "dir" */
+  kind: "file" | "dir";
+  /** File contents encoded as base64 (only present for file entries) */
+  dataBase64?: string;
+}
+```

package/dist/extensions/element-ext.d.ts

@@ -21,21 +21,21 @@ declare global {
          * @param selector - CSS selector
          * @returns Array of matching elements (empty selector returns empty array)
          */
-        findAll<T extends Element = Element>(selector: string): T[];
+        findAll<TEl extends Element = Element>(selector: string): TEl[];
         /**
          * Find first element matching selector
          *
          * @param selector - CSS selector
          * @returns First matching element or undefined (empty selector returns undefined)
          */
-        findFirst<T extends Element = Element>(selector: string): T | undefined;
+        findFirst<TEl extends Element = Element>(selector: string): TEl | undefined;
         /**
          * Insert element as first child
          *
          * @param child - Child element to insert
          * @returns Inserted child element
          */
-        prependChild<T extends Element>(child: T): T;
+        prependChild<TEl extends Element>(child: TEl): TEl;
         /**
          * Get all parent elements (in order of proximity)
          *

package/dist/extensions/element-ext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-ext.d.ts","sourceRoot":"","sources":["..\\..\\src\\extensions\\element-ext.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO;QACf;;;;;WAKG;QACH,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAE5D;;;;;WAKG;QACH,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;QAExE;;;;;WAKG;QACH,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAE7C;;;;WAIG;QACH,UAAU,IAAI,OAAO,EAAE,CAAC;QAExB;;;;WAIG;QACH,mBAAmB,IAAI,WAAW,GAAG,SAAS,CAAC;QAE/C;;;;WAIG;QACH,uBAAuB,IAAI,WAAW,GAAG,SAAS,CAAC;QAEnD;;;;WAIG;QACH,eAAe,IAAI,OAAO,CAAC;QAE3B;;;;;;;WAOG;QACH,SAAS,IAAI,OAAO,CAAC;KACtB;CACF;AAkED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAYvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAa1D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoDhG"}
+{"version":3,"file":"element-ext.d.ts","sourceRoot":"","sources":["..\\..\\src\\extensions\\element-ext.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO;QACf;;;;;WAKG;QACH,OAAO,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;QAEhE;;;;;WAKG;QACH,SAAS,CAAC,GAAG,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;QAE5E;;;;;WAKG;QACH,YAAY,CAAC,GAAG,SAAS,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;QAEnD;;;;WAIG;QACH,UAAU,IAAI,OAAO,EAAE,CAAC;QAExB;;;;WAIG;QACH,mBAAmB,IAAI,WAAW,GAAG,SAAS,CAAC;QAE/C;;;;WAIG;QACH,uBAAuB,IAAI,WAAW,GAAG,SAAS,CAAC;QAEnD;;;;WAIG;QACH,eAAe,IAAI,OAAO,CAAC;QAE3B;;;;;;;WAOG;QACH,SAAS,IAAI,OAAO,CAAC;KACtB;CACF;AAkED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAYvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAa1D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoDhG"}

package/dist/extensions/element-ext.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/extensions/element-ext.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export * from "./extensions/html-element-ext";
 export * from "./utils/download";
 export * from "./utils/fetch";
 export * from "./utils/file-dialog";
+export * from "./utils/IndexedDbStore";
+export * from "./utils/IndexedDbVirtualFs";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAGA,OAAO,0BAA0B,CAAC;AAClC,OAAO,+BAA+B,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAGA,OAAO,0BAA0B,CAAC;AAClC,OAAO,+BAA+B,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -5,4 +5,6 @@ export * from "./extensions/html-element-ext.js";
 export * from "./utils/download.js";
 export * from "./utils/fetch.js";
 export * from "./utils/file-dialog.js";
+export * from "./utils/IndexedDbStore.js";
+export * from "./utils/IndexedDbVirtualFs.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "mappings": "AAGA,OAAO;AACP,OAAO;AAGP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "mappings": "AAGA,OAAO;AACP,OAAO;AAGP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/utils/IndexedDbStore.d.ts

@@ -0,0 +1,16 @@
+export interface StoreConfig {
+    name: string;
+    keyPath: string;
+}
+export declare class IndexedDbStore {
+    private readonly _dbName;
+    private readonly _dbVersion;
+    private readonly _storeConfigs;
+    constructor(_dbName: string, _dbVersion: number, _storeConfigs: StoreConfig[]);
+    open(): Promise<IDBDatabase>;
+    withStore<TResult>(storeName: string, mode: IDBTransactionMode, fn: (store: IDBObjectStore) => Promise<TResult>): Promise<TResult>;
+    get<TValue>(storeName: string, key: IDBValidKey): Promise<TValue | undefined>;
+    put(storeName: string, value: unknown): Promise<void>;
+    getAll<TItem>(storeName: string): Promise<TItem[]>;
+}
+//# sourceMappingURL=IndexedDbStore.d.ts.map

package/dist/utils/IndexedDbStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbStore.d.ts","sourceRoot":"","sources":["..\\..\\src\\utils\\IndexedDbStore.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,WAAW,EAAE;IAGzC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAiB5B,SAAS,CAAC,OAAO,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,OAAO,CAAC;IAwCb,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAU7E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CASzD"}

package/dist/utils/IndexedDbStore.js

@@ -0,0 +1,89 @@
+class IndexedDbStore {
+  constructor(_dbName, _dbVersion, _storeConfigs) {
+    this._dbName = _dbName;
+    this._dbVersion = _dbVersion;
+    this._storeConfigs = _storeConfigs;
+  }
+  async open() {
+    return new Promise((resolve, reject) => {
+      const req = indexedDB.open(this._dbName, this._dbVersion);
+      req.onupgradeneeded = () => {
+        const db = req.result;
+        for (const config of this._storeConfigs) {
+          if (!db.objectStoreNames.contains(config.name)) {
+            db.createObjectStore(config.name, { keyPath: config.keyPath });
+          }
+        }
+      };
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+      req.onblocked = () => reject(new Error("Database blocked by another connection"));
+    });
+  }
+  async withStore(storeName, mode, fn) {
+    const db = await this.open();
+    try {
+      const tx = db.transaction(storeName, mode);
+      const store = tx.objectStore(storeName);
+      let result;
+      let fnError;
+      try {
+        result = await fn(store);
+      } catch (err) {
+        fnError = err;
+        tx.abort();
+      }
+      return await new Promise((resolve, reject) => {
+        if (fnError !== void 0) {
+          tx.onerror = () => {
+            db.close();
+            reject(fnError);
+          };
+        } else {
+          tx.oncomplete = () => {
+            db.close();
+            resolve(result);
+          };
+          tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+          };
+        }
+      });
+    } catch (err) {
+      db.close();
+      throw err;
+    }
+  }
+  async get(storeName, key) {
+    return this.withStore(storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.get(key);
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+  async put(storeName, value) {
+    return this.withStore(storeName, "readwrite", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.put(value);
+        req.onsuccess = () => resolve();
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+  async getAll(storeName) {
+    return this.withStore(storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.getAll();
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+}
+export {
+  IndexedDbStore
+};
+//# sourceMappingURL=IndexedDbStore.js.map

package/dist/utils/IndexedDbStore.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/IndexedDbStore.ts"],
+  "mappings": "AAKO,MAAM,eAAe;AAAA,EAC1B,YACmB,SACA,YACA,eACjB;AAHiB;AACA;AACA;AAAA,EAChB;AAAA,EAEH,MAAM,OAA6B;AACjC,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,MAAM,UAAU,KAAK,KAAK,SAAS,KAAK,UAAU;AACxD,UAAI,kBAAkB,MAAM;AAC1B,cAAM,KAAK,IAAI;AACf,mBAAW,UAAU,KAAK,eAAe;AACvC,cAAI,CAAC,GAAG,iBAAiB,SAAS,OAAO,IAAI,GAAG;AAC9C,eAAG,kBAAkB,OAAO,MAAM,EAAE,SAAS,OAAO,QAAQ,CAAC;AAAA,UAC/D;AAAA,QACF;AAAA,MACF;AACA,UAAI,YAAY,MAAM,QAAQ,IAAI,MAAM;AACxC,UAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AACpC,UAAI,YAAY,MAAM,OAAO,IAAI,MAAM,wCAAwC,CAAC;AAAA,IAClF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,UACJ,WACA,MACA,IACkB;AAClB,UAAM,KAAK,MAAM,KAAK,KAAK;AAC3B,QAAI;AACF,YAAM,KAAK,GAAG,YAAY,WAAW,IAAI;AACzC,YAAM,QAAQ,GAAG,YAAY,SAAS;AAGtC,UAAI;AACJ,UAAI;AACJ,UAAI;AACF,iBAAS,MAAM,GAAG,KAAK;AAAA,MACzB,SAAS,KAAK;AACZ,kBAAU;AACV,WAAG,MAAM;AAAA,MACX;AAGA,aAAO,MAAM,IAAI,QAAiB,CAAC,SAAS,WAAW;AACrD,YAAI,YAAY,QAAW;AACzB,aAAG,UAAU,MAAM;AACjB,eAAG,MAAM;AACT,mBAAO,OAAO;AAAA,UAChB;AAAA,QACF,OAAO;AACL,aAAG,aAAa,MAAM;AACpB,eAAG,MAAM;AACT,oBAAQ,MAAO;AAAA,UACjB;AACA,aAAG,UAAU,MAAM;AACjB,eAAG,MAAM;AACT,mBAAO,GAAG,KAAK;AAAA,UACjB;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,SAAG,MAAM;AACT,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,IAAY,WAAmB,KAA+C;AAClF,WAAO,KAAK,UAAU,WAAW,YAAY,OAAO,UAAU;AAC5D,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,MAAM,MAAM,IAAI,GAAG;AACzB,YAAI,YAAY,MAAM,QAAQ,IAAI,MAA4B;AAC9D,YAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,WAAmB,OAA+B;AAC1D,WAAO,KAAK,UAAU,WAAW,aAAa,OAAO,UAAU;AAC7D,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,YAAI,YAAY,MAAM,QAAQ;AAC9B,YAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAc,WAAqC;AACvD,WAAO,KAAK,UAAU,WAAW,YAAY,OAAO,UAAU;AAC5D,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,MAAM,MAAM,OAAO;AACzB,YAAI,YAAY,MAAM,QAAQ,IAAI,MAAiB;AACnD,YAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/utils/IndexedDbVirtualFs.d.ts

@@ -0,0 +1,20 @@
+import type { IndexedDbStore } from "./IndexedDbStore";
+export interface VirtualFsEntry {
+    kind: "file" | "dir";
+    dataBase64?: string;
+}
+export declare class IndexedDbVirtualFs {
+    private readonly _db;
+    private readonly _storeName;
+    private readonly _keyField;
+    constructor(_db: IndexedDbStore, _storeName: string, _keyField: string);
+    getEntry(fullKey: string): Promise<VirtualFsEntry | undefined>;
+    putEntry(fullKey: string, kind: "file" | "dir", dataBase64?: string): Promise<void>;
+    deleteByPrefix(keyPrefix: string): Promise<boolean>;
+    listChildren(prefix: string): Promise<{
+        name: string;
+        isDirectory: boolean;
+    }[]>;
+    ensureDir(fullKeyBuilder: (path: string) => string, dirPath: string): Promise<void>;
+}
+//# sourceMappingURL=IndexedDbVirtualFs.d.ts.map

package/dist/utils/IndexedDbVirtualFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbVirtualFs.d.ts","sourceRoot":"","sources":["..\\..\\src\\utils\\IndexedDbVirtualFs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM;IAG9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI9D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBnD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAmC/E,SAAS,CACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACxC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/utils/IndexedDbVirtualFs.js

@@ -0,0 +1,87 @@
+class IndexedDbVirtualFs {
+  constructor(_db, _storeName, _keyField) {
+    this._db = _db;
+    this._storeName = _storeName;
+    this._keyField = _keyField;
+  }
+  async getEntry(fullKey) {
+    return this._db.get(this._storeName, fullKey);
+  }
+  async putEntry(fullKey, kind, dataBase64) {
+    await this._db.put(this._storeName, { [this._keyField]: fullKey, kind, dataBase64 });
+  }
+  async deleteByPrefix(keyPrefix) {
+    return this._db.withStore(this._storeName, "readwrite", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.openCursor();
+        let found = false;
+        req.onsuccess = () => {
+          const cursor = req.result;
+          if (!cursor) {
+            resolve(found);
+            return;
+          }
+          const key = String(cursor.key);
+          if (key === keyPrefix || key.startsWith(keyPrefix + "/")) {
+            found = true;
+            cursor.delete();
+          }
+          cursor.continue();
+        };
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+  async listChildren(prefix) {
+    return this._db.withStore(this._storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.openCursor();
+        const map = /* @__PURE__ */ new Map();
+        req.onsuccess = () => {
+          const cursor = req.result;
+          if (!cursor) {
+            resolve(
+              Array.from(map.entries()).map(([name, isDirectory]) => ({ name, isDirectory }))
+            );
+            return;
+          }
+          const key = String(cursor.key);
+          if (key.startsWith(prefix)) {
+            const rest = key.slice(prefix.length);
+            if (rest) {
+              const segments = rest.split("/").filter(Boolean);
+              if (segments.length > 0) {
+                const firstSeg = segments[0];
+                if (!map.has(firstSeg)) {
+                  const isDir = segments.length > 1 || cursor.value.kind === "dir";
+                  map.set(firstSeg, isDir);
+                }
+              }
+            }
+          }
+          cursor.continue();
+        };
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+  async ensureDir(fullKeyBuilder, dirPath) {
+    if (dirPath === "/") {
+      await this.putEntry(fullKeyBuilder("/"), "dir");
+      return;
+    }
+    const segments = dirPath.split("/").filter(Boolean);
+    let acc = "";
+    for (const seg of segments) {
+      acc += "/" + seg;
+      const existing = await this.getEntry(fullKeyBuilder(acc));
+      if (!existing) {
+        await this.putEntry(fullKeyBuilder(acc), "dir");
+      }
+    }
+  }
+}
+export {
+  IndexedDbVirtualFs
+};
+//# sourceMappingURL=IndexedDbVirtualFs.js.map

package/dist/utils/IndexedDbVirtualFs.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/IndexedDbVirtualFs.ts"],
+  "mappings": "AAOO,MAAM,mBAAmB;AAAA,EAC9B,YACmB,KACA,YACA,WACjB;AAHiB;AACA;AACA;AAAA,EAChB;AAAA,EAEH,MAAM,SAAS,SAAsD;AACnE,WAAO,KAAK,IAAI,IAAoB,KAAK,YAAY,OAAO;AAAA,EAC9D;AAAA,EAEA,MAAM,SAAS,SAAiB,MAAsB,YAAoC;AACxF,UAAM,KAAK,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC,KAAK,SAAS,GAAG,SAAS,MAAM,WAAW,CAAC;AAAA,EACrF;AAAA,EAEA,MAAM,eAAe,WAAqC;AACxD,WAAO,KAAK,IAAI,UAAU,KAAK,YAAY,aAAa,OAAO,UAAU;AACvE,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,MAAM,MAAM,WAAW;AAC7B,YAAI,QAAQ;AACZ,YAAI,YAAY,MAAM;AACpB,gBAAM,SAAS,IAAI;AACnB,cAAI,CAAC,QAAQ;AACX,oBAAQ,KAAK;AACb;AAAA,UACF;AACA,gBAAM,MAAM,OAAO,OAAO,GAAG;AAC7B,cAAI,QAAQ,aAAa,IAAI,WAAW,YAAY,GAAG,GAAG;AACxD,oBAAQ;AACR,mBAAO,OAAO;AAAA,UAChB;AACA,iBAAO,SAAS;AAAA,QAClB;AACA,YAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,aAAa,QAAmE;AACpF,WAAO,KAAK,IAAI,UAAU,KAAK,YAAY,YAAY,OAAO,UAAU;AACtE,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,MAAM,MAAM,WAAW;AAC7B,cAAM,MAAM,oBAAI,IAAqB;AACrC,YAAI,YAAY,MAAM;AACpB,gBAAM,SAAS,IAAI;AACnB,cAAI,CAAC,QAAQ;AACX;AAAA,cACE,MAAM,KAAK,IAAI,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,WAAW,OAAO,EAAE,MAAM,YAAY,EAAE;AAAA,YAChF;AACA;AAAA,UACF;AACA,gBAAM,MAAM,OAAO,OAAO,GAAG;AAC7B,cAAI,IAAI,WAAW,MAAM,GAAG;AAC1B,kBAAM,OAAO,IAAI,MAAM,OAAO,MAAM;AACpC,gBAAI,MAAM;AACR,oBAAM,WAAW,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAC/C,kBAAI,SAAS,SAAS,GAAG;AACvB,sBAAM,WAAW,SAAS,CAAC;AAC3B,oBAAI,CAAC,IAAI,IAAI,QAAQ,GAAG;AACtB,wBAAM,QACJ,SAAS,SAAS,KAAM,OAAO,MAAyB,SAAS;AACnE,sBAAI,IAAI,UAAU,KAAK;AAAA,gBACzB;AAAA,cACF;AAAA,YACF;AAAA,UACF;AACA,iBAAO,SAAS;AAAA,QAClB;AACA,YAAI,UAAU,MAAM,OAAO,IAAI,KAAK;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,UACJ,gBACA,SACe;AACf,QAAI,YAAY,KAAK;AACnB,YAAM,KAAK,SAAS,eAAe,GAAG,GAAG,KAAK;AAC9C;AAAA,IACF;AACA,UAAM,WAAW,QAAQ,MAAM,GAAG,EAAE,OAAO,OAAO;AAClD,QAAI,MAAM;AACV,eAAW,OAAO,UAAU;AAC1B,aAAO,MAAM;AACb,YAAM,WAAW,MAAM,KAAK,SAAS,eAAe,GAAG,CAAC;AACxD,UAAI,CAAC,UAAU;AACb,cAAM,KAAK,SAAS,eAAe,GAAG,GAAG,KAAK;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/core-browser",
-  "version": "13.0.75",
+  "version": "13.0.77",
   "description": "Simplysm package - Core module (browser)",
   "author": "simplysm",
   "license": "Apache-2.0",
@@ -23,9 +23,9 @@
   ],
   "dependencies": {
     "tabbable": "^6.4.0",
-    "@simplysm/core-common": "13.0.75"
+    "@simplysm/core-common": "13.0.77"
   },
   "devDependencies": {
-    "happy-dom": "^20.7.0"
+    "happy-dom": "^20.8.3"
   }
 }

package/src/extensions/element-ext.ts

@@ -25,7 +25,7 @@ declare global {
      * @param selector - CSS selector
      * @returns Array of matching elements (empty selector returns empty array)
      */
-    findAll<T extends Element = Element>(selector: string): T[];
+    findAll<TEl extends Element = Element>(selector: string): TEl[];
 
     /**
      * Find first element matching selector
@@ -33,7 +33,7 @@ declare global {
      * @param selector - CSS selector
      * @returns First matching element or undefined (empty selector returns undefined)
      */
-    findFirst<T extends Element = Element>(selector: string): T | undefined;
+    findFirst<TEl extends Element = Element>(selector: string): TEl | undefined;
 
     /**
      * Insert element as first child
@@ -41,7 +41,7 @@ declare global {
      * @param child - Child element to insert
      * @returns Inserted child element
      */
-    prependChild<T extends Element>(child: T): T;
+    prependChild<TEl extends Element>(child: TEl): TEl;
 
     /**
      * Get all parent elements (in order of proximity)
@@ -83,21 +83,21 @@ declare global {
   }
 }
 
-Element.prototype.findAll = function <T extends Element = Element>(selector: string): T[] {
+Element.prototype.findAll = function <TEl extends Element = Element>(selector: string): TEl[] {
   const trimmed = selector.trim();
   if (trimmed === "") return [];
-  return Array.from(this.querySelectorAll<T>(trimmed));
+  return Array.from(this.querySelectorAll<TEl>(trimmed));
 };
 
-Element.prototype.findFirst = function <T extends Element = Element>(
+Element.prototype.findFirst = function <TEl extends Element = Element>(
   selector: string,
-): T | undefined {
+): TEl | undefined {
   const trimmed = selector.trim();
   if (trimmed === "") return undefined;
-  return this.querySelector<T>(trimmed) ?? undefined;
+  return this.querySelector<TEl>(trimmed) ?? undefined;
 };
 
-Element.prototype.prependChild = function <T extends Element>(child: T): T {
+Element.prototype.prependChild = function <TEl extends Element>(child: TEl): TEl {
   return this.insertBefore(child, this.firstElementChild);
 };
 

package/src/index.ts

@@ -10,3 +10,5 @@ export * from "./extensions/html-element-ext";
 export * from "./utils/download";
 export * from "./utils/fetch";
 export * from "./utils/file-dialog";
+export * from "./utils/IndexedDbStore";
+export * from "./utils/IndexedDbVirtualFs";

package/src/utils/IndexedDbStore.ts

@@ -0,0 +1,103 @@
+export interface StoreConfig {
+  name: string;
+  keyPath: string;
+}
+
+export class IndexedDbStore {
+  constructor(
+    private readonly _dbName: string,
+    private readonly _dbVersion: number,
+    private readonly _storeConfigs: StoreConfig[],
+  ) {}
+
+  async open(): Promise<IDBDatabase> {
+    return new Promise((resolve, reject) => {
+      const req = indexedDB.open(this._dbName, this._dbVersion);
+      req.onupgradeneeded = () => {
+        const db = req.result;
+        for (const config of this._storeConfigs) {
+          if (!db.objectStoreNames.contains(config.name)) {
+            db.createObjectStore(config.name, { keyPath: config.keyPath });
+          }
+        }
+      };
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+      req.onblocked = () => reject(new Error("Database blocked by another connection"));
+    });
+  }
+
+  async withStore<TResult>(
+    storeName: string,
+    mode: IDBTransactionMode,
+    fn: (store: IDBObjectStore) => Promise<TResult>,
+  ): Promise<TResult> {
+    const db = await this.open();
+    try {
+      const tx = db.transaction(storeName, mode);
+      const store = tx.objectStore(storeName);
+
+      // Await fn result first
+      let result: TResult;
+      let fnError: unknown;
+      try {
+        result = await fn(store);
+      } catch (err) {
+        fnError = err;
+        tx.abort();
+      }
+
+      // Wait for transaction completion
+      return await new Promise<TResult>((resolve, reject) => {
+        if (fnError !== undefined) {
+          tx.onerror = () => {
+            db.close();
+            reject(fnError);
+          };
+        } else {
+          tx.oncomplete = () => {
+            db.close();
+            resolve(result!);
+          };
+          tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+          };
+        }
+      });
+    } catch (err) {
+      db.close();
+      throw err;
+    }
+  }
+
+  async get<TValue>(storeName: string, key: IDBValidKey): Promise<TValue | undefined> {
+    return this.withStore(storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.get(key);
+        req.onsuccess = () => resolve(req.result as TValue | undefined);
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+
+  async put(storeName: string, value: unknown): Promise<void> {
+    return this.withStore(storeName, "readwrite", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.put(value);
+        req.onsuccess = () => resolve();
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+
+  async getAll<TItem>(storeName: string): Promise<TItem[]> {
+    return this.withStore(storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.getAll();
+        req.onsuccess = () => resolve(req.result as TItem[]);
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+}

package/src/utils/IndexedDbVirtualFs.ts

@@ -0,0 +1,99 @@
+import type { IndexedDbStore } from "./IndexedDbStore";
+
+export interface VirtualFsEntry {
+  kind: "file" | "dir";
+  dataBase64?: string;
+}
+
+export class IndexedDbVirtualFs {
+  constructor(
+    private readonly _db: IndexedDbStore,
+    private readonly _storeName: string,
+    private readonly _keyField: string,
+  ) {}
+
+  async getEntry(fullKey: string): Promise<VirtualFsEntry | undefined> {
+    return this._db.get<VirtualFsEntry>(this._storeName, fullKey);
+  }
+
+  async putEntry(fullKey: string, kind: "file" | "dir", dataBase64?: string): Promise<void> {
+    await this._db.put(this._storeName, { [this._keyField]: fullKey, kind, dataBase64 });
+  }
+
+  async deleteByPrefix(keyPrefix: string): Promise<boolean> {
+    return this._db.withStore(this._storeName, "readwrite", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.openCursor();
+        let found = false;
+        req.onsuccess = () => {
+          const cursor = req.result;
+          if (!cursor) {
+            resolve(found);
+            return;
+          }
+          const key = String(cursor.key);
+          if (key === keyPrefix || key.startsWith(keyPrefix + "/")) {
+            found = true;
+            cursor.delete();
+          }
+          cursor.continue();
+        };
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+
+  async listChildren(prefix: string): Promise<{ name: string; isDirectory: boolean }[]> {
+    return this._db.withStore(this._storeName, "readonly", async (store) => {
+      return new Promise((resolve, reject) => {
+        const req = store.openCursor();
+        const map = new Map<string, boolean>();
+        req.onsuccess = () => {
+          const cursor = req.result;
+          if (!cursor) {
+            resolve(
+              Array.from(map.entries()).map(([name, isDirectory]) => ({ name, isDirectory })),
+            );
+            return;
+          }
+          const key = String(cursor.key);
+          if (key.startsWith(prefix)) {
+            const rest = key.slice(prefix.length);
+            if (rest) {
+              const segments = rest.split("/").filter(Boolean);
+              if (segments.length > 0) {
+                const firstSeg = segments[0];
+                if (!map.has(firstSeg)) {
+                  const isDir =
+                    segments.length > 1 || (cursor.value as VirtualFsEntry).kind === "dir";
+                  map.set(firstSeg, isDir);
+                }
+              }
+            }
+          }
+          cursor.continue();
+        };
+        req.onerror = () => reject(req.error);
+      });
+    });
+  }
+
+  async ensureDir(
+    fullKeyBuilder: (path: string) => string,
+    dirPath: string,
+  ): Promise<void> {
+    if (dirPath === "/") {
+      await this.putEntry(fullKeyBuilder("/"), "dir");
+      return;
+    }
+    const segments = dirPath.split("/").filter(Boolean);
+    let acc = "";
+    for (const seg of segments) {
+      acc += "/" + seg;
+      const existing = await this.getEntry(fullKeyBuilder(acc));
+      if (!existing) {
+        await this.putEntry(fullKeyBuilder(acc), "dir");
+      }
+    }
+  }
+}

package/tests/extensions/element-ext.spec.ts

@@ -75,26 +75,6 @@ describe("Element prototype extensions", () => {
       const result = container.findAll("");
       expect(result).toEqual([]);
     });
-
-    it("returns empty array for whitespace-only selector", () => {
-      container.innerHTML = `<div class="item">1</div>`;
-      const result = container.findAll("   ");
-      expect(result).toEqual([]);
-    });
-
-    it("handles comma in attribute selector", () => {
-      container.innerHTML = `
-        <div data-values="a,b,c">1</div>
-        <div class="item">2</div>
-      `;
-
-      // When comma is in attribute selector
-      // Current implementation may split incorrectly, single selector recommended
-      const result = container.findAll('[data-values="a,b,c"]');
-
-      // Edge case behavior verification
-      expect(result.length).toBeGreaterThanOrEqual(0);
-    });
   });
 
   describe("findFirst", () => {
@@ -119,12 +99,6 @@ describe("Element prototype extensions", () => {
       const result = container.findFirst("");
       expect(result).toBeUndefined();
     });
-
-    it("returns undefined for whitespace-only selector", () => {
-      container.innerHTML = `<div class="item">1</div>`;
-      const result = container.findFirst("   ");
-      expect(result).toBeUndefined();
-    });
   });
 
   describe("getParents", () => {
@@ -226,24 +200,6 @@ describe("Element prototype extensions", () => {
       container.style.display = "none";
       expect(container.isVisible()).toBe(false);
     });
-
-    it("determines visibility of element with zero width", () => {
-      container.style.width = "0";
-      container.style.height = "100px";
-      // When getClientRects().length is 0, it is not visible
-      const isVisible = container.isVisible();
-      // May vary depending on browser, verify it is boolean type
-      expect(typeof isVisible).toBe("boolean");
-    });
-
-    it("determines visibility of element with zero height", () => {
-      container.style.width = "100px";
-      container.style.height = "0";
-      // When getClientRects().length is 0, it is not visible
-      const isVisible = container.isVisible();
-      // May vary depending on browser, verify it is boolean type
-      expect(typeof isVisible).toBe("boolean");
-    });
   });
 
   describe("copyElement", () => {
@@ -639,40 +595,6 @@ describe("Element prototype extensions", () => {
       vi.unstubAllGlobals();
     });
 
-    it("supports custom timeout setting", async () => {
-      const mockObserver = {
-        observe: vi.fn(),
-        disconnect: vi.fn(),
-      };
-
-      const MockIntersectionObserver = vi.fn(function (
-        this: IntersectionObserver,
-        callback: IntersectionObserverCallback,
-      ) {
-        // Responds after 100ms
-        setTimeout(() => {
-          callback(
-            [
-              {
-                target: container,
-                boundingClientRect: { top: 0, left: 0, width: 10, height: 10 },
-              },
-            ] as unknown as IntersectionObserverEntry[],
-            this,
-          );
-        }, 100);
-        return mockObserver;
-      });
-
-      vi.stubGlobal("IntersectionObserver", MockIntersectionObserver);
-
-      // Should succeed with 200ms timeout
-      const result = await getBounds([container], 200);
-      expect(result.length).toBe(1);
-
-      vi.unstubAllGlobals();
-    });
-
     it("collects all results even when callback is called multiple times", async () => {
       const el1 = document.createElement("div");
       const el2 = document.createElement("div");

package/tests/extensions/html-element-ext.spec.ts

@@ -59,21 +59,6 @@ describe("HTMLElement prototype extensions", () => {
       expect(() => child.getRelativeOffset(".not-exist")).toThrow(ArgumentError);
     });
 
-    it("handles elements with transforms", () => {
-      container.style.position = "relative";
-      container.style.transform = "scale(2)";
-      container.innerHTML = `<div id="child" style="transform: rotate(45deg);"></div>`;
-
-      const child = container.querySelector<HTMLElement>("#child")!;
-
-      // Should return result without error even with transforms
-      const result = child.getRelativeOffset(container);
-      expect(result).toHaveProperty("top");
-      expect(result).toHaveProperty("left");
-      expect(typeof result.top).toBe("number");
-      expect(typeof result.left).toBe("number");
-    });
-
     it("accumulates border width of intermediate elements", () => {
       container.style.position = "relative";
       container.innerHTML = `