[DRAFT] Quiver edits

.github/actions/setup-workspace/action.yml

@@ -1,17 +1,12 @@
 name: 'Setup Workspace'
 description: 'Setup Node.js, install dependencies, and download build artifacts'
 
-inputs:
-  node-version:
-    description: 'Node.js version to use'
-    default: '18'
-
 runs:
   using: 'composite'
   steps:
     - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
       with:
-        node-version: ${{ inputs.node-version }}
+        node-version-file: '.nvmrc'
         cache: 'npm'
 
     - name: Install dependencies

.github/workflows/ci.yml

@@ -14,9 +14,6 @@ concurrency:
   group: ci-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
-env:
-  NODE_VERSION: '18'
-
 jobs:
   detect-changes:
     runs-on: ubuntu-latest
@@ -60,7 +57,7 @@ jobs:
 
       - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version-file: '.nvmrc'
           cache: 'npm'
 
       - name: Install dependencies
@@ -270,7 +267,7 @@ jobs:
           chrome-version: 'stable'
 
       - name: Run noCI tests
-        uses: coactions/setup-xvfb@b6b4fcfb9f5a895edadc3bc76318fae0ac17c8b3 # v1
+        uses: ./.github/actions/run-xvfb
         with:
           run: ./tasks/noci_test.sh jasmine
 
@@ -579,6 +576,26 @@ jobs:
       - name: Run syntax tests on source files
         run: .github/scripts/test.sh source-syntax
 
+  typecheck:
+    needs: install-and-cibuild
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: ./.github/actions/setup-workspace
+
+      - name: Type-check TypeScript sources
+        run: npm run typecheck
+
+  generated-types-drift:
+    needs: install-and-cibuild
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: ./.github/actions/setup-workspace
+
+      - name: Verify generated types are in sync with schema
+        run: npm run schema-typegen-diff-check
+
   # ============================================================
   # Standalone jobs (no dependencies on install-and-cibuild)
   # ============================================================
@@ -593,7 +610,7 @@ jobs:
 
       - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version-file: '.nvmrc'
           cache: 'npm'
 
       - name: Set up build environment
@@ -624,7 +641,7 @@ jobs:
 
       - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version-file: '.nvmrc'
           cache: 'npm'
 
       - name: Set up build environment

.github/workflows/publish-dist.yml

@@ -25,7 +25,7 @@ jobs:
 
       - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
         with:
-          node-version: '22.14.0'
+          node-version-file: '.nvmrc'
           cache: 'npm'
 
       - name: Set up build environment

.gitignore

@@ -7,6 +7,9 @@ build/*
 dist/*.LICENSE.txt
 dist/*.css
 
+# Ignore local dev mocks/baselines
+test/image/**/dev_*.*
+
 npm-debug.log*
 *.sublime*
 *~
@@ -16,3 +19,4 @@ tags
 !.github/
 !.gitignore
 !.npmignore
+!.nvmrc

.nvmrc

@@ -0,0 +1 @@
+22.23.0

CONTRIBUTING.md

@@ -78,7 +78,7 @@ We use the following [labels](https://github.com/plotly/plotly.js/labels) to tra
 #### Prerequisites
 
 - git
-- [node.js](https://nodejs.org/en/). We recommend using node.js v18.x.
+- [node.js](https://nodejs.org/en/). We recommend using node.js v22.x.
   Upgrading and managing node versions can be easily done using
   [`nvm`](https://github.com/nvm-sh/nvm) or its Windows alternatives.
 - [`npm`](https://www.npmjs.com/) v10.x and up to ensure that the

CUSTOM_BUNDLE.md

@@ -5,8 +5,9 @@ Make sure you have the versions of node/npm that's recommended:
 - plotly.js before 2.5: Node 12/npm 6
 - plotly.js from 2.5: Node 16/npm 8
 - plotly.js from 2.35: Node 18/npm 10
+- plotly.js from 4.0: Node 22/npm 10
 
-To download a specific node version look [here](https://nodejs.org/en/download/package-manager).
+To download a specific node version look [here](https://nodejs.org/en/download).
 
 Note: For CI, it's faster to do `git clone --depth 1` to only get one commit.
 

draftlogs/7536_change.md

@@ -0,0 +1,5 @@
+- **Breaking**: Switch color processing library from [TinyColor](https://github.com/bgrins/TinyColor) to [color](https://github.com/Qix-/color) [[#7536](https://github.com/plotly/plotly.js/pull/7536)]
+  - `rgb()`/`rgba()` strings with decimal 0–1 fractions are no longer supported
+  - `hsv()` color strings are no longer permitted
+  - Color calculations may differ slightly (by a few RGB units)
+  - New color formats are now supported: '#ff0000aa', '#f00a', 'rgb(255 0 0)', 'rgba(255 0 0 / 0.5)', 'hsl(0 100% 50% / 0.5)', 'hsla(0, 100%, 50%, 0.5)', 'hwb(0, 0%, 0%)' 

draftlogs/7684_change.md

@@ -0,0 +1 @@
+ - Set default layout.axis.tickmode to 'sync' when axis is overlaying [[#7684](https://github.com/plotly/plotly.js/pull/7684)]

draftlogs/7710_add.md

@@ -0,0 +1 @@
+- Add `quiver` trace type to visualize vector fields using arrows [[#7710](https://github.com/plotly/plotly.js/pull/7710)]

draftlogs/7812_remove.md

@@ -0,0 +1 @@
+- Remove config attributes `showLink`, `linkText`, `sendData`, `showSources`, and `showEditInChartStudio`, as well as trace attribute `stream`, since all of these were associated with Chart Studio and are no longer needed [[#7812](https://github.com/plotly/plotly.js/pull/7812)]

draftlogs/7825_change.md

@@ -0,0 +1 @@
+- Enable scattermap icons to render in color, upgrade Maki icons version to 8.2, and standardize scattermap legend icons to circles [[#7825](https://github.com/plotly/plotly.js/pull/7825)]

draftlogs/7828_change.md

@@ -0,0 +1 @@
+- Use plot title as default filename for "Download plot" button [[#7828](https://github.com/plotly/plotly.js/pull/7828)]

draftlogs/7829_change.md

@@ -0,0 +1 @@
+- Change signature of `plots.graphJson()` function to remove `mode` argument [[#7829](https://github.com/plotly/plotly.js/pull/7829)]

draftlogs/7829_remove.md

@@ -0,0 +1 @@
+- Remove all `*src` attributes, as well as `layout.hidesources` attribute, from the schema [[#7829](https://github.com/plotly/plotly.js/pull/7829)]

draftlogs/7834_remove.md

@@ -0,0 +1 @@
+- Remove internal `trace._fullInput` property and other dead code related to the removed `transforms` feature. No user-facing changes expected [[#7834](https://github.com/plotly/plotly.js/pull/7834)]

draftlogs/7843_change.md

@@ -0,0 +1 @@
+- Change `splom.axis.matches` default from `false` to `true` [[#7843](https://github.com/plotly/plotly.js/pull/7843)]

draftlogs/7845_add.md

@@ -0,0 +1 @@
+- Use dashed markers in legend for shape traces with dash configured [[#7845](https://github.com/plotly/plotly.js/pull/7845)]

draftlogs/7856_add.md

@@ -0,0 +1 @@
+- Replace `country-regex` with `country-iso-search` to search for country names in choropleth, scattergeo traces [[#7856](https://github.com/plotly/plotly.js/pull/7856)]

draftlogs/7861_change.md

@@ -0,0 +1 @@
+- Update minimum required Node version to 22 [[#7861](https://github.com/plotly/plotly.js/pull/7861)]

lib/index-strict.js

@@ -52,6 +52,7 @@ Plotly.register([
     require('../src/traces/scatterpolargl/strict'),
     require('./barpolar'),
     require('./scattersmith'),
+    require('./quiver'),
 
     // components
     require('./calendars'),

lib/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * TypeScript type definitions for plotly.js.
+ *
+ * Public API surface for consumers installing plotly.js as a dependency.
+ *
+ * Usage:
+ *
+ *     import Plotly from 'plotly.js';
+ *     // or
+ *     import * as Plotly from 'plotly.js';
+ *     // or
+ *     import { newPlot, Layout, Data } from 'plotly.js';
+ *
+ *     const data: Data[] = [{ type: 'scatter', x: [1, 2, 3], y: [4, 5, 6] }];
+ *     const layout: Partial<Layout> = { title: { text: 'Demo' } };
+ *     await Plotly.newPlot(div, data, layout);
+ *
+ * Internal types (FullLayout, GraphDiv internals, the AttrsToType machinery,
+ * etc.) live alongside the source under src/types/ but are intentionally not
+ * re-exported from this entry point.
+ */
+
+export as namespace Plotly;
+
+// ---------------------------------------------------------------------------
+// Primitives & utility types
+// ---------------------------------------------------------------------------
+
+export type {
+    Color,
+    ColorScale,
+    Datum,
+    DTickValue,
+    ErrorBar,
+    ErrorOptions,
+    MarkerSymbol,
+    TypedArray,
+    XAnchor,
+    YAnchor
+} from '../src/types/lib/common';
+
+// ---------------------------------------------------------------------------
+// Schema-generated types (traces, layout, shared interfaces)
+// ---------------------------------------------------------------------------
+
+export type * from '../src/types/generated/schema';
+
+// ---------------------------------------------------------------------------
+// Hand-written layout types (not in schema)
+// ---------------------------------------------------------------------------
+
+export type {
+    AxisName,
+    ButtonClickEvent,
+    Icon,
+    Mapbox,
+    ModeBarButton,
+    ModeBarButtonAny,
+    ModeBarDefaultButtons,
+    Template,
+    XAxisName,
+    YAxisName
+} from '../src/types/core/layout';
+
+// ---------------------------------------------------------------------------
+// Trace data
+// ---------------------------------------------------------------------------
+
+export type { Data } from '../src/types/core/data';
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+export type {
+    Config,
+    DownloadImgopts,
+    ToImageButtonOptions,
+    ToImgopts
+} from '../src/types/core/config';
+
+// ---------------------------------------------------------------------------
+// Events & runtime DOM types
+// ---------------------------------------------------------------------------
+
+export type {
+    BeforePlotEvent,
+    ClickAnnotationEvent,
+    FrameAnimationEvent,
+    LegendClickEvent,
+    PlotCoordinate,
+    PlotDatum,
+    PlotHoverEvent,
+    PlotlyEventName,
+    PlotlyHTMLElement,
+    PlotMouseEvent,
+    PlotRelayoutEvent,
+    PlotRestyleEvent,
+    PlotRestyleEventUpdate,
+    PlotScatterDataPoint,
+    PlotScene,
+    PlotSelectedData,
+    PlotSelectionEvent,
+    SelectionRange,
+    SliderChangeEvent,
+    SliderEndEvent,
+    SliderStartEvent,
+    SunburstClickEvent,
+    SunburstPlotDatum
+} from '../src/types/core/events';
+
+// ---------------------------------------------------------------------------
+// Public API functions
+// ---------------------------------------------------------------------------
+
+export {
+    addFrames,
+    addTraces,
+    animate,
+    deleteFrames,
+    deleteTraces,
+    downloadImage,
+    extendTraces,
+    Icons,
+    makeTemplate,
+    moveTraces,
+    newPlot,
+    Plots,
+    prependTraces,
+    purge,
+    react,
+    redraw,
+    register,
+    relayout,
+    restyle,
+    setPlotConfig,
+    toImage,
+    update,
+    validate,
+    validateTemplate
+} from '../src/types/core/api';
+
+export type {
+    DefaultIcons,
+    IconsMap,
+    PlotlyDataLayoutConfig,
+    PlotlyModule,
+    Root,
+    RootOrData,
+    StaticPlots,
+    TemplateFigure,
+    ValidateResult,
+    ValidateTemplateResult
+} from '../src/types/core/api';
+
+// ---------------------------------------------------------------------------
+// Default export — matches the runtime CommonJS shape
+// ---------------------------------------------------------------------------
+
+import * as PlotlyAPI from '../src/types/core/api';
+declare const Plotly: typeof PlotlyAPI;
+export default Plotly;

lib/index.js

@@ -52,6 +52,7 @@ Plotly.register([
     require('./scatterpolargl'),
     require('./barpolar'),
     require('./scattersmith'),
+    require('./quiver'),
 
     // components
     require('./calendars'),

lib/locales/cs.js

@@ -32,9 +32,9 @@ module.exports = {
         'Reset view': 'Obnovit nastavení pohledu',                                                               // components/modebar/buttons.js:583
         'Reset views': 'Obnovit nastavení pohledů',                                                            // components/modebar/buttons.js:529
         'Show closest data on hover': 'Zobrazit najbližší hodnotu při najetí myší',                                // components/modebar/buttons.js:157
-        'Snapshot succeeded': 'Snímek vytvořen',                                                       // components/modebar/buttons.js:66
-        'Sorry, there was a problem downloading your snapshot!': 'Omlouváme se, ale došlo k chybě stahování snímku!', // components/modebar/buttons.js:69
-        'Taking snapshot - this may take a few seconds': 'Vytváří se snímek - může zabrat pár vteřin', // components/modebar/buttons.js:57
+        'Image download succeeded': 'Stažení obrázku proběhlo úspěšně',                                                       // components/modebar/buttons.js:66
+        'Sorry, there was a problem downloading your image!': 'Omlouváme se, ale došlo k chybě při stahování obrázku!', // components/modebar/buttons.js:69
+        'Preparing image - this may take a few seconds': 'Připravuje se obrázek - může zabrat pár vteřin', // components/modebar/buttons.js:57
         'Zoom': 'Zvětšení',                                                                                     // components/modebar/buttons.js:85
         'Zoom in': 'Zvětšit',                                                                          // components/modebar/buttons.js:121
         'Zoom out': 'Zmenšit',                                                                         // components/modebar/buttons.js:130

lib/locales/cy.js

@@ -32,9 +32,9 @@ module.exports = {
         'Reset view': 'Ailosodwch y golwg', // components / modebar / buttons.js: 592
         'Reset views': 'Ailosod olygfeydd', // components / modebar / buttons.js: 540
         'Show closest data on hover': 'Dangos y data agosaf wrth hofran', // components / modebar / buttons.js: 168
-        'Snapshot succeeded': 'Llwyddodd y Ciplun', // components / modebar / buttons.js: 77
-        'Sorry, there was a problem downloading your snapshot!': 'Mae\'n ddrwg gennym, roedd problem wrth lawrlwytho eich ciplun!', // components / modebar / buttons.js: 80
-        'Taking snapshot - this may take a few seconds': 'Tynnu ciplun - gallai hyn gymryd ychydig o eiliadau', // components / modebar / buttons.js: 62
+        'Image download succeeded': 'Llwyddwyd i lawrlwytho\'r ddelwedd', // components / modebar / buttons.js: 77
+        'Sorry, there was a problem downloading your image!': 'Mae\'n ddrwg gennym, roedd problem wrth lawrlwytho eich delwedd!', // components / modebar / buttons.js: 80
+        'Preparing image - this may take a few seconds': 'Paratoi\'r ddelwedd - gallai hyn gymryd ychydig o eiliadau', // components / modebar / buttons.js: 62
         'Toggle Spike Lines': 'Toglo llinellau pigog', // components / modebar / buttons.js: 559
         'Toggle show closest data on hover': 'Toglo dangos y data agosaf wrth hofran', // components / modebar / buttons.js: 364
         'Turntable rotation': 'Cylchdroi trofwrdd', // components / modebar / buttons.js: 296

lib/locales/de.js

@@ -31,9 +31,9 @@ module.exports = {
         'Reset view': 'Ansicht zurücksetzen',                                                               // components/modebar/buttons.js:583
         'Reset views': 'Ansichten zurücksetzen',                                                            // components/modebar/buttons.js:529
         'Show closest data on hover': 'Zeige näheste Daten beim Überfahren',                                // components/modebar/buttons.js:157
-        'Snapshot succeeded': 'Snapshot erfolgreich',                                                       // components/modebar/buttons.js:66
-        'Sorry, there was a problem downloading your snapshot!': 'Es gab ein Problem beim Herunterladen des Snapshots', // components/modebar/buttons.js:69
-        'Taking snapshot - this may take a few seconds': 'Erstelle einen Snapshot - dies kann einige Sekunden dauern', // components/modebar/buttons.js:57
+        'Image download succeeded': 'Bild-Download erfolgreich',                                                       // components/modebar/buttons.js:66
+        'Sorry, there was a problem downloading your image!': 'Es gab ein Problem beim Herunterladen des Bildes', // components/modebar/buttons.js:69
+        'Preparing image - this may take a few seconds': 'Bild wird vorbereitet - dies kann einige Sekunden dauern', // components/modebar/buttons.js:57
         'Zoom': 'Zoom',                                                                                     // components/modebar/buttons.js:85
         'Zoom in': 'Hineinzoomen',                                                                          // components/modebar/buttons.js:121
         'Zoom out': 'Herauszoomen',                                                                         // components/modebar/buttons.js:130