canvu-react 0.3.17 → 0.3.20

package/dist/index.d.cts

@@ -266,6 +266,42 @@ declare function cloneVectorSceneItemsWithNewIds(items: readonly VectorSceneItem
  */
 declare function cullItemsByViewport(items: readonly VectorSceneItem[], visibleWorld: Rect): VectorSceneItem[];
 
+declare const MANAGED_KEY = "managed";
+declare function isManagedImage(item: VectorSceneItem): boolean;
+declare function markImageAsManaged(item: VectorSceneItem): VectorSceneItem;
+/**
+ * Repositions every managed image into a single vertical stack. The stack
+ * origin is the current topmost (minimum Y) managed item — that point in world
+ * space is stable across reorder/copy/delete operations, so reorder swaps slots
+ * instead of making the whole stack drift downward. Subsequent items are
+ * centered on the anchor's center X and stacked downward with a fixed gap.
+ *
+ * Non-managed items keep their position. Call this after any operation that
+ * changes the relative order or count of managed images so the canvas reflects
+ * the menu order.
+ */
+declare function restackManagedImages(items: readonly VectorSceneItem[]): VectorSceneItem[];
+/**
+ * Marks `newItem` as a managed image (locked + `pluginData.managed = true`),
+ * appends it to `items`, and restacks all managed images so the new one lands
+ * at the bottom of the stack with the anchor preserved.
+ *
+ * Typical usage: after producing scene items with
+ * `ingestAssetFilesToSceneItems`, push each result through this helper to add
+ * them to the managed-images stack:
+ *
+ * ```ts
+ * let next = doc.items;
+ * for (const created of result.items) next = addManagedImage(next, created);
+ * doc.onItemsChange(next);
+ * ```
+ */
+declare function addManagedImage(items: readonly VectorSceneItem[], newItem: VectorSceneItem): VectorSceneItem[];
+declare function copyManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function rotateManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function deleteManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function reorderManagedImages(items: readonly VectorSceneItem[], orderedManagedIds: readonly string[]): VectorSceneItem[];
+
 /** Default body font size for vector text (local SVG units). */
 declare const DEFAULT_TEXT_FONT_SIZE = 18;
 /**
@@ -274,4 +310,4 @@ declare const DEFAULT_TEXT_FONT_SIZE = 18;
  */
 declare function buildTextSvg(content: string, _width: number, _height: number, fillColor?: string, fontSize?: number): string;
 
-export { ARROW_BIND_SNAP_PX, type ApplePencilNavOptions, ArrowEndpointBinding, Camera2D, type CreateCustomShapeContent, type CustomShapeSize, DEFAULT_TEXT_FONT_SIZE, type LoadRasterImageFileOptions, MAX_RASTER_EMBED_DIMENSION, type RasterEmbedMode, type RasterSceneSource, Rect, SvgVectorRenderer, type SvgVectorRendererOptions, VectorScene, VectorSceneItem, type ViewportInputOptions, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildCustomShapeChildrenSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, createCustomShapeItem, cullItemsByViewport, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, isArrowBindTarget, itemHitTestWorldPoint, loadImageFileAsRasterSceneSource, resolveArrowBindingsInScene, snapArrowEndpointToShape };
+export { ARROW_BIND_SNAP_PX, type ApplePencilNavOptions, ArrowEndpointBinding, Camera2D, type CreateCustomShapeContent, type CustomShapeSize, DEFAULT_TEXT_FONT_SIZE, type LoadRasterImageFileOptions, MANAGED_KEY, MAX_RASTER_EMBED_DIMENSION, type RasterEmbedMode, type RasterSceneSource, Rect, SvgVectorRenderer, type SvgVectorRendererOptions, VectorScene, VectorSceneItem, type ViewportInputOptions, addManagedImage, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildCustomShapeChildrenSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, copyManagedImage, createCustomShapeItem, cullItemsByViewport, deleteManagedImage, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, isArrowBindTarget, isManagedImage, itemHitTestWorldPoint, loadImageFileAsRasterSceneSource, markImageAsManaged, reorderManagedImages, resolveArrowBindingsInScene, restackManagedImages, rotateManagedImage, snapArrowEndpointToShape };

package/dist/index.d.ts

@@ -266,6 +266,42 @@ declare function cloneVectorSceneItemsWithNewIds(items: readonly VectorSceneItem
  */
 declare function cullItemsByViewport(items: readonly VectorSceneItem[], visibleWorld: Rect): VectorSceneItem[];
 
+declare const MANAGED_KEY = "managed";
+declare function isManagedImage(item: VectorSceneItem): boolean;
+declare function markImageAsManaged(item: VectorSceneItem): VectorSceneItem;
+/**
+ * Repositions every managed image into a single vertical stack. The stack
+ * origin is the current topmost (minimum Y) managed item — that point in world
+ * space is stable across reorder/copy/delete operations, so reorder swaps slots
+ * instead of making the whole stack drift downward. Subsequent items are
+ * centered on the anchor's center X and stacked downward with a fixed gap.
+ *
+ * Non-managed items keep their position. Call this after any operation that
+ * changes the relative order or count of managed images so the canvas reflects
+ * the menu order.
+ */
+declare function restackManagedImages(items: readonly VectorSceneItem[]): VectorSceneItem[];
+/**
+ * Marks `newItem` as a managed image (locked + `pluginData.managed = true`),
+ * appends it to `items`, and restacks all managed images so the new one lands
+ * at the bottom of the stack with the anchor preserved.
+ *
+ * Typical usage: after producing scene items with
+ * `ingestAssetFilesToSceneItems`, push each result through this helper to add
+ * them to the managed-images stack:
+ *
+ * ```ts
+ * let next = doc.items;
+ * for (const created of result.items) next = addManagedImage(next, created);
+ * doc.onItemsChange(next);
+ * ```
+ */
+declare function addManagedImage(items: readonly VectorSceneItem[], newItem: VectorSceneItem): VectorSceneItem[];
+declare function copyManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function rotateManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function deleteManagedImage(items: readonly VectorSceneItem[], id: string): VectorSceneItem[];
+declare function reorderManagedImages(items: readonly VectorSceneItem[], orderedManagedIds: readonly string[]): VectorSceneItem[];
+
 /** Default body font size for vector text (local SVG units). */
 declare const DEFAULT_TEXT_FONT_SIZE = 18;
 /**
@@ -274,4 +310,4 @@ declare const DEFAULT_TEXT_FONT_SIZE = 18;
  */
 declare function buildTextSvg(content: string, _width: number, _height: number, fillColor?: string, fontSize?: number): string;
 
-export { ARROW_BIND_SNAP_PX, type ApplePencilNavOptions, ArrowEndpointBinding, Camera2D, type CreateCustomShapeContent, type CustomShapeSize, DEFAULT_TEXT_FONT_SIZE, type LoadRasterImageFileOptions, MAX_RASTER_EMBED_DIMENSION, type RasterEmbedMode, type RasterSceneSource, Rect, SvgVectorRenderer, type SvgVectorRendererOptions, VectorScene, VectorSceneItem, type ViewportInputOptions, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildCustomShapeChildrenSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, createCustomShapeItem, cullItemsByViewport, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, isArrowBindTarget, itemHitTestWorldPoint, loadImageFileAsRasterSceneSource, resolveArrowBindingsInScene, snapArrowEndpointToShape };
+export { ARROW_BIND_SNAP_PX, type ApplePencilNavOptions, ArrowEndpointBinding, Camera2D, type CreateCustomShapeContent, type CustomShapeSize, DEFAULT_TEXT_FONT_SIZE, type LoadRasterImageFileOptions, MANAGED_KEY, MAX_RASTER_EMBED_DIMENSION, type RasterEmbedMode, type RasterSceneSource, Rect, SvgVectorRenderer, type SvgVectorRendererOptions, VectorScene, VectorSceneItem, type ViewportInputOptions, addManagedImage, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildCustomShapeChildrenSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, copyManagedImage, createCustomShapeItem, cullItemsByViewport, deleteManagedImage, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, isArrowBindTarget, isManagedImage, itemHitTestWorldPoint, loadImageFileAsRasterSceneSource, markImageAsManaged, reorderManagedImages, resolveArrowBindingsInScene, restackManagedImages, rotateManagedImage, snapArrowEndpointToShape };

package/dist/index.js

@@ -2264,6 +2264,84 @@ function cloneVectorSceneItemsWithNewIds(items) {
   return items.map(cloneVectorSceneItemWithNewId);
 }
 
+// src/scene/managed-images.ts
+var MANAGED_KEY = "managed";
+var STACK_GAP_WORLD = 16;
+function isManagedImage(item) {
+  const data = item.pluginData;
+  return data != null && data[MANAGED_KEY] === true;
+}
+function markImageAsManaged(item) {
+  return {
+    ...item,
+    locked: true,
+    pluginData: { ...item.pluginData ?? {}, [MANAGED_KEY]: true }
+  };
+}
+function restackManagedImages(items) {
+  let anchor;
+  for (const item of items) {
+    if (!isManagedImage(item)) continue;
+    if (!anchor || item.bounds.y < anchor.bounds.y) anchor = item;
+  }
+  if (!anchor) return [...items];
+  const anchorCenterX = anchor.bounds.x + anchor.bounds.width / 2;
+  const anchorTopY = anchor.bounds.y;
+  let cursorY = anchorTopY;
+  return items.map((item) => {
+    if (!isManagedImage(item)) return item;
+    const newX = anchorCenterX - item.bounds.width / 2;
+    const newY = cursorY;
+    cursorY = newY + item.bounds.height + STACK_GAP_WORLD;
+    if (item.bounds.x === newX && item.bounds.y === newY) return item;
+    return {
+      ...item,
+      x: newX,
+      y: newY,
+      bounds: { ...item.bounds, x: newX, y: newY }
+    };
+  });
+}
+function addManagedImage(items, newItem) {
+  return restackManagedImages([...items, markImageAsManaged(newItem)]);
+}
+function copyManagedImage(items, id) {
+  const idx = items.findIndex((i) => i.id === id);
+  if (idx < 0) return [...items];
+  const source = items[idx];
+  if (!source) return [...items];
+  const clone = markImageAsManaged(cloneVectorSceneItemWithNewId(source));
+  const inserted = [...items.slice(0, idx + 1), clone, ...items.slice(idx + 1)];
+  return restackManagedImages(inserted);
+}
+function rotateManagedImage(items, id) {
+  return items.map(
+    (i) => i.id === id ? { ...i, rotation: ((i.rotation ?? 0) + Math.PI / 2) % (Math.PI * 2) } : i
+  );
+}
+function deleteManagedImage(items, id) {
+  return restackManagedImages(items.filter((i) => i.id !== id));
+}
+function reorderManagedImages(items, orderedManagedIds) {
+  const managedSlots = [];
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (item && isManagedImage(item)) managedSlots.push(i);
+  }
+  if (managedSlots.length !== orderedManagedIds.length) {
+    return [...items];
+  }
+  const byId = new Map(items.map((i) => [i.id, i]));
+  const next = [...items];
+  managedSlots.forEach((slot, k) => {
+    const orderedId = orderedManagedIds[k];
+    if (orderedId === void 0) return;
+    const replacement = byId.get(orderedId);
+    if (replacement) next[slot] = replacement;
+  });
+  return restackManagedImages(next);
+}
+
 // src/scene/scene.ts
 var VectorScene = class {
   items = [];
@@ -2281,6 +2359,6 @@ var VectorScene = class {
   }
 };
 
-export { ARROW_BIND_SNAP_PX, Camera2D, DEFAULT_STROKE_STYLE, DEFAULT_TEXT_FONT_SIZE, MAX_RASTER_EMBED_DIMENSION, SvgVectorRenderer, VectorScene, applyStrokeToItem, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildArrowSvg, buildCustomShapeChildrenSvg, buildDrawDotSvg, buildEllipseSvg, buildFreehandPathSvg, buildLineSvg, buildRectSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, computeFreehandSvgPayload, createCustomShapeItem, createDrawDotItem, createEllipseItem, createFreehandStrokeItem, createImageFromVectorTrace, createImageItem, createLineItem, createRectangleItem, createShapeId, createTextItem, cullItemsByViewport, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, hydrateSceneItemsWithAssets, isArrowBindTarget, itemHitTestWorldPoint, lineEndpointsToLocal, loadImageFileAsRasterSceneSource, normalizeRect, rebuildItemSvg, rectsIntersect, resolveArrowBindingsInScene, resolveStrokeStyle, snapArrowEndpointToShape };
+export { ARROW_BIND_SNAP_PX, Camera2D, DEFAULT_STROKE_STYLE, DEFAULT_TEXT_FONT_SIZE, MANAGED_KEY, MAX_RASTER_EMBED_DIMENSION, SvgVectorRenderer, VectorScene, addManagedImage, applyStrokeToItem, attachApplePencilNavigation, attachViewportInput, bakeArrowItemToAbsolute, buildArrowSvg, buildCustomShapeChildrenSvg, buildDrawDotSvg, buildEllipseSvg, buildFreehandPathSvg, buildLineSvg, buildRectSvg, buildTextSvg, cloneVectorSceneItemWithNewId, cloneVectorSceneItemsWithNewIds, collectEraserTargetsAtWorldPoint, computeFreehandSvgPayload, copyManagedImage, createCustomShapeItem, createDrawDotItem, createEllipseItem, createFreehandStrokeItem, createImageFromVectorTrace, createImageItem, createLineItem, createRectangleItem, createShapeId, createTextItem, cullItemsByViewport, deleteManagedImage, expandCustomShapeTemplate, formatCameraTransform, formatItemPlacementTransform, hitTestWorldPoint, hydrateSceneItemsWithAssets, isArrowBindTarget, isManagedImage, itemHitTestWorldPoint, lineEndpointsToLocal, loadImageFileAsRasterSceneSource, markImageAsManaged, normalizeRect, rebuildItemSvg, rectsIntersect, reorderManagedImages, resolveArrowBindingsInScene, resolveStrokeStyle, restackManagedImages, rotateManagedImage, snapArrowEndpointToShape };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map