@json-schema-engine/formats 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henry Andrews
+
+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/README.md

@@ -0,0 +1,45 @@
+# @json-schema-engine/formats
+
+Format implementations for `@json-schema-engine/core`'s format-assertion vocabulary and `assertFormats` configuration — `date`, `date-time`, `time`, `duration`, `email`, `hostname`, `ipv4`, `ipv6`, `uri`, `uri-reference`, `uri-template`, `iri`, `iri-reference`, `json-pointer`, `relative-json-pointer`, `regex`, `uuid`, and their per-dialect tables. Add this package when a schema needs `format` to actually reject bad values rather than only annotate them. Needs `@json-schema-engine/core` installed alongside.
+
+## Install
+
+```sh
+npm install @json-schema-engine/formats @json-schema-engine/core
+```
+
+## Example
+
+```ts
+import assert from "node:assert";
+import { createEngine } from "@json-schema-engine/core";
+import { FORMATS_2020_12 } from "@json-schema-engine/formats";
+
+const engine = createEngine({
+  formats: FORMATS_2020_12,
+  assertFormats: true,
+});
+const uri = engine.registerSchema(
+  { type: "string", format: "date" },
+  "https://example.com/date",
+);
+
+assert.equal(engine.evaluate(uri, "2024-01-15").valid, true);
+assert.equal(engine.evaluate(uri, "not-a-date").valid, false);
+```
+
+## Status
+
+Version 0.0.1 is published for initial public feedback on both the functionality and the documentation. APIs may change before 1.0. [STATUS.md](https://github.com/handrews/json-schema-engine/blob/main/STATUS.md) is the authoritative statement of what is built and what is staged.
+
+## Documentation
+
+- [User guide](https://github.com/handrews/json-schema-engine/blob/main/docs/guide/index.md)
+- [Validation](https://github.com/handrews/json-schema-engine/blob/main/docs/guide/validation.md)
+- [Dialects](https://github.com/handrews/json-schema-engine/blob/main/docs/guide/dialects.md)
+- [Conformance](https://github.com/handrews/json-schema-engine/blob/main/docs/conformance.md)
+- [Repository](https://github.com/handrews/json-schema-engine)
+
+## License
+
+MIT

package/dist/idn.d.ts

@@ -0,0 +1,4 @@
+import type { FormatDefinition } from "@json-schema-engine/core";
+export declare const idnHostname: FormatDefinition;
+export declare const idnEmail: FormatDefinition;
+//# sourceMappingURL=idn.d.ts.map

package/dist/idn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idn.d.ts","sourceRoot":"","sources":["../src/idn.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAyNjE,eAAO,MAAM,WAAW,EAAE,gBAEzB,CAAC;AAkFF,eAAO,MAAM,QAAQ,EAAE,gBAEtB,CAAC"}

package/dist/idn.js

@@ -0,0 +1,304 @@
+// idn-hostname / idn-email (RFC 5890/5891/5892/5893, RFC 6531) — the
+// U-label side of the IDNA2008 machinery in idna.ts. Implemented from the
+// RFCs with Unicode data through ECMA-262's native \p{...} property
+// escapes plus small cited tables (DESIGN.md D15).
+import { decodePunycode, encodePunycode, isValidALabel, isValidIdnaLabel, } from "./idna.js";
+// ---------------------------------------------------------------------------
+// RFC 5892 derived-property approximation for U-label code points. PVALID's
+// backbone is letters/digits/marks in lowercase or caseless form; uppercase
+// (and anything case-unstable), symbols, punctuation, spaces, and controls
+// are DISALLOWED. Context characters (Appendix A) are admitted here and
+// judged by their rules in isValidIdnaLabel.
+const LETTER_DIGIT_MARK = /^[\p{Ll}\p{Lo}\p{Lm}\p{Mn}\p{Mc}\p{Nd}]$/u;
+const CONTEXT_CPS = new Set([
+    0x200c, // ZWNJ (CONTEXTJ, A.1)
+    0x200d, // ZWJ (CONTEXTJ, A.2)
+    0x00b7, // MIDDLE DOT (A.3)
+    0x0375, // GREEK KERAIA (A.4)
+    0x05f3, // HEBREW GERESH (A.5)
+    0x05f4, // HEBREW GERSHAYIM (A.6)
+    0x30fb, // KATAKANA MIDDLE DOT (A.7)
+]);
+// RFC 5892 §2.6 exceptions carrying PVALID despite their general
+// category (punctuation/symbol/number-letter): TIBETAN TSHEG, IDEOGRAPHIC
+// ZERO, the Sindhi Arabic signs. (ß/ς are Ll and need no exception here.)
+const PVALID_EXCEPTIONS = new Set([0x0f0b, 0x3007, 0x06fd, 0x06fe]);
+const allowedUnicodeCp = (cp) => {
+    if (PVALID_EXCEPTIONS.has(cp))
+        return true;
+    if (cp === 0x2d)
+        return true; // hyphen (LDH; placement rules elsewhere)
+    if (cp >= 0x30 && cp <= 0x39)
+        return true;
+    if (cp >= 0x61 && cp <= 0x7a)
+        return true;
+    if (cp < 0x80)
+        return false; // other ASCII: uppercase, symbols, dots…
+    if (CONTEXT_CPS.has(cp))
+        return true;
+    return LETTER_DIGIT_MARK.test(String.fromCodePoint(cp));
+};
+const R_RANGES = [
+    [0x05be, 0x05be],
+    [0x05c0, 0x05c0],
+    [0x05c3, 0x05c3],
+    [0x05c6, 0x05c6],
+    [0x05d0, 0x05f4],
+    [0x0608, 0x0608],
+    [0x200f, 0x200f],
+    [0xfb1d, 0xfb1d],
+    [0xfb1f, 0xfb28],
+    [0xfb2a, 0xfb4f],
+];
+const AL_RANGES = [
+    [0x0600, 0x0605],
+    [0x060b, 0x060b],
+    [0x060d, 0x060d],
+    [0x061b, 0x064a],
+    [0x066d, 0x066f],
+    [0x0671, 0x06d5],
+    [0x06e5, 0x06e6],
+    [0x06ee, 0x06ef],
+    [0x06fa, 0x0710],
+    [0x0712, 0x072f],
+    [0x074d, 0x07a5],
+    [0x07b1, 0x07b1],
+    [0x0780, 0x07a5],
+    [0xfb50, 0xfdfd],
+    [0xfe70, 0xfefc],
+];
+const AN_RANGES = [
+    [0x0660, 0x0669],
+    [0x066b, 0x066c],
+    [0x06dd, 0x06dd],
+];
+const inRanges = (cp, ranges) => ranges.some(([lo, hi]) => cp >= lo && cp <= hi);
+const NSM_RE = /^\p{Mn}$/u;
+const L_RE = /^[\p{L}\p{Nl}]$/u;
+function bidiClass(cp) {
+    if (inRanges(cp, AN_RANGES))
+        return "AN";
+    if (inRanges(cp, R_RANGES))
+        return "R";
+    if (inRanges(cp, AL_RANGES))
+        return "AL";
+    if (cp >= 0x30 && cp <= 0x39)
+        return "EN";
+    if (cp >= 0x06f0 && cp <= 0x06f9)
+        return "EN"; // extended Arabic-Indic: EN
+    const ch = String.fromCodePoint(cp);
+    if (NSM_RE.test(ch))
+        return "NSM";
+    if (L_RE.test(ch))
+        return "L";
+    return "N"; // ES/CS/ET/ON/BN for the rule's purposes
+}
+/**
+ * The RFC 5893 §2 Bidi rule for one label. Applied only when the whole
+ * domain name is a "Bidi domain name" (some label contains R/AL/AN).
+ */
+function satisfiesBidiRule(codepoints) {
+    const classes = codepoints.map(bidiClass);
+    const first = classes[0];
+    // Trailing NSMs attach to the preceding character (rules 3 and 6).
+    let lastIdx = classes.length - 1;
+    while (lastIdx > 0 && classes[lastIdx] === "NSM")
+        lastIdx--;
+    const last = classes[lastIdx];
+    if (first === "R" || first === "AL") {
+        // RTL label: rules 2-4.
+        const allowed = new Set(["R", "AL", "AN", "EN", "NSM", "N"]);
+        if (!classes.every((c) => allowed.has(c)))
+            return false;
+        if (!(last === "R" || last === "AL" || last === "AN" || last === "EN")) {
+            return false;
+        }
+        const hasEN = classes.includes("EN");
+        const hasAN = classes.includes("AN");
+        return !(hasEN && hasAN);
+    }
+    if (first === "L") {
+        // LTR label: rules 5-6.
+        const allowed = new Set(["L", "EN", "NSM", "N"]);
+        if (!classes.every((c) => allowed.has(c)))
+            return false;
+        return last === "L" || last === "EN";
+    }
+    return false; // rule 1: first character must be L, R, or AL
+}
+// ---------------------------------------------------------------------------
+const LDH_ASCII = /^[a-z0-9-]+$/i;
+/**
+ * Validate one label; returns its A-label (ACE) octet length, or null when
+ * invalid. RFC 5891 §4.2.3.1 hyphen restrictions apply to both forms.
+ */
+function labelAceLength(label) {
+    if (label.length === 0)
+        return null;
+    if (label.startsWith("-") || label.endsWith("-"))
+        return null;
+    // ASCII labels: plain LDH, or a full A-label when ACE-prefixed.
+    // eslint-disable-next-line no-control-regex -- explicit ASCII-range test
+    if (/^[\x00-\x7f]*$/u.test(label)) {
+        if (!LDH_ASCII.test(label))
+            return null;
+        if (label.length > 63)
+            return null;
+        if (/^..--/.test(label)) {
+            if (!/^xn--/i.test(label))
+                return null; // reserved LDH label
+            if (!isValidALabel(label))
+                return null;
+            // idn-hostname additionally screens the DECODED content's code
+            // points (an A-label hiding a DISALLOWED code point is invalid).
+            const decoded = decodePunycode(label.slice(4).toLowerCase());
+            if (!decoded?.every(allowedUnicodeCp))
+                return null;
+            return label.length;
+        }
+        return label.length;
+    }
+    // U-label. RFC 5891 §4.2.3: NFC form required.
+    if (label.normalize("NFC") !== label)
+        return null;
+    if (/^..--/u.test(label))
+        return null; // hyphens in positions 3-4
+    // eslint-disable-next-line @typescript-eslint/no-misused-spread -- code-point iteration is the IDNA unit
+    const codepoints = [...label].map((ch) => ch.codePointAt(0));
+    if (!codepoints.every(allowedUnicodeCp))
+        return null;
+    // Context rules + leading-mark + exceptions (RFC 5892; shared with the
+    // A-label path).
+    if (!isValidIdnaLabel(label, codepoints))
+        return null;
+    const ace = encodePunycode(codepoints);
+    const aceLength = ace.length + 4; // "xn--" prefix
+    if (aceLength > 63)
+        return null;
+    // The canonical ACE must decode back (guards encoder edge cases).
+    if (decodePunycode(ace) === undefined)
+        return null;
+    return aceLength;
+}
+function isIdnHostname(value) {
+    if (value.length === 0)
+        return false;
+    // IDNA label separators: the ideographic/fullwidth/halfwidth full stops
+    // separate labels exactly like ".".
+    const labels = value.split(/[.\u3002\uff0e\uff61]/u);
+    const decodedLabels = [];
+    let total = 0;
+    for (const label of labels) {
+        const aceLength = labelAceLength(label);
+        if (aceLength === null)
+            return false;
+        total += aceLength;
+        // Bidi checking needs the Unicode form: decode A-labels.
+        if (/^xn--/i.test(label)) {
+            decodedLabels.push(decodePunycode(label.slice(4).toLowerCase()) ?? []);
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-misused-spread -- code-point iteration is the IDNA unit
+            decodedLabels.push([...label].map((ch) => ch.codePointAt(0)));
+        }
+    }
+    if (total + labels.length - 1 > 253)
+        return false;
+    // RFC 5893 §1.4: a Bidi domain name (any RTL character anywhere) must
+    // satisfy the Bidi rule in EVERY label.
+    const isBidiName = decodedLabels.some((cps) => cps.some((cp) => {
+        const c = bidiClass(cp);
+        return c === "R" || c === "AL" || c === "AN";
+    }));
+    if (isBidiName) {
+        return decodedLabels.every((cps) => cps.length === 0 || satisfiesBidiRule(cps));
+    }
+    return true;
+}
+export const idnHostname = {
+    test: (value) => typeof value === "string" && isIdnHostname(value),
+};
+// ---------------------------------------------------------------------------
+// idn-email (RFC 6531): RFC 5321's mailbox grammar with `atext`/`qtextSMTP`
+// extended by UTF8-non-ascii — any non-ASCII code point is admitted in the
+// local part; the domain side is an idn-hostname (U- or A-labels) or an
+// address literal.
+const ATEXT_ASCII = /^[A-Za-z0-9!#$%&'*+\-/=?^_`{|}~]$/;
+const isExtendedAtext = (ch) => {
+    const cp = ch.codePointAt(0);
+    // A lone surrogate is not a Unicode scalar value — UTF8-non-ascii can
+    // never encode it (RFC 3629 forbids surrogate code points in UTF-8).
+    if (cp >= 0xd800 && cp <= 0xdfff && ch.length === 1)
+        return false;
+    return ATEXT_ASCII.test(ch) || cp >= 0x80;
+};
+function isIdnDotString(local) {
+    if (local.length === 0)
+        return false;
+    const atoms = local.split(".");
+    return atoms.every((atom) => 
+    // eslint-disable-next-line @typescript-eslint/no-misused-spread -- code-point iteration
+    atom.length > 0 && [...atom].every(isExtendedAtext));
+}
+function isIdnQuotedString(local) {
+    if (local.length < 2 || !local.startsWith('"') || !local.endsWith('"'))
+        return false;
+    const body = local.slice(1, -1);
+    for (let i = 0; i < body.length; i++) {
+        const ch = body[i];
+        if (ch === "\\") {
+            // quoted-pairSMTP: "\" + printable ASCII (RFC 6531 leaves this rule).
+            const next = body.charCodeAt(i + 1);
+            if (Number.isNaN(next) || next < 32 || next > 126)
+                return false;
+            i++;
+            continue;
+        }
+        const cp = ch.codePointAt(0);
+        // qtextSMTP (32-126 minus '"' and "\") or UTF8-non-ascii.
+        if (cp >= 0x80)
+            continue;
+        if (cp < 32 || cp > 126 || ch === '"')
+            return false;
+    }
+    return true;
+}
+// Address literals ([IPv4] / [IPv6:...]) are pure ASCII plumbing shared
+// with `email`; the idn-email suite exercises hostname domains, and a
+// literal domain simply defers to the same bracket grammar via the plain
+// email rules embedded here.
+const IPV4_LITERAL = /^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])(\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}$/;
+function isIdnEmail(value) {
+    let local;
+    let domain;
+    if (value.startsWith('"')) {
+        let i = 1;
+        while (i < value.length && value[i] !== '"') {
+            i += value[i] === "\\" ? 2 : 1;
+        }
+        if (i >= value.length || value[i + 1] !== "@")
+            return false;
+        local = value.slice(0, i + 1);
+        domain = value.slice(i + 2);
+        if (!isIdnQuotedString(local))
+            return false;
+    }
+    else {
+        const at = value.lastIndexOf("@");
+        if (at === -1)
+            return false;
+        local = value.slice(0, at);
+        domain = value.slice(at + 1);
+        if (!isIdnDotString(local))
+            return false;
+    }
+    if (domain.startsWith("[") && domain.endsWith("]")) {
+        const inner = domain.slice(1, -1);
+        return IPV4_LITERAL.test(inner);
+    }
+    return isIdnHostname(domain);
+}
+export const idnEmail = {
+    test: (value) => typeof value === "string" && isIdnEmail(value),
+};
+//# sourceMappingURL=idn.js.map

package/dist/idn.js.map

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

package/dist/idna.d.ts

@@ -0,0 +1,50 @@
+/**
+ * RFC 3492 §6.2 decoding procedure over the Bootstring-encoded remainder
+ * of an A-label (the part after the "xn--" ACE prefix, which is an IDNA
+ * layering concern handled by the caller, not by Bootstring itself).
+ * Returns the decoded code points, or undefined for any malformed input:
+ * a non-ASCII basic code point, an unrecognized digit, an incomplete
+ * trailing generalized variable-length integer, arithmetic overflow, or a
+ * resulting code point outside the valid Unicode scalar value range.
+ */
+export declare function decodePunycode(input: string): number[] | undefined;
+/**
+ * RFC 3492 §6.3 encoding procedure — the inverse of {@link decodePunycode}.
+ * RFC 5891 §4.4 requires an A-label to be the CANONICAL Punycode encoding
+ * of its decoded content: a non-canonical Bootstring digit sequence can
+ * decode successfully yet not be what encoding those code points would
+ * produce (e.g. an encoder-would-never-emit extra "--" run), so an A-label
+ * is only valid when decode-then-re-encode round-trips to the original
+ * (case-insensitive) text.
+ */
+export declare function encodePunycode(input: number[]): string;
+/**
+ * Applies the RFC 5891 §4.2.3.2 leading-mark rule and the RFC 5892
+ * Appendix A rules that the suite exercises to a decoded label's code
+ * points. `label` is the lowercase ASCII text of the label (the "xn--..."
+ * form); `codepoints` is its Punycode-decoded content.
+ */
+export declare function isValidIdnaLabel(label: string, codepoints: number[]): boolean;
+/**
+ * Validates one "xn--..." A-label per RFC 5890 §2.3.1/§2.3.2.1 (ACE
+ * prefix, case-insensitive) + RFC 5891 §4.4 (canonical Punycode) + the
+ * content rules above. §4.4 requires the ACE suffix to be the CANONICAL
+ * encoding of its decoded content — decode-then-re-encode must round-trip
+ * to the original suffix, not merely decode without error, since a
+ * non-canonical Bootstring digit sequence can be well-formed enough to
+ * decode yet isn't what an encoder would ever produce for that content.
+ *
+ * §2.3.1's "'--' in the third/fourth position is reserved for ACE labels"
+ * is, per the suite, a constraint on the label's ASCII text as a whole,
+ * not just its mandatory prefix occurrence: every valid A-label in the
+ * suite has exactly one "--" pair (the "xn--" prefix itself), while the
+ * sole invalid "contains '--' in the 3rd and 4th position" case has a
+ * second "--" later in the same label. A second reserved-looking marker
+ * elsewhere in the text is rejected on the same "R-LDH labels are
+ * reserved for ACE use" grounds as the prefix position itself — allowing
+ * it would let two different byte-for-byte-identical ACE-shaped
+ * substrings coexist in one label with no way to say which is "the"
+ * prefix.
+ */
+export declare function isValidALabel(label: string): boolean;
+//# sourceMappingURL=idna.d.ts.map

package/dist/idna.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idna.d.ts","sourceRoot":"","sources":["../src/idna.ts"],"names":[],"mappings":"AA8CA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAkDlE;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CA0CtD;AA6FD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAyE7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUpD"}