@zukhruf/python 0.8.3 → 0.8.4

package/README.md

@@ -1,6 +1,6 @@
 # @zukhruf/python
 
-The results of CPython 3.12 in JavaScript, to the last bit: the `sum()` of floats, the `repr()` of a float, `json.loads`, the white space of `str.isspace()`, and the word characters of `\w`. Use it when a TypeScript port must give the same numbers and text as a Python program, such as a benchmark's scorer.
+The results of CPython 3.12 in JavaScript, to the last bit: the `sum()` of floats, the `repr()` of a float, the order of two strings, `json.loads`, the white space of `str.isspace()`, and the word characters of `\w`. Use it when a TypeScript port must give the same numbers and text as a Python program, such as a benchmark's scorer.
 
 The package is public on npm. Until 2026-11-07 it was private and reached through a workspace path (ADR 0001); it became public with `@zukhruf/evals`, which depends on it (backlog #3888).
 
@@ -12,6 +12,7 @@ import {
   NeumaierSum,
   PYTHON_SPACE,
   PYTHON_WORD,
+  compareStrings,
   floatRepr,
   loadsJson,
   toJsonParseValue,
@@ -20,6 +21,7 @@ import {
 NeumaierSum.of([0.1, 0.2, 0.3]); // 0.6, as sum([0.1, 0.2, 0.3]) in Python
 NeumaierSum.mean([0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1]); // 0.1, as sum(values) / len(values) in Python
 floatRepr(1e16); // '1e+16', as repr(1e16)
+['é', '😀', '￿'].toSorted(compareStrings); // ['é', '￿', '😀'], as sorted() in Python
 const value: JsonData = loadsJson('{"b": 1, "10": 2.0, "a": NaN}');
 // Map { 'b' => 1n, '10' => 2, 'a' => NaN }
 toJsonParseValue(value); // { '10': 2, b: 1, a: NaN }, for a validator
@@ -30,6 +32,7 @@ new RegExp(`[${PYTHON_WORD}]+`, 'u'); // Python's \w
 | Export             | CPython                                  | What it keeps                                                                                                                                                                                                                                                                                                                                                                                             |
 | ------------------ | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `NeumaierSum`      | `sum()` of floats (Python/bltinmodule.c) | Neumaier's compensated sum. It starts at 0 and adds the compensation only when that is not 0 and is finite, so `[1e308, 1e308, -1e308]` gives `Infinity` and `[-0.0]` gives `0`. `add` and `value` give a running sum; `NeumaierSum.of(values)` sums an iterable. `NeumaierSum.mean(values)` is `sum(values) / len(values)`, and no value throws a `RangeError` (Python's `ZeroDivisionError`, ADR 0003). |
+| `compareStrings`   | the order of two `str`                   | The order of the Unicode code points, as `sorted()` gives. JavaScript's `<` compares UTF-16 code units, so a character above U+FFFF sorts before U+E000 to U+FFFF there and after them in Python.                                                                                                                                                                                                         |
 | `floatRepr`        | `repr()` of a float                      | The shortest digits, fixed notation for exponents from -4 to 15, and always a fraction: `1.0`, `1e+16`, `1e-05`, `-0.0`, `nan`, `inf`.                                                                                                                                                                                                                                                                    |
 | `loadsJson`        | `json.loads`                             | A dict is a `Map` in the order of its keys, and a repeated key keeps its first place and its last value. An int is a `bigint` and a float a `number`, so `1` and `1.0` stay apart. `NaN`, `Infinity` and `-Infinity` are numbers. Text that is not JSON throws a `SyntaxError` (Python's `JSONDecodeError`). An int of more than 4300 digits throws a `RangeError` (Python's `ValueError`).               |
 | `JsonData`         | the values of `json.loads`               | `null`, `boolean`, `bigint`, `number`, `string`, arrays and `Map`s of them. They are mutable, as in Python, so `Array.isArray` and `instanceof Map` narrow a value.                                                                                                                                                                                                                                       |

package/dist/compare-strings.d.ts

@@ -0,0 +1,2 @@
+export declare function compareStrings(left: string, right: string): number;
+//# sourceMappingURL=compare-strings.d.ts.map

package/dist/compare-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-strings.d.ts","sourceRoot":"","sources":["../src/compare-strings.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWlE"}

package/dist/compare-strings.js

@@ -0,0 +1,19 @@
+// UTF-16 code units order the strings that have no character above U+FFFF
+// as code points do.
+const SURROGATE = /[\u{10000}-\u{10FFFF}]/u;
+// Compares two strings as Python does: by Unicode code point, so
+// sorted(strings) of Python is strings.toSorted(compareStrings). UTF-8 bytes,
+// which C's strcmp compares, have the same order.
+export function compareStrings(left, right) {
+    if (!SURROGATE.test(left) && !SURROGATE.test(right))
+        return left < right ? -1 : left > right ? 1 : 0;
+    const a = [...left];
+    const b = [...right];
+    for (let index = 0; index < Math.min(a.length, b.length); index++) {
+        const difference = (a[index]?.codePointAt(0) ?? 0) - (b[index]?.codePointAt(0) ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    return a.length - b.length;
+}
+//# sourceMappingURL=compare-strings.js.map

package/dist/compare-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-strings.js","sourceRoot":"","sources":["../src/compare-strings.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qBAAqB;AACrB,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAE5C,iEAAiE;AACjE,8EAA8E;AAC9E,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,UAAU,GACd,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { compareStrings } from './compare-strings.ts';
 export { floatRepr } from './float-repr.ts';
 export type { JsonData } from './json-data.ts';
 export { loadsJson } from './loads-json.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { compareStrings } from "./compare-strings.js";
 export { floatRepr } from "./float-repr.js";
 export { loadsJson } from "./loads-json.js";
 export { NeumaierSum } from "./neumaier-sum.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zukhruf/python",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "CPython 3.12 results in JavaScript: the compensated sum() of floats, repr() of a float, json.loads with the order of keys and ints apart from floats, and the white space of str.isspace().",
   "license": "MIT",
   "repository": {