@svgsketch/core 0.4.0 → 0.5.0

package/dist/index.d.mts

@@ -40,7 +40,18 @@ declare enum EasingType {
     EASE_OUT_BACK = "ease-out-back",
     EASE_IN_OUT_BACK = "ease-in-out-back",
     CUSTOM_BEZIER = "custom-bezier",
-    LINEAR_FUNCTION = "linear-function"
+    LINEAR_FUNCTION = "linear-function",
+    STEPS = "steps"
+}
+/**
+ * Step position for CSS `steps()` easing. Follows CSS Easing 1 §3.2.
+ * `start`/`end` are legacy aliases for `jump-start`/`jump-end`.
+ */
+type StepPosition = 'jump-start' | 'jump-end' | 'jump-none' | 'jump-both';
+/** Parameters for a `steps(count, position)` easing function. */
+interface StepsParams {
+    count: number;
+    position: StepPosition;
 }
 /**
  * Map from EasingType → cubic-bezier control points [x1, y1, x2, y2].
@@ -97,6 +108,8 @@ interface AnimationKeyframe {
     customBezier?: [number, number, number, number];
     /** Control points for CSS linear() easing when easing is LINEAR_FUNCTION. */
     linearPoints?: LinearEasingPoint[];
+    /** Step count and jump position when easing is STEPS. */
+    stepsParams?: StepsParams;
 }
 /** A control point for a CSS linear() easing function. */
 interface LinearEasingPoint {
@@ -222,6 +235,7 @@ interface SerializedAnimationTimeline {
                 value: number;
                 position: number;
             }[];
+            stepsParams?: StepsParams;
         }[];
     }[];
 }
@@ -297,6 +311,23 @@ interface GradientStop {
     color: string;
     opacity: number;
 }
+/**
+ * How gradient coordinates are interpreted.
+ *
+ * - `'objectBoundingBox'` (default): coordinates are fractions of the
+ *   painted element's bounding box, where `1` equals the full width or
+ *   height. The gradient rescales to each shape.
+ * - `'userSpaceOnUse'`: coordinates are absolute user-space values, so
+ *   the gradient is a fixed color field in the document. Multiple
+ *   shapes referencing the same gradient see a consistent field, and
+ *   clipped shapes reveal a specific slice of it. Required for
+ *   round-tripping source SVGs that author gradients this way.
+ *
+ * When omitted, the renderer treats the gradient as `objectBoundingBox`
+ * for backward compatibility with documents authored before this field
+ * was added.
+ */
+type GradientUnits = 'objectBoundingBox' | 'userSpaceOnUse';
 interface LinearGradient {
     type: 'linear-gradient';
     id: string;
@@ -307,6 +338,12 @@ interface LinearGradient {
     stops: GradientStop[];
     spreadMethod: GradientSpreadMethod;
     opacity: number;
+    /**
+     * When present and equal to `'userSpaceOnUse'`, `x1`/`y1`/`x2`/`y2`
+     * are in document user space (post any ancestor bake), not in the
+     * element's bbox-normalised [0, 1] space. See `GradientUnits`.
+     */
+    gradientUnits?: GradientUnits;
 }
 interface RadialGradient {
     type: 'radial-gradient';
@@ -321,6 +358,11 @@ interface RadialGradient {
     stops: GradientStop[];
     spreadMethod: GradientSpreadMethod;
     opacity: number;
+    /**
+     * When present and equal to `'userSpaceOnUse'`, `cx`/`cy`/`fx`/`fy`/
+     * `r`/`ry` are in document user space. See `GradientUnits`.
+     */
+    gradientUnits?: GradientUnits;
 }
 /**
  * Per-pattern-type tuneable parameters.
@@ -1136,6 +1178,16 @@ interface SerializedShape {
         headWidthPercent?: number;
         headLengthPercent?: number;
         shaftWidthPercent?: number;
+        tailAngleDeg?: number;
+        tailLengthPercent?: number;
+        tailWidthPercent?: number;
+        lobeRadiusPercent?: number;
+        cleftDepthPercent?: number;
+        boltSegments?: number;
+        boltJaggednessPercent?: number;
+        boltWidthPercent?: number;
+        cloudBumps?: number;
+        cloudPuffinessPercent?: number;
         x1?: number;
         y1?: number;
         x2?: number;
@@ -1150,6 +1202,16 @@ interface SerializedShape {
         endEndpoint?: 'none' | 'arrow' | 'open-arrow' | 'circle' | 'diamond' | 'square';
         locked?: boolean;
         visible?: boolean;
+        /**
+         * SVG `visibility` presentation attribute. Distinct from `visible`:
+         * `visible` (boolean) is the editor's user-toggled layer hide
+         * (display:none semantics); `visibility` is the SVG attribute
+         * (preserves layout, can be flipped by SMIL
+         * `<animate attributeName="visibility">`). Conflating the two breaks
+         * SMIL visibility animations on imported SVGs because display:none
+         * overrides the SVG visibility attribute.
+         */
+        visibility?: 'visible' | 'hidden' | 'collapse';
         fillType?: FillType;
         fillGradient?: LinearGradient | RadialGradient | PatternFill;
         strokeType?: StrokeType;
@@ -1832,6 +1894,41 @@ declare function computeCrossVertices(radius: number, armWidthPercent: number, s
  * Compute arrow vertices (7 points forming an arrow).
  */
 declare function computeArrowVertices(radius: number, headWidthPercent: number, headLengthPercent: number, shaftWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute speech-bubble vertices — square body with a tail protruding at a
+ * chosen angle. The base endpoints lie on the chosen body edge (keeping the
+ * body outline continuous); the tip extends in the direction of `tailAngleDeg`
+ * at length `tailLengthPercent * radius`.
+ *
+ * The `shiftAngleDeg` rotates the entire shape (body + tail).
+ */
+declare function computeSpeechBubbleVertices(radius: number, tailAngleDeg: number, tailLengthPercent: number, tailWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute lightning-bolt vertices — a zigzag ribbon from top tip to bottom tip.
+ * `boltSegments` line segments make the zigzag (alternating x offsets of
+ * `boltJaggednessPercent * radius`); the ribbon is `boltWidthPercent * radius`
+ * wide, perpendicular to each segment's bisector normal.
+ */
+declare function computeLightningVertices(radius: number, boltSegments: number, boltJaggednessPercent: number, boltWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute heart path — two cubic Béziers meeting at the bottom tip and the
+ * upper cleft. `lobeRadiusPercent` controls the horizontal extent of the two
+ * top lobes; `cleftDepthPercent` controls how deep the central dip sits.
+ */
+declare function computeHeartPath(radius: number, lobeRadiusPercent: number, cleftDepthPercent: number, shiftAngleDeg?: number): string;
+/**
+ * Compute cloud path — a classic cartoon-cloud silhouette built as the outer
+ * boundary of N overlapping circles placed around an elongated ellipse.
+ * Circles go all the way around (top, sides, bottom), and the silhouette is
+ * closed by walking each circle's outer arc via the intersection with its
+ * next neighbor. Every transition between bumps is tangent-smooth — no flat
+ * edges, no corners.
+ *
+ * `cloudBumps` (3..8) — number of bump circles forming the silhouette.
+ * `cloudPuffinessPercent` (40..80) — drives bump overlap; higher values
+ * smooth the underside; lower values leave the bumps more pronounced.
+ */
+declare function computeCloudPath(radius: number, cloudBumps: number, cloudPuffinessPercent: number, shiftAngleDeg?: number): string;
 /**
  * Convert an array of vertices to an SVG path string.
  * Supports optional rounded corners via quadratic Bézier.
@@ -1845,9 +1942,6 @@ declare function computeRingPath(radius: number, innerRadiusPercent: number, fil
  * Generate SVG path for an Archimedean spiral.
  */
 declare function computeSpiralPath(radius: number, turns: number, thicknessPercent: number, spiralDirection?: number, shiftAngleDeg?: number): string;
-/**
- * Compute gear vertices (4 vertices per tooth).
- */
 declare function computeGearVertices(teeth: number, radius: number, toothDepthPercent: number, shiftAngleDeg?: number): Point[];
 /**
  * Generate full gear path including optional center hole.
@@ -3255,4 +3349,4 @@ declare class Document {
     private _ensureMetadata;
 }
 
-export { type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, type BaseFilter, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type CodeFormat, type CodegenOptions, type CommonNodeProps, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FillType, type FilmGrainFilter, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GrayscaleFilter, type GroupNodeProps, type Guide, type HistorySnapshot, type HueRotateFilter, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type LicenseType, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MIGRATIONS, type MarkerDescriptor, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, type ParseOptions, PatternBuilder, type PatternElement, type PatternFill, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type RadialGradient, RadialGradientBuilder, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedGroup, type SerializedShape, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, type SharpenFilter, Spiral, type SpiralNodeProps, Spline, SplineCurveType, type SplineNodeProps, type SplinePoint, SplinePointType, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StringifyOptions, type StrokeType, type SymbolInstanceNodeProps, type TemplateVariable, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, computeArrowVertices, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, escXml, extractVariables, filterAttr, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generateReactCode, generateSvgCode, generateVueCode, getEasingCubicBezier, getMarkerDescriptors, getPatternElements, linearGradient, migrateSnapshot, parseDocument, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderCircle, renderEllipse, renderFilterDefs, renderFilterPrimitivesForType, renderImage, renderLine, renderPolygonShape, renderPolyline, renderRectangle, renderShape, renderSpline, renderText, renderToSvg, stringifyDocument, substituteString, substituteVariables, validateSnapshot, verticesToPath };
+export { type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, type BaseFilter, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type CodeFormat, type CodegenOptions, type CommonNodeProps, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FillType, type FilmGrainFilter, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GrayscaleFilter, type GroupNodeProps, type Guide, type HistorySnapshot, type HueRotateFilter, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type LicenseType, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MIGRATIONS, type MarkerDescriptor, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, type ParseOptions, PatternBuilder, type PatternElement, type PatternFill, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type RadialGradient, RadialGradientBuilder, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedGroup, type SerializedShape, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, type SharpenFilter, Spiral, type SpiralNodeProps, Spline, SplineCurveType, type SplineNodeProps, type SplinePoint, SplinePointType, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type SymbolInstanceNodeProps, type TemplateVariable, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, escXml, extractVariables, filterAttr, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generateReactCode, generateSvgCode, generateVueCode, getEasingCubicBezier, getMarkerDescriptors, getPatternElements, linearGradient, migrateSnapshot, parseDocument, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderCircle, renderEllipse, renderFilterDefs, renderFilterPrimitivesForType, renderImage, renderLine, renderPolygonShape, renderPolyline, renderRectangle, renderShape, renderSpline, renderText, renderToSvg, stringifyDocument, substituteString, substituteVariables, validateSnapshot, verticesToPath };

package/dist/index.d.ts

@@ -40,7 +40,18 @@ declare enum EasingType {
     EASE_OUT_BACK = "ease-out-back",
     EASE_IN_OUT_BACK = "ease-in-out-back",
     CUSTOM_BEZIER = "custom-bezier",
-    LINEAR_FUNCTION = "linear-function"
+    LINEAR_FUNCTION = "linear-function",
+    STEPS = "steps"
+}
+/**
+ * Step position for CSS `steps()` easing. Follows CSS Easing 1 §3.2.
+ * `start`/`end` are legacy aliases for `jump-start`/`jump-end`.
+ */
+type StepPosition = 'jump-start' | 'jump-end' | 'jump-none' | 'jump-both';
+/** Parameters for a `steps(count, position)` easing function. */
+interface StepsParams {
+    count: number;
+    position: StepPosition;
 }
 /**
  * Map from EasingType → cubic-bezier control points [x1, y1, x2, y2].
@@ -97,6 +108,8 @@ interface AnimationKeyframe {
     customBezier?: [number, number, number, number];
     /** Control points for CSS linear() easing when easing is LINEAR_FUNCTION. */
     linearPoints?: LinearEasingPoint[];
+    /** Step count and jump position when easing is STEPS. */
+    stepsParams?: StepsParams;
 }
 /** A control point for a CSS linear() easing function. */
 interface LinearEasingPoint {
@@ -222,6 +235,7 @@ interface SerializedAnimationTimeline {
                 value: number;
                 position: number;
             }[];
+            stepsParams?: StepsParams;
         }[];
     }[];
 }
@@ -297,6 +311,23 @@ interface GradientStop {
     color: string;
     opacity: number;
 }
+/**
+ * How gradient coordinates are interpreted.
+ *
+ * - `'objectBoundingBox'` (default): coordinates are fractions of the
+ *   painted element's bounding box, where `1` equals the full width or
+ *   height. The gradient rescales to each shape.
+ * - `'userSpaceOnUse'`: coordinates are absolute user-space values, so
+ *   the gradient is a fixed color field in the document. Multiple
+ *   shapes referencing the same gradient see a consistent field, and
+ *   clipped shapes reveal a specific slice of it. Required for
+ *   round-tripping source SVGs that author gradients this way.
+ *
+ * When omitted, the renderer treats the gradient as `objectBoundingBox`
+ * for backward compatibility with documents authored before this field
+ * was added.
+ */
+type GradientUnits = 'objectBoundingBox' | 'userSpaceOnUse';
 interface LinearGradient {
     type: 'linear-gradient';
     id: string;
@@ -307,6 +338,12 @@ interface LinearGradient {
     stops: GradientStop[];
     spreadMethod: GradientSpreadMethod;
     opacity: number;
+    /**
+     * When present and equal to `'userSpaceOnUse'`, `x1`/`y1`/`x2`/`y2`
+     * are in document user space (post any ancestor bake), not in the
+     * element's bbox-normalised [0, 1] space. See `GradientUnits`.
+     */
+    gradientUnits?: GradientUnits;
 }
 interface RadialGradient {
     type: 'radial-gradient';
@@ -321,6 +358,11 @@ interface RadialGradient {
     stops: GradientStop[];
     spreadMethod: GradientSpreadMethod;
     opacity: number;
+    /**
+     * When present and equal to `'userSpaceOnUse'`, `cx`/`cy`/`fx`/`fy`/
+     * `r`/`ry` are in document user space. See `GradientUnits`.
+     */
+    gradientUnits?: GradientUnits;
 }
 /**
  * Per-pattern-type tuneable parameters.
@@ -1136,6 +1178,16 @@ interface SerializedShape {
         headWidthPercent?: number;
         headLengthPercent?: number;
         shaftWidthPercent?: number;
+        tailAngleDeg?: number;
+        tailLengthPercent?: number;
+        tailWidthPercent?: number;
+        lobeRadiusPercent?: number;
+        cleftDepthPercent?: number;
+        boltSegments?: number;
+        boltJaggednessPercent?: number;
+        boltWidthPercent?: number;
+        cloudBumps?: number;
+        cloudPuffinessPercent?: number;
         x1?: number;
         y1?: number;
         x2?: number;
@@ -1150,6 +1202,16 @@ interface SerializedShape {
         endEndpoint?: 'none' | 'arrow' | 'open-arrow' | 'circle' | 'diamond' | 'square';
         locked?: boolean;
         visible?: boolean;
+        /**
+         * SVG `visibility` presentation attribute. Distinct from `visible`:
+         * `visible` (boolean) is the editor's user-toggled layer hide
+         * (display:none semantics); `visibility` is the SVG attribute
+         * (preserves layout, can be flipped by SMIL
+         * `<animate attributeName="visibility">`). Conflating the two breaks
+         * SMIL visibility animations on imported SVGs because display:none
+         * overrides the SVG visibility attribute.
+         */
+        visibility?: 'visible' | 'hidden' | 'collapse';
         fillType?: FillType;
         fillGradient?: LinearGradient | RadialGradient | PatternFill;
         strokeType?: StrokeType;
@@ -1832,6 +1894,41 @@ declare function computeCrossVertices(radius: number, armWidthPercent: number, s
  * Compute arrow vertices (7 points forming an arrow).
  */
 declare function computeArrowVertices(radius: number, headWidthPercent: number, headLengthPercent: number, shaftWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute speech-bubble vertices — square body with a tail protruding at a
+ * chosen angle. The base endpoints lie on the chosen body edge (keeping the
+ * body outline continuous); the tip extends in the direction of `tailAngleDeg`
+ * at length `tailLengthPercent * radius`.
+ *
+ * The `shiftAngleDeg` rotates the entire shape (body + tail).
+ */
+declare function computeSpeechBubbleVertices(radius: number, tailAngleDeg: number, tailLengthPercent: number, tailWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute lightning-bolt vertices — a zigzag ribbon from top tip to bottom tip.
+ * `boltSegments` line segments make the zigzag (alternating x offsets of
+ * `boltJaggednessPercent * radius`); the ribbon is `boltWidthPercent * radius`
+ * wide, perpendicular to each segment's bisector normal.
+ */
+declare function computeLightningVertices(radius: number, boltSegments: number, boltJaggednessPercent: number, boltWidthPercent: number, shiftAngleDeg?: number): Point[];
+/**
+ * Compute heart path — two cubic Béziers meeting at the bottom tip and the
+ * upper cleft. `lobeRadiusPercent` controls the horizontal extent of the two
+ * top lobes; `cleftDepthPercent` controls how deep the central dip sits.
+ */
+declare function computeHeartPath(radius: number, lobeRadiusPercent: number, cleftDepthPercent: number, shiftAngleDeg?: number): string;
+/**
+ * Compute cloud path — a classic cartoon-cloud silhouette built as the outer
+ * boundary of N overlapping circles placed around an elongated ellipse.
+ * Circles go all the way around (top, sides, bottom), and the silhouette is
+ * closed by walking each circle's outer arc via the intersection with its
+ * next neighbor. Every transition between bumps is tangent-smooth — no flat
+ * edges, no corners.
+ *
+ * `cloudBumps` (3..8) — number of bump circles forming the silhouette.
+ * `cloudPuffinessPercent` (40..80) — drives bump overlap; higher values
+ * smooth the underside; lower values leave the bumps more pronounced.
+ */
+declare function computeCloudPath(radius: number, cloudBumps: number, cloudPuffinessPercent: number, shiftAngleDeg?: number): string;
 /**
  * Convert an array of vertices to an SVG path string.
  * Supports optional rounded corners via quadratic Bézier.
@@ -1845,9 +1942,6 @@ declare function computeRingPath(radius: number, innerRadiusPercent: number, fil
  * Generate SVG path for an Archimedean spiral.
  */
 declare function computeSpiralPath(radius: number, turns: number, thicknessPercent: number, spiralDirection?: number, shiftAngleDeg?: number): string;
-/**
- * Compute gear vertices (4 vertices per tooth).
- */
 declare function computeGearVertices(teeth: number, radius: number, toothDepthPercent: number, shiftAngleDeg?: number): Point[];
 /**
  * Generate full gear path including optional center hole.
@@ -3255,4 +3349,4 @@ declare class Document {
     private _ensureMetadata;
 }
 
-export { type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, type BaseFilter, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type CodeFormat, type CodegenOptions, type CommonNodeProps, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FillType, type FilmGrainFilter, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GrayscaleFilter, type GroupNodeProps, type Guide, type HistorySnapshot, type HueRotateFilter, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type LicenseType, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MIGRATIONS, type MarkerDescriptor, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, type ParseOptions, PatternBuilder, type PatternElement, type PatternFill, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type RadialGradient, RadialGradientBuilder, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedGroup, type SerializedShape, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, type SharpenFilter, Spiral, type SpiralNodeProps, Spline, SplineCurveType, type SplineNodeProps, type SplinePoint, SplinePointType, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StringifyOptions, type StrokeType, type SymbolInstanceNodeProps, type TemplateVariable, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, computeArrowVertices, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, escXml, extractVariables, filterAttr, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generateReactCode, generateSvgCode, generateVueCode, getEasingCubicBezier, getMarkerDescriptors, getPatternElements, linearGradient, migrateSnapshot, parseDocument, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderCircle, renderEllipse, renderFilterDefs, renderFilterPrimitivesForType, renderImage, renderLine, renderPolygonShape, renderPolyline, renderRectangle, renderShape, renderSpline, renderText, renderToSvg, stringifyDocument, substituteString, substituteVariables, validateSnapshot, verticesToPath };
+export { type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, type BaseFilter, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type CodeFormat, type CodegenOptions, type CommonNodeProps, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FillType, type FilmGrainFilter, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GrayscaleFilter, type GroupNodeProps, type Guide, type HistorySnapshot, type HueRotateFilter, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type LicenseType, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MIGRATIONS, type MarkerDescriptor, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, type ParseOptions, PatternBuilder, type PatternElement, type PatternFill, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type RadialGradient, RadialGradientBuilder, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedGroup, type SerializedShape, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, type SharpenFilter, Spiral, type SpiralNodeProps, Spline, SplineCurveType, type SplineNodeProps, type SplinePoint, SplinePointType, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type SymbolInstanceNodeProps, type TemplateVariable, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, escXml, extractVariables, filterAttr, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generateReactCode, generateSvgCode, generateVueCode, getEasingCubicBezier, getMarkerDescriptors, getPatternElements, linearGradient, migrateSnapshot, parseDocument, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderCircle, renderEllipse, renderFilterDefs, renderFilterPrimitivesForType, renderImage, renderLine, renderPolygonShape, renderPolyline, renderRectangle, renderShape, renderSpline, renderText, renderToSvg, stringifyDocument, substituteString, substituteVariables, validateSnapshot, verticesToPath };