@particle-academy/holy-sheet 2.4.1 → 2.4.3

package/dist/index.d.cts

@@ -223,7 +223,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.4.1";
+declare const VERSION = "2.4.3";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -295,7 +295,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.4.1";
+    static readonly VERSION = "2.4.3";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -702,6 +702,21 @@ declare const SheetDiff: {
      *   example `columnWidths` decoded from `{"1":140,"0":120}`) as a map, not a
      *   list, and so as different from the same widths in order. A JS object has
      *   no such order to compare.
+     *
+     * Throws a `TypeError` on a value JSON cannot hold, as PHP 2.3.2 throws
+     * `JsonException`, rather than calling two such values the same:
+     *
+     * - a non-finite number (PHP: NAN, INF);
+     * - a lone UTF-16 surrogate in a string or a key, which is this runtime's
+     *   invalid UTF-8 (a JS string cannot hold invalid UTF-8, and PHP's own
+     *   `json_decode` refuses a lone surrogate);
+     * - a function or a symbol, which `JSON.stringify` would silently drop
+     *   (a bigint already throws there);
+     * - nesting deeper than PHP's `json_encode` depth of 4096, where every object
+     *   and array is a level, an empty one included. The walk is iterative, so
+     *   this is PHP's limit and not the call stack's.
+     *
+     * `undefined` stays what JSON makes it: an absent key, and `null` in a list.
      */
     same(a: unknown, b: unknown): boolean;
     /**

package/dist/index.d.ts

@@ -223,7 +223,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.4.1";
+declare const VERSION = "2.4.3";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -295,7 +295,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.4.1";
+    static readonly VERSION = "2.4.3";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -702,6 +702,21 @@ declare const SheetDiff: {
      *   example `columnWidths` decoded from `{"1":140,"0":120}`) as a map, not a
      *   list, and so as different from the same widths in order. A JS object has
      *   no such order to compare.
+     *
+     * Throws a `TypeError` on a value JSON cannot hold, as PHP 2.3.2 throws
+     * `JsonException`, rather than calling two such values the same:
+     *
+     * - a non-finite number (PHP: NAN, INF);
+     * - a lone UTF-16 surrogate in a string or a key, which is this runtime's
+     *   invalid UTF-8 (a JS string cannot hold invalid UTF-8, and PHP's own
+     *   `json_decode` refuses a lone surrogate);
+     * - a function or a symbol, which `JSON.stringify` would silently drop
+     *   (a bigint already throws there);
+     * - nesting deeper than PHP's `json_encode` depth of 4096, where every object
+     *   and array is a level, an empty one included. The walk is iterative, so
+     *   this is PHP's limit and not the call stack's.
+     *
+     * `undefined` stays what JSON makes it: an absent key, and `null` in a list.
      */
     same(a: unknown, b: unknown): boolean;
     /**