craft-native 0.0.85 → 0.0.87

package/dist/api/window.d.ts

@@ -97,8 +97,10 @@ export interface WindowCreateOptions {
     webSidebarMaterial?: boolean;
     /** Width of the native material backdrop behind a web-rendered sidebar */
     webSidebarWidth?: number;
-    /** White/dark tint opacity over the native material backdrop */
+    /** White/dark tint opacity over the native material backdrop (sidebar span only) */
     webSidebarMaterialOpacity?: number;
+    /** Draw that material behind the whole web view instead of a leading strip */
+    webWindowMaterial?: boolean;
     /** Titlebar style (macOS) */
     titlebarStyle?: 'default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover';
     /** Vibrancy effect (macOS) */
@@ -332,6 +334,15 @@ export declare class Window {
      * Set vibrancy effect (macOS)
      */
     setVibrancy(vibrancy: WindowCreateOptions['vibrancy'] | null): Promise<void>;
+    /**
+     * Pin the window to light or dark, or hand it back to the OS (macOS).
+     *
+     * Everything native around the page — a material backdrop, a vibrancy view,
+     * the window buttons — resolves against the *window's* appearance. An app
+     * with its own light/dark control is the only thing that knows which it
+     * picked, so it has to say, or the page and its window disagree.
+     */
+    setAppearance(appearance: 'light' | 'dark' | 'system'): Promise<void>;
     /**
      * Where the platform's window buttons are — read, not written.
      *
@@ -454,6 +465,8 @@ declare class WindowManager {
     setBackgroundColor: (color: string) => Promise<void>;
     /** Set current window vibrancy (macOS) */
     setVibrancy: (vibrancy: WindowCreateOptions['vibrancy'] | null) => Promise<void>;
+    /** Pin the current window to light or dark, or follow the OS (macOS) */
+    setAppearance: (appearance: 'light' | 'dark' | 'system') => Promise<void>;
     /** Set current window resizable */
     setResizable: (resizable: boolean) => Promise<void>;
     /** Start moving current window from a native pointer event */

package/dist/cli.js

@@ -4191,7 +4191,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.85";
+var version = "0.0.87";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -2532,6 +2532,9 @@ class Window {
   async setVibrancy(vibrancy) {
     await this._call("setVibrancy", { vibrancy });
   }
+  async setAppearance(appearance) {
+    await this._call("setAppearance", { appearance });
+  }
   get windowControls() {
     return globalThis.craft?.windowControls;
   }
@@ -2631,6 +2634,7 @@ class WindowManager {
   setOpacity = (opacity) => this.current.setOpacity(opacity);
   setBackgroundColor = (color) => this.current.setBackgroundColor(color);
   setVibrancy = (vibrancy) => this.current.setVibrancy(vibrancy);
+  setAppearance = (appearance) => this.current.setAppearance(appearance);
   setResizable = (resizable) => this.current.setResizable(resizable);
   startDrag = () => this.current.startDrag();
   getState = () => this.current.getState();
@@ -10749,7 +10753,9 @@ class CraftApp {
       args.push("--keep-running");
     else if (window3?.keepRunning === false)
       args.push("--quit-on-close");
-    if (window3?.webSidebarMaterial) {
+    if (window3?.webWindowMaterial) {
+      args.push("--web-window-material");
+    } else if (window3?.webSidebarMaterial) {
       args.push("--web-sidebar-material");
       if (window3?.webSidebarWidth)
         args.push("--web-sidebar-width", String(window3.webSidebarWidth));

package/dist/index.js

@@ -2302,6 +2302,9 @@ class Window {
   async setVibrancy(vibrancy) {
     await this._call("setVibrancy", { vibrancy });
   }
+  async setAppearance(appearance) {
+    await this._call("setAppearance", { appearance });
+  }
   get windowControls() {
     return globalThis.craft?.windowControls;
   }
@@ -2401,6 +2404,7 @@ class WindowManager {
   setOpacity = (opacity) => this.current.setOpacity(opacity);
   setBackgroundColor = (color) => this.current.setBackgroundColor(color);
   setVibrancy = (vibrancy) => this.current.setVibrancy(vibrancy);
+  setAppearance = (appearance) => this.current.setAppearance(appearance);
   setResizable = (resizable) => this.current.setResizable(resizable);
   startDrag = () => this.current.startDrag();
   getState = () => this.current.getState();
@@ -10519,7 +10523,9 @@ class CraftApp {
       args.push("--keep-running");
     else if (window3?.keepRunning === false)
       args.push("--quit-on-close");
-    if (window3?.webSidebarMaterial) {
+    if (window3?.webWindowMaterial) {
+      args.push("--web-window-material");
+    } else if (window3?.webSidebarMaterial) {
       args.push("--web-sidebar-material");
       if (window3?.webSidebarWidth)
         args.push("--web-sidebar-width", String(window3.webSidebarWidth));

package/dist/types.d.ts

@@ -201,9 +201,31 @@ export interface WindowOptions {
     /**
      * White/dark native tint opacity over the sidebar material.
      * Higher values reduce desktop bleed-through while keeping subtle vibrancy.
+     *
+     * `webSidebarMaterial` only — a `webWindowMaterial` window carries no native
+     * tint, because the page is the only thing that knows its colour scheme.
      * @default 0.78
      */
     webSidebarMaterialOpacity?: number;
+    /**
+     * Draw that same material behind the *whole* web view rather than a leading
+     * strip, with nothing opaque beside it.
+     *
+     * Where `webSidebarMaterial` is Finder — vibrancy under the sidebar, a solid
+     * pane beside it — this is System Settings: one material behind everything,
+     * and the page's own cards are the only things with edges.
+     *
+     * Two differences follow, and both are the point rather than side effects:
+     * the window is not pinned to light (so `darkMode` and the system setting
+     * reach the material, and the page's `prefers-color-scheme` agrees with it),
+     * and no native tint is drawn (the page washes the material with its own
+     * translucent background, which is the only wash that knows whether the page
+     * is light or dark).
+     *
+     * Wins over `webSidebarMaterial` when both are set.
+     * @default false
+     */
+    webWindowMaterial?: boolean;
     /**
      * Use native macOS sidebar (Finder-style with vibrancy)
      * Creates a split view with NSOutlineView sidebar and WebView content

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craft-native",
-  "version": "0.0.85",
+  "version": "0.0.87",
   "type": "module",
   "description": "Build desktop apps with web languages - TypeScript SDK for Craft",
   "author": "Chris Breuer <chris@stacksjs.org>",