canvu-react 0.4.36 → 0.4.38

package/dist/native.d.cts

@@ -226,13 +226,25 @@ 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.
  *
- * This is the high-level native integration point: show an app-native URL
- * dialog, then call {@link NativeLinkToolRequestDetail.insertLink} with the
- * submitted link metadata. Use `onWorldPointerDown` only for fully custom tools
- * or when you do not want canvu to insert the card.
+ * 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
@@ -266,13 +278,14 @@ type NativeVectorViewportProps = {
     readonly onItemsChange?: (items: VectorSceneItem[]) => void;
     readonly onToolChangeRequest?: (toolId: string) => void;
     /**
-     * Called after the built-in native `"link"` tool is tapped on the canvas.
+     * Optional override for the built-in native link dialog.
      *
-     * Use this to open your app's native modal or sheet for URL entry. Call
-     * `detail.insertLink(...)` after the user confirms to append and select the
-     * link card at the tapped world point.
+     * 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;
@@ -360,6 +373,7 @@ type SvgPathNode = {
     readonly strokeOpacity?: number;
     readonly strokeLinecap?: string;
     readonly strokeLinejoin?: string;
+    readonly strokeDasharray?: string;
     readonly shapeRendering?: string;
     readonly vectorEffect?: string;
 };
@@ -419,4 +433,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { CanvuLinkData, DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, 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 };
+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

@@ -226,13 +226,25 @@ 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.
  *
- * This is the high-level native integration point: show an app-native URL
- * dialog, then call {@link NativeLinkToolRequestDetail.insertLink} with the
- * submitted link metadata. Use `onWorldPointerDown` only for fully custom tools
- * or when you do not want canvu to insert the card.
+ * 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
@@ -266,13 +278,14 @@ type NativeVectorViewportProps = {
     readonly onItemsChange?: (items: VectorSceneItem[]) => void;
     readonly onToolChangeRequest?: (toolId: string) => void;
     /**
-     * Called after the built-in native `"link"` tool is tapped on the canvas.
+     * Optional override for the built-in native link dialog.
      *
-     * Use this to open your app's native modal or sheet for URL entry. Call
-     * `detail.insertLink(...)` after the user confirms to append and select the
-     * link card at the tapped world point.
+     * 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;
@@ -360,6 +373,7 @@ type SvgPathNode = {
     readonly strokeOpacity?: number;
     readonly strokeLinecap?: string;
     readonly strokeLinejoin?: string;
+    readonly strokeDasharray?: string;
     readonly shapeRendering?: string;
     readonly vectorEffect?: string;
 };
@@ -419,4 +433,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { CanvuLinkData, DEFAULT_NATIVE_OVERFLOW_TOOL_IDS, DEFAULT_NATIVE_VECTOR_TOOLS, NATIVE_STYLE_PALETTE, type NativeCustomShapePlacementOptions, NativeInteractionOverlay, type NativeInteractionOverlayProps, 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 };
+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 };