@zukhruf/python 0.0.0-stage → 0.8.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ezzabuzaid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,9 @@
+@zukhruf/python
+Copyright 2026 ezzabuzaid
+
+This package ports the semantics of parts of CPython 3.12 (the sum() of
+floats in Python/bltinmodule.c, float.__repr__ in Python/pystrtod.c, the
+json module's scanner and decoder in Lib/json, and str.isspace), Copyright
+(c) Python Software Foundation, PSF License Version 2,
+https://github.com/python/cpython. The package does not include CPython's
+code.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @zukhruf/python
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+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 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).
+
+## Use it
+
+```ts
+import {
+  type JsonData,
+  NeumaierSum,
+  PYTHON_SPACE,
+  PYTHON_WORD,
+  floatRepr,
+  loadsJson,
+  toJsonParseValue,
+} from '@zukhruf/python';
+
+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)
+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
+new RegExp(`[${PYTHON_SPACE}]+`, 'u'); // Python's \s
+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). |
+| `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.                                                                                                                                                                                                                                       |
+| `PYTHON_SPACE`     | `str.isspace()`, `\s`, `str.split()`     | The body of a RegExp class. It has U+001C to U+001F, which JavaScript's `\s` lacks, and lacks U+FEFF, which JavaScript's `\s` has.                                                                                                                                                                                                                                                                        |
+| `PYTHON_WORD`      | `\w` of a `str` pattern                  | The body of a RegExp class: letters, numbers and `_`. It equals CPython 3.12's `\w` for each character of Unicode 15.0. Node knows characters of later Unicode versions, which it reads as `\w` and Python 3.12 does not.                                                                                                                                                                                 |
+| `toJsonParseValue` | none: the way out of `JsonData`          | The value that `JSON.parse` gives for the same text, for code that reads only plain JavaScript, such as a JSON Schema validator. A dict becomes an object, so its integer-like keys move first. An int becomes the nearest `number`, so an int beyond 2^53 loses digits. The int `-0` gives `0`. Keep the `JsonData`, and convert only where such code reads it (ADR 0002).                               |
+| `JsonParseValue`   | none                                     | The type of a value of `toJsonParseValue`: `null`, `boolean`, `number`, `string`, arrays and plain objects of them.                                                                                                                                                                                                                                                                                       |
+
+## Documentation
+
+- [ADR 0001: one home for the CPython rules that three places copied, reached through a workspace path](docs/adr/0001-one-home-for-the-cpython-rules-that-three-places-copied.md)
+- [ADR 0002: JsonData has one way out, and code takes it only at an edge](docs/adr/0002-json-data-has-one-way-out-at-an-edge.md)
+- [ADR 0003: the mean that a Python program writes as sum(values) / len(values) is NeumaierSum.mean](docs/adr/0003-the-mean-of-a-python-program-is-neumaier-sum-mean.md)

package/dist/float-repr.d.ts

@@ -0,0 +1,2 @@
+export declare function floatRepr(value: number): string;
+//# sourceMappingURL=float-repr.d.ts.map

package/dist/float-repr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"float-repr.d.ts","sourceRoot":"","sources":["../src/float-repr.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB/C"}

package/dist/float-repr.js

@@ -0,0 +1,24 @@
+// repr() of a float in CPython: the shortest digits that read back as the
+// same float, in fixed notation when the exponent is from -4 to 15, and
+// always with a fraction (Python/pystrtod.c, format_float_short, mode 'r').
+export function floatRepr(value) {
+    if (Number.isNaN(value))
+        return 'nan';
+    if (!Number.isFinite(value))
+        return value > 0 ? 'inf' : '-inf';
+    const [mantissa = '', exponentText = '0'] = value.toExponential().split('e');
+    const sign = mantissa.startsWith('-') || Object.is(value, -0) ? '-' : '';
+    const digits = mantissa.replace('-', '').replace('.', '');
+    const exponent = Number(exponentText);
+    if (exponent < -4 || exponent >= 16) {
+        const fraction = digits.slice(1);
+        const magnitude = String(Math.abs(exponent)).padStart(2, '0');
+        return `${sign}${digits[0]}${fraction ? `.${fraction}` : ''}e${exponent < 0 ? '-' : '+'}${magnitude}`;
+    }
+    if (exponent < 0)
+        return `${sign}0.${'0'.repeat(-exponent - 1)}${digits}`;
+    const whole = digits.slice(0, exponent + 1).padEnd(exponent + 1, '0');
+    const fraction = digits.slice(exponent + 1);
+    return `${sign}${whole}.${fraction || '0'}`;
+}
+//# sourceMappingURL=float-repr.js.map

package/dist/float-repr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"float-repr.js","sourceRoot":"","sources":["../src/float-repr.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,CAAC,QAAQ,GAAG,EAAE,EAAE,YAAY,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;IACxG,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO,GAAG,IAAI,GAAG,KAAK,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { floatRepr } from './float-repr.ts';
+export type { JsonData } from './json-data.ts';
+export { loadsJson } from './loads-json.ts';
+export { NeumaierSum } from './neumaier-sum.ts';
+export { PYTHON_SPACE } from './python-space.ts';
+export { PYTHON_WORD } from './python-word.ts';
+export { type JsonParseValue, toJsonParseValue, } from './to-json-parse-value.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { floatRepr } from "./float-repr.js";
+export { loadsJson } from "./loads-json.js";
+export { NeumaierSum } from "./neumaier-sum.js";
+export { PYTHON_SPACE } from "./python-space.js";
+export { PYTHON_WORD } from "./python-word.js";
+export { toJsonParseValue, } from "./to-json-parse-value.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/json-data.d.ts

@@ -0,0 +1,2 @@
+export type JsonData = null | boolean | bigint | number | string | JsonData[] | Map<string, JsonData>;
+//# sourceMappingURL=json-data.d.ts.map

package/dist/json-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-data.d.ts","sourceRoot":"","sources":["../src/json-data.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,EAAE,GACV,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC"}

package/dist/json-data.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-data.js.map

package/dist/json-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-data.js","sourceRoot":"","sources":["../src/json-data.ts"],"names":[],"mappings":""}

package/dist/loads-json.d.ts

@@ -0,0 +1,3 @@
+import type { JsonData } from './json-data.ts';
+export declare function loadsJson(text: string): JsonData;
+//# sourceMappingURL=loads-json.d.ts.map

package/dist/loads-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loads-json.d.ts","sourceRoot":"","sources":["../src/loads-json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAa/C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAuDhD"}

package/dist/loads-json.js

@@ -0,0 +1,131 @@
+import { printParseErrorCode, visit } from 'jsonc-parser';
+// Python refuses to read an int of more than this many digits
+// (sys.int_info.default_max_str_digits, Python 3.11 and later).
+const maxIntDigits = 4300;
+// json.loads of CPython: each dict a Map in the order of its keys (a repeated
+// key keeps its first place and its last value), each number with a `.`, `e`
+// or `E` a float and any other an int (a bigint, exact), and the NaN,
+// Infinity and -Infinity tokens of Python's json module. A text that is not
+// JSON throws a SyntaxError, as Python raises a JSONDecodeError: comments and
+// trailing commas too. An int of more than 4300 digits throws a RangeError, as
+// Python raises a ValueError.
+export function loadsJson(text) {
+    const tokens = pythonTokens(text);
+    const containers = [];
+    let root;
+    let key = '';
+    const add = (value) => {
+        const parent = containers.at(-1);
+        if (parent === undefined)
+            root = value;
+        else if (Array.isArray(parent))
+            parent.push(value);
+        else
+            parent.set(key, value);
+    };
+    visit(tokens.json, {
+        onObjectBegin: () => {
+            const object = new Map();
+            add(object);
+            containers.push(object);
+        },
+        onObjectProperty: (property) => {
+            tokens.key(property);
+            key = property;
+        },
+        onObjectEnd: () => {
+            containers.pop();
+        },
+        onArrayBegin: () => {
+            const array = [];
+            add(array);
+            containers.push(array);
+        },
+        onArrayEnd: () => {
+            containers.pop();
+        },
+        onLiteralValue: (value, offset, length) => {
+            if (typeof value !== 'number') {
+                add(tokens.number(value));
+                return;
+            }
+            add(numberOf(tokens.json.slice(offset, offset + length), value));
+        },
+        onError: (error, offset) => {
+            throw new SyntaxError(`${printParseErrorCode(error)} at position ${offset} of the JSON text.`);
+        },
+    }, { disallowComments: true });
+    if (root === undefined)
+        throw new SyntaxError('The JSON text has no value.');
+    return root;
+}
+// A number literal as Python reads it: with ".", "e" or "E" it is a float,
+// else an int, exact at any size up to Python's limit (Lib/json/scanner.py,
+// NUMBER_RE).
+function numberOf(literal, value) {
+    if (/[.eE]/.test(literal))
+        return value;
+    if (literal.replace('-', '').length > maxIntDigits)
+        throw new RangeError(`An int of more than ${maxIntDigits} digits, which Python does not read.`);
+    return BigInt(literal);
+}
+// Python's json module writes NaN, Infinity and -Infinity as bare tokens,
+// which JSON does not have. json is the text with each token outside a string
+// as a string that starts with a random marker; number gives the number of
+// such a string, and any other value as it is. The json module reads the
+// tokens only as values (_scan_once, Lib/json/scanner.py); a key must start
+// with '"' (JSONObject, Lib/json/decoder.py), so key throws for a token.
+function pythonTokens(text) {
+    const marker = `${crypto.randomUUID()}:`;
+    let out = '';
+    let index = 0;
+    while (index < text.length) {
+        const char = text[index];
+        if (char === '"') {
+            const end = stringEnd(text, index);
+            out += text.slice(index, end);
+            index = end;
+            continue;
+        }
+        const token = ['-Infinity', 'Infinity', 'NaN'].find((candidate) => text.startsWith(candidate, index));
+        if (token !== undefined) {
+            out += JSON.stringify(marker + token);
+            index += token.length;
+            continue;
+        }
+        out += char;
+        index++;
+    }
+    const numbers = [
+        [`${marker}NaN`, NaN],
+        [`${marker}Infinity`, Infinity],
+        [`${marker}-Infinity`, -Infinity],
+    ];
+    return {
+        json: out,
+        number: (value) => {
+            for (const [token, number] of numbers)
+                if (value === token)
+                    return number;
+            return value;
+        },
+        key: (name) => {
+            if (numbers.some(([token]) => token === name))
+                throw new SyntaxError('Expecting property name enclosed in double quotes');
+        },
+    };
+}
+// The index after the closing quote of the string that starts at start.
+function stringEnd(text, start) {
+    let index = start + 1;
+    while (index < text.length) {
+        if (text[index] === '\\')
+            index += 2;
+        else if (text[index] === '"')
+            return index + 1;
+        else
+            index++;
+    }
+    return text.length;
+}
+//# sourceMappingURL=loads-json.js.map

package/dist/loads-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loads-json.js","sourceRoot":"","sources":["../src/loads-json.ts"],"names":[],"mappings":"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"}

package/dist/neumaier-sum.d.ts

@@ -0,0 +1,8 @@
+export declare class NeumaierSum {
+    #private;
+    static of(values: Iterable<number>): number;
+    static mean(values: Iterable<number>): number;
+    add(value: number): void;
+    get value(): number;
+}
+//# sourceMappingURL=neumaier-sum.d.ts.map

package/dist/neumaier-sum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neumaier-sum.d.ts","sourceRoot":"","sources":["../src/neumaier-sum.ts"],"names":[],"mappings":"AAIA,qBAAa,WAAW;;IAKtB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM;IAQ3C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM;IAc7C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASxB,IAAI,KAAK,IAAI,MAAM,CAIlB;CACF"}

package/dist/neumaier-sum.js

@@ -0,0 +1,42 @@
+// A running sum with Neumaier's compensated summation (Neumaier 1974), the
+// algorithm of the sum() of CPython 3.12 for floats (Python/bltinmodule.c,
+// builtin_sum_impl), so a sum here equals Python's to the last bit: it starts
+// at 0, and it adds the compensation only when that is not 0 and is finite.
+export class NeumaierSum {
+    #sum = 0;
+    #compensation = 0;
+    // The sum() of the values, in their order.
+    static of(values) {
+        const sum = new NeumaierSum();
+        for (const value of values)
+            sum.add(value);
+        return sum.value;
+    }
+    // sum(values) / len(values) (ADR 0003). The values are read once, so a
+    // one-pass iterator gives its own count.
+    static mean(values) {
+        const sum = new NeumaierSum();
+        let count = 0;
+        for (const value of values) {
+            sum.add(value);
+            count++;
+        }
+        if (count === 0)
+            throw new RangeError('The mean of no value, for which Python raises ZeroDivisionError.');
+        return sum.value / count;
+    }
+    add(value) {
+        const total = this.#sum + value;
+        this.#compensation +=
+            Math.abs(this.#sum) >= Math.abs(value)
+                ? this.#sum - total + value
+                : value - total + this.#sum;
+        this.#sum = total;
+    }
+    get value() {
+        return this.#compensation !== 0 && Number.isFinite(this.#compensation)
+            ? this.#sum + this.#compensation
+            : this.#sum;
+    }
+}
+//# sourceMappingURL=neumaier-sum.js.map

package/dist/neumaier-sum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neumaier-sum.js","sourceRoot":"","sources":["../src/neumaier-sum.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,MAAM,OAAO,WAAW;IACtB,IAAI,GAAG,CAAC,CAAC;IACT,aAAa,GAAG,CAAC,CAAC;IAElB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAwB;QAChC,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,uEAAuE;IACvE,yCAAyC;IACzC,MAAM,CAAC,IAAI,CAAC,MAAwB;QAClC,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACf,KAAK,EAAE,CAAC;QACV,CAAC;QACD,IAAI,KAAK,KAAK,CAAC;YACb,MAAM,IAAI,UAAU,CAClB,kEAAkE,CACnE,CAAC;QACJ,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,KAAa;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,aAAa;YAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACpC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,KAAK;gBAC3B,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC;YACpE,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa;YAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAChB,CAAC;CACF"}

package/dist/python-space.d.ts

@@ -0,0 +1,2 @@
+export declare const PYTHON_SPACE: string;
+//# sourceMappingURL=python-space.d.ts.map

package/dist/python-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-space.d.ts","sourceRoot":"","sources":["../src/python-space.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,QAA4G,CAAC"}

package/dist/python-space.js

@@ -0,0 +1,6 @@
+// The characters of Python's str.isspace(), which are also its \s and the
+// separators of str.split(), as the body of a RegExp class (u flag): a probe
+// over every code point proved it equal to CPython 3.12's. It differs from
+// JavaScript's \s: it has U+001C to U+001F and lacks U+FEFF.
+export const PYTHON_SPACE = String.raw `\t\n\v\f\r\x1c-\x1f \x85\xa0\u{1680}\u{2000}-\u{200a}\u{2028}\u{2029}\u{202f}\u{205f}\u{3000}`;
+//# sourceMappingURL=python-space.js.map

package/dist/python-space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-space.js","sourceRoot":"","sources":["../src/python-space.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA,+FAA+F,CAAC"}

package/dist/python-word.d.ts

@@ -0,0 +1,2 @@
+export declare const PYTHON_WORD: string;
+//# sourceMappingURL=python-word.d.ts.map

package/dist/python-word.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-word.d.ts","sourceRoot":"","sources":["../src/python-word.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,QAA0B,CAAC"}

package/dist/python-word.js

@@ -0,0 +1,7 @@
+// The characters of Python's \w in a str pattern, as the body of a RegExp
+// class (u flag): letters, numbers and the underscore. The golden test proves
+// it equal to CPython 3.12's for each code point that Python's Unicode
+// database (15.0) assigns; Node knows characters of later Unicode versions,
+// which it reads as \w and Python 3.12 does not.
+export const PYTHON_WORD = String.raw `\p{L}\p{N}_`;
+//# sourceMappingURL=python-word.js.map

package/dist/python-word.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-word.js","sourceRoot":"","sources":["../src/python-word.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,uEAAuE;AACvE,4EAA4E;AAC5E,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAA,aAAa,CAAC"}

package/dist/to-json-parse-value.d.ts

@@ -0,0 +1,6 @@
+import type { JsonData } from './json-data.ts';
+export type JsonParseValue = null | boolean | number | string | JsonParseValue[] | {
+    [key: string]: JsonParseValue;
+};
+export declare function toJsonParseValue(value: JsonData): JsonParseValue;
+//# sourceMappingURL=to-json-parse-value.d.ts.map

package/dist/to-json-parse-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-json-parse-value.d.ts","sourceRoot":"","sources":["../src/to-json-parse-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,cAAc,EAAE,GAChB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,CAAC;AAStC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,CAQhE"}

package/dist/to-json-parse-value.js

@@ -0,0 +1,17 @@
+// The value that JSON.parse gives for the JSON text of a value, for code that
+// reads only plain JavaScript, such as a JSON Schema validator. It loses what
+// JsonData keeps: a dict becomes an object, so its integer-like keys move
+// first, and an int becomes the nearest number, so an int beyond 2^53 loses
+// digits. The int -0 gives 0, where JSON.parse gives -0: an int of Python has
+// no negative zero. Keep the JsonData, and convert it only where such code
+// reads it (ADR 0002).
+export function toJsonParseValue(value) {
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (Array.isArray(value))
+        return value.map(toJsonParseValue);
+    if (value instanceof Map)
+        return Object.fromEntries([...value].map(([key, item]) => [key, toJsonParseValue(item)]));
+    return value;
+}
+//# sourceMappingURL=to-json-parse-value.js.map

package/dist/to-json-parse-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-json-parse-value.js","sourceRoot":"","sources":["../src/to-json-parse-value.ts"],"names":[],"mappings":"AAWA,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,uBAAuB;AACvB,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,KAAK,YAAY,GAAG;QACtB,OAAO,MAAM,CAAC,WAAW,CACvB,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/D,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@zukhruf/python",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.3",
+  "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": {
+    "type": "git",
+    "url": "https://github.com/JanuaryLabs/zukhruf",
+    "directory": "packages/python"
+  },
+  "bugs": {
+    "url": "https://github.com/JanuaryLabs/zukhruf/issues"
+  },
+  "homepage": "https://github.com/JanuaryLabs/zukhruf/tree/main/packages/python#readme",
+  "keywords": [
+    "python",
+    "cpython",
+    "json",
+    "repr",
+    "sum"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@zukhruf/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "NOTICE",
+    "!dist/spec/**",
+    "!**/*.tsbuildinfo",
+    "!**/*.test.*"
+  ],
+  "dependencies": {
+    "jsonc-parser": "^3.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}