@maroonedog/luq 0.1.1-alpha → 2.0.0

package/dist/plugins/tupleBuilder.mjs

@@ -1 +1 @@
-var j=Object.freeze({valid:!0}),x=Object.freeze({valid:!1});function V(t,e=[],o){return{_validators:t,_transforms:e,validate:o||(a=>{for(let n=0;n<e.length;n++)if(!t[n].check(a,a))return x;return j})}}function O(t,e,o){return{check:e,name:t,inputType:o?.inputType,outputType:o?.outputType,metadata:o?{severity:o.severity||"error",async:o.async||!1}:void 0}}function A(t,e,o,a){return{name:t,methodName:e,allowedTypes:o,category:"composable",createComposer(n,r){let i=[],d={add(s){return i.push(s),d},build(){return a(i,n,r)}},y=d;return y[e]=function(...s){return y.add(s)},y}}}function R(t,e,o,a){let n=e.methodName,r=null,i=null;t[n]=function(...d){if(r||(r=e.createComposer(o,a)),r.add(d),t[n]=r[n],r){i=r.build();let y=t._executionPlan;if(!(y&&i&&typeof i.validate=="function")){if(i&&i._validators)for(let s of i._validators)y.addValidator(s.name,(l,g)=>{let f=s.check(l,l);return{valid:f,message:f?void 0:`Validation failed for ${s.name}`}})}}return t}}function E(t,e,o,a){return{...A(t,e,o,a),category:"composable-directly"}}function $(t){switch(t){case"string":return{check:e=>e==null?!0:typeof e=="string",name:"stringType",messageFactory:()=>"Expected string",inputType:"string",outputType:"string",metadata:{severity:"error",async:!1}};case"number":return{check:e=>e==null?!0:typeof e=="number"&&!isNaN(e),name:"numberType",messageFactory:()=>"Expected number",inputType:"number",outputType:"number",metadata:{severity:"error",async:!1}};case"boolean":return{check:e=>e==null?!0:typeof e=="boolean",name:"booleanType",messageFactory:()=>"Expected boolean",inputType:"boolean",outputType:"boolean",metadata:{severity:"error",async:!1}};case"array":return{check:e=>e==null?!0:Array.isArray(e),name:"arrayType",messageFactory:()=>"Expected array",inputType:"array",outputType:"array",metadata:{severity:"error",async:!1}};case"object":return{check:e=>e==null?!0:typeof e=="object"&&e!==null&&!Array.isArray(e),name:"objectType",messageFactory:()=>"Expected object",inputType:"object",outputType:"object",metadata:{severity:"error",async:!1}};case"date":return{check:e=>e==null?!0:e instanceof Date,name:"dateType",messageFactory:()=>"Expected Date",inputType:"date",outputType:"date",metadata:{severity:"error",async:!1}};case"null":return{check:e=>e===null,name:"nullType",messageFactory:()=>"Expected null",inputType:"null",outputType:"null",metadata:{severity:"error",async:!1}};case"any":return{check:()=>!0,name:"anyType",messageFactory:()=>"",inputType:"any",outputType:"any",metadata:{severity:"error",async:!1}};default:return null}}function m(t,e,o,a){let n=a?.validators?[...a.validators]:[];if(!a&&t!=="union"){let d=$(t);d&&n.push(d)}let r=a?.transforms?[...a.transforms]:[],i={_type:t,_fieldPath:e,_validators:n,_transforms:r,build(){return t==="union"&&n.length===0&&n.push({check:()=>!1,name:"unionGuard",messageFactory:()=>"No union type guards defined",inputType:"union",outputType:"union",metadata:{severity:"error",async:!1}}),{_validators:n,_transforms:r}}};return W(i,t,e,o,n,r),i.refineString=()=>m("string",e,o,{validators:n,transforms:r}),i.refineNumber=()=>m("number",e,o,{validators:n,transforms:r}),i.refineBoolean=()=>m("boolean",e,o,{validators:n,transforms:r}),i.refineArray=()=>m("array",e,o,{validators:n,transforms:r}),i.refineObject=()=>m("object",e,o,{validators:n,transforms:r}),i.refineTuple=()=>m("tuple",e,o,{validators:n,transforms:r}),i.refineUnion=()=>m("union",e,o,{validators:n,transforms:r}),i.refineDate=()=>m("date",e,o,{validators:n,transforms:r}),i.refineAny=()=>m("any",e,o,{validators:n,transforms:r}),i}function W(t,e,o,a,n,r){let i=Object.entries(a),d=i.length;for(let y=0;y<d;y++){let[,s]=i[y];if(!s||typeof s!="object")continue;if(s.category?.startsWith("composable")){if(s.allowedTypes&&!s.allowedTypes.includes(e))continue;R(t,s,o,a);continue}if(typeof s.create!="function"||s.allowedTypes&&!s.allowedTypes.includes(e))continue;let{methodName:l,category:g="standard",name:f}=s,b=s.create();t[l]=function(...w){try{let h=b(...w);if(g==="transform"){let N=U(h,w[0]);r.push(N)}else{let N=I(h,o),B=z(N,f||l,e,w,h);n.push(B)}}catch{}return t}}}function U(t,e){return typeof t=="function"?e:t?.__isTransform?t.__transformFn:t?.__isCoerce?o=>t.coerce.coerceFn(o):t?.__isDefault?(o,a)=>t.default.applyDefault(o,a):t?.__isPreprocess?(o,a)=>t.preprocess.applyPreprocess(o,a):e||(o=>o)}function I(t,e){return typeof t=="function"?(o,a)=>t(o,{path:e,allValues:a}).valid:t?.check?(o,a)=>t.check(o,a):()=>!1}function z(t,e,o,a,n){let r={check:t,name:e,code:n?.code||e,pluginName:n?.pluginName||e,getErrorMessage:n?.getErrorMessage,messageFactory:a[a.length-1]?.messageFactory||n?.messageFactory||(()=>"Validation failed"),inputType:o,outputType:o,metadata:n?.metadata||{severity:"error",async:!1}};return n&&(n.shouldSkipAllValidation&&(r.shouldSkipAllValidation=n.shouldSkipAllValidation),n.shouldSkipValidation&&(r.shouldSkipValidation=n.shouldSkipValidation),n.shouldSkipFurtherValidation&&(r.shouldSkipFurtherValidation=n.shouldSkipFurtherValidation),n.skipForNull!==void 0&&(r.skipForNull=n.skipForNull),n.skipForUndefined!==void 0&&(r.skipForUndefined=n.skipForUndefined),n.__isRecursive&&(r.__isRecursive=n.__isRecursive),n.recursive&&(r.recursive=n.recursive)),r}function P(t,e){let o=m("string",t,e),a=m("number",t,e),n=m("boolean",t,e),r=m("array",t,e),i=m("object",t,e),d=m("union",t,e),y=m("tuple",t,e),s=m("date",t,e),l=m("any",t,e);return{string:o,number:a,boolean:n,date:s,array:r,tuple:y,union:d,object:i,any:l}}var L=Array.isArray,D=Object.freeze({code:"TUPLE_NOT_ARRAY",message:"Value must be an array"}),v=Object.freeze({code:"TUPLE_LENGTH_MISMATCH",prefix:"Tuple must have exactly",suffix:"elements, got"}),_=Object.freeze({code:"TUPLE_TOO_SHORT",prefix:"Tuple must have at least",suffix:"elements, got"}),Z=E("tupleBuilder","builder",["tuple"],(t,e,o)=>{let a=t[0]||[];if(a.length===0)return V([O("tupleBuilder",()=>!1,{inputType:"tuple",outputType:"tuple"})]);let n=[],r,i=a.length,d=a[i-1],y=d&&typeof d=="object"&&typeof d!="function"&&(Object.prototype.hasOwnProperty.call(d,"rest")||Object.keys(d).length===0),s={};y?(n=a.slice(0,-1),s=d,r=s.rest):n=a;let l=n.length,g=!!r,f=new Array(l);for(let u=0;u<l;u++){let c=P(`${e}[${u}]`,o),p=n[u](c);p&&typeof p.build=="function"?f[u]=p.build():f[u]=null}let b=null;if(r){let u=P(`${e}[rest]`,o),c=r(u);c&&typeof c.build=="function"&&(b=c.build())}let w=u=>{if(u.length!==l)return!1;for(let c=0;c<l;c++){let p=f[c];if(p&&!p.validate(u[c]).valid)return!1}return!0},h=u=>{let c=u.length;if(c<l)return!1;for(let p=0;p<l;p++){let T=f[p];if(T&&!T.validate(u[p]).valid)return!1}if(b&&c>l){for(let p=l;p<c;p++)if(!b.validate(u[p]).valid)return!1}return!0},N=O("tupleBuilder",u=>L(u)?g?h(u):w(u):!1,{inputType:"tuple",outputType:"tuple",severity:"error",async:!1});return V([N],[],u=>{if(!L(u))return{...x,errors:[{path:e,message:s.messageFactory?.notArray?s.messageFactory.notArray(u):D.message,code:D.code}]};let c=u.length;if(!g&&c!==l)return{...x,errors:[{path:e,message:s.messageFactory?.lengthMismatch?s.messageFactory.lengthMismatch(l,c):`${v.prefix} ${l} ${v.suffix} ${c}`,code:v.code}]};if(g&&c<l)return{...x,errors:[{path:e,message:s.messageFactory?.tooShort?s.messageFactory.tooShort(l,c):`${_.prefix} ${l} ${_.suffix} ${c}`,code:_.code}]};let p=[];for(let T=0;T<l;T++){let C=f[T];if(C){let F=u[T],k=C.validate(F,u);if(!k.isValid()){let M=`${e}[${T}]`;if(k.errors&&k.errors.length>0)for(let S of k.errors)p.push({...S,path:M});else p.push({path:M,message:`Validation failed for element ${T}`,code:"ELEMENT_INVALID"})}}}if(b&&c>l)for(let T=l;T<c;T++){let C=b.validate(u[T]);if(!C.valid&&C.errors){let F=`${e}[${T}]`;for(let k of C.errors)p.push({...k,path:F})}}return p.length>0?{...x,errors:p}:j})});export{Z as tupleBuilderPlugin};
+export * from "./tuple-builder/index.mjs";

package/dist/plugins/union-guard/index.d.ts

@@ -0,0 +1 @@
+export { unionGuardPlugin } from "./union-guard";

package/dist/plugins/union-guard/index.js

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

package/dist/plugins/union-guard/index.mjs

@@ -0,0 +1 @@
+export { unionGuardPlugin } from "./union-guard.mjs";

package/dist/plugins/union-guard/union-guard.d.ts

@@ -0,0 +1,14 @@
+import type { MessageContextExtra } from "../../types";
+import type { GuardOut, NarrowedChain, SelfGuard } from "../../plugin-kit/marker.types";
+/**
+ * WHICH argument positions carry a sub-chain cannot be recovered from a
+ * plugin's type at run time — a NarrowedChain and a RootPredicate are both
+ * plain functions once erased — so src/chain/collect-branch-rules.ts reads it
+ * from this declared field. definePlugin's spec does not carry it yet (see
+ * needsFromOthers), which is why it is spread on rather than passed in.
+ */
+export declare const unionGuardPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"unionGuard", "guard", readonly ["union"], {
+    args: readonly [condition: SelfGuard, define: NarrowedChain];
+    out: GuardOut;
+    context: MessageContextExtra;
+}>;

package/dist/plugins/union-guard/union-guard.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unionGuardPlugin = void 0;
+// ===========================================================================
+// L7  src/plugins/union-guard/union-guard.ts
+// `b.union.guard(isCat, sub => ...)`: a type guard plus the rules that apply
+// once it holds.
+//
+// The chain SYNTHESISES this method's signature from `out: GuardOut` (see
+// src/chain/chain-method.types.ts), which is what makes `condition` a
+// `value is X` predicate and `define` a chain over X. That is also what makes
+// the union coverage check possible: each guard narrows the state by X, and a
+// union with an uncovered member never reaches build().
+//
+// The composite carries ONE branch and the engine runs it. Legacy needed a
+// whole third plugin mechanism (composable-conditional) for this, which
+// docs/legacy-spec/plugin-contract.md records as the reason the mechanism
+// existed at all; the branch/combine pair replaces the mechanism.
+//
+// `b.union` gets no injected type guard, so a value that satisfies no
+// condition simply runs no branch — which is why the coverage check, not this
+// plugin, is what makes a union exhaustive.
+// ===========================================================================
+const types_1 = require("../../types");
+const create_rule_1 = require("../../plugin-kit/create-rule");
+const plugin_definition_1 = require("../../plugin-kit/plugin-definition");
+function runGuardedBranch(runners, condition) {
+    const guarded = runners[0];
+    return (value, ctx) => {
+        if (guarded === undefined || !condition(value))
+            return types_1.PASS;
+        return guarded.run(value, ctx);
+    };
+}
+/**
+ * WHICH argument positions carry a sub-chain cannot be recovered from a
+ * plugin's type at run time — a NarrowedChain and a RootPredicate are both
+ * plain functions once erased — so src/chain/collect-branch-rules.ts reads it
+ * from this declared field. definePlugin's spec does not carry it yet (see
+ * needsFromOthers), which is why it is spread on rather than passed in.
+ */
+exports.unionGuardPlugin = (0, plugin_definition_1.definePlugin)()({
+    name: "unionGuard",
+    method: "guard",
+    slots: ["union"],
+    build: (ctx, condition, define) => (0, create_rule_1.composite)({
+        code: ctx.code,
+        messageFactory: ctx.messageFactory,
+        severity: ctx.severity,
+        branches: [(0, create_rule_1.branch)("guard", define)],
+        combine: (runners) => runGuardedBranch(runners, condition),
+        describe: () => "Value does not satisfy the guarded branch",
+        buildMessageContext: () => ({}),
+    }),
+    subChainArguments: [1],
+});

package/dist/plugins/union-guard/union-guard.mjs

@@ -0,0 +1,53 @@
+// ===========================================================================
+// L7  src/plugins/union-guard/union-guard.ts
+// `b.union.guard(isCat, sub => ...)`: a type guard plus the rules that apply
+// once it holds.
+//
+// The chain SYNTHESISES this method's signature from `out: GuardOut` (see
+// src/chain/chain-method.types.ts), which is what makes `condition` a
+// `value is X` predicate and `define` a chain over X. That is also what makes
+// the union coverage check possible: each guard narrows the state by X, and a
+// union with an uncovered member never reaches build().
+//
+// The composite carries ONE branch and the engine runs it. Legacy needed a
+// whole third plugin mechanism (composable-conditional) for this, which
+// docs/legacy-spec/plugin-contract.md records as the reason the mechanism
+// existed at all; the branch/combine pair replaces the mechanism.
+//
+// `b.union` gets no injected type guard, so a value that satisfies no
+// condition simply runs no branch — which is why the coverage check, not this
+// plugin, is what makes a union exhaustive.
+// ===========================================================================
+import { PASS } from "../../types/index.mjs";
+import { branch, composite } from "../../plugin-kit/create-rule.mjs";
+import { definePlugin } from "../../plugin-kit/plugin-definition.mjs";
+function runGuardedBranch(runners, condition) {
+    const guarded = runners[0];
+    return (value, ctx) => {
+        if (guarded === undefined || !condition(value))
+            return PASS;
+        return guarded.run(value, ctx);
+    };
+}
+/**
+ * WHICH argument positions carry a sub-chain cannot be recovered from a
+ * plugin's type at run time — a NarrowedChain and a RootPredicate are both
+ * plain functions once erased — so src/chain/collect-branch-rules.ts reads it
+ * from this declared field. definePlugin's spec does not carry it yet (see
+ * needsFromOthers), which is why it is spread on rather than passed in.
+ */
+export const unionGuardPlugin = /*#__PURE__*/ definePlugin()({
+    name: "unionGuard",
+    method: "guard",
+    slots: ["union"],
+    build: (ctx, condition, define) => composite({
+        code: ctx.code,
+        messageFactory: ctx.messageFactory,
+        severity: ctx.severity,
+        branches: [branch("guard", define)],
+        combine: (runners) => runGuardedBranch(runners, condition),
+        describe: () => "Value does not satisfy the guarded branch",
+        buildMessageContext: () => ({}),
+    }),
+    subChainArguments: [1],
+});

package/dist/plugins/unionGuard.d.ts

@@ -0,0 +1 @@
+export * from "./union-guard/index";

package/dist/plugins/unionGuard.js

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

package/dist/plugins/unionGuard.mjs

@@ -0,0 +1 @@
+export * from "./union-guard/index.mjs";

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

@@ -0,0 +1 @@
+export { uuidPlugin } from "./uuid";

package/dist/plugins/uuid/index.js

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

package/dist/plugins/uuid/index.mjs

@@ -0,0 +1 @@
+export { uuidPlugin } from "./uuid.mjs";

package/dist/plugins/uuid/uuid.d.ts

@@ -0,0 +1,10 @@
+import type { Unchanged } from "../../plugin-kit/marker.types";
+/** 1.x supports 1, 3, 4, 5, 6, 7 and 8. Version 2 is deliberately absent. */
+export type UuidVersion = 1 | 3 | 4 | 5 | 6 | 7 | 8;
+export declare const uuidPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"uuid", "uuid", readonly ["string"], {
+    args: readonly [version?: UuidVersion | readonly UuidVersion[]];
+    out: Unchanged;
+    context: {
+        readonly versions: readonly number[];
+    };
+}>;

package/dist/plugins/uuid/uuid.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidPlugin = void 0;
+// ===========================================================================
+// L7  src/plugins/uuid/uuid.ts
+// `.uuid(version?)`. The DIRECTORY is `uuid`, not `string-uuid`, so the 1.x
+// subpath `@maroonedog/luq/plugins/uuid` needs no override.
+//
+// 1.x carried three names for one thing (export `uuidPlugin`, registry name
+// "stringUuid", method "uuid") and emitted TWO codes from one plugin ("uuid"
+// with no argument, "uuidVersion" with one). Here the registry name is "uuid",
+// so the export, the method, the directory, the subpath and the default error
+// code are all the same word, and an argument never moves the code.
+// ===========================================================================
+const create_rule_1 = require("../../plugin-kit/create-rule");
+const plugin_definition_1 = require("../../plugin-kit/plugin-definition");
+const types_1 = require("../../types");
+const SUPPORTED_VERSIONS = [1, 3, 4, 5, 6, 7, 8];
+/** Version nibble 1-8, variant nibble 8/9/a/b, case-insensitive. */
+const ANY_VERSION = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function patternForVersion(version) {
+    return new RegExp(`^[0-9a-f]{8}-[0-9a-f]{4}-${String(version)}[0-9a-f]{3}-` +
+        `[89ab][0-9a-f]{3}-[0-9a-f]{12}$`, "i");
+}
+function toVersionList(version) {
+    if (version === undefined)
+        return [];
+    return (0, types_1.isArray)(version) ? version : [version];
+}
+exports.uuidPlugin = (0, plugin_definition_1.definePlugin)()({
+    name: "uuid",
+    method: "uuid",
+    slots: ["string"],
+    build: (ctx, version) => {
+        const versions = toVersionList(version);
+        for (const candidate of versions) {
+            if (!SUPPORTED_VERSIONS.includes(candidate)) {
+                throw new plugin_definition_1.PluginArgumentError(ctx.pluginName, "version", candidate);
+            }
+        }
+        const patterns = versions.length === 0 ? [ANY_VERSION] : versions.map(patternForVersion);
+        const printed = versions.length === 0
+            ? ""
+            : `v${versions.map((each) => String(each)).join(", v")} `;
+        return (0, create_rule_1.check)({
+            code: ctx.code,
+            messageFactory: ctx.messageFactory,
+            severity: ctx.severity,
+            run: (value) => !(0, types_1.isString)(value) || patterns.some((pattern) => pattern.test(value))
+                ? types_1.PASS
+                : (0, types_1.fail)({ actual: value }),
+            describe: () => `Value must be a valid UUID ${printed}format`,
+            buildMessageContext: () => ({ versions }),
+        });
+    },
+});

package/dist/plugins/uuid/uuid.mjs

@@ -0,0 +1,53 @@
+// ===========================================================================
+// L7  src/plugins/uuid/uuid.ts
+// `.uuid(version?)`. The DIRECTORY is `uuid`, not `string-uuid`, so the 1.x
+// subpath `@maroonedog/luq/plugins/uuid` needs no override.
+//
+// 1.x carried three names for one thing (export `uuidPlugin`, registry name
+// "stringUuid", method "uuid") and emitted TWO codes from one plugin ("uuid"
+// with no argument, "uuidVersion" with one). Here the registry name is "uuid",
+// so the export, the method, the directory, the subpath and the default error
+// code are all the same word, and an argument never moves the code.
+// ===========================================================================
+import { check } from "../../plugin-kit/create-rule.mjs";
+import { PluginArgumentError, definePlugin, } from "../../plugin-kit/plugin-definition.mjs";
+import { PASS, fail, isArray, isString } from "../../types/index.mjs";
+const SUPPORTED_VERSIONS = [1, 3, 4, 5, 6, 7, 8];
+/** Version nibble 1-8, variant nibble 8/9/a/b, case-insensitive. */
+const ANY_VERSION = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function patternForVersion(version) {
+    return new RegExp(`^[0-9a-f]{8}-[0-9a-f]{4}-${String(version)}[0-9a-f]{3}-` +
+        `[89ab][0-9a-f]{3}-[0-9a-f]{12}$`, "i");
+}
+function toVersionList(version) {
+    if (version === undefined)
+        return [];
+    return isArray(version) ? version : [version];
+}
+export const uuidPlugin = /*#__PURE__*/ definePlugin()({
+    name: "uuid",
+    method: "uuid",
+    slots: ["string"],
+    build: (ctx, version) => {
+        const versions = toVersionList(version);
+        for (const candidate of versions) {
+            if (!SUPPORTED_VERSIONS.includes(candidate)) {
+                throw new PluginArgumentError(ctx.pluginName, "version", candidate);
+            }
+        }
+        const patterns = versions.length === 0 ? [ANY_VERSION] : versions.map(patternForVersion);
+        const printed = versions.length === 0
+            ? ""
+            : `v${versions.map((each) => String(each)).join(", v")} `;
+        return check({
+            code: ctx.code,
+            messageFactory: ctx.messageFactory,
+            severity: ctx.severity,
+            run: (value) => !isString(value) || patterns.some((pattern) => pattern.test(value))
+                ? PASS
+                : fail({ actual: value }),
+            describe: () => `Value must be a valid UUID ${printed}format`,
+            buildMessageContext: () => ({ versions }),
+        });
+    },
+});

package/dist/plugins/uuid.d.ts

@@ -1,95 +1 @@
-import { ValidationOptions } from "../core/plugin/types";
-declare const SUPPORTED_VERSIONS: readonly [1, 3, 4, 5, 6, 7, 8];
-type UUIDVersion = (typeof SUPPORTED_VERSIONS)[number];
-/**
- * @luq-plugin
- * @name uuid
- * @category standard
- * @description Validates that a string is a valid UUID (Universally Unique Identifier)
- * @allowedTypes ["string"]
- * @see https://tools.ietf.org/html/rfc4122 - RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace
- * @see https://developer.mozilla.org/en-US/docs/Glossary/UUID - MDN UUID Reference
- * @example
- * ```typescript
- * // Basic usage - validate any UUID version (RFC 4122 compliant)
- * const validator = Builder()
- *   .use(uuidPlugin)
- *   .for<Entity>()
- *   .v("id", (b) => b.string.uuid())
- *   .v("correlationId", (b) => b.string.required().uuid())
- *   .build();
- *
- * // Validate specific UUID version
- * builder.v("userId", b => b.string.uuid(4))  // UUID v4 only
- * builder.v("namespaceId", b => b.string.uuid(5))  // UUID v5 only
- * builder.v("timestamp", b => b.string.uuid(7))  // UUID v7 only (time-based)
- *
- * // ✅ VALID UUID formats (RFC 4122)
- * // UUID v1 (MAC address + timestamp based)
- * validator.parse({ id: "12345678-1234-1234-8123-123456789abc" });
- * validator.parse({ id: "f47ac10b-58cc-4372-a567-0e02b2c3d479" });
- *
- * // UUID v3 (MD5 hash based)
- * validator.parse({ id: "6ba7b810-9dad-11d1-80b4-00c04fd430c8" });
- * validator.parse({ id: "12345678-1234-3234-8123-123456789abc" });
- *
- * // UUID v4 (random)
- * validator.parse({ id: "550e8400-e29b-41d4-a716-446655440000" });
- * validator.parse({ id: "f47ac10b-58cc-4372-a567-0e02b2c3d479" });
- * validator.parse({ id: "12345678-1234-4234-9123-123456789abc" });
- *
- * // UUID v5 (SHA-1 hash based)
- * validator.parse({ id: "6ba7b811-9dad-11d1-80b4-00c04fd430c8" });
- * validator.parse({ id: "12345678-1234-5234-8123-123456789abc" });
- *
- * // UUID v6 (reordered timestamp)
- * validator.parse({ id: "1EC9414C-232A-6B00-B3C8-9E6BDECED846" });
- * validator.parse({ id: "12345678-1234-6234-9123-123456789abc" });
- *
- * // UUID v7 (Unix timestamp based)
- * validator.parse({ id: "017F22E2-79B0-7CC3-98C4-DC0C0C07398F" });
- * validator.parse({ id: "12345678-1234-7234-8123-123456789abc" });
- *
- * // UUID v8 (custom/application-specific)
- * validator.parse({ id: "12345678-1234-8234-9123-123456789abc" });
- *
- * // Case insensitive
- * validator.parse({ id: "F47AC10B-58CC-4372-A567-0E02B2C3D479" });
- * validator.parse({ id: "f47ac10b-58cc-4372-a567-0e02b2c3d479" });
- *
- * // ❌ INVALID UUID formats
- * validator.parse({ id: "not-a-uuid" });                      // Plain text
- * validator.parse({ id: "12345678-1234-1234-1234-123456789" }); // Too short
- * validator.parse({ id: "12345678-1234-1234-1234-123456789abcd" }); // Too long
- * validator.parse({ id: "12345678-1234-0234-8123-123456789abc" }); // Invalid version (0)
- * validator.parse({ id: "12345678-1234-9234-8123-123456789abc" }); // Invalid version (9)
- * validator.parse({ id: "12345678-1234-4234-0123-123456789abc" }); // Invalid variant (0)
- * validator.parse({ id: "12345678-1234-4234-c123-123456789abc" }); // Invalid variant (c)
- * validator.parse({ id: "12345678-1234-4234-g123-123456789abc" }); // Invalid hex char (g)
- * validator.parse({ id: "12345678123412348123123456789abc" });     // Missing hyphens
- * validator.parse({ id: "12345678-1234-4234-8123-123456789ab" });  // Missing last char
- * validator.parse({ id: "12345678-1234-4234-8123-123456789abcX" }); // Extra char
- * validator.parse({ id: "" });                                    // Empty string
- * validator.parse({ id: "12345678-1234-4234-8123-123456789ab " }); // Trailing space
- * validator.parse({ id: " 12345678-1234-4234-8123-123456789abc" }); // Leading space
- * ```
- * @params
- * - version?: 1 | 3 | 4 | 5 | 6 | 7 | 8 - Specific UUID version to validate (optional)
- * - options?: { messageFactory?: (context: MessageContext) => string } - Optional configuration
- * @returns Validation function that returns true if string is a valid UUID
- * @customError
- * ```typescript
- * .uuid(4, {
- *   messageFactory: ({ path, value, params }) =>
- *     `${path} must be a valid UUID v${params.version} (received: ${value})`
- * })
- * ```
- * @since 0.1.0-alpha
- */
-export declare const uuidPlugin: import("../index").TypedPlugin<"stringUuid", "uuid", (version?: UUIDVersion | readonly UUIDVersion[], options?: ValidationOptions) => {
-    check: (value: any) => boolean;
-    code: string;
-    getErrorMessage: (value: any, path: string) => string;
-    params: (1 | 5 | 7 | 3 | 4 | ValidationOptions<{}> | 6 | 8 | readonly (1 | 5 | 7 | 3 | 4 | 6 | 8)[])[];
-}, readonly ["string"], "validator", "standard">;
-export {};
+export * from "./uuid/index";

package/dist/plugins/uuid.js

@@ -1 +1,2 @@
-"use strict";var u=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var c=(e,n)=>{for(var r in n)u(e,r,{get:n[r],enumerable:!0})},f=(e,n,r,m)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of g(n))!y.call(e,i)&&i!==r&&u(e,i,{get:()=>n[i],enumerable:!(m=d(n,i))||m.enumerable});return e};var I=e=>f(u({},"__esModule",{value:!0}),e);var C={};c(C,{uuidPlugin:()=>R});module.exports=I(C);var N=(e,n,r,m)=>{let o=(t=>(...a)=>{let s=t(...a);return s&&typeof s=="object"&&"check"in s?{...s,pluginName:m}:s})(r);switch(e){case"conditional":return(t,...a)=>o(t,...a);case"fieldReference":return(t,...a)=>o(t,...a);case"multiFieldReference":return o;case"transform":return t=>o(t);case"arrayElement":return(t,...a)=>o(t,...a);case"context":return t=>o(t);default:return o}};function p(e){let{name:n,methodName:r,allowedTypes:m,category:i,impl:o}=e;return{name:n,methodName:r,allowedTypes:m,category:i,create:()=>N(i,r,o,n)}}function x(e){return e.version?`Value must be a valid UUID ${e.version} format`:"Value must be a valid UUID format"}var P=["string"],h=[1,3,4,5,6,7,8];function U(e){return new RegExp(`^[0-9a-f]{8}-[0-9a-f]{4}-${e}[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$`,"i")}var T={};for(let e of h)T[e]=U(e);var E=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,R=p({name:"stringUuid",methodName:"uuid",allowedTypes:P,category:"standard",impl:(e,n)=>{let r=n?.messageFactory||x;if(!e){let t=n?.code||"uuid";return{check:a=>typeof a!="string"?!0:E.test(a),code:t,getErrorMessage:(a,s)=>r({path:s,value:a,code:t}),params:[e,n]}}let m=Array.isArray(e)?e:[e],i=Array.isArray(e)?`v${e.join(", v")}`:`v${e}`,o=n?.code||"uuidVersion";return{check:t=>{if(typeof t!="string")return!0;let a=m.length;for(let s=0;s<a;s++){let l=m[s];if(T[l]&&T[l].test(t))return!0}return!1},code:o,getErrorMessage:(t,a)=>r({path:a,value:t,code:o,version:i}),params:[e,n]}}});0&&(module.exports={uuidPlugin});
+"use strict";
+module.exports = require("./uuid/index");

package/dist/plugins/uuid.mjs

@@ -1 +1 @@
-var p=(e,o,s,i)=>{let a=(n=>(...t)=>{let r=n(...t);return r&&typeof r=="object"&&"check"in r?{...r,pluginName:i}:r})(s);switch(e){case"conditional":return(n,...t)=>a(n,...t);case"fieldReference":return(n,...t)=>a(n,...t);case"multiFieldReference":return a;case"transform":return n=>a(n);case"arrayElement":return(n,...t)=>a(n,...t);case"context":return n=>a(n);default:return a}};function T(e){let{name:o,methodName:s,allowedTypes:i,category:m,impl:a}=e;return{name:o,methodName:s,allowedTypes:i,category:m,create:()=>p(m,s,a,o)}}function d(e){return e.version?`Value must be a valid UUID ${e.version} format`:"Value must be a valid UUID format"}var g=["string"],y=[1,3,4,5,6,7,8];function c(e){return new RegExp(`^[0-9a-f]{8}-[0-9a-f]{4}-${e}[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$`,"i")}var u={};for(let e of y)u[e]=c(e);var f=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,x=T({name:"stringUuid",methodName:"uuid",allowedTypes:g,category:"standard",impl:(e,o)=>{let s=o?.messageFactory||d;if(!e){let n=o?.code||"uuid";return{check:t=>typeof t!="string"?!0:f.test(t),code:n,getErrorMessage:(t,r)=>s({path:r,value:t,code:n}),params:[e,o]}}let i=Array.isArray(e)?e:[e],m=Array.isArray(e)?`v${e.join(", v")}`:`v${e}`,a=o?.code||"uuidVersion";return{check:n=>{if(typeof n!="string")return!0;let t=i.length;for(let r=0;r<t;r++){let l=i[r];if(u[l]&&u[l].test(n))return!0}return!1},code:a,getErrorMessage:(n,t)=>s({path:t,value:n,code:a,version:m}),params:[e,o]}}});export{x as uuidPlugin};
+export * from "./uuid/index.mjs";

package/dist/plugins/validate-if/index.d.ts

@@ -0,0 +1 @@
+export { validateIfPlugin } from "./validate-if";

package/dist/plugins/validate-if/index.js

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

package/dist/plugins/validate-if/index.mjs

@@ -0,0 +1 @@
+export { validateIfPlugin } from "./validate-if.mjs";

package/dist/plugins/validate-if/validate-if.d.ts

@@ -0,0 +1,7 @@
+import type { MessageContextExtra, TypeName } from "../../types";
+import type { RootPredicate, Unchanged } from "../../plugin-kit/marker.types";
+export declare const validateIfPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"validateIf", "validateIf", readonly TypeName[], {
+    args: readonly [when: RootPredicate];
+    out: Unchanged;
+    context: MessageContextExtra;
+}>;

package/dist/plugins/validate-if/validate-if.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateIfPlugin = void 0;
+const create_rule_1 = require("../../plugin-kit/create-rule");
+const plugin_definition_1 = require("../../plugin-kit/plugin-definition");
+const VALIDATE_IF_SLOTS = [
+    "string",
+    "number",
+    "boolean",
+    "date",
+    "array",
+    "tuple",
+    "object",
+    "union",
+    "any",
+];
+exports.validateIfPlugin = (0, plugin_definition_1.definePlugin)()({
+    name: "validateIf",
+    method: "validateIf",
+    slots: VALIDATE_IF_SLOTS,
+    build: (ctx, when) => (0, create_rule_1.gate)(ctx.code, (_value, ruleContext) => when(ruleContext.root, ruleContext.item)),
+});

package/dist/plugins/validate-if/validate-if.mjs

@@ -0,0 +1,19 @@
+import { gate } from "../../plugin-kit/create-rule.mjs";
+import { definePlugin } from "../../plugin-kit/plugin-definition.mjs";
+const VALIDATE_IF_SLOTS = [
+    "string",
+    "number",
+    "boolean",
+    "date",
+    "array",
+    "tuple",
+    "object",
+    "union",
+    "any",
+];
+export const validateIfPlugin = /*#__PURE__*/ definePlugin()({
+    name: "validateIf",
+    method: "validateIf",
+    slots: VALIDATE_IF_SLOTS,
+    build: (ctx, when) => gate(ctx.code, (_value, ruleContext) => when(ruleContext.root, ruleContext.item)),
+});

package/dist/plugins/validateIf.d.ts

@@ -1,57 +1 @@
-import { ValidationOptions, MessageContext } from "../core/plugin/types";
-export interface ValidateIfContext extends MessageContext {
-    condition?: boolean;
-}
-/**
- * @luq-plugin
- * @name validateIf
- * @category conditional
- * @description Conditionally applies all validation rules to a field based on a dynamic condition, with support for array context validation
- * @allowedTypes ["string", "number", "boolean", "array", "object", "date", "union"]
- * @example
- * ```typescript
- * // Validate URL only when custom endpoint is enabled
- * const validator = Builder()
- *   .use(validateIfPlugin)
- *   .for<ConfigData>()
- *   .v("customEndpoint", b =>
- *     b.string
- *       .validateIf(values => values.useCustomEndpoint)
- *       .url()
- *       .min(10)
- *   )
- *   .build();
- *
- * // Skip validation in local environment
- * builder.v("apiKey", b =>
- *   b.string
- *     .validateIf(values => values.environment !== 'local')
- *     .required()
- *     .min(32)
- * )
- *
- * // Conditional sections in forms
- * builder.v("businessDetails.taxId", b =>
- *   b.string
- *     .validateIf(values => values.accountType === 'business')
- *     .required()
- *     .pattern(/^\d{9}$/)
- * )
- * ```
- * @params
- * - condition: (allValues: TObject, arrayContext?: ArrayContext) => boolean - Function that returns true if validation should run, with access to array context
- * - options?: ValidationOptions - Optional configuration
- * @returns Validation function that skips all validations when condition is false
- * @customError
- * ```typescript
- * This plugin does not generate errors - it controls whether validation runs
- * ```
- * @since 0.1.0-alpha
- */
-export declare const validateIfPlugin: import("../index").TypedPlugin<"validateIf", "validateIf", <TObject>(condition: (allValues: TObject, arrayContext?: import("./types").ArrayContext) => boolean, options?: ValidationOptions<ValidateIfContext>) => {
-    check: (value: any, allValues?: TObject, arrayContext?: import("./types").ArrayContext) => boolean;
-    code: string;
-    getErrorMessage: () => never;
-    params: (((allValues: TObject, arrayContext?: import("./types").ArrayContext) => boolean) | ValidationOptions<ValidateIfContext>)[];
-    shouldSkipAllValidation: (value: any, allValues?: TObject, arrayContext?: import("./types").ArrayContext) => boolean;
-}, readonly ["string", "number", "boolean", "array", "object", "date", "union"], "validator", "conditional">;
+export * from "./validate-if/index";

package/dist/plugins/validateIf.js

@@ -1 +1,2 @@
-"use strict";var m=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var g=(e,n)=>{for(var r in n)m(e,r,{get:n[r],enumerable:!0})},y=(e,n,r,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of T(n))!d.call(e,t)&&t!==r&&m(e,t,{get:()=>n[t],enumerable:!(a=p(n,t))||a.enumerable});return e};var c=e=>y(m({},"__esModule",{value:!0}),e);var h={};g(h,{validateIfPlugin:()=>N});module.exports=c(h);var f=(e,n,r,a)=>{let o=(i=>(...l)=>{let s=i(...l);return s&&typeof s=="object"&&"check"in s?{...s,pluginName:a}:s})(r);switch(e){case"conditional":return(i,...l)=>o(i,...l);case"fieldReference":return(i,...l)=>o(i,...l);case"multiFieldReference":return o;case"transform":return i=>o(i);case"arrayElement":return(i,...l)=>o(i,...l);case"context":return i=>o(i);default:return o}};function u(e){let{name:n,methodName:r,allowedTypes:a,category:t,impl:o}=e;return{name:n,methodName:r,allowedTypes:a,category:t,create:()=>f(t,r,o,n)}}var w=Object.freeze({valid:!0,__skipAllValidation:!0}),x=["string","number","boolean","array","object","date","union"],N=u({name:"validateIf",methodName:"validateIf",allowedTypes:x,category:"conditional",impl:(e,n)=>({check:(r,a,t)=>(!a||!e(a,t),!0),code:"validateIf",getErrorMessage:()=>{throw new Error("validateIf plugin should never generate errors")},params:[e,n],shouldSkipAllValidation:(r,a,t)=>a?!e(a,t):!1})});0&&(module.exports={validateIfPlugin});
+"use strict";
+module.exports = require("./validate-if/index");

package/dist/plugins/validateIf.mjs

@@ -1 +1 @@
-var u=(a,l,i,t)=>{let e=(n=>(...o)=>{let s=n(...o);return s&&typeof s=="object"&&"check"in s?{...s,pluginName:t}:s})(i);switch(a){case"conditional":return(n,...o)=>e(n,...o);case"fieldReference":return(n,...o)=>e(n,...o);case"multiFieldReference":return e;case"transform":return n=>e(n);case"arrayElement":return(n,...o)=>e(n,...o);case"context":return n=>e(n);default:return e}};function m(a){let{name:l,methodName:i,allowedTypes:t,category:r,impl:e}=a;return{name:l,methodName:i,allowedTypes:t,category:r,create:()=>u(r,i,e,l)}}var g=Object.freeze({valid:!0,__skipAllValidation:!0}),p=["string","number","boolean","array","object","date","union"],y=m({name:"validateIf",methodName:"validateIf",allowedTypes:p,category:"conditional",impl:(a,l)=>({check:(i,t,r)=>(!t||!a(t,r),!0),code:"validateIf",getErrorMessage:()=>{throw new Error("validateIf plugin should never generate errors")},params:[a,l],shouldSkipAllValidation:(i,t,r)=>t?!a(t,r):!1})});export{y as validateIfPlugin};
+export * from "./validate-if/index.mjs";

package/dist/plugins/write-only/index.d.ts

@@ -0,0 +1 @@
+export { writeOnlyPlugin } from "./write-only";

package/dist/plugins/write-only/index.js

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

package/dist/plugins/write-only/index.mjs

@@ -0,0 +1 @@
+export { writeOnlyPlugin } from "./write-only.mjs";

package/dist/plugins/write-only/write-only.d.ts

@@ -0,0 +1,7 @@
+import type { MessageContextExtra } from "../../types";
+import type { Unchanged } from "../../plugin-kit/marker.types";
+export declare const writeOnlyPlugin: import("../../plugin-kit/plugin-definition").PluginDefinition<"writeOnly", "writeOnly", readonly ["string", "number", "boolean", "date", "array", "object"], {
+    args: readonly [];
+    out: Unchanged;
+    context: MessageContextExtra;
+}>;