@maroonedog/luq 2.0.0 → 2.2.0

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

@@ -1,6 +1,16 @@
+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.
+ *
+ * 呼び出し側がこれを見ることはもう無い。`.stitch(["price"], ...)` と書いた
+ * 時点でパスの集合は分かっているので、述語が受け取る束の型は
+ * `PickPaths<TRoot, F>` として組まれる (src/chain/chain-method.types.ts の
+ * StitchOut の腕)。この型が残っているのは、実行時に集める側が「キーは
+ * パス文字列」という事実を書き留めておく場所だからである。
+ */
 export type StitchFieldValues = Readonly<Record<string, unknown>>;
 /**
  * PickPaths applied to a declared tuple: `StitchFieldsOf<Order, ["price",
@@ -11,11 +21,21 @@ 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;
-}
+/**
+ * 1.x の `{ valid, message? }`、名前も形もそのまま。実体は src/types の
+ * CrossFieldOutcome で、チェーン層が呼び出し側の型を組むのに参照する —
+ * L3 から L7 を import しないための置き場である。
+ */
+export type StitchOutcome = CrossFieldOutcome;
+/**
+ * 実行時に build() が受け取る形。**呼び出し側が見る型ではない。**
+ *
+ * `.stitch(["price", "quantity"], ...)` と書いた時点でパスの集合は分かって
+ * いるので、述語が受け取る束は `PickPaths<TRoot, F>` として組まれ、キーごとに
+ * 値の型が付く (src/chain/chain-method.types.ts の StitchOut の腕)。
+ * ここが `Record<string, unknown>` のままだったのが、その腕を足すまでの
+ * stitch である。
+ */
 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 +45,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; } });

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

@@ -0,0 +1 @@
+export { stitchWithPlugin } from "./stitch-with.mjs";

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

@@ -0,0 +1,12 @@
+import type { MessageContextExtra } from "../../types";
+import type { BundleOut, NarrowedChain } from "../../plugin-kit/marker.types";
+/** 別名 -> ルートのパス。実行時はただの文字列の対応表である。 */
+export type BundleAliasMap = Readonly<Record<string, string>>;
+export interface StitchWithExtra extends MessageContextExtra {
+    readonly aliases: readonly string[];
+}
+export declare const stitchWithPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"stitchWith", "stitchWith", readonly ["string", "number", "boolean", "date", "object", "array", "tuple", "union"], {
+    args: readonly [fields: BundleAliasMap, define: NarrowedChain];
+    out: BundleOut;
+    context: StitchWithExtra;
+}>;

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

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stitchWithPlugin = void 0;
+// ===========================================================================
+// L7  src/plugins/stitch-with/stitch-with.ts — EXPERIMENTAL.
+// `stitch` の型付き後継。クロスフィールド検証のためのメソッドである。
+//
+// stitch の核は「**複数のフィールドを1つの判定にまとめる**」ことなので、
+// 主体は束そのものであって、別名ごとではない。別名ごとにルールを並べる形も
+// 書けるが、それでは `total === price * quantity` が書けず、stitch では
+// なくなる。
+//
+// stitch との違いは一点だけである。stitch は束を
+// `Readonly<Record<string, unknown>>` として手書きの述語に渡すので、束の中身に
+// ついて型が何も言わない。ここでは束が対応表から組まれて **型が付く**:
+//
+//     .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 ではない。
+// メンバー名を綴り違えれば、型を取り違えれば、コンパイルエラーになる。
+//
+// なぜ別名を経由するのか。束をパス文字列でキーすると、その文字列は宣言の場で
+// **パスとして** 解釈される: `"user.name"` は束の中の `user.name` を探しに
+// 行き、束は平たいので見つからない (実測して分かった)。別名は素の識別子なので
+// その衝突が起きず、参照できるのは宣言した別名だけになる。
+//
+// このファイルに判定は無い。サブチェーンは NarrowedChain と同じ経路で
+// `readonly Rule[]` に解決され、branch がそれを枝にし、エンジンが走らせる。
+// 束専用の収集器をコアに置く案も作って動かしたが、実測でコアが 220 B 増えた
+// (7,590 -> 7,810 B)。stitchWith を使わない利用者が払う形なので採らなかった。
+// 既存の経路に乗せると追加は 0 B である。
+//
+// 1.x が同じ責務の実装を3つ持っていたのは、ここで「もう1つ書く」を選んだ
+// からである。
+// ===========================================================================
+const types_1 = require("../../types");
+const create_rule_1 = require("../../plugin-kit/create-rule");
+const plugin_definition_1 = require("../../plugin-kit/plugin-definition");
+const index_1 = require("../../path/index");
+const STITCH_WITH_SLOTS = [
+    "string",
+    "number",
+    "boolean",
+    "date",
+    "object",
+    "array",
+    "tuple",
+    "union",
+];
+const BUNDLE_BRANCH_LABEL = "bundle";
+function readMembers(aliasMap) {
+    return Object.freeze(Object.entries(aliasMap).map(([alias, path]) => ({
+        alias,
+        read: (0, index_1.createValueReader)((0, index_1.parseFieldPath)(path)),
+    })));
+}
+/** ルートから束を組む。枝の主体はこのオブジェクトになる。 */
+function collectBundle(members, root) {
+    const bundle = {};
+    for (const member of members)
+        bundle[member.alias] = member.read(root);
+    return bundle;
+}
+exports.stitchWithPlugin = (0, plugin_definition_1.definePlugin)()({
+    name: "stitchWith",
+    method: "stitchWith",
+    slots: STITCH_WITH_SLOTS,
+    build: (ctx, aliasMap, rules) => {
+        const members = readMembers((0, types_1.isPlainObject)(aliasMap) ? aliasMap : {});
+        const aliases = Object.freeze(members.map((member) => member.alias));
+        return (0, create_rule_1.composite)({
+            code: ctx.code,
+            messageFactory: ctx.messageFactory,
+            severity: ctx.severity,
+            branches: [(0, create_rule_1.branch)(BUNDLE_BRANCH_LABEL, rules)],
+            // 主体の値は見ない。見るのはルートから組んだ束だけである。
+            combine: (runners) => {
+                const runner = runners[0];
+                if (runner === undefined)
+                    return () => types_1.PASS;
+                return (_value, runCtx) => {
+                    const outcome = runner.run(collectBundle(members, runCtx.root), runCtx);
+                    return outcome.ok ? types_1.PASS : (0, types_1.fail)({ ...outcome.detail });
+                };
+            },
+            describe: (_detail, msgCtx) => `Cross-field validation failed for ${msgCtx.path}`,
+            buildMessageContext: () => ({ aliases }),
+        });
+    },
+    subChainArguments: [1],
+});

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

@@ -0,0 +1,91 @@
+// ===========================================================================
+// L7  src/plugins/stitch-with/stitch-with.ts — EXPERIMENTAL.
+// `stitch` の型付き後継。クロスフィールド検証のためのメソッドである。
+//
+// stitch の核は「**複数のフィールドを1つの判定にまとめる**」ことなので、
+// 主体は束そのものであって、別名ごとではない。別名ごとにルールを並べる形も
+// 書けるが、それでは `total === price * quantity` が書けず、stitch では
+// なくなる。
+//
+// stitch との違いは一点だけである。stitch は束を
+// `Readonly<Record<string, unknown>>` として手書きの述語に渡すので、束の中身に
+// ついて型が何も言わない。ここでは束が対応表から組まれて **型が付く**:
+//
+//     .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 ではない。
+// メンバー名を綴り違えれば、型を取り違えれば、コンパイルエラーになる。
+//
+// なぜ別名を経由するのか。束をパス文字列でキーすると、その文字列は宣言の場で
+// **パスとして** 解釈される: `"user.name"` は束の中の `user.name` を探しに
+// 行き、束は平たいので見つからない (実測して分かった)。別名は素の識別子なので
+// その衝突が起きず、参照できるのは宣言した別名だけになる。
+//
+// このファイルに判定は無い。サブチェーンは NarrowedChain と同じ経路で
+// `readonly Rule[]` に解決され、branch がそれを枝にし、エンジンが走らせる。
+// 束専用の収集器をコアに置く案も作って動かしたが、実測でコアが 220 B 増えた
+// (7,590 -> 7,810 B)。stitchWith を使わない利用者が払う形なので採らなかった。
+// 既存の経路に乗せると追加は 0 B である。
+//
+// 1.x が同じ責務の実装を3つ持っていたのは、ここで「もう1つ書く」を選んだ
+// からである。
+// ===========================================================================
+import { PASS, fail, isPlainObject } from "../../types/index.mjs";
+import { branch, composite } from "../../plugin-kit/create-rule.mjs";
+import { definePlugin } from "../../plugin-kit/plugin-definition.mjs";
+import { createValueReader, parseFieldPath } from "../../path/index.mjs";
+const STITCH_WITH_SLOTS = [
+    "string",
+    "number",
+    "boolean",
+    "date",
+    "object",
+    "array",
+    "tuple",
+    "union",
+];
+const BUNDLE_BRANCH_LABEL = "bundle";
+function readMembers(aliasMap) {
+    return Object.freeze(Object.entries(aliasMap).map(([alias, path]) => ({
+        alias,
+        read: createValueReader(parseFieldPath(path)),
+    })));
+}
+/** ルートから束を組む。枝の主体はこのオブジェクトになる。 */
+function collectBundle(members, root) {
+    const bundle = {};
+    for (const member of members)
+        bundle[member.alias] = member.read(root);
+    return bundle;
+}
+export const stitchWithPlugin = /*#__PURE__*/ definePlugin()({
+    name: "stitchWith",
+    method: "stitchWith",
+    slots: STITCH_WITH_SLOTS,
+    build: (ctx, aliasMap, rules) => {
+        const members = readMembers(isPlainObject(aliasMap) ? aliasMap : {});
+        const aliases = Object.freeze(members.map((member) => member.alias));
+        return composite({
+            code: ctx.code,
+            messageFactory: ctx.messageFactory,
+            severity: ctx.severity,
+            branches: [branch(BUNDLE_BRANCH_LABEL, rules)],
+            // 主体の値は見ない。見るのはルートから組んだ束だけである。
+            combine: (runners) => {
+                const runner = runners[0];
+                if (runner === undefined)
+                    return () => PASS;
+                return (_value, runCtx) => {
+                    const outcome = runner.run(collectBundle(members, runCtx.root), runCtx);
+                    return outcome.ok ? PASS : fail({ ...outcome.detail });
+                };
+            },
+            describe: (_detail, msgCtx) => `Cross-field validation failed for ${msgCtx.path}`,
+            buildMessageContext: () => ({ aliases }),
+        });
+    },
+    subChainArguments: [1],
+});

package/dist/plugins/stitchWith.d.ts

@@ -0,0 +1 @@
+export * from "./stitch-with/index";

package/dist/plugins/stitchWith.js

@@ -0,0 +1,2 @@
+"use strict";
+module.exports = require("./stitch-with/index");

package/dist/plugins/stitchWith.mjs

@@ -0,0 +1 @@
+export * from "./stitch-with/index.mjs";

package/dist/plugins/string-exact-length/string-exact-length.js

@@ -20,9 +20,9 @@ exports.stringExactLengthPlugin = (0, plugin_definition_1.definePlugin)()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !(0, types_1.isString)(value) || value.length === expected
+            run: (value) => !(0, types_1.isString)(value) || (0, types_1.countCodePoints)(value) === expected
                 ? types_1.PASS
-                : (0, types_1.fail)({ expected, actual: value.length }),
+                : (0, types_1.fail)({ expected, actual: (0, types_1.countCodePoints)(value) }),
             describe: (detail) => `String must have exactly ${String(expected)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

package/dist/plugins/string-exact-length/string-exact-length.mjs

@@ -4,7 +4,7 @@
 // ===========================================================================
 import { check } from "../../plugin-kit/create-rule.mjs";
 import { PluginArgumentError, definePlugin, } from "../../plugin-kit/plugin-definition.mjs";
-import { PASS, fail, isNumber, isString } from "../../types/index.mjs";
+import { PASS, fail, isNumber, countCodePoints, isString } from "../../types/index.mjs";
 export const stringExactLengthPlugin = /*#__PURE__*/ definePlugin()({
     name: "stringExactLength",
     method: "exactLength",
@@ -17,9 +17,9 @@ export const stringExactLengthPlugin = /*#__PURE__*/ definePlugin()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !isString(value) || value.length === expected
+            run: (value) => !isString(value) || countCodePoints(value) === expected
                 ? PASS
-                : fail({ expected, actual: value.length }),
+                : fail({ expected, actual: countCodePoints(value) }),
             describe: (detail) => `String must have exactly ${String(expected)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

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

@@ -20,9 +20,9 @@ exports.stringMaxPlugin = (0, plugin_definition_1.definePlugin)()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !(0, types_1.isString)(value) || value.length <= max
+            run: (value) => !(0, types_1.isString)(value) || (0, types_1.countCodePoints)(value) <= max
                 ? types_1.PASS
-                : (0, types_1.fail)({ expected: max, actual: value.length }),
+                : (0, types_1.fail)({ expected: max, actual: (0, types_1.countCodePoints)(value) }),
             describe: (detail) => `String must have at most ${String(max)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

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

@@ -4,7 +4,7 @@
 // ===========================================================================
 import { check } from "../../plugin-kit/create-rule.mjs";
 import { PluginArgumentError, definePlugin, } from "../../plugin-kit/plugin-definition.mjs";
-import { PASS, fail, isNumber, isString } from "../../types/index.mjs";
+import { PASS, fail, isNumber, countCodePoints, isString } from "../../types/index.mjs";
 export const stringMaxPlugin = /*#__PURE__*/ definePlugin()({
     name: "stringMax",
     method: "max",
@@ -17,9 +17,9 @@ export const stringMaxPlugin = /*#__PURE__*/ definePlugin()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !isString(value) || value.length <= max
+            run: (value) => !isString(value) || countCodePoints(value) <= max
                 ? PASS
-                : fail({ expected: max, actual: value.length }),
+                : fail({ expected: max, actual: countCodePoints(value) }),
             describe: (detail) => `String must have at most ${String(max)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

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

@@ -23,9 +23,27 @@ exports.stringMinPlugin = (0, plugin_definition_1.definePlugin)()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !(0, types_1.isString)(value) || value.length >= min
-                ? types_1.PASS
-                : (0, types_1.fail)({ expected: min, actual: value.length }),
+            // min に届いた時点で止める。全長を数える必要があるのは**落ちる**
+            // ときだけで、そのときは値が min より短いのだから走査も短い。
+            // 元は countCodePoints を最大二度呼び、どちらも文字列を最後まで
+            // 歩いていた。符号位置で数えるのは変えない (UTF-16 単位ではない) —
+            // 変えているのは、いつ止めるかだけである。受理パスで 12.7%。
+            run: (value) => {
+                if (!(0, types_1.isString)(value))
+                    return types_1.PASS;
+                // min が 0 なら空文字列も通る。ループは空文字列で一度も回らないので、
+                // この行が無いと `""` が actual 0 で落ちる — 早期脱出に書き換えた
+                // ときに実際に開いた穴で、既存のテストは一件も気づかなかった。
+                if (min === 0)
+                    return types_1.PASS;
+                let count = 0;
+                for (const _character of value) {
+                    count += 1;
+                    if (count >= min)
+                        return types_1.PASS;
+                }
+                return (0, types_1.fail)({ expected: min, actual: count });
+            },
             describe: (detail) => `String must have at least ${String(min)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

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

@@ -20,9 +20,27 @@ export const stringMinPlugin = /*#__PURE__*/ definePlugin()({
             code: ctx.code,
             messageFactory: ctx.messageFactory,
             severity: ctx.severity,
-            run: (value) => !isString(value) || value.length >= min
-                ? PASS
-                : fail({ expected: min, actual: value.length }),
+            // min に届いた時点で止める。全長を数える必要があるのは**落ちる**
+            // ときだけで、そのときは値が min より短いのだから走査も短い。
+            // 元は countCodePoints を最大二度呼び、どちらも文字列を最後まで
+            // 歩いていた。符号位置で数えるのは変えない (UTF-16 単位ではない) —
+            // 変えているのは、いつ止めるかだけである。受理パスで 12.7%。
+            run: (value) => {
+                if (!isString(value))
+                    return PASS;
+                // min が 0 なら空文字列も通る。ループは空文字列で一度も回らないので、
+                // この行が無いと `""` が actual 0 で落ちる — 早期脱出に書き換えた
+                // ときに実際に開いた穴で、既存のテストは一件も気づかなかった。
+                if (min === 0)
+                    return PASS;
+                let count = 0;
+                for (const _character of value) {
+                    count += 1;
+                    if (count >= min)
+                        return PASS;
+                }
+                return fail({ expected: min, actual: count });
+            },
             describe: (detail) => `String must have at least ${String(min)} characters, but got ` +
                 `${String(detail.actual)}`,
             buildMessageContext: (detail) => ({

package/dist/presets/index.d.ts

@@ -0,0 +1 @@
+export { arrays, everydayRules, numbers, presence, strings } from "./presets";

package/dist/presets/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.strings = exports.presence = exports.numbers = exports.everydayRules = exports.arrays = void 0;
+var presets_1 = require("./presets");
+Object.defineProperty(exports, "arrays", { enumerable: true, get: function () { return presets_1.arrays; } });
+Object.defineProperty(exports, "everydayRules", { enumerable: true, get: function () { return presets_1.everydayRules; } });
+Object.defineProperty(exports, "numbers", { enumerable: true, get: function () { return presets_1.numbers; } });
+Object.defineProperty(exports, "presence", { enumerable: true, get: function () { return presets_1.presence; } });
+Object.defineProperty(exports, "strings", { enumerable: true, get: function () { return presets_1.strings; } });

package/dist/presets/index.mjs

@@ -0,0 +1 @@
+export { arrays, everydayRules, numbers, presence, strings } from "./presets.mjs";

package/dist/presets/presets.d.ts

@@ -0,0 +1,165 @@
+/**
+ * 在る・無い・null。ほぼ全ての宣言がこの三つのどれかを使う。
+ * 使用実績: required 138 / optional 26 / nullable 12。
+ */
+export declare const presence: Readonly<{
+    required: import("..").PluginDefinition<"required", "required", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"excludeMissing">;
+        context: import("..").MessageContextExtra;
+    }>;
+    optional: import("..").PluginDefinition<"optional", "optional", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"excludeNull">;
+        context: import("..").MessageContextExtra;
+    }>;
+    nullable: import("..").PluginDefinition<"nullable", "nullable", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"allowNull">;
+        context: import("..").MessageContextExtra;
+    }>;
+}>;
+/** 文字列の定番。使用実績: stringMin 95 / stringEmail 33 / stringPattern 12。 */
+export declare const strings: Readonly<{
+    stringMin: import("..").PluginDefinition<"stringMin", "min", readonly ["string"], {
+        args: readonly [min: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/string-min/string-min").StringMinContext;
+    }>;
+    stringMax: import("..").PluginDefinition<"stringMax", "max", readonly ["string"], {
+        args: readonly [max: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/string-max/string-max").StringMaxContext;
+    }>;
+    stringPattern: import("..").PluginDefinition<"stringPattern", "pattern", readonly ["string"], {
+        args: readonly [pattern: RegExp];
+        out: import("../plugin-kit").Unchanged;
+        context: {
+            readonly pattern: string;
+        };
+    }>;
+    stringEmail: import("..").PluginDefinition<"stringEmail", "email", readonly ["string"], {
+        args: readonly [options?: import("../plugins/string-email/string-email").EmailFormatOptions];
+        out: import("../plugin-kit").Unchanged;
+        context: {
+            readonly reason: string;
+        };
+    }>;
+}>;
+/** 数値の定番。使用実績: numberMin 43 / numberMax 8。 */
+export declare const numbers: Readonly<{
+    numberMin: import("..").PluginDefinition<"numberMin", "min", readonly ["number"], {
+        args: readonly [min: number, exclusive?: boolean];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/number-min").NumberMinContext;
+    }>;
+    numberMax: import("..").PluginDefinition<"numberMax", "max", readonly ["number"], {
+        args: readonly [max: number, exclusive?: boolean];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/number-max").NumberMaxContext;
+    }>;
+    numberInteger: import("..").PluginDefinition<"numberInteger", "integer", readonly ["number"], {
+        args: readonly [];
+        out: import("../plugin-kit").Unchanged;
+        context: import("..").MessageContextExtra;
+    }>;
+}>;
+/** 配列の定番。要素ごとの規則は arrayEach が運ぶ。 */
+export declare const arrays: Readonly<{
+    arrayMinLength: import("..").PluginDefinition<"arrayMinLength", "minLength", readonly ["array", "tuple"], {
+        args: readonly [min: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/array-min-length").ArrayMinLengthContext;
+    }>;
+    arrayMaxLength: import("..").PluginDefinition<"arrayMaxLength", "maxLength", readonly ["array", "tuple"], {
+        args: readonly [max: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/array-max-length").ArrayMaxLengthContext;
+    }>;
+    arrayEach: import("..").PluginDefinition<"arrayEach", "each", readonly ["array", "tuple"], {
+        args: readonly [element: import("../plugin-kit").ElementChain];
+        out: import("../plugin-kit").Unchanged;
+        context: import("..").MessageContextExtra;
+    }>;
+}>;
+/**
+ * 上の四つを合わせたもの。13プラグイン、gzip で +1,452 B。
+ *
+ * 名前が「common」でないのは、それが何も言っていないからである
+ * (lint の禁止語彙にも入っている)。入っているのは presence と、文字列・数値・
+ * 配列それぞれの定番で、毎日書くのはこの範囲だ、という主張がこの名前である。
+ *
+ * これでも「全部入り」ではない。全部入りが要るなら `@maroonedog/luq/plugins`
+ * のバレルがあり、そちらは 77 個ぶん、gzip で +17,986 B を払う。
+ */
+export declare const everydayRules: Readonly<{
+    arrayMinLength: import("..").PluginDefinition<"arrayMinLength", "minLength", readonly ["array", "tuple"], {
+        args: readonly [min: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/array-min-length").ArrayMinLengthContext;
+    }>;
+    arrayMaxLength: import("..").PluginDefinition<"arrayMaxLength", "maxLength", readonly ["array", "tuple"], {
+        args: readonly [max: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/array-max-length").ArrayMaxLengthContext;
+    }>;
+    arrayEach: import("..").PluginDefinition<"arrayEach", "each", readonly ["array", "tuple"], {
+        args: readonly [element: import("../plugin-kit").ElementChain];
+        out: import("../plugin-kit").Unchanged;
+        context: import("..").MessageContextExtra;
+    }>;
+    numberMin: import("..").PluginDefinition<"numberMin", "min", readonly ["number"], {
+        args: readonly [min: number, exclusive?: boolean];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/number-min").NumberMinContext;
+    }>;
+    numberMax: import("..").PluginDefinition<"numberMax", "max", readonly ["number"], {
+        args: readonly [max: number, exclusive?: boolean];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/number-max").NumberMaxContext;
+    }>;
+    numberInteger: import("..").PluginDefinition<"numberInteger", "integer", readonly ["number"], {
+        args: readonly [];
+        out: import("../plugin-kit").Unchanged;
+        context: import("..").MessageContextExtra;
+    }>;
+    stringMin: import("..").PluginDefinition<"stringMin", "min", readonly ["string"], {
+        args: readonly [min: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/string-min/string-min").StringMinContext;
+    }>;
+    stringMax: import("..").PluginDefinition<"stringMax", "max", readonly ["string"], {
+        args: readonly [max: number];
+        out: import("../plugin-kit").Unchanged;
+        context: import("../plugins/string-max/string-max").StringMaxContext;
+    }>;
+    stringPattern: import("..").PluginDefinition<"stringPattern", "pattern", readonly ["string"], {
+        args: readonly [pattern: RegExp];
+        out: import("../plugin-kit").Unchanged;
+        context: {
+            readonly pattern: string;
+        };
+    }>;
+    stringEmail: import("..").PluginDefinition<"stringEmail", "email", readonly ["string"], {
+        args: readonly [options?: import("../plugins/string-email/string-email").EmailFormatOptions];
+        out: import("../plugin-kit").Unchanged;
+        context: {
+            readonly reason: string;
+        };
+    }>;
+    required: import("..").PluginDefinition<"required", "required", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"excludeMissing">;
+        context: import("..").MessageContextExtra;
+    }>;
+    optional: import("..").PluginDefinition<"optional", "optional", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"excludeNull">;
+        context: import("..").MessageContextExtra;
+    }>;
+    nullable: import("..").PluginDefinition<"nullable", "nullable", readonly import("..").TypeName[], {
+        args: readonly [];
+        out: import("../plugin-kit").PresenceShift<"allowNull">;
+        context: import("..").MessageContextExtra;
+    }>;
+}>;