canvu-react 0.3.38 → 0.3.40

package/dist/{shape-builders-CsbSRZnQ.d.cts → shape-builders-BAWu-PxX.d.cts}

@@ -1,4 +1,4 @@
-import { V as VectorSceneItem, L as LineEndpointsLocal, b as VectorPathPoint, R as Rect, a as ArrowBindings } from './types-Bnq2HtHQ.cjs';
+import { V as VectorSceneItem, R as Rect, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.cjs';
 
 /**
  * Kind of binary selected through the built-in canvu asset ingestion flow.
@@ -110,11 +110,52 @@ type VectorViewportAssetStore = {
     getHydrationRequest?: (item: VectorSceneItem) => VectorViewportAssetHydrationRequest | null;
 };
 
+/** Plugin key under which link metadata is stored on a link item's `pluginData`. */
+declare const LINK_PLUGIN_KEY = "canvuLink";
+/**
+ * Metadata describing a clickable link/bookmark item.
+ * `href` is required; the rest enrich the rendered card (unfurl result).
+ */
+type CanvuLinkData = {
+    /** Absolute URL the card points to. */
+    href: string;
+    /** Human readable title (falls back to the hostname). */
+    title?: string;
+    /** Short description shown under the title. */
+    description?: string;
+    /** Preview image URL (og:image). */
+    image?: string;
+    /** Favicon URL shown in the leading badge. */
+    favicon?: string;
+};
+/**
+ * Builds the inner SVG (no outer `<svg>`) for a link/bookmark card at the given box size.
+ * Uses fixed pixel bands so text never overlaps regardless of the card's aspect ratio.
+ */
+declare function buildLinkCardSvg(width: number, height: number, link: CanvuLinkData): string;
+/** Reads the link metadata from an item, or `null` when the item is not a link. */
+declare function getLinkData(item: VectorSceneItem): CanvuLinkData | null;
+/** True when the item carries link metadata (clickable card). */
+declare function isLinkItem(item: VectorSceneItem): boolean;
+/**
+ * Creates a clickable link/bookmark card item ready to append to the scene.
+ * The card resizes by scaling its authored SVG, like other custom shapes.
+ */
+declare function createLinkItem(id: string, bounds: Rect, link: CanvuLinkData): VectorSceneItem;
+/** Default card size used when placing a new link without explicit bounds. */
+declare const DEFAULT_LINK_CARD_SIZE: {
+    readonly width: 360;
+    readonly height: 132;
+};
+
+/** Stroke dash pattern for freehand drawings. `solid` = perfect-freehand fill; `dashed` = centerline stroke with dashes. */
+type StrokeDash = "solid" | "dashed";
 /** Resolved stroke for SVG generation. */
 type StrokeStyle = {
     stroke: string;
     strokeWidth: number;
     strokeOpacity?: number;
+    strokeDash?: StrokeDash;
 };
 declare const DEFAULT_STROKE_STYLE: StrokeStyle;
 declare function resolveStrokeStyle(item: VectorSceneItem): StrokeStyle;
@@ -164,6 +205,7 @@ type FreehandSvgPayload = {
     stroke: string;
     strokeWidth: number;
     strokeOpacity?: number;
+    strokeDasharray?: string;
 };
 /**
  * Computes freehand geometry (perfect-freehand + fallback). Used by {@link buildFreehandPathSvg}
@@ -198,7 +240,7 @@ declare function lineEndpointsToLocal(bounds: Rect, worldEndA: {
  */
 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;
+declare function applyStrokeToItem(item: VectorSceneItem, patch: Partial<Pick<VectorSceneItem, "stroke" | "strokeWidth" | "strokeOpacity" | "strokeDash" | "textFontSize">>): 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. */
@@ -227,7 +269,7 @@ declare function createLineItem(id: string, bounds: Rect, line: LineEndpointsLoc
 /** “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;
+declare function createTextItem(id: string, bounds: Rect, text?: string, style?: Partial<StrokeStyle>, textFontSize?: number): 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`. */
@@ -241,4 +283,4 @@ declare function createImageFromVectorTrace(id: string, bounds: Rect, imageVecto
     height: number;
 }): VectorSceneItem;
 
-export { type VectorViewportAssetResolveResult as A, type VectorViewportAssetUploadRequest as B, type VectorViewportAssetUploadResult as C, DEFAULT_STROKE_STYLE as D, type FreehandSvgPayload as F, type StrokeStyle as S, type VectorViewportAssetKind as V, applyStrokeToItem as a, buildArchitecturalCloudPathD as b, buildArchitecturalCloudSvg as c, buildArrowSvg as d, buildDrawDotSvg as e, buildEllipseSvg as f, buildFreehandPathSvg as g, buildLineSvg as h, buildRectSvg as i, computeFreehandSvgPayload as j, createArchitecturalCloudItem as k, createDrawDotItem as l, createEllipseItem as m, createFreehandStrokeItem as n, createImageFromVectorTrace as o, createImageItem as p, createLineItem as q, createRectangleItem as r, createShapeId as s, createTextItem as t, lineEndpointsToLocal as u, rebuildItemSvg as v, resolveStrokeStyle as w, type VectorViewportAssetStore as x, type VectorViewportAssetHydrationRequest as y, type VectorViewportAssetResolveRequest as z };
+export { rebuildItemSvg as A, resolveStrokeStyle as B, type CanvuLinkData as C, DEFAULT_LINK_CARD_SIZE as D, type VectorViewportAssetStore as E, type FreehandSvgPayload as F, type VectorViewportAssetHydrationRequest as G, type VectorViewportAssetResolveRequest as H, type VectorViewportAssetResolveResult as I, type VectorViewportAssetUploadRequest as J, type VectorViewportAssetUploadResult as K, LINK_PLUGIN_KEY as L, type StrokeStyle as S, type VectorViewportAssetKind as V, DEFAULT_STROKE_STYLE as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildLinkCardSvg as j, buildRectSvg as k, computeFreehandSvgPayload as l, createArchitecturalCloudItem as m, createDrawDotItem as n, createEllipseItem as o, createFreehandStrokeItem as p, createImageFromVectorTrace as q, createImageItem as r, createLineItem as s, createLinkItem as t, createRectangleItem as u, createShapeId as v, createTextItem as w, getLinkData as x, isLinkItem as y, lineEndpointsToLocal as z };

package/dist/{shape-builders-CsSXKCcs.d.ts → shape-builders-ClKv9tz9.d.ts}

@@ -1,4 +1,4 @@
-import { V as VectorSceneItem, L as LineEndpointsLocal, b as VectorPathPoint, R as Rect, a as ArrowBindings } from './types-Bnq2HtHQ.js';
+import { V as VectorSceneItem, R as Rect, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.js';
 
 /**
  * Kind of binary selected through the built-in canvu asset ingestion flow.
@@ -110,11 +110,52 @@ type VectorViewportAssetStore = {
     getHydrationRequest?: (item: VectorSceneItem) => VectorViewportAssetHydrationRequest | null;
 };
 
+/** Plugin key under which link metadata is stored on a link item's `pluginData`. */
+declare const LINK_PLUGIN_KEY = "canvuLink";
+/**
+ * Metadata describing a clickable link/bookmark item.
+ * `href` is required; the rest enrich the rendered card (unfurl result).
+ */
+type CanvuLinkData = {
+    /** Absolute URL the card points to. */
+    href: string;
+    /** Human readable title (falls back to the hostname). */
+    title?: string;
+    /** Short description shown under the title. */
+    description?: string;
+    /** Preview image URL (og:image). */
+    image?: string;
+    /** Favicon URL shown in the leading badge. */
+    favicon?: string;
+};
+/**
+ * Builds the inner SVG (no outer `<svg>`) for a link/bookmark card at the given box size.
+ * Uses fixed pixel bands so text never overlaps regardless of the card's aspect ratio.
+ */
+declare function buildLinkCardSvg(width: number, height: number, link: CanvuLinkData): string;
+/** Reads the link metadata from an item, or `null` when the item is not a link. */
+declare function getLinkData(item: VectorSceneItem): CanvuLinkData | null;
+/** True when the item carries link metadata (clickable card). */
+declare function isLinkItem(item: VectorSceneItem): boolean;
+/**
+ * Creates a clickable link/bookmark card item ready to append to the scene.
+ * The card resizes by scaling its authored SVG, like other custom shapes.
+ */
+declare function createLinkItem(id: string, bounds: Rect, link: CanvuLinkData): VectorSceneItem;
+/** Default card size used when placing a new link without explicit bounds. */
+declare const DEFAULT_LINK_CARD_SIZE: {
+    readonly width: 360;
+    readonly height: 132;
+};
+
+/** Stroke dash pattern for freehand drawings. `solid` = perfect-freehand fill; `dashed` = centerline stroke with dashes. */
+type StrokeDash = "solid" | "dashed";
 /** Resolved stroke for SVG generation. */
 type StrokeStyle = {
     stroke: string;
     strokeWidth: number;
     strokeOpacity?: number;
+    strokeDash?: StrokeDash;
 };
 declare const DEFAULT_STROKE_STYLE: StrokeStyle;
 declare function resolveStrokeStyle(item: VectorSceneItem): StrokeStyle;
@@ -164,6 +205,7 @@ type FreehandSvgPayload = {
     stroke: string;
     strokeWidth: number;
     strokeOpacity?: number;
+    strokeDasharray?: string;
 };
 /**
  * Computes freehand geometry (perfect-freehand + fallback). Used by {@link buildFreehandPathSvg}
@@ -198,7 +240,7 @@ declare function lineEndpointsToLocal(bounds: Rect, worldEndA: {
  */
 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;
+declare function applyStrokeToItem(item: VectorSceneItem, patch: Partial<Pick<VectorSceneItem, "stroke" | "strokeWidth" | "strokeOpacity" | "strokeDash" | "textFontSize">>): 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. */
@@ -227,7 +269,7 @@ declare function createLineItem(id: string, bounds: Rect, line: LineEndpointsLoc
 /** “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;
+declare function createTextItem(id: string, bounds: Rect, text?: string, style?: Partial<StrokeStyle>, textFontSize?: number): 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`. */
@@ -241,4 +283,4 @@ declare function createImageFromVectorTrace(id: string, bounds: Rect, imageVecto
     height: number;
 }): VectorSceneItem;
 
-export { type VectorViewportAssetResolveResult as A, type VectorViewportAssetUploadRequest as B, type VectorViewportAssetUploadResult as C, DEFAULT_STROKE_STYLE as D, type FreehandSvgPayload as F, type StrokeStyle as S, type VectorViewportAssetKind as V, applyStrokeToItem as a, buildArchitecturalCloudPathD as b, buildArchitecturalCloudSvg as c, buildArrowSvg as d, buildDrawDotSvg as e, buildEllipseSvg as f, buildFreehandPathSvg as g, buildLineSvg as h, buildRectSvg as i, computeFreehandSvgPayload as j, createArchitecturalCloudItem as k, createDrawDotItem as l, createEllipseItem as m, createFreehandStrokeItem as n, createImageFromVectorTrace as o, createImageItem as p, createLineItem as q, createRectangleItem as r, createShapeId as s, createTextItem as t, lineEndpointsToLocal as u, rebuildItemSvg as v, resolveStrokeStyle as w, type VectorViewportAssetStore as x, type VectorViewportAssetHydrationRequest as y, type VectorViewportAssetResolveRequest as z };
+export { rebuildItemSvg as A, resolveStrokeStyle as B, type CanvuLinkData as C, DEFAULT_LINK_CARD_SIZE as D, type VectorViewportAssetStore as E, type FreehandSvgPayload as F, type VectorViewportAssetHydrationRequest as G, type VectorViewportAssetResolveRequest as H, type VectorViewportAssetResolveResult as I, type VectorViewportAssetUploadRequest as J, type VectorViewportAssetUploadResult as K, LINK_PLUGIN_KEY as L, type StrokeStyle as S, type VectorViewportAssetKind as V, DEFAULT_STROKE_STYLE as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildLinkCardSvg as j, buildRectSvg as k, computeFreehandSvgPayload as l, createArchitecturalCloudItem as m, createDrawDotItem as n, createEllipseItem as o, createFreehandStrokeItem as p, createImageFromVectorTrace as q, createImageItem as r, createLineItem as s, createLinkItem as t, createRectangleItem as u, createShapeId as v, createTextItem as w, getLinkData as x, isLinkItem as y, lineEndpointsToLocal as z };