canvu-react 0.3.5

package/dist/shape-builders-DxPoOecg.d.cts

@@ -0,0 +1,93 @@
+import { V as VectorSceneItem, L as LineEndpointsLocal, b as VectorPathPoint, R as Rect, a as ArrowBindings } from './types-CB0TZZuk.cjs';
+
+/** Resolved stroke for SVG generation. */
+type StrokeStyle = {
+    stroke: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+};
+declare const DEFAULT_STROKE_STYLE: StrokeStyle;
+declare function resolveStrokeStyle(item: VectorSceneItem): StrokeStyle;
+declare function buildRectSvg(width: number, height: number, style?: StrokeStyle): string;
+declare function buildEllipseSvg(width: number, height: number, style?: StrokeStyle): string;
+declare function buildLineSvg(line: LineEndpointsLocal, style?: StrokeStyle): string;
+declare function buildArrowSvg(itemId: string, line: LineEndpointsLocal, style?: StrokeStyle): string;
+declare function buildDrawDotSvg(r: number, style?: StrokeStyle): string;
+/** Structured result for React overlays; scene uses {@link buildFreehandPathSvg} string. */
+type FreehandSvgPayload = {
+    kind: "circle";
+    cx: number;
+    cy: number;
+    r: number;
+    fill: string;
+    fillOpacity?: number;
+} | {
+    kind: "fillPath";
+    d: string;
+    fill: string;
+    fillOpacity?: number;
+} | {
+    kind: "strokePath";
+    d: string;
+    stroke: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+};
+/**
+ * Computes freehand geometry (perfect-freehand + fallback). Used by {@link buildFreehandPathSvg}
+ * and React overlays without `dangerouslySetInnerHTML`.
+ */
+declare function computeFreehandSvgPayload(pathPointsLocal: readonly VectorPathPoint[], style: StrokeStyle, toolKind: "draw" | "pencil" | "brush" | "marker", strokeComplete?: boolean): FreehandSvgPayload | null;
+/**
+ * Freehand stroke in local coordinates using [perfect-freehand](https://github.com/steveruizok/perfect-freehand)
+ * (filled outline, tapered caps — similar spirit to tldraw / Excalidraw ink).
+ */
+declare function buildFreehandPathSvg(pathPointsLocal: readonly {
+    x: number;
+    y: number;
+}[], style: StrokeStyle, toolKind: "draw" | "pencil" | "brush" | "marker", strokeComplete?: boolean): string;
+/**
+ * Creates a new unique id for a shape (for `VectorSceneItem.id` when adding from code or API).
+ */
+declare function createShapeId(): string;
+/**
+ * Converts line segment endpoints from **world** coordinates to **local** coordinates
+ * (origin = top-left of `bounds`). Use with {@link createLineItem}.
+ */
+declare function lineEndpointsToLocal(bounds: Rect, worldEndA: {
+    x: number;
+    y: number;
+}, worldEndB: {
+    x: number;
+    y: number;
+}): LineEndpointsLocal;
+/**
+ * Rebuilds the SVG fragment (`childrenSvg`) from geometry + stroke fields (after edits or resize).
+ */
+declare function rebuildItemSvg(item: VectorSceneItem): VectorSceneItem;
+/** Updates stroke color / width / opacity and refreshes the item’s SVG. */
+declare function applyStrokeToItem(item: VectorSceneItem, patch: Partial<Pick<VectorSceneItem, "stroke" | "strokeWidth" | "strokeOpacity">>): VectorSceneItem;
+/** Creates a rectangle shape ready to append to your scene `items` array. */
+declare function createRectangleItem(id: string, bounds: Rect, style?: Partial<StrokeStyle>): VectorSceneItem;
+/** Creates an ellipse shape. */
+declare function createEllipseItem(id: string, bounds: Rect, style?: Partial<StrokeStyle>): VectorSceneItem;
+/** Creates a straight line or arrow; `line` is usually from {@link lineEndpointsToLocal}. */
+declare function createLineItem(id: string, bounds: Rect, line: LineEndpointsLocal, toolKind: "line" | "arrow", style?: Partial<StrokeStyle>, arrowBind?: ArrowBindings): VectorSceneItem;
+/** “Draw dot” tool: a small filled circle at (`worldX`, `worldY`). */
+declare function createDrawDotItem(id: string, worldX: number, worldY: number, radius: number, style?: Partial<StrokeStyle>): VectorSceneItem;
+/** Creates an editable text box (`stroke` is used as text fill). */
+declare function createTextItem(id: string, bounds: Rect, text?: string, style?: Partial<StrokeStyle>): VectorSceneItem;
+/** Freehand stroke from world-space points (main pen or marker highlight). */
+declare function createFreehandStrokeItem(id: string, pointsWorld: readonly VectorPathPoint[], toolKind: "draw" | "marker", style?: Partial<StrokeStyle>): VectorSceneItem | null;
+/** Places a bitmap (e.g. `data:image/png;base64,...`) inside `bounds`. */
+declare function createImageItem(id: string, bounds: Rect, imageRasterHref: string, imageIntrinsicSize: {
+    width: number;
+    height: number;
+}): VectorSceneItem;
+/** @internal Legacy traced path content — prefer {@link createImageItem} with a raster data URL. */
+declare function createImageFromVectorTrace(id: string, bounds: Rect, imageVectorInnerSvg: string, imageVectorLocalSize: {
+    width: number;
+    height: number;
+}): VectorSceneItem;
+
+export { DEFAULT_STROKE_STYLE as D, type FreehandSvgPayload as F, type StrokeStyle as S, applyStrokeToItem as a, buildArrowSvg as b, buildDrawDotSvg as c, buildEllipseSvg as d, buildFreehandPathSvg as e, buildLineSvg as f, buildRectSvg as g, computeFreehandSvgPayload as h, createDrawDotItem as i, createEllipseItem as j, createFreehandStrokeItem as k, createImageFromVectorTrace as l, createImageItem as m, createLineItem as n, createRectangleItem as o, createShapeId as p, createTextItem as q, lineEndpointsToLocal as r, rebuildItemSvg as s, resolveStrokeStyle as t };