@maroonedog/luq 2.2.0 → 2.3.0

package/dist/json-schema/build-from-schema.js

@@ -42,7 +42,14 @@ function buildFieldEntries(bag, schema) {
         path: declaration.path,
         defaultOf: null,
         applyDefaultToNull: false,
-        collectRules: (chain) => collectDeclaredRules(declaration, bag, schema, chain),
+        normalize: null,
+        // No record of declared calls: what is assembled here comes from a
+        // document, and nobody called a chain method. null rather than the empty
+        // list is what lets a writer say "not known" instead of "none".
+        collectRules: (chain) => ({
+            rules: collectDeclaredRules(declaration, bag, schema, chain),
+            calls: null,
+        }),
     }));
 }
 /** The erased front door: the declarations, with nothing compiled yet. */

package/dist/json-schema/build-from-schema.mjs

@@ -35,7 +35,14 @@ export function buildFieldEntries(bag, schema) {
         path: declaration.path,
         defaultOf: null,
         applyDefaultToNull: false,
-        collectRules: (chain) => collectDeclaredRules(declaration, bag, schema, chain),
+        normalize: null,
+        // No record of declared calls: what is assembled here comes from a
+        // document, and nobody called a chain method. null rather than the empty
+        // list is what lets a writer say "not known" instead of "none".
+        collectRules: (chain) => ({
+            rules: collectDeclaredRules(declaration, bag, schema, chain),
+            calls: null,
+        }),
     }));
 }
 /** The erased front door: the declarations, with nothing compiled yet. */

package/dist/json-schema/declare-additional-properties.d.ts

@@ -3,17 +3,17 @@ import type { ConverterChain } from "./apply-keyword-binding";
 import type { Draft07SchemaObject } from "./draft07.types";
 import type { StructuralContext } from "./structural-expansion.types";
 /**
- * `patternProperties` のキー、つまり正規表現の文字列。
- * additionalProperties が「該当しないキー」を選ぶのに要る。
+ * The keys of `patternProperties`, which are regular expression strings.
+ * additionalProperties needs them to pick out the keys that match none.
  */
 export declare function patternPropertyKeys(schema: Draft07SchemaObject): readonly string[];
 /**
- * BOOLEAN 形。
+ * The BOOLEAN form.
  *
- * キーワード束縛は自分の値 (boolean) しか運べないので、パターンがあるときだけ
- * プラグインを直接呼ぶ。束縛のほうは残す: キーワード表と「そのメソッドが
- * 実在する」というコンパイル時のゲートはそちらが持っている。
+ * A keyword binding can only carry its own value, so when patterns are present
+ * the plugin is called directly. The binding stays either way: it is what
+ * holds the keyword table and the compile-time check that the method exists.
  */
 export declare function applyAdditionalPropertiesBoolean(chain: ConverterChain<"object">, schema: Draft07SchemaObject, allowed: boolean): ConverterChain<"object">;
-/** SCHEMA 形: 宣言にもパターンにも該当しない値が、そのスキーマに従う。 */
+/** The SCHEMA form: whatever matches neither a declaration nor a pattern follows it. */
 export declare function declareAdditionalPropertiesSchema(schema: Draft07SchemaObject, context: StructuralContext): readonly Rule[];

package/dist/json-schema/declare-additional-properties.js

@@ -7,8 +7,8 @@ const apply_keyword_binding_1 = require("./apply-keyword-binding");
 const keyword_map_object_1 = require("./keyword-map-object");
 const NO_RULES = Object.freeze([]);
 /**
- * `patternProperties` のキー、つまり正規表現の文字列。
- * additionalProperties が「該当しないキー」を選ぶのに要る。
+ * The keys of `patternProperties`, which are regular expression strings.
+ * additionalProperties needs them to pick out the keys that match none.
  */
 function patternPropertyKeys(schema) {
     const patterns = schema.patternProperties;
@@ -17,11 +17,11 @@ function patternPropertyKeys(schema) {
     return Object.freeze(Object.keys(patterns));
 }
 /**
- * BOOLEAN 形。
+ * The BOOLEAN form.
  *
- * キーワード束縛は自分の値 (boolean) しか運べないので、パターンがあるときだけ
- * プラグインを直接呼ぶ。束縛のほうは残す: キーワード表と「そのメソッドが
- * 実在する」というコンパイル時のゲートはそちらが持っている。
+ * A keyword binding can only carry its own value, so when patterns are present
+ * the plugin is called directly. The binding stays either way: it is what
+ * holds the keyword table and the compile-time check that the method exists.
  */
 function applyAdditionalPropertiesBoolean(chain, schema, allowed) {
     const patterns = patternPropertyKeys(schema);
@@ -29,7 +29,7 @@ function applyAdditionalPropertiesBoolean(chain, schema, allowed) {
         ? (0, apply_keyword_binding_1.applyKeywordBinding)(chain, keyword_map_object_1.additionalPropertiesBinding, allowed)
         : chain.additionalProperties(allowed, undefined, patterns);
 }
-/** SCHEMA 形: 宣言にもパターンにも該当しない値が、そのスキーマに従う。 */
+/** The SCHEMA form: whatever matches neither a declaration nor a pattern follows it. */
 function declareAdditionalPropertiesSchema(schema, context) {
     const additional = schema.additionalProperties;
     if (additional === undefined || typeof additional === "boolean") {

package/dist/json-schema/declare-additional-properties.mjs

@@ -2,8 +2,8 @@ import { applyKeywordBinding } from "./apply-keyword-binding.mjs";
 import { additionalPropertiesBinding } from "./keyword-map-object.mjs";
 const NO_RULES = Object.freeze([]);
 /**
- * `patternProperties` のキー、つまり正規表現の文字列。
- * additionalProperties が「該当しないキー」を選ぶのに要る。
+ * The keys of `patternProperties`, which are regular expression strings.
+ * additionalProperties needs them to pick out the keys that match none.
  */
 export function patternPropertyKeys(schema) {
     const patterns = schema.patternProperties;
@@ -12,11 +12,11 @@ export function patternPropertyKeys(schema) {
     return Object.freeze(Object.keys(patterns));
 }
 /**
- * BOOLEAN 形。
+ * The BOOLEAN form.
  *
- * キーワード束縛は自分の値 (boolean) しか運べないので、パターンがあるときだけ
- * プラグインを直接呼ぶ。束縛のほうは残す: キーワード表と「そのメソッドが
- * 実在する」というコンパイル時のゲートはそちらが持っている。
+ * A keyword binding can only carry its own value, so when patterns are present
+ * the plugin is called directly. The binding stays either way: it is what
+ * holds the keyword table and the compile-time check that the method exists.
  */
 export function applyAdditionalPropertiesBoolean(chain, schema, allowed) {
     const patterns = patternPropertyKeys(schema);
@@ -24,7 +24,7 @@ export function applyAdditionalPropertiesBoolean(chain, schema, allowed) {
         ? applyKeywordBinding(chain, additionalPropertiesBinding, allowed)
         : chain.additionalProperties(allowed, undefined, patterns);
 }
-/** SCHEMA 形: 宣言にもパターンにも該当しない値が、そのスキーマに従う。 */
+/** The SCHEMA form: whatever matches neither a declaration nor a pattern follows it. */
 export function declareAdditionalPropertiesSchema(schema, context) {
     const additional = schema.additionalProperties;
     if (additional === undefined || typeof additional === "boolean") {

package/dist/json-schema/declare-object-keywords.js

@@ -40,10 +40,10 @@ function declareObjectRules(schema, context) {
     }
     const additional = schema.additionalProperties;
     if (typeof additional === "boolean") {
-        // §6.5.4 の対象は「properties にも patternProperties にも該当しない」キー。
-        // キーワード束縛は自分の値 (boolean) しか運べないので、パターンがある
-        // ときだけプラグインを直接呼ぶ。束縛のほうは残す: キーワード表と
-        // 「そのメソッドが実在する」というコンパイル時のゲートはそちらが持つ。
+        // §6.5.4 applies to the keys matched by neither properties nor
+        // patternProperties. A keyword binding can only carry its own value, so
+        // when patterns are present the plugin is called directly. The binding
+        // stays: it holds the keyword table and the check that the method exists.
         chain = (0, declare_additional_properties_1.applyAdditionalPropertiesBoolean)(chain, schema, additional);
     }
     return readRules(chain);

package/dist/json-schema/declare-object-keywords.mjs

@@ -33,10 +33,10 @@ export function declareObjectRules(schema, context) {
     }
     const additional = schema.additionalProperties;
     if (typeof additional === "boolean") {
-        // §6.5.4 の対象は「properties にも patternProperties にも該当しない」キー。
-        // キーワード束縛は自分の値 (boolean) しか運べないので、パターンがある
-        // ときだけプラグインを直接呼ぶ。束縛のほうは残す: キーワード表と
-        // 「そのメソッドが実在する」というコンパイル時のゲートはそちらが持つ。
+        // §6.5.4 applies to the keys matched by neither properties nor
+        // patternProperties. A keyword binding can only carry its own value, so
+        // when patterns are present the plugin is called directly. The binding
+        // stays: it holds the keyword table and the check that the method exists.
         chain = applyAdditionalPropertiesBoolean(chain, schema, additional);
     }
     return readRules(chain);

package/dist/json-schema/follow-json-pointer.d.ts

@@ -8,14 +8,15 @@ export declare function toPointerTokens(fragment: string): readonly string[];
  */
 export declare function stepInto(current: unknown, token: string): unknown;
 /**
- * ポインタを辿りながら、**途中で跨いだ `$id` を数える**。
+ * Walks the pointer while **counting every `$id` crossed on the way**.
  *
- * `#/definitions/baz/definitions/bar` の `baz` が `$id: "folder/"` を持つとき、
- * `bar` の中に書かれた相対 `$ref` は folder/ の下で解決されなければならない。
- * 着地したノードの `$id` だけを見ると、通過したノードの分が落ちる。
+ * When an intermediate node along the path carries `$id: "folder/"`, a
+ * relative `$ref` written deeper in must resolve under folder/. Looking only
+ * at the `$id` of the node landed on loses every node passed through.
  *
- * ベースをどう進めるかは呼び出し側が渡す (`advance`)。この関数は「どのノードを
- * どの順に跨いだか」だけを知っていればよく、URI の演算は持たない。
+ * How the base advances is supplied by the caller. This function only needs
+ * to know which nodes were crossed and in what order; it does no URI
+ * arithmetic of its own.
  */
 export declare function walkPointer<TScope>(fragment: string, document: unknown, scope: TScope, advance: (scope: TScope, node: unknown) => TScope, onMissing: (token: string) => never): {
     readonly node: unknown;

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

@@ -4,13 +4,12 @@ exports.toPointerTokens = toPointerTokens;
 exports.stepInto = stepInto;
 exports.walkPointer = walkPointer;
 // ===========================================================================
-// L8  src/json-schema/follow-json-pointer.ts — RFC 6901 のポインタを辿る。
+// L8  src/json-schema/follow-json-pointer.ts — walks an RFC 6901 pointer.
 //
-// `$ref` のうち **場所** を表す部分だけを担う。どの文書を見るかは
-// schema-registry.ts と resolve-ref.ts の仕事で、ここは「その文書の中の
-// どこか」だけを答える。分けてあるのは、`$id` によるベース URI の話と
-// ポインタの復号の話が別物であり、混ぜると 200 行を超えて両方読みにくく
-// なるからである。
+// Answers only WHERE INSIDE a document, never WHICH document. Choosing the
+// document is a separate job, kept separate because base-URI arithmetic and
+// pointer decoding are different problems and neither reads well once they
+// share a file.
 // ===========================================================================
 const types_1 = require("../types");
 /** RFC 6901: `~1` is "/" and `~0` is "~", decoded in that order. */
@@ -18,18 +17,18 @@ function decodePointerToken(token) {
     return token.replace(/~1/g, "/").replace(/~0/g, "~");
 }
 /**
- * `$ref` は URI で、ポインタはそのフラグメント。RFC 6901 §6 は
- * 「フラグメントの規則でパーセント符号化されている」と定めるので、
- * **スラッシュで割る前にフラグメント全体を復号する**。
+ * A `$ref` is a URI and the pointer is its fragment. RFC 6901 §6 says the
+ * fragment is percent-encoded by the fragment rules, so **the whole fragment
+ * is decoded before splitting on slashes**.
  *
- * 順序が意味を持つ。`#/definitions/percent%25field` は復号して
- * `/definitions/percent%field` になり、そこで割ってトークンを得る。
- * 先に割ってからトークンごとに復号すると `%25` は復号されるが、
- * `%2F` が「区切りとしてのスラッシュ」に戻る仕様どおりの挙動にならない。
+ * The order matters. `#/definitions/percent%25field` decodes to
+ * `/definitions/percent%field` and is split from there. Splitting first and
+ * decoding each token does decode `%25`, but then `%2F` turns back into a
+ * separator, which is not what the spec says it means.
  *
- * 壊れたパーセント列 (`%zz`) は decodeURIComponent が投げるので、
- * 復号できないポインタはそのまま扱う。ここで投げると、ポインタが1つ
- * 壊れているだけで文書全体が読めなくなる。
+ * decodeURIComponent throws on a malformed sequence like `%zz`, and a
+ * pointer that cannot be decoded is used as-is. Throwing here would make one
+ * broken pointer take the whole document down.
  */
 function decodeFragment(pointer) {
     try {
@@ -44,8 +43,8 @@ function toPointerTokens(fragment) {
     const pointer = decodeFragment(fragment);
     if (pointer === "")
         return [];
-    // "/" は「ルート直下の空文字キー」であって空のトークン列ではない。
-    // ここを [] にすると `{"": ...}` を指すポインタがルートに化ける。
+    // "/" is the empty-string key directly under the root, not an empty token
+    // list. Returning [] here would turn a pointer at `{"": ...}` into the root.
     return pointer.split("/").slice(1).map(decodePointerToken);
 }
 /**
@@ -65,14 +64,15 @@ function stepInto(current, token) {
     return current[token];
 }
 /**
- * ポインタを辿りながら、**途中で跨いだ `$id` を数える**。
+ * Walks the pointer while **counting every `$id` crossed on the way**.
  *
- * `#/definitions/baz/definitions/bar` の `baz` が `$id: "folder/"` を持つとき、
- * `bar` の中に書かれた相対 `$ref` は folder/ の下で解決されなければならない。
- * 着地したノードの `$id` だけを見ると、通過したノードの分が落ちる。
+ * When an intermediate node along the path carries `$id: "folder/"`, a
+ * relative `$ref` written deeper in must resolve under folder/. Looking only
+ * at the `$id` of the node landed on loses every node passed through.
  *
- * ベースをどう進めるかは呼び出し側が渡す (`advance`)。この関数は「どのノードを
- * どの順に跨いだか」だけを知っていればよく、URI の演算は持たない。
+ * How the base advances is supplied by the caller. This function only needs
+ * to know which nodes were crossed and in what order; it does no URI
+ * arithmetic of its own.
  */
 function walkPointer(fragment, document, scope, advance, onMissing) {
     let current = document;

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

@@ -1,11 +1,10 @@
 // ===========================================================================
-// L8  src/json-schema/follow-json-pointer.ts — RFC 6901 のポインタを辿る。
+// L8  src/json-schema/follow-json-pointer.ts — walks an RFC 6901 pointer.
 //
-// `$ref` のうち **場所** を表す部分だけを担う。どの文書を見るかは
-// schema-registry.ts と resolve-ref.ts の仕事で、ここは「その文書の中の
-// どこか」だけを答える。分けてあるのは、`$id` によるベース URI の話と
-// ポインタの復号の話が別物であり、混ぜると 200 行を超えて両方読みにくく
-// なるからである。
+// Answers only WHERE INSIDE a document, never WHICH document. Choosing the
+// document is a separate job, kept separate because base-URI arithmetic and
+// pointer decoding are different problems and neither reads well once they
+// share a file.
 // ===========================================================================
 import { isArray, isPlainObject } from "../types/index.mjs";
 /** RFC 6901: `~1` is "/" and `~0` is "~", decoded in that order. */
@@ -13,18 +12,18 @@ function decodePointerToken(token) {
     return token.replace(/~1/g, "/").replace(/~0/g, "~");
 }
 /**
- * `$ref` は URI で、ポインタはそのフラグメント。RFC 6901 §6 は
- * 「フラグメントの規則でパーセント符号化されている」と定めるので、
- * **スラッシュで割る前にフラグメント全体を復号する**。
+ * A `$ref` is a URI and the pointer is its fragment. RFC 6901 §6 says the
+ * fragment is percent-encoded by the fragment rules, so **the whole fragment
+ * is decoded before splitting on slashes**.
  *
- * 順序が意味を持つ。`#/definitions/percent%25field` は復号して
- * `/definitions/percent%field` になり、そこで割ってトークンを得る。
- * 先に割ってからトークンごとに復号すると `%25` は復号されるが、
- * `%2F` が「区切りとしてのスラッシュ」に戻る仕様どおりの挙動にならない。
+ * The order matters. `#/definitions/percent%25field` decodes to
+ * `/definitions/percent%field` and is split from there. Splitting first and
+ * decoding each token does decode `%25`, but then `%2F` turns back into a
+ * separator, which is not what the spec says it means.
  *
- * 壊れたパーセント列 (`%zz`) は decodeURIComponent が投げるので、
- * 復号できないポインタはそのまま扱う。ここで投げると、ポインタが1つ
- * 壊れているだけで文書全体が読めなくなる。
+ * decodeURIComponent throws on a malformed sequence like `%zz`, and a
+ * pointer that cannot be decoded is used as-is. Throwing here would make one
+ * broken pointer take the whole document down.
  */
 function decodeFragment(pointer) {
     try {
@@ -39,8 +38,8 @@ export function toPointerTokens(fragment) {
     const pointer = decodeFragment(fragment);
     if (pointer === "")
         return [];
-    // "/" は「ルート直下の空文字キー」であって空のトークン列ではない。
-    // ここを [] にすると `{"": ...}` を指すポインタがルートに化ける。
+    // "/" is the empty-string key directly under the root, not an empty token
+    // list. Returning [] here would turn a pointer at `{"": ...}` into the root.
     return pointer.split("/").slice(1).map(decodePointerToken);
 }
 /**
@@ -60,14 +59,15 @@ export function stepInto(current, token) {
     return current[token];
 }
 /**
- * ポインタを辿りながら、**途中で跨いだ `$id` を数える**。
+ * Walks the pointer while **counting every `$id` crossed on the way**.
  *
- * `#/definitions/baz/definitions/bar` の `baz` が `$id: "folder/"` を持つとき、
- * `bar` の中に書かれた相対 `$ref` は folder/ の下で解決されなければならない。
- * 着地したノードの `$id` だけを見ると、通過したノードの分が落ちる。
+ * When an intermediate node along the path carries `$id: "folder/"`, a
+ * relative `$ref` written deeper in must resolve under folder/. Looking only
+ * at the `$id` of the node landed on loses every node passed through.
  *
- * ベースをどう進めるかは呼び出し側が渡す (`advance`)。この関数は「どのノードを
- * どの順に跨いだか」だけを知っていればよく、URI の演算は持たない。
+ * How the base advances is supplied by the caller. This function only needs
+ * to know which nodes were crossed and in what order; it does no URI
+ * arithmetic of its own.
  */
 export function walkPointer(fragment, document, scope, advance, onMissing) {
     let current = document;

package/dist/json-schema/ref-resolution-error.js

@@ -2,9 +2,9 @@
 // ===========================================================================
 // L8  src/json-schema/ref-resolution-error.ts
 //
-// `$ref` が解けなかったことを表す例外。呼び出し側が **identity で捕まえられる**
-// ことが要件なので、独立したクラスであり、独立したモジュールである
-// (resolve-ref.ts から import すると、その巨大な依存を一緒に引く)。
+// Raised when a `$ref` cannot be resolved. Callers must be able to catch it
+// **by identity**, so it is its own class — and its own module, so catching it
+// does not drag in the resolver's dependencies.
 // ===========================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RefResolutionError = void 0;

package/dist/json-schema/ref-resolution-error.mjs

@@ -1,9 +1,9 @@
 // ===========================================================================
 // L8  src/json-schema/ref-resolution-error.ts
 //
-// `$ref` が解けなかったことを表す例外。呼び出し側が **identity で捕まえられる**
-// ことが要件なので、独立したクラスであり、独立したモジュールである
-// (resolve-ref.ts から import すると、その巨大な依存を一緒に引く)。
+// Raised when a `$ref` cannot be resolved. Callers must be able to catch it
+// **by identity**, so it is its own class — and its own module, so catching it
+// does not drag in the resolver's dependencies.
 // ===========================================================================
 export class RefResolutionError extends Error {
     constructor(ref, reason) {

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

@@ -2,19 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSchemaRegistry = createSchemaRegistry;
 // ===========================================================================
-// L8  src/json-schema/schema-registry.ts — どの URI がどのスキーマを指すか。
+// L8  src/json-schema/schema-registry.ts — which URI names which schema.
 //
-// Draft-07 §8.2 では `$id` が二つの働きをする: 場所を示す URI はベースを
-// 立て直し、`#name` の形は**位置に依らない名前**を付ける。どちらも
-// 「この URI はこのノード」という索引で、それがこのファイルの責務である。
-// ポインタ (`#/definitions/x`) を辿るのは場所の話なので resolve-ref.ts が持つ。
+// Draft-07 §8.2 gives `$id` two jobs: a URI that names a location re-bases
+// what follows, and the `#name` form gives a **location-independent name**.
+// Both are the same index — this URI is that node — which is this file's whole
+// responsibility. Walking a pointer is about location, and lives elsewhere.
 //
-// 外部文書は**呼び出し側が渡したものだけ**である。Luq は取りに行かない:
-// 関数ではなく地図 (`externalDocuments`) を受けるのは、そうすれば
-//   * スキーマに書かれた URI でプロセスがソケットを開くことがない (SSRF)、
-//   * 変換が同期のままで、CSP でも動く、
-//   * 何が読まれうるかが呼び出し側のコードに全部書いてある、
-// の三つが同時に成り立つからで、非同期ローダーではどれも失われる。
+// External documents are **only what the caller passed in**; nothing is
+// fetched. Taking a map rather than a loader function is what makes all three
+// of these true at once:
+//   * a URI written in a schema can never make this process open a socket,
+//   * conversion stays synchronous, so it works under CSP,
+//   * everything that could possibly be read is visible in the caller's code.
+// An async loader gives up all three.
 // ===========================================================================
 const draft07_types_1 = require("./draft07.types");
 const types_1 = require("../types");

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

@@ -1,17 +1,18 @@
 // ===========================================================================
-// L8  src/json-schema/schema-registry.ts — どの URI がどのスキーマを指すか。
+// L8  src/json-schema/schema-registry.ts — which URI names which schema.
 //
-// Draft-07 §8.2 では `$id` が二つの働きをする: 場所を示す URI はベースを
-// 立て直し、`#name` の形は**位置に依らない名前**を付ける。どちらも
-// 「この URI はこのノード」という索引で、それがこのファイルの責務である。
-// ポインタ (`#/definitions/x`) を辿るのは場所の話なので resolve-ref.ts が持つ。
+// Draft-07 §8.2 gives `$id` two jobs: a URI that names a location re-bases
+// what follows, and the `#name` form gives a **location-independent name**.
+// Both are the same index — this URI is that node — which is this file's whole
+// responsibility. Walking a pointer is about location, and lives elsewhere.
 //
-// 外部文書は**呼び出し側が渡したものだけ**である。Luq は取りに行かない:
-// 関数ではなく地図 (`externalDocuments`) を受けるのは、そうすれば
-//   * スキーマに書かれた URI でプロセスがソケットを開くことがない (SSRF)、
-//   * 変換が同期のままで、CSP でも動く、
-//   * 何が読まれうるかが呼び出し側のコードに全部書いてある、
-// の三つが同時に成り立つからで、非同期ローダーではどれも失われる。
+// External documents are **only what the caller passed in**; nothing is
+// fetched. Taking a map rather than a loader function is what makes all three
+// of these true at once:
+//   * a URI written in a schema can never make this process open a socket,
+//   * conversion stays synchronous, so it works under CSP,
+//   * everything that could possibly be read is visible in the caller's code.
+// An async loader gives up all three.
 // ===========================================================================
 import { isDraft07Schema, isSchemaObject } from "./draft07.types.mjs";
 import { isArray, isPlainObject } from "../types/index.mjs";

package/dist/json-schema/uri-reference.js

@@ -1,20 +1,20 @@
 "use strict";
 // ===========================================================================
-// L8  src/json-schema/uri-reference.ts — `$id` と `$ref` の URI 演算。
+// L8  src/json-schema/uri-reference.ts — the URI arithmetic of `$id`/`$ref`.
 //
-// Draft-07 §8.2 の `$id` はベース URI を立て、`$ref` はその上で解決される。
-// つまり `$ref` は「文書内のポインタ」ではなく **URI 参照** であり、
-// 同じ文字列でも、どの `$id` の下に書かれたかで別の場所を指す。
+// Draft-07 §8.2 makes `$id` establish a base URI that `$ref` resolves
+// against. A `$ref` is therefore a **URI reference** and not a pointer within
+// a document: the same string points somewhere else depending on which `$id`
+// it was written under.
 //
-// 解決は WHATWG URL に任せる。RFC 3986 §5.3 を手で書き直しても、
-// パーセント符号化・ドットセグメント・スキーム相対 (`//host/x`) の三つで
-// 必ずずれる — そして URL はブラウザにも Node にもある標準グローバルで、
-// eval も new Function も使わない (check:no-dynamic-code が見ている)。
+// Resolution is delegated to the WHATWG URL. Rewriting RFC 3986 §5.3 by hand
+// goes wrong on percent-encoding, dot segments and scheme-relative
+// (`//host/x`) every time — and URL is a standard global in both browsers and
+// Node, needing neither eval nor new Function.
 //
-// ネットワークには**触れない**。ここにあるのは文字列演算だけで、
-// 解決した URI をどう手に入れるかは呼び出し側の責任である
-// (schema-registry.ts の externalDocuments)。スキーマが書いた URI で
-// このプロセスがソケットを開くことは無い。
+// **Nothing here touches the network.** This is string arithmetic; how a
+// resolved URI is actually obtained is the caller's responsibility. A URI
+// written in a schema never causes this process to open a socket.
 // ===========================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitUri = splitUri;

package/dist/json-schema/uri-reference.mjs

@@ -1,19 +1,19 @@
 // ===========================================================================
-// L8  src/json-schema/uri-reference.ts — `$id` と `$ref` の URI 演算。
+// L8  src/json-schema/uri-reference.ts — the URI arithmetic of `$id`/`$ref`.
 //
-// Draft-07 §8.2 の `$id` はベース URI を立て、`$ref` はその上で解決される。
-// つまり `$ref` は「文書内のポインタ」ではなく **URI 参照** であり、
-// 同じ文字列でも、どの `$id` の下に書かれたかで別の場所を指す。
+// Draft-07 §8.2 makes `$id` establish a base URI that `$ref` resolves
+// against. A `$ref` is therefore a **URI reference** and not a pointer within
+// a document: the same string points somewhere else depending on which `$id`
+// it was written under.
 //
-// 解決は WHATWG URL に任せる。RFC 3986 §5.3 を手で書き直しても、
-// パーセント符号化・ドットセグメント・スキーム相対 (`//host/x`) の三つで
-// 必ずずれる — そして URL はブラウザにも Node にもある標準グローバルで、
-// eval も new Function も使わない (check:no-dynamic-code が見ている)。
+// Resolution is delegated to the WHATWG URL. Rewriting RFC 3986 §5.3 by hand
+// goes wrong on percent-encoding, dot segments and scheme-relative
+// (`//host/x`) every time — and URL is a standard global in both browsers and
+// Node, needing neither eval nor new Function.
 //
-// ネットワークには**触れない**。ここにあるのは文字列演算だけで、
-// 解決した URI をどう手に入れるかは呼び出し側の責任である
-// (schema-registry.ts の externalDocuments)。スキーマが書いた URI で
-// このプロセスがソケットを開くことは無い。
+// **Nothing here touches the network.** This is string arithmetic; how a
+// resolved URI is actually obtained is the caller's responsibility. A URI
+// written in a schema never causes this process to open a socket.
 // ===========================================================================
 export function splitUri(uri) {
     const hash = uri.indexOf("#");

package/dist/path/create-value-writer.js

@@ -36,19 +36,19 @@ function writeInto(container, keys, depth, value) {
  * numeric key here is a Record key.
  */
 /**
- * キーを own プロパティとして置く。**代入演算子を使わない。**
+ * Places a key as an own property. **Never with the assignment operator.**
  *
- * `copy[key] = value` は key が "__proto__" のとき Object.prototype の
- * アクセサ (setter) を呼び、own プロパティを作る代わりにプロトタイプを
- * 差し替えてしまう。defineProperty はアクセサを見ずに own プロパティを
- * 定義するので、"__proto__" という名前のプロパティを安全に持てる。
+ * `copy[key] = value` on "__proto__" invokes the accessor on
+ * Object.prototype: instead of creating an own property it swaps the
+ * prototype. defineProperty ignores accessors and defines the own property, so
+ * a property actually named "__proto__" can be held safely.
  *
- * "constructor" と "prototype" は Object.prototype 上でデータプロパティ
- * なので代入でも own プロパティになるが、キーごとに分岐すると分岐のほうを
- * 間違えるので一律にこちらを通す。
+ * "constructor" and "prototype" are data properties, so assignment would only
+ * make own properties of them — but branching per key is how the branch gets
+ * written wrong, so everything goes through this one path.
  *
- * これが「宣言パスに __proto__ を書けるようにする」の前提。書き込みが安全に
- * なったので、パス文法の側で拒否する必要が無くなった (reserved-segment.ts)。
+ * This is what makes writing safe, and therefore what makes refusing these
+ * names in the path grammar unnecessary. See reserved-segment.ts.
  */
 function putOwnProperty(target, key, value) {
     Object.defineProperty(target, key, {
@@ -72,8 +72,8 @@ function copyWith(container, key, value) {
         copy[index] = value;
         return copy;
     }
-    // スプレッドは own の列挙可能プロパティを CreateDataProperty で写すので、
-    // ここでは setter は動かない。危ないのは下の代入だけ。
+    // Spread copies own enumerable properties with CreateDataProperty, so no
+    // setter runs here. Only assignment is dangerous.
     const copy = { ...container };
     putOwnProperty(copy, key, value);
     return copy;

package/dist/path/create-value-writer.mjs

@@ -33,19 +33,19 @@ function writeInto(container, keys, depth, value) {
  * numeric key here is a Record key.
  */
 /**
- * キーを own プロパティとして置く。**代入演算子を使わない。**
+ * Places a key as an own property. **Never with the assignment operator.**
  *
- * `copy[key] = value` は key が "__proto__" のとき Object.prototype の
- * アクセサ (setter) を呼び、own プロパティを作る代わりにプロトタイプを
- * 差し替えてしまう。defineProperty はアクセサを見ずに own プロパティを
- * 定義するので、"__proto__" という名前のプロパティを安全に持てる。
+ * `copy[key] = value` on "__proto__" invokes the accessor on
+ * Object.prototype: instead of creating an own property it swaps the
+ * prototype. defineProperty ignores accessors and defines the own property, so
+ * a property actually named "__proto__" can be held safely.
  *
- * "constructor" と "prototype" は Object.prototype 上でデータプロパティ
- * なので代入でも own プロパティになるが、キーごとに分岐すると分岐のほうを
- * 間違えるので一律にこちらを通す。
+ * "constructor" and "prototype" are data properties, so assignment would only
+ * make own properties of them — but branching per key is how the branch gets
+ * written wrong, so everything goes through this one path.
  *
- * これが「宣言パスに __proto__ を書けるようにする」の前提。書き込みが安全に
- * なったので、パス文法の側で拒否する必要が無くなった (reserved-segment.ts)。
+ * This is what makes writing safe, and therefore what makes refusing these
+ * names in the path grammar unnecessary. See reserved-segment.ts.
  */
 function putOwnProperty(target, key, value) {
     Object.defineProperty(target, key, {
@@ -69,8 +69,8 @@ function copyWith(container, key, value) {
         copy[index] = value;
         return copy;
     }
-    // スプレッドは own の列挙可能プロパティを CreateDataProperty で写すので、
-    // ここでは setter は動かない。危ないのは下の代入だけ。
+    // Spread copies own enumerable properties with CreateDataProperty, so no
+    // setter runs here. Only assignment is dangerous.
     const copy = { ...container };
     putOwnProperty(copy, key, value);
     return copy;