@particle-academy/holy-sheet 2.11.0 → 2.11.1

package/CHANGELOG.md

@@ -10,6 +10,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.11.1] - 2026-10-27
+
+### Fixed
+
+- **An explicit `{value: <string>}` cell is now written as a string, exactly
+  as given**, matching PHP holy-sheet and holy-sheet-py. Numeric-string
+  coercion used to run on the object form too, so `{value: "+1"}` was written
+  as the number 1, `{value: "007"}` as 7 and `{value: "1e5"}` as 100000: a
+  phone prefix, zip code or part number lost its characters with no error.
+  This applies in `rows` and in the sparse `cells` map, under any column type
+  or number format, and to a `set_cell` op's `value`. Unchanged: a BARE string
+  in a row or a `cells` entry is still coerced (`"+1"` is still 1) and a bare
+  `"=..."` is still a formula; an object value that is already a number is
+  still a number; and a string under a `date` / `datetime` display format is
+  still converted to a date serial. `read()` returns such a cell as the same
+  string.
+  **What a consumer must do:** if you relied on `{value: "100"}` becoming a
+  number, pass the number (`{value: 100}`) or the bare string (`"100"`).
+  Otherwise nothing.
+
 ## [2.11.0] - 2026-10-27
 
 ### Added

package/dist/{chunk-OL6E7DE5.js → chunk-NQRZFV32.js}

@@ -780,7 +780,7 @@ var Normalizer = class {
         address,
         new Cell(
           address,
-          this.coerceValue(rawValue, format, address, sheetName2),
+          this.coerceValue(rawValue, format, address, sheetName2, true),
           cellData?.formula ?? null,
           format,
           comment,
@@ -873,7 +873,7 @@ var Normalizer = class {
       const rawValue = value.value ?? null;
       return new Cell(
         address,
-        this.coerceValue(rawValue, merged, address, sheetName2),
+        this.coerceValue(rawValue, merged, address, sheetName2, true),
         value.formula ?? null,
         merged,
         comment,
@@ -888,7 +888,15 @@ var Normalizer = class {
       columnFormat
     );
   }
-  coerceValue(value, format, address = "?", sheetName2) {
+  /**
+   * `explicit`: the value came from an object cell's `value` key. An explicit
+   * string is the caller saying "this text, exactly", so it is never coerced
+   * to a number: `{value: "+1"}` stays "+1" and `{value: "007"}` stays "007".
+   * Only a date/datetime display format still turns a string into a serial,
+   * because that conversion is what the format asks for. Bare values keep
+   * numeric-string coercion. Mirrors PHP `Normalizer::coerceValue`.
+   */
+  coerceValue(value, format, address = "?", sheetName2, explicit = false) {
     if (value === null || value === void 0) return null;
     const df = format?.displayFormat;
     if (df === "date" || df === "datetime") {
@@ -896,6 +904,9 @@ var Normalizer = class {
         return DateConverter.toSerial(value, df === "datetime");
       }
     }
+    if (explicit && typeof value === "string") {
+      return value;
+    }
     if (typeof value === "string" && isNumericString(value)) {
       return numericStringToNumber(value);
     }
@@ -6252,7 +6263,7 @@ var holy_sheet_schema_default = {
 };
 
 // src/agent.ts
-var VERSION = "2.11.0";
+var VERSION = "2.11.1";
 function toU8(input) {
   return input instanceof Uint8Array ? input : new Uint8Array(input);
 }
@@ -6824,5 +6835,5 @@ function unencodable(reason) {
 }
 
 export { Agent, ArchiveRefused, ArrayBuilder, CellAddress, CsvBuilder, FormatSniffer, FormulaLinter, Inference, Normalizer, OdsReader, OfficeTemplateRefused, Repairer, SchemaException, SheetDiff, SheetOpSchema, SheetReducer, SourceArchive, Theme, UnsupportedFormatException, VERSION, Validator, XlsxReader, XlsxWriter, readFileBounded, sourceKind, unzipSync, zipSync };
-//# sourceMappingURL=chunk-OL6E7DE5.js.map
-//# sourceMappingURL=chunk-OL6E7DE5.js.map
+//# sourceMappingURL=chunk-NQRZFV32.js.map
+//# sourceMappingURL=chunk-NQRZFV32.js.map