@maroonedog/luq 0.1.2-alpha → 2.0.0

package/dist/json-schema/flatten-schema.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinDeclaredPath = joinDeclaredPath;
+exports.collectRootNodes = collectRootNodes;
+exports.flattenSchema = flattenSchema;
+// ===========================================================================
+// L8  src/json-schema/flatten-schema.ts — the document as a list of DECLARED
+// PATHS.
+//
+// `properties` nests; Luq declares. `{properties:{user:{properties:{address:
+// {properties:{street:{}}}}}}}` becomes the declaration `user.address.street`,
+// and `items` becomes `tags[*]`, so an issue renders as `tags[2].name` with the
+// real index rather than as a cause hanging off a parent object.
+//
+// THE ROOT IS A DECLARABLE PATH — as of the stage-27 gate, and it is why
+// `{type:"object", properties:{…}, additionalProperties:false}` converts at all.
+// parse-field-path still rejects "" (a CHILD path may not be empty), but
+// compile-schema maps ROOT_PATH onto the EMPTY TEMPLATE — the shape a composite
+// branch's own rules have always used — so a root keyword becomes a rule.
+//
+// 1.x dropped every root keyword in silence (skipping the `path === ""` entry
+// and calling `.strict()`, which has no runtime effect); step 25 refused them
+// loudly instead. Neither validated them. Now:
+//   * `properties` still becomes one DECLARED PATH per key, so an issue reads
+//     `user.age`, not "somewhere inside the root object";
+//   * `required` still distributes to those children, so a missing property is
+//     reported AT the property;
+//   * `allOf` is still merged arm by arm, so its children are declared too;
+//   * `type` is dropped: fromJsonSchema is object-rooted by construction;
+//   * EVERY OTHER rule-bearing keyword becomes a rule on the root declaration.
+// `properties` is kept in that residual node, and only there: it contributes no
+// rule, but createStructuralContext reads `declaredSiblingKeys` from it, which
+// is what a root-level `additionalProperties: false` needs to know.
+// ===========================================================================
+const declared_child_keys_1 = require("../compile/declared-child-keys");
+const reserved_segment_1 = require("../path/reserved-segment");
+const collect_definitions_1 = require("./collect-definitions");
+const flatten_array_schema_1 = require("./flatten-array-schema");
+/** Deep enough for any hand-written schema; a recursive one stops sooner. */
+const MAX_NESTING_DEPTH = 32;
+/**
+ * Root keywords that produce NO rule on the root declaration: the ones the
+ * flattener distributes itself (and would otherwise apply twice), plus the ones
+ * that assert nothing anywhere. Every other keyword stays in the residual node
+ * and reaches expandSchemaRules like any other field's schema.
+ */
+const ROOT_KEYWORDS_WITHOUT_A_ROOT_RULE = Object.freeze([
+    "$schema",
+    "$id",
+    "$ref",
+    "$comment",
+    "definitions",
+    "$defs",
+    "title",
+    "description",
+    "default",
+    "examples",
+    "readOnly",
+    "writeOnly",
+    "properties",
+    "required",
+    "allOf",
+    "type",
+]);
+/** `[*]` trails its key; every other step is a `.`-joined property name. */
+function joinDeclaredPath(parent, step) {
+    if (step === flatten_array_schema_1.EACH_STEP)
+        return `${parent}${flatten_array_schema_1.EACH_STEP}`;
+    (0, reserved_segment_1.assertDeclarableKey)(step, parent === "" ? step : `${parent}.${step}`);
+    return parent === "" ? step : `${parent}.${step}`;
+}
+/** The root plus every arm of its `allOf`, transitively, all resolved. */
+function collectRootNodes(root) {
+    const nodes = [];
+    const pending = [root];
+    while (pending.length > 0 && nodes.length < MAX_NESTING_DEPTH) {
+        const next = pending.shift();
+        if (next === undefined)
+            break;
+        const node = (0, collect_definitions_1.resolveSchemaNode)(next, root);
+        nodes.push(node);
+        for (const arm of node.allOf ?? [])
+            pending.push(arm);
+    }
+    return Object.freeze(nodes);
+}
+/** True when the node says anything the root declaration has to carry. */
+function hasRootRuleKeyword(node) {
+    return Object.keys(node).some((keyword) => !ROOT_KEYWORDS_WITHOUT_A_ROOT_RULE.includes(keyword));
+}
+/** The root node MINUS the three keywords the flattener applies itself. A rest
+ *  destructuring, so the compiler and not a comment keeps the result a schema. */
+function dropDistributedKeywords(node) {
+    const { type, required, allOf, ...residual } = node;
+    return residual;
+}
+/** Children of the root, merged across the `allOf` arms, first arm winning. */
+function readRootChildren(nodes, readChildren) {
+    const merged = new Map();
+    for (const node of nodes) {
+        // Requiredness is read from the ROOT nodes themselves: readChildSchemas
+        // reports every child as not-required, because everywhere else a
+        // `required` array becomes a rule on the object that owns it. The root has
+        // no such object, so this is the one place it becomes child presence.
+        const required = node.required ?? [];
+        for (const child of readChildren(node)) {
+            const isRequired = required.includes(child.step);
+            const seen = merged.get(child.step);
+            if (seen === undefined) {
+                merged.set(child.step, { ...child, isRequired });
+                continue;
+            }
+            if (isRequired && !seen.isRequired) {
+                merged.set(child.step, { ...seen, isRequired: true });
+            }
+        }
+    }
+    return Object.freeze([...merged.values()]);
+}
+/**
+ * A `$ref` already on this branch is a RECURSIVE definition. Its declared paths
+ * are infinite and Luq declares finite ones, so the node's own rules are kept
+ * and its children are not expanded. objectRecursively is the plugin for that
+ * shape and it is not in the JSON Schema bag.
+ */
+function walkChild(parentPath, child, visitedRefs, depth, state) {
+    const path = joinDeclaredPath(parentPath, child.step);
+    const pointer = (0, collect_definitions_1.readRefPointer)(child.schema);
+    const node = (0, collect_definitions_1.resolveSchemaNode)(child.schema, state.root);
+    state.into.push({ path, schema: node, isRequired: child.isRequired });
+    const isRepeat = pointer !== undefined && visitedRefs.includes(pointer);
+    if (isRepeat || depth >= MAX_NESTING_DEPTH)
+        return;
+    const seen = pointer === undefined ? visitedRefs : [...visitedRefs, pointer];
+    for (const grandChild of state.readChildren(node)) {
+        walkChild(path, grandChild, seen, depth + 1, state);
+    }
+}
+/**
+ * The root declarations come FIRST, one per `allOf` arm that carries a rule of
+ * its own, so two arms cannot silently overwrite each other's `minProperties`.
+ * `isRequired` is false: the root is always present (create-validator refuses a
+ * missing root before the plan runs), and a presence rule there would only add
+ * a second answer to a question already settled.
+ */
+function flattenSchema(root, readChildren) {
+    const nodes = collectRootNodes(root);
+    const state = { root, readChildren, into: [] };
+    for (const node of nodes) {
+        if (!hasRootRuleKeyword(node))
+            continue;
+        state.into.push({
+            path: declared_child_keys_1.ROOT_PATH,
+            schema: dropDistributedKeywords(node),
+            isRequired: false,
+        });
+    }
+    for (const child of readRootChildren(nodes, readChildren)) {
+        walkChild("", child, Object.freeze([]), 0, state);
+    }
+    return Object.freeze(state.into);
+}

package/dist/json-schema/flatten-schema.mjs

@@ -0,0 +1,157 @@
+// ===========================================================================
+// L8  src/json-schema/flatten-schema.ts — the document as a list of DECLARED
+// PATHS.
+//
+// `properties` nests; Luq declares. `{properties:{user:{properties:{address:
+// {properties:{street:{}}}}}}}` becomes the declaration `user.address.street`,
+// and `items` becomes `tags[*]`, so an issue renders as `tags[2].name` with the
+// real index rather than as a cause hanging off a parent object.
+//
+// THE ROOT IS A DECLARABLE PATH — as of the stage-27 gate, and it is why
+// `{type:"object", properties:{…}, additionalProperties:false}` converts at all.
+// parse-field-path still rejects "" (a CHILD path may not be empty), but
+// compile-schema maps ROOT_PATH onto the EMPTY TEMPLATE — the shape a composite
+// branch's own rules have always used — so a root keyword becomes a rule.
+//
+// 1.x dropped every root keyword in silence (skipping the `path === ""` entry
+// and calling `.strict()`, which has no runtime effect); step 25 refused them
+// loudly instead. Neither validated them. Now:
+//   * `properties` still becomes one DECLARED PATH per key, so an issue reads
+//     `user.age`, not "somewhere inside the root object";
+//   * `required` still distributes to those children, so a missing property is
+//     reported AT the property;
+//   * `allOf` is still merged arm by arm, so its children are declared too;
+//   * `type` is dropped: fromJsonSchema is object-rooted by construction;
+//   * EVERY OTHER rule-bearing keyword becomes a rule on the root declaration.
+// `properties` is kept in that residual node, and only there: it contributes no
+// rule, but createStructuralContext reads `declaredSiblingKeys` from it, which
+// is what a root-level `additionalProperties: false` needs to know.
+// ===========================================================================
+import { ROOT_PATH } from "../compile/declared-child-keys.mjs";
+import { assertDeclarableKey } from "../path/reserved-segment.mjs";
+import { resolveSchemaNode, readRefPointer } from "./collect-definitions.mjs";
+import { EACH_STEP } from "./flatten-array-schema.mjs";
+/** Deep enough for any hand-written schema; a recursive one stops sooner. */
+const MAX_NESTING_DEPTH = 32;
+/**
+ * Root keywords that produce NO rule on the root declaration: the ones the
+ * flattener distributes itself (and would otherwise apply twice), plus the ones
+ * that assert nothing anywhere. Every other keyword stays in the residual node
+ * and reaches expandSchemaRules like any other field's schema.
+ */
+const ROOT_KEYWORDS_WITHOUT_A_ROOT_RULE = Object.freeze([
+    "$schema",
+    "$id",
+    "$ref",
+    "$comment",
+    "definitions",
+    "$defs",
+    "title",
+    "description",
+    "default",
+    "examples",
+    "readOnly",
+    "writeOnly",
+    "properties",
+    "required",
+    "allOf",
+    "type",
+]);
+/** `[*]` trails its key; every other step is a `.`-joined property name. */
+export function joinDeclaredPath(parent, step) {
+    if (step === EACH_STEP)
+        return `${parent}${EACH_STEP}`;
+    assertDeclarableKey(step, parent === "" ? step : `${parent}.${step}`);
+    return parent === "" ? step : `${parent}.${step}`;
+}
+/** The root plus every arm of its `allOf`, transitively, all resolved. */
+export function collectRootNodes(root) {
+    const nodes = [];
+    const pending = [root];
+    while (pending.length > 0 && nodes.length < MAX_NESTING_DEPTH) {
+        const next = pending.shift();
+        if (next === undefined)
+            break;
+        const node = resolveSchemaNode(next, root);
+        nodes.push(node);
+        for (const arm of node.allOf ?? [])
+            pending.push(arm);
+    }
+    return Object.freeze(nodes);
+}
+/** True when the node says anything the root declaration has to carry. */
+function hasRootRuleKeyword(node) {
+    return Object.keys(node).some((keyword) => !ROOT_KEYWORDS_WITHOUT_A_ROOT_RULE.includes(keyword));
+}
+/** The root node MINUS the three keywords the flattener applies itself. A rest
+ *  destructuring, so the compiler and not a comment keeps the result a schema. */
+function dropDistributedKeywords(node) {
+    const { type, required, allOf, ...residual } = node;
+    return residual;
+}
+/** Children of the root, merged across the `allOf` arms, first arm winning. */
+function readRootChildren(nodes, readChildren) {
+    const merged = new Map();
+    for (const node of nodes) {
+        // Requiredness is read from the ROOT nodes themselves: readChildSchemas
+        // reports every child as not-required, because everywhere else a
+        // `required` array becomes a rule on the object that owns it. The root has
+        // no such object, so this is the one place it becomes child presence.
+        const required = node.required ?? [];
+        for (const child of readChildren(node)) {
+            const isRequired = required.includes(child.step);
+            const seen = merged.get(child.step);
+            if (seen === undefined) {
+                merged.set(child.step, { ...child, isRequired });
+                continue;
+            }
+            if (isRequired && !seen.isRequired) {
+                merged.set(child.step, { ...seen, isRequired: true });
+            }
+        }
+    }
+    return Object.freeze([...merged.values()]);
+}
+/**
+ * A `$ref` already on this branch is a RECURSIVE definition. Its declared paths
+ * are infinite and Luq declares finite ones, so the node's own rules are kept
+ * and its children are not expanded. objectRecursively is the plugin for that
+ * shape and it is not in the JSON Schema bag.
+ */
+function walkChild(parentPath, child, visitedRefs, depth, state) {
+    const path = joinDeclaredPath(parentPath, child.step);
+    const pointer = readRefPointer(child.schema);
+    const node = resolveSchemaNode(child.schema, state.root);
+    state.into.push({ path, schema: node, isRequired: child.isRequired });
+    const isRepeat = pointer !== undefined && visitedRefs.includes(pointer);
+    if (isRepeat || depth >= MAX_NESTING_DEPTH)
+        return;
+    const seen = pointer === undefined ? visitedRefs : [...visitedRefs, pointer];
+    for (const grandChild of state.readChildren(node)) {
+        walkChild(path, grandChild, seen, depth + 1, state);
+    }
+}
+/**
+ * The root declarations come FIRST, one per `allOf` arm that carries a rule of
+ * its own, so two arms cannot silently overwrite each other's `minProperties`.
+ * `isRequired` is false: the root is always present (create-validator refuses a
+ * missing root before the plan runs), and a presence rule there would only add
+ * a second answer to a question already settled.
+ */
+export function flattenSchema(root, readChildren) {
+    const nodes = collectRootNodes(root);
+    const state = { root, readChildren, into: [] };
+    for (const node of nodes) {
+        if (!hasRootRuleKeyword(node))
+            continue;
+        state.into.push({
+            path: ROOT_PATH,
+            schema: dropDistributedKeywords(node),
+            isRequired: false,
+        });
+    }
+    for (const child of readRootChildren(nodes, readChildren)) {
+        walkChild("", child, Object.freeze([]), 0, state);
+    }
+    return Object.freeze(state.into);
+}

package/dist/json-schema/format-map.d.ts

@@ -0,0 +1,20 @@
+import type { BindableMethod, BoundMethod } from "./json-schema-bag.types";
+import type { BindingForMethod, UnsupportedKeyword } from "./keyword-binding.types";
+/** The seventeen Draft-07 §7.3 names, plus the three 1.x shipped besides. */
+export type Draft07Format = "date-time" | "date" | "time" | "duration" | "email" | "idn-email" | "hostname" | "idn-hostname" | "ipv4" | "ipv6" | "uri" | "uri-reference" | "iri" | "iri-reference" | "uri-template" | "json-pointer" | "relative-json-pointer" | "regex" | "url" | "uuid";
+type StringMethod = BindableMethod<"string"> & BoundMethod<"string">;
+/** A format carries no value of its own: the NAME is the whole instruction. */
+export type FormatBinding = {
+    [M in StringMethod]: BindingForMethod<"string", M, "format">;
+}[StringMethod];
+export type FormatHandling = FormatBinding | UnsupportedKeyword;
+export declare const draft07FormatMap: Record<Draft07Format, FormatHandling>;
+/** Every name the table decides on, supported or not. No assertion needed. */
+export declare function listFormatNames(): readonly Draft07Format[];
+/**
+ * `undefined` means "this name is not in the table", which Draft-07 §7.2 says
+ * to treat as an annotation. It does NOT mean "unsupported": an unsupported
+ * format is in the table and says so.
+ */
+export declare function findFormatHandling(format: string): FormatHandling | undefined;
+export {};

package/dist/json-schema/format-map.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.draft07FormatMap = void 0;
+exports.listFormatNames = listFormatNames;
+exports.findFormatHandling = findFormatHandling;
+// ===========================================================================
+// L8  src/json-schema/format-map.ts — THE format table. There is exactly one.
+//
+// 1.x shipped three (jsonSchema/format-validators.ts, the stringXxx plugins,
+// and an inline switch in error-generation.ts) and they disagreed: `email` had
+// three different regexes, `uuid` accepted v1-v5 in one and v1-v8 in another,
+// `date-time` rejected "+09:00" in one and accepted it in another, and an
+// UNKNOWN format passed in one and failed in another. This file holds no
+// grammar of its own — every entry points at the plugin that owns the grammar,
+// so there is one regex per format in src and nothing here to drift from it.
+//
+// Draft-07 §7.2: `format` is an annotation by default, so a name that is not
+// in this table is NOT an error. findFormatHandling returns undefined and the
+// converter adds no rule — the behaviour 1.x's validateFormat had, and the one
+// its error generator contradicted.
+// ===========================================================================
+const bind_keyword_1 = require("./bind-keyword");
+const string_date_1 = require("../plugins/string-date");
+const string_datetime_1 = require("../plugins/string-datetime");
+const string_time_1 = require("../plugins/string-time");
+const string_duration_1 = require("../plugins/string-duration");
+const string_email_1 = require("../plugins/string-email");
+const string_idn_email_1 = require("../plugins/string-idn-email");
+const string_hostname_1 = require("../plugins/string-hostname");
+const string_idn_hostname_1 = require("../plugins/string-idn-hostname");
+const string_regex_1 = require("../plugins/string-regex");
+const string_uri_reference_1 = require("../plugins/string-uri-reference");
+const string_ipv4_1 = require("../plugins/string-ipv4");
+const string_ipv6_1 = require("../plugins/string-ipv6");
+const string_url_1 = require("../plugins/string-url");
+const string_iri_1 = require("../plugins/string-iri");
+const string_iri_reference_1 = require("../plugins/string-iri-reference");
+const string_uri_template_1 = require("../plugins/string-uri-template");
+const string_json_pointer_1 = require("../plugins/string-json-pointer");
+const string_relative_json_pointer_1 = require("../plugins/string-relative-json-pointer");
+const uuid_1 = require("../plugins/uuid");
+const noArguments = (_keyword) => [];
+exports.draft07FormatMap = {
+    "date-time": (0, bind_keyword_1.bindKeyword)("string", "datetime", string_datetime_1.stringDatetimePlugin, noArguments),
+    date: (0, bind_keyword_1.bindKeyword)("string", "date", string_date_1.stringDatePlugin, noArguments),
+    time: (0, bind_keyword_1.bindKeyword)("string", "time", string_time_1.stringTimePlugin, noArguments),
+    duration: (0, bind_keyword_1.bindKeyword)("string", "duration", string_duration_1.stringDurationPlugin, noArguments),
+    email: (0, bind_keyword_1.bindKeyword)("string", "email", string_email_1.stringEmailPlugin, noArguments),
+    hostname: (0, bind_keyword_1.bindKeyword)("string", "hostname", string_hostname_1.stringHostnamePlugin, noArguments),
+    ipv4: (0, bind_keyword_1.bindKeyword)("string", "ipv4", string_ipv4_1.stringIpv4Plugin, noArguments),
+    ipv6: (0, bind_keyword_1.bindKeyword)("string", "ipv6", string_ipv6_1.stringIpv6Plugin, noArguments),
+    // `uri` and `url` share one plugin on purpose: string-url's header names
+    // itself the Draft-07 `uri` format's single home, and it parses with the
+    // platform URL constructor rather than a second grammar.
+    uri: (0, bind_keyword_1.bindKeyword)("string", "url", string_url_1.stringUrlPlugin, noArguments),
+    url: (0, bind_keyword_1.bindKeyword)("string", "url", string_url_1.stringUrlPlugin, noArguments),
+    iri: (0, bind_keyword_1.bindKeyword)("string", "iri", string_iri_1.stringIriPlugin, noArguments),
+    "iri-reference": (0, bind_keyword_1.bindKeyword)("string", "iriReference", string_iri_reference_1.stringIriReferencePlugin, noArguments),
+    "uri-template": (0, bind_keyword_1.bindKeyword)("string", "uriTemplate", string_uri_template_1.stringUriTemplatePlugin, noArguments),
+    "json-pointer": (0, bind_keyword_1.bindKeyword)("string", "jsonPointer", string_json_pointer_1.stringJsonPointerPlugin, noArguments),
+    "relative-json-pointer": (0, bind_keyword_1.bindKeyword)("string", "relativeJsonPointer", string_relative_json_pointer_1.stringRelativeJsonPointerPlugin, noArguments),
+    uuid: (0, bind_keyword_1.bindKeyword)("string", "uuid", uuid_1.uuidPlugin, noArguments),
+    // The four names this table declared OUT OF SCOPE until step 27. Each threw
+    // UnsupportedKeywordError at BUILD time, so a schema naming one produced no
+    // validator at all — 24 cases of the official draft7 corpus. They are bound
+    // now; each plugin header states exactly what its grammar does and does not
+    // check, which is the honest form of "supported".
+    "idn-email": (0, bind_keyword_1.bindKeyword)("string", "idnEmail", string_idn_email_1.stringIdnEmailPlugin, noArguments),
+    "idn-hostname": (0, bind_keyword_1.bindKeyword)("string", "idnHostname", string_idn_hostname_1.stringIdnHostnamePlugin, noArguments),
+    // NOT stringIriReference: an IRI-reference is a strict SUPERSET of a
+    // URI-reference, so binding it here would pass values the format forbids.
+    "uri-reference": (0, bind_keyword_1.bindKeyword)("string", "uriReference", string_uri_reference_1.stringUriReferencePlugin, noArguments),
+    regex: (0, bind_keyword_1.bindKeyword)("string", "regex", string_regex_1.stringRegexPlugin, noArguments),
+};
+function isKnownFormat(format) {
+    return Object.prototype.hasOwnProperty.call(exports.draft07FormatMap, format);
+}
+/** Every name the table decides on, supported or not. No assertion needed. */
+function listFormatNames() {
+    return Object.keys(exports.draft07FormatMap).filter(isKnownFormat);
+}
+/**
+ * `undefined` means "this name is not in the table", which Draft-07 §7.2 says
+ * to treat as an annotation. It does NOT mean "unsupported": an unsupported
+ * format is in the table and says so.
+ */
+function findFormatHandling(format) {
+    return isKnownFormat(format) ? exports.draft07FormatMap[format] : undefined;
+}

package/dist/json-schema/format-map.mjs

@@ -0,0 +1,84 @@
+// ===========================================================================
+// L8  src/json-schema/format-map.ts — THE format table. There is exactly one.
+//
+// 1.x shipped three (jsonSchema/format-validators.ts, the stringXxx plugins,
+// and an inline switch in error-generation.ts) and they disagreed: `email` had
+// three different regexes, `uuid` accepted v1-v5 in one and v1-v8 in another,
+// `date-time` rejected "+09:00" in one and accepted it in another, and an
+// UNKNOWN format passed in one and failed in another. This file holds no
+// grammar of its own — every entry points at the plugin that owns the grammar,
+// so there is one regex per format in src and nothing here to drift from it.
+//
+// Draft-07 §7.2: `format` is an annotation by default, so a name that is not
+// in this table is NOT an error. findFormatHandling returns undefined and the
+// converter adds no rule — the behaviour 1.x's validateFormat had, and the one
+// its error generator contradicted.
+// ===========================================================================
+import { bindKeyword } from "./bind-keyword.mjs";
+import { stringDatePlugin } from "../plugins/string-date/index.mjs";
+import { stringDatetimePlugin } from "../plugins/string-datetime/index.mjs";
+import { stringTimePlugin } from "../plugins/string-time/index.mjs";
+import { stringDurationPlugin } from "../plugins/string-duration/index.mjs";
+import { stringEmailPlugin } from "../plugins/string-email/index.mjs";
+import { stringIdnEmailPlugin } from "../plugins/string-idn-email/index.mjs";
+import { stringHostnamePlugin } from "../plugins/string-hostname/index.mjs";
+import { stringIdnHostnamePlugin } from "../plugins/string-idn-hostname/index.mjs";
+import { stringRegexPlugin } from "../plugins/string-regex/index.mjs";
+import { stringUriReferencePlugin } from "../plugins/string-uri-reference/index.mjs";
+import { stringIpv4Plugin } from "../plugins/string-ipv4/index.mjs";
+import { stringIpv6Plugin } from "../plugins/string-ipv6/index.mjs";
+import { stringUrlPlugin } from "../plugins/string-url/index.mjs";
+import { stringIriPlugin } from "../plugins/string-iri/index.mjs";
+import { stringIriReferencePlugin } from "../plugins/string-iri-reference/index.mjs";
+import { stringUriTemplatePlugin } from "../plugins/string-uri-template/index.mjs";
+import { stringJsonPointerPlugin } from "../plugins/string-json-pointer/index.mjs";
+import { stringRelativeJsonPointerPlugin } from "../plugins/string-relative-json-pointer/index.mjs";
+import { uuidPlugin } from "../plugins/uuid/index.mjs";
+const noArguments = (_keyword) => [];
+export const draft07FormatMap = {
+    "date-time": bindKeyword("string", "datetime", stringDatetimePlugin, noArguments),
+    date: bindKeyword("string", "date", stringDatePlugin, noArguments),
+    time: bindKeyword("string", "time", stringTimePlugin, noArguments),
+    duration: bindKeyword("string", "duration", stringDurationPlugin, noArguments),
+    email: bindKeyword("string", "email", stringEmailPlugin, noArguments),
+    hostname: bindKeyword("string", "hostname", stringHostnamePlugin, noArguments),
+    ipv4: bindKeyword("string", "ipv4", stringIpv4Plugin, noArguments),
+    ipv6: bindKeyword("string", "ipv6", stringIpv6Plugin, noArguments),
+    // `uri` and `url` share one plugin on purpose: string-url's header names
+    // itself the Draft-07 `uri` format's single home, and it parses with the
+    // platform URL constructor rather than a second grammar.
+    uri: bindKeyword("string", "url", stringUrlPlugin, noArguments),
+    url: bindKeyword("string", "url", stringUrlPlugin, noArguments),
+    iri: bindKeyword("string", "iri", stringIriPlugin, noArguments),
+    "iri-reference": bindKeyword("string", "iriReference", stringIriReferencePlugin, noArguments),
+    "uri-template": bindKeyword("string", "uriTemplate", stringUriTemplatePlugin, noArguments),
+    "json-pointer": bindKeyword("string", "jsonPointer", stringJsonPointerPlugin, noArguments),
+    "relative-json-pointer": bindKeyword("string", "relativeJsonPointer", stringRelativeJsonPointerPlugin, noArguments),
+    uuid: bindKeyword("string", "uuid", uuidPlugin, noArguments),
+    // The four names this table declared OUT OF SCOPE until step 27. Each threw
+    // UnsupportedKeywordError at BUILD time, so a schema naming one produced no
+    // validator at all — 24 cases of the official draft7 corpus. They are bound
+    // now; each plugin header states exactly what its grammar does and does not
+    // check, which is the honest form of "supported".
+    "idn-email": bindKeyword("string", "idnEmail", stringIdnEmailPlugin, noArguments),
+    "idn-hostname": bindKeyword("string", "idnHostname", stringIdnHostnamePlugin, noArguments),
+    // NOT stringIriReference: an IRI-reference is a strict SUPERSET of a
+    // URI-reference, so binding it here would pass values the format forbids.
+    "uri-reference": bindKeyword("string", "uriReference", stringUriReferencePlugin, noArguments),
+    regex: bindKeyword("string", "regex", stringRegexPlugin, noArguments),
+};
+function isKnownFormat(format) {
+    return Object.prototype.hasOwnProperty.call(draft07FormatMap, format);
+}
+/** Every name the table decides on, supported or not. No assertion needed. */
+export function listFormatNames() {
+    return Object.keys(draft07FormatMap).filter(isKnownFormat);
+}
+/**
+ * `undefined` means "this name is not in the table", which Draft-07 §7.2 says
+ * to treat as an annotation. It does NOT mean "unsupported": an unsupported
+ * format is in the table and says so.
+ */
+export function findFormatHandling(format) {
+    return isKnownFormat(format) ? draft07FormatMap[format] : undefined;
+}

package/dist/json-schema/index.d.ts

@@ -0,0 +1,19 @@
+export { NotASchemaError, buildFieldEntries, buildFromSchema, fromJsonSchema, } from "./build-from-schema";
+export { DEFINITION_CONTAINERS, collectDefinitionNames, isDefinitionContainer, readRefPointer, resolveSchemaNode, toSchemaObject, } from "./collect-definitions";
+export { flattenSchema, joinDeclaredPath } from "./flatten-schema";
+export type { ReadChildSchemas, SchemaFieldDeclaration, } from "./flatten-schema";
+export { STRUCTURAL_EXPANSIONS, expandSchemaRules, isStructuralKeyword, readChildSchemas, } from "./schema-to-declarations";
+export { collectSubSchemaRules, toSchemaBranch, } from "./collect-sub-schema-rules";
+export { createStructuralContext } from "./create-structural-context";
+export { declareRequiredProperties } from "./declare-required-properties";
+export { declarePresenceRules } from "./declare-presence";
+export type { PresenceDeclaration } from "./declare-presence";
+export type { ConversionSeed } from "./create-structural-context";
+export type { ChildSchema, StructuralConsumer, StructuralContext, StructuralExpansion, StructuralExpansionTable, StructuralKeyword, } from "./structural-expansion.types";
+export { RefResolutionError, isResolvableRef, resolveRef } from "./resolve-ref";
+export { UnsupportedKeywordError } from "./unsupported-keyword-error";
+export { isDraft07Schema, isSchemaObject } from "./draft07.types";
+export type { Draft07Schema, Draft07SchemaObject, Draft07TypeKeyword, } from "./draft07.types";
+export { assertKeywordSupported, countKeywordHandlings, findKeywordHandling, isDraft07Keyword, listBoundPluginNames, listDraft07Keywords, } from "./keyword-map";
+export { findFormatHandling, listFormatNames } from "./format-map";
+export type { JsonSchemaBag } from "./json-schema-bag.types";

package/dist/json-schema/index.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listFormatNames = exports.findFormatHandling = exports.listDraft07Keywords = exports.listBoundPluginNames = exports.isDraft07Keyword = exports.findKeywordHandling = exports.countKeywordHandlings = exports.assertKeywordSupported = exports.isSchemaObject = exports.isDraft07Schema = exports.UnsupportedKeywordError = exports.resolveRef = exports.isResolvableRef = exports.RefResolutionError = exports.declarePresenceRules = exports.declareRequiredProperties = exports.createStructuralContext = exports.toSchemaBranch = exports.collectSubSchemaRules = exports.readChildSchemas = exports.isStructuralKeyword = exports.expandSchemaRules = exports.STRUCTURAL_EXPANSIONS = exports.joinDeclaredPath = exports.flattenSchema = exports.toSchemaObject = exports.resolveSchemaNode = exports.readRefPointer = exports.isDefinitionContainer = exports.collectDefinitionNames = exports.DEFINITION_CONTAINERS = exports.fromJsonSchema = exports.buildFromSchema = exports.buildFieldEntries = exports.NotASchemaError = void 0;
+// ===========================================================================
+// L8  src/json-schema/index.ts — re-exports only. Nothing is defined here.
+//
+// This is the surface step 26's two bundle plugins are written against, and
+// the only json-schema surface anything outside src/json-schema/ may reach.
+// ===========================================================================
+var build_from_schema_1 = require("./build-from-schema");
+Object.defineProperty(exports, "NotASchemaError", { enumerable: true, get: function () { return build_from_schema_1.NotASchemaError; } });
+Object.defineProperty(exports, "buildFieldEntries", { enumerable: true, get: function () { return build_from_schema_1.buildFieldEntries; } });
+Object.defineProperty(exports, "buildFromSchema", { enumerable: true, get: function () { return build_from_schema_1.buildFromSchema; } });
+Object.defineProperty(exports, "fromJsonSchema", { enumerable: true, get: function () { return build_from_schema_1.fromJsonSchema; } });
+var collect_definitions_1 = require("./collect-definitions");
+Object.defineProperty(exports, "DEFINITION_CONTAINERS", { enumerable: true, get: function () { return collect_definitions_1.DEFINITION_CONTAINERS; } });
+Object.defineProperty(exports, "collectDefinitionNames", { enumerable: true, get: function () { return collect_definitions_1.collectDefinitionNames; } });
+Object.defineProperty(exports, "isDefinitionContainer", { enumerable: true, get: function () { return collect_definitions_1.isDefinitionContainer; } });
+Object.defineProperty(exports, "readRefPointer", { enumerable: true, get: function () { return collect_definitions_1.readRefPointer; } });
+Object.defineProperty(exports, "resolveSchemaNode", { enumerable: true, get: function () { return collect_definitions_1.resolveSchemaNode; } });
+Object.defineProperty(exports, "toSchemaObject", { enumerable: true, get: function () { return collect_definitions_1.toSchemaObject; } });
+var flatten_schema_1 = require("./flatten-schema");
+Object.defineProperty(exports, "flattenSchema", { enumerable: true, get: function () { return flatten_schema_1.flattenSchema; } });
+Object.defineProperty(exports, "joinDeclaredPath", { enumerable: true, get: function () { return flatten_schema_1.joinDeclaredPath; } });
+var schema_to_declarations_1 = require("./schema-to-declarations");
+Object.defineProperty(exports, "STRUCTURAL_EXPANSIONS", { enumerable: true, get: function () { return schema_to_declarations_1.STRUCTURAL_EXPANSIONS; } });
+Object.defineProperty(exports, "expandSchemaRules", { enumerable: true, get: function () { return schema_to_declarations_1.expandSchemaRules; } });
+Object.defineProperty(exports, "isStructuralKeyword", { enumerable: true, get: function () { return schema_to_declarations_1.isStructuralKeyword; } });
+Object.defineProperty(exports, "readChildSchemas", { enumerable: true, get: function () { return schema_to_declarations_1.readChildSchemas; } });
+var collect_sub_schema_rules_1 = require("./collect-sub-schema-rules");
+Object.defineProperty(exports, "collectSubSchemaRules", { enumerable: true, get: function () { return collect_sub_schema_rules_1.collectSubSchemaRules; } });
+Object.defineProperty(exports, "toSchemaBranch", { enumerable: true, get: function () { return collect_sub_schema_rules_1.toSchemaBranch; } });
+var create_structural_context_1 = require("./create-structural-context");
+Object.defineProperty(exports, "createStructuralContext", { enumerable: true, get: function () { return create_structural_context_1.createStructuralContext; } });
+var declare_required_properties_1 = require("./declare-required-properties");
+Object.defineProperty(exports, "declareRequiredProperties", { enumerable: true, get: function () { return declare_required_properties_1.declareRequiredProperties; } });
+var declare_presence_1 = require("./declare-presence");
+Object.defineProperty(exports, "declarePresenceRules", { enumerable: true, get: function () { return declare_presence_1.declarePresenceRules; } });
+var resolve_ref_1 = require("./resolve-ref");
+Object.defineProperty(exports, "RefResolutionError", { enumerable: true, get: function () { return resolve_ref_1.RefResolutionError; } });
+Object.defineProperty(exports, "isResolvableRef", { enumerable: true, get: function () { return resolve_ref_1.isResolvableRef; } });
+Object.defineProperty(exports, "resolveRef", { enumerable: true, get: function () { return resolve_ref_1.resolveRef; } });
+var unsupported_keyword_error_1 = require("./unsupported-keyword-error");
+Object.defineProperty(exports, "UnsupportedKeywordError", { enumerable: true, get: function () { return unsupported_keyword_error_1.UnsupportedKeywordError; } });
+var draft07_types_1 = require("./draft07.types");
+Object.defineProperty(exports, "isDraft07Schema", { enumerable: true, get: function () { return draft07_types_1.isDraft07Schema; } });
+Object.defineProperty(exports, "isSchemaObject", { enumerable: true, get: function () { return draft07_types_1.isSchemaObject; } });
+var keyword_map_1 = require("./keyword-map");
+Object.defineProperty(exports, "assertKeywordSupported", { enumerable: true, get: function () { return keyword_map_1.assertKeywordSupported; } });
+Object.defineProperty(exports, "countKeywordHandlings", { enumerable: true, get: function () { return keyword_map_1.countKeywordHandlings; } });
+Object.defineProperty(exports, "findKeywordHandling", { enumerable: true, get: function () { return keyword_map_1.findKeywordHandling; } });
+Object.defineProperty(exports, "isDraft07Keyword", { enumerable: true, get: function () { return keyword_map_1.isDraft07Keyword; } });
+Object.defineProperty(exports, "listBoundPluginNames", { enumerable: true, get: function () { return keyword_map_1.listBoundPluginNames; } });
+Object.defineProperty(exports, "listDraft07Keywords", { enumerable: true, get: function () { return keyword_map_1.listDraft07Keywords; } });
+var format_map_1 = require("./format-map");
+Object.defineProperty(exports, "findFormatHandling", { enumerable: true, get: function () { return format_map_1.findFormatHandling; } });
+Object.defineProperty(exports, "listFormatNames", { enumerable: true, get: function () { return format_map_1.listFormatNames; } });

package/dist/json-schema/index.mjs

@@ -0,0 +1,19 @@
+// ===========================================================================
+// L8  src/json-schema/index.ts — re-exports only. Nothing is defined here.
+//
+// This is the surface step 26's two bundle plugins are written against, and
+// the only json-schema surface anything outside src/json-schema/ may reach.
+// ===========================================================================
+export { NotASchemaError, buildFieldEntries, buildFromSchema, fromJsonSchema, } from "./build-from-schema.mjs";
+export { DEFINITION_CONTAINERS, collectDefinitionNames, isDefinitionContainer, readRefPointer, resolveSchemaNode, toSchemaObject, } from "./collect-definitions.mjs";
+export { flattenSchema, joinDeclaredPath } from "./flatten-schema.mjs";
+export { STRUCTURAL_EXPANSIONS, expandSchemaRules, isStructuralKeyword, readChildSchemas, } from "./schema-to-declarations.mjs";
+export { collectSubSchemaRules, toSchemaBranch, } from "./collect-sub-schema-rules.mjs";
+export { createStructuralContext } from "./create-structural-context.mjs";
+export { declareRequiredProperties } from "./declare-required-properties.mjs";
+export { declarePresenceRules } from "./declare-presence.mjs";
+export { RefResolutionError, isResolvableRef, resolveRef } from "./resolve-ref.mjs";
+export { UnsupportedKeywordError } from "./unsupported-keyword-error.mjs";
+export { isDraft07Schema, isSchemaObject } from "./draft07.types.mjs";
+export { assertKeywordSupported, countKeywordHandlings, findKeywordHandling, isDraft07Keyword, listBoundPluginNames, listDraft07Keywords, } from "./keyword-map.mjs";
+export { findFormatHandling, listFormatNames } from "./format-map.mjs";