@maroonedog/luq 2.1.0 → 2.3.0

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;

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/plugin-kit/marker.types.d.ts

@@ -45,6 +45,22 @@ export interface TransformOut {
 export interface GuardOut {
     readonly [MARKER]: "guardOut";
 }
+/**
+ * Like GuardOut, these exist so ChainMethod can give the method a call-site
+ * type parameter. ResolveArgs resolves each argument against a FIXED
+ * TRoot/TValue and cannot make argument 2 depend on argument 1, so a plugin
+ * whose second argument is typed by its first has to come through this door.
+ *
+ * `StitchOut` types the FIELD VALUES a cross-field predicate receives, from
+ * the paths named in argument 1. `BundleOut` types the SUBJECT of a sub-chain,
+ * from the alias-to-path map in argument 1.
+ */
+export interface StitchOut {
+    readonly [MARKER]: "stitchOut";
+}
+export interface BundleOut {
+    readonly [MARKER]: "bundleOut";
+}
 export type PresenceShiftKind = "excludeMissing" | "excludeUndefined" | "excludeNull" | "allowNull";
 export interface PresenceShift<K extends PresenceShiftKind> {
     readonly [MARKER]: "presence";
@@ -75,6 +91,8 @@ export interface OutputMarkerRegistry {
     readonly unchanged: Unchanged;
     readonly transformOut: TransformOut;
     readonly guardOut: GuardOut;
+    readonly stitchOut: StitchOut;
+    readonly bundleOut: BundleOut;
     readonly excludeMissing: PresenceShift<"excludeMissing">;
     readonly excludeUndefined: PresenceShift<"excludeUndefined">;
     readonly excludeNull: PresenceShift<"excludeNull">;

package/dist/plugins/index.generated.d.ts

@@ -41,6 +41,7 @@ export { requiredPlugin } from "./required";
 export { requiredIfPlugin } from "./required-if";
 export { skipPlugin } from "./skip";
 export { stitchPlugin } from "./stitch";
+export { stitchWithPlugin } from "./stitch-with";
 export { stringAlphanumericPlugin } from "./string-alphanumeric";
 export { stringBase64Plugin } from "./string-base64";
 export { stringContentEncodingPlugin } from "./string-content-encoding";

package/dist/plugins/index.generated.js

@@ -1,9 +1,9 @@
 "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.stringDurationPlugin = exports.stringDatetimePlugin = exports.stringDatePlugin = exports.stringContentMediaTypePlugin = exports.stringContentEncodingPlugin = exports.stringBase64Plugin = exports.stringAlphanumericPlugin = 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 = void 0;
+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;
 var array_contains_1 = require("./array-contains");
 Object.defineProperty(exports, "arrayContainsPlugin", { enumerable: true, get: function () { return array_contains_1.arrayContainsPlugin; } });
 var array_each_1 = require("./array-each");
@@ -90,6 +90,8 @@ var skip_1 = require("./skip");
 Object.defineProperty(exports, "skipPlugin", { enumerable: true, get: function () { return skip_1.skipPlugin; } });
 var stitch_1 = require("./stitch");
 Object.defineProperty(exports, "stitchPlugin", { enumerable: true, get: function () { return stitch_1.stitchPlugin; } });
+var stitch_with_1 = require("./stitch-with");
+Object.defineProperty(exports, "stitchWithPlugin", { enumerable: true, get: function () { return stitch_with_1.stitchWithPlugin; } });
 var string_alphanumeric_1 = require("./string-alphanumeric");
 Object.defineProperty(exports, "stringAlphanumericPlugin", { enumerable: true, get: function () { return string_alphanumeric_1.stringAlphanumericPlugin; } });
 var string_base64_1 = require("./string-base64");

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";
@@ -43,6 +43,7 @@ export { requiredPlugin } from "./required/index.mjs";
 export { requiredIfPlugin } from "./required-if/index.mjs";
 export { skipPlugin } from "./skip/index.mjs";
 export { stitchPlugin } from "./stitch/index.mjs";
+export { stitchWithPlugin } from "./stitch-with/index.mjs";
 export { stringAlphanumericPlugin } from "./string-alphanumeric/index.mjs";
 export { stringBase64Plugin } from "./string-base64/index.mjs";
 export { stringContentEncodingPlugin } from "./string-content-encoding/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 = [
@@ -46,6 +46,7 @@ exports.PLUGIN_MANIFEST = [
     { directoryName: "required-if", subpathName: "requiredIf", tier: "isolated", entryFile: "src/plugins/required-if/index.ts", exportedSymbols: ["requiredIfPlugin"] },
     { directoryName: "skip", subpathName: "skip", tier: "isolated", entryFile: "src/plugins/skip/index.ts", exportedSymbols: ["skipPlugin"] },
     { directoryName: "stitch", subpathName: "stitch", tier: "isolated", entryFile: "src/plugins/stitch/index.ts", exportedSymbols: ["stitchPlugin"] },
+    { directoryName: "stitch-with", subpathName: "stitchWith", tier: "isolated", entryFile: "src/plugins/stitch-with/index.ts", exportedSymbols: ["stitchWithPlugin"] },
     { directoryName: "string-alphanumeric", subpathName: "stringAlphanumeric", tier: "isolated", entryFile: "src/plugins/string-alphanumeric/index.ts", exportedSymbols: ["stringAlphanumericPlugin"] },
     { directoryName: "string-base64", subpathName: "stringBase64", tier: "isolated", entryFile: "src/plugins/string-base64/index.ts", exportedSymbols: ["stringBase64Plugin"] },
     { directoryName: "string-content-encoding", subpathName: "stringContentEncoding", tier: "isolated", entryFile: "src/plugins/string-content-encoding/index.ts", exportedSymbols: ["stringContentEncodingPlugin"] },

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"] },
@@ -43,6 +43,7 @@ export const PLUGIN_MANIFEST = [
     { directoryName: "required-if", subpathName: "requiredIf", tier: "isolated", entryFile: "src/plugins/required-if/index.ts", exportedSymbols: ["requiredIfPlugin"] },
     { directoryName: "skip", subpathName: "skip", tier: "isolated", entryFile: "src/plugins/skip/index.ts", exportedSymbols: ["skipPlugin"] },
     { directoryName: "stitch", subpathName: "stitch", tier: "isolated", entryFile: "src/plugins/stitch/index.ts", exportedSymbols: ["stitchPlugin"] },
+    { directoryName: "stitch-with", subpathName: "stitchWith", tier: "isolated", entryFile: "src/plugins/stitch-with/index.ts", exportedSymbols: ["stitchWithPlugin"] },
     { directoryName: "string-alphanumeric", subpathName: "stringAlphanumeric", tier: "isolated", entryFile: "src/plugins/string-alphanumeric/index.ts", exportedSymbols: ["stringAlphanumericPlugin"] },
     { directoryName: "string-base64", subpathName: "stringBase64", tier: "isolated", entryFile: "src/plugins/string-base64/index.ts", exportedSymbols: ["stringBase64Plugin"] },
     { directoryName: "string-content-encoding", subpathName: "stringContentEncoding", tier: "isolated", entryFile: "src/plugins/string-content-encoding/index.ts", exportedSymbols: ["stringContentEncodingPlugin"] },

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

@@ -1,6 +1,15 @@
+import type { CrossFieldOutcome } from "../../types";
 import type { PickPaths } from "../../path/index";
-import type { FieldRefs, Unchanged } from "../../plugin-kit/marker.types";
-/** The bundle handed to the check, keyed by the path exactly as declared. */
+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.
+ *
+ * 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>>;
 /**
  * PickPaths applied to a declared tuple: `StitchFieldsOf<Order, ["price",
@@ -11,11 +20,18 @@ export type StitchFieldValues = Readonly<Record<string, unknown>>;
  * the same alternative-2 move readExternalContext makes for async context.
  */
 export type StitchFieldsOf<TRoot, TFields extends readonly string[]> = PickPaths<TRoot, TFields>;
-/** 1.x's `{ valid, message? }`, unchanged. */
-export interface StitchOutcome {
-    readonly valid: boolean;
-    readonly message?: string;
-}
+/**
+ * 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;
+/**
+ * The shape build() receives at run time. **Not the type a caller sees.**
+ *
+ * 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. */
 export interface StitchExtra {
@@ -25,6 +41,6 @@ export interface StitchExtra {
 }
 export declare const stitchPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"stitch", "stitch", readonly ["string", "number", "boolean", "date", "object", "array", "tuple", "union"], {
     args: readonly [fields: FieldRefs, check: StitchCheck];
-    out: Unchanged;
+    out: StitchOut;
     context: StitchExtra;
 }>;

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

@@ -0,0 +1,2 @@
+export { stitchWithPlugin } from "./stitch-with";
+export type { BundleAliasMap, StitchWithExtra } from "./stitch-with";

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stitchWithPlugin = void 0;
+var stitch_with_1 = require("./stitch-with");
+Object.defineProperty(exports, "stitchWithPlugin", { enumerable: true, get: function () { return stitch_with_1.stitchWithPlugin; } });