@maroonedog/luq 2.2.0 → 2.3.0

package/dist/path/reserved-segment.d.ts

@@ -1,24 +1,24 @@
 /**
- * `Object.prototype` 上に同名のものがあるキー。
+ * Keys that share a name with something on `Object.prototype`.
  *
- * **これはもう拒否リストではない。** 以前はこの3つを宣言パスに書けなくして
- * いたが、その拒否は過剰だった。危険なのは書き込みだけで、しかも本当に危ない
- * のは "__proto__" ひとつである:
+ * **This is no longer a deny list.** Refusing these in a declared path was
+ * over-broad: only writing is dangerous, and of the three only "__proto__"
+ * really is.
  *
- *   読み取り  create-value-reader.ts が hasOwnProperty.call で own プロパティ
- *             しか読まないので、プロトタイプは最初から辿らない
- *   書き込み  `target[key] = value` は "__proto__" のとき Object.prototype の
- *             **アクセサ** を呼び、own プロパティを作らずプロトタイプを差し替える。
- *             "constructor" と "prototype" はデータプロパティなので代入でも
- *             own プロパティになるだけで、汚染にはならない
+ *   reading  own properties only, checked with hasOwnProperty.call, so the
+ *            prototype chain is never walked to begin with
+ *   writing  `target[key] = value` on "__proto__" invokes the ACCESSOR on
+ *            Object.prototype: it creates no own property and swaps the
+ *            prototype instead. "constructor" and "prototype" are data
+ *            properties, so assigning them only makes an own property and
+ *            pollutes nothing
  *
- * create-value-writer.ts が代入をやめて defineProperty に移したことで、
- * この経路が閉じた。したがって名前で拒否する必要が無くなり、
- * `{ "properties": { "__proto__": ... } }` のようなスキーマを検証できる
- * ようになった (JSON-Schema-Test-Suite の properties.json が要求している)。
+ * Writing through defineProperty instead of assignment closes that route.
+ * Refusing by name became unnecessary, which is what allows a schema like
+ * `{ "properties": { "__proto__": ... } }` to be validated at all.
  *
- * リスト自体は残す。テストが「この3つを書いても Object.prototype が汚れない」
- * ことを名指しで確認するのに使う (test/unit/path/create-value-writer.test.ts)。
+ * The list stays. Tests use it to name the keys they check Object.prototype
+ * against.
  */
 export declare const RESERVED_SEGMENTS: readonly string[];
 /** Thrown at BUILD time for every malformed or unsafe path. A declared rule

package/dist/path/reserved-segment.js

@@ -14,26 +14,26 @@ exports.PathSyntaxError = exports.RESERVED_SEGMENTS = void 0;
 exports.isReservedSegment = isReservedSegment;
 exports.assertDeclarableKey = assertDeclarableKey;
 /**
- * `Object.prototype` 上に同名のものがあるキー。
+ * Keys that share a name with something on `Object.prototype`.
  *
- * **これはもう拒否リストではない。** 以前はこの3つを宣言パスに書けなくして
- * いたが、その拒否は過剰だった。危険なのは書き込みだけで、しかも本当に危ない
- * のは "__proto__" ひとつである:
+ * **This is no longer a deny list.** Refusing these in a declared path was
+ * over-broad: only writing is dangerous, and of the three only "__proto__"
+ * really is.
  *
- *   読み取り  create-value-reader.ts が hasOwnProperty.call で own プロパティ
- *             しか読まないので、プロトタイプは最初から辿らない
- *   書き込み  `target[key] = value` は "__proto__" のとき Object.prototype の
- *             **アクセサ** を呼び、own プロパティを作らずプロトタイプを差し替える。
- *             "constructor" と "prototype" はデータプロパティなので代入でも
- *             own プロパティになるだけで、汚染にはならない
+ *   reading  own properties only, checked with hasOwnProperty.call, so the
+ *            prototype chain is never walked to begin with
+ *   writing  `target[key] = value` on "__proto__" invokes the ACCESSOR on
+ *            Object.prototype: it creates no own property and swaps the
+ *            prototype instead. "constructor" and "prototype" are data
+ *            properties, so assigning them only makes an own property and
+ *            pollutes nothing
  *
- * create-value-writer.ts が代入をやめて defineProperty に移したことで、
- * この経路が閉じた。したがって名前で拒否する必要が無くなり、
- * `{ "properties": { "__proto__": ... } }` のようなスキーマを検証できる
- * ようになった (JSON-Schema-Test-Suite の properties.json が要求している)。
+ * Writing through defineProperty instead of assignment closes that route.
+ * Refusing by name became unnecessary, which is what allows a schema like
+ * `{ "properties": { "__proto__": ... } }` to be validated at all.
  *
- * リスト自体は残す。テストが「この3つを書いても Object.prototype が汚れない」
- * ことを名指しで確認するのに使う (test/unit/path/create-value-writer.test.ts)。
+ * The list stays. Tests use it to name the keys they check Object.prototype
+ * against.
  */
 exports.RESERVED_SEGMENTS = Object.freeze([
     "__proto__",
@@ -80,9 +80,5 @@ function assertDeclarableKey(key, source) {
         throw new PathSyntaxError(source, `the key ${JSON.stringify(key)} contains a bracket; "[*]" is the only ` +
             "bracket form and it must trail a key");
     }
-    // 予約セグメントの拒否はここから外した。理由は RESERVED_SEGMENTS の
-    // コメントに書いてある。要約すると、危険なのは書き込みだけで、その書き込みは
-    // create-value-writer.ts が defineProperty に移したので安全になった。
-    // 名前で拒否する必要が無くなり、JSON Schema が "__proto__" というキーを
-    // 持つオブジェクトを検証できるようになった。
+    // Reserved segments are deliberately NOT refused here. See RESERVED_SEGMENTS.
 }

package/dist/path/reserved-segment.mjs

@@ -9,26 +9,26 @@
 // dependent for no gain.
 // ===========================================================================
 /**
- * `Object.prototype` 上に同名のものがあるキー。
+ * Keys that share a name with something on `Object.prototype`.
  *
- * **これはもう拒否リストではない。** 以前はこの3つを宣言パスに書けなくして
- * いたが、その拒否は過剰だった。危険なのは書き込みだけで、しかも本当に危ない
- * のは "__proto__" ひとつである:
+ * **This is no longer a deny list.** Refusing these in a declared path was
+ * over-broad: only writing is dangerous, and of the three only "__proto__"
+ * really is.
  *
- *   読み取り  create-value-reader.ts が hasOwnProperty.call で own プロパティ
- *             しか読まないので、プロトタイプは最初から辿らない
- *   書き込み  `target[key] = value` は "__proto__" のとき Object.prototype の
- *             **アクセサ** を呼び、own プロパティを作らずプロトタイプを差し替える。
- *             "constructor" と "prototype" はデータプロパティなので代入でも
- *             own プロパティになるだけで、汚染にはならない
+ *   reading  own properties only, checked with hasOwnProperty.call, so the
+ *            prototype chain is never walked to begin with
+ *   writing  `target[key] = value` on "__proto__" invokes the ACCESSOR on
+ *            Object.prototype: it creates no own property and swaps the
+ *            prototype instead. "constructor" and "prototype" are data
+ *            properties, so assigning them only makes an own property and
+ *            pollutes nothing
  *
- * create-value-writer.ts が代入をやめて defineProperty に移したことで、
- * この経路が閉じた。したがって名前で拒否する必要が無くなり、
- * `{ "properties": { "__proto__": ... } }` のようなスキーマを検証できる
- * ようになった (JSON-Schema-Test-Suite の properties.json が要求している)。
+ * Writing through defineProperty instead of assignment closes that route.
+ * Refusing by name became unnecessary, which is what allows a schema like
+ * `{ "properties": { "__proto__": ... } }` to be validated at all.
  *
- * リスト自体は残す。テストが「この3つを書いても Object.prototype が汚れない」
- * ことを名指しで確認するのに使う (test/unit/path/create-value-writer.test.ts)。
+ * The list stays. Tests use it to name the keys they check Object.prototype
+ * against.
  */
 export const RESERVED_SEGMENTS = Object.freeze([
     "__proto__",
@@ -74,9 +74,5 @@ export function assertDeclarableKey(key, source) {
         throw new PathSyntaxError(source, `the key ${JSON.stringify(key)} contains a bracket; "[*]" is the only ` +
             "bracket form and it must trail a key");
     }
-    // 予約セグメントの拒否はここから外した。理由は RESERVED_SEGMENTS の
-    // コメントに書いてある。要約すると、危険なのは書き込みだけで、その書き込みは
-    // create-value-writer.ts が defineProperty に移したので安全になった。
-    // 名前で拒否する必要が無くなり、JSON Schema が "__proto__" というキーを
-    // 持つオブジェクトを検証できるようになった。
+    // Reserved segments are deliberately NOT refused here. See RESERVED_SEGMENTS.
 }

package/dist/plugins/index.generated.js

@@ -1,6 +1,6 @@
 "use strict";
-// GENERATED FILE - 手で編集しないでください。
-// 生成元: プラグインディレクトリ構造 (scripts/catalog/build-plugin-catalog.ts)。
+// GENERATED FILE - do not edit by hand.
+// Generated by scripts/catalog/build-plugin-catalog.ts out of the plugin directory structure.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stringDatetimePlugin = exports.stringDatePlugin = exports.stringContentMediaTypePlugin = exports.stringContentEncodingPlugin = exports.stringBase64Plugin = exports.stringAlphanumericPlugin = exports.stitchWithPlugin = exports.stitchPlugin = exports.skipPlugin = exports.requiredIfPlugin = exports.requiredPlugin = exports.readOnlyPlugin = exports.orFailPlugin = exports.optionalIfPlugin = exports.optionalPlugin = exports.oneOfPlugin = exports.objectRecursivelyPlugin = exports.objectPropertyNamesPlugin = exports.objectPatternPropertiesPlugin = exports.objectMinPropertiesPlugin = exports.objectMaxPropertiesPlugin = exports.objectDependentSchemasPlugin = exports.objectDependentRequiredPlugin = exports.objectAdditionalPropertiesSchemaPlugin = exports.objectAdditionalPropertiesPlugin = exports.objectPlugin = exports.numberRangePlugin = exports.numberPositivePlugin = exports.numberNegativePlugin = exports.numberMultipleOfPlugin = exports.numberMinPlugin = exports.numberMaxPlugin = exports.numberIntegerPlugin = exports.numberFinitePlugin = exports.nullablePlugin = exports.literalPlugin = exports.jsonSchemaFullFeaturePlugin = exports.jsonSchemaPlugin = exports.fromContextPlugin = exports.customPlugin = exports.conditionalSchemaPlugin = exports.compareFieldPlugin = exports.booleanTruthyPlugin = exports.booleanFalsyPlugin = exports.arrayUniquePlugin = exports.arrayMinLengthPlugin = exports.arrayMaxLengthPlugin = exports.arrayIncludesPlugin = exports.arrayEachPlugin = exports.arrayContainsPlugin = void 0;
 exports.writeOnlyPlugin = exports.validateIfPlugin = exports.uuidPlugin = exports.unionGuardPlugin = exports.tupleBuilderPlugin = exports.transformPlugin = exports.stringUrlPlugin = exports.stringUriTemplatePlugin = exports.stringUriReferencePlugin = exports.stringTimePlugin = exports.stringStartsWithPlugin = exports.stringRelativeJsonPointerPlugin = exports.stringRegexPlugin = exports.stringPatternPlugin = exports.stringMinPlugin = exports.stringMaxPlugin = exports.stringJsonPointerPlugin = exports.stringIriReferencePlugin = exports.stringIriPlugin = exports.stringIpv6Plugin = exports.stringIpv4Plugin = exports.stringIdnHostnamePlugin = exports.stringIdnEmailPlugin = exports.stringHostnamePlugin = exports.stringExactLengthPlugin = exports.stringEndsWithPlugin = exports.stringEmailPlugin = exports.stringDurationPlugin = void 0;

package/dist/plugins/index.generated.mjs

@@ -1,5 +1,5 @@
-// GENERATED FILE - 手で編集しないでください。
-// 生成元: プラグインディレクトリ構造 (scripts/catalog/build-plugin-catalog.ts)。
+// GENERATED FILE - do not edit by hand.
+// Generated by scripts/catalog/build-plugin-catalog.ts out of the plugin directory structure.
 export { arrayContainsPlugin } from "./array-contains/index.mjs";
 export { arrayEachPlugin } from "./array-each/index.mjs";
 export { arrayIncludesPlugin } from "./array-includes/index.mjs";

package/dist/plugins/manifest.generated.js

@@ -1,6 +1,6 @@
 "use strict";
-// GENERATED FILE - 手で編集しないでください。
-// 生成元: プラグインディレクトリ構造 (scripts/catalog/build-plugin-catalog.ts)。
+// GENERATED FILE - do not edit by hand.
+// Generated by scripts/catalog/build-plugin-catalog.ts out of the plugin directory structure.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PLUGIN_MANIFEST = void 0;
 exports.PLUGIN_MANIFEST = [

package/dist/plugins/manifest.generated.mjs

@@ -1,5 +1,5 @@
-// GENERATED FILE - 手で編集しないでください。
-// 生成元: プラグインディレクトリ構造 (scripts/catalog/build-plugin-catalog.ts)。
+// GENERATED FILE - do not edit by hand.
+// Generated by scripts/catalog/build-plugin-catalog.ts out of the plugin directory structure.
 export const PLUGIN_MANIFEST = [
     { directoryName: "array-contains", subpathName: "arrayContains", tier: "isolated", entryFile: "src/plugins/array-contains/index.ts", exportedSymbols: ["arrayContainsPlugin"] },
     { directoryName: "array-each", subpathName: "arrayEach", tier: "isolated", entryFile: "src/plugins/array-each/index.ts", exportedSymbols: ["arrayEachPlugin"] },

package/dist/plugins/object-additional-properties/select-additional-keys.d.ts

@@ -1,15 +1,15 @@
 /**
- * パターンは build 時に一度だけコンパイルする。実行時は回すだけ、という
- * 設計に合わせるためで、キーごとに new RegExp すると O(キー数 x パターン数)
- * のコンパイルが毎回走る。
+ * Patterns are compiled once, at build time, matching the design where
+ * validation only runs what was already assembled. Compiling per key would
+ * cost O(keys × patterns) compilations on every call.
  *
- * 壊れた正規表現は無視する。スキーマ側の誤りでビルド全体を落とすより、
- * そのパターンが誰にも一致しないほうがまし (Draft-07 は ECMA-262 の
- * 正規表現を求めるが、方言差で通らないものが現実には来る)。
+ * A broken pattern is ignored rather than fatal. Draft-07 asks for ECMA-262
+ * regular expressions and real documents arrive with dialect differences;
+ * having that one pattern match nothing beats refusing the whole build.
  */
 export declare function compilePatterns(patterns: readonly string[] | undefined): readonly RegExp[];
 /**
- * 宣言済みのキー名にも、どのパターンにも該当しないキーを返す。
- * 返る配列は入力の列挙順を保つ (issue のメッセージが安定する)。
+ * Returns the keys matched by neither a declared name nor any pattern,
+ * preserving the input's enumeration order so issue output stays stable.
  */
 export declare function selectAdditionalKeys(value: Readonly<Record<string, unknown>>, known: ReadonlySet<string>, patterns: readonly RegExp[]): readonly string[];

package/dist/plugins/object-additional-properties/select-additional-keys.js

@@ -2,25 +2,25 @@
 // ===========================================================================
 // L7  src/plugins/object-additional-properties/select-additional-keys.ts
 //
-// 「additional なキー」を選ぶ規則。boolean 形とスキーマ形の両方が使う。
+// Which keys count as "additional". Used by both the boolean form and the
+// schema form.
 //
-// Draft-07 §6.5.4 は additionalProperties の対象を「properties にも
-// patternProperties にも該当しないキー」と定めている。パターンを見落とすと
-// `{"patternProperties":{"^v":{}},"additionalProperties":false}` が
-// {"vroom":2} を誤って拒否する (スイートの
-// "patternProperties are not additional properties" がそれを突く)。
+// Draft-07 §6.5.4 defines them as the keys matched by neither `properties`
+// nor `patternProperties`. Miss the patterns and
+// `{"patternProperties":{"^v":{}},"additionalProperties":false}` wrongly
+// rejects {"vroom":2}.
 // ===========================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compilePatterns = compilePatterns;
 exports.selectAdditionalKeys = selectAdditionalKeys;
 /**
- * パターンは build 時に一度だけコンパイルする。実行時は回すだけ、という
- * 設計に合わせるためで、キーごとに new RegExp すると O(キー数 x パターン数)
- * のコンパイルが毎回走る。
+ * Patterns are compiled once, at build time, matching the design where
+ * validation only runs what was already assembled. Compiling per key would
+ * cost O(keys × patterns) compilations on every call.
  *
- * 壊れた正規表現は無視する。スキーマ側の誤りでビルド全体を落とすより、
- * そのパターンが誰にも一致しないほうがまし (Draft-07 は ECMA-262 の
- * 正規表現を求めるが、方言差で通らないものが現実には来る)。
+ * A broken pattern is ignored rather than fatal. Draft-07 asks for ECMA-262
+ * regular expressions and real documents arrive with dialect differences;
+ * having that one pattern match nothing beats refusing the whole build.
  */
 function compilePatterns(patterns) {
     if (patterns === undefined || patterns.length === 0)
@@ -32,19 +32,19 @@ function compilePatterns(patterns) {
         }
         catch {
             try {
-                // "u" が付くと通らない書き方が現実にはある。付けずにもう一度試す。
+                // Some real patterns fail only under "u". Try again without it.
                 compiled.push(new RegExp(pattern));
             }
             catch {
-                // どちらでも駄目なら、このパターンは一致しないものとして扱う。
+                // Failing both ways, treat this pattern as matching nothing.
             }
         }
     }
     return Object.freeze(compiled);
 }
 /**
- * 宣言済みのキー名にも、どのパターンにも該当しないキーを返す。
- * 返る配列は入力の列挙順を保つ (issue のメッセージが安定する)。
+ * Returns the keys matched by neither a declared name nor any pattern,
+ * preserving the input's enumeration order so issue output stays stable.
  */
 function selectAdditionalKeys(value, known, patterns) {
     return Object.keys(value).filter((key) => !known.has(key) && !patterns.some((pattern) => pattern.test(key)));

package/dist/plugins/object-additional-properties/select-additional-keys.mjs

@@ -1,22 +1,22 @@
 // ===========================================================================
 // L7  src/plugins/object-additional-properties/select-additional-keys.ts
 //
-// 「additional なキー」を選ぶ規則。boolean 形とスキーマ形の両方が使う。
+// Which keys count as "additional". Used by both the boolean form and the
+// schema form.
 //
-// Draft-07 §6.5.4 は additionalProperties の対象を「properties にも
-// patternProperties にも該当しないキー」と定めている。パターンを見落とすと
-// `{"patternProperties":{"^v":{}},"additionalProperties":false}` が
-// {"vroom":2} を誤って拒否する (スイートの
-// "patternProperties are not additional properties" がそれを突く)。
+// Draft-07 §6.5.4 defines them as the keys matched by neither `properties`
+// nor `patternProperties`. Miss the patterns and
+// `{"patternProperties":{"^v":{}},"additionalProperties":false}` wrongly
+// rejects {"vroom":2}.
 // ===========================================================================
 /**
- * パターンは build 時に一度だけコンパイルする。実行時は回すだけ、という
- * 設計に合わせるためで、キーごとに new RegExp すると O(キー数 x パターン数)
- * のコンパイルが毎回走る。
+ * Patterns are compiled once, at build time, matching the design where
+ * validation only runs what was already assembled. Compiling per key would
+ * cost O(keys × patterns) compilations on every call.
  *
- * 壊れた正規表現は無視する。スキーマ側の誤りでビルド全体を落とすより、
- * そのパターンが誰にも一致しないほうがまし (Draft-07 は ECMA-262 の
- * 正規表現を求めるが、方言差で通らないものが現実には来る)。
+ * A broken pattern is ignored rather than fatal. Draft-07 asks for ECMA-262
+ * regular expressions and real documents arrive with dialect differences;
+ * having that one pattern match nothing beats refusing the whole build.
  */
 export function compilePatterns(patterns) {
     if (patterns === undefined || patterns.length === 0)
@@ -28,19 +28,19 @@ export function compilePatterns(patterns) {
         }
         catch {
             try {
-                // "u" が付くと通らない書き方が現実にはある。付けずにもう一度試す。
+                // Some real patterns fail only under "u". Try again without it.
                 compiled.push(new RegExp(pattern));
             }
             catch {
-                // どちらでも駄目なら、このパターンは一致しないものとして扱う。
+                // Failing both ways, treat this pattern as matching nothing.
             }
         }
     }
     return Object.freeze(compiled);
 }
 /**
- * 宣言済みのキー名にも、どのパターンにも該当しないキーを返す。
- * 返る配列は入力の列挙順を保つ (issue のメッセージが安定する)。
+ * Returns the keys matched by neither a declared name nor any pattern,
+ * preserving the input's enumeration order so issue output stays stable.
  */
 export function selectAdditionalKeys(value, known, patterns) {
     return Object.keys(value).filter((key) => !known.has(key) && !patterns.some((pattern) => pattern.test(key)));

package/dist/plugins/stitch/stitch.d.ts

@@ -5,11 +5,10 @@ import type { FieldRefs, StitchOut } from "../../plugin-kit/marker.types";
  * The bundle handed to the check at RUN TIME, keyed by the path exactly as
  * declared.
  *
- * 呼び出し側がこれを見ることはもう無い。`.stitch(["price"], ...)` と書いた
- * 時点でパスの集合は分かっているので、述語が受け取る束の型は
- * `PickPaths<TRoot, F>` として組まれる (src/chain/chain-method.types.ts の
- * StitchOut の腕)。この型が残っているのは、実行時に集める側が「キーは
- * パス文字列」という事実を書き留めておく場所だからである。
+ * Callers no longer see this type. Writing `.stitch(["price"], ...)` already
+ * fixes the set of paths, so the bundle the predicate receives is typed per
+ * key from those paths. What survives here is the run-time side's record of
+ * one fact: the keys are the path strings.
  */
 export type StitchFieldValues = Readonly<Record<string, unknown>>;
 /**
@@ -22,19 +21,16 @@ export type StitchFieldValues = Readonly<Record<string, unknown>>;
  */
 export type StitchFieldsOf<TRoot, TFields extends readonly string[]> = PickPaths<TRoot, TFields>;
 /**
- * 1.x の `{ valid, message? }`、名前も形もそのまま。実体は src/types の
- * CrossFieldOutcome で、チェーン層が呼び出し側の型を組むのに参照する —
- * L3 から L7 を import しないための置き場である。
+ * The legacy `{ valid, message? }`, name and shape unchanged. It is declared
+ * where the chain layer can reach it, so that layer never has to import a
+ * plugin to build a caller-facing type.
  */
 export type StitchOutcome = CrossFieldOutcome;
 /**
- * 実行時に build() が受け取る形。**呼び出し側が見る型ではない。**
+ * The shape build() receives at run time. **Not the type a caller sees.**
  *
- * `.stitch(["price", "quantity"], ...)` と書いた時点でパスの集合は分かって
- * いるので、述語が受け取る束は `PickPaths<TRoot, F>` として組まれ、キーごとに
- * 値の型が付く (src/chain/chain-method.types.ts の StitchOut の腕)。
- * ここが `Record<string, unknown>` のままだったのが、その腕を足すまでの
- * stitch である。
+ * Writing `.stitch(["price", "quantity"], ...)` already fixes the set of
+ * paths, so the bundle the predicate receives is typed per key.
  */
 export type StitchCheck = (fieldValues: StitchFieldValues, value: unknown, root: unknown) => StitchOutcome;
 /** 1.x's messageFactory context for this plugin, minus the re-run. */

package/dist/plugins/stitch-with/stitch-with.d.ts

@@ -1,6 +1,6 @@
 import type { MessageContextExtra } from "../../types";
 import type { BundleOut, NarrowedChain } from "../../plugin-kit/marker.types";
-/** 別名 -> ルートのパス。実行時はただの文字列の対応表である。 */
+/** Alias to a path from the root. At run time, a table of strings. */
 export type BundleAliasMap = Readonly<Record<string, string>>;
 export interface StitchWithExtra extends MessageContextExtra {
     readonly aliases: readonly string[];

package/dist/plugins/stitch-with/stitch-with.js

@@ -3,38 +3,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.stitchWithPlugin = void 0;
 // ===========================================================================
 // L7  src/plugins/stitch-with/stitch-with.ts — EXPERIMENTAL.
-// `stitch` の型付き後継。クロスフィールド検証のためのメソッドである。
+// The typed successor to `stitch`, for cross-field validation.
 //
-// stitch の核は「**複数のフィールドを1つの判定にまとめる**」ことなので、
-// 主体は束そのものであって、別名ごとではない。別名ごとにルールを並べる形も
-// 書けるが、それでは `total === price * quantity` が書けず、stitch では
-// なくなる。
+// The point of stitching is to bring SEVERAL FIELDS INTO ONE JUDGEMENT, so
+// the subject is the bundle itself and not each alias. Listing rules per alias
+// is writable but cannot express `total === price * quantity`, at which point
+// it is no longer stitching.
 //
-// stitch との違いは一点だけである。stitch は束を
-// `Readonly<Record<string, unknown>>` として手書きの述語に渡すので、束の中身に
-// ついて型が何も言わない。ここでは束が対応表から組まれて **型が付く**:
+// One difference from `stitch`. There the bundle reaches the predicate as
+// `Readonly<Record<string, unknown>>`, so the type says nothing about its
+// contents. Here the bundle is assembled from a mapping and IS TYPED:
 //
 //     .v("total", (b) => b.number.stitchWith(
 //       { cost: "price", count: "quantity" },
 //       (f) => f.object.custom((bundle) => bundle.cost * bundle.count === 100)
 //     ))
 //
-// `bundle` は `{ cost: number; count: number }` であって Record ではない。
-// メンバー名を綴り違えれば、型を取り違えれば、コンパイルエラーになる。
+// `bundle` is `{ cost: number; count: number }`, not a Record. Misspell a
+// member or mistake its type and it fails to compile.
 //
-// なぜ別名を経由するのか。束をパス文字列でキーすると、その文字列は宣言の場で
-// **パスとして** 解釈される: `"user.name"` は束の中の `user.name` を探しに
-// 行き、束は平たいので見つからない (実測して分かった)。別名は素の識別子なので
-// その衝突が起きず、参照できるのは宣言した別名だけになる。
+// Why aliases rather than paths as keys. A path string used as a bundle key is
+// interpreted AS A PATH where it is declared, so `"user.name"` goes looking
+// for `user.name` inside the bundle and never finds it, the bundle being
+// flat. An alias is a bare identifier, so that collision cannot happen and the
+// only things referable are the aliases actually declared.
 //
-// このファイルに判定は無い。サブチェーンは NarrowedChain と同じ経路で
-// `readonly Rule[]` に解決され、branch がそれを枝にし、エンジンが走らせる。
-// 束専用の収集器をコアに置く案も作って動かしたが、実測でコアが 220 B 増えた
-// (7,590 -> 7,810 B)。stitchWith を使わない利用者が払う形なので採らなかった。
-// 既存の経路に乗せると追加は 0 B である。
-//
-// 1.x が同じ責務の実装を3つ持っていたのは、ここで「もう1つ書く」を選んだ
-// からである。
+// No judgement happens in this file. The sub-chain resolves to
+// `readonly Rule[]` through the same route a narrowed chain takes, and the
+// engine runs it. A bundle-specific collector in the core was built and
+// measured; it added bytes to everyone who never stitches, so this rides the
+// existing route instead and adds none.
 // ===========================================================================
 const types_1 = require("../../types");
 const create_rule_1 = require("../../plugin-kit/create-rule");
@@ -57,7 +55,7 @@ function readMembers(aliasMap) {
         read: (0, index_1.createValueReader)((0, index_1.parseFieldPath)(path)),
     })));
 }
-/** ルートから束を組む。枝の主体はこのオブジェクトになる。 */
+/** Assembles the bundle from the root; this object is the branch's subject. */
 function collectBundle(members, root) {
     const bundle = {};
     for (const member of members)
@@ -76,7 +74,7 @@ exports.stitchWithPlugin = (0, plugin_definition_1.definePlugin)()({
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
             branches: [(0, create_rule_1.branch)(BUNDLE_BRANCH_LABEL, rules)],
-            // 主体の値は見ない。見るのはルートから組んだ束だけである。
+            // The field's own value is not read. Only the assembled bundle is.
             combine: (runners) => {
                 const runner = runners[0];
                 if (runner === undefined)

package/dist/plugins/stitch-with/stitch-with.mjs

@@ -1,37 +1,35 @@
 // ===========================================================================
 // L7  src/plugins/stitch-with/stitch-with.ts — EXPERIMENTAL.
-// `stitch` の型付き後継。クロスフィールド検証のためのメソッドである。
+// The typed successor to `stitch`, for cross-field validation.
 //
-// stitch の核は「**複数のフィールドを1つの判定にまとめる**」ことなので、
-// 主体は束そのものであって、別名ごとではない。別名ごとにルールを並べる形も
-// 書けるが、それでは `total === price * quantity` が書けず、stitch では
-// なくなる。
+// The point of stitching is to bring SEVERAL FIELDS INTO ONE JUDGEMENT, so
+// the subject is the bundle itself and not each alias. Listing rules per alias
+// is writable but cannot express `total === price * quantity`, at which point
+// it is no longer stitching.
 //
-// stitch との違いは一点だけである。stitch は束を
-// `Readonly<Record<string, unknown>>` として手書きの述語に渡すので、束の中身に
-// ついて型が何も言わない。ここでは束が対応表から組まれて **型が付く**:
+// One difference from `stitch`. There the bundle reaches the predicate as
+// `Readonly<Record<string, unknown>>`, so the type says nothing about its
+// contents. Here the bundle is assembled from a mapping and IS TYPED:
 //
 //     .v("total", (b) => b.number.stitchWith(
 //       { cost: "price", count: "quantity" },
 //       (f) => f.object.custom((bundle) => bundle.cost * bundle.count === 100)
 //     ))
 //
-// `bundle` は `{ cost: number; count: number }` であって Record ではない。
-// メンバー名を綴り違えれば、型を取り違えれば、コンパイルエラーになる。
+// `bundle` is `{ cost: number; count: number }`, not a Record. Misspell a
+// member or mistake its type and it fails to compile.
 //
-// なぜ別名を経由するのか。束をパス文字列でキーすると、その文字列は宣言の場で
-// **パスとして** 解釈される: `"user.name"` は束の中の `user.name` を探しに
-// 行き、束は平たいので見つからない (実測して分かった)。別名は素の識別子なので
-// その衝突が起きず、参照できるのは宣言した別名だけになる。
+// Why aliases rather than paths as keys. A path string used as a bundle key is
+// interpreted AS A PATH where it is declared, so `"user.name"` goes looking
+// for `user.name` inside the bundle and never finds it, the bundle being
+// flat. An alias is a bare identifier, so that collision cannot happen and the
+// only things referable are the aliases actually declared.
 //
-// このファイルに判定は無い。サブチェーンは NarrowedChain と同じ経路で
-// `readonly Rule[]` に解決され、branch がそれを枝にし、エンジンが走らせる。
-// 束専用の収集器をコアに置く案も作って動かしたが、実測でコアが 220 B 増えた
-// (7,590 -> 7,810 B)。stitchWith を使わない利用者が払う形なので採らなかった。
-// 既存の経路に乗せると追加は 0 B である。
-//
-// 1.x が同じ責務の実装を3つ持っていたのは、ここで「もう1つ書く」を選んだ
-// からである。
+// No judgement happens in this file. The sub-chain resolves to
+// `readonly Rule[]` through the same route a narrowed chain takes, and the
+// engine runs it. A bundle-specific collector in the core was built and
+// measured; it added bytes to everyone who never stitches, so this rides the
+// existing route instead and adds none.
 // ===========================================================================
 import { PASS, fail, isPlainObject } from "../../types/index.mjs";
 import { branch, composite } from "../../plugin-kit/create-rule.mjs";
@@ -54,7 +52,7 @@ function readMembers(aliasMap) {
         read: createValueReader(parseFieldPath(path)),
     })));
 }
-/** ルートから束を組む。枝の主体はこのオブジェクトになる。 */
+/** Assembles the bundle from the root; this object is the branch's subject. */
 function collectBundle(members, root) {
     const bundle = {};
     for (const member of members)
@@ -73,7 +71,7 @@ export const stitchWithPlugin = /*#__PURE__*/ definePlugin()({
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
             branches: [branch(BUNDLE_BRANCH_LABEL, rules)],
-            // 主体の値は見ない。見るのはルートから組んだ束だけである。
+            // The field's own value is not read. Only the assembled bundle is.
             combine: (runners) => {
                 const runner = runners[0];
                 if (runner === undefined)

package/dist/plugins/string-min/string-min.js

@@ -23,17 +23,15 @@ exports.stringMinPlugin = (0, plugin_definition_1.definePlugin)()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            // min に届いた時点で止める。全長を数える必要があるのは**落ちる**
-            // ときだけで、そのときは値が min より短いのだから走査も短い。
-            // 元は countCodePoints を最大二度呼び、どちらも文字列を最後まで
-            // 歩いていた。符号位置で数えるのは変えない (UTF-16 単位ではない) —
-            // 変えているのは、いつ止めるかだけである。受理パスで 12.7%。
+            // Stops as soon as min is reached. The full length is only needed to
+            // REPORT a failure, and a failing value is shorter than min, so that
+            // walk is short too. Counting is still by code point, not UTF-16 unit;
+            // the only thing that changed is when it stops.
             run: (value) => {
                 if (!(0, types_1.isString)(value))
                     return types_1.PASS;
-                // min が 0 なら空文字列も通る。ループは空文字列で一度も回らないので、
-                // この行が無いと `""` が actual 0 で落ちる — 早期脱出に書き換えた
-                // ときに実際に開いた穴で、既存のテストは一件も気づかなかった。
+                // min of 0 admits the empty string. The loop body never runs on an
+                // empty string, so without this line the empty string fails with 0.
                 if (min === 0)
                     return types_1.PASS;
                 let count = 0;

package/dist/plugins/string-min/string-min.mjs

@@ -20,17 +20,15 @@ export const stringMinPlugin = /*#__PURE__*/ definePlugin()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            // min に届いた時点で止める。全長を数える必要があるのは**落ちる**
-            // ときだけで、そのときは値が min より短いのだから走査も短い。
-            // 元は countCodePoints を最大二度呼び、どちらも文字列を最後まで
-            // 歩いていた。符号位置で数えるのは変えない (UTF-16 単位ではない) —
-            // 変えているのは、いつ止めるかだけである。受理パスで 12.7%。
+            // Stops as soon as min is reached. The full length is only needed to
+            // REPORT a failure, and a failing value is shorter than min, so that
+            // walk is short too. Counting is still by code point, not UTF-16 unit;
+            // the only thing that changed is when it stops.
             run: (value) => {
                 if (!isString(value))
                     return PASS;
-                // min が 0 なら空文字列も通る。ループは空文字列で一度も回らないので、
-                // この行が無いと `""` が actual 0 で落ちる — 早期脱出に書き換えた
-                // ときに実際に開いた穴で、既存のテストは一件も気づかなかった。
+                // min of 0 admits the empty string. The loop body never runs on an
+                // empty string, so without this line the empty string fails with 0.
                 if (min === 0)
                     return PASS;
                 let count = 0;