mirinjs 0.0.1-alpha.3 → 0.0.1-alpha.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirinjs",
-  "version": "0.0.1-alpha.3",
+  "version": "0.0.1-alpha.5",
   "description": "Build desktop apps with Bun, TypeScript, and Chromium (CEF). The Bun-native Electron alternative.",
   "type": "module",
   "license": "MIT",

package/src/app.ts

@@ -32,6 +32,14 @@ export type AppEvents = {
   "window-all-closed": void;
 };
 
+/** A window's frame in screen points (bottom-left origin, like AppKit). */
+export interface WindowFrame {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
 type Listener<P> = (payload: P) => void;
 
 class Emitter<Events extends Record<string, unknown>> {
@@ -127,6 +135,31 @@ export class WindowHandle extends Emitter<WindowEvents> {
     runtime().core.windowSetMaterial(this.id, JSON.stringify(normalizeMaterial(material)));
   }
 
+  /** Move the window's bottom-left origin to screen point (x, y), in points. */
+  setPosition(x: number, y: number): void {
+    runtime().core.windowSetPosition(this.id, x, y);
+  }
+
+  /** The latest known window frame (screen points, bottom-left origin). Tracked
+   *  from `moved`/`resized` events, so it's current without a round-trip. */
+  getFrame(): WindowFrame {
+    return this.#frame ?? { x: 0, y: 0, width: 0, height: 0 };
+  }
+
+  /** Whether the window is currently zoomed (maximized). */
+  isMaximized(): boolean {
+    return this.#maximized;
+  }
+
+  #frame: WindowFrame | null = null;
+  #maximized = false;
+
+  /** @internal — fed from native window frame events. */
+  _setFrame(frame: WindowFrame, maximized: boolean): void {
+    this.#frame = frame;
+    this.#maximized = maximized;
+  }
+
   #control(verb: string): void {
     runtime().core.windowControl(this.id, verb);
   }
@@ -322,7 +355,15 @@ export function wireAppEvents(): void {
   for (const kind of WINDOW_EVENTS) {
     onNativeEvent(`window.${kind}`, (event: NativeEvent) => {
       const id = event.id as number | undefined;
-      if (id != null) app.windows._byId(id)?._emit(kind, undefined);
+      if (id == null) return;
+      const handle = app.windows._byId(id);
+      if (!handle) return;
+      // moved/resized carry the current frame + maximized state; track them so
+      // getFrame()/isMaximized() are answerable without a round-trip.
+      if (event.frame) {
+        handle._setFrame(event.frame as WindowFrame, Boolean(event.maximized));
+      }
+      handle._emit(kind, undefined);
     });
   }
 }

package/src/config.ts

@@ -42,6 +42,9 @@ export interface WindowConfig {
   title?: string;
   width?: number;
   height?: number;
+  /** Screen position (bottom-left origin, points). Centered when absent. */
+  x?: number;
+  y?: number;
   /** "ready" (default) shows on first paint to avoid a white flash. */
   show?: "ready" | "immediately";
   /** "auto" (default) opens at launch; "manual" windows are templates for app.windows.open(name). */
@@ -70,6 +73,12 @@ export interface MirinConfig {
   name: string;
   /** Main-process entry, relative to the project root (runs in the Bun Worker). */
   main: string;
+  /**
+   * App icon, relative to the project root (macOS). Accepts a `.icns`, a
+   * `.iconset` directory, or a single square `.png` (≥512px) that mirin renders
+   * into an `.icns`. Embedded in the bundle for the Dock and Finder.
+   */
+  icon?: string;
   windows: Record<string, WindowConfig>;
 }
 

package/src/index.ts

@@ -27,6 +27,7 @@ export { NotAttachedError } from "./runtime.ts";
 export type {
   WindowEvents,
   WindowMaterialInfo,
+  WindowFrame,
   AppEvents,
   WindowHandle,
   WindowOpenOptions,

package/src/native.ts

@@ -23,6 +23,7 @@ const symbols = {
   mirin_window_set_title: { args: [FFIType.u32, FFIType.ptr], returns: FFIType.void },
   mirin_window_control: { args: [FFIType.u32, FFIType.ptr], returns: FFIType.void },
   mirin_window_set_material: { args: [FFIType.u32, FFIType.ptr], returns: FFIType.void },
+  mirin_window_set_position: { args: [FFIType.u32, FFIType.f64, FFIType.f64], returns: FFIType.void },
   mirin_app_quit: { args: [], returns: FFIType.void },
   mirin_app_set_dock_visible: { args: [FFIType.i32], returns: FFIType.void },
   mirin_set_app_menu: { args: [FFIType.ptr], returns: FFIType.void },
@@ -108,6 +109,10 @@ export class Core {
     this.#lib.symbols.mirin_window_set_material(id, ptr(buf));
   }
 
+  windowSetPosition(id: number, x: number, y: number): void {
+    this.#lib.symbols.mirin_window_set_position(id, x, y);
+  }
+
   quit(): void {
     this.#lib.symbols.mirin_app_quit();
   }

package/src/runtime.ts

@@ -35,9 +35,14 @@ export function runtime(): Runtime {
   return current;
 }
 
-/** Dev: every window loads the Vite server. Production: its manifest app:// URL. */
+/** Dev: every window loads the Vite server. Production: its manifest app:// URL.
+ *  Any query/hash on the requested URL (e.g. "#devtools") is preserved so
+ *  hash-routed sub-windows reach the right view through the dev server too. */
 export function resolveUrl(url: string): string {
-  return current?.devUrl ?? url;
+  const devUrl = current?.devUrl;
+  if (!devUrl) return url;
+  const suffix = url.match(/[?#].*$/)?.[0] ?? "";
+  return devUrl + suffix;
 }
 
 // ---- native event dispatch ----