@ai-matrx/summon 0.1.7 → 0.1.9

package/dist/window.d.cts

@@ -47,8 +47,9 @@ interface UseWindowPanelOptions {
      */
     onAutoNoRoom?: (() => void) | undefined;
     /**
-     * @deprecated Pass `width`, `height`, and `position` instead.
-     * Low-level initial rect — overrides width/height/position when provided.
+     * Explicit placement: open at exactly this rect (any of x, y, width, height). Overrides
+     * width/height/position and is never auto-placed — for hosts that place windows themselves,
+     * e.g. a canvas full of controls where auto-placement finds no free gutter.
      */
     initialRect?: Partial<WindowRect> | undefined;
     /** Maximum width the user can resize to. */

package/dist/window.d.ts

@@ -47,8 +47,9 @@ interface UseWindowPanelOptions {
      */
     onAutoNoRoom?: (() => void) | undefined;
     /**
-     * @deprecated Pass `width`, `height`, and `position` instead.
-     * Low-level initial rect — overrides width/height/position when provided.
+     * Explicit placement: open at exactly this rect (any of x, y, width, height). Overrides
+     * width/height/position and is never auto-placed — for hosts that place windows themselves,
+     * e.g. a canvas full of controls where auto-placement finds no free gutter.
      */
     initialRect?: Partial<WindowRect> | undefined;
     /** Maximum width the user can resize to. */

package/dist/window.js

@@ -496,7 +496,8 @@ function useWindowPanel(opts = {}) {
     const h = opts.initialRect?.height ?? resolveSize(opts.height, DEFAULT_HEIGHT);
     const { vw, vh } = safeViewportDims();
     let autoPlaced = null;
-    if (opts.autoOpened && vw >= NARROW_VIEWPORT) {
+    const explicitlyPlaced = opts.initialRect?.x !== void 0 || opts.initialRect?.y !== void 0;
+    if (opts.autoOpened && !explicitlyPlaced && vw >= NARROW_VIEWPORT) {
       {
         const ap = autoPlacement();
         if (!ap.order.has(id)) ap.order.set(id, ap.next++);