create-opentray 0.21.1 → 0.23.0

package/README.md

@@ -2,15 +2,15 @@
 
 # create-opentray
 
-Turn any start command that serves HTTP locally into an OpenTray-hosted
-desktop app — through a browser wizard or fully non-interactively, without
-writing OpenTray code.
+Turn any start command that serves HTTP locally — or any http(s) URL — into
+an OpenTray-hosted desktop app: through a browser wizard or fully
+non-interactively, without writing OpenTray code.
 
 ```bash
 npx create-opentray
 ```
 
-Requires Node >= 20 (native `sharp` icon pipeline).
+Requires Node >= 20.
 
 ## Command tree
 
@@ -40,8 +40,30 @@ npx create-opentray create \
 
 - `--arg` is repeatable; each value is ONE exact argv element — never a shell
   string (`&&` stays a literal argument).
-- Icon sources: local files, `http(s)` URLs, or `data:` URLs. The CLI never
-  scrapes names or favicons.
+- `--url <address>` packages the http(s) URL directly as an application
+  (no command): `npx create-opentray create --url https://example.com` derives
+  the app id/name from the address (`https://example.com/app` →
+  `app.com.example` / `App`); override with `--app-id`/`--app-name`. It is
+  mutually exclusive with `--exec`/`--arg`/`--cwd`/`--env`, and the generated
+  app opens one window at the address with no terminal or PTY. Because the
+  address is known up front (unlike a command that must run first), creation
+  scrapes the page once and adopts its `<title>` and best favicon as
+  defaults — explicit flags always win, failures fall back silently
+  (address-derived name + glyph icon), and `--no-scrape` disables the fetch.
+- URL app window options: `--toolbar` hosts the shared address-bar wrapper
+  (back/forward/reload buttons, address input, and the ⌘/Ctrl+←→, ⌘/Ctrl+[
+  ], ⌘/Ctrl+R, F5, ⌘/Ctrl+L shortcuts while focus is in the wrapper). Sites
+  that forbid iframe embedding cannot be wrapped: creation probes the page's
+  embedding policy during the default scrape and, when the target refuses
+  (`X-Frame-Options` / CSP `frame-ancestors`), prints a notice and falls
+  back to the direct window automatically (with `--no-scrape` there is no
+  probe data, so the toolbar request stands). Every URL app's tray menu
+  offers Reload regardless of toolbar mode. By default the window title follows the
+  page (`--no-title-follow` to stop) and the icon does NOT follow favicon
+  changes at runtime (`--icon-follow` to enable); both persist in the v1
+  config and round-trip through export.
+- Icon sources: local files, `http(s)` URLs, or `data:` URLs. Outside URL-mode
+  enrichment the CLI never scrapes names or favicons.
 - `--config <file>` loads a complete v1 document; explicit flags override
   only their named fields.
 - `--dry-run` prints the plan without mutating anything.

package/dist/avif-DCXcyYJR.mjs

@@ -0,0 +1,2 @@
+import decode from "./decode-Dsj9J0OD.mjs";
+export { decode };