@nativedesktop/react 0.1.1 → 0.2.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;

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

@@ -7,16 +7,17 @@ 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/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.1",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "homepage": "https://github.com/FormalSnake/NativeDesktop#readme",
@@ -11,46 +11,48 @@
     "directory": "packages/react"
   },
   "publishConfig": {
-  "access": "public"
-},
-"files": ["dist"],
-"main": "./dist/index.js",
-"types": "./dist/packages/react/src/index.d.ts",
-"exports": {
-  ".": {
-    "types": "./dist/packages/react/src/index.d.ts",
-    "default": "./dist/index.js"
+    "access": "public"
   },
-  "./jsx-runtime": {
-    "types": "./dist/packages/react/src/jsx-runtime.d.ts",
-    "default": "./dist/jsx-runtime.js"
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/packages/react/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/packages/react/src/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/packages/react/src/jsx-runtime.d.ts",
+      "default": "./dist/jsx-runtime.js"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/packages/react/src/jsx-dev-runtime.d.ts",
+      "default": "./dist/jsx-dev-runtime.js"
+    },
+    "./rpc": {
+      "types": "./dist/packages/react/src/generated/rpc.d.ts",
+      "default": "./dist/generated/rpc.js"
+    }
   },
-  "./jsx-dev-runtime": {
-    "types": "./dist/packages/react/src/jsx-dev-runtime.d.ts",
-    "default": "./dist/jsx-dev-runtime.js"
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && bun build ./src/index.ts ./src/jsx-runtime.ts ./src/jsx-dev-runtime.ts ./src/generated/rpc.ts --outdir dist --target node --format esm --external react --external react-reconciler --external react-refresh",
+    "prepack": "bun run build",
+    "prepare": "bun run build"
   },
-  "./rpc": {
-    "types": "./dist/packages/react/src/generated/rpc.d.ts",
-    "default": "./dist/generated/rpc.js"
+  "peerDependencies": {
+    "react": "^19.2.7"
+  },
+  "dependencies": {
+    "react-reconciler": "0.33.0",
+    "react-refresh": "0.17.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.17",
+    "@types/react-reconciler": "0.33.0",
+    "@types/react-refresh": "0.14.7",
+    "react": "19.2.7",
+    "typescript": "7.0.2"
   }
-},
-"scripts": {
-  "build": "rm -rf dist && tsc -p tsconfig.build.json && bun build ./src/index.ts ./src/jsx-runtime.ts ./src/jsx-dev-runtime.ts ./src/generated/rpc.ts --outdir dist --target node --format esm --external react --external react-reconciler --external react-refresh",
-  "prepack": "bun run build",
-  "prepare": "bun run build"
-},
-"peerDependencies": {
-  "react": "^19.2.7"
-},
-"dependencies": {
-  "react-reconciler": "0.33.0",
-  "react-refresh": "0.17.0"
-},
-"devDependencies": {
-  "@types/react": "19.2.17",
-  "@types/react-reconciler": "0.33.0",
-  "@types/react-refresh": "0.14.7",
-  "react": "19.2.7",
-  "typescript": "7.0.2"
-}
 }