@gjsify/iframe 0.46.0 → 0.47.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -0
- package/package.json +8 -7
package/README.md
CHANGED
|
@@ -14,6 +14,33 @@ npm install @gjsify/iframe
|
|
|
14
14
|
yarn add @gjsify/iframe
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
+
## Where `gi://WebKit` 6.0 comes from
|
|
18
|
+
|
|
19
|
+
This package imports `gi://WebKit?version=6.0` and never branches on the
|
|
20
|
+
operating system. Which typelib answers to that name is decided by packaging —
|
|
21
|
+
one backend per OS:
|
|
22
|
+
|
|
23
|
+
| OS | provider | engine |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| Linux | the system WebKitGTK | WebKit |
|
|
26
|
+
| macOS | [`@gjsify/webkit-native`](../webkit-native/README.md) ([ADR 0022](https://github.com/gjsify/gjsify/blob/main/docs/adr/0022-webkit-on-darwin.md)) | Apple's WebKit |
|
|
27
|
+
| Windows | [`@gjsify/webview2-native`](../webview2-native/README.md) ([ADR 0035](https://github.com/gjsify/gjsify/blob/main/docs/adr/0035-web-view-on-win32.md)) | Chromium, via WebView2 |
|
|
28
|
+
|
|
29
|
+
Both shims are ordinary dependencies of this package and contain no JavaScript.
|
|
30
|
+
Each one's prebuilt library and typelib arrive through its *own* per-target
|
|
31
|
+
`optionalDependencies`, which a package manager installs only on the matching
|
|
32
|
+
`os`/`cpu` and silently skips everywhere else
|
|
33
|
+
([ADR 0017](https://github.com/gjsify/gjsify/blob/main/docs/adr/0017-native-package-distribution.md)).
|
|
34
|
+
So a Linux install pulls in two empty packages and no binaries at all.
|
|
35
|
+
|
|
36
|
+
> **Windows is stage 1, and stage 1 is not a widget.** `@gjsify/webview2-native`
|
|
37
|
+
> hosts an OS-composited child window that sits *outside* GSK's scene graph, and
|
|
38
|
+
> the hosted path itself — re-parenting under a real GTK toplevel, bounds
|
|
39
|
+
> tracking, hiding on unmap — is **not yet verified**; everything green so far
|
|
40
|
+
> ran against a hidden parking window. Read that package's README before
|
|
41
|
+
> relying on it: a full-page document in a window works, a web view used as an
|
|
42
|
+
> ordinary widget does not.
|
|
43
|
+
|
|
17
44
|
## Usage
|
|
18
45
|
|
|
19
46
|
```typescript
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gjsify/iframe",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.47.0",
|
|
4
4
|
"description": "HTMLIFrameElement for GJS, backed by WebKit.WebView",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"module": "lib/esm/index.js",
|
|
@@ -48,14 +48,15 @@
|
|
|
48
48
|
"@girs/gtk-4.0": "4.6.0",
|
|
49
49
|
"@girs/javascriptcore-6.0": "4.6.0",
|
|
50
50
|
"@girs/webkit-6.0": "4.6.0",
|
|
51
|
-
"@gjsify/dom-elements": "^0.
|
|
52
|
-
"@gjsify/dom-events": "^0.
|
|
53
|
-
"@gjsify/message-channel": "^0.
|
|
54
|
-
"@gjsify/webkit-native": "^0.
|
|
51
|
+
"@gjsify/dom-elements": "^0.47.0",
|
|
52
|
+
"@gjsify/dom-events": "^0.47.0",
|
|
53
|
+
"@gjsify/message-channel": "^0.47.0",
|
|
54
|
+
"@gjsify/webkit-native": "^0.47.0",
|
|
55
|
+
"@gjsify/webview2-native": "^0.47.0"
|
|
55
56
|
},
|
|
56
57
|
"devDependencies": {
|
|
57
|
-
"@gjsify/cli": "^0.
|
|
58
|
-
"@gjsify/unit": "^0.
|
|
58
|
+
"@gjsify/cli": "^0.47.0",
|
|
59
|
+
"@gjsify/unit": "^0.47.0",
|
|
59
60
|
"@types/node": "^25.9.2",
|
|
60
61
|
"typescript": "^6.0.3"
|
|
61
62
|
},
|