numbl 0.4.8 → 0.4.9

package/dist-lib/numbl-core/helpers/scanFormat.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared scanning core for sscanf/fscanf: apply a MATLAB format string
+ * cyclically to input text, collecting numeric results.
+ */
+export interface ScanResult {
+    results: number[];
+    /** Number of characters consumed from the input. */
+    consumed: number;
+    matchFailure: boolean;
+}
+export declare function scanFormat(str: string, fmt: string, maxCount: number): ScanResult;

package/dist-lib/numbl-core/jit/builtins/defs/logical/fieldnames.d.ts

@@ -2,8 +2,8 @@
  * `fieldnames(s)` — returns an N×1 cell of char-array field names
  * for a struct or class instance. Matches numbl's
  * `introspection.ts:fieldnamesApply` semantics, with the result's
- * cell-element type being `char` (matches MATLAB; numbl wraps as
- * string but mtoc2 follows MATLAB by emitting chars).
+ * cell-element type being `char` (matches MATLAB and the
+ * interpreter, which also emits chars).
  *
  * Interpreter-only for now; the AOT path would need to materialize
  * a heterogeneous-len cell of chars which is a different feature

package/dist-lib/numbl-core/runtime/constructors.d.ts

@@ -2,7 +2,7 @@
  * RuntimeValue constructor helpers (the RTV namespace).
  */
 import { ItemType } from "../lowering/itemTypes.js";
-import { type RuntimeNumber, RuntimeTensor, type RuntimeString, RuntimeChar, type RuntimeLogical, RuntimeCell, RuntimeStruct, RuntimeFunction, RuntimeClassInstance, RuntimeClassInstanceArray, RuntimeComplexNumber, RuntimeDummyHandle, RuntimeGraphicsHandle, RuntimeStructArray, RuntimeSparseMatrix, RuntimeDictionary, type RuntimeValue } from "./types.js";
+import { type RuntimeNumber, RuntimeTensor, type RuntimeString, RuntimeChar, type RuntimeLogical, RuntimeCell, RuntimeStruct, RuntimeFunction, RuntimeClassInstance, RuntimeClassInstanceArray, RuntimeComplexNumber, RuntimeDummyHandle, RuntimeGraphicsHandle, RuntimeStructArray, RuntimeSparseMatrix, RuntimeDictionary, RuntimeStringArray, type RuntimeValue } from "./types.js";
 export declare const RTV: {
     num(value: number): RuntimeNumber;
     tensor(data: Float64Array | number[], shape: number[], imag?: Float64Array | number[]): RuntimeTensor;
@@ -17,6 +17,8 @@ export declare const RTV: {
     /** Create a matrix from row-major data */
     matrix(rows: number, cols: number, data: number[] | Float64Array, imag?: number[] | Float64Array): RuntimeTensor;
     string(value: string): RuntimeString;
+    /** String array (does NOT collapse 1x1 — use stringArrayValue for that). */
+    stringArray(data: string[], shape: [number, number]): RuntimeStringArray;
     char(value: string): RuntimeChar;
     logical(value: boolean): RuntimeLogical;
     cell(data: RuntimeValue[], shape: number[]): RuntimeCell;

package/dist-lib/numbl-core/runtime/indexing.d.ts

@@ -18,6 +18,9 @@ export declare function charToNumericTensor(c: RuntimeChar): RuntimeTensor;
 /** Inverse of charToNumericTensor: read a numeric tensor's column-major
  *  data into a row-major char value, rounding codes to integers. */
 export declare function numericTensorToChar(t: RuntimeTensor): RuntimeChar;
+/** Resolve one subscript against a dimension of extent `extent` to 0-based
+ *  positions. Handles colon, scalars, numeric vectors, and logical masks. */
+export declare function stringArraySubscript(idx: RuntimeValue, extent: number): number[];
 /** Index into a value: v(i1, i2, ...) */
 export declare function indexIntoRTValue(base: RuntimeValue, indices: RuntimeValue[]): RuntimeValue;
 /** Store into indexed position: base(indices) = rhs — uses copy-on-write for shared data */

package/dist-lib/numbl-core/runtime/runtime.d.ts

@@ -78,6 +78,7 @@ export declare class Runtime {
         col(data: number[], imag?: number[]): RuntimeTensor;
         matrix(rows: number, cols: number, data: number[] | Float64Array, imag?: number[] | Float64Array): RuntimeTensor;
         string(value: string): RuntimeString;
+        stringArray(data: string[], shape: [number, number]): import("../runtime/types.js").RuntimeStringArray;
         char(value: string): RuntimeChar;
         logical(value: boolean): RuntimeLogical;
         cell(data: RuntimeValue[], shape: number[]): RuntimeCell;

package/dist-lib/numbl-core/runtime/types.d.ts

@@ -1,6 +1,6 @@
 import { Refcounted, type RefcountRuntime } from "./refcount.js";
 export declare const USE_FLOAT32: boolean;
-export type RuntimeValue = number | boolean | string | RuntimeTensor | RuntimeChar | RuntimeCell | RuntimeStruct | RuntimeFunction | RuntimeClassInstance | RuntimeComplexNumber | RuntimeDummyHandle | RuntimeGraphicsHandle | RuntimeStructArray | RuntimeClassInstanceArray | RuntimeSparseMatrix | RuntimeDictionary;
+export type RuntimeValue = number | boolean | string | RuntimeTensor | RuntimeChar | RuntimeCell | RuntimeStruct | RuntimeFunction | RuntimeClassInstance | RuntimeComplexNumber | RuntimeDummyHandle | RuntimeGraphicsHandle | RuntimeStructArray | RuntimeClassInstanceArray | RuntimeSparseMatrix | RuntimeDictionary | RuntimeStringArray;
 export type RuntimeNumber = number;
 export type RuntimeLogical = boolean;
 export type RuntimeString = string;
@@ -20,6 +20,7 @@ export declare const isRuntimeStructArray: (value: RuntimeValue) => value is Run
 export declare const isRuntimeClassInstanceArray: (value: RuntimeValue) => value is RuntimeClassInstanceArray;
 export declare const isRuntimeSparseMatrix: (value: RuntimeValue) => value is RuntimeSparseMatrix;
 export declare const isRuntimeDictionary: (value: RuntimeValue) => value is RuntimeDictionary;
+export declare const isRuntimeStringArray: (value: RuntimeValue) => value is RuntimeStringArray;
 export declare const kstr: (value: RuntimeValue) => string;
 export declare class RuntimeTensor extends Refcounted {
     readonly kind: "tensor";
@@ -40,6 +41,19 @@ export declare class RuntimeChar extends Refcounted {
     shape: number[] | undefined;
     constructor(value: string, shape?: number[]);
 }
+export declare class RuntimeStringArray extends Refcounted {
+    readonly kind: "string_array";
+    /** Elements in column-major order (plain JS strings). */
+    data: string[];
+    /** 2-D shape [rows, cols]; data.length === rows*cols. A 1x1 string is
+     *  normally represented as a primitive JS string, not a 1x1 array —
+     *  use stringArrayValue() to build results so scalars collapse. */
+    shape: [number, number];
+    constructor(data: string[], shape: [number, number]);
+}
+/** Build a string-array result, collapsing 1x1 to the primitive string
+ *  representation used for string scalars throughout the runtime. */
+export declare function stringArrayValue(data: string[], shape: [number, number]): RuntimeValue;
 export declare class RuntimeCell extends Refcounted {
     readonly kind: "cell";
     data: RuntimeValue[];

package/dist-lib/numbl-core/runtime/utils.d.ts

@@ -14,3 +14,6 @@ export declare function colMajorIndex(row: number, col: number, rows: number): n
 export declare function ind2sub(shape: number[], idx: number): number[];
 /** Convert subscripts to linear index (column-major) */
 export declare function sub2ind(shape: number[], subs: number[]): number;
+/** MATLAB num2str/string(double) default formatting: integers exact,
+ *  otherwise 5 significant digits (%.5g with MATLAB exponent padding). */
+export declare function matlabNumToString(n: number): string;

package/dist-lib/numbl-core/version.d.ts

@@ -1,2 +1,2 @@
 /** Numbl version, used for JIT disk cache invalidation. */
-export declare const NUMBL_VERSION = "0.4.8";
+export declare const NUMBL_VERSION = "0.4.9";

package/dist-lib/vfs/BrowserFileIOAdapter.d.ts

@@ -48,6 +48,12 @@ export declare class BrowserFileIOAdapter implements FileIOAdapter {
     private getEntry;
     private flushEntry;
     private writeBytes;
+    /**
+     * `entry.pos` stays the logical (consumed) byte position: the text buffer
+     * holds the bytes starting at `entry.pos`, and consuming a line advances
+     * `entry.pos` by its byte length. This keeps fgetl/fgets coherent with
+     * freadBytes/fseek/ftell (and fscanf, which mixes the two).
+     */
     private readLine;
     private listDirGlob;
     private listDirRecursive;