@pictor-sdk/ui 0.2.2 → 0.3.0

package/dist/index.d.mts

@@ -827,6 +827,22 @@ interface LayoutImageFit {
 declare function fitImageToLayoutCell(cell: Rect, documentSize: Size, intrinsic: Size, options?: LayoutCropOptions): LayoutImageFit;
 /** The transform patch that moves a layer into a cell, leaving its other fields alone. */
 declare function cellToTransformPatch(cell: LayoutCell): Partial<Transform>;
+/**
+ * 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
+ */
+declare function layoutCellBox(cell: Rect, documentSize: Size): Size;
 
 /** The active brush: kind, colour and width. Width is a fraction of document width. */
 interface BrushConfig {
@@ -882,4 +898,4 @@ declare function UiStateProvider({ children }: {
 /** Read and write one key of the ephemeral UI state. Throws outside an `<Editor>`. */
 declare function useUiState<T>(key: string, fallback: T): [T, (value: T) => void];
 
-export { type AddPhotoController, type AddPhotoControllerOptions, AddPhotoPanel, AdjustPanel, type BrushConfig, CanvasStage, type CanvasStageProps, CropGestureSurface, type CropGestureSurfaceProps, CropGrid, CropPanel, DEFAULT_BRUSH, type DrawController, DrawPanel, DrawingSurface, Editor, EditorGestures, type EditorGesturesProps, type EditorProps, type EditorSlots, type EditorTheme, FilterStrip, type GestureController, type GestureControllerOptions, type GestureMetrics, type GestureSnapEvent, type GestureSurfaceKind, type HostCallbacks, HostCallbacksProvider, InteractionGuides, type InteractionGuidesProps, InteractionProvider, InvalidImageResultError, LayerGestureSurface, type LayerGestureSurfaceProps, LayersPanel, type LayoutCell, type LayoutCropOptions, type LayoutImageFit, LayoutPanel, type LayoutPreset, MediaPanel, type PartialTheme, STRAIGHTEN_LIMIT, Slider, type SliderProps, type StickerAsset, StickerPanel, StoryMediaGestureSurface, type StoryMediaGestureSurfaceProps, StraightenRuler, type StraightenRulerProps, TextComposer, TextComposerHost, type TextComposerProps, TextPanel, type TextSessionController, ThemeContext, ToolPanelHost, ToolRail, TopBar, type TopBarProps, UiStateProvider, type UiStateStore, type UseTextSessionOptions, canvasSizeForAspect, cellToTransformPatch, centeredCropForAspect, createAddPhotoController, createDrawController, createGestureController, createUiStateStore, defaultTheme, fitImageToLayoutCell, layoutCellBounds, layoutCells, mergeSlots, mergeTheme, radiansToStraighten, resolveGestureSurface, resolvePanel, straightenToRadians, useBaseImageLayer, useBaseMediaLayer, useHostCallbacks, useInteractionState, useTargetImageLayer, useTextSession, useTheme, useUiState };
+export { type AddPhotoController, type AddPhotoControllerOptions, AddPhotoPanel, AdjustPanel, type BrushConfig, CanvasStage, type CanvasStageProps, CropGestureSurface, type CropGestureSurfaceProps, CropGrid, CropPanel, DEFAULT_BRUSH, type DrawController, DrawPanel, DrawingSurface, Editor, EditorGestures, type EditorGesturesProps, type EditorProps, type EditorSlots, type EditorTheme, FilterStrip, type GestureController, type GestureControllerOptions, type GestureMetrics, type GestureSnapEvent, type GestureSurfaceKind, type HostCallbacks, HostCallbacksProvider, InteractionGuides, type InteractionGuidesProps, InteractionProvider, InvalidImageResultError, LayerGestureSurface, type LayerGestureSurfaceProps, LayersPanel, type LayoutCell, type LayoutCropOptions, type LayoutImageFit, LayoutPanel, type LayoutPreset, MediaPanel, type PartialTheme, STRAIGHTEN_LIMIT, Slider, type SliderProps, type StickerAsset, StickerPanel, StoryMediaGestureSurface, type StoryMediaGestureSurfaceProps, StraightenRuler, type StraightenRulerProps, TextComposer, TextComposerHost, type TextComposerProps, TextPanel, type TextSessionController, ThemeContext, ToolPanelHost, ToolRail, TopBar, type TopBarProps, UiStateProvider, type UiStateStore, type UseTextSessionOptions, canvasSizeForAspect, cellToTransformPatch, centeredCropForAspect, createAddPhotoController, createDrawController, createGestureController, createUiStateStore, defaultTheme, fitImageToLayoutCell, layoutCellBounds, layoutCellBox, layoutCells, mergeSlots, mergeTheme, radiansToStraighten, resolveGestureSurface, resolvePanel, straightenToRadians, useBaseImageLayer, useBaseMediaLayer, useHostCallbacks, useInteractionState, useTargetImageLayer, useTextSession, useTheme, useUiState };

package/dist/index.d.ts

@@ -827,6 +827,22 @@ interface LayoutImageFit {
 declare function fitImageToLayoutCell(cell: Rect, documentSize: Size, intrinsic: Size, options?: LayoutCropOptions): LayoutImageFit;
 /** The transform patch that moves a layer into a cell, leaving its other fields alone. */
 declare function cellToTransformPatch(cell: LayoutCell): Partial<Transform>;
+/**
+ * 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
+ */
+declare function layoutCellBox(cell: Rect, documentSize: Size): Size;
 
 /** The active brush: kind, colour and width. Width is a fraction of document width. */
 interface BrushConfig {
@@ -882,4 +898,4 @@ declare function UiStateProvider({ children }: {
 /** Read and write one key of the ephemeral UI state. Throws outside an `<Editor>`. */
 declare function useUiState<T>(key: string, fallback: T): [T, (value: T) => void];
 
-export { type AddPhotoController, type AddPhotoControllerOptions, AddPhotoPanel, AdjustPanel, type BrushConfig, CanvasStage, type CanvasStageProps, CropGestureSurface, type CropGestureSurfaceProps, CropGrid, CropPanel, DEFAULT_BRUSH, type DrawController, DrawPanel, DrawingSurface, Editor, EditorGestures, type EditorGesturesProps, type EditorProps, type EditorSlots, type EditorTheme, FilterStrip, type GestureController, type GestureControllerOptions, type GestureMetrics, type GestureSnapEvent, type GestureSurfaceKind, type HostCallbacks, HostCallbacksProvider, InteractionGuides, type InteractionGuidesProps, InteractionProvider, InvalidImageResultError, LayerGestureSurface, type LayerGestureSurfaceProps, LayersPanel, type LayoutCell, type LayoutCropOptions, type LayoutImageFit, LayoutPanel, type LayoutPreset, MediaPanel, type PartialTheme, STRAIGHTEN_LIMIT, Slider, type SliderProps, type StickerAsset, StickerPanel, StoryMediaGestureSurface, type StoryMediaGestureSurfaceProps, StraightenRuler, type StraightenRulerProps, TextComposer, TextComposerHost, type TextComposerProps, TextPanel, type TextSessionController, ThemeContext, ToolPanelHost, ToolRail, TopBar, type TopBarProps, UiStateProvider, type UiStateStore, type UseTextSessionOptions, canvasSizeForAspect, cellToTransformPatch, centeredCropForAspect, createAddPhotoController, createDrawController, createGestureController, createUiStateStore, defaultTheme, fitImageToLayoutCell, layoutCellBounds, layoutCells, mergeSlots, mergeTheme, radiansToStraighten, resolveGestureSurface, resolvePanel, straightenToRadians, useBaseImageLayer, useBaseMediaLayer, useHostCallbacks, useInteractionState, useTargetImageLayer, useTextSession, useTheme, useUiState };
+export { type AddPhotoController, type AddPhotoControllerOptions, AddPhotoPanel, AdjustPanel, type BrushConfig, CanvasStage, type CanvasStageProps, CropGestureSurface, type CropGestureSurfaceProps, CropGrid, CropPanel, DEFAULT_BRUSH, type DrawController, DrawPanel, DrawingSurface, Editor, EditorGestures, type EditorGesturesProps, type EditorProps, type EditorSlots, type EditorTheme, FilterStrip, type GestureController, type GestureControllerOptions, type GestureMetrics, type GestureSnapEvent, type GestureSurfaceKind, type HostCallbacks, HostCallbacksProvider, InteractionGuides, type InteractionGuidesProps, InteractionProvider, InvalidImageResultError, LayerGestureSurface, type LayerGestureSurfaceProps, LayersPanel, type LayoutCell, type LayoutCropOptions, type LayoutImageFit, LayoutPanel, type LayoutPreset, MediaPanel, type PartialTheme, STRAIGHTEN_LIMIT, Slider, type SliderProps, type StickerAsset, StickerPanel, StoryMediaGestureSurface, type StoryMediaGestureSurfaceProps, StraightenRuler, type StraightenRulerProps, TextComposer, TextComposerHost, type TextComposerProps, TextPanel, type TextSessionController, ThemeContext, ToolPanelHost, ToolRail, TopBar, type TopBarProps, UiStateProvider, type UiStateStore, type UseTextSessionOptions, canvasSizeForAspect, cellToTransformPatch, centeredCropForAspect, createAddPhotoController, createDrawController, createGestureController, createUiStateStore, defaultTheme, fitImageToLayoutCell, layoutCellBounds, layoutCellBox, layoutCells, mergeSlots, mergeTheme, radiansToStraighten, resolveGestureSurface, resolvePanel, straightenToRadians, useBaseImageLayer, useBaseMediaLayer, useHostCallbacks, useInteractionState, useTargetImageLayer, useTextSession, useTheme, useUiState };

package/dist/index.js

@@ -75,6 +75,7 @@ __export(index_exports, {
   defaultTheme: () => defaultTheme,
   fitImageToLayoutCell: () => fitImageToLayoutCell,
   layoutCellBounds: () => layoutCellBounds,
+  layoutCellBox: () => layoutCellBox,
   layoutCells: () => layoutCells,
   mergeSlots: () => mergeSlots,
   mergeTheme: () => mergeTheme,
@@ -2924,6 +2925,13 @@ function fitImageToLayoutCell(cell, documentSize, intrinsic, options = {}) {
 function cellToTransformPatch(cell) {
   return { x: cell.x, y: cell.y, scale: cell.scale, rotation: 0 };
 }
+function layoutCellBox(cell, documentSize) {
+  "worklet";
+  return {
+    width: cell.width * documentSize.width,
+    height: cell.height * documentSize.height
+  };
+}
 
 // src/panels/LayoutPanel.tsx
 var import_jsx_runtime19 = require("react/jsx-runtime");
@@ -4720,6 +4728,7 @@ function TextPanel() {
   defaultTheme,
   fitImageToLayoutCell,
   layoutCellBounds,
+  layoutCellBox,
   layoutCells,
   mergeSlots,
   mergeTheme,