@nativedesktop/react 0.1.2 → 0.3.0

package/dist/packages/react/src/generated/protocol.d.ts

@@ -1,5 +1,5 @@
 export declare const NDP_VERSION = 1;
-export type WidgetName = "Window" | "Box" | "Label" | "Button" | "TextInput" | "TextArea" | "Checkbox" | "Radio" | "Select" | "Slider" | "ProgressBar" | "Image" | "ScrollView" | "Separator" | "Spinner" | "TabView" | "Grid" | "ListView" | "WebView" | "NativeView" | "SplitView" | "HeaderBar" | "ToolbarView" | "SearchInput" | "SourceList" | "SourceTree" | "Menubar" | "Menu" | "MenuItem" | "SettingsGroup" | "Row" | "SwitchRow" | "Clamp" | "Switch" | "ToggleButton" | "SegmentedControl" | "NumberInput" | "LinkButton" | "LevelIndicator" | "ColorPicker" | "Banner" | "MenuButton" | "SplitButton" | "Popover" | "Expander" | "StatusPage" | "ToastOverlay" | "DatePicker" | "Table" | "TreeView" | "FontPicker" | "Video" | "TrayItem" | "ShareButton" | "Terminal" | "Paned" | "CommandPalette";
+export type WidgetName = "Window" | "Box" | "Label" | "Button" | "TextInput" | "TextArea" | "Checkbox" | "Radio" | "Select" | "Slider" | "ProgressBar" | "Image" | "ScrollView" | "Separator" | "Spinner" | "TabView" | "Grid" | "ListView" | "WebView" | "NativeView" | "SplitView" | "HeaderBar" | "ToolbarView" | "SearchInput" | "SourceList" | "SourceTree" | "Menubar" | "Menu" | "MenuItem" | "SettingsGroup" | "Row" | "SwitchRow" | "Clamp" | "Switch" | "ToggleButton" | "SegmentedControl" | "NumberInput" | "LinkButton" | "LevelIndicator" | "ColorPicker" | "Banner" | "MenuButton" | "SplitButton" | "Popover" | "Expander" | "StatusPage" | "ToastOverlay" | "DatePicker" | "Table" | "TreeView" | "FontPicker" | "Video" | "TrayItem" | "ShareButton" | "Terminal" | "Paned" | "CommandPalette" | "Avatar" | "Badge" | "Tag" | "Kbd" | "ComboBox" | "Breadcrumb" | "Dialog" | "Sheet" | "RichText" | "ProgressCircle" | "Skeleton" | "Chart" | "CodeEditor";
 /** Child runtime identity, carried inside the hello frame. */
 export interface Runtime {
     name: string;

package/dist/packages/react/src/generated/rpc.d.ts

@@ -5,12 +5,14 @@ export interface Geometry {
     w: number;
     h: number;
 }
-/** SourceList's per-row shape on the wire (M11 SourceList Wave 1) — camelCase iconName, matching the schema prop shape. testID carries SourceTree's per-node testID (null for SourceList rows, which have none). */
+/** The per-row shape on the wire, shared by every row-driven widget (SourceList `items`, SourceTree `nodes`, CommandPalette `items`) — camelCase iconName, matching the schema prop shape. testID carries SourceTree's per-node testID (null for SourceList rows, which have none); id and subtitle carry the row's own identity and secondary line where the widget's item type has them (CommandPaletteItem, SourceTreeNode), so a drive can name a row instead of counting to it. */
 export interface RowJson {
     title: string;
     badge: string | null;
     iconName: string | null;
     testID: string | null;
+    id: string | null;
+    subtitle: string | null;
 }
 /** One tree-snapshot node. itemCount is ListView's row count (M5c-D4), null for every widget that isn't data-driven; rows is SourceList's ordered row data, null for every widget that isn't row-driven. role/enabled/focused/value are the accessibility-tree fields (M16): role is the widget's schema-declared automation role (null when the type declares none); enabled/focused/value come from a live per-node backend probe and default to true/false/null on backends without the probe. */
 export interface JsonNode {
@@ -62,7 +64,7 @@ export interface ScrollResult {
     x: number;
     y: number;
 }
-/** Exactly one selector: textContains | refVisible | testId. With testId, `state` (default "present", one of present|gone|visible|enabled|disabled|focused) picks the predicate and countAtLeast/valueEquals/valueContains refine it. valueEquals/valueContains compare against the node's a11y value STRING RENDERING (numbers stringified, bools "true"/"false") so one predicate works for TextInput and Slider alike. Every predicate is evaluated host-side on the retained tree plus the live a11y probe, once per ~50ms tick — never a getTree round trip. */
+/** Exactly one selector: textContains | refVisible | testId. With testId, `state` (default "present", one of present|gone|visible|enabled|disabled|focused) picks the predicate and countAtLeast/valueEquals/valueContains refine it. valueEquals/valueContains compare against the node's a11y value STRING RENDERING (numbers stringified, bools "true"/"false") so one predicate works for TextInput and Slider alike. urlContains/pageTitleContains/pageTextContains are PAGE predicates and refine a testId selector the same way; the node they name must be a WebView. url and title come from the engine directly, but pageTextContains INJECTS JAVASCRIPT (document.body.innerText) into the page world, re-probed at most once per 250ms and matched against the last answer — so a match can lag the page by one probe. Every predicate is evaluated host-side on the retained tree plus the live probes, once per ~50ms tick — never a getTree round trip. */
 export interface WaitCondition {
     textContains?: string;
     refVisible?: number;
@@ -71,6 +73,9 @@ export interface WaitCondition {
     countAtLeast?: number;
     valueEquals?: string;
     valueContains?: string;
+    urlContains?: string;
+    pageTitleContains?: string;
+    pageTextContains?: string;
 }
 export interface ResolveResult {
     ref: number | null;
@@ -104,6 +109,22 @@ export interface DragResult {
 export interface KeysResult {
     dispatched: boolean;
 }
+/** Live page state read off the engine on the UI thread (WebKitGTK's uri/title/is-loading/can-go-back/can-go-forward, WKWebView's url/title/isLoading/canGoBack/canGoForward) — no page JavaScript, no app cooperation. url/title are null before the first commit. */
+export interface WebViewInfo {
+    ref: number;
+    url: string | null;
+    title: string | null;
+    loading: boolean;
+    canGoBack: boolean;
+    canGoForward: boolean;
+}
+/** `value` is the result's STRING rendering (the engine's own JSValue-to-string), the same shape the javaScriptResult event carries — never a typed JSON value. On a thrown exception `ok` is false and `error` carries the engine's message. */
+export interface WebViewEvalResult {
+    ref: number;
+    ok: boolean;
+    value: string | null;
+    error: string | null;
+}
 /** Full tree snapshot with stable refs, testIDs, text, logical geometry, and accessibility state (role/enabled/focused/value). window (if given) must be a Window node ref and scopes the snapshot to that window's subtree; absent, the root/first window is used and other windows' nodes attach as orphans. */
 export interface GetTreeParams {
     window?: number;
@@ -181,6 +202,21 @@ export interface PointerParams {
     clickCount?: number;
     window?: number;
 }
+/** Live page state for a WebView node: {url, title, loading, canGoBack, canGoForward}. Read straight off the engine, so a drive can assert what a page did without the app forwarding its navigate/titleChanged events. Target by exactly one of ref / testId (window optionally scopes testId resolution); a target that is not a WebView answers -32602. */
+export interface WebviewInfoParams {
+    ref?: number;
+    testId?: string;
+    window?: number;
+}
+/** Evaluates `code` in a WebView node's page and answers the result's string rendering. `world` picks an isolated content world by name (absent/empty = the page's own world), matching the executeJavaScript command. The engine's evaluation is asynchronous: the host starts it, then polls its own UI thread until it settles or timeoutMs elapses (-32002). A thrown exception is a RESULT with ok:false, not an RPC error. Target by exactly one of ref / testId; a target that is not a WebView answers -32602. */
+export interface WebviewEvalParams {
+    ref?: number;
+    testId?: string;
+    window?: number;
+    code: string;
+    world?: string;
+    timeoutMs?: number;
+}
 /** Press-move-release gesture. Endpoints are widget refs (their centers; fromRef/toRef must share a window) or explicit coordinates (fromX/fromY/toX/toY in the target window, default root). The full down/dragged.../up sequence is posted as one batch so native mouse-tracking loops (slider thumbs, split dividers) consume it like a real drag. Unsupported on GTK (-32003). */
 export interface DragParams {
     fromRef?: number;
@@ -252,6 +288,14 @@ export interface RpcMethods {
         params: PointerParams;
         result: PointerResult;
     };
+    webviewInfo: {
+        params: WebviewInfoParams;
+        result: WebViewInfo;
+    };
+    webviewEval: {
+        params: WebviewEvalParams;
+        result: WebViewEvalResult;
+    };
     drag: {
         params: DragParams;
         result: DragResult;
@@ -280,6 +324,11 @@ export declare const RPC_ERRORS: {
         readonly code: -32003;
         readonly message: "input synthesis unsupported on this backend";
     };
+    /** data: {window}. getTree/screenshot only: params.window named a real Window ref (e.g. from windows()) that has since closed, distinguishing a benign concurrent-close race from invalidParams (a malformed request). Every other window-scoped method resolves a closed window into its own no-match result instead of this error. */
+    readonly windowGone: {
+        readonly code: -32004;
+        readonly message: "window closed";
+    };
     readonly methodNotFound: {
         readonly code: -32601;
         readonly message: "method not found";

package/dist/packages/react/src/generated/schema-meta.d.ts

@@ -8,7 +8,7 @@ export declare const intrinsicToName: Record<string, string>;
 export interface WidgetEvent {
     name: string;
     handler: string;
-    payload: "none" | "text" | "checked" | "value" | "index" | "data";
+    payload: "none" | "text" | "checked" | "value" | "index" | "indexes" | "data" | "position" | "dragPoint";
 }
 export declare const widgetEvents: Record<string, WidgetEvent[]>;
 export declare const handlerPropNames: Record<string, string[]>;
@@ -18,9 +18,20 @@ export declare const widgetCommands: Record<string, readonly string[]>;
 /** Compile-time command-name map (only widgets with commands appear). */
 export type WidgetCommandNames = {
     "window": "showAlert" | "openFile" | "saveFile" | "showAbout" | "showTabOverview" | "present";
-    "webview": "goBack" | "goForward" | "reload" | "stop" | "executeJavaScript" | "setZoom" | "setUserAgent" | "openDevTools";
+    "button": "focus";
+    "textinput": "focus";
+    "textarea": "focus";
+    "checkbox": "focus";
+    "radio": "focus";
+    "select": "focus";
+    "webview": "goBack" | "goForward" | "reload" | "stop" | "executeJavaScript" | "setZoom" | "setUserAgent" | "openDevTools" | "addUserScript" | "removeUserScript" | "clearUserScripts" | "registerScriptMessage" | "unregisterScriptMessage" | "respondScheme" | "getCookies" | "setCookie" | "deleteCookie" | "findStart" | "findNext" | "findPrevious" | "findStop" | "saveSession" | "restoreSession" | "setMuted" | "setContextMenuItems" | "focus";
+    "searchinput": "focus";
+    "switch": "focus";
+    "numberinput": "focus";
     "toastoverlay": "showToast" | "dismissToast";
     "terminal": "copy" | "paste" | "selectAll" | "clearSelection" | "focus";
+    "combobox": "focus";
+    "codeeditor": "focus";
 };
 /** Platform availability (schema `platforms`): null = every platform. A
  *  widget listing only some platforms renders natively there and is an

package/dist/packages/react/src/index.d.ts

@@ -2,21 +2,22 @@ export { render, sendCommand, sendNativeCommand, createPortal, createPool, moveN
 export type { Pool } from "./renderer.ts";
 export { Platform, hasWidget, hasCommand } from "./platform.ts";
 export type { Backend, OS } from "./platform.ts";
-export { Spacing, ContentMargin } from "./metrics.ts";
+export { Spacing, ContentMargin, ContentWidth } from "./metrics.ts";
 export type { SpacingScale } from "./metrics.ts";
 export { getAppDataDir, ensureAppDataDir } from "./paths.ts";
 export { defineNativeComponent } from "./native-component.ts";
 export type { NativeComponentOptions, NativeComponentProps, NativeComponentRef } from "./native-component.ts";
-export { executeJavaScript, onJavaScriptResult } from "./webview.ts";
+export { executeJavaScript, onJavaScriptResult, getCookies, onCookiesResult, saveSession, onSessionSaved, setContextMenuItems, } from "./webview.ts";
+export type { Cookie, ContextMenuContext, ContextMenuItem, ContextMenuItemClick } from "./webview.ts";
 export { showAlert, openFile, saveFile, showAbout, showTabOverview, onAlertResult, onOpenFileResult, onSaveFileResult, } from "./dialogs.ts";
 export type { DialogButton, ShowAlertOptions, AlertResult, OpenFileOptions as WindowOpenFileOptions, OpenFileResult as WindowOpenFileResult, SaveFileOptions as WindowSaveFileOptions, SaveFileResult as WindowSaveFileResult, ShowAboutOptions, } from "./dialogs.ts";
 export { showToast, dismissToast, onToastButtonClicked, onToastDismissed } from "./toast.ts";
 export type { ToastPriority, ShowToastOptions, ToastResult } from "./toast.ts";
 export type { Instance } from "./host-config.ts";
-export type { NdNodeRef, WidgetType, TableColumn, TableRow, TreeNode, SourceTreeAction, SourceTreeNode } from "./generated/intrinsics.ts";
+export type { NdNodeRef, WidgetType, TableColumn, TableRow, TreeNode, SourceTreeAction, SourceTreeNode, CommandPaletteItem, ChartPoint, ChartSeries, CodeDiagnostic, } from "./generated/intrinsics.ts";
 export { performRefresh, registerExports, fullReload } from "./hmr.ts";
-export { useState, useEffect, useLayoutEffect, useMemo, useCallback, useRef, useContext, useReducer, useTransition, useDeferredValue, useSyncExternalStore, useId, use, startTransition, memo, forwardRef, createContext, Suspense, Fragment, } from "./dev-react.ts";
-export { dialog, clipboard, notifications, recentDocuments, credentials, app, system, audio } from "./system.ts";
+export { useState, useEffect, useLayoutEffect, useMemo, useCallback, useRef, useContext, useReducer, useTransition, useDeferredValue, useSyncExternalStore, useId, use, startTransition, memo, forwardRef, createContext, Suspense, Fragment, Activity, } from "./dev-react.ts";
+export { dialog, clipboard, notifications, recentDocuments, credentials, app, system, audio, webviewEngine } from "./system.ts";
 export type { FileFilter, OpenFileOptions, SaveFileOptions, MessageLevel, MessageOptions, NotificationOptions, Appearance, AppearanceInfo, AudioPlayOptions, AudioState, AudioStateEvent, AudioSpectrumEvent, } from "./system.ts";
 export { openExternal, openPath, revealPath } from "./shell.ts";
 export { onUnhandledError, setUnhandledErrorPolicy } from "./errors.ts";

package/dist/packages/react/src/metrics.d.ts

@@ -10,3 +10,19 @@ export declare const Spacing: SpacingScale;
  * binding (a number export cannot be a getter): read it at render time, not
  * into a module-scope constant. */
 export declare let ContentMargin: number;
+/** The platform's reading measure for settings-shaped content — the width to
+ * cap a content column at, as `<clamp maximumSize>`.
+ *
+ * A column, not a widget: the cap belongs to whatever holds the column so
+ * every child shares it. This matters on AppKit, where `<settingsgroup>` is a
+ * SwiftUI grouped `Form` and that style caps and centers its own card inside
+ * whatever width it is handed. A `<codeeditor>` or `<table>` beside it has no
+ * such cap, so the two disagree by however wide the pane happens to be, and
+ * neither `maxWidth: .infinity` nor a wider frame turns the Form's cap off.
+ * Clamping the column below the cap settles it: the Form stops capping, its
+ * card fills the column, and its siblings line up with it. GTK has the same
+ * shape natively — AdwPreferencesGroup fills its AdwClamp — so one tree reads
+ * correctly on both.
+ *
+ * A live binding for the same reason `ContentMargin` is. */
+export declare let ContentWidth: number;

package/dist/packages/react/src/system.d.ts

@@ -126,6 +126,42 @@ export declare const system: {
     /** Subscribes to system appearance/accent changes. Returns an unsubscribe function. */
     onAppearanceChange(handler: (info: AppearanceInfo) => void): () => void;
 };
+export interface RegisterSchemeOptions {
+    /**
+     * Lets pages read the scheme cross-origin. GTK marks the scheme CORS-enabled
+     * on the WebKitSecurityManager; without it a `fetch()` from another origin is
+     * refused before any response header is consulted. **AppKit ignores this**
+     * (see the asymmetry note on `registerScheme`).
+     */
+    corsEnabled?: boolean;
+    /**
+     * Makes the scheme's origins secure contexts, which is what `crypto.subtle`,
+     * IndexedDB and service workers require. **GTK only** — WebKit's Cocoa API
+     * has no public equivalent.
+     */
+    secure?: boolean;
+}
+/** Engine-level `<webview>` configuration. `core:webview` is default-granted. */
+export declare const webviewEngine: {
+    /**
+     * Registers a custom URI scheme (`crx`, `app`, …) with the web engine.
+     * Requests for it arrive as the `schemeRequest` event on the `<webview>`
+     * that made them, and the app answers with the `respondScheme` command.
+     *
+     * MUST be called before the first `<webview>` mounts: WebKit binds scheme
+     * handlers to a configuration/context that is frozen once a view exists.
+     * Calling it later rejects with "registerScheme must be called before the
+     * first <webview> mounts".
+     *
+     * Backend asymmetry: `corsEnabled` and `secure` take effect on GTK only.
+     * WebKitGTK exposes a WebKitSecurityManager for both; WebKit's Cocoa API
+     * keeps that registry as SPI, so on AppKit the options are accepted and
+     * ignored. Cross-origin reads still work there through `respondScheme`'s
+     * `Access-Control-Allow-Origin` header — a secure context cannot be granted
+     * at all.
+     */
+    registerScheme(scheme: string, options?: RegisterSchemeOptions): Promise<void>;
+};
 export interface AudioPlayOptions {
     path?: string;
     url?: string;

package/dist/packages/react/src/webview.d.ts

@@ -1,5 +1,46 @@
 import type { NdNodeRef } from "./generated/intrinsics.ts";
-export declare function executeJavaScript(node: NdNodeRef<"webview">, code: string): Promise<string>;
+export declare function executeJavaScript(node: NdNodeRef<"webview">, code: string, world?: string): Promise<string>;
 export declare function onJavaScriptResult(e: {
     data: unknown;
 }): void;
+export interface Cookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    secure: boolean;
+    httpOnly: boolean;
+    /** Unix seconds, or null for a session cookie. */
+    expires: number | null;
+    sameSite: "None" | "Lax" | "Strict";
+}
+export declare function getCookies(node: NdNodeRef<"webview">, url?: string): Promise<Cookie[]>;
+export declare function onCookiesResult(e: {
+    data: unknown;
+}): void;
+export declare function saveSession(node: NdNodeRef<"webview">): Promise<string>;
+export declare function onSessionSaved(e: {
+    data: unknown;
+}): void;
+export type ContextMenuContext = "all" | "page" | "link" | "image" | "selection" | "editable";
+export interface ContextMenuItem {
+    id?: string;
+    label?: string;
+    type?: "normal" | "checkbox" | "radio" | "separator";
+    checked?: boolean;
+    enabled?: boolean;
+    contexts?: ContextMenuContext[];
+    targetUrlGlobs?: string[];
+    children?: ContextMenuItem[];
+}
+export interface ContextMenuItemClick {
+    id: string;
+    pageUrl: string;
+    linkUrl?: string;
+    imageUrl?: string;
+    selectionText?: string;
+    editable: boolean;
+    checked?: boolean;
+    wasChecked?: boolean;
+}
+export declare function setContextMenuItems(node: NdNodeRef<"webview">, items: ContextMenuItem[]): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nativedesktop/react",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "homepage": "https://github.com/FormalSnake/NativeDesktop#readme",