versioncam 0.1.1

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/core/camera.d.ts

@@ -0,0 +1,30 @@
+import type { CameraKey, Rect } from "./timeline.js";
+export type Viewport = {
+    width: number;
+    height: number;
+};
+export type ZoomOptions = {
+    /** Padding around the target, as a fraction of its size. */
+    pad?: number;
+    /**
+     * Hard ceiling on magnification. Above the ratio of capture DPR to output
+     * scale the image is being upscaled, and the whole point of capturing at
+     * DPR 2 is that a zoom stays sharp.
+     */
+    maxScale?: number;
+};
+export declare function clampRect(rect: Rect, viewport: Viewport): Rect;
+/**
+ * The camera rectangle that frames `target`: padded, fitted to the viewport's
+ * aspect (the output frame has the viewport's shape, so anything else would
+ * letterbox), capped in magnification, and kept inside the captured area.
+ */
+export declare function zoomRect(target: Rect, viewport: Viewport, options?: ZoomOptions): Rect;
+/** The magnification a camera rectangle represents. */
+export declare function scaleOf(rect: Rect, viewport: Viewport): number;
+/**
+ * Where the camera is at time `t`. A key's `ease` describes how the camera
+ * reaches it from the previous key: `minjerk` glides, `hold` stays put and
+ * then cuts.
+ */
+export declare function evalCamera(keys: CameraKey[], t: number): Rect;

package/dist/core/camera.js

@@ -0,0 +1,94 @@
+import { clamp, lerp, minjerk } from "./easing.js";
+const DEFAULT_PAD = 0.12;
+const DEFAULT_MAX_SCALE = 1.65;
+export function clampRect(rect, viewport) {
+    const w = Math.min(rect.w, viewport.width);
+    const h = Math.min(rect.h, viewport.height);
+    return {
+        x: clamp(rect.x, 0, viewport.width - w),
+        y: clamp(rect.y, 0, viewport.height - h),
+        w,
+        h,
+    };
+}
+/**
+ * The camera rectangle that frames `target`: padded, fitted to the viewport's
+ * aspect (the output frame has the viewport's shape, so anything else would
+ * letterbox), capped in magnification, and kept inside the captured area.
+ */
+export function zoomRect(target, viewport, options = {}) {
+    const pad = options.pad ?? DEFAULT_PAD;
+    const maxScale = options.maxScale ?? DEFAULT_MAX_SCALE;
+    const aspect = viewport.width / viewport.height;
+    const centerX = target.x + target.w / 2;
+    const centerY = target.y + target.h / 2;
+    let w = target.w * (1 + 2 * pad);
+    let h = target.h * (1 + 2 * pad);
+    // Grow the deficient axis rather than shrinking the other, so the target
+    // never gets cropped by the aspect fit.
+    if (w / h < aspect)
+        w = h * aspect;
+    else
+        h = w / aspect;
+    const minWidth = viewport.width / maxScale;
+    if (w < minWidth) {
+        w = minWidth;
+        h = w / aspect;
+    }
+    if (w > viewport.width) {
+        w = viewport.width;
+        h = viewport.height;
+    }
+    return clampRect({ x: centerX - w / 2, y: centerY - h / 2, w, h }, viewport);
+}
+/** The magnification a camera rectangle represents. */
+export function scaleOf(rect, viewport) {
+    return viewport.width / rect.w;
+}
+/**
+ * Interpolate one camera framing towards another.
+ *
+ * The size moves geometrically and the centre linearly. Interpolating width
+ * linearly is the usual reason a zoom feels wrong: going from 1440 wide to 780
+ * wide, the first half of the move changes the magnification by 1.22x and the
+ * second half by 1.51x, so a zoom that is mathematically even reads as rushing
+ * into the target and then crawling. In log space each equal step multiplies
+ * the scale by the same factor, which is what the eye actually reads as
+ * constant speed.
+ */
+function interpolateRect(a, b, u) {
+    const cxA = a.x + a.w / 2;
+    const cyA = a.y + a.h / 2;
+    const cxB = b.x + b.w / 2;
+    const cyB = b.y + b.h / 2;
+    const w = a.w * Math.pow(b.w / a.w, u);
+    const h = a.h * Math.pow(b.h / a.h, u);
+    const cx = lerp(cxA, cxB, u);
+    const cy = lerp(cyA, cyB, u);
+    return { x: cx - w / 2, y: cy - h / 2, w, h };
+}
+/**
+ * Where the camera is at time `t`. A key's `ease` describes how the camera
+ * reaches it from the previous key: `minjerk` glides, `hold` stays put and
+ * then cuts.
+ */
+export function evalCamera(keys, t) {
+    if (keys.length === 0) {
+        throw new Error("evalCamera called with no keys");
+    }
+    if (t <= keys[0].t)
+        return keys[0].rect;
+    for (let i = 1; i < keys.length; i += 1) {
+        const prev = keys[i - 1];
+        const next = keys[i];
+        if (t >= next.t)
+            continue;
+        if (next.ease === "hold")
+            return prev.rect;
+        const span = next.t - prev.t;
+        const u = span <= 0 ? 1 : (t - prev.t) / span;
+        return interpolateRect(prev.rect, next.rect, minjerk(u));
+    }
+    return keys[keys.length - 1].rect;
+}
+//# sourceMappingURL=camera.js.map

package/dist/core/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../src/core/camera.ts"],"names":[],"mappings":"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"}

package/dist/core/compose.d.ts

@@ -0,0 +1,38 @@
+import type { Rect, Vec2 } from "./timeline.js";
+/**
+ * Mapping from the captured page into the output frame.
+ *
+ * Three spaces are in play and confusing them is the easiest way to get a
+ * cursor that drifts away from what it is clicking:
+ *
+ *  - **viewport space** — CSS pixels, what the timeline stores.
+ *  - **state space** — pixels inside a captured PNG: viewport × dpr.
+ *  - **output space** — pixels in the rendered video frame.
+ *
+ * `camera` is a rectangle in viewport space; `frameArea` is where the app
+ * image is drawn in output space. Everything else follows from those two.
+ */
+export declare function sourceToOutput(point: Vec2, camera: Rect, frameArea: Rect): Vec2;
+export declare function rectToOutput(rect: Rect, camera: Rect, frameArea: Rect): Rect;
+/** The source rectangle to read out of a state image, in state pixels. */
+export declare function cameraToStatePixels(camera: Rect, dpr: number): Rect;
+/**
+ * Fit a viewport-shaped image into `canvas` with `padding` (a fraction of the
+ * smaller canvas dimension) around it. This is the rounded "device frame" the
+ * app sits in.
+ */
+export declare function fitFrameArea(canvas: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, padding: number): Rect;
+/**
+ * Opacity of the *new* state during a crossfade that starts at `cutFrame` and
+ * lasts `length` frames. Frame `cutFrame` itself is already partly faded, so
+ * a cut never shows a duplicated still.
+ */
+export declare function crossfadeAlpha(frame: number, cutFrame: number, length: number): number;
+/** Linear fade in/out envelope, in seconds, for captions and highlights. */
+export declare function fadeEnvelope(t: number, t0: number, t1: number, fade: number): number;

package/dist/core/compose.js

@@ -0,0 +1,81 @@
+import { clamp01 } from "./easing.js";
+/**
+ * Mapping from the captured page into the output frame.
+ *
+ * Three spaces are in play and confusing them is the easiest way to get a
+ * cursor that drifts away from what it is clicking:
+ *
+ *  - **viewport space** — CSS pixels, what the timeline stores.
+ *  - **state space** — pixels inside a captured PNG: viewport × dpr.
+ *  - **output space** — pixels in the rendered video frame.
+ *
+ * `camera` is a rectangle in viewport space; `frameArea` is where the app
+ * image is drawn in output space. Everything else follows from those two.
+ */
+export function sourceToOutput(point, camera, frameArea) {
+    const scale = frameArea.w / camera.w;
+    return [
+        frameArea.x + (point[0] - camera.x) * scale,
+        frameArea.y + (point[1] - camera.y) * scale,
+    ];
+}
+export function rectToOutput(rect, camera, frameArea) {
+    const scale = frameArea.w / camera.w;
+    return {
+        x: frameArea.x + (rect.x - camera.x) * scale,
+        y: frameArea.y + (rect.y - camera.y) * scale,
+        w: rect.w * scale,
+        h: rect.h * scale,
+    };
+}
+/** The source rectangle to read out of a state image, in state pixels. */
+export function cameraToStatePixels(camera, dpr) {
+    return {
+        x: camera.x * dpr,
+        y: camera.y * dpr,
+        w: camera.w * dpr,
+        h: camera.h * dpr,
+    };
+}
+/**
+ * Fit a viewport-shaped image into `canvas` with `padding` (a fraction of the
+ * smaller canvas dimension) around it. This is the rounded "device frame" the
+ * app sits in.
+ */
+export function fitFrameArea(canvas, viewport, padding) {
+    const inset = Math.min(canvas.width, canvas.height) * padding;
+    const availableW = canvas.width - inset * 2;
+    const availableH = canvas.height - inset * 2;
+    const aspect = viewport.width / viewport.height;
+    let w = availableW;
+    let h = w / aspect;
+    if (h > availableH) {
+        h = availableH;
+        w = h * aspect;
+    }
+    return {
+        x: (canvas.width - w) / 2,
+        y: (canvas.height - h) / 2,
+        w,
+        h,
+    };
+}
+/**
+ * Opacity of the *new* state during a crossfade that starts at `cutFrame` and
+ * lasts `length` frames. Frame `cutFrame` itself is already partly faded, so
+ * a cut never shows a duplicated still.
+ */
+export function crossfadeAlpha(frame, cutFrame, length) {
+    if (length <= 0)
+        return 1;
+    return clamp01((frame - cutFrame + 1) / length);
+}
+/** Linear fade in/out envelope, in seconds, for captions and highlights. */
+export function fadeEnvelope(t, t0, t1, fade) {
+    if (t <= t0 || t >= t1)
+        return 0;
+    if (fade <= 0)
+        return 1;
+    return Math.min(clamp01((t - t0) / fade), clamp01((t1 - t) / fade));
+}
+//# sourceMappingURL=compose.js.map

package/dist/core/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/core/compose.ts"],"names":[],"mappings":"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"}

package/dist/core/cursor.d.ts

@@ -0,0 +1,38 @@
+import type { CursorTrack, Rect, Vec2 } from "./timeline.js";
+import type { CursorSegment } from "./timeline.js";
+/** Straight-line distance between two points. */
+export declare function distance(a: Vec2, b: Vec2): number;
+/**
+ * Fitts's law, loosely: a move takes longer the further it goes and the
+ * smaller the thing it is aiming at. Without this every move takes the same
+ * time and the cursor reads as a machine — a nudge to an adjacent button
+ * should not take as long as a sweep across the window.
+ *
+ * Returns milliseconds.
+ */
+export declare function moveDuration(dist: number, targetSize: number): number;
+/**
+ * Where inside a box to aim. Dead centre every time is another machine tell,
+ * so land within the middle ~quarter but never exactly on the middle.
+ */
+export declare function targetPoint(box: Rect, rng: () => number): Vec2;
+export type PlanMoveOptions = {
+    /** Smallest dimension of the target, for the Fitts term. */
+    targetSize?: number;
+    /** Override the computed duration, in milliseconds. */
+    duration?: number;
+};
+/**
+ * A single move, as a quadratic Bézier with a slight perpendicular bow.
+ * People do not move a mouse in straight lines; a small arc is the cheapest
+ * convincing correction, and its direction alternates by seed so repeated
+ * moves along the same axis do not all curve the same way.
+ */
+export declare function planMove(from: Vec2, to: Vec2, t0: number, rng: () => number, options?: PlanMoveOptions): CursorSegment;
+/**
+ * Where the cursor is at time `t`. Before the track starts it sits at the
+ * first known position; after it ends, at the last.
+ */
+export declare function evalCursor(track: CursorTrack, t: number): Vec2;
+/** Where the cursor ends up once the whole track has played. */
+export declare function cursorEnd(track: CursorTrack, fallback: Vec2): Vec2;

package/dist/core/cursor.js

@@ -0,0 +1,103 @@
+import { clamp, minjerk } from "./easing.js";
+import { jitter } from "./rng.js";
+/** Straight-line distance between two points. */
+export function distance(a, b) {
+    return Math.hypot(b[0] - a[0], b[1] - a[1]);
+}
+/**
+ * Fitts's law, loosely: a move takes longer the further it goes and the
+ * smaller the thing it is aiming at. Without this every move takes the same
+ * time and the cursor reads as a machine — a nudge to an adjacent button
+ * should not take as long as a sweep across the window.
+ *
+ * Returns milliseconds.
+ */
+export function moveDuration(dist, targetSize) {
+    const size = Math.max(targetSize, MIN_TARGET_SIZE);
+    const raw = 250 + 120 * Math.log2(dist / size + 1);
+    return clamp(raw, 300, 900);
+}
+const MIN_TARGET_SIZE = 24;
+const ARC_MIN = 0.05;
+const ARC_MAX = 0.1;
+/**
+ * Where inside a box to aim. Dead centre every time is another machine tell,
+ * so land within the middle ~quarter but never exactly on the middle.
+ */
+export function targetPoint(box, rng) {
+    return [
+        box.x + box.w / 2 + jitter(rng, 0.12 * box.w),
+        box.y + box.h / 2 + jitter(rng, 0.12 * box.h),
+    ];
+}
+/**
+ * A single move, as a quadratic Bézier with a slight perpendicular bow.
+ * People do not move a mouse in straight lines; a small arc is the cheapest
+ * convincing correction, and its direction alternates by seed so repeated
+ * moves along the same axis do not all curve the same way.
+ */
+export function planMove(from, to, t0, rng, options = {}) {
+    const dist = distance(from, to);
+    const durationMs = options.duration ??
+        moveDuration(dist, options.targetSize ?? MIN_TARGET_SIZE);
+    const mid = [(from[0] + to[0]) / 2, (from[1] + to[1]) / 2];
+    let ctrl = mid;
+    if (dist > 0) {
+        const arc = ARC_MIN + rng() * (ARC_MAX - ARC_MIN);
+        const sign = rng() < 0.5 ? -1 : 1;
+        // Unit normal to the travel direction.
+        const nx = -(to[1] - from[1]) / dist;
+        const ny = (to[0] - from[0]) / dist;
+        const offset = dist * arc * sign;
+        ctrl = [mid[0] + nx * offset, mid[1] + ny * offset];
+    }
+    return {
+        kind: "move",
+        t0,
+        t1: t0 + durationMs / 1000,
+        from,
+        to,
+        ctrl,
+        ease: "minjerk",
+    };
+}
+function bezier(from, ctrl, to, u) {
+    const inv = 1 - u;
+    const a = inv * inv;
+    const b = 2 * inv * u;
+    const c = u * u;
+    return [
+        a * from[0] + b * ctrl[0] + c * to[0],
+        a * from[1] + b * ctrl[1] + c * to[1],
+    ];
+}
+/**
+ * Where the cursor is at time `t`. Before the track starts it sits at the
+ * first known position; after it ends, at the last.
+ */
+export function evalCursor(track, t) {
+    if (track.length === 0)
+        return [0, 0];
+    const first = track[0];
+    if (t <= first.t0)
+        return first.kind === "move" ? first.from : first.at;
+    for (const step of track) {
+        if (t > step.t1)
+            continue;
+        if (step.kind === "hold")
+            return step.at;
+        const span = step.t1 - step.t0;
+        const u = span <= 0 ? 1 : (t - step.t0) / span;
+        return bezier(step.from, step.ctrl, step.to, minjerk(u));
+    }
+    const last = track[track.length - 1];
+    return last.kind === "move" ? last.to : last.at;
+}
+/** Where the cursor ends up once the whole track has played. */
+export function cursorEnd(track, fallback) {
+    if (track.length === 0)
+        return fallback;
+    const last = track[track.length - 1];
+    return last.kind === "move" ? last.to : last.at;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/core/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/core/cursor.ts"],"names":[],"mappings":"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"}

package/dist/core/easing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimum-jerk: the standard model of a human reaching movement.
+ *
+ *   x(u) = 10u³ − 15u⁴ + 6u⁵
+ *
+ * Its first *and* second derivatives vanish at both ends, so motion starts
+ * and stops without a visible corner. This is the difference between a cursor
+ * that looks like a person moved it and one that looks like a tween — and the
+ * reason the recorder does not use CSS-style cubic-bezier easings, whose
+ * acceleration is discontinuous at the endpoints.
+ */
+export declare function minjerk(u: number): number;
+export declare function clamp01(u: number): number;
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function lerp(a: number, b: number, u: number): number;

package/dist/core/easing.js

@@ -0,0 +1,33 @@
+/**
+ * Minimum-jerk: the standard model of a human reaching movement.
+ *
+ *   x(u) = 10u³ − 15u⁴ + 6u⁵
+ *
+ * Its first *and* second derivatives vanish at both ends, so motion starts
+ * and stops without a visible corner. This is the difference between a cursor
+ * that looks like a person moved it and one that looks like a tween — and the
+ * reason the recorder does not use CSS-style cubic-bezier easings, whose
+ * acceleration is discontinuous at the endpoints.
+ */
+export function minjerk(u) {
+    const c = clamp01(u);
+    return c * c * c * (10 + c * (-15 + 6 * c));
+}
+export function clamp01(u) {
+    if (u <= 0)
+        return 0;
+    if (u >= 1)
+        return 1;
+    return u;
+}
+export function clamp(value, min, max) {
+    if (value <= min)
+        return min;
+    if (value >= max)
+        return max;
+    return value;
+}
+export function lerp(a, b, u) {
+    return a + (b - a) * u;
+}
+//# sourceMappingURL=easing.js.map

package/dist/core/easing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../src/core/easing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC7B,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAClD,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/core/loop.d.ts

@@ -0,0 +1,30 @@
+import type { Rect, Vec2 } from "./timeline.js";
+/**
+ * A lasso stroke. Authored as a handful of points and smoothed into a closed
+ * loop, because a polygon drawn by hand has no straight edges and no corners
+ * — a four-point polygon played back verbatim looks like a selection
+ * rectangle, not a lasso.
+ */
+/**
+ * Uniform closed Catmull-Rom through `points`. The curve passes through every
+ * control point, which is what makes authoring by fractions predictable.
+ */
+export declare function catmullRomClosed(points: Vec2[], samplesPerSegment: number): Vec2[];
+export type LoopPlanner = (box: Rect, rng: () => number) => Vec2[];
+export type LoopOptions = {
+    samplesPerSegment?: number;
+    /** Radial wobble as a fraction of the box size. */
+    jitter?: number;
+};
+/**
+ * Author a lasso as fractions of the target's box, so the same stroke lands
+ * on the same part of the map after a layout change.
+ */
+export declare function loop(fractions: readonly (readonly [number, number])[], options?: LoopOptions): LoopPlanner;
+/**
+ * Resample a path so consecutive points are equally spaced, then walk it with
+ * an easing. A raw Catmull-Rom is parameterised by segment, not by distance,
+ * so playing it back directly speeds up and slows down at every control
+ * point — visible as a stutter in the stroke.
+ */
+export declare function resampleByArcLength(path: Vec2[], count: number): Vec2[];

package/dist/core/loop.js

@@ -0,0 +1,96 @@
+import { jitter } from "./rng.js";
+/**
+ * A lasso stroke. Authored as a handful of points and smoothed into a closed
+ * loop, because a polygon drawn by hand has no straight edges and no corners
+ * — a four-point polygon played back verbatim looks like a selection
+ * rectangle, not a lasso.
+ */
+/**
+ * Uniform closed Catmull-Rom through `points`. The curve passes through every
+ * control point, which is what makes authoring by fractions predictable.
+ */
+export function catmullRomClosed(points, samplesPerSegment) {
+    if (points.length < 3)
+        return [...points];
+    const out = [];
+    const n = points.length;
+    for (let i = 0; i < n; i += 1) {
+        const p0 = points[(i - 1 + n) % n];
+        const p1 = points[i];
+        const p2 = points[(i + 1) % n];
+        const p3 = points[(i + 2) % n];
+        for (let s = 0; s < samplesPerSegment; s += 1) {
+            const t = s / samplesPerSegment;
+            const t2 = t * t;
+            const t3 = t2 * t;
+            out.push([
+                0.5 *
+                    (2 * p1[0] +
+                        (-p0[0] + p2[0]) * t +
+                        (2 * p0[0] - 5 * p1[0] + 4 * p2[0] - p3[0]) * t2 +
+                        (-p0[0] + 3 * p1[0] - 3 * p2[0] + p3[0]) * t3),
+                0.5 *
+                    (2 * p1[1] +
+                        (-p0[1] + p2[1]) * t +
+                        (2 * p0[1] - 5 * p1[1] + 4 * p2[1] - p3[1]) * t2 +
+                        (-p0[1] + 3 * p1[1] - 3 * p2[1] + p3[1]) * t3),
+            ]);
+        }
+    }
+    // Close the ring explicitly so callers can draw it without special-casing.
+    out.push(out[0]);
+    return out;
+}
+/**
+ * Author a lasso as fractions of the target's box, so the same stroke lands
+ * on the same part of the map after a layout change.
+ */
+export function loop(fractions, options = {}) {
+    const samplesPerSegment = options.samplesPerSegment ?? 16;
+    const wobble = options.jitter ?? 0.01;
+    return (box, rng) => {
+        const points = fractions.map(([fx, fy]) => [
+            box.x + fx * box.w + jitter(rng, wobble * box.w),
+            box.y + fy * box.h + jitter(rng, wobble * box.h),
+        ]);
+        return catmullRomClosed(points, samplesPerSegment);
+    };
+}
+/**
+ * Resample a path so consecutive points are equally spaced, then walk it with
+ * an easing. A raw Catmull-Rom is parameterised by segment, not by distance,
+ * so playing it back directly speeds up and slows down at every control
+ * point — visible as a stutter in the stroke.
+ */
+export function resampleByArcLength(path, count) {
+    if (path.length === 0)
+        return [];
+    if (count <= 1)
+        return [path[0]];
+    const cumulative = [0];
+    for (let i = 1; i < path.length; i += 1) {
+        const dx = path[i][0] - path[i - 1][0];
+        const dy = path[i][1] - path[i - 1][1];
+        cumulative.push(cumulative[i - 1] + Math.hypot(dx, dy));
+    }
+    const total = cumulative[cumulative.length - 1];
+    if (total === 0)
+        return new Array(count).fill(path[0]);
+    const out = [];
+    let cursor = 1;
+    for (let i = 0; i < count; i += 1) {
+        const target = (i / (count - 1)) * total;
+        while (cursor < cumulative.length - 1 && cumulative[cursor] < target) {
+            cursor += 1;
+        }
+        const spanStart = cumulative[cursor - 1];
+        const spanEnd = cumulative[cursor];
+        const span = spanEnd - spanStart;
+        const u = span <= 0 ? 0 : (target - spanStart) / span;
+        const a = path[cursor - 1];
+        const b = path[cursor];
+        out.push([a[0] + (b[0] - a[0]) * u, a[1] + (b[1] - a[1]) * u]);
+    }
+    return out;
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/core/loop.ts"],"names":[],"mappings":"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"}