@sarmal/core 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -1,35 +1,40 @@
-import { E as Engine, S as SarmalInstance, C as CurveDef, R as RendererOptions, a as SarmalOptions } from './types-BzgdhxE0.js';
-export { J as JumpOptions, P as PalettePreset, b as Point, c as SeekOptions, T as TrailStyle } from './types-BzgdhxE0.js';
-export { CurveName, curves } from './curves/index.js';
-export { artemis2 } from './curves/artemis2.js';
-export { astroid } from './curves/astroid.js';
-export { deltoid } from './curves/deltoid.js';
-export { epicycloid3 } from './curves/epicycloid3.js';
-export { epitrochoid7 } from './curves/epitrochoid7.js';
-export { lame } from './curves/lame.js';
-export { lissajous32 } from './curves/lissajous32.js';
-export { lissajous43 } from './curves/lissajous43.js';
-export { rose3 } from './curves/rose3.js';
-export { rose5 } from './curves/rose5.js';
+import {
+  B as BaseRendererOptions,
+  E as Engine,
+  S as SarmalInstance,
+  C as CurveDef,
+  R as RendererOptions,
+  a as SarmalOptions,
+} from "./types-BW0bpL1Z.js";
+export {
+  J as JumpOptions,
+  P as PalettePreset,
+  b as Point,
+  c as SeekOptions,
+  T as TrailStyle,
+} from "./types-BW0bpL1Z.js";
+export { CurveName, curves } from "./curves/index.js";
+export { artemis2 } from "./curves/artemis2.js";
+export { astroid } from "./curves/astroid.js";
+export { deltoid } from "./curves/deltoid.js";
+export { epicycloid3 } from "./curves/epicycloid3.js";
+export { epitrochoid7 } from "./curves/epitrochoid7.js";
+export { lame } from "./curves/lame.js";
+export { lissajous32 } from "./curves/lissajous32.js";
+export { lissajous43 } from "./curves/lissajous43.js";
+export { rose3 } from "./curves/rose3.js";
+export { rose5 } from "./curves/rose5.js";
 
-interface SVGRendererOptions {
-    /** Container element that will contain the SVG */
-    container: Element;
-    engine: Engine;
-    /** @default '#ffffff' */
-    skeletonColor?: string;
-    /** @default '#ffffff' */
-    trailColor?: string;
-    /** @default '#ffffff' */
-    headColor?: string;
-    /** @default 4 */
-    headRadius?: number;
-    /** @default 'Loading' */
-    ariaLabel?: string;
+interface SVGRendererOptions extends BaseRendererOptions {
+  /** Container element that will contain the SVG */
+  container: Element;
+  engine: Engine;
+  /** @default 'Loading' */
+  ariaLabel?: string;
 }
 interface SVGSarmalOptions extends Omit<SVGRendererOptions, "container" | "engine"> {
-    /** @default 120 */
-    trailLength?: number;
+  /** @default 120 */
+  trailLength?: number;
 }
 /**
  * Creates a live SVG renderer for sarmal animations
@@ -44,10 +49,18 @@ declare function createSVGRenderer(options: SVGRendererOptions): SarmalInstance;
  * ```ts
  * import { createSarmalSVG, curves } from '@sarmal/core'
  * const sarmal = createSarmalSVG(document.getElementById('spinner'), curves.epitrochoid7)
- * sarmal.start()
+ *
+ * // To control manually, use autoStart: false
+ * const controlled = createSarmalSVG(container, curves.artemis2, { autoStart: false })
+ * controlled.play()  // Start when ready
+ * controlled.pause() // Pause later
  * ```
  */
-declare function createSarmalSVG(container: Element, curveDef: CurveDef, options?: SVGSarmalOptions): SarmalInstance;
+declare function createSarmalSVG(
+  container: Element,
+  curveDef: CurveDef,
+  options?: SVGSarmalOptions,
+): SarmalInstance;
 
 declare function createEngine(curveDef: CurveDef, trailLength?: number): Engine;
 
@@ -64,9 +77,31 @@ declare function createRenderer(options: RendererOptions): SarmalInstance;
  * ```ts
  * import { createSarmal, curves } from '@sarmal/core'
  * const sarmal = createSarmal(canvas, curves.artemis2)
- * sarmal.start()
+ *
+ * // To control manually, use autoStart: false
+ * const controlled = createSarmal(canvas, curves.artemis2, { autoStart: false })
+ * controlled.play()  // Start when ready
+ * controlled.pause() // Pause later
  * ```
  */
-declare function createSarmal(canvas: HTMLCanvasElement, curveDef: CurveDef, options?: SarmalOptions): SarmalInstance;
+declare function createSarmal(
+  canvas: HTMLCanvasElement,
+  curveDef: CurveDef,
+  options?: SarmalOptions,
+): SarmalInstance;
 
-export { CurveDef, Engine, RendererOptions, type SVGRendererOptions, type SVGSarmalOptions, SarmalInstance, SarmalOptions, createEngine, createRenderer, createSVGRenderer, createSarmal, createSarmalSVG };
+export {
+  BaseRendererOptions,
+  CurveDef,
+  Engine,
+  RendererOptions,
+  type SVGRendererOptions,
+  type SVGSarmalOptions,
+  SarmalInstance,
+  SarmalOptions,
+  createEngine,
+  createRenderer,
+  createSVGRenderer,
+  createSarmal,
+  createSarmalSVG,
+};