canvu-react 0.4.35 → 0.4.37

package/dist/native.d.cts

@@ -1,3 +1,5 @@
+import { C as CanvuLinkData } from './link-item-DwzXOwU5.cjs';
+export { D as DEFAULT_LINK_CARD_SIZE, c as createLinkItem, g as getLinkData, i as isLinkItem } from './link-item-DwzXOwU5.cjs';
 import { C as Camera2D, S as StrokeStyle } from './shape-builders-CKEMjivV.cjs';
 export { o as createFreehandStrokeItem, q as createImageItem, t as createShapeId } from './shape-builders-CKEMjivV.cjs';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.cjs';
@@ -162,7 +164,7 @@ type NativeVectorToolbarProps = {
     readonly renderOverflowChevronIcon?: (input: NativeVectorToolbarRenderOverflowInput) => ReactNode;
     readonly renderToolButton?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
 };
-declare const DEFAULT_NATIVE_OVERFLOW_TOOL_IDS: readonly ["rect", "ellipse", "architectural-cloud", "line", "marker", "laser", "image"];
+declare const DEFAULT_NATIVE_OVERFLOW_TOOL_IDS: readonly ["rect", "ellipse", "architectural-cloud", "line", "marker", "laser", "image", "link"];
 /**
  * Default mobile-friendly tool list for {@link NativeVectorToolbar}.
  *
@@ -213,6 +215,58 @@ type NativeWorldPointerDownDetail = {
     readonly screenX: number;
     readonly screenY: number;
 };
+/**
+ * Optional override for a link item inserted from the native link tool.
+ *
+ * Use this when your app has already reserved an item id or wants to place the
+ * link card at a custom box. Most apps can omit it and use the default card
+ * centered on the tapped world point.
+ */
+type NativeLinkToolInsertOptions = {
+    readonly id?: string;
+    readonly bounds?: Rect;
+};
+/**
+ * Copy used by the built-in native link dialog.
+ *
+ * Pass this only when you need localized or product-specific text. Omit it for
+ * the default plug-and-play `"link"` tool flow.
+ */
+type NativeLinkToolDialogLabels = {
+    readonly title?: string;
+    readonly description?: string;
+    readonly inputPlaceholder?: string;
+    readonly cancelLabel?: string;
+    readonly addLabel?: string;
+};
+/**
+ * Detail passed when the built-in native `"link"` tool receives a tap.
+ *
+ * The default flow shows canvu's built-in URL dialog and inserts the card after
+ * submit. Use this detail only when overriding that dialog through
+ * `onLinkToolRequest`.
+ *
+ * @example
+ * ```tsx
+ * <NativeVectorViewport
+ *   toolId={toolId}
+ *   onLinkToolRequest={(detail) => {
+ *     openLinkDialog({
+ *       onSubmit: (href) => detail.insertLink({ href }),
+ *     });
+ *   }}
+ * />
+ * ```
+ */
+type NativeLinkToolRequestDetail = {
+    readonly toolId: "link";
+    readonly worldX: number;
+    readonly worldY: number;
+    readonly screenX: number;
+    readonly screenY: number;
+    readonly suggestedBounds: Rect;
+    readonly insertLink: (link: CanvuLinkData, options?: NativeLinkToolInsertOptions) => VectorSceneItem | null;
+};
 type NativeVectorViewportProps = {
     readonly items: readonly VectorSceneItem[];
     readonly selectedIds?: readonly string[];
@@ -223,6 +277,15 @@ type NativeVectorViewportProps = {
     readonly onSelectionChange?: (ids: string[]) => void;
     readonly onItemsChange?: (items: VectorSceneItem[]) => void;
     readonly onToolChangeRequest?: (toolId: string) => void;
+    /**
+     * Optional override for the built-in native link dialog.
+     *
+     * Omit this for the plug-and-play first-party link tool. When supplied,
+     * canvu will not show its default dialog; your app is responsible for
+     * calling `detail.insertLink(...)`.
+     */
+    readonly onLinkToolRequest?: (detail: NativeLinkToolRequestDetail) => void;
+    readonly linkToolDialogLabels?: NativeLinkToolDialogLabels;
     readonly onWorldPointerDown?: (detail: NativeWorldPointerDownDetail) => void;
     readonly onWorldPointerMove?: (world: {
         readonly x: number;
@@ -369,4 +432,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeStyleColor, NativeVectorStyleInspector, type NativeVectorStyleInspectorProps, type NativeVectorStyleToolId, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarDensity, type NativeVectorToolbarProps, type NativeVectorToolbarRenderOverflowInput, type NativeVectorToolbarRenderToolInput, type NativeVectorToolbarRenderToolLockInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type NativeWorldPointerDownDetail, type PlacementPreview, type SvgNode, VectorSceneItem, nativeStyleColorWithOpacity, normalizeNativeStyleHex, parseSvgFragment };
+export { CanvuLinkData, DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, type NativeLinkToolDialogLabels, type NativeLinkToolInsertOptions, type NativeLinkToolRequestDetail, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeStyleColor, NativeVectorStyleInspector, type NativeVectorStyleInspectorProps, type NativeVectorStyleToolId, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarDensity, type NativeVectorToolbarProps, type NativeVectorToolbarRenderOverflowInput, type NativeVectorToolbarRenderToolInput, type NativeVectorToolbarRenderToolLockInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type NativeWorldPointerDownDetail, type PlacementPreview, type SvgNode, VectorSceneItem, nativeStyleColorWithOpacity, normalizeNativeStyleHex, parseSvgFragment };

package/dist/native.d.ts

@@ -1,3 +1,5 @@
+import { C as CanvuLinkData } from './link-item-IW4GTnxl.js';
+export { D as DEFAULT_LINK_CARD_SIZE, c as createLinkItem, g as getLinkData, i as isLinkItem } from './link-item-IW4GTnxl.js';
 import { C as Camera2D, S as StrokeStyle } from './shape-builders-Cyh8zvDG.js';
 export { o as createFreehandStrokeItem, q as createImageItem, t as createShapeId } from './shape-builders-Cyh8zvDG.js';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.js';
@@ -162,7 +164,7 @@ type NativeVectorToolbarProps = {
     readonly renderOverflowChevronIcon?: (input: NativeVectorToolbarRenderOverflowInput) => ReactNode;
     readonly renderToolButton?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
 };
-declare const DEFAULT_NATIVE_OVERFLOW_TOOL_IDS: readonly ["rect", "ellipse", "architectural-cloud", "line", "marker", "laser", "image"];
+declare const DEFAULT_NATIVE_OVERFLOW_TOOL_IDS: readonly ["rect", "ellipse", "architectural-cloud", "line", "marker", "laser", "image", "link"];
 /**
  * Default mobile-friendly tool list for {@link NativeVectorToolbar}.
  *
@@ -213,6 +215,58 @@ type NativeWorldPointerDownDetail = {
     readonly screenX: number;
     readonly screenY: number;
 };
+/**
+ * Optional override for a link item inserted from the native link tool.
+ *
+ * Use this when your app has already reserved an item id or wants to place the
+ * link card at a custom box. Most apps can omit it and use the default card
+ * centered on the tapped world point.
+ */
+type NativeLinkToolInsertOptions = {
+    readonly id?: string;
+    readonly bounds?: Rect;
+};
+/**
+ * Copy used by the built-in native link dialog.
+ *
+ * Pass this only when you need localized or product-specific text. Omit it for
+ * the default plug-and-play `"link"` tool flow.
+ */
+type NativeLinkToolDialogLabels = {
+    readonly title?: string;
+    readonly description?: string;
+    readonly inputPlaceholder?: string;
+    readonly cancelLabel?: string;
+    readonly addLabel?: string;
+};
+/**
+ * Detail passed when the built-in native `"link"` tool receives a tap.
+ *
+ * The default flow shows canvu's built-in URL dialog and inserts the card after
+ * submit. Use this detail only when overriding that dialog through
+ * `onLinkToolRequest`.
+ *
+ * @example
+ * ```tsx
+ * <NativeVectorViewport
+ *   toolId={toolId}
+ *   onLinkToolRequest={(detail) => {
+ *     openLinkDialog({
+ *       onSubmit: (href) => detail.insertLink({ href }),
+ *     });
+ *   }}
+ * />
+ * ```
+ */
+type NativeLinkToolRequestDetail = {
+    readonly toolId: "link";
+    readonly worldX: number;
+    readonly worldY: number;
+    readonly screenX: number;
+    readonly screenY: number;
+    readonly suggestedBounds: Rect;
+    readonly insertLink: (link: CanvuLinkData, options?: NativeLinkToolInsertOptions) => VectorSceneItem | null;
+};
 type NativeVectorViewportProps = {
     readonly items: readonly VectorSceneItem[];
     readonly selectedIds?: readonly string[];
@@ -223,6 +277,15 @@ type NativeVectorViewportProps = {
     readonly onSelectionChange?: (ids: string[]) => void;
     readonly onItemsChange?: (items: VectorSceneItem[]) => void;
     readonly onToolChangeRequest?: (toolId: string) => void;
+    /**
+     * Optional override for the built-in native link dialog.
+     *
+     * Omit this for the plug-and-play first-party link tool. When supplied,
+     * canvu will not show its default dialog; your app is responsible for
+     * calling `detail.insertLink(...)`.
+     */
+    readonly onLinkToolRequest?: (detail: NativeLinkToolRequestDetail) => void;
+    readonly linkToolDialogLabels?: NativeLinkToolDialogLabels;
     readonly onWorldPointerDown?: (detail: NativeWorldPointerDownDetail) => void;
     readonly onWorldPointerMove?: (world: {
         readonly x: number;
@@ -369,4 +432,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeStyleColor, NativeVectorStyleInspector, type NativeVectorStyleInspectorProps, type NativeVectorStyleToolId, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarDensity, type NativeVectorToolbarProps, type NativeVectorToolbarRenderOverflowInput, type NativeVectorToolbarRenderToolInput, type NativeVectorToolbarRenderToolLockInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type NativeWorldPointerDownDetail, type PlacementPreview, type SvgNode, VectorSceneItem, nativeStyleColorWithOpacity, normalizeNativeStyleHex, parseSvgFragment };
+export { CanvuLinkData, DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, type NativeLinkToolDialogLabels, type NativeLinkToolInsertOptions, type NativeLinkToolRequestDetail, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeStyleColor, NativeVectorStyleInspector, type NativeVectorStyleInspectorProps, type NativeVectorStyleToolId, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarDensity, type NativeVectorToolbarProps, type NativeVectorToolbarRenderOverflowInput, type NativeVectorToolbarRenderToolInput, type NativeVectorToolbarRenderToolLockInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type NativeWorldPointerDownDetail, type PlacementPreview, type SvgNode, VectorSceneItem, nativeStyleColorWithOpacity, normalizeNativeStyleHex, parseSvgFragment };