@pictor-sdk/ui 0.2.2 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pictor-sdk/ui",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Default slot-based editor UI for Pictor, built entirely on the public headless API.",
   "license": "MIT",
   "sideEffects": false,
@@ -33,8 +33,8 @@
     "react-native-gesture-handler": ">=2.20.0",
     "react-native-reanimated": ">=3.16.0",
     "react-native-worklets": ">=0.5.1",
-    "@pictor-sdk/skia": "^0.2.1",
-    "@pictor-sdk/core": "^0.2.0"
+    "@pictor-sdk/core": "^0.2.0",
+    "@pictor-sdk/skia": "^0.3.0"
   },
   "devDependencies": {
     "@shopify/react-native-skia": "^2.0.0",
@@ -45,7 +45,7 @@
     "react-native-reanimated": "^4.1.0",
     "react-native-worklets": "0.5.1",
     "@pictor-sdk/core": "0.2.0",
-    "@pictor-sdk/skia": "0.2.1"
+    "@pictor-sdk/skia": "0.3.0"
   },
   "publishConfig": {
     "access": "public",

package/src/index.ts

@@ -67,7 +67,7 @@ export { StickerPanel, type StickerAsset } from './panels/StickerPanel'
 export { LayersPanel } from './panels/LayersPanel'
 export { LayoutPanel } from './panels/LayoutPanel'
 export { layoutCells, cellToTransformPatch, type LayoutCell, type LayoutPreset } from './panels/layoutMath'
-export { layoutCellBounds, fitImageToLayoutCell, type LayoutCropOptions, type LayoutImageFit } from './panels/layoutMath'
+export { layoutCellBounds, layoutCellBox, fitImageToLayoutCell, type LayoutCropOptions, type LayoutImageFit } from './panels/layoutMath'
 export { DrawingSurface, DEFAULT_BRUSH } from './gestures/DrawingSurface'
 export { createDrawController, type BrushConfig, type DrawController } from './gestures/drawController'
 export { UiStateProvider, useUiState, createUiStateStore, type UiStateStore } from './uiState'

package/src/panels/layoutMath.ts

@@ -110,3 +110,26 @@ export function fitImageToLayoutCell(
 export function cellToTransformPatch(cell: LayoutCell): Partial<Transform> {
   return { x: cell.x, y: cell.y, scale: cell.scale, rotation: 0 }
 }
+
+/**
+ * The box a photo draws into when it fills one cell, in document pixels.
+ *
+ * The cell fixes the box: `fitImageToLayoutCell` picks a crop whose aspect
+ * matches the cell, so zooming and panning inside it move the source window
+ * and leave the box alone. That is what makes a live crop expressible as a
+ * source-space override at all, and it is why a cell's bounds cannot drift
+ * while a gesture is running.
+ *
+ * Paired with `imageSourceTransform` from `@pictor-sdk/skia`, this is
+ * everything a host needs to draw an uncommitted crop from a worklet, using
+ * the renderer's own arithmetic rather than a second copy of it.
+ *
+ * @experimental
+ */
+export function layoutCellBox(cell: Rect, documentSize: Size): Size {
+  'worklet'
+  return {
+    width: cell.width * documentSize.width,
+    height: cell.height * documentSize.height,
+  }
+}