numbl 0.4.3 → 0.4.5

package/dist-lib/graphics/figuresReducer.d.ts

@@ -1,4 +1,4 @@
-import type { PlotTrace, Plot3Trace, SurfTrace, ImagescTrace, PcolorTrace, ContourTrace, BarTrace, Bar3Trace, ErrorBarTrace, BoxTrace, PieTrace, HeatmapTrace, QuiverTrace, Quiver3Trace, PlotInstruction } from "./types.js";
+import type { PlotTrace, Plot3Trace, PatchTrace, SurfTrace, ImagescTrace, PcolorTrace, ContourTrace, BarTrace, Bar3Trace, ErrorBarTrace, BoxTrace, PieTrace, HeatmapTrace, QuiverTrace, Quiver3Trace, PlotInstruction } from "./types.js";
 export type AxesState = {
     holdOn: boolean;
     traces: PlotTrace[];
@@ -19,6 +19,7 @@ export type AxesState = {
     quiver3Traces: Quiver3Trace[];
     areaTraces: PlotTrace[];
     areaBaseValue: number;
+    patchTraces: PatchTrace[];
     title?: string;
     xlabel?: string;
     ylabel?: string;
@@ -26,6 +27,9 @@ export type AxesState = {
     shading?: "faceted" | "flat" | "interp";
     legend?: string[];
     gridOn?: boolean;
+    /** Axes border. Undefined/true → full rectangle (numbl's default, matching
+     *  MATLAB `box on`); false → only the left and bottom axis lines (`box off`). */
+    boxOn?: boolean;
     colorbar?: boolean;
     colorbarLocation?: string;
     colormap?: string;
@@ -58,6 +62,15 @@ export type FigureState = {
     axes: {
         [index: number]: AxesState;
     };
+    /** When set, this figure is an HTML UI component (MATLAB `uihtml`): the
+     *  `html` string is rendered in an iframe instead of the axes/trace canvas.
+     *  Takes precedence over `axes`. `data` is the JSON-encoded `Data` property
+     *  (from `jsonencode`), pushed into the page's `htmlComponent`. */
+    uihtml?: {
+        id: string;
+        html: string;
+        data?: string;
+    };
 };
 export type FiguresState = {
     currentHandle: number;

package/dist-lib/graphics/types.d.ts

@@ -19,6 +19,10 @@ export interface PlotTrace {
     markerEdgeColor?: [number, number, number];
     markerFaceColor?: [number, number, number];
     markerIndices?: number[];
+    /** Stable identity for a trace returned as a graphics handle (e.g. from
+     *  `line`). Lets `set(h,'XData',...)` / `update_trace` find and mutate this
+     *  exact trace in the renderer's accumulated state across `drawnow`. */
+    id?: number;
 }
 export interface Plot3Trace {
     x: number[];
@@ -32,6 +36,35 @@ export interface Plot3Trace {
     markerEdgeColor?: [number, number, number];
     markerFaceColor?: [number, number, number];
     markerIndices?: number[];
+    /** See PlotTrace.id. */
+    id?: number;
+}
+/** A patch object: one or more colored polygons sharing a single set of
+ *  vertices. Mirrors MATLAB's Faces/Vertices model — `patch(X,Y,C)` and the
+ *  name-value forms are all canonicalized to this shape at parse time. */
+export interface PatchTrace {
+    /** Unique vertices: `vertices[k] = [x, y]` (2-D) or `[x, y, z]` (3-D). */
+    vertices: number[][];
+    /** Faces as 0-based vertex-index arrays — one polygon per face. */
+    faces: number[][];
+    /** Single RGB for all faces, a colormap keyword, or 'none'. */
+    faceColor?: [number, number, number] | "flat" | "interp" | "none";
+    /** Edge color (default black [0,0,0]). */
+    edgeColor?: [number, number, number] | "flat" | "interp" | "none";
+    /** Face transparency in [0,1]. */
+    faceAlpha?: number;
+    lineWidth?: number;
+    lineStyle?: string;
+    marker?: string;
+    markerFaceColor?: [number, number, number] | "flat" | "none";
+    /** Color data driving 'flat'/'interp': one entry per face (flat) or per
+     *  vertex (interp). Each entry is a scalar (mapped through the colormap) or
+     *  an RGB triplet. */
+    faceVertexCData?: (number | [number, number, number])[];
+    /** True when vertices carry a z-coordinate (3-D patch). */
+    is3D?: boolean;
+    /** See PlotTrace.id — lets `set(p,...)` live-update this patch. */
+    id?: number;
 }
 export interface SurfTrace {
     /** X coordinates: flat array of length rows*cols (column-major) */
@@ -228,12 +261,36 @@ export type AxisLimitSpec = [number | null, number | null] | "auto";
 export type PlotInstruction = {
     type: "set_figure_handle";
     handle: number;
+} | {
+    /** An HTML UI component (MATLAB `uihtml`): renders self-contained HTML
+     *  markup in an iframe, bypassing the axes/trace model. `html` is the
+     *  full HTMLSource string; `id` is a stable per-component key. `data`, when
+     *  present, is the `Data` property JSON-encoded (via `jsonencode`); the
+     *  renderer parses it and pushes it to the page's `htmlComponent` so the
+     *  `setup`/`"DataChanged"` bridge fires (MATLAB `h.Data` → JavaScript). */
+    type: "uihtml";
+    id: string;
+    html: string;
+    data?: string;
 } | {
     type: "plot";
     traces: PlotTrace[];
 } | {
     type: "plot3";
     traces: Plot3Trace[];
+} | {
+    type: "line";
+    traces: PlotTrace[];
+} | {
+    type: "line3";
+    traces: Plot3Trace[];
+} | {
+    type: "patch";
+    trace: PatchTrace;
+} | {
+    type: "update_trace";
+    id: number;
+    props: Record<string, unknown>;
 } | {
     type: "surf";
     trace: SurfTrace;
@@ -327,6 +384,9 @@ export type PlotInstruction = {
 } | {
     type: "set_grid";
     value: boolean;
+} | {
+    type: "set_box";
+    value: boolean;
 } | {
     type: "set_colorbar";
     value: string;