canvu-react 0.4.4 → 0.4.6

package/dist/native.d.cts

@@ -1,10 +1,13 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Camera2D } from './camera-CVVG7z56.cjs';
+import { C as Camera2D } from './shape-builders-CKEMjivV.cjs';
+export { o as createFreehandStrokeItem, t as createShapeId } from './shape-builders-CKEMjivV.cjs';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle, TextStyle } from 'react-native';
 
 type PlacementPreview = {
-    readonly kind: "rect" | "ellipse";
+    readonly kind: "rect" | "ellipse" | "architectural-cloud";
     readonly rect: {
         readonly x: number;
         readonly y: number;
@@ -69,6 +72,81 @@ type NativeShapeRendererProps = {
 };
 declare function NativeShapeRenderer({ item }: NativeShapeRendererProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Describes a single tool button rendered by {@link NativeVectorToolbar}.
+ *
+ * Use the built-in ids from {@link DEFAULT_NATIVE_VECTOR_TOOLS} when pairing
+ * the toolbar with {@link NativeVectorViewport}. Custom ids are useful only
+ * when the app also implements matching viewport behavior.
+ */
+type NativeVectorToolDefinition = {
+    readonly id: string;
+    readonly label: string;
+    readonly shortLabel?: string;
+    readonly accessibilityLabel?: string;
+    readonly disabled?: boolean;
+};
+/**
+ * Render input for custom tool icons or complete custom tool buttons.
+ *
+ * Prefer `renderToolIcon` for app-specific icon packs. Use
+ * `renderToolButton` only when you need to replace the full touch target while
+ * keeping the toolbar's horizontal scrolling and tool list behavior.
+ */
+type NativeVectorToolbarRenderToolInput = {
+    readonly tool: NativeVectorToolDefinition;
+    readonly selected: boolean;
+    readonly disabled: boolean;
+    readonly foregroundColor: string;
+    readonly onSelect: () => void;
+};
+/**
+ * Props for {@link NativeVectorToolbar}.
+ *
+ * The component is controlled: pass the same `value` to `NativeVectorViewport`
+ * as `toolId`, and update it from `onChange`. It is intentionally lightweight
+ * and native-only, with no dependency on the web toolbar implementation.
+ */
+type NativeVectorToolbarProps = {
+    readonly value: string;
+    readonly onChange: (toolId: string) => void;
+    readonly tools?: readonly NativeVectorToolDefinition[];
+    readonly disabled?: boolean;
+    readonly disabledToolIds?: readonly string[];
+    readonly accessibilityLabel?: string;
+    readonly style?: StyleProp<ViewStyle>;
+    readonly contentContainerStyle?: StyleProp<ViewStyle>;
+    readonly toolButtonStyle?: StyleProp<ViewStyle>;
+    readonly activeToolButtonStyle?: StyleProp<ViewStyle>;
+    readonly toolLabelStyle?: StyleProp<TextStyle>;
+    readonly activeToolLabelStyle?: StyleProp<TextStyle>;
+    readonly renderToolIcon?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
+    readonly renderToolButton?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
+};
+/**
+ * Default mobile-friendly tool list for {@link NativeVectorToolbar}.
+ *
+ * The ids match the native viewport's built-in tool handling. Apps can pass a
+ * filtered or reordered list when permissions or product scope require it.
+ */
+declare const DEFAULT_NATIVE_VECTOR_TOOLS: readonly NativeVectorToolDefinition[];
+/**
+ * Horizontal, touch-sized toolbar for `canvu/native`.
+ *
+ * Use it with {@link NativeVectorViewport} by controlling the same `toolId`
+ * state. It intentionally uses React Native primitives only, so it works in
+ * Expo and bare React Native apps without a WebView.
+ *
+ * @example
+ * ```tsx
+ * const [toolId, setToolId] = useState("select");
+ *
+ * <NativeVectorViewport toolId={toolId} ... />
+ * <NativeVectorToolbar value={toolId} onChange={setToolId} />
+ * ```
+ */
+declare function NativeVectorToolbar({ value, onChange, tools, disabled, disabledToolIds, accessibilityLabel, style, contentContainerStyle, toolButtonStyle, activeToolButtonStyle, toolLabelStyle, activeToolLabelStyle, renderToolIcon, renderToolButton, }: NativeVectorToolbarProps): react_jsx_runtime.JSX.Element;
+
 type NativeVectorViewportHandle = {
     getCamera: () => Camera2D | null;
     requestRender: () => void;
@@ -214,4 +292,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type PlacementPreview, type SvgNode, parseSvgFragment };
+export { DEFAULT_NATIVE_VECTOR_TOOLS, NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarProps, type NativeVectorToolbarRenderToolInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type PlacementPreview, type SvgNode, VectorSceneItem, parseSvgFragment };

package/dist/native.d.ts

@@ -1,10 +1,13 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Camera2D } from './camera-CoRYN_IV.js';
+import { C as Camera2D } from './shape-builders-Cyh8zvDG.js';
+export { o as createFreehandStrokeItem, t as createShapeId } from './shape-builders-Cyh8zvDG.js';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle, TextStyle } from 'react-native';
 
 type PlacementPreview = {
-    readonly kind: "rect" | "ellipse";
+    readonly kind: "rect" | "ellipse" | "architectural-cloud";
     readonly rect: {
         readonly x: number;
         readonly y: number;
@@ -69,6 +72,81 @@ type NativeShapeRendererProps = {
 };
 declare function NativeShapeRenderer({ item }: NativeShapeRendererProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Describes a single tool button rendered by {@link NativeVectorToolbar}.
+ *
+ * Use the built-in ids from {@link DEFAULT_NATIVE_VECTOR_TOOLS} when pairing
+ * the toolbar with {@link NativeVectorViewport}. Custom ids are useful only
+ * when the app also implements matching viewport behavior.
+ */
+type NativeVectorToolDefinition = {
+    readonly id: string;
+    readonly label: string;
+    readonly shortLabel?: string;
+    readonly accessibilityLabel?: string;
+    readonly disabled?: boolean;
+};
+/**
+ * Render input for custom tool icons or complete custom tool buttons.
+ *
+ * Prefer `renderToolIcon` for app-specific icon packs. Use
+ * `renderToolButton` only when you need to replace the full touch target while
+ * keeping the toolbar's horizontal scrolling and tool list behavior.
+ */
+type NativeVectorToolbarRenderToolInput = {
+    readonly tool: NativeVectorToolDefinition;
+    readonly selected: boolean;
+    readonly disabled: boolean;
+    readonly foregroundColor: string;
+    readonly onSelect: () => void;
+};
+/**
+ * Props for {@link NativeVectorToolbar}.
+ *
+ * The component is controlled: pass the same `value` to `NativeVectorViewport`
+ * as `toolId`, and update it from `onChange`. It is intentionally lightweight
+ * and native-only, with no dependency on the web toolbar implementation.
+ */
+type NativeVectorToolbarProps = {
+    readonly value: string;
+    readonly onChange: (toolId: string) => void;
+    readonly tools?: readonly NativeVectorToolDefinition[];
+    readonly disabled?: boolean;
+    readonly disabledToolIds?: readonly string[];
+    readonly accessibilityLabel?: string;
+    readonly style?: StyleProp<ViewStyle>;
+    readonly contentContainerStyle?: StyleProp<ViewStyle>;
+    readonly toolButtonStyle?: StyleProp<ViewStyle>;
+    readonly activeToolButtonStyle?: StyleProp<ViewStyle>;
+    readonly toolLabelStyle?: StyleProp<TextStyle>;
+    readonly activeToolLabelStyle?: StyleProp<TextStyle>;
+    readonly renderToolIcon?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
+    readonly renderToolButton?: (input: NativeVectorToolbarRenderToolInput) => ReactNode;
+};
+/**
+ * Default mobile-friendly tool list for {@link NativeVectorToolbar}.
+ *
+ * The ids match the native viewport's built-in tool handling. Apps can pass a
+ * filtered or reordered list when permissions or product scope require it.
+ */
+declare const DEFAULT_NATIVE_VECTOR_TOOLS: readonly NativeVectorToolDefinition[];
+/**
+ * Horizontal, touch-sized toolbar for `canvu/native`.
+ *
+ * Use it with {@link NativeVectorViewport} by controlling the same `toolId`
+ * state. It intentionally uses React Native primitives only, so it works in
+ * Expo and bare React Native apps without a WebView.
+ *
+ * @example
+ * ```tsx
+ * const [toolId, setToolId] = useState("select");
+ *
+ * <NativeVectorViewport toolId={toolId} ... />
+ * <NativeVectorToolbar value={toolId} onChange={setToolId} />
+ * ```
+ */
+declare function NativeVectorToolbar({ value, onChange, tools, disabled, disabledToolIds, accessibilityLabel, style, contentContainerStyle, toolButtonStyle, activeToolButtonStyle, toolLabelStyle, activeToolLabelStyle, renderToolIcon, renderToolButton, }: NativeVectorToolbarProps): react_jsx_runtime.JSX.Element;
+
 type NativeVectorViewportHandle = {
     getCamera: () => Camera2D | null;
     requestRender: () => void;
@@ -214,4 +292,4 @@ type SvgNode = SvgRectNode | SvgEllipseNode | SvgCircleNode | SvgLineNode | SvgP
  */
 declare function parseSvgFragment(xml: string): SvgNode[];
 
-export { NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type PlacementPreview, type SvgNode, parseSvgFragment };
+export { DEFAULT_NATIVE_VECTOR_TOOLS, NativeInteractionOverlay, type NativeInteractionOverlayProps, NativeSceneRenderer, type NativeSceneRendererProps, NativeShapeRenderer, type NativeShapeRendererProps, type NativeVectorToolDefinition, NativeVectorToolbar, type NativeVectorToolbarProps, type NativeVectorToolbarRenderToolInput, NativeVectorViewport, type NativeVectorViewportHandle, type NativeVectorViewportProps, type PlacementPreview, type SvgNode, VectorSceneItem, parseSvgFragment };