@maroonedog/luq 0.1.2-alpha → 2.1.0

package/dist/json-schema/follow-json-pointer.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPointerTokens = toPointerTokens;
+exports.stepInto = stepInto;
+exports.walkPointer = walkPointer;
+// ===========================================================================
+// L8  src/json-schema/follow-json-pointer.ts — RFC 6901 のポインタを辿る。
+//
+// `$ref` のうち **場所** を表す部分だけを担う。どの文書を見るかは
+// schema-registry.ts と resolve-ref.ts の仕事で、ここは「その文書の中の
+// どこか」だけを答える。分けてあるのは、`$id` によるベース URI の話と
+// ポインタの復号の話が別物であり、混ぜると 200 行を超えて両方読みにくく
+// なるからである。
+// ===========================================================================
+const types_1 = require("../types");
+/** RFC 6901: `~1` is "/" and `~0` is "~", decoded in that order. */
+function decodePointerToken(token) {
+    return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+/**
+ * `$ref` は URI で、ポインタはそのフラグメント。RFC 6901 §6 は
+ * 「フラグメントの規則でパーセント符号化されている」と定めるので、
+ * **スラッシュで割る前にフラグメント全体を復号する**。
+ *
+ * 順序が意味を持つ。`#/definitions/percent%25field` は復号して
+ * `/definitions/percent%field` になり、そこで割ってトークンを得る。
+ * 先に割ってからトークンごとに復号すると `%25` は復号されるが、
+ * `%2F` が「区切りとしてのスラッシュ」に戻る仕様どおりの挙動にならない。
+ *
+ * 壊れたパーセント列 (`%zz`) は decodeURIComponent が投げるので、
+ * 復号できないポインタはそのまま扱う。ここで投げると、ポインタが1つ
+ * 壊れているだけで文書全体が読めなくなる。
+ */
+function decodeFragment(pointer) {
+    try {
+        return decodeURIComponent(pointer);
+    }
+    catch {
+        return pointer;
+    }
+}
+/** `fragment` is what came AFTER the "#", so there is no prefix to strip. */
+function toPointerTokens(fragment) {
+    const pointer = decodeFragment(fragment);
+    if (pointer === "")
+        return [];
+    // "/" は「ルート直下の空文字キー」であって空のトークン列ではない。
+    // ここを [] にすると `{"": ...}` を指すポインタがルートに化ける。
+    return pointer.split("/").slice(1).map(decodePointerToken);
+}
+/**
+ * `definitions` and `$defs` are the same container to a pointer: a Draft-07
+ * document spells it one way, a 2019-09 document the other, and a schema that
+ * mixes them (they exist) must still resolve. A real `definitions` member
+ * always wins, so a property literally named "definitions" is unaffected.
+ */
+function stepInto(current, token) {
+    if ((0, types_1.isArray)(current))
+        return current[Number(token)];
+    if (!(0, types_1.isPlainObject)(current))
+        return undefined;
+    if (token === "definitions" || token === "$defs") {
+        return current["definitions"] ?? current["$defs"];
+    }
+    return current[token];
+}
+/**
+ * ポインタを辿りながら、**途中で跨いだ `$id` を数える**。
+ *
+ * `#/definitions/baz/definitions/bar` の `baz` が `$id: "folder/"` を持つとき、
+ * `bar` の中に書かれた相対 `$ref` は folder/ の下で解決されなければならない。
+ * 着地したノードの `$id` だけを見ると、通過したノードの分が落ちる。
+ *
+ * ベースをどう進めるかは呼び出し側が渡す (`advance`)。この関数は「どのノードを
+ * どの順に跨いだか」だけを知っていればよく、URI の演算は持たない。
+ */
+function walkPointer(fragment, document, scope, advance, onMissing) {
+    let current = document;
+    let here = scope;
+    for (const token of toPointerTokens(fragment)) {
+        current = stepInto(current, token);
+        if (current === undefined)
+            onMissing(token);
+        here = advance(here, current);
+    }
+    return { node: current, scope: here };
+}

package/dist/json-schema/follow-json-pointer.mjs

@@ -0,0 +1,82 @@
+// ===========================================================================
+// L8  src/json-schema/follow-json-pointer.ts — RFC 6901 のポインタを辿る。
+//
+// `$ref` のうち **場所** を表す部分だけを担う。どの文書を見るかは
+// schema-registry.ts と resolve-ref.ts の仕事で、ここは「その文書の中の
+// どこか」だけを答える。分けてあるのは、`$id` によるベース URI の話と
+// ポインタの復号の話が別物であり、混ぜると 200 行を超えて両方読みにくく
+// なるからである。
+// ===========================================================================
+import { isArray, isPlainObject } from "../types/index.mjs";
+/** RFC 6901: `~1` is "/" and `~0` is "~", decoded in that order. */
+function decodePointerToken(token) {
+    return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+/**
+ * `$ref` は URI で、ポインタはそのフラグメント。RFC 6901 §6 は
+ * 「フラグメントの規則でパーセント符号化されている」と定めるので、
+ * **スラッシュで割る前にフラグメント全体を復号する**。
+ *
+ * 順序が意味を持つ。`#/definitions/percent%25field` は復号して
+ * `/definitions/percent%field` になり、そこで割ってトークンを得る。
+ * 先に割ってからトークンごとに復号すると `%25` は復号されるが、
+ * `%2F` が「区切りとしてのスラッシュ」に戻る仕様どおりの挙動にならない。
+ *
+ * 壊れたパーセント列 (`%zz`) は decodeURIComponent が投げるので、
+ * 復号できないポインタはそのまま扱う。ここで投げると、ポインタが1つ
+ * 壊れているだけで文書全体が読めなくなる。
+ */
+function decodeFragment(pointer) {
+    try {
+        return decodeURIComponent(pointer);
+    }
+    catch {
+        return pointer;
+    }
+}
+/** `fragment` is what came AFTER the "#", so there is no prefix to strip. */
+export function toPointerTokens(fragment) {
+    const pointer = decodeFragment(fragment);
+    if (pointer === "")
+        return [];
+    // "/" は「ルート直下の空文字キー」であって空のトークン列ではない。
+    // ここを [] にすると `{"": ...}` を指すポインタがルートに化ける。
+    return pointer.split("/").slice(1).map(decodePointerToken);
+}
+/**
+ * `definitions` and `$defs` are the same container to a pointer: a Draft-07
+ * document spells it one way, a 2019-09 document the other, and a schema that
+ * mixes them (they exist) must still resolve. A real `definitions` member
+ * always wins, so a property literally named "definitions" is unaffected.
+ */
+export function stepInto(current, token) {
+    if (isArray(current))
+        return current[Number(token)];
+    if (!isPlainObject(current))
+        return undefined;
+    if (token === "definitions" || token === "$defs") {
+        return current["definitions"] ?? current["$defs"];
+    }
+    return current[token];
+}
+/**
+ * ポインタを辿りながら、**途中で跨いだ `$id` を数える**。
+ *
+ * `#/definitions/baz/definitions/bar` の `baz` が `$id: "folder/"` を持つとき、
+ * `bar` の中に書かれた相対 `$ref` は folder/ の下で解決されなければならない。
+ * 着地したノードの `$id` だけを見ると、通過したノードの分が落ちる。
+ *
+ * ベースをどう進めるかは呼び出し側が渡す (`advance`)。この関数は「どのノードを
+ * どの順に跨いだか」だけを知っていればよく、URI の演算は持たない。
+ */
+export function walkPointer(fragment, document, scope, advance, onMissing) {
+    let current = document;
+    let here = scope;
+    for (const token of toPointerTokens(fragment)) {
+        current = stepInto(current, token);
+        if (current === undefined)
+            onMissing(token);
+        here = advance(here, current);
+    }
+    return { node: current, scope: here };
+}

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,24 @@
+export { NotASchemaError, buildFieldEntries, buildFromSchema, fromJsonSchema, } from "./build-from-schema";
+export { DEFINITION_CONTAINERS, collectDefinitionNames, isDefinitionContainer, readRefPointer, resolveSchemaNode, resolveSchemaNodeInScope, 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 } from "./ref-resolution-error";
+export { isResolvableRef, resolveRef, resolveRefInScope } from "./resolve-ref";
+export type { RefScope } from "./ref-scope";
+export { createDocumentScope, createLocalScope } from "./ref-scope";
+export type { SchemaRegistry } from "./schema-registry";
+export { createSchemaRegistry } from "./schema-registry";
+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,65 @@
+"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.createSchemaRegistry = exports.createLocalScope = exports.createDocumentScope = exports.resolveRefInScope = 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.resolveSchemaNodeInScope = 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, "resolveSchemaNodeInScope", { enumerable: true, get: function () { return collect_definitions_1.resolveSchemaNodeInScope; } });
+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 ref_resolution_error_1 = require("./ref-resolution-error");
+Object.defineProperty(exports, "RefResolutionError", { enumerable: true, get: function () { return ref_resolution_error_1.RefResolutionError; } });
+var resolve_ref_1 = require("./resolve-ref");
+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; } });
+Object.defineProperty(exports, "resolveRefInScope", { enumerable: true, get: function () { return resolve_ref_1.resolveRefInScope; } });
+var ref_scope_1 = require("./ref-scope");
+Object.defineProperty(exports, "createDocumentScope", { enumerable: true, get: function () { return ref_scope_1.createDocumentScope; } });
+Object.defineProperty(exports, "createLocalScope", { enumerable: true, get: function () { return ref_scope_1.createLocalScope; } });
+var schema_registry_1 = require("./schema-registry");
+Object.defineProperty(exports, "createSchemaRegistry", { enumerable: true, get: function () { return schema_registry_1.createSchemaRegistry; } });
+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,22 @@
+// ===========================================================================
+// 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, resolveSchemaNodeInScope, 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 } from "./ref-resolution-error.mjs";
+export { isResolvableRef, resolveRef, resolveRefInScope } from "./resolve-ref.mjs";
+export { createDocumentScope, createLocalScope } from "./ref-scope.mjs";
+export { createSchemaRegistry } from "./schema-registry.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";

package/dist/json-schema/json-schema-bag.types.d.ts

@@ -0,0 +1,124 @@
+import type { TypeName } from "../types";
+import type { IsMarkerFree } from "../plugin-kit/marker.types";
+import type { PluginArgs, PluginDefinition, PluginSignature } from "../plugin-kit/plugin-definition";
+import type { SlotPlugins } from "../chain/plugin-bag.types";
+import { requiredPlugin } from "../plugins/required";
+import { compareFieldPlugin } from "../plugins/compare-field";
+import { numberMinPlugin } from "../plugins/number-min";
+import { stringMinPlugin } from "../plugins/string-min";
+import { arrayEachPlugin } from "../plugins/array-each";
+import { conditionalSchemaPlugin } from "../plugins/conditional-schema";
+import { arrayMaxLengthPlugin } from "../plugins/array-max-length";
+import { arrayMinLengthPlugin } from "../plugins/array-min-length";
+import { arrayUniquePlugin } from "../plugins/array-unique";
+import { numberMaxPlugin } from "../plugins/number-max";
+import { stringMaxPlugin } from "../plugins/string-max";
+import { stringPatternPlugin } from "../plugins/string-pattern";
+import { literalPlugin } from "../plugins/literal";
+import { oneOfPlugin } from "../plugins/one-of";
+import { objectAdditionalPropertiesPlugin } from "../plugins/object-additional-properties";
+import { objectPatternPropertiesPlugin } from "../plugins/object-pattern-properties";
+import { objectPropertyNamesPlugin } from "../plugins/object-property-names";
+import { numberIntegerPlugin } from "../plugins/number-integer";
+import { numberMultipleOfPlugin } from "../plugins/number-multiple-of";
+import { objectMinPropertiesPlugin } from "../plugins/object-min-properties";
+import { objectMaxPropertiesPlugin } from "../plugins/object-max-properties";
+import { objectAdditionalPropertiesSchemaPlugin } from "../plugins/object-additional-properties";
+import { objectDependentRequiredPlugin } from "../plugins/object-dependent-required";
+import { objectDependentSchemasPlugin } from "../plugins/object-dependent-schemas";
+import { arrayContainsPlugin } from "../plugins/array-contains";
+import { tupleBuilderPlugin } from "../plugins/tuple-builder";
+import { optionalPlugin } from "../plugins/optional";
+import { nullablePlugin } from "../plugins/nullable";
+import { stringContentEncodingPlugin } from "../plugins/string-content-encoding";
+import { stringContentMediaTypePlugin } from "../plugins/string-content-media-type";
+import { stringDatePlugin } from "../plugins/string-date";
+import { stringDatetimePlugin } from "../plugins/string-datetime";
+import { stringDurationPlugin } from "../plugins/string-duration";
+import { stringEmailPlugin } from "../plugins/string-email";
+import { stringHostnamePlugin } from "../plugins/string-hostname";
+import { stringIdnEmailPlugin } from "../plugins/string-idn-email";
+import { stringIdnHostnamePlugin } from "../plugins/string-idn-hostname";
+import { stringIpv4Plugin } from "../plugins/string-ipv4";
+import { stringIpv6Plugin } from "../plugins/string-ipv6";
+import { stringIriPlugin } from "../plugins/string-iri";
+import { stringIriReferencePlugin } from "../plugins/string-iri-reference";
+import { stringJsonPointerPlugin } from "../plugins/string-json-pointer";
+import { stringRelativeJsonPointerPlugin } from "../plugins/string-relative-json-pointer";
+import { stringTimePlugin } from "../plugins/string-time";
+import { stringUriTemplatePlugin } from "../plugins/string-uri-template";
+import { stringUrlPlugin } from "../plugins/string-url";
+import { stringRegexPlugin } from "../plugins/string-regex";
+import { stringUriReferencePlugin } from "../plugins/string-uri-reference";
+import { uuidPlugin } from "../plugins/uuid";
+/** The concrete bag `jsonSchemaFullFeature` installs. See the note above. */
+export type JsonSchemaBag = {
+    readonly required: typeof requiredPlugin;
+    readonly optional: typeof optionalPlugin;
+    readonly nullable: typeof nullablePlugin;
+    readonly literal: typeof literalPlugin;
+    readonly stringMin: typeof stringMinPlugin;
+    readonly stringMax: typeof stringMaxPlugin;
+    readonly stringPattern: typeof stringPatternPlugin;
+    readonly stringContentEncoding: typeof stringContentEncodingPlugin;
+    readonly stringContentMediaType: typeof stringContentMediaTypePlugin;
+    readonly numberMin: typeof numberMinPlugin;
+    readonly numberMax: typeof numberMaxPlugin;
+    readonly numberInteger: typeof numberIntegerPlugin;
+    readonly numberMultipleOf: typeof numberMultipleOfPlugin;
+    readonly arrayMinLength: typeof arrayMinLengthPlugin;
+    readonly arrayMaxLength: typeof arrayMaxLengthPlugin;
+    readonly arrayUnique: typeof arrayUniquePlugin;
+    readonly objectMinProperties: typeof objectMinPropertiesPlugin;
+    readonly objectMaxProperties: typeof objectMaxPropertiesPlugin;
+    readonly stringDate: typeof stringDatePlugin;
+    readonly stringDatetime: typeof stringDatetimePlugin;
+    readonly stringTime: typeof stringTimePlugin;
+    readonly stringDuration: typeof stringDurationPlugin;
+    readonly stringEmail: typeof stringEmailPlugin;
+    readonly stringHostname: typeof stringHostnamePlugin;
+    readonly stringIdnEmail: typeof stringIdnEmailPlugin;
+    readonly stringIdnHostname: typeof stringIdnHostnamePlugin;
+    readonly stringRegex: typeof stringRegexPlugin;
+    readonly stringUriReference: typeof stringUriReferencePlugin;
+    readonly stringIpv4: typeof stringIpv4Plugin;
+    readonly stringIpv6: typeof stringIpv6Plugin;
+    readonly stringUrl: typeof stringUrlPlugin;
+    readonly stringIri: typeof stringIriPlugin;
+    readonly stringIriReference: typeof stringIriReferencePlugin;
+    readonly stringUriTemplate: typeof stringUriTemplatePlugin;
+    readonly stringJsonPointer: typeof stringJsonPointerPlugin;
+    readonly stringRelativeJsonPointer: typeof stringRelativeJsonPointerPlugin;
+    readonly uuid: typeof uuidPlugin;
+    readonly oneOf: typeof oneOfPlugin;
+    readonly objectAdditionalProperties: typeof objectAdditionalPropertiesPlugin;
+    readonly objectAdditionalPropertiesSchema: typeof objectAdditionalPropertiesSchemaPlugin;
+    readonly objectPatternProperties: typeof objectPatternPropertiesPlugin;
+    readonly objectPropertyNames: typeof objectPropertyNamesPlugin;
+    readonly objectDependentRequired: typeof objectDependentRequiredPlugin;
+    readonly objectDependentSchemas: typeof objectDependentSchemasPlugin;
+    readonly arrayEach: typeof arrayEachPlugin;
+    readonly arrayContains: typeof arrayContainsPlugin;
+    readonly tupleBuilder: typeof tupleBuilderPlugin;
+    readonly conditionalSchema: typeof conditionalSchemaPlugin;
+    readonly compareField: typeof compareFieldPlugin;
+};
+/** Every method name reachable on the bag's chain for slot S. */
+export type BoundMethod<S extends TypeName> = keyof SlotPlugins<JsonSchemaBag, S> & string;
+/** A total lookup: a direct index would be TS2536 under a generic S. */
+export type BoundPlugin<S extends TypeName, M> = SlotPlugins<JsonSchemaBag, S> extends infer Slot ? M extends keyof Slot ? Slot[M] : never : never;
+export type NameOf<P> = P extends {
+    readonly name: infer N extends string;
+} ? N : never;
+/** PluginArgs re-stated so it satisfies a `readonly unknown[]` constraint. */
+export type ArgsOf<P> = PluginArgs<P> extends infer A extends readonly unknown[] ? A : never;
+/** Marker-freeness is expressed through IsMarkerFree, which lives beside the
+ *  marker registry, so a new marker cannot silently widen it. */
+export type MarkerFreePlugin<P> = P extends PluginDefinition<string, string, readonly TypeName[], infer Sig extends PluginSignature> ? IsMarkerFree<Sig["args"]> extends true ? P : never : never;
+export type JsonSchemaPlugin = MarkerFreePlugin<JsonSchemaBag[keyof JsonSchemaBag]>;
+/** An argument tuple a JSON document can supply: `never` when it carries a marker. */
+export type MarkerFreeArgs<A extends readonly unknown[]> = IsMarkerFree<A> extends true ? A : never;
+/** The methods of slot S a keyword may bind to: reachable AND marker-free. */
+export type BindableMethod<S extends TypeName> = {
+    [M in BoundMethod<S>]: [MarkerFreePlugin<BoundPlugin<S, M>>] extends [never] ? never : M;
+}[BoundMethod<S>];

package/dist/json-schema/json-schema-bag.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/json-schema/json-schema-bag.types.mjs

@@ -0,0 +1 @@
+export {};