ewvjs 1.0.10 → 1.0.12

package/README.md

@@ -143,10 +143,42 @@ Once a window is created, you can control it using the returned `Window` instanc
 *   **Interaction**:
     *   `setTitle(title)`
     *   `showTitlebar()`, `hideTitlebar()`
-    *   `evaluate(script)`: Execute JavaScript in the WebView.
+    *   `evaluate(script, [frame])`: Execute JavaScript in the WebView or target a specific subframe/iframe context.
     *   `setIcon(path)`
 *   **Cookies**: `getCookies()`, `setCookie(name, value, domain, path)`, `clearCookies()`
 
+### Executing JavaScript inside IFrames (Cross-Origin Bypass)
+
+The `evaluate` method supports executing and injecting JavaScript directly inside any subframe/iframe context, completely bypassing standard browser Same-Origin Policy (SOP) limitations. This enables the native Node.js layer to inspect and mutate the DOM of cross-origin or same-origin subframes natively.
+
+```typescript
+async evaluate(script: string, frame?: string | number): Promise<any>
+```
+
+#### Parameters:
+*   `script`: The JavaScript code string to execute.
+*   `frame` *(optional)*: The target subframe selector. This can be:
+    *   **String**: The iframe's `name` attribute value (case-insensitive) or a substring of the iframe's loaded `src` URL.
+    *   **Number**: The internal unique frame registry identifier.
+
+#### Example:
+```javascript
+// Execute on top-level main document
+const title = await win.evaluate("document.title");
+
+// Execute inside a cross-origin iframe using its frame name
+const iframeText = await win.evaluate(
+    "document.querySelector('h1').innerText", 
+    "my-frame-name"
+);
+
+// Execute inside an iframe targeted by its loaded URL substring
+await win.evaluate(
+    "document.body.style.background = '#8b5cf6'", 
+    "example.com/payment"
+);
+```
+
 ### Custom Context Menus
 
 Define native context menus using `on_context_menu`. It should return an array of `ContextMenuItem` objects.
@@ -196,25 +228,53 @@ Create a new ewvjs project with a sample application structure.
 
 **Usage:**
 ```bash
-npx ewvjs-cli init [name]
+npx ewvjs-cli init [name] [options]
 ```
 
 **Arguments:**
 *   `name` - Project name (default: `my-ewvjs-app`)
 
+**Options:**
+*   `-t, --template <template>` - Template to initialize (`basic` | `react`) (default: `basic`)
+*   `-l, --list-templates` - List all available templates
+
 **Example:**
 ```bash
-npx ewvjs-cli init my-awesome-app
+npx ewvjs-cli init my-awesome-app --template react
 cd my-awesome-app
 npm install
-npm start
+npm run dev
 ```
 
-This creates:
-*   `package.json` - Project configuration with scripts
-*   `app.js` - Sample application with Node.js integration
-*   `assets/` - Directory for static assets
-*   `README.md` - Project documentation
+### Project Templates
+
+`ewvjs-cli` supports two official templates out of the box:
+
+#### 1. Basic Template (`basic` - default)
+A simple, lightweight setup using plain static assets:
+- **`app.js`**: Main host controller containing standard Node.js exposure hooks.
+- **`assets/`**: Pure HTML/CSS/JS frontend files loaded natively via `file://` resolution.
+
+#### 2. React Template (`react`)
+A premium, feature-rich React 19 + Vite 8 + TypeScript development environment:
+- **Vite Bundler**: Ultra-fast build times and hot-reload configs.
+- **Premium Styling**: Pre-configured global CSS resets, sleek glassmorphic themes, and linear gradients styled around the **Outfit** Google Font.
+- **HMR Developer Runner**: Spawns a parallel Vite developer server and embeds it directly into the native ewvjs window, rendering real-time UI changes dynamically as you edit.
+- **Type-Safe Host API**: Employs global typed window definitions for fully intelligent, warning-free React-to-Node API communications.
+
+**React Workflow Commands:**
+```bash
+# Initialize a new React project
+npx ewvjs-cli init my-react-app --template react
+cd my-react-app
+npm install
+
+# Run the HMR interactive developer window
+npm run dev
+
+# Compile React static outputs and build a standalone packaged exe
+npm run package
+```
 
 ---
 
@@ -240,7 +300,6 @@ npx ewvjs-cli package <entry> [options]
 | `--assets <dir>` | `-a` | Assets directory to include in package | `./assets` |
 | `--target <target>` | `-t` | Target platform | `node18-win-x64` |
 | `--modules <modules>` | `-m` | Additional node modules to bundle (comma-separated) | None |
-| `--no-native` | | Skip bundling native DLLs (if already included) | Includes by default |
 
 **Examples:**
 
@@ -257,7 +316,6 @@ npx ewvjs-cli package app.js \
   --icon icon.ico \
   --assets ./public \
   --modules axios,lodash \
-  --compress
 ```
 
 Package with custom target:

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,QAAA,MAAM,KAAK,SAAgB,CAAC;AAC5B,eAAe,KAAK,CAAC;AAGrB,eAAO,MAAM,aAAa,8HAAkC,CAAC;AAC7D,eAAO,MAAM,KAAK,qBAA0B,CAAC;AAC7C,eAAO,MAAM,MAAM,wCAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+BA,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,QAAA,MAAM,KAAK,SAAgB,CAAC;AAC5B,eAAe,KAAK,CAAC;AAGrB,eAAO,MAAM,aAAa,8HAAkC,CAAC;AAC7D,eAAO,MAAM,KAAK,qBAA0B,CAAC;AAC7C,eAAO,MAAM,MAAM,wCAA2B,CAAC"}

package/dist/index.js

@@ -15,8 +15,13 @@ if (isPkg) {
         // Since pkg locks Module properties, we need to intercept requires at a higher level
         // Add the node_modules path to require.resolve paths by modifying module.paths
         // This needs to be done for every module, so we'll hook into the module creation
-        if (typeof require.main !== 'undefined' && require.main.paths) {
-            require.main.paths.unshift(nodeModulesPath);
+        try {
+            if (typeof require !== 'undefined' && require.main !== 'undefined' && require.main.paths) {
+                require.main.paths.unshift(nodeModulesPath);
+            }
+        }
+        catch (e) {
+            // Ignore ReferenceError in pure ES module environments
         }
     }
 }

package/dist/window.d.ts

@@ -17,7 +17,7 @@ export declare class Window {
     get is_closed(): boolean;
     run(): Promise<any>;
     private _call;
-    evaluate(script: string): Promise<any>;
+    evaluate(script: string, frame?: string | number): Promise<any>;
     close(): Promise<any>;
     destroy(): Promise<any>;
     maximize(): Promise<any>;

package/dist/window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D,qBAAa,MAAM;IAClB,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IAEvB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IAEnD,eAAe,EAAE,CAChB,KAAK,EAAE,GAAG,EAAE,KACR,eAAe,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAC3D;gBAGL,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAkB9C,IAAI,MAAM,kBAET;IAED,IAAI,SAAS,YAEZ;IAEK,GAAG;YAmBK,KAAK;IAoCb,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAItC,KAAK;IAQL,OAAO;IAKP,QAAQ;IAGR,OAAO;IAGP,QAAQ;IAGR,KAAK;IAGL,IAAI;IAGJ,IAAI;IAKJ,OAAO;IAGP,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIpC,UAAU;IAGV,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIxC,WAAW;IAGX,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAGhC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAKzB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAKtB,YAAY;IAGZ,YAAY;IAKZ,OAAO,CAAC,QAAQ,EAAE,MAAM;IAKxB,UAAU;IAGV,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAW,EACnB,IAAI,GAAE,MAAY;IAIb,YAAY;YAIJ,WAAW;IAkEzB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;YAOV,kBAAkB;YAYlB,sBAAsB;YAmBtB,oBAAoB;YAUpB,kBAAkB;IAUhC,OAAO,CAAC,YAAY;CAkBpB"}
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D,qBAAa,MAAM;IAClB,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IAEvB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IAEnD,eAAe,EAAE,CAChB,KAAK,EAAE,GAAG,EAAE,KACR,eAAe,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAC3D;gBAGL,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAkB9C,IAAI,MAAM,kBAET;IAED,IAAI,SAAS,YAEZ;IAEK,GAAG;YAmBK,KAAK;IAoCb,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAS/D,KAAK;IAQL,OAAO;IAKP,QAAQ;IAGR,OAAO;IAGP,QAAQ;IAGR,KAAK;IAGL,IAAI;IAGJ,IAAI;IAKJ,OAAO;IAGP,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIpC,UAAU;IAGV,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIxC,WAAW;IAGX,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAGhC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAKzB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAKtB,YAAY;IAGZ,YAAY;IAKZ,OAAO,CAAC,QAAQ,EAAE,MAAM;IAKxB,UAAU;IAGV,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAW,EACnB,IAAI,GAAE,MAAY;IAIb,YAAY;YAIJ,WAAW;IAkEzB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;YAOV,kBAAkB;YAYlB,sBAAsB;YAmBtB,oBAAoB;YAUpB,kBAAkB;IAUhC,OAAO,CAAC,YAAY;CAkBpB"}

package/dist/window.js

@@ -77,7 +77,10 @@ export class Window {
         }
     }
     // Core methods
-    async evaluate(script) {
+    async evaluate(script, frame) {
+        if (frame !== undefined) {
+            return this._call("evaluate", { script, frame });
+        }
         return this._call("evaluate", script);
     }
     async close() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ewvjs",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Embedded WebView for JavaScript - Edge WebView2 bindings for Node.js",
   "workspaces": [
     "packages/*"
@@ -11,8 +11,10 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist/**/*",
@@ -53,4 +55,4 @@
     "mime-types": "^3.0.2",
     "node-api-dotnet": "^0.9.19"
   }
-}
+}