numbl 0.4.21 → 0.4.22

package/{dist-lib/graphics → dist-graphics/numbl-core/plotting}/axisLimits.d.ts

@@ -3,8 +3,8 @@
  *
  * This is the source of truth for the query form `lim = axis`: the numbl
  * runtime reduces its accumulated plot instructions into an `AxesState` and
- * asks this module for the limit vector. It is deliberately rendering-free
- * (no canvas, no DOM) so numbl-core can import it.
+ * asks this module for the limit vector. It is rendering-free (no canvas, no
+ * DOM); the renderer in src/graphics/ uses it too.
  *
  * For an axis with an explicit limit, that limit is returned verbatim (a
  * `null` bound falls back to the data-derived bound). For a fully automatic
@@ -13,11 +13,23 @@
  * what is drawn.
  */
 import type { AxesState } from "./figuresReducer.js";
+type Extent = {
+    min: number;
+    max: number;
+};
 /** Does this axes hold any 3-D content (so limits are a 6-vector)? */
 export declare function axesIs3D(axes: AxesState): boolean;
+/** Raw data extents (no padding) across every renderable trace type.
+ *  Non-finite values are ignored; an empty axis has min > max. */
+export declare function dataExtents(axes: Partial<AxesState>): {
+    x: Extent;
+    y: Extent;
+    z: Extent;
+};
 /**
  * Compute the limit vector for `lim = axis`.
  * Returns 4 elements `[xmin xmax ymin ymax]` for a 2-D view, or 6 elements
  * `[xmin xmax ymin ymax zmin zmax]` when the axes holds 3-D content.
  */
 export declare function computeAxisLimits(axes: AxesState): number[];
+export {};

package/dist-graphics/numbl-core/plotting/colormaps.d.ts

@@ -0,0 +1,10 @@
+export type RGB = [number, number, number];
+/** An axes colormap: a named map, or custom N×3 `data` (which wins). */
+export interface ColormapSpec {
+    name?: string;
+    data?: number[][];
+}
+export declare const PARULA_ANCHORS: RGB[];
+/** Color at t ∈ [0, 1] (clamped; non-finite → 0) in the given colormap.
+ *  Unknown names fall back to parula. */
+export declare function colormapLookup(t: number, cm?: ColormapSpec): RGB;

package/dist-graphics/numbl-core/plotting/imagescExtent.d.ts

@@ -0,0 +1,19 @@
+import type { ImagescTrace } from "./types.js";
+/**
+ * Pixel geometry of an imagesc trace. As in MATLAB, `x` and `y` hold the
+ * centers of the first and last columns/rows (XData/YData), so the image
+ * extends half a pixel beyond them; a single column or row is one unit wide.
+ * `dx`/`dy` may be negative (decreasing XData/YData).
+ */
+export declare function imagescExtent(t: ImagescTrace): {
+    dx: number;
+    dy: number;
+    x: [number, number];
+    y: [number, number];
+};
+/**
+ * Color limits for an imagesc trace: the axes' caxis/clim when set, else the
+ * finite data range. Values outside the limits clamp to the colormap ends.
+ * Returns null when there is no finite data and no caxis.
+ */
+export declare function imagescColorLimits(t: ImagescTrace, caxis?: [number, number]): [number, number] | null;

package/{dist-browser/graphics → dist-graphics/numbl-core/plotting}/types.d.ts

@@ -1,12 +1,12 @@
 /**
- * Shared graphics types used by both numbl-core and the rendering layer.
+ * Plot data types: the trace interfaces and `PlotInstruction`, the
+ * serializable contract between numbl-core (which emits instructions) and the
+ * renderer in src/graphics/ (which consumes them). The renderer imports these
+ * from here; numbl-core does not depend on src/graphics/.
  *
- * This file is the single source of truth for plot trace interfaces and
- * PlotInstruction.  numbl-core re-exports these types so that internal
- * runtime code can import them without reaching into src/graphics/.
- *
- * The numbl-vscode extension syncs this file (and the rest of src/graphics/)
- * via devel/sync-graphics.sh.
+ * The numbl-vscode extension syncs src/graphics/ via devel/sync-graphics.sh;
+ * it also needs the core modules the renderer imports (types, figuresReducer,
+ * axisLimits, imagescExtent, colormaps).
  */
 export interface PlotTrace {
     x: number[];
@@ -53,6 +53,8 @@ export interface PatchTrace {
     edgeColor?: [number, number, number] | "flat" | "interp" | "none";
     /** Face transparency in [0,1]. */
     faceAlpha?: number;
+    /** Edge transparency in [0,1]. */
+    edgeAlpha?: number;
     lineWidth?: number;
     lineStyle?: string;
     marker?: string;

package/dist-lib/browser/mip.d.ts

@@ -0,0 +1,17 @@
+export declare const MIP_SYSTEM_PREFIX = "/system/mip/packages/gh/mip-org/core/mip/";
+/** Directory that must be on the search path for `mip` to resolve. */
+export declare const MIP_SEARCH_PATH: string;
+/** Present iff mip core is installed in the VFS. */
+export declare const MIP_MARKER_PATH: string;
+/**
+ * Route GitHub release-asset URLs through the CORS proxy (GitHub sends no
+ * CORS headers on them); other URLs pass through. The cachebust matters:
+ * release tags such as mip-numbl are mutable, and without it the browser or
+ * proxy serves a stale .mhl for hours.
+ */
+export declare function corsProxiedUrl(url: string): string;
+export interface MipCoreFile {
+    path: string;
+    content: Uint8Array;
+}
+export declare function fetchMipCoreFiles(): Promise<MipCoreFile[]>;

package/dist-lib/cli-scan.d.ts

@@ -1,6 +1,13 @@
 /**
- * Shared utility for scanning directories for .m/.numbl.js/.wasm workspace files.
+ * Shared utilities for scanning directories for .m/.numbl.js/.wasm workspace
+ * files and for discovering .m test scripts.
  * Extracted from cli.ts to avoid circular imports (cli-fileio → cli → main()).
  */
 import type { WorkspaceFile } from "./numbl-core/workspace/types.js";
 export declare function scanMFiles(dirPath: string, excludeFile?: string): WorkspaceFile[];
+/**
+ * Find integration test scripts under `dir`: `.m` files containing "SUCCESS",
+ * in sorted depth-first order. Skips class (`@`), package (`+`) and `wasm`
+ * directories. Shared by `numbl run-tests`, the vitest wrapper and scripts/.
+ */
+export declare function findTestScripts(dir: string): string[];

package/dist-lib/lib.d.ts

@@ -17,7 +17,7 @@ export { BrowserFileIOAdapter } from "./vfs/BrowserFileIOAdapter.js";
 export { BrowserSystemAdapter } from "./vfs/BrowserSystemAdapter.js";
 export type { UihtmlSession } from "./numbl-core/executeCode.js";
 export type { WorkspaceFile, NativeBridge, } from "./numbl-core/workspace/index.js";
-export type { PlotInstruction } from "./graphics/types.js";
+export type { PlotInstruction } from "./numbl-core/plotting/types.js";
 export type { RuntimeValue, RuntimeTensor, RuntimeString, RuntimeLogical, RuntimeCell, RuntimeStruct, RuntimeFunction, RuntimeDictionary, } from "./numbl-core/runtime/index.js";
 export { RuntimeError } from "./numbl-core/runtime/index.js";
 export { RTV } from "./numbl-core/runtime/constructors.js";