@vectoriox/iox-builder 4.37.1 → 4.37.3

package/index.d.ts

@@ -1446,11 +1446,24 @@ interface ViewportState {
     scale: number;
 }
 declare class ViewportService {
+    /**
+     * True once the scale is something the author chose (restored from storage, or set since) —
+     * false while it is still the DEFAULT guessed below.
+     *
+     * ⚠️ That default used to be a flat 0.75 whatever the window, so on a 1600px screen the 1440
+     * canvas came up 1080 wide inside a ~1026 slot and the page's own left and right edges were
+     * clipped off on first paint. A zoom read-out of "75%" over a page with no visible boundary
+     * tells the author nothing. The builder now fits the canvas to the room it actually has while
+     * this is false, and never touches a remembered zoom. See `autoFitViewport()`.
+     */
+    private scaleIsExplicit;
     private state;
     private stateSubject;
     state$: rxjs.Observable<ViewportState>;
     getState(): ViewportState;
     getScale(): number;
+    /** True when the current scale is this code's guess, not a zoom the author picked. */
+    get scaleIsDefault(): boolean;
     /** Show (and edit) `bp`: the canvas takes that breakpoint's preview width and height. */
     setBreakpoint(bp: Breakpoint): void;
     setScale(scale: number): void;
@@ -1486,6 +1499,8 @@ declare class ViewportService {
      * matching breakpoint (Base / Tablet / Small), so old preferences carry over unchanged.
      */
     private loadFromStorage;
+    /** A saved zoom is the author's choice and is restored; its absence leaves the guess flagged. */
+    private restoreScale;
     static ɵfac: i0.ɵɵFactoryDeclaration<ViewportService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ViewportService>;
 }
@@ -1910,6 +1925,14 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     onBoardMouseDown(event: MouseEvent): void;
     onBoardMouseMove(event: MouseEvent): void;
     onBoardMouseUp(): void;
+    /**
+     * Scale the canvas so the WHOLE page frame fits the slot it is given.
+     *
+     * ⚠️ The gutter here must match `$canvas-inset` in the stylesheet, doubled. It said 20 while
+     * the inset was 20px *per side*, so "Fit" left the frame 40px wider than `.preview-scroll`
+     * can show and `overflow: hidden` ate the difference — the one button whose entire job is to
+     * fit was clipping both edges of the page by 20px.
+     */
     private autoFitViewport;
     selectPanel(panel: string): void;
     handleClick(event: any): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "4.37.1",
+  "version": "4.37.3",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",