dsh-browser-plus 0.0.0-stage → 0.5.1

package/lib/browser-electron/icon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Platform icon resolver for the shared browser host window.
+ *
+ * Maps the current platform to the matching generated icon derivative and
+ * returns its absolute path, or undefined when the asset is missing (so the
+ * host can build the window without the icon rather than fail). No files are
+ * read at import time; only the resolver itself touches the filesystem.
+ * @module dsh-browser-plus/browser-electron/icon
+ */
+/** Absolute path of this platform's BrowserWindow icon, or undefined. */
+export declare function resolveBrowserIconPath(platform?: NodeJS.Platform): string | undefined;

package/lib/browser-electron/icon.js

@@ -0,0 +1,23 @@
+/**
+ * Platform icon resolver for the shared browser host window.
+ *
+ * Maps the current platform to the matching generated icon derivative and
+ * returns its absolute path, or undefined when the asset is missing (so the
+ * host can build the window without the icon rather than fail). No files are
+ * read at import time; only the resolver itself touches the filesystem.
+ * @module dsh-browser-plus/browser-electron/icon
+ */
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/** Icon filename for each platform; any unknown platform falls back to linux. */
+const ICON_BY_PLATFORM = {
+    win32: 'dsh-browser-plus.ico',
+    darwin: 'dsh-browser-plus-512.png',
+    linux: 'dsh-browser-plus-256.png',
+};
+/** Absolute path of this platform's BrowserWindow icon, or undefined. */
+export function resolveBrowserIconPath(platform = process.platform) {
+    const filename = ICON_BY_PLATFORM[platform] ?? ICON_BY_PLATFORM.linux;
+    const path = fileURLToPath(new URL('../../assets/' + filename, import.meta.url));
+    return existsSync(path) ? path : undefined;
+}

package/lib/browser-electron/page-chrome.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Human-facing browser chrome injected into the top-level page document.
+ * Keeping this UI in the page renderer avoids a second Electron
+ * WebContentsView and leaves the host composition tree stable.
+ */
+export declare const PAGE_CHROME_HOST_ID = "__dsh_browser_chrome_host__";
+export declare const PAGE_CHROME_ATTRIBUTE = "data-dsh-browser-chrome";
+/** Generated once; stable across documents and reused by the provider. */
+export declare const PAGE_CHROME_SCRIPT: string;
+/** Convert human address-bar text into an allowed HTTP(S) navigation target. */
+export declare function normalizeBrowserAddress(raw: string): string;
+/**
+ * Build a self-contained CDP page-start script.
+ *
+ * @param bindingToken - per-view secret echoed back on every chrome control
+ *   message. It is captured in the injected IIFE's closure, so page scripts can
+ *   call the CDP binding but cannot read the token back out. Omit it for hosts
+ *   that do not authenticate page-emitted controls (see {@link PAGE_CHROME_SCRIPT}).
+ */
+export type ChromeSurface = 'full' | 'frame' | 'page';
+export declare function buildPageChromeScript(bindingToken?: string, surface?: ChromeSurface): string;