numbl 0.4.3 → 0.4.4

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;

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) */
@@ -234,6 +267,19 @@ export type PlotInstruction = {
 } | {
     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 +373,9 @@ export type PlotInstruction = {
 } | {
     type: "set_grid";
     value: boolean;
+} | {
+    type: "set_box";
+    value: boolean;
 } | {
     type: "set_colorbar";
     value: string;