hyperframes 0.8.103 → 0.8.104

package/dist/studio/assets/{index-DuCZ3pQw.js → index-WV9LroAD.js}

@@ -1,4 +1,4 @@
-import{n as Qi}from"./index-BPJRf2X9.js";/*!
+import{n as Qi}from"./index-De2aO4XM.js";/*!
  * Copyright (c) 2026-present, Vanilagy and contributors
  *
  * This Source Code Form is subject to the terms of the Mozilla Public

package/dist/studio/index.d.ts

@@ -2285,6 +2285,8 @@ interface PropertyPanelProps {
     onSetManualOffset: (element: DomEditSelection, next: {
         x: number;
         y: number;
+    }, route?: {
+        plainTranslate: boolean;
     }) => void | Promise<void>;
     onSetManualSize: (element: DomEditSelection, next: {
         width: number;
@@ -2922,24 +2924,150 @@ interface InlineTextEditCommit {
     previousHtml: string;
 }
 
+/** Where a plain rotate draws its turn, read once at press: the element's own `rotate`, or, when its
+ *  transform translates it (often the translate(-50%, -50%) centring), a rotate() right after that
+ *  translate, so the box turns in place in screen space. `share` is what the rest already turns. */
+interface CssRotationTarget {
+    property: "rotate" | "transform";
+    before: string;
+    after: string;
+    share: number;
+    /** -1 when a mirroring `scale` property flips a turn made inside the transform. */
+    sign: number;
+    /** An inline box does not transform, so the turn makes it inline-block. */
+    inline: boolean;
+}
+type RotationCommit = {
+    angle: number;
+    plain?: CssRotationTarget;
+};
+
+declare const SNAP_THRESHOLD_PX = 6;
+/** Whether a move of this size has travelled far enough for snapping to apply. */
+declare function snapEngagedForTravel(dx: number, dy: number): boolean;
+interface SnapEdge {
+    position: number;
+    source: "grid";
+    id: string;
+}
+interface SnapTarget {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    centerX: number;
+    centerY: number;
+    id: string;
+}
+interface SnapGuide {
+    axis: "x" | "y";
+    position: number;
+    /** Extent of the guide line (min of involved elements). */
+    from: number;
+    /** Extent of the guide line (max of involved elements). */
+    to: number;
+}
+interface SpacingGuide {
+    axis: "x" | "y";
+    /** Position of the gap (start of gap). */
+    position: number;
+    /** Size of the gap in pixels. */
+    size: number;
+    /** Extent for rendering the indicator. */
+    from: number;
+    /** Extent for rendering the indicator. */
+    to: number;
+}
+interface SnapResult {
+    dx: number;
+    dy: number;
+    guides: SnapGuide[];
+    spacingGuides: SpacingGuide[];
+}
+interface Rect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
 /**
- * Why a DOM edit commit did not change the file.
- *
- * `runDomEditCommit` resolves on persist failure by design (see its contract
- * above), so a caller cannot learn whether the write landed by awaiting it — a
- * failed persist and a successful one are indistinguishable. Capture and apply
- * bugs still reject. The human path does not need to ask about handled persist
- * failures, because `onError` already put a toast on screen. A programmatic
- * caller has no screen, so it has to be told.
+ * Convert overlay rects to snap targets with precomputed edges & centers.
  */
-type DomEditCommitDeclineReason = "no-project" | "no-selection" | "geometry-property" | "styles-not-editable" | "not-text-editable" | "preview-stale" | "persist-failed";
-type DomEditCommitOutcome = {
-    ok: true;
-    persistence?: DomEditPersistOutcome;
-} | {
-    ok: false;
-    reason: DomEditCommitDeclineReason;
+declare function extractSnapTargets(entries: Array<{
+    rect: Rect;
+    id: string;
+}>): SnapTarget[];
+/**
+ * Create a snap target from the composition/overlay boundary.
+ */
+declare function buildCompositionSnapTarget(rect: Rect): SnapTarget;
+/**
+ * Generate grid-line snap edges.
+ * `gridSpacing` is in composition pixels; `scale` converts to overlay pixels.
+ * X edges are vertical grid lines; Y edges are horizontal grid lines.
+ */
+declare function buildGridSnapEdges(compositionRect: Rect, gridSpacing: number, scale: number): {
+    x: SnapEdge[];
+    y: SnapEdge[];
 };
+declare function resolveSnapAdjustment(input: {
+    movingRect: Rect;
+    proposedDx: number;
+    proposedDy: number;
+    targets: SnapTarget[];
+    gridEdges?: {
+        x: SnapEdge[];
+        y: SnapEdge[];
+    };
+    threshold: number;
+    disabled: boolean;
+    /** Set when the gesture has not travelled far enough for snapping yet. */
+    disabledForTravel?: boolean;
+    lockedAxis?: "x" | "y";
+}): SnapResult;
+/**
+ * Full-length guide line spanning the composition: a vertical line (axis "x")
+ * runs the composition's height at the snapped x position; a horizontal line
+ * (axis "y") runs the composition's width. `composition` is the composition
+ * rect in overlay space — guide positions are already overlay-space, so the
+ * line must be offset by the composition's left/top (the canvas is usually
+ * letterboxed inside the overlay).
+ */
+declare function resolveGuideLineRect(guide: SnapGuide, composition: Rect): Rect;
+declare function resolveEquidistanceGuides(input: {
+    movingRect: Rect;
+    targets: SnapTarget[];
+    threshold: number;
+}): SpacingGuide[];
+
+interface SnapContext {
+    targets: SnapTarget[];
+    compositionTarget: SnapTarget | null;
+    gridEdges: {
+        x: SnapEdge[];
+        y: SnapEdge[];
+    } | null;
+    snapEnabled: boolean;
+}
+declare function collectSnapContext(input: {
+    overlayEl: HTMLDivElement;
+    iframe: HTMLIFrameElement;
+    excludeElements: Set<HTMLElement>;
+}): SnapContext;
+
+interface SnapGuidesState {
+    guides: SnapGuide[];
+    spacingGuides: SpacingGuide[];
+}
+interface SnapGuideOverlayProps {
+    snapGuidesRef: RefObject<SnapGuidesState | null>;
+    /** Composition rect in overlay space — guide lines span exactly this rect. */
+    compositionLeft: number;
+    compositionTop: number;
+    compositionWidth: number;
+    compositionHeight: number;
+}
+declare const SnapGuideOverlay: react.NamedExoticComponent<SnapGuideOverlayProps>;
 
 interface ApplyDomSelectionOptions {
     revealPanel?: boolean;
@@ -2974,6 +3102,38 @@ interface PreviewMouseDownOptions {
     hoverSelection?: DomEditSelection | null;
 }
 
+interface MoveCommitOptions {
+    altKey?: boolean;
+    plainTranslate?: boolean;
+}
+interface DomEditGroupPathOffsetCommit {
+    selection: DomEditSelection;
+    next: {
+        x: number;
+        y: number;
+    };
+    plainTranslate?: boolean;
+}
+
+/**
+ * Why a DOM edit commit did not change the file.
+ *
+ * `runDomEditCommit` resolves on persist failure by design (see its contract
+ * above), so a caller cannot learn whether the write landed by awaiting it — a
+ * failed persist and a successful one are indistinguishable. Capture and apply
+ * bugs still reject. The human path does not need to ask about handled persist
+ * failures, because `onError` already put a toast on screen. A programmatic
+ * caller has no screen, so it has to be told.
+ */
+type DomEditCommitDeclineReason = "no-project" | "no-selection" | "geometry-property" | "styles-not-editable" | "not-text-editable" | "preview-stale" | "persist-failed";
+type DomEditCommitOutcome = {
+    ok: true;
+    persistence?: DomEditPersistOutcome;
+} | {
+    ok: false;
+    reason: DomEditCommitDeclineReason;
+};
+
 /**
  * Which elements a delete acts on.
  *
@@ -3056,9 +3216,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     handleDomPathOffsetCommit: (selection: DomEditSelection, next: {
         x: number;
         y: number;
-    }, modifiers?: {
-        altKey?: boolean;
-    }) => Promise<void>;
+    }, modifiers?: MoveCommitOptions) => Promise<void>;
     handleDomGroupPathOffsetCommit: (updates: DomEditGroupPathOffsetCommit[]) => Promise<void>;
     handleDomZIndexReorderCommit: (entries: Array<{
         element: HTMLElement;
@@ -3076,9 +3234,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
         x: number;
         y: number;
     }, restore?: () => void) => Promise<void>;
-    handleDomRotationCommit: (selection: DomEditSelection, next: {
-        angle: number;
-    }) => Promise<void>;
+    handleDomRotationCommit: (selection: DomEditSelection, next: RotationCommit) => Promise<void>;
     handleDomManualEditsReset: (selection: DomEditSelection) => Promise<void>;
     handleDomTextCommit: (value: string, fieldKey?: string) => Promise<DomEditCommitOutcome>;
     handleDomTextCommitForSelection: (selection: DomEditSelection, value: string, fieldKey?: string) => Promise<DomEditCommitOutcome>;
@@ -3244,141 +3400,6 @@ declare function PreviewReadOnlyProvider({ readOnly, reason, children, }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
-declare const SNAP_THRESHOLD_PX = 6;
-/** Whether a move of this size has travelled far enough for snapping to apply. */
-declare function snapEngagedForTravel(dx: number, dy: number): boolean;
-interface SnapEdge {
-    position: number;
-    source: "grid";
-    id: string;
-}
-interface SnapTarget {
-    left: number;
-    top: number;
-    right: number;
-    bottom: number;
-    centerX: number;
-    centerY: number;
-    id: string;
-}
-interface SnapGuide {
-    axis: "x" | "y";
-    position: number;
-    /** Extent of the guide line (min of involved elements). */
-    from: number;
-    /** Extent of the guide line (max of involved elements). */
-    to: number;
-}
-interface SpacingGuide {
-    axis: "x" | "y";
-    /** Position of the gap (start of gap). */
-    position: number;
-    /** Size of the gap in pixels. */
-    size: number;
-    /** Extent for rendering the indicator. */
-    from: number;
-    /** Extent for rendering the indicator. */
-    to: number;
-}
-interface SnapResult {
-    dx: number;
-    dy: number;
-    guides: SnapGuide[];
-    spacingGuides: SpacingGuide[];
-}
-interface Rect {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-/**
- * Convert overlay rects to snap targets with precomputed edges & centers.
- */
-declare function extractSnapTargets(entries: Array<{
-    rect: Rect;
-    id: string;
-}>): SnapTarget[];
-/**
- * Create a snap target from the composition/overlay boundary.
- */
-declare function buildCompositionSnapTarget(rect: Rect): SnapTarget;
-/**
- * Generate grid-line snap edges.
- * `gridSpacing` is in composition pixels; `scale` converts to overlay pixels.
- * X edges are vertical grid lines; Y edges are horizontal grid lines.
- */
-declare function buildGridSnapEdges(compositionRect: Rect, gridSpacing: number, scale: number): {
-    x: SnapEdge[];
-    y: SnapEdge[];
-};
-declare function resolveSnapAdjustment(input: {
-    movingRect: Rect;
-    proposedDx: number;
-    proposedDy: number;
-    targets: SnapTarget[];
-    gridEdges?: {
-        x: SnapEdge[];
-        y: SnapEdge[];
-    };
-    threshold: number;
-    disabled: boolean;
-    /** Set when the gesture has not travelled far enough for snapping yet. */
-    disabledForTravel?: boolean;
-    lockedAxis?: "x" | "y";
-}): SnapResult;
-/**
- * Full-length guide line spanning the composition: a vertical line (axis "x")
- * runs the composition's height at the snapped x position; a horizontal line
- * (axis "y") runs the composition's width. `composition` is the composition
- * rect in overlay space — guide positions are already overlay-space, so the
- * line must be offset by the composition's left/top (the canvas is usually
- * letterboxed inside the overlay).
- */
-declare function resolveGuideLineRect(guide: SnapGuide, composition: Rect): Rect;
-declare function resolveEquidistanceGuides(input: {
-    movingRect: Rect;
-    targets: SnapTarget[];
-    threshold: number;
-}): SpacingGuide[];
-
-interface SnapContext {
-    targets: SnapTarget[];
-    compositionTarget: SnapTarget | null;
-    gridEdges: {
-        x: SnapEdge[];
-        y: SnapEdge[];
-    } | null;
-    snapEnabled: boolean;
-}
-declare function collectSnapContext(input: {
-    overlayEl: HTMLDivElement;
-    iframe: HTMLIFrameElement;
-    excludeElements: Set<HTMLElement>;
-}): SnapContext;
-
-interface SnapGuidesState {
-    guides: SnapGuide[];
-    spacingGuides: SpacingGuide[];
-}
-interface SnapGuideOverlayProps {
-    snapGuidesRef: RefObject<SnapGuidesState | null>;
-    /** Composition rect in overlay space — guide lines span exactly this rect. */
-    compositionLeft: number;
-    compositionTop: number;
-    compositionWidth: number;
-    compositionHeight: number;
-}
-declare const SnapGuideOverlay: react.NamedExoticComponent<SnapGuideOverlayProps>;
-
-interface DomEditGroupPathOffsetCommit {
-    selection: DomEditSelection;
-    next: {
-        x: number;
-        y: number;
-    };
-}
-
 /**
  * Pure z-order helpers for the canvas right-click context menu.
  *
@@ -3455,9 +3476,7 @@ interface DomEditOverlayProps {
     onPathOffsetCommit: (selection: DomEditSelection, next: {
         x: number;
         y: number;
-    }, modifiers?: {
-        altKey?: boolean;
-    }) => Promise<unknown> | void;
+    }, modifiers?: MoveCommitOptions) => Promise<unknown> | void;
     onGroupPathOffsetCommit: (updates: DomEditGroupPathOffsetCommit[]) => Promise<unknown> | void;
     onBoxSizeCommit: (selection: DomEditSelection, next: {
         width: number;
@@ -3466,9 +3485,7 @@ interface DomEditOverlayProps {
         x: number;
         y: number;
     }, restore?: () => void) => Promise<unknown> | void;
-    onRotationCommit: (selection: DomEditSelection, next: {
-        angle: number;
-    }) => Promise<unknown> | void;
+    onRotationCommit: (selection: DomEditSelection, next: RotationCommit) => Promise<unknown> | void;
     onStyleCommit?: (property: string, value: string) => Promise<unknown> | void;
     recordingState?: GestureRecordingState;
     onToggleRecording?: () => void;
@@ -3552,9 +3569,7 @@ interface DomGeometryCommits {
     commitPathOffset: (selection: DomEditSelection, next: {
         x: number;
         y: number;
-    }, modifiers?: {
-        altKey?: boolean;
-    }) => Promise<DomEditCommitOutcome>;
+    }, modifiers?: MoveCommitOptions) => Promise<DomEditCommitOutcome>;
     commitGroupPathOffset: (updates: DomEditGroupPathOffsetCommit[]) => Promise<DomEditCommitOutcome>;
     commitBoxSize: (selection: DomEditSelection, next: {
         width: number;
@@ -3563,9 +3578,7 @@ interface DomGeometryCommits {
         x: number;
         y: number;
     }, restore?: () => void) => Promise<DomEditCommitOutcome>;
-    commitRotation: (selection: DomEditSelection, next: {
-        angle: number;
-    }) => Promise<DomEditCommitOutcome>;
+    commitRotation: (selection: DomEditSelection, next: RotationCommit) => Promise<DomEditCommitOutcome>;
     waitForPendingSaves: () => Promise<void>;
 }
 /**

package/dist/studio/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>HyperFrames Studio</title>
-    <script type="module" crossorigin src="/assets/index-BPJRf2X9.js"></script>
+    <script type="module" crossorigin src="/assets/index-De2aO4XM.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-CQN3M56N.css">
   </head>
   <body>