@marimo-team/islands 0.19.10-dev5 → 0.19.10-dev51

package/src/plugins/impl/plotly/Plot.tsx

@@ -0,0 +1,173 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import type * as PlotlyTypes from "plotly.js";
+// Import the pre-built dist bundle, not the source entry point.
+// The source entry point requires Node.js polyfills (e.g. `buffer/`)
+// that are unavailable in the browser/bundler environment.
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-expect-error — no type declarations for dist path, we use PlotlyTypes above
+import Plotly from "plotly.js/dist/plotly";
+import { useEffect, useRef } from "react";
+
+// Plotly attaches `on` and `removeListener` to the DOM element at runtime.
+// The @types/plotly.js PlotlyHTMLElement type includes `on` and `removeAllListeners`
+// but not the per-handler `removeListener`. We extend the type to include it.
+interface PlotlyElement extends PlotlyTypes.PlotlyHTMLElement {
+  removeListener(event: string, handler: (...args: never[]) => void): void;
+}
+
+export interface Figure {
+  data: PlotlyTypes.Data[];
+  layout: Partial<PlotlyTypes.Layout>;
+  frames: PlotlyTypes.Frame[] | null;
+}
+
+export interface PlotProps {
+  data: PlotlyTypes.Data[];
+  layout: Partial<PlotlyTypes.Layout>;
+  frames?: PlotlyTypes.Frame[];
+  config?: Partial<PlotlyTypes.Config>;
+  className?: string;
+  style?: React.CSSProperties;
+  useResizeHandler?: boolean;
+  divId?: string;
+  onRelayout?: (event: PlotlyTypes.PlotRelayoutEvent) => void;
+  onRelayouting?: (event: PlotlyTypes.PlotRelayoutEvent) => void;
+  onSelected?: (event: PlotlyTypes.PlotSelectionEvent) => void;
+  onDeselect?: () => void;
+  onClick?: (event: PlotlyTypes.PlotMouseEvent) => void;
+  onSunburstClick?: (event: PlotlyTypes.PlotMouseEvent) => void;
+  onTreemapClick?: (event: PlotlyTypes.PlotMouseEvent) => void;
+  onError?: (err: Error) => void;
+}
+
+// Plotly event name convention:
+//   - events are attached as `'plotly_' + name.toLowerCase()`
+//   - react props are `'on' + name`
+const EVENT_NAMES = [
+  "Relayout",
+  "Relayouting",
+  "Selected",
+  "Deselect",
+  "Click",
+  "SunburstClick",
+  "TreemapClick",
+] as const;
+
+type EventName = (typeof EVENT_NAMES)[number];
+
+function propName(event: EventName): keyof PlotProps {
+  return `on${event}` as keyof PlotProps;
+}
+
+function plotlyEventName(event: EventName): string {
+  return `plotly_${event.toLowerCase()}`;
+}
+
+export const Plot = (props: PlotProps) => {
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  const {
+    data,
+    layout,
+    config,
+    frames,
+    className,
+    style,
+    useResizeHandler,
+    divId,
+    onError,
+  } = props;
+
+  // Render / update the plot
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) {
+      return;
+    }
+
+    Plotly.react(el, data, layout, config)
+      .then(() => {
+        if (frames && frames.length > 0) {
+          return Plotly.addFrames(el as unknown as PlotlyTypes.Root, frames);
+        }
+      })
+      .catch((error: Error) => {
+        onError?.(error);
+      });
+  }, [data, layout, config, frames, onError]);
+
+  // Sync event handlers
+  useEffect(
+    () => {
+      const el = containerRef.current;
+      if (!el) {
+        return;
+      }
+
+      const plotlyEl = el as unknown as PlotlyElement;
+
+      // eslint-disable-next-line @typescript-eslint/ban-types -- Plotly's event API uses generic function references
+      const attached: {
+        plotlyName: string;
+        handler: (...args: never[]) => void;
+      }[] = [];
+
+      for (const name of EVENT_NAMES) {
+        const handler = props[propName(name)];
+        if (typeof handler === "function") {
+          const plotlyName = plotlyEventName(name);
+          plotlyEl.on(plotlyName as never, handler as never);
+          attached.push({
+            plotlyName,
+            handler: handler as (...args: never[]) => void,
+          });
+        }
+      }
+
+      return () => {
+        for (const { plotlyName, handler } of attached) {
+          plotlyEl.removeListener(plotlyName, handler as never);
+        }
+      };
+      // Re-sync whenever any event handler prop changes
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+    },
+    EVENT_NAMES.map((name) => props[propName(name)]),
+  );
+
+  // Window resize handler
+  useEffect(() => {
+    if (!useResizeHandler) {
+      return;
+    }
+
+    const el = containerRef.current;
+    if (!el) {
+      return;
+    }
+
+    const handler = () => {
+      Plotly.Plots.resize(el as unknown as PlotlyTypes.Root);
+    };
+
+    window.addEventListener("resize", handler);
+    return () => {
+      window.removeEventListener("resize", handler);
+    };
+  }, [useResizeHandler]);
+
+  // Cleanup on unmount
+  useEffect(() => {
+    const el = containerRef.current;
+    return () => {
+      if (el) {
+        Plotly.purge(el as unknown as PlotlyTypes.Root);
+      }
+    };
+  }, []);
+
+  return (
+    <div id={divId} className={className} style={style} ref={containerRef} />
+  );
+};

package/src/plugins/impl/plotly/PlotlyPlugin.tsx

@@ -1,9 +1,10 @@
 /* Copyright 2026 Marimo. All rights reserved. */
 
-import type { Figure, PlotParams } from "react-plotly.js";
+import type * as Plotly from "plotly.js";
 import { z } from "zod";
 import type { IPlugin, IPluginProps, Setter } from "@/plugins/types";
 import { Logger } from "@/utils/Logger";
+import type { Figure } from "./Plot";
 
 import "./plotly.css";
 import "./mapbox.css";
@@ -70,13 +71,8 @@ interface PlotlyPluginProps extends Data {
   host: HTMLElement;
 }
 
-// For whatever reason, the version of vite-rolldown that we are one is not exporting this default export correctly.
-export const LazyPlot = lazy(() =>
-  import("react-plotly.js").then((module) => {
-    return module.default as unknown as {
-      default: React.ComponentType<PlotParams>;
-    };
-  }),
+const LazyPlot = lazy(() =>
+  import("./Plot").then((mod) => ({ default: mod.Plot })),
 );
 
 const SUNBURST_DATA_KEYS: (keyof Plotly.SunburstPlotDatum)[] = [
@@ -176,7 +172,6 @@ export const PlotlyComponent = memo(
             };
           });
         })}
-        // @ts-expect-error We patched this prop here so it doesn't exist in the types
         onTreemapClick={useEvent((evt: Readonly<Plotly.PlotMouseEvent>) => {
           if (!evt) {
             return;
@@ -198,6 +193,24 @@ export const PlotlyComponent = memo(
           }));
         })}
         config={plotlyConfig}
+        onClick={useEvent((evt: Readonly<Plotly.PlotMouseEvent>) => {
+          if (!evt) {
+            return;
+          }
+          // Only handle clicks for chart types where box/lasso selection
+          // (onSelected) doesn't work, such as heatmaps.
+          const isHeatmap = evt.points.some(
+            (point) => point.data?.type === "heatmap",
+          );
+          if (!isHeatmap) {
+            return;
+          }
+          setValue((prev) => ({
+            ...prev,
+            points: extractPoints(evt.points),
+            indices: evt.points.map((point) => point.pointIndex),
+          }));
+        })}
         onSelected={useEvent((evt: Readonly<Plotly.PlotSelectionEvent>) => {
           if (!evt) {
             return;
@@ -215,7 +228,7 @@ export const PlotlyComponent = memo(
         className="w-full"
         useResizeHandler={true}
         frames={figure.frames ?? undefined}
-        onError={useEvent((err) => {
+        onError={useEvent((err: Error) => {
           Logger.error("PlotlyPlugin: ", err);
         })}
       />
@@ -229,6 +242,17 @@ PlotlyComponent.displayName = "PlotlyComponent";
  * instead of the ones that Plotly uses internally,
  * by using the hovertemplate.
  */
+const STANDARD_POINT_KEYS: string[] = [
+  "x",
+  "y",
+  "z",
+  "lat",
+  "lon",
+  "curveNumber",
+  "pointNumber",
+  "pointIndex",
+];
+
 function extractPoints(
   points: Plotly.PlotDatum[],
 ): Record<AxisName, AxisDatum>[] {
@@ -243,6 +267,13 @@ function extractPoints(
     const hovertemplate = Array.isArray(point.data.hovertemplate)
       ? point.data.hovertemplate[0]
       : point.data.hovertemplate;
+
+    // For chart types with standard point keys (e.g. heatmaps),
+    // or when there's no hovertemplate, pick keys directly from the point.
+    if (!hovertemplate || point.data?.type === "heatmap") {
+      return pick(point, STANDARD_POINT_KEYS);
+    }
+
     // Update or create a parser
     parser = parser
       ? parser.update(hovertemplate)

package/src/plugins/impl/plotly/__tests__/parse-from-template.test.ts

@@ -1,4 +1,5 @@
 /* Copyright 2026 Marimo. All rights reserved. */
+import type * as Plotly from "plotly.js";
 import { describe, expect, it } from "vitest";
 import { createParser } from "../parse-from-template";
 

package/src/plugins/impl/plotly/__tests__/usePlotlyLayout.test.ts

@@ -1,7 +1,8 @@
 /* Copyright 2026 Marimo. All rights reserved. */
 
-import type { Figure } from "react-plotly.js";
+import type * as Plotly from "plotly.js";
 import { describe, expect, it } from "vitest";
+import type { Figure } from "../Plot";
 import {
   computeLayoutOnFigureChange,
   computeLayoutUpdate,

package/src/plugins/impl/plotly/parse-from-template.ts

@@ -1,6 +1,7 @@
 /* Copyright 2026 Marimo. All rights reserved. */
 
 import { get } from "lodash-es";
+import type * as Plotly from "plotly.js";
 
 export interface PlotlyTemplateParser {
   /**

package/src/plugins/impl/plotly/usePlotlyLayout.ts

@@ -2,9 +2,10 @@
 
 import { usePrevious } from "@uidotdev/usehooks";
 import { isEqual, pick } from "lodash-es";
+import type * as Plotly from "plotly.js";
 import { useEffect, useState } from "react";
-import type { Figure } from "react-plotly.js";
 import { Objects } from "@/utils/objects";
+import type { Figure } from "./Plot";
 
 /**
  * Keys that are preserved across figure updates when set by user interaction.

package/src/theme/ThemeProvider.tsx

@@ -10,8 +10,10 @@ export const ThemeProvider: React.FC<PropsWithChildren> = memo(
     const { theme } = useTheme();
     useLayoutEffect(() => {
       document.body.classList.add(theme, `${theme}-theme`);
+      document.body.dataset.theme = theme;
       return () => {
         document.body.classList.remove(theme, `${theme}-theme`);
+        delete document.body.dataset.theme;
       };
     }, [theme]);
 

package/dist/apl-BuwKwesW.js

@@ -1,4 +0,0 @@
-import { t as apl } from "./apl-D9gTcP3Q.js";
-export {
-  apl
-};

package/dist/asciiarmor-zAEd_wtn.js

@@ -1,4 +0,0 @@
-import { t as asciiArmor } from "./asciiarmor-mLyg-Z5h.js";
-export {
-  asciiArmor
-};

package/dist/asn1-DWEA66J4.js

@@ -1,4 +0,0 @@
-import { t as asn1 } from "./asn1-AE7eHomk.js";
-export {
-  asn1
-};

package/dist/brainfuck-mIPR6Ong.js

@@ -1,4 +0,0 @@
-import { t as brainfuck } from "./brainfuck-Bdd6NcL6.js";
-export {
-  brainfuck
-};

package/dist/classDiagram-2ON5EDUG-B9pkKjjc.js

@@ -1,30 +0,0 @@
-import "./purify.es-Brw-U87Q.js";
-import "./chunk-S3R3BYOJ-CBkH6JZZ.js";
-import { r as __name } from "./src-szye8OCw.js";
-import "./chunk-ABZYJK2D-BXTC53mt.js";
-import "./chunk-HN2XXSSU-CqPwpolw.js";
-import "./chunk-CVBHYZKI-Dhc_e3rA.js";
-import "./chunk-ATLVNIR6-BJDjUR_c.js";
-import "./dist-BYznkC5E.js";
-import "./chunk-JA3XYJ7Z-BGnAIbOP.js";
-import "./chunk-JZLCHNYA-CIRgweVQ.js";
-import "./chunk-QXUST7PY-C7750n_u.js";
-import "./chunk-N4CR4FBY-DKSvXAIS.js";
-import "./chunk-FMBD7UC4-geNUIndh.js";
-import "./chunk-55IACEB6-C3BASkh4.js";
-import "./chunk-QN33PNHL-B6zC8BTi.js";
-import { i as styles_default, n as classDiagram_default, r as classRenderer_v3_unified_default, t as ClassDB } from "./chunk-B4BG7PRW-DzmUUpfH.js";
-var diagram = {
-  parser: classDiagram_default,
-  get db() {
-    return new ClassDB();
-  },
-  renderer: classRenderer_v3_unified_default,
-  styles: styles_default,
-  init: /* @__PURE__ */ __name((e) => {
-    e.class || (e.class = {}), e.class.arrowMarkerAbsolute = e.arrowMarkerAbsolute;
-  }, "init")
-};
-export {
-  diagram
-};

package/dist/classDiagram-v2-WZHVMYZB-CRhhA0tV.js

@@ -1,30 +0,0 @@
-import "./purify.es-Brw-U87Q.js";
-import "./chunk-S3R3BYOJ-CBkH6JZZ.js";
-import { r as __name } from "./src-szye8OCw.js";
-import "./chunk-ABZYJK2D-BXTC53mt.js";
-import "./chunk-HN2XXSSU-CqPwpolw.js";
-import "./chunk-CVBHYZKI-Dhc_e3rA.js";
-import "./chunk-ATLVNIR6-BJDjUR_c.js";
-import "./dist-BYznkC5E.js";
-import "./chunk-JA3XYJ7Z-BGnAIbOP.js";
-import "./chunk-JZLCHNYA-CIRgweVQ.js";
-import "./chunk-QXUST7PY-C7750n_u.js";
-import "./chunk-N4CR4FBY-DKSvXAIS.js";
-import "./chunk-FMBD7UC4-geNUIndh.js";
-import "./chunk-55IACEB6-C3BASkh4.js";
-import "./chunk-QN33PNHL-B6zC8BTi.js";
-import { i as styles_default, n as classDiagram_default, r as classRenderer_v3_unified_default, t as ClassDB } from "./chunk-B4BG7PRW-DzmUUpfH.js";
-var diagram = {
-  parser: classDiagram_default,
-  get db() {
-    return new ClassDB();
-  },
-  renderer: classRenderer_v3_unified_default,
-  styles: styles_default,
-  init: /* @__PURE__ */ __name((e) => {
-    e.class || (e.class = {}), e.class.arrowMarkerAbsolute = e.arrowMarkerAbsolute;
-  }, "init")
-};
-export {
-  diagram
-};

package/dist/clojure-DkhhNHNQ.js

@@ -1,4 +0,0 @@
-import { t as clojure } from "./clojure-zTYBCd80.js";
-export {
-  clojure
-};

package/dist/cmake-1obPvqtc.js

@@ -1,4 +0,0 @@
-import { t as cmake } from "./cmake-BnJV90fC.js";
-export {
-  cmake
-};

package/dist/cobol-oWNTiXPE.js

@@ -1,4 +0,0 @@
-import { t as cobol } from "./cobol-CH0OZO8A.js";
-export {
-  cobol
-};

package/dist/coffeescript-LtYUvf6r.js

@@ -1,4 +0,0 @@
-import { t as coffeeScript } from "./coffeescript-CLhc1U6Q.js";
-export {
-  coffeeScript
-};

package/dist/commonlisp-C_06qBYF.js

@@ -1,4 +0,0 @@
-import { t as commonLisp } from "./commonlisp-8K2-IkUD.js";
-export {
-  commonLisp
-};

package/dist/crystal-CDJkbx14.js

@@ -1,4 +0,0 @@
-import { t as crystal } from "./crystal-8to4H-ep.js";
-export {
-  crystal
-};

package/dist/css-Bi_Nk0uN.js

@@ -1,4 +0,0 @@
-import { n as mkCSS, t as gss } from "./css-BVo-JOy5.js";
-export {
-  gss
-};

package/dist/cypher-TrG0NvZ0.js

@@ -1,4 +0,0 @@
-import { t as cypher } from "./cypher-BTFaDDd_.js";
-export {
-  cypher
-};

package/dist/d-CFKOrZsi.js

@@ -1,4 +0,0 @@
-import { t as d } from "./d-c9bddW2W.js";
-export {
-  d
-};

package/dist/diff-CfnSF48q.js

@@ -1,4 +0,0 @@
-import { t as diff } from "./diff-PA28xMKg.js";
-export {
-  diff
-};

package/dist/dist-2OSzSqy2.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as yamlLanguage, t as yaml } from "./dist-MFzhAmKV.js";
-export {
-  yaml
-};

package/dist/dist-B1H2TQGB.js

@@ -1,8 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import "./dist-COp5dkis.js";
-import "./dist-BSMZYwqW.js";
-import "./dist-DsqQCNKw.js";
-import { n as phpLanguage, t as php } from "./dist--JwRU9u5.js";
-export {
-  php
-};

package/dist/dist-BNvasp6N.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as wastLanguage, t as wast } from "./dist-BKGWAN8J.js";
-export {
-  wast
-};

package/dist/dist-CFi_P6cs.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { i as defineCSSCompletionSource, n as cssCompletionSource, r as cssLanguage, t as css } from "./dist-BSMZYwqW.js";
-export {
-  css
-};

package/dist/dist-CG4LWTPv.js

@@ -1,8 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import "./dist-COp5dkis.js";
-import "./dist-BSMZYwqW.js";
-import "./dist-DsqQCNKw.js";
-import { i as jinjaLanguage, n as jinja, r as jinjaCompletionSource, t as closePercentBrace } from "./dist-BcXuIt-h.js";
-export {
-  jinja
-};

package/dist/dist-CHWVQZ6Z.js

@@ -1,6 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import "./dist-BSMZYwqW.js";
-import { n as sassCompletionSource, r as sassLanguage, t as sass } from "./dist-C6p7UKkB.js";
-export {
-  sass
-};

package/dist/dist-C_8-swED.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as rustLanguage, t as rust } from "./dist-DIVeCGlI.js";
-export {
-  rust
-};

package/dist/dist-DIhtur5b.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as jsonLanguage, t as json } from "./dist-Cpj5BHNP.js";
-export {
-  json
-};

package/dist/dist-DoQ7RS4e.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as javaLanguage, t as java } from "./dist-BbQ-5HAA.js";
-export {
-  java
-};

package/dist/dist-DsMd-F9h.js

@@ -1,5 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import { n as cppLanguage, t as cpp } from "./dist-9J8_3DZN.js";
-export {
-  cpp
-};

package/dist/dist-DurmUshd.js

@@ -1,8 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import "./dist-COp5dkis.js";
-import "./dist-BSMZYwqW.js";
-import "./dist-DsqQCNKw.js";
-import { i as liquidLanguage, n as liquid, r as liquidCompletionSource, t as closePercentBrace } from "./dist-b7Sc3Tj8.js";
-export {
-  liquid
-};

package/dist/dist-PZgrh2z6.js

@@ -1,6 +0,0 @@
-import "./dist-D7jHtwN8.js";
-import "./dist-BSMZYwqW.js";
-import { n as lessCompletionSource, r as lessLanguage, t as less } from "./dist-DA1J6LvO.js";
-export {
-  less
-};