@pixerate/editor 0.166.0 → 0.168.0

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   exportDocx,
   exportDocxBlob,
   stripInvalidXmlChars
-} from "./chunk-NQQDGGXY.js";
+} from "./chunk-FKYGM35R.js";
 import {
   deflateRaw,
   writeZip
@@ -165,7 +165,7 @@ import {
   updateImageSrc,
   validateFindPattern,
   writeRichClipboard
-} from "./chunk-VB2CY6EG.js";
+} from "./chunk-T62BRXMS.js";
 import {
   DEFAULT_STYLES,
   NORMAL_STYLE_ID,
@@ -174,7 +174,7 @@ import {
   isValidStyleId,
   safeCSSValue
 } from "./chunk-CXXKJBQZ.js";
-import "./chunk-XNU45TYA.js";
+import "./chunk-OLCHKGGO.js";
 import {
   compareDocuments,
   compareHtml,
@@ -246,11 +246,11 @@ import {
   tableNestingPluginKey,
   typeAgentText,
   unnestTables
-} from "./chunk-DFCAR7AW.js";
-import "./chunk-YUFTVNLX.js";
+} from "./chunk-ZUPP4NKM.js";
+import "./chunk-N3ACT6VJ.js";
 import "./chunk-KGRZMHZB.js";
-import "./chunk-ITANXMZD.js";
-import "./chunk-FR432ROA.js";
+import "./chunk-M52UCHVZ.js";
+import "./chunk-ORZF4JOO.js";
 import "./chunk-O6OGNDND.js";
 import "./chunk-6T4BV5B4.js";
 import {

package/dist/video-editor/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7;
 
-var _chunk6DM3PUQDcjs = require('../chunk-6DM3PUQD.cjs');
+var _chunkCYKWYP6Dcjs = require('../chunk-CYKWYP6D.cjs');
 
 
 
@@ -6136,7 +6136,7 @@ async function openVideoClipEffectAuthoring(controller, clip, instance, options
   const at = _chunk3OSXHLITcjs.findVideoClip.call(void 0, controller.getProject(), clip);
   if (!at) throw new Error(`There is no clip "${clip}".`);
   const doc = videoClipEffectDocument(at.clip, instance, provider.id);
-  const session = await _chunk6DM3PUQDcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
+  const session = await _chunkCYKWYP6Dcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
   return {
     clip,
     instance,

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-ZGOHKS3X.js";
+} from "../chunk-HCC2LBCW.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.166.0",
+  "version": "0.168.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -304,6 +304,16 @@
         "default": "./dist/chart/index.cjs"
       }
     },
+    "./chart-maps": {
+      "import": {
+        "types": "./dist/chart-maps/index.d.ts",
+        "default": "./dist/chart-maps/index.js"
+      },
+      "require": {
+        "types": "./dist/chart-maps/index.d.cts",
+        "default": "./dist/chart-maps/index.cjs"
+      }
+    },
     "./effects": {
       "import": {
         "types": "./dist/effects/index.d.ts",

package/skills/pixerate-chart/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pixerate-chart
-description: How to build, edit and check charts in the Pixerate chart editor through its agent tools and chart.* commands - bar, column, line, area, scatter, bubble, pie, donut, radar, waterfall, histogram, box plot, funnel, treemap (flat or grouped), sunburst, Sankey, slope, Likert (survey), parliament and bar chart race charts; series, categories, stacking, secondary axis, log axis, number formats, data labels, legend, trendline, error bars, reference lines and target bands, callouts, highlighting, footnotes, colour palettes and colour-blind checks, CSV and Mermaid import, Office chart XML export, and reading charts out of open .xlsx, .pptx and .docx files. Use when a chart editor's tools (get_chart, update_chart, set_chart_values, list_file_charts...) are available or the user asks to make, restyle, fix or explain a chart.
+description: How to build, edit and check charts in the Pixerate chart editor through its agent tools and chart.* commands - bar, column, line, area, scatter, bubble, pie, donut, radar, waterfall, histogram, box plot, funnel, treemap (flat or grouped), sunburst, Sankey, slope, Likert (survey), parliament, bar chart race and choropleth map charts; series, categories, stacking, secondary axis, log axis, number formats, data labels, legend, trendline, error bars, reference lines and target bands, callouts, highlighting, footnotes, colour palettes and colour-blind checks, CSV and Mermaid import, Office chart XML export, and reading charts out of open .xlsx, .pptx and .docx files. Use when a chart editor's tools (get_chart, update_chart, set_chart_values, list_file_charts...) are available or the user asks to make, restyle, fix or explain a chart.
 ---
 
 # Charts
@@ -24,6 +24,11 @@ and the first series their totals, so a treemap nests the groups, a sunburst dra
 rings, and any other type draws the totals. Nodes are addressed by `path`, the names from the
 top down (`["Europe", "France"]`); `get_chart` returns them as `treeTable`.
 
+A choropleth (`choropleth`) shades the regions of a map (`map`, `europe` by default) by the
+first series: each category names a region by code (ISO alpha-3 for countries, such as FRA;
+Kosovo is XKX) or by name (France). The host registers the map outlines; when no map is
+registered or no category matches, the chart draws bars and warns.
+
 A bar race (`barrace`) reads the ordinary table differently: each category is a time point
 and each series a name, and it draws the top `raceTopN` names at one moment as ranked bars.
 Which moment is shown is view state (`set_chart_race_frame`, `play_chart_race`), not part of
@@ -88,6 +93,8 @@ Charts inside a rich-text document are not edited with these tools: use `insert_
   rows of source, target, value with `import_chart_links_csv` or `set_chart_links`.
   A ranking that changes over time (sales by product per year, top cities per decade): barrace,
   with time points as categories and one series per name; keep `raceTopN` to about 10.
+  A value by country across Europe: choropleth. Call `list_chart_map_regions` for the codes,
+  load one row per country with `set_chart_data`, and keep to about five classes.
   Seats or votes per group with a majority: parliament (`parliamentMajority`,
   `parliamentArc`, `parliamentLabel`).
 - **Bars start at zero.** Bar length encodes the value, so never set a non-zero `min` on the
@@ -150,6 +157,7 @@ Charts inside a rich-text document are not edited with these tools: use `insert_
 | `recommend_chart` | Ranked chart types with a reason each, from `csv` when given, else the current data (series count, points, dates, negative values). Use before choosing a type. |
 | `get_chart_trendline` | Read a trendline's fit (`series`, `index`): coefficients, R2, equation and point count, or the moving-average points. Fails when the fit needs more or positive values. |
 | `get_chart_race_ranking` | Read who leads a bar race at a moment (`time`: a category label or index, fractional between time points; default the moment shown): the top `raceTopN` with rank, series id and value. Read-only; use it to describe the race instead of rendering frames. |
+| `list_chart_map_regions` | List the registered maps and the regions of one (default the chart's map) with the ids and names categories may use, plus which of the chart's categories matched a region and which did not. Call it before loading map data and after, to fix unmatched labels. |
 | `list_chart_presets` | List the quick layouts (`standard`, `minimal`, `labelled`, `legend-right`, `presentation`, `analysis`) and colour schemes (such as `default`, `okabe-ito`, `office`, monochrome) with what each changes. |
 | `export_chart_mermaid` | Get the chart as Mermaid for Markdown or chat: `xychart-beta`, `pie` or `radar-beta`, `sankey-beta` for Sankey diagrams with flows (title in frontmatter), `treemap-beta` for treemaps and sunbursts with their levels. With `meta` (default true) a `%% @pixerate` comment keeps everything Mermaid cannot express so `import_chart_mermaid` restores it exactly. |
 | `export_chart_ooxml` | Get a DrawingML `c:chartSpace` part for Word or PowerPoint, plus sentences for anything that could not be written. |
@@ -164,7 +172,7 @@ it changed.
 
 | Tool | Use it to |
 | --- | --- |
-| `update_chart` | Change presentation in one all-or-nothing call: `type`, `title`, `subtitle`, `xAxis` / `yAxis` / `yAxis2` (show, title, min, max, step, gridlines, format, kind `"date"`, scale `"log"`, logBase, reverse), `legend` (show, position top / bottom / left / right), `stacking` (none / stacked / percent), `orientation`, `curve`, `points`, `dataLabels`, `labelPosition`, `palette`, `innerRadius` (donut hole, 0-0.9), `gapWidth`, `overlap`, `bins`, `showTotal`, `radarTicks` (radar ring count 1-50, null for round numbers), `radarGraticule` (radar rings as `polygon` or `circle`), `note` (footnote, "" for none), `highlight` (whole list of names), `referenceLines` / `referenceBands` (whole lists; prefer the add tools), `varyColors` (one colour per category on a one-series chart), `likertNeutral` (`split` / `separate`), `likertSort` (`none` / `positive` / `negative`), `parliamentArc` (90-360 degrees), `parliamentMajority` (seats, null for half plus one), `parliamentLabel` (caption under the total), `sunburstLabel` (caption under a sunburst's total), `sankeyLinkColor` (`source` / `target` / `gray`), `sankeyNodes` (node stacking order), `raceTopN` (bars per moment, 1-30). Invalid values change nothing and come back as sentences. Returns the spec. |
+| `update_chart` | Change presentation in one all-or-nothing call: `type`, `title`, `subtitle`, `xAxis` / `yAxis` / `yAxis2` (show, title, min, max, step, gridlines, format, kind `"date"`, scale `"log"`, logBase, reverse), `legend` (show, position top / bottom / left / right), `stacking` (none / stacked / percent), `orientation`, `curve`, `points`, `dataLabels`, `labelPosition`, `palette`, `innerRadius` (donut hole, 0-0.9), `gapWidth`, `overlap`, `bins`, `showTotal`, `radarTicks` (radar ring count 1-50, null for round numbers), `radarGraticule` (radar rings as `polygon` or `circle`), `note` (footnote, "" for none), `highlight` (whole list of names), `referenceLines` / `referenceBands` (whole lists; prefer the add tools), `varyColors` (one colour per category on a one-series chart), `likertNeutral` (`split` / `separate`), `likertSort` (`none` / `positive` / `negative`), `parliamentArc` (90-360 degrees), `parliamentMajority` (seats, null for half plus one), `parliamentLabel` (caption under the total), `sunburstLabel` (caption under a sunburst's total), `sankeyLinkColor` (`source` / `target` / `gray`), `sankeyNodes` (node stacking order), `raceTopN` (bars per moment, 1-30), `map` (registered map id), `mapSteps` (2-9 equal colour classes), `mapThresholds` (ascending class breaks instead). Invalid values change nothing and come back as sentences. Returns the spec. |
 | `set_chart_data` | Replace `categories` and / or all `series` (each with `name`, `values` and optional settings). Values are padded with gaps to the categories. Use for whole tables and for re-sorting. Returns the table and series ids. |
 | `set_chart_values` | Set individual `cells` (`series`, `category`, `value`) all-or-nothing. Values may be numbers, numeric text (`"1,200"`, `"12%"`, `"$40"`, `"(3)"`) or `null` for a gap. Returns the stored values. Acted out with a cursor when the host has a director. |
 | `add_chart_series` | Add a series (`name` required; `values`, `color`, `type` for a combo, `axis: "secondary"`, `x` / `sizes` for scatter and bubble, marker, format, error bars, `id`, `at`). Selects it and returns its id. |
@@ -259,6 +267,7 @@ several charts may register them with another prefix.
 | `chart.addLink` | Add a flow; returns its index. |
 | `chart.updateLink` | Change a flow by index. |
 | `chart.removeLink` | Delete a flow by index. |
+| `chart.mapRegions` | List a map's regions and the unmatched categories (as `list_chart_map_regions`). |
 | `chart.raceRanking` | Read a bar race ranking (as `get_chart_race_ranking`). |
 | `chart.setRaceFrame` | Show a bar race moment. |
 | `chart.playRace` | Play the bar race. |
@@ -297,6 +306,13 @@ several charts may register them with another prefix.
   categories, `transpose_chart`) are refused, because the totals come from the tree or flows.
   Edit the nodes or flows, or replace the data (`set_chart_data`, `import_chart_csv`), which
   clears them.
+- On a choropleth, a value is a shade, not a size: use it for rates and shares (per person,
+  per cent), not raw totals, which make big countries look important. Say the unit in the
+  title. Equal classes (`mapSteps`) suit evenly spread values; set `mapThresholds` for
+  meaningful breaks (targets, round numbers) or skewed data. Regions without data are grey.
+- Microstates (Malta, Luxembourg, Andorra, Monaco, San Marino, Liechtenstein, Vatican City)
+  are drawn as markers so they can be seen and clicked.
+- Office export has no maps: it writes the values as bars and says so.
 - A bar race fills gaps with the last known value (0 before a name's first), and values and
   places ease between time points, so a name can sit between two places mid-swap. `render_chart`
   takes `time` to draw one moment. Office and Mermaid export cannot animate: they get every

package/skills/pixerate-effect-authoring/SKILL.md

@@ -21,7 +21,9 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 
 1. **Inspect first.** Run `effect_authoring_describe` to inspect the effect name, kind, source
    language (`glsl`, `svg`, or null when the effect has no source to edit), control parameter schemas, current
-   values, existing tracks, and compile issues.
+   values, existing tracks, playhead `time`, compile issues and `previewError`.
+   A session opens with its playhead at half the effect's length (where entrance-style effects and
+   transitions show), so values set on an animated control key that time unless you seek first.
 2. **Read or update source code.** If `sourceLanguage` is non-null, use `effect_authoring_get_source`
    to read the shader or script code. Use `effect_authoring_set_source` to recompile with new code
    and immediately inspect any reported syntax or compilation issues with line numbers.
@@ -38,7 +40,10 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 6. **Save presets.** When an interesting look is achieved, save it with `effect_authoring_save_preset`
    or restore known presets with `effect_authoring_apply_preset`.
 7. **Verify visually.** When `effect_authoring_view` is available, capture rendered preview frames
-   at specific times to visually confirm effect appearance.
+   at specific times to visually confirm effect appearance. When `effect_authoring_describe` reports a
+   `previewError` (typically a `vector` effect whose provider only draws it as SVG), there is no pixel
+   preview: `effect_authoring_view` is refused with that reason, but values, presets, keyframes and
+   timing still work. Judge the result from the values instead of retrying the view.
 
 ## Best practices
 
@@ -56,7 +61,7 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 
 | Tool | Description and usage |
 | --- | --- |
-| `effect_authoring_describe` | Reads the currently open effect session: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, duration, loop, and compile issues. |
+| `effect_authoring_describe` | Reads the currently open effect session: name, kind, source language, controls schema and current values, presets, animated tracks with keyframe counts, playhead `time`, duration, loop, compile issues, and `previewError` (why there is no pixel preview, or null). Call it first. |
 | `effect_authoring_get_source` | Retrieves shader or script source code and language for code-backed effects. Refused if `sourceLanguage` is null. |
 | `effect_authoring_set_source` | Recompiles the effect with new shader or script source code. Returns compiler issues with line numbers and messages. Available only when supported by the session. |
 | `effect_authoring_set_values` | Sets one or more control values at the current playhead time as a single undo step. Rejects all changes if any control name or value is invalid. |
@@ -70,11 +75,13 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 | `effect_authoring_seek` | Moves the preview playhead to a specific timeline position in milliseconds (clamped to 0..duration) and returns values at that time. |
 | `effect_authoring_undo` | Undoes the most recent edit in the authoring session. |
 | `effect_authoring_redo` | Redoes the most recently undone edit in the authoring session. |
-| `effect_authoring_view` | Captures a preview image of the effect at the current playhead or a specified timestamp. Available when preview capture is supported. |
+| `effect_authoring_view` | Captures a preview image of the effect at the current playhead or a specified timestamp. Available when preview capture is supported. Refused, with the reason, when `effect_authoring_describe` shows a `previewError`. |
 
 ## Pitfalls
 
 - Calling authoring tools when no authoring session is open returns an error explaining that a session must be opened first.
 - Animated controls calculate their values dynamically from keyframes; clearing a track reverts the parameter to static behavior.
 - Compiling invalid shader code produces issues in `effect_authoring_set_source`; inspect the line numbers and messages to correct syntax.
+- A `vector` effect may have no pixel preview (the provider refuses a pixel renderer); check `previewError` rather than reading a blank capture as a broken effect.
+- The playhead does not start at 0. Pass explicit `time`s to `effect_authoring_set_keyframe`, or `effect_authoring_seek` before setting values on an animated control.
 - Control values must match their schema types and bounds; colours must be `#rrggbb` (or `#rrggbbaa`), and numbers must fall within `[min, max]`.