@pixerate/editor 0.164.0 → 0.166.0

package/dist/canvas/index.js

@@ -53,14 +53,14 @@ import {
   shiftEndpoint,
   textWidth,
   timelineGeometry
-} from "../chunk-GZ2FM3ZB.js";
+} from "../chunk-DKNEQX7T.js";
 import {
   TokenError,
   getTokenCollection,
   getTokenVariable,
   isTokenInScope,
   resolveToken
-} from "../chunk-SDHZG5TF.js";
+} from "../chunk-ILP77UD6.js";
 import {
   DEFAULT_NODE_HEIGHT,
   DEFAULT_NODE_WIDTH,
@@ -113,10 +113,11 @@ import {
 } from "../chunk-5ED73EC6.js";
 import {
   layoutChart
-} from "../chunk-Z4P2RBMJ.js";
+} from "../chunk-ITANXMZD.js";
 import {
   createChartSpec
-} from "../chunk-3NEZJCBY.js";
+} from "../chunk-FR432ROA.js";
+import "../chunk-O6OGNDND.js";
 import "../chunk-II2WIF5Z.js";
 import {
   PathOpsError,
@@ -215,7 +216,7 @@ import {
 } from "../chunk-ODBT55Q7.js";
 import {
   defineEditorDocument
-} from "../chunk-NHLYK3AX.js";
+} from "../chunk-XBQX76CT.js";
 import "../chunk-HF5QZS7Z.js";
 import {
   ANIMATION_TIME_EPSILON,
@@ -229,7 +230,7 @@ import {
   pageHidden,
   realClock,
   wrapAnimationTime
-} from "../chunk-H3OEM3Q2.js";
+} from "../chunk-F6R67I3A.js";
 import {
   ANIMATION_EASING_LABELS,
   ANIMATION_EASING_PRESETS,
@@ -254,12 +255,13 @@ import {
   oklabToRgb,
   parseOklab,
   rgbToOklab
-} from "../chunk-BQWGN5WH.js";
+} from "../chunk-M2TPMYJE.js";
 import {
   normalizeTokenColor
 } from "../chunk-2WPNAGHI.js";
-import "../chunk-QYZGBVNC.js";
-import "../chunk-4VU4CP7R.js";
+import "../chunk-7272D3K2.js";
+import "../chunk-YBAPT7NL.js";
+import "../chunk-MHLU6GRJ.js";
 import "../chunk-6ONMQ6WF.js";
 
 // src/canvas/trajectory.ts

package/dist/chart/controller.d.cts

@@ -2,7 +2,7 @@ import { HistoryManager } from '../history/HistoryManager.cjs';
 import { type ChartTrendFit } from './trend.cjs';
 import { type ChartTreeRow } from './tree.cjs';
 import { type ChartTableOptions } from './spec.cjs';
-import type { ChartAxis, ChartIssue, ChartCurve, ChartErrorBars, ChartLegend, ChartMarker, ChartNumberFormat, ChartReferenceBand, ChartReferenceLine, ChartSelection, ChartSeries, ChartSeriesType, ChartSpec, ChartTrendline, ChartType } from './types.cjs';
+import type { ChartAxis, ChartIssue, ChartCurve, ChartErrorBars, ChartLegend, ChartLink, ChartMarker, ChartNumberFormat, ChartReferenceBand, ChartReferenceLine, ChartSelection, ChartSeries, ChartSeriesType, ChartSpec, ChartTrendline, ChartType } from './types.cjs';
 export interface ChartControllerOptions {
     /** Starting chart (any partial or saved spec; problems are reported in `state.issues`). */
     spec?: Partial<ChartSpec> | unknown;
@@ -10,6 +10,13 @@ export interface ChartControllerOptions {
     history?: HistoryManager;
     /** Called after the spec changes (edit, undo, redo, load). */
     onChange?: (spec: Readonly<ChartSpec>) => void;
+    /** Time and frames for playing a bar race (default: `performance.now` / `requestAnimationFrame`, else timers). */
+    raceTicker?: ChartRaceTicker;
+}
+/** Drives bar race playback: the current time in ms, and a way to run `step` on the next frame (returns a cancel). */
+export interface ChartRaceTicker {
+    now(): number;
+    next(step: () => void): () => void;
 }
 /** A snapshot of the controller. The same object is returned until something changes. */
 export interface ChartState {
@@ -27,6 +34,10 @@ export interface ChartState {
     canRedo: boolean;
     undoLabel: string;
     redoLabel: string;
+    /** Bar race: the moment shown, a fractional category index (null: the last time point). View state, not undone. */
+    raceFrame: number | null;
+    /** Bar race: playback is running. */
+    racePlaying: boolean;
     /** Bumped on every change. */
     revision: number;
 }
@@ -109,6 +120,9 @@ export declare class ChartController {
     private revision;
     private applying;
     private readonly onChange?;
+    private readonly raceTicker;
+    private raceFrame;
+    private raceStop;
     private readonly listeners;
     private unsubscribeHistory?;
     private state;
@@ -220,7 +234,7 @@ export declare class ChartController {
     }): ChartActionResult & {
         issues?: ChartIssue[];
     };
-    /** A refusal while the data is a tree (cell edits would be overwritten by its totals), else null. */
+    /** A refusal while the data is a tree or flows (cell edits would be overwritten by their totals), else null. */
     private treeLocked;
     /** Replaces the grouped data (an empty list goes back to the table, keeping the totals as values). One undo step. */
     setTree(tree: unknown, options?: ChartEditOptions): ChartActionResult;
@@ -268,6 +282,35 @@ export declare class ChartController {
     };
     /** Removes a node (with everything under it). A group left empty becomes an item with value 0. */
     removeTreeNode(path: readonly string[]): ChartActionResult;
+    /**
+     * Replaces the flows (and, when given, the node order). An empty list goes back to the
+     * table, keeping how much passed through each node as values. One undo step, all-or-nothing.
+     */
+    setLinks(links: unknown, options?: ChartEditOptions & {
+        nodes?: readonly string[];
+    }): ChartActionResult;
+    /** Replaces the data with flows from a table of source, target and value columns. */
+    importLinksTable(rows: ReadonlyArray<ReadonlyArray<unknown>>, options?: {
+        header?: boolean | 'auto';
+    }): ChartActionResult;
+    private badLink;
+    /** Adds a flow and returns its index. */
+    addLink(link: ChartLink): {
+        ok: true;
+        index: number;
+    } | {
+        ok: false;
+        message: string;
+        issues?: ChartIssue[];
+    };
+    /** Changes a flow's source, target, value or colour (`color: null` goes back to the default). */
+    updateLink(index: number, patch: {
+        source?: string;
+        target?: string;
+        value?: number;
+        color?: string | null;
+    }): ChartActionResult;
+    removeLink(index: number): ChartActionResult;
     /** Sets the note written under the chart ("" removes it). */
     setNote(note: string): ChartActionResult;
     /**
@@ -345,6 +388,21 @@ export declare class ChartController {
      * undo step). Series colours, types and other per-series settings are dropped.
      */
     transpose(): ChartActionResult;
+    /**
+     * Shows a bar race at a moment: a category index, fractional between time points (`null`:
+     * the last one). View state like the selection, so not an undo step. Stops playback.
+     */
+    setRaceFrame(frame: number | null): ChartActionResult;
+    /**
+     * Plays the bar race from the moment shown (from the start when it is at the end), moving
+     * one time point every `msPerStep` (default 1000) until the last. Not an undo step.
+     */
+    playRace(options?: {
+        msPerStep?: number;
+    }): ChartActionResult;
+    /** Pauses bar race playback where it is. */
+    pauseRace(): void;
+    private stopRace;
     /** Selects a chart element (view state; not an undo step). */
     select(selection: ChartSelection | null): void;
     /**

package/dist/chart/controller.d.ts

@@ -2,7 +2,7 @@ import { HistoryManager } from '../history/HistoryManager.js';
 import { type ChartTrendFit } from './trend.js';
 import { type ChartTreeRow } from './tree.js';
 import { type ChartTableOptions } from './spec.js';
-import type { ChartAxis, ChartIssue, ChartCurve, ChartErrorBars, ChartLegend, ChartMarker, ChartNumberFormat, ChartReferenceBand, ChartReferenceLine, ChartSelection, ChartSeries, ChartSeriesType, ChartSpec, ChartTrendline, ChartType } from './types.js';
+import type { ChartAxis, ChartIssue, ChartCurve, ChartErrorBars, ChartLegend, ChartLink, ChartMarker, ChartNumberFormat, ChartReferenceBand, ChartReferenceLine, ChartSelection, ChartSeries, ChartSeriesType, ChartSpec, ChartTrendline, ChartType } from './types.js';
 export interface ChartControllerOptions {
     /** Starting chart (any partial or saved spec; problems are reported in `state.issues`). */
     spec?: Partial<ChartSpec> | unknown;
@@ -10,6 +10,13 @@ export interface ChartControllerOptions {
     history?: HistoryManager;
     /** Called after the spec changes (edit, undo, redo, load). */
     onChange?: (spec: Readonly<ChartSpec>) => void;
+    /** Time and frames for playing a bar race (default: `performance.now` / `requestAnimationFrame`, else timers). */
+    raceTicker?: ChartRaceTicker;
+}
+/** Drives bar race playback: the current time in ms, and a way to run `step` on the next frame (returns a cancel). */
+export interface ChartRaceTicker {
+    now(): number;
+    next(step: () => void): () => void;
 }
 /** A snapshot of the controller. The same object is returned until something changes. */
 export interface ChartState {
@@ -27,6 +34,10 @@ export interface ChartState {
     canRedo: boolean;
     undoLabel: string;
     redoLabel: string;
+    /** Bar race: the moment shown, a fractional category index (null: the last time point). View state, not undone. */
+    raceFrame: number | null;
+    /** Bar race: playback is running. */
+    racePlaying: boolean;
     /** Bumped on every change. */
     revision: number;
 }
@@ -109,6 +120,9 @@ export declare class ChartController {
     private revision;
     private applying;
     private readonly onChange?;
+    private readonly raceTicker;
+    private raceFrame;
+    private raceStop;
     private readonly listeners;
     private unsubscribeHistory?;
     private state;
@@ -220,7 +234,7 @@ export declare class ChartController {
     }): ChartActionResult & {
         issues?: ChartIssue[];
     };
-    /** A refusal while the data is a tree (cell edits would be overwritten by its totals), else null. */
+    /** A refusal while the data is a tree or flows (cell edits would be overwritten by their totals), else null. */
     private treeLocked;
     /** Replaces the grouped data (an empty list goes back to the table, keeping the totals as values). One undo step. */
     setTree(tree: unknown, options?: ChartEditOptions): ChartActionResult;
@@ -268,6 +282,35 @@ export declare class ChartController {
     };
     /** Removes a node (with everything under it). A group left empty becomes an item with value 0. */
     removeTreeNode(path: readonly string[]): ChartActionResult;
+    /**
+     * Replaces the flows (and, when given, the node order). An empty list goes back to the
+     * table, keeping how much passed through each node as values. One undo step, all-or-nothing.
+     */
+    setLinks(links: unknown, options?: ChartEditOptions & {
+        nodes?: readonly string[];
+    }): ChartActionResult;
+    /** Replaces the data with flows from a table of source, target and value columns. */
+    importLinksTable(rows: ReadonlyArray<ReadonlyArray<unknown>>, options?: {
+        header?: boolean | 'auto';
+    }): ChartActionResult;
+    private badLink;
+    /** Adds a flow and returns its index. */
+    addLink(link: ChartLink): {
+        ok: true;
+        index: number;
+    } | {
+        ok: false;
+        message: string;
+        issues?: ChartIssue[];
+    };
+    /** Changes a flow's source, target, value or colour (`color: null` goes back to the default). */
+    updateLink(index: number, patch: {
+        source?: string;
+        target?: string;
+        value?: number;
+        color?: string | null;
+    }): ChartActionResult;
+    removeLink(index: number): ChartActionResult;
     /** Sets the note written under the chart ("" removes it). */
     setNote(note: string): ChartActionResult;
     /**
@@ -345,6 +388,21 @@ export declare class ChartController {
      * undo step). Series colours, types and other per-series settings are dropped.
      */
     transpose(): ChartActionResult;
+    /**
+     * Shows a bar race at a moment: a category index, fractional between time points (`null`:
+     * the last one). View state like the selection, so not an undo step. Stops playback.
+     */
+    setRaceFrame(frame: number | null): ChartActionResult;
+    /**
+     * Plays the bar race from the moment shown (from the start when it is at the end), moving
+     * one time point every `msPerStep` (default 1000) until the last. Not an undo step.
+     */
+    playRace(options?: {
+        msPerStep?: number;
+    }): ChartActionResult;
+    /** Pauses bar race playback where it is. */
+    pauseRace(): void;
+    private stopRace;
     /** Selects a chart element (view state; not an undo step). */
     select(selection: ChartSelection | null): void;
     /**