@oh-my-pi/pi-utils 16.3.6 → 16.3.7

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.3.7] - 2026-07-05
+
+### Added
+
+- Added `classifyJsonPrefix`, a strict RFC 8259 streaming-buffer classifier (`"complete" | "prefix" | "invalid"`). Providers use it to disambiguate identifierless streaming tool-call deltas: a `{`-prefixed chunk only advances to a sibling call when the current argument buffer cannot absorb it.
+
 ## [16.3.1] - 2026-07-02
 
 ### Fixed

package/dist/types/env.d.ts

@@ -1,4 +1,4 @@
-export * from "./worker-host";
+export * from "./worker-host.js";
 /**
  * Strict shell-identifier shape. Used for dotenv keys we accept into
  * `Bun.env` — those should be referenceable as `$NAME` from POSIX shells,

package/dist/types/fetch-retry.d.ts

@@ -3,7 +3,9 @@
  * by the OpenAI Codex and Google Gemini retry helpers.
  *
  * Header sources (checked in order):
+ *  - `retry-after-ms` (milliseconds)
  *  - `Retry-After` (numeric seconds, or HTTP date)
+ *  - `x-ratelimit-reset-ms` (delta ms, or Unix epoch ms/s for large values)
  *  - `x-ratelimit-reset` (Unix epoch seconds)
  *  - `x-ratelimit-reset-after` (seconds)
  *

package/dist/types/index.d.ts

@@ -1,35 +1,35 @@
-export { once, untilAborted } from "./abortable";
-export * from "./async";
-export * from "./binary";
-export * from "./color";
-export * from "./dirs";
-export * from "./env";
-export * from "./fetch-retry";
-export * from "./format";
-export * from "./frontmatter";
-export * from "./fs-error";
-export * from "./glob";
-export * from "./json";
-export * from "./json-parse";
-export * as logger from "./logger";
-export * from "./loop-phase";
-export * from "./mermaid-ascii";
-export * from "./mime";
-export * from "./path";
-export * from "./path-tree";
-export * from "./peek-file";
-export * as postmortem from "./postmortem";
-export * as procmgr from "./procmgr";
-export * as prompt from "./prompt";
-export * as ptree from "./ptree";
-export { AbortError, ChildProcess, Exception, NonZeroExitError } from "./ptree";
-export * from "./runtime-install";
-export * from "./sanitize-text";
-export * from "./snowflake";
-export * from "./stream";
-export * from "./tab-spacing";
-export * from "./temp";
-export * from "./tls-fetch";
-export * from "./type-guards";
-export * from "./which";
+export { once, untilAborted } from "./abortable.js";
+export * from "./async.js";
+export * from "./binary.js";
+export * from "./color.js";
+export * from "./dirs.js";
+export * from "./env.js";
+export * from "./fetch-retry.js";
+export * from "./format.js";
+export * from "./frontmatter.js";
+export * from "./fs-error.js";
+export * from "./glob.js";
+export * from "./json.js";
+export * from "./json-parse.js";
+export * as logger from "./logger.js";
+export * from "./loop-phase.js";
+export * from "./mermaid-ascii.js";
+export * from "./mime.js";
+export * from "./path.js";
+export * from "./path-tree.js";
+export * from "./peek-file.js";
+export * as postmortem from "./postmortem.js";
+export * as procmgr from "./procmgr.js";
+export * as prompt from "./prompt.js";
+export * as ptree from "./ptree.js";
+export { AbortError, ChildProcess, Exception, NonZeroExitError } from "./ptree.js";
+export * from "./runtime-install.js";
+export * from "./sanitize-text.js";
+export * from "./snowflake.js";
+export * from "./stream.js";
+export * from "./tab-spacing.js";
+export * from "./temp.js";
+export * from "./tls-fetch.js";
+export * from "./type-guards.js";
+export * from "./which.js";
 export declare function structuredCloneJSON<T>(value: T): T;

package/dist/types/json-parse.d.ts

@@ -46,3 +46,29 @@ export declare function parseStreamingJsonThrottled<T = Record<string, unknown>>
     value: T;
     parsedLen: number;
 } | null;
+/**
+ * Classification of a streaming buffer against strict JSON (RFC 8259):
+ * - `"complete"`: exactly one whole JSON value (plus surrounding whitespace).
+ * - `"prefix"`: a proper prefix of some valid JSON value — more bytes can
+ *   still complete it.
+ * - `"invalid"`: no suffix can ever make it valid strict JSON (e.g. a raw
+ *   control character inside a string, or a second top-level value).
+ */
+export type JsonPrefixState = "complete" | "prefix" | "invalid";
+/**
+ * Classify `text` as a strict-JSON value, prefix, or dead end.
+ *
+ * Providers use this to disambiguate identifierless streaming tool-call
+ * deltas: a chunk starting with `{` is a *new* sibling call only if the
+ * current call's argument buffer cannot absorb it — the buffer is already a
+ * complete value, already unsalvageable (lossy hosts abandon buffers
+ * mid-string, leaving raw control characters strict JSON forbids), or the
+ * concatenation would break it. Unlike {@link parseStreamingJson} this is
+ * deliberately strict: forgiving repair would mask exactly the corruption
+ * signals the caller needs.
+ *
+ * A top-level number at end-of-input classifies as `"complete"` even though
+ * more digits could extend it; tool-argument buffers are always objects, so
+ * the ambiguity is immaterial here.
+ */
+export declare function classifyJsonPrefix(text: string): JsonPrefixState;

package/dist/types/mermaid-ascii.d.ts

@@ -1,4 +1,4 @@
-import { type AsciiRenderOptions } from "./vendor/mermaid-ascii";
+import { type AsciiRenderOptions } from "./vendor/mermaid-ascii/index.js";
 export type { AsciiRenderOptions as MermaidAsciiRenderOptions };
 export declare function renderMermaidAscii(source: string, options?: AsciiRenderOptions): string;
 export declare function renderMermaidAsciiSafe(source: string, options?: AsciiRenderOptions): string | null;

package/dist/types/vendor/mermaid-ascii/ascii/ansi.d.ts

@@ -1,4 +1,4 @@
-import type { CharRole, AsciiTheme, ColorMode } from './types';
+import type { CharRole, AsciiTheme, ColorMode } from './types.js';
 /**
  * Default ASCII theme derived from the SVG renderer's color palette.
  * Uses the same mixing ratios to maintain visual consistency.

package/dist/types/vendor/mermaid-ascii/ascii/canvas.d.ts

@@ -1,4 +1,4 @@
-import type { Canvas, DrawingCoord, RoleCanvas, CharRole, AsciiTheme, ColorMode } from './types';
+import type { Canvas, DrawingCoord, RoleCanvas, CharRole, AsciiTheme, ColorMode } from './types.js';
 /**
  * Create a blank canvas filled with spaces.
  * Dimensions are inclusive: mkCanvas(3, 2) creates a 4x3 grid (indices 0..3, 0..2).

package/dist/types/vendor/mermaid-ascii/ascii/class-diagram.d.ts

@@ -1,4 +1,4 @@
-import type { AsciiConfig, AsciiTheme, ColorMode } from './types';
+import type { AsciiConfig, AsciiTheme, ColorMode } from './types.js';
 /**
  * Render a Mermaid class diagram to ASCII/Unicode text.
  *

package/dist/types/vendor/mermaid-ascii/ascii/converter.d.ts

@@ -1,5 +1,5 @@
-import type { MermaidGraph } from '../types';
-import type { AsciiGraph, AsciiConfig } from './types';
+import type { MermaidGraph } from '../types.js';
+import type { AsciiGraph, AsciiConfig } from './types.js';
 /**
  * Convert a parsed MermaidGraph into an AsciiGraph ready for grid layout.
  *

package/dist/types/vendor/mermaid-ascii/ascii/draw.d.ts

@@ -1,4 +1,4 @@
-import type { Canvas, DrawingCoord, AsciiGraph, AsciiNode, AsciiEdge, AsciiSubgraph, AsciiEdgeStyle } from './types';
+import type { Canvas, DrawingCoord, AsciiGraph, AsciiNode, AsciiEdge, AsciiSubgraph, AsciiEdgeStyle } from './types.js';
 /**
  * Draw a node using its shape type.
  * Returns a standalone canvas containing the rendered shape.

package/dist/types/vendor/mermaid-ascii/ascii/edge-bundling.d.ts

@@ -1,4 +1,4 @@
-import type { AsciiGraph, EdgeBundle, GridCoord } from './types';
+import type { AsciiGraph, EdgeBundle, GridCoord } from './types.js';
 /**
  * Analyze graph edges and create bundles for parallel links.
  *

package/dist/types/vendor/mermaid-ascii/ascii/edge-routing.d.ts

@@ -1,4 +1,4 @@
-import type { Direction, AsciiEdge, AsciiGraph } from './types';
+import type { Direction, AsciiEdge, AsciiGraph } from './types.js';
 export declare function getOpposite(d: Direction): Direction;
 /** Compare directions by value (not reference). */
 export declare function dirEquals(a: Direction, b: Direction): boolean;

package/dist/types/vendor/mermaid-ascii/ascii/er-diagram.d.ts

@@ -1,4 +1,4 @@
-import type { AsciiConfig, AsciiTheme, ColorMode } from './types';
+import type { AsciiConfig, AsciiTheme, ColorMode } from './types.js';
 /**
  * Render a Mermaid ER diagram to ASCII/Unicode text.
  *

package/dist/types/vendor/mermaid-ascii/ascii/grid.d.ts

@@ -1,4 +1,4 @@
-import type { GridCoord, DrawingCoord, Direction, AsciiGraph, AsciiNode, AsciiSubgraph } from './types';
+import type { GridCoord, DrawingCoord, Direction, AsciiGraph, AsciiNode, AsciiSubgraph } from './types.js';
 /**
  * Convert a grid coordinate to a drawing (character) coordinate.
  * Sums column widths up to the target column, and row heights up to the target row,

package/dist/types/vendor/mermaid-ascii/ascii/index.d.ts

@@ -1,6 +1,6 @@
-import { detectColorMode, DEFAULT_ASCII_THEME } from './ansi';
-import type { AsciiTheme, ColorMode } from './types';
-import type { Direction } from '../types';
+import { detectColorMode, DEFAULT_ASCII_THEME } from './ansi.js';
+import type { AsciiTheme, ColorMode } from './types.js';
+import type { Direction } from '../types.js';
 export type { AsciiTheme, ColorMode };
 export { DEFAULT_ASCII_THEME, detectColorMode };
 export interface AsciiRenderOptions {

package/dist/types/vendor/mermaid-ascii/ascii/multiline-utils.d.ts

@@ -1,4 +1,4 @@
-import type { Canvas } from './types';
+import type { Canvas } from './types.js';
 /**
  * Split a label into lines.
  * Labels are already normalized by parsers (br tags → \n).

package/dist/types/vendor/mermaid-ascii/ascii/pathfinder.d.ts

@@ -1,4 +1,4 @@
-import type { GridCoord, AsciiNode } from './types';
+import type { GridCoord, AsciiNode } from './types.js';
 /**
  * Manhattan distance with a +1 penalty when both dx and dy are non-zero.
  * This encourages the pathfinder to prefer straight lines and minimize corners.

package/dist/types/vendor/mermaid-ascii/ascii/sequence.d.ts

@@ -1,4 +1,4 @@
-import type { AsciiConfig, AsciiTheme, ColorMode } from './types';
+import type { AsciiConfig, AsciiTheme, ColorMode } from './types.js';
 /**
  * Render a Mermaid sequence diagram to ASCII/Unicode text.
  *

package/dist/types/vendor/mermaid-ascii/ascii/shapes/circle.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Circle shape renderer.
  * Uses circle markers (◯) at corners to indicate circular shape semantics.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/corners.d.ts

@@ -1,4 +1,4 @@
-import type { AsciiNodeShape } from '../types';
+import type { AsciiNodeShape } from '../types.js';
 /**
  * Corner characters for a shape in both Unicode and ASCII modes.
  */

package/dist/types/vendor/mermaid-ascii/ascii/shapes/diamond.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Diamond shape renderer.
  * Uses diamond markers (◇) at corners to indicate decision node semantics.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/hexagon.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Hexagon shape renderer.
  * Uses hexagon markers (⬡) at corners to indicate process node semantics.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/index.d.ts

@@ -1,5 +1,5 @@
-import type { AsciiNodeShape, Canvas, DrawingCoord, Direction } from '../types';
-import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry } from './types';
+import type { AsciiNodeShape, Canvas, DrawingCoord, Direction } from '../types.js';
+import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry } from './types.js';
 export type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry };
 /**
  * Global shape registry — maps shape types to their renderers.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/rectangle.d.ts

@@ -1,6 +1,6 @@
-import type { Canvas, DrawingCoord, Direction } from '../types';
-import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types';
-import { type CornerChars } from './corners';
+import type { Canvas, DrawingCoord, Direction } from '../types.js';
+import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types.js';
+import { type CornerChars } from './corners.js';
 /**
  * Calculate standard box dimensions for any rectangular shape.
  * Used by rectangle, circle, diamond, hexagon, etc.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/rounded.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Rounded rectangle shape renderer.
  * Uses rounded corner markers (╭╮╰╯) to indicate soft edges.

package/dist/types/vendor/mermaid-ascii/ascii/shapes/special.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Subroutine shape renderer — double-bordered rectangle.
  * Renders as:

package/dist/types/vendor/mermaid-ascii/ascii/shapes/stadium.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * Stadium (pill) shape renderer.
  *

package/dist/types/vendor/mermaid-ascii/ascii/shapes/state.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeRenderer } from './types';
+import type { ShapeRenderer } from './types.js';
 /**
  * State start pseudo-state renderer — filled circle in rounded box.
  * Renders as:

package/dist/types/vendor/mermaid-ascii/ascii/shapes/types.d.ts

@@ -1,4 +1,4 @@
-import type { Canvas, DrawingCoord, Direction, AsciiNodeShape } from '../types';
+import type { Canvas, DrawingCoord, Direction, AsciiNodeShape } from '../types.js';
 /**
  * Dimensions calculated for a shape, used by layout and rendering.
  */

package/dist/types/vendor/mermaid-ascii/ascii/types.d.ts

@@ -1,4 +1,4 @@
-import type { NodeShape } from '../types';
+import type { NodeShape } from '../types.js';
 export type { NodeShape };
 /**
  * Shape type for ASCII rendering — maps parser shapes to ASCII renderers.

package/dist/types/vendor/mermaid-ascii/ascii/xychart.d.ts

@@ -1,2 +1,2 @@
-import type { AsciiConfig, AsciiTheme, ColorMode } from './types';
+import type { AsciiConfig, AsciiTheme, ColorMode } from './types.js';
 export declare function renderXYChartAscii(text: string, config: AsciiConfig, colorMode: ColorMode, theme: AsciiTheme): string;

package/dist/types/vendor/mermaid-ascii/class/parser.d.ts

@@ -1,4 +1,4 @@
-import type { ClassDiagram } from './types';
+import type { ClassDiagram } from './types.js';
 /**
  * Parse a Mermaid class diagram.
  * Expects the first line to be "classDiagram".

package/dist/types/vendor/mermaid-ascii/er/parser.d.ts

@@ -1,4 +1,4 @@
-import type { ErDiagram } from './types';
+import type { ErDiagram } from './types.js';
 /**
  * Parse a Mermaid ER diagram.
  * Expects the first line to be "erDiagram".

package/dist/types/vendor/mermaid-ascii/index.d.ts

@@ -1 +1 @@
-export * from './ascii/index';
+export * from './ascii/index.js';

package/dist/types/vendor/mermaid-ascii/parser.d.ts

@@ -1,4 +1,4 @@
-import type { MermaidGraph } from './types';
+import type { MermaidGraph } from './types.js';
 /**
  * Parse Mermaid text into a logical graph structure.
  * Auto-detects diagram type (flowchart or state diagram).

package/dist/types/vendor/mermaid-ascii/sequence/parser.d.ts

@@ -1,4 +1,4 @@
-import type { SequenceDiagram } from './types';
+import type { SequenceDiagram } from './types.js';
 /**
  * Parse a Mermaid sequence diagram.
  * Expects the first line to be "sequenceDiagram".

package/dist/types/vendor/mermaid-ascii/xychart/parser.d.ts

@@ -1,4 +1,4 @@
-import type { XYChart } from './types';
+import type { XYChart } from './types.js';
 /**
  * Parse a Mermaid xychart-beta diagram from preprocessed lines.
  * Lines should already be trimmed and comment-stripped.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-utils",
-	"version": "16.3.6",
+	"version": "16.3.7",
 	"description": "Shared utilities for pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,7 +31,7 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "16.3.6",
+		"@oh-my-pi/pi-natives": "16.3.7",
 		"handlebars": "^4.7.9",
 		"winston": "^3.19.0",
 		"winston-daily-rotate-file": "^5.0.0"

package/src/fetch-retry.ts

@@ -16,7 +16,9 @@ const TRY_AGAIN_PATTERN = /try again in\s+~?\s*([0-9.]+)\s*(ms|sec|s|minutes?|mi
  * by the OpenAI Codex and Google Gemini retry helpers.
  *
  * Header sources (checked in order):
+ *  - `retry-after-ms` (milliseconds)
  *  - `Retry-After` (numeric seconds, or HTTP date)
+ *  - `x-ratelimit-reset-ms` (delta ms, or Unix epoch ms/s for large values)
  *  - `x-ratelimit-reset` (Unix epoch seconds)
  *  - `x-ratelimit-reset-after` (seconds)
  *
@@ -31,6 +33,11 @@ const TRY_AGAIN_PATTERN = /try again in\s+~?\s*([0-9.]+)\s*(ms|sec|s|minutes?|mi
 export function extractRetryHint(source: Response | Headers | null | undefined, body?: string): number | undefined {
 	const headers = source instanceof Headers ? source : (source?.headers ?? undefined);
 	if (headers) {
+		const retryAfterMs = headers.get("retry-after-ms");
+		if (retryAfterMs) {
+			const ms = Number(retryAfterMs);
+			if (Number.isFinite(ms) && ms >= 0) return ms;
+		}
 		const retryAfter = headers.get("retry-after");
 		if (retryAfter) {
 			const seconds = Number(retryAfter);
@@ -38,6 +45,17 @@ export function extractRetryHint(source: Response | Headers | null | undefined,
 			const parsedDate = Date.parse(retryAfter);
 			if (!Number.isNaN(parsedDate)) return Math.max(0, parsedDate - Date.now());
 		}
+		const rateLimitResetMs = headers.get("x-ratelimit-reset-ms");
+		if (rateLimitResetMs) {
+			const value = Number(rateLimitResetMs);
+			if (Number.isFinite(value) && value > 0) {
+				// > 1e12 → epoch ms; > 1e9 → epoch s; otherwise a delta in ms.
+				const targetMs = value > 1e12 ? value : value > 1e9 ? value * 1000 : undefined;
+				if (targetMs === undefined) return value;
+				const delta = targetMs - Date.now();
+				if (delta > 0) return delta;
+			}
+		}
 		const rateLimitReset = headers.get("x-ratelimit-reset");
 		if (rateLimitReset) {
 			const resetSeconds = Number.parseInt(rateLimitReset, 10);

package/src/json-parse.ts

@@ -610,3 +610,212 @@ export function parseStreamingJsonThrottled<T = Record<string, unknown>>(
 	if (len === 0 || (lastParsedLen > 0 && len - lastParsedLen < minGrowthBytes)) return null;
 	return { value: parseStreamingJson<T>(partialJson), parsedLen: len };
 }
+
+/**
+ * Classification of a streaming buffer against strict JSON (RFC 8259):
+ * - `"complete"`: exactly one whole JSON value (plus surrounding whitespace).
+ * - `"prefix"`: a proper prefix of some valid JSON value — more bytes can
+ *   still complete it.
+ * - `"invalid"`: no suffix can ever make it valid strict JSON (e.g. a raw
+ *   control character inside a string, or a second top-level value).
+ */
+export type JsonPrefixState = "complete" | "prefix" | "invalid";
+
+/** What the strict-prefix scanner expects at the current position. */
+const enum JsonExpect {
+	Value,
+	ObjKeyOrEnd,
+	ObjKey,
+	ObjColon,
+	ObjCommaOrEnd,
+	ArrValueOrEnd,
+	ArrCommaOrEnd,
+	End,
+}
+
+/**
+ * Classify `text` as a strict-JSON value, prefix, or dead end.
+ *
+ * Providers use this to disambiguate identifierless streaming tool-call
+ * deltas: a chunk starting with `{` is a *new* sibling call only if the
+ * current call's argument buffer cannot absorb it — the buffer is already a
+ * complete value, already unsalvageable (lossy hosts abandon buffers
+ * mid-string, leaving raw control characters strict JSON forbids), or the
+ * concatenation would break it. Unlike {@link parseStreamingJson} this is
+ * deliberately strict: forgiving repair would mask exactly the corruption
+ * signals the caller needs.
+ *
+ * A top-level number at end-of-input classifies as `"complete"` even though
+ * more digits could extend it; tool-argument buffers are always objects, so
+ * the ambiguity is immaterial here.
+ */
+export function classifyJsonPrefix(text: string): JsonPrefixState {
+	const n = text.length;
+	let i = 0;
+	// Container stack: true = object, false = array.
+	const stack: boolean[] = [];
+	let expect = JsonExpect.Value;
+
+	/** Consume a string starting at the opening quote. 1 = ok, 0 = prefix, -1 = invalid. */
+	const scanString = (): 1 | 0 | -1 => {
+		i++; // opening quote
+		while (i < n) {
+			const c = text.charCodeAt(i);
+			if (c === QUOTE) {
+				i++;
+				return 1;
+			}
+			if (c === BACKSLASH) {
+				i++;
+				if (i >= n) return 0;
+				const e = text.charCodeAt(i);
+				if (e >= 128 || !VALID_ESCAPE_CHAR[e]) return -1;
+				i++;
+				if (e === U) {
+					for (let k = 0; k < 4; k++, i++) {
+						if (i >= n) return 0;
+						if (!isHexDigit(text.charCodeAt(i))) return -1;
+					}
+				}
+				continue;
+			}
+			if (c < 0x20) return -1; // raw control char: strict JSON forbids it
+			i++;
+		}
+		return 0;
+	};
+
+	/** Consume a number starting at `-` or a digit. 1 = token done, 0 = prefix, -1 = invalid. */
+	const scanNumber = (): 1 | 0 | -1 => {
+		if (text.charCodeAt(i) === 0x2d) i++; // -
+		if (i >= n) return 0;
+		let c = text.charCodeAt(i);
+		if (c === 0x30) {
+			i++; // 0: no further integer digits allowed
+		} else if (c >= 0x31 && c <= 0x39) {
+			while (i < n && text.charCodeAt(i) >= 0x30 && text.charCodeAt(i) <= 0x39) i++;
+		} else {
+			return -1;
+		}
+		if (i < n && text.charCodeAt(i) === 0x2e) {
+			i++; // .
+			if (i >= n) return 0;
+			if (text.charCodeAt(i) < 0x30 || text.charCodeAt(i) > 0x39) return -1;
+			while (i < n && text.charCodeAt(i) >= 0x30 && text.charCodeAt(i) <= 0x39) i++;
+		}
+		c = i < n ? text.charCodeAt(i) : 0;
+		if (c === 0x65 || c === 0x45) {
+			i++; // e | E
+			if (i < n && (text.charCodeAt(i) === 0x2b || text.charCodeAt(i) === 0x2d)) i++;
+			if (i >= n) return 0;
+			if (text.charCodeAt(i) < 0x30 || text.charCodeAt(i) > 0x39) return -1;
+			while (i < n && text.charCodeAt(i) >= 0x30 && text.charCodeAt(i) <= 0x39) i++;
+		}
+		return 1;
+	};
+
+	/** Consume `true`/`false`/`null`. 1 = done, 0 = prefix, -1 = invalid. */
+	const scanKeyword = (): 1 | 0 | -1 => {
+		for (const word of ["true", "false", "null"] as const) {
+			if (word.charCodeAt(0) !== text.charCodeAt(i)) continue;
+			const available = Math.min(word.length, n - i);
+			if (!word.startsWith(text.slice(i, i + available))) return -1;
+			i += available;
+			return available === word.length ? 1 : 0;
+		}
+		return -1;
+	};
+
+	/** A value just finished; the next expectation follows from the stack. */
+	const valueDone = (): JsonExpect =>
+		stack.length === 0
+			? JsonExpect.End
+			: stack[stack.length - 1]
+				? JsonExpect.ObjCommaOrEnd
+				: JsonExpect.ArrCommaOrEnd;
+
+	while (i < n) {
+		const c = text.charCodeAt(i);
+		if (isWhitespace(c)) {
+			i++;
+			continue;
+		}
+		switch (expect) {
+			case JsonExpect.Value:
+			case JsonExpect.ArrValueOrEnd: {
+				if (c === 0x5d && expect === JsonExpect.ArrValueOrEnd) {
+					stack.pop();
+					i++;
+					expect = valueDone();
+					break;
+				}
+				if (c === 0x7b) {
+					stack.push(true);
+					i++;
+					expect = JsonExpect.ObjKeyOrEnd;
+					break;
+				}
+				if (c === 0x5b) {
+					stack.push(false);
+					i++;
+					expect = JsonExpect.ArrValueOrEnd;
+					break;
+				}
+				let r: 1 | 0 | -1;
+				if (c === QUOTE) r = scanString();
+				else if (c === 0x2d || (c >= 0x30 && c <= 0x39)) r = scanNumber();
+				else if (c === 0x74 || c === 0x66 || c === 0x6e) r = scanKeyword();
+				else return "invalid";
+				if (r === -1) return "invalid";
+				if (r === 0) return "prefix";
+				expect = valueDone();
+				break;
+			}
+			case JsonExpect.ObjKeyOrEnd:
+			case JsonExpect.ObjKey: {
+				if (c === 0x7d && expect === JsonExpect.ObjKeyOrEnd) {
+					stack.pop();
+					i++;
+					expect = valueDone();
+					break;
+				}
+				if (c !== QUOTE) return "invalid";
+				const r = scanString();
+				if (r === -1) return "invalid";
+				if (r === 0) return "prefix";
+				expect = JsonExpect.ObjColon;
+				break;
+			}
+			case JsonExpect.ObjColon:
+				if (c !== 0x3a) return "invalid";
+				i++;
+				expect = JsonExpect.Value;
+				break;
+			case JsonExpect.ObjCommaOrEnd:
+				if (c === 0x7d) {
+					stack.pop();
+					i++;
+					expect = valueDone();
+					break;
+				}
+				if (c !== 0x2c) return "invalid";
+				i++;
+				expect = JsonExpect.ObjKey;
+				break;
+			case JsonExpect.ArrCommaOrEnd:
+				if (c === 0x5d) {
+					stack.pop();
+					i++;
+					expect = valueDone();
+					break;
+				}
+				if (c !== 0x2c) return "invalid";
+				i++;
+				expect = JsonExpect.Value;
+				break;
+			case JsonExpect.End:
+				return "invalid"; // trailing non-whitespace after a complete value
+		}
+	}
+	return expect === JsonExpect.End ? "complete" : "prefix";
+}