@sarmal/core 0.17.3 → 0.19.0

package/dist/index.d.cts

@@ -1,31 +1,45 @@
-import { B as BaseRendererOptions, E as Engine, S as SarmalInstance, C as CurveDef, R as RendererOptions, a as SarmalOptions } from './types-BL9HhEmk.cjs';
-export { J as JumpOptions, P as Point, b as RuntimeRenderOptions, c as SeekOptions, T as TrailColor, d as TrailStyle } from './types-BL9HhEmk.cjs';
-export { CurveName, curves } from './curves/index.cjs';
-export { artemis2 } from './curves/artemis2.cjs';
-export { astroid } from './curves/astroid.cjs';
-export { deltoid } from './curves/deltoid.cjs';
-export { epicycloid3 } from './curves/epicycloid3.cjs';
-export { epitrochoid7 } from './curves/epitrochoid7.cjs';
-export { lame } from './curves/lame.cjs';
-export { lissajous32 } from './curves/lissajous32.cjs';
-export { lissajous43 } from './curves/lissajous43.cjs';
-export { rose3 } from './curves/rose3.cjs';
-export { rose5 } from './curves/rose5.cjs';
-import './curves/rose52.cjs';
-import './curves/star.cjs';
-import './curves/star4.cjs';
-import './curves/star7.cjs';
+import {
+  B as BaseRendererOptions,
+  E as Engine,
+  S as SarmalInstance,
+  C as CurveDef,
+  R as RendererOptions,
+  a as SarmalOptions,
+} from "./types-frtEoAq6.cjs";
+export {
+  J as JumpOptions,
+  P as Point,
+  b as RuntimeRenderOptions,
+  c as SeekOptions,
+  T as TrailColor,
+  d as TrailStyle,
+} from "./types-frtEoAq6.cjs";
+export { CurveName, curves } from "./curves/index.cjs";
+export { artemis2 } from "./curves/artemis2.cjs";
+export { astroid } from "./curves/astroid.cjs";
+export { deltoid } from "./curves/deltoid.cjs";
+export { epicycloid3 } from "./curves/epicycloid3.cjs";
+export { epitrochoid7 } from "./curves/epitrochoid7.cjs";
+export { lame } from "./curves/lame.cjs";
+export { lissajous32 } from "./curves/lissajous32.cjs";
+export { lissajous43 } from "./curves/lissajous43.cjs";
+export { rose3 } from "./curves/rose3.cjs";
+export { rose5 } from "./curves/rose5.cjs";
+import "./curves/rose52.cjs";
+import "./curves/star.cjs";
+import "./curves/star4.cjs";
+import "./curves/star7.cjs";
 
 interface SVGRendererOptions extends BaseRendererOptions {
-    /** Container element that will contain the SVG */
-    container: Element;
-    engine: Engine;
-    /** @default 'Loading' */
-    ariaLabel?: string;
+  /** SVG element the renderer draws into directly */
+  container: SVGSVGElement;
+  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
@@ -33,33 +47,40 @@ interface SVGSarmalOptions extends Omit<SVGRendererOptions, "container" | "engin
  */
 declare function createSVGRenderer(options: SVGRendererOptions): SarmalInstance;
 /**
- * Creates a sarmal animation inside a container element using an SVG renderer
- * The SVG is appended to the container and animated via requestAnimationFrame
+ * Creates a sarmal animation directly inside an `<svg>` element using an SVG renderer.
+ * The passed `<svg>` element is set to `viewBox="0 0 100 100"` and animated via requestAnimationFrame
  *
  * @example
  * ```ts
  * import { createSarmalSVG, epitrochoid7 } from '@sarmal/core'
- * const sarmal = createSarmalSVG(document.getElementById('spinner'), epitrochoid7)
+ *
+ * // <svg id="spinner"></svg> in your HTML
+ * const svg = document.getElementById('spinner')
+ * const sarmal = createSarmalSVG(svg, epitrochoid7)
  *
  * // To control manually, use autoStart: false
- * const controlled = createSarmalSVG(container, rose5, { autoStart: false })
+ * const controlled = createSarmalSVG(svg, rose5, { 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: SVGSVGElement,
+  curveDef: CurveDef,
+  options?: SVGSarmalOptions,
+): SarmalInstance;
 
 /**
  * Can be passed directly to `trailColor`,
  *  or can be mixed/sliced before passing as a prop.
  */
 declare const palettes: {
-    readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
-    readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
-    readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
-    readonly ice: ["#1e3a8a", "#67e8f9"];
-    readonly fire: ["#7f1d1d", "#fbbf24"];
-    readonly forest: ["#14532d", "#86efac"];
+  readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
+  readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
+  readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
+  readonly ice: ["#1e3a8a", "#67e8f9"];
+  readonly fire: ["#7f1d1d", "#fbbf24"];
+  readonly forest: ["#14532d", "#86efac"];
 };
 type SarmalPalette = keyof typeof palettes;
 
@@ -85,6 +106,26 @@ declare function createRenderer(options: RendererOptions): SarmalInstance;
  * 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 { BaseRendererOptions, CurveDef, Engine, RendererOptions, type SVGRendererOptions, type SVGSarmalOptions, SarmalInstance, SarmalOptions, type SarmalPalette, createEngine, createRenderer, createSVGRenderer, createSarmal, createSarmalSVG, palettes };
+export {
+  BaseRendererOptions,
+  CurveDef,
+  Engine,
+  RendererOptions,
+  type SVGRendererOptions,
+  type SVGSarmalOptions,
+  SarmalInstance,
+  SarmalOptions,
+  type SarmalPalette,
+  createEngine,
+  createRenderer,
+  createSVGRenderer,
+  createSarmal,
+  createSarmalSVG,
+  palettes,
+};

package/dist/index.d.ts

@@ -1,31 +1,45 @@
-import { B as BaseRendererOptions, E as Engine, S as SarmalInstance, C as CurveDef, R as RendererOptions, a as SarmalOptions } from './types-BL9HhEmk.js';
-export { J as JumpOptions, P as Point, b as RuntimeRenderOptions, c as SeekOptions, T as TrailColor, d as TrailStyle } from './types-BL9HhEmk.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 './curves/rose52.js';
-import './curves/star.js';
-import './curves/star4.js';
-import './curves/star7.js';
+import {
+  B as BaseRendererOptions,
+  E as Engine,
+  S as SarmalInstance,
+  C as CurveDef,
+  R as RendererOptions,
+  a as SarmalOptions,
+} from "./types-frtEoAq6.js";
+export {
+  J as JumpOptions,
+  P as Point,
+  b as RuntimeRenderOptions,
+  c as SeekOptions,
+  T as TrailColor,
+  d as TrailStyle,
+} from "./types-frtEoAq6.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 "./curves/rose52.js";
+import "./curves/star.js";
+import "./curves/star4.js";
+import "./curves/star7.js";
 
 interface SVGRendererOptions extends BaseRendererOptions {
-    /** Container element that will contain the SVG */
-    container: Element;
-    engine: Engine;
-    /** @default 'Loading' */
-    ariaLabel?: string;
+  /** SVG element the renderer draws into directly */
+  container: SVGSVGElement;
+  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
@@ -33,33 +47,40 @@ interface SVGSarmalOptions extends Omit<SVGRendererOptions, "container" | "engin
  */
 declare function createSVGRenderer(options: SVGRendererOptions): SarmalInstance;
 /**
- * Creates a sarmal animation inside a container element using an SVG renderer
- * The SVG is appended to the container and animated via requestAnimationFrame
+ * Creates a sarmal animation directly inside an `<svg>` element using an SVG renderer.
+ * The passed `<svg>` element is set to `viewBox="0 0 100 100"` and animated via requestAnimationFrame
  *
  * @example
  * ```ts
  * import { createSarmalSVG, epitrochoid7 } from '@sarmal/core'
- * const sarmal = createSarmalSVG(document.getElementById('spinner'), epitrochoid7)
+ *
+ * // <svg id="spinner"></svg> in your HTML
+ * const svg = document.getElementById('spinner')
+ * const sarmal = createSarmalSVG(svg, epitrochoid7)
  *
  * // To control manually, use autoStart: false
- * const controlled = createSarmalSVG(container, rose5, { autoStart: false })
+ * const controlled = createSarmalSVG(svg, rose5, { 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: SVGSVGElement,
+  curveDef: CurveDef,
+  options?: SVGSarmalOptions,
+): SarmalInstance;
 
 /**
  * Can be passed directly to `trailColor`,
  *  or can be mixed/sliced before passing as a prop.
  */
 declare const palettes: {
-    readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
-    readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
-    readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
-    readonly ice: ["#1e3a8a", "#67e8f9"];
-    readonly fire: ["#7f1d1d", "#fbbf24"];
-    readonly forest: ["#14532d", "#86efac"];
+  readonly bard: ["#a855f7", "#3b82f6", "#14b8a6", "#ec4899"];
+  readonly sunset: ["#f97316", "#dc2626", "#9333ea", "#f472b6"];
+  readonly ocean: ["#1e3a8a", "#06b6d4", "#22d3ee", "#e0f2fe"];
+  readonly ice: ["#1e3a8a", "#67e8f9"];
+  readonly fire: ["#7f1d1d", "#fbbf24"];
+  readonly forest: ["#14532d", "#86efac"];
 };
 type SarmalPalette = keyof typeof palettes;
 
@@ -85,6 +106,26 @@ declare function createRenderer(options: RendererOptions): SarmalInstance;
  * 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 { BaseRendererOptions, CurveDef, Engine, RendererOptions, type SVGRendererOptions, type SVGSarmalOptions, SarmalInstance, SarmalOptions, type SarmalPalette, createEngine, createRenderer, createSVGRenderer, createSarmal, createSarmalSVG, palettes };
+export {
+  BaseRendererOptions,
+  CurveDef,
+  Engine,
+  RendererOptions,
+  type SVGRendererOptions,
+  type SVGSarmalOptions,
+  SarmalInstance,
+  SarmalOptions,
+  type SarmalPalette,
+  createEngine,
+  createRenderer,
+  createSVGRenderer,
+  createSarmal,
+  createSarmalSVG,
+  palettes,
+};