@hyperframes/studio 0.8.102 → 0.8.104

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

@@ -1,4 +1,4 @@
-import{n as Qi}from"./index-C2utDZt-.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/{chunk-MTAVNAGW.js → chunk-46XP7J3B.js}

@@ -2,7 +2,7 @@ import {
   buildProjectApiPath,
   getSourceScopedSelectorIndex,
   withSelectorIndexPass
-} from "./chunk-S65AQH6M.js";
+} from "./chunk-DI4LCJHL.js";
 
 // src/components/editor/probeSourceElement.ts
 async function probeSourceElement(projectId, sourceFile, target) {
@@ -1061,4 +1061,4 @@ export {
   readHfId,
   buildDomEditPatchTarget
 };
-//# sourceMappingURL=chunk-MTAVNAGW.js.map
+//# sourceMappingURL=chunk-46XP7J3B.js.map

package/dist/{chunk-S65AQH6M.js → chunk-DI4LCJHL.js}

@@ -40,8 +40,9 @@ function getSourceScopedSelectorIndex(doc, el, selector, sourceFile, resolveSour
 
 // src/utils/projectRouting.ts
 var PROJECT_HASH_PREFIX = "#project/";
+var WINDOWS_DRIVE_PREFIX = /^[a-z]:/i;
 function isValidProjectId(value) {
-  return value.length > 0 && value !== "." && value !== ".." && !value.includes(":") && !value.includes("/") && !value.includes("\\") && !Array.from(value).some((char) => char.charCodeAt(0) < 32);
+  return value.length > 0 && value !== "." && value !== ".." && !WINDOWS_DRIVE_PREFIX.test(value) && !value.includes("/") && !value.includes("\\") && !Array.from(value).some((char) => char.charCodeAt(0) < 32);
 }
 function decodeHashProjectId(value) {
   try {
@@ -98,4 +99,4 @@ export {
   withSelectorIndexPass,
   getSourceScopedSelectorIndex
 };
-//# sourceMappingURL=chunk-S65AQH6M.js.map
+//# sourceMappingURL=chunk-DI4LCJHL.js.map

package/dist/chunk-DI4LCJHL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/sourceScopedSelectorIndex.ts","../src/utils/projectRouting.ts"],"sourcesContent":["/**\n * Occurrence index for a selector within its source document.\n *\n * The preview flattens multiple composition files into one DOM, so a raw\n * `querySelectorAll` index is not a stable source-file identity. Callers supply\n * their existing source resolver; this helper alone owns occurrence scoping.\n */\n\n/** Every element matching one selector, mapped to the source file it belongs to\n *  and its occurrence index within that file. One document query fills it. */\ntype SelectorOccurrences = Map<Element, { scope: string; index: number }>;\n\ninterface SelectorIndexPass {\n  doc: Document;\n  bySelector: Map<string, SelectorOccurrences>;\n}\n\nlet activePass: SelectorIndexPass | null = null;\n\n/**\n * Share one occurrence index per selector across every\n * `getSourceScopedSelectorIndex` call made synchronously inside `run`.\n *\n * Unshared, each call runs its own whole-document `querySelectorAll(selector)`\n * and resolves the source file of every match. A rebuild that walks n elements\n * sharing a selector therefore does n whole-document queries and n² resolver\n * calls — a composition of repeated cards or tiles is exactly that shape. One\n * index per selector makes the same pass linear.\n *\n * Correctness rests on the pass being ONE synchronous walk of a document that\n * does not change under it: nothing invalidates the index, so `run` must not\n * mutate `doc`, and every call inside it must resolve source files the same way\n * (the resolver may be a fresh closure per call, as long as it answers the\n * same). Outside a pass the index is per-call, exactly as before.\n */\nexport function withSelectorIndexPass<T>(doc: Document, run: () => T): T {\n  const previous = activePass;\n  activePass = { doc, bySelector: new Map() };\n  try {\n    return run();\n  } finally {\n    activePass = previous;\n  }\n}\n\nfunction buildOccurrences(\n  doc: Document,\n  selector: string,\n  resolveSourceFile: (candidate: Element) => string | undefined,\n): SelectorOccurrences {\n  const occurrences: SelectorOccurrences = new Map();\n  const counts = new Map<string, number>();\n  for (const candidate of doc.querySelectorAll(selector)) {\n    const scope = resolveSourceFile(candidate) ?? \"index.html\";\n    const index = counts.get(scope) ?? 0;\n    counts.set(scope, index + 1);\n    occurrences.set(candidate, { scope, index });\n  }\n  return occurrences;\n}\n\nexport function getSourceScopedSelectorIndex(\n  doc: Document,\n  el: Element,\n  selector: string | undefined,\n  sourceFile: string | undefined,\n  resolveSourceFile: (candidate: Element) => string | undefined,\n): number | undefined {\n  if (!selector || selector.startsWith(\"#\") || selector.startsWith(\"[data-composition-id=\")) {\n    return undefined;\n  }\n\n  try {\n    const pass = activePass?.doc === doc ? activePass : null;\n    let occurrences = pass?.bySelector.get(selector);\n    if (!occurrences) {\n      occurrences = buildOccurrences(doc, selector, resolveSourceFile);\n      pass?.bySelector.set(selector, occurrences);\n    }\n    // An element outside the requested scope is not in that scope's occurrence\n    // run at all, which is the `indexOf` miss the filtered form returned before.\n    const hit = occurrences.get(el);\n    return hit && hit.scope === (sourceFile ?? \"index.html\") ? hit.index : undefined;\n  } catch {\n    return undefined;\n  }\n}\n","const PROJECT_HASH_PREFIX = \"#project/\";\n\nexport interface ProjectHashRoute {\n  projectId: string;\n  params: URLSearchParams;\n}\n\nconst WINDOWS_DRIVE_PREFIX = /^[a-z]:/i;\n\n/** Project names are single path segments, including when received from a hash or server. */\nexport function isValidProjectId(value: string): boolean {\n  return (\n    value.length > 0 &&\n    value !== \".\" &&\n    value !== \"..\" &&\n    !WINDOWS_DRIVE_PREFIX.test(value) &&\n    !value.includes(\"/\") &&\n    !value.includes(\"\\\\\") &&\n    !Array.from(value).some((char) => char.charCodeAt(0) < 32)\n  );\n}\n\nfunction decodeHashProjectId(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction normalizeHashParams(\n  params?: URLSearchParams | Record<string, string | null | undefined>,\n): URLSearchParams {\n  if (!params) return new URLSearchParams();\n  if (params instanceof URLSearchParams) return params;\n\n  const next = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (!key || value == null || value === \"\") continue;\n    next.set(key, value);\n  }\n  return next;\n}\n\nexport function encodeProjectId(projectId: string): string {\n  if (!isValidProjectId(projectId)) throw new Error(\"Invalid project ID\");\n  return encodeURIComponent(projectId);\n}\n\nexport function buildProjectHash(\n  projectId: string,\n  params?: URLSearchParams | Record<string, string | null | undefined>,\n): string {\n  const search = normalizeHashParams(params).toString();\n  return `${PROJECT_HASH_PREFIX}${encodeProjectId(projectId)}${search ? `?${search}` : \"\"}`;\n}\n\nexport function parseProjectHashRoute(hash: string): ProjectHashRoute | null {\n  if (!hash.startsWith(PROJECT_HASH_PREFIX)) return null;\n\n  const route = hash.slice(PROJECT_HASH_PREFIX.length);\n  const queryIndex = route.indexOf(\"?\");\n  const encodedProjectId = queryIndex >= 0 ? route.slice(0, queryIndex) : route;\n  if (!encodedProjectId || encodedProjectId.includes(\"/\")) return null;\n\n  const projectId = decodeHashProjectId(encodedProjectId);\n  if (!isValidProjectId(projectId)) return null;\n\n  const rawParams = queryIndex >= 0 ? route.slice(queryIndex + 1) : \"\";\n  return {\n    projectId,\n    params: new URLSearchParams(rawParams),\n  };\n}\n\nexport function parseProjectIdFromHash(hash: string): string | null {\n  return parseProjectHashRoute(hash)?.projectId ?? null;\n}\n\nexport function buildProjectApiPath(projectId: string, suffix = \"\"): string {\n  const normalizedSuffix = suffix && !suffix.startsWith(\"/\") ? `/${suffix}` : suffix;\n  return `/api/projects/${encodeProjectId(projectId)}${normalizedSuffix}`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-7X4XRP3L.js → chunk-HIGHVWYD.js}

@@ -4,7 +4,7 @@ import {
 import {
   buildProjectApiPath,
   getSourceScopedSelectorIndex
-} from "./chunk-S65AQH6M.js";
+} from "./chunk-DI4LCJHL.js";
 
 // src/player/lib/time.ts
 var STUDIO_PREVIEW_FPS = 30;
@@ -1890,4 +1890,4 @@ export {
   whenPreviewBooted,
   Player
 };
-//# sourceMappingURL=chunk-7X4XRP3L.js.map
+//# sourceMappingURL=chunk-HIGHVWYD.js.map

package/dist/{domEditingLayers-NU6Z5QWA.js → domEditingLayers-AQBDFNUC.js}

@@ -20,8 +20,8 @@ import {
   resolveDomEditCapabilities,
   resolveDomEditSelection,
   serializeDomEditTextFields
-} from "./chunk-MTAVNAGW.js";
-import "./chunk-S65AQH6M.js";
+} from "./chunk-46XP7J3B.js";
+import "./chunk-DI4LCJHL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   buildDefaultDomEditTextField,
@@ -46,4 +46,4 @@ export {
   resolveDomEditSelection,
   serializeDomEditTextFields
 };
-//# sourceMappingURL=domEditingLayers-NU6Z5QWA.js.map
+//# sourceMappingURL=domEditingLayers-AQBDFNUC.js.map

package/dist/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>;
@@ -3089,7 +3245,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     getGsapAnimationsForSelection: (selection: DomEditSelection) => _hyperframes_parsers.GsapAnimation[] | Promise<_hyperframes_parsers.GsapAnimation[]>;
     handleAskAgent: () => void;
     handleAgentModalSubmit: (userInstruction: string) => Promise<void>;
-    handleBlockedDomMove: (selection: DomEditSelection) => void;
+    handleBlockedDomMove: (selection: DomEditSelection, reason?: string) => void;
     handleDomManualDragStart: () => void;
     handleDomEditElementDelete: (selection: DomEditSelection, options?: {
         expandGroup?: boolean;
@@ -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.
  *
@@ -3450,14 +3471,12 @@ interface DomEditOverlayProps {
         revealPanel?: boolean;
         additive?: boolean;
     }) => void;
-    onBlockedMove: (selection: DomEditSelection) => void;
+    onBlockedMove: (selection: DomEditSelection, reason?: string) => void;
     onManualDragStart?: () => void;
     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/index.html

@@ -5,8 +5,8 @@
     <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-C2utDZt-.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-xB5O0hPw.css">
+    <script type="module" crossorigin src="/assets/index-De2aO4XM.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CQN3M56N.css">
   </head>
   <body>
     <div data-hf-id="hf-aph5" id="root"></div>