@sarmal/core 0.24.0 → 0.25.0

package/dist/{types-CknrlCAf.d.cts → types-BZpzgNau.d.cts}

@@ -2,6 +2,12 @@ interface Point {
     x: number;
     y: number;
 }
+/**
+ * A control point for drawn curves, represented as a
+ *  normalized `[x, y]` tuple in `[-1, 1]` space,
+ *    matching the playground's draw-mode coordinate system.
+ */
+type ControlPoint = [number, number];
 interface CurveDef {
     name: string;
     /**
@@ -39,6 +45,13 @@ interface CurveDef {
      * @returns The point on the skeleton at time `t`
      */
     skeletonFn?: (t: number) => Point;
+    /**
+     * How the curve was created:
+     * - 'parametric': Defined by a mathematical parametric equation
+     * - 'drawn': Defined by control points
+     * @default "parametric"
+     */
+    kind?: "parametric" | "drawn";
 }
 type JumpOptions = {
     /**
@@ -212,6 +225,11 @@ interface SarmalInstance extends AnimationControls {
     pause(): void;
     /** Stops the animation and cleans up resources */
     destroy(): void;
+    /**
+     * Returns the skeleton of the curve:
+     * The complete traversal over one full period, sampled at points from t=0 to t=period.
+     */
+    getSarmalSkeleton(): Array<Point>;
     /**
      * Smoothly transitions from the current curve to `target`.
      * The trail naturally reflects the new curve as new points are added.
@@ -311,4 +329,4 @@ interface SarmalOptions extends Omit<RendererOptions, "canvas" | "engine"> {
     trailLength?: number;
 }
 
-export type { BaseRendererOptions as B, CurveDef as C, Engine as E, JumpOptions as J, Point as P, RendererOptions as R, SarmalInstance as S, TrailColor as T, SarmalOptions as a, RuntimeRenderOptions as b, SeekOptions as c, TrailStyle as d };
+export type { BaseRendererOptions as B, CurveDef as C, Engine as E, JumpOptions as J, Point as P, RendererOptions as R, SarmalInstance as S, TrailColor as T, ControlPoint as a, SarmalOptions as b, RuntimeRenderOptions as c, SeekOptions as d, TrailStyle as e };

package/dist/{types-CknrlCAf.d.ts → types-BZpzgNau.d.ts}

@@ -2,6 +2,12 @@ interface Point {
     x: number;
     y: number;
 }
+/**
+ * A control point for drawn curves, represented as a
+ *  normalized `[x, y]` tuple in `[-1, 1]` space,
+ *    matching the playground's draw-mode coordinate system.
+ */
+type ControlPoint = [number, number];
 interface CurveDef {
     name: string;
     /**
@@ -39,6 +45,13 @@ interface CurveDef {
      * @returns The point on the skeleton at time `t`
      */
     skeletonFn?: (t: number) => Point;
+    /**
+     * How the curve was created:
+     * - 'parametric': Defined by a mathematical parametric equation
+     * - 'drawn': Defined by control points
+     * @default "parametric"
+     */
+    kind?: "parametric" | "drawn";
 }
 type JumpOptions = {
     /**
@@ -212,6 +225,11 @@ interface SarmalInstance extends AnimationControls {
     pause(): void;
     /** Stops the animation and cleans up resources */
     destroy(): void;
+    /**
+     * Returns the skeleton of the curve:
+     * The complete traversal over one full period, sampled at points from t=0 to t=period.
+     */
+    getSarmalSkeleton(): Array<Point>;
     /**
      * Smoothly transitions from the current curve to `target`.
      * The trail naturally reflects the new curve as new points are added.
@@ -311,4 +329,4 @@ interface SarmalOptions extends Omit<RendererOptions, "canvas" | "engine"> {
     trailLength?: number;
 }
 
-export type { BaseRendererOptions as B, CurveDef as C, Engine as E, JumpOptions as J, Point as P, RendererOptions as R, SarmalInstance as S, TrailColor as T, SarmalOptions as a, RuntimeRenderOptions as b, SeekOptions as c, TrailStyle as d };
+export type { BaseRendererOptions as B, CurveDef as C, Engine as E, JumpOptions as J, Point as P, RendererOptions as R, SarmalInstance as S, TrailColor as T, ControlPoint as a, SarmalOptions as b, RuntimeRenderOptions as c, SeekOptions as d, TrailStyle as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarmal/core",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Curve path based loading indicators and their renderer",
   "keywords": [
     "animation",