@pixerate/editor 0.162.0 → 0.163.0

package/dist/chart/types.d.cts

@@ -10,8 +10,14 @@
  * - `waterfall` draws the first series as running increases and decreases.
  * - `histogram` bins every value of the visible series; `box` draws one box and whiskers per series.
  * - `funnel` and `treemap` draw the first series, one bar or rectangle per category.
+ * - `slope` joins each category's value in the first series (before) to the second (after).
+ * - `likert` draws each category (a question) as one diverging bar of the series (answers,
+ *   most negative first), as shares of the question's total.
+ * - `parliament` draws the first series as seats in a hemicycle, one colour per category.
+ * - `sunburst` draws `tree` as rings from the centre out (or, without a tree, the first series
+ *   as one ring); a `treemap` with a `tree` nests each group's rectangles inside it.
  */
-export type ChartType = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap';
+export type ChartType = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap' | 'slope' | 'likert' | 'parliament' | 'sunburst';
 /** How a series is drawn in a cartesian chart. */
 export type ChartSeriesType = 'bar' | 'line' | 'area' | 'scatter';
 /** One data value; `null` is a gap (missing value). */
@@ -101,6 +107,41 @@ export interface ChartSeries {
     errorBars?: ChartErrorBars;
     /** Error bars along the numeric x axis (scatter charts with x values). */
     xErrorBars?: ChartErrorBars;
+    /** A label pinned to each point that matters, one per category (null: none). Bar, line, area and scatter charts. */
+    callouts?: (string | null)[];
+}
+/**
+ * One node of a chart's hierarchy: a leaf with a `value`, or a group with `children` (whose
+ * value is the sum of its leaves). Sibling names are unique, so a path of names finds a node.
+ */
+export interface ChartTreeNode {
+    name: string;
+    /** Leaves only: 0 or more. */
+    value?: number;
+    children?: ChartTreeNode[];
+    /** CSS colour (default: the palette colour of its top-level group, lighter further in). */
+    color?: string;
+}
+/** Which axis a reference line or band is measured on: the value axis, the secondary value axis, or the numeric x axis of a scatter or bubble chart. */
+export type ChartReferenceAxis = 'y' | 'y2' | 'x';
+/** A line across the plot at one value: a target, a floor, an average. */
+export interface ChartReferenceLine {
+    value: number;
+    label?: string;
+    /** Default `y`. */
+    axis?: ChartReferenceAxis;
+    /** CSS colour (default: the theme's text colour). */
+    color?: string;
+}
+/** A band across the plot between two values: a target range. */
+export interface ChartReferenceBand {
+    from: number;
+    to: number;
+    label?: string;
+    /** Default `y`. */
+    axis?: ChartReferenceAxis;
+    /** CSS colour (default: the theme's text colour, faint). */
+    color?: string;
 }
 export interface ChartNumberFormat {
     /** `number` (default), `percent` (0.25 → 25%), `currency` or `compact` (1.2K). */
@@ -157,6 +198,8 @@ export type ChartStacking = 'none' | 'stacked' | 'percent';
 export type ChartOrientation = 'vertical' | 'horizontal';
 export type ChartCurve = 'linear' | 'smooth' | 'step';
 export type ChartRadarGraticule = 'polygon' | 'circle';
+export type ChartLikertNeutral = 'split' | 'separate';
+export type ChartLikertSort = 'none' | 'positive' | 'negative';
 /** Where bar labels go: `auto` puts them outside, or centred on stacked segments, and drops ones that do not fit. */
 export type ChartLabelPosition = 'auto' | 'inside' | 'outside' | 'center';
 /** A whole chart: data plus presentation. Plain JSON, safe to persist. */
@@ -203,6 +246,37 @@ export interface ChartSpec {
     radarTicks: number | null;
     /** Radar: rings drawn as polygons through the spokes or as circles. */
     radarGraticule: ChartRadarGraticule;
+    /** A source or footnote, written under the chart. */
+    note: string;
+    /**
+     * The marks the chart is about; the rest are drawn muted. Each entry names a category
+     * (label) or a series (name or id). A point stays bright when its category or its series
+     * is named; whole lines and areas are muted only when another series is named.
+     */
+    highlight: string[];
+    /** Targets, floors and averages across the plot (bar, line, area, scatter and bubble charts). */
+    referenceLines: ChartReferenceLine[];
+    /** Target ranges across the plot (bar, line, area, scatter and bubble charts). */
+    referenceBands: ChartReferenceBand[];
+    /** A one-series bar, line, area or scatter chart colours each category from the palette (and the legend lists categories). */
+    varyColors: boolean;
+    /** Likert, with an odd number of answers: the middle one straddles the centre line (`split`) or is drawn apart on the right (`separate`). */
+    likertNeutral: ChartLikertNeutral;
+    /** Likert: order the questions by agreement (`positive`), by disagreement (`negative`) or as given (`none`). */
+    likertSort: ChartLikertSort;
+    /** Parliament: the sweep of the hemicycle in degrees, 90–360. */
+    parliamentArc: number;
+    /** Parliament: seats needed for a majority, drawn as a line (`null`: half of the seats plus one). */
+    parliamentMajority: number | null;
+    /** Parliament: the caption under the seat total ("" writes "seats"). */
+    parliamentLabel: string;
+    /**
+     * Grouped data (treemaps and sunbursts). When set it is the chart's data: the categories are
+     * its top-level names and the first series holds their totals, so other types draw the totals.
+     */
+    tree: ChartTreeNode[];
+    /** Sunburst: the caption under the total in the centre ("" for none). */
+    sunburstLabel: string;
 }
 /** What a click selects. */
 export type ChartSelection = {
@@ -258,7 +332,7 @@ export interface ChartRect {
     height: number;
 }
 /** What a mark is, for styling and tests. */
-export type ChartMarkRole = 'background' | 'title' | 'subtitle' | 'grid' | 'axis' | 'tick' | 'tick-label' | 'axis-title' | 'bar' | 'line' | 'area' | 'point' | 'slice' | 'cell' | 'box' | 'whisker' | 'outlier' | 'connector' | 'trendline' | 'trendline-label' | 'error-bar' | 'data-label' | 'legend-swatch' | 'legend-label' | 'drag-readout' | 'selection' | 'empty';
+export type ChartMarkRole = 'background' | 'title' | 'subtitle' | 'grid' | 'axis' | 'tick' | 'tick-label' | 'axis-title' | 'bar' | 'line' | 'area' | 'point' | 'slice' | 'cell' | 'box' | 'whisker' | 'outlier' | 'connector' | 'trendline' | 'trendline-label' | 'error-bar' | 'data-label' | 'legend-swatch' | 'legend-label' | 'drag-readout' | 'reference-line' | 'reference-band' | 'reference-label' | 'callout' | 'note' | 'selection' | 'empty';
 interface ChartMarkBase {
     /** Unique within the scene (a stable key for frameworks). */
     key: string;
@@ -334,7 +408,7 @@ export interface ChartValueScale {
 }
 /** Something the layout had to leave out or shorten, as a sentence (for agents and screen readers). */
 export interface ChartWarning {
-    code: 'labels-hidden' | 'labels-truncated' | 'legend-truncated' | 'points-decimated' | 'values-skipped' | 'data-labels-hidden' | 'type-fallback';
+    code: 'labels-hidden' | 'labels-truncated' | 'legend-truncated' | 'points-decimated' | 'values-skipped' | 'data-labels-hidden' | 'type-fallback' | 'annotations-skipped' | 'highlight-unmatched';
     message: string;
 }
 /** A laid-out chart: drawing primitives in scene pixels, ready for SVG, canvas or anything else. */

package/dist/chart/types.d.ts

@@ -10,8 +10,14 @@
  * - `waterfall` draws the first series as running increases and decreases.
  * - `histogram` bins every value of the visible series; `box` draws one box and whiskers per series.
  * - `funnel` and `treemap` draw the first series, one bar or rectangle per category.
+ * - `slope` joins each category's value in the first series (before) to the second (after).
+ * - `likert` draws each category (a question) as one diverging bar of the series (answers,
+ *   most negative first), as shares of the question's total.
+ * - `parliament` draws the first series as seats in a hemicycle, one colour per category.
+ * - `sunburst` draws `tree` as rings from the centre out (or, without a tree, the first series
+ *   as one ring); a `treemap` with a `tree` nests each group's rectangles inside it.
  */
-export type ChartType = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap';
+export type ChartType = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'radar' | 'waterfall' | 'histogram' | 'box' | 'funnel' | 'treemap' | 'slope' | 'likert' | 'parliament' | 'sunburst';
 /** How a series is drawn in a cartesian chart. */
 export type ChartSeriesType = 'bar' | 'line' | 'area' | 'scatter';
 /** One data value; `null` is a gap (missing value). */
@@ -101,6 +107,41 @@ export interface ChartSeries {
     errorBars?: ChartErrorBars;
     /** Error bars along the numeric x axis (scatter charts with x values). */
     xErrorBars?: ChartErrorBars;
+    /** A label pinned to each point that matters, one per category (null: none). Bar, line, area and scatter charts. */
+    callouts?: (string | null)[];
+}
+/**
+ * One node of a chart's hierarchy: a leaf with a `value`, or a group with `children` (whose
+ * value is the sum of its leaves). Sibling names are unique, so a path of names finds a node.
+ */
+export interface ChartTreeNode {
+    name: string;
+    /** Leaves only: 0 or more. */
+    value?: number;
+    children?: ChartTreeNode[];
+    /** CSS colour (default: the palette colour of its top-level group, lighter further in). */
+    color?: string;
+}
+/** Which axis a reference line or band is measured on: the value axis, the secondary value axis, or the numeric x axis of a scatter or bubble chart. */
+export type ChartReferenceAxis = 'y' | 'y2' | 'x';
+/** A line across the plot at one value: a target, a floor, an average. */
+export interface ChartReferenceLine {
+    value: number;
+    label?: string;
+    /** Default `y`. */
+    axis?: ChartReferenceAxis;
+    /** CSS colour (default: the theme's text colour). */
+    color?: string;
+}
+/** A band across the plot between two values: a target range. */
+export interface ChartReferenceBand {
+    from: number;
+    to: number;
+    label?: string;
+    /** Default `y`. */
+    axis?: ChartReferenceAxis;
+    /** CSS colour (default: the theme's text colour, faint). */
+    color?: string;
 }
 export interface ChartNumberFormat {
     /** `number` (default), `percent` (0.25 → 25%), `currency` or `compact` (1.2K). */
@@ -157,6 +198,8 @@ export type ChartStacking = 'none' | 'stacked' | 'percent';
 export type ChartOrientation = 'vertical' | 'horizontal';
 export type ChartCurve = 'linear' | 'smooth' | 'step';
 export type ChartRadarGraticule = 'polygon' | 'circle';
+export type ChartLikertNeutral = 'split' | 'separate';
+export type ChartLikertSort = 'none' | 'positive' | 'negative';
 /** Where bar labels go: `auto` puts them outside, or centred on stacked segments, and drops ones that do not fit. */
 export type ChartLabelPosition = 'auto' | 'inside' | 'outside' | 'center';
 /** A whole chart: data plus presentation. Plain JSON, safe to persist. */
@@ -203,6 +246,37 @@ export interface ChartSpec {
     radarTicks: number | null;
     /** Radar: rings drawn as polygons through the spokes or as circles. */
     radarGraticule: ChartRadarGraticule;
+    /** A source or footnote, written under the chart. */
+    note: string;
+    /**
+     * The marks the chart is about; the rest are drawn muted. Each entry names a category
+     * (label) or a series (name or id). A point stays bright when its category or its series
+     * is named; whole lines and areas are muted only when another series is named.
+     */
+    highlight: string[];
+    /** Targets, floors and averages across the plot (bar, line, area, scatter and bubble charts). */
+    referenceLines: ChartReferenceLine[];
+    /** Target ranges across the plot (bar, line, area, scatter and bubble charts). */
+    referenceBands: ChartReferenceBand[];
+    /** A one-series bar, line, area or scatter chart colours each category from the palette (and the legend lists categories). */
+    varyColors: boolean;
+    /** Likert, with an odd number of answers: the middle one straddles the centre line (`split`) or is drawn apart on the right (`separate`). */
+    likertNeutral: ChartLikertNeutral;
+    /** Likert: order the questions by agreement (`positive`), by disagreement (`negative`) or as given (`none`). */
+    likertSort: ChartLikertSort;
+    /** Parliament: the sweep of the hemicycle in degrees, 90–360. */
+    parliamentArc: number;
+    /** Parliament: seats needed for a majority, drawn as a line (`null`: half of the seats plus one). */
+    parliamentMajority: number | null;
+    /** Parliament: the caption under the seat total ("" writes "seats"). */
+    parliamentLabel: string;
+    /**
+     * Grouped data (treemaps and sunbursts). When set it is the chart's data: the categories are
+     * its top-level names and the first series holds their totals, so other types draw the totals.
+     */
+    tree: ChartTreeNode[];
+    /** Sunburst: the caption under the total in the centre ("" for none). */
+    sunburstLabel: string;
 }
 /** What a click selects. */
 export type ChartSelection = {
@@ -258,7 +332,7 @@ export interface ChartRect {
     height: number;
 }
 /** What a mark is, for styling and tests. */
-export type ChartMarkRole = 'background' | 'title' | 'subtitle' | 'grid' | 'axis' | 'tick' | 'tick-label' | 'axis-title' | 'bar' | 'line' | 'area' | 'point' | 'slice' | 'cell' | 'box' | 'whisker' | 'outlier' | 'connector' | 'trendline' | 'trendline-label' | 'error-bar' | 'data-label' | 'legend-swatch' | 'legend-label' | 'drag-readout' | 'selection' | 'empty';
+export type ChartMarkRole = 'background' | 'title' | 'subtitle' | 'grid' | 'axis' | 'tick' | 'tick-label' | 'axis-title' | 'bar' | 'line' | 'area' | 'point' | 'slice' | 'cell' | 'box' | 'whisker' | 'outlier' | 'connector' | 'trendline' | 'trendline-label' | 'error-bar' | 'data-label' | 'legend-swatch' | 'legend-label' | 'drag-readout' | 'reference-line' | 'reference-band' | 'reference-label' | 'callout' | 'note' | 'selection' | 'empty';
 interface ChartMarkBase {
     /** Unique within the scene (a stable key for frameworks). */
     key: string;
@@ -334,7 +408,7 @@ export interface ChartValueScale {
 }
 /** Something the layout had to leave out or shorten, as a sentence (for agents and screen readers). */
 export interface ChartWarning {
-    code: 'labels-hidden' | 'labels-truncated' | 'legend-truncated' | 'points-decimated' | 'values-skipped' | 'data-labels-hidden' | 'type-fallback';
+    code: 'labels-hidden' | 'labels-truncated' | 'legend-truncated' | 'points-decimated' | 'values-skipped' | 'data-labels-hidden' | 'type-fallback' | 'annotations-skipped' | 'highlight-unmatched';
     message: string;
 }
 /** A laid-out chart: drawing primitives in scene pixels, ready for SVG, canvas or anything else. */

package/dist/{chunk-7YBDRJXT.cjs → chunk-22KLZZGH.cjs}

@@ -11,10 +11,10 @@ var _chunkYN6JKAUEcjs = require('./chunk-YN6JKAUE.cjs');
 
 
 
-var _chunkNA4UVVJ4cjs = require('./chunk-NA4UVVJ4.cjs');
+var _chunkYGG7WDWTcjs = require('./chunk-YGG7WDWT.cjs');
 
 
-var _chunkLL3H5XUHcjs = require('./chunk-LL3H5XUH.cjs');
+var _chunkR3P2M7HUcjs = require('./chunk-R3P2M7HU.cjs');
 
 // src/export/images.ts
 var DOCX_IMAGE_TYPES = {
@@ -1028,12 +1028,12 @@ var DocxBuilder = (_class2 = class {
       this.drop("node", "chart", "chart has no spec");
       return;
     }
-    const spec = _chunkLL3H5XUHcjs.normalizeChartSpec.call(void 0, raw).spec;
-    const written = _chunkNA4UVVJ4cjs.chartToOoxml.call(void 0, spec);
+    const spec = _chunkR3P2M7HUcjs.normalizeChartSpec.call(void 0, raw).spec;
+    const written = _chunkYGG7WDWTcjs.chartToOoxml.call(void 0, spec);
     for (const issue of written.issues) this.drop("node", "chart", issue);
     const name = `chart${this.charts.length + 1}.xml`;
     this.charts.push(written.xml);
-    const relId = this.rels.add(_chunkNA4UVVJ4cjs.CHART_OOXML_RELATIONSHIP, `charts/${name}`);
+    const relId = this.rels.add(_chunkYGG7WDWTcjs.CHART_OOXML_RELATIONSHIP, `charts/${name}`);
     let width = _nullishCoalesce(pixelAttr(_optionalChain([node, 'access', _91 => _91.attrs, 'optionalAccess', _92 => _92.width])), () => ( MAX_IMAGE_WIDTH_PX));
     let height = _nullishCoalesce(pixelAttr(_optionalChain([node, 'access', _93 => _93.attrs, 'optionalAccess', _94 => _94.height])), () => ( 320));
     if (width > MAX_IMAGE_WIDTH_PX) {
@@ -1050,8 +1050,8 @@ var DocxBuilder = (_class2 = class {
     drawing.empty("wp:extent", { cx, cy }).empty("wp:effectExtent", { l: 0, t: 0, r: 0, b: 0 });
     drawing.empty("wp:docPr", { id, name: `Chart ${id}`, descr: title || void 0, title: title || void 0 });
     drawing.empty("wp:cNvGraphicFramePr");
-    drawing.open("a:graphic").open("a:graphicData", { uri: _chunkNA4UVVJ4cjs.CHART_OOXML_NS });
-    drawing.empty("c:chart", { "xmlns:c": _chunkNA4UVVJ4cjs.CHART_OOXML_NS, "r:id": relId });
+    drawing.open("a:graphic").open("a:graphicData", { uri: _chunkYGG7WDWTcjs.CHART_OOXML_NS });
+    drawing.empty("c:chart", { "xmlns:c": _chunkYGG7WDWTcjs.CHART_OOXML_NS, "r:id": relId });
     drawing.close("a:graphicData").close("a:graphic").close("wp:inline").close("w:drawing").close("w:r");
     this.report.written.paragraphs++;
     w.open("w:p");
@@ -1384,7 +1384,7 @@ var DocxBuilder = (_class2 = class {
     if (people) add("word/people.xml", people, `${CT_WML}people+xml`);
     parts.push({ name: "word/_rels/document.xml.rels", data: this.rels.xml() });
     for (const file of this.media) parts.push({ name: `word/media/${file.name}`, data: file.bytes });
-    this.charts.forEach((xml, i) => add(`word/charts/chart${i + 1}.xml`, xml, _chunkNA4UVVJ4cjs.CHART_OOXML_CONTENT_TYPE));
+    this.charts.forEach((xml, i) => add(`word/charts/chart${i + 1}.xml`, xml, _chunkYGG7WDWTcjs.CHART_OOXML_CONTENT_TYPE));
     add("docProps/core.xml", this.coreXml(now), "application/vnd.openxmlformats-package.core-properties+xml");
     const app = new XmlWriter();
     app.open("Properties", { xmlns: "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" });

package/dist/{chunk-LQLZHP6F.js → chunk-36OKQDCF.js}

@@ -2358,12 +2358,15 @@ var WetMedium = class {
   sample(rect, cov) {
     const s = this.world.sample(this.laneId, rect, cov);
     if (!(s.wet > 0) || !(s.weight > 0)) return null;
-    const k = s.pigment;
-    const kmax = Math.max(k[0], k[1], k[2]);
+    const k0 = s.pigment[0] + s.settled[0];
+    const k1 = s.pigment[1] + s.settled[1];
+    const k2 = s.pigment[2] + s.settled[2];
+    const k3 = s.pigment[3] + s.settled[3];
+    const kmax = Math.max(k0, k1, k2);
     if (!(kmax > 1e-9)) return null;
     const f = SAMPLE_K / kmax;
-    const rgb = pigmentColor(k[0] * f, k[1] * f, k[2] * f, k[3] * f);
-    const density = Math.min(1, (k[0] + k[1] + k[2]) / s.wet / 0.06);
+    const rgb = pigmentColor(k0 * f, k1 * f, k2 * f, k3 * f);
+    const density = Math.min(1, (k0 + k1 + k2) / s.wet / 0.06);
     return { rgb, contact: s.wet / s.weight * density };
   }
   deposit(rect, cov, dep, paint, _pigment, field = null) {