@pithos/core 2.0.0

package/dist/kanon/schemas/constraints/refine/array.js

@@ -0,0 +1,55 @@
+import { isCoerced } from "../../../types/base";
+import { ERROR_MESSAGES_COMPOSITION } from "../../../core/consts/messages";
+/**
+ * Adds a refinement to an array schema.
+ * Returns a base ArraySchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineArray = (schema, refinement) => {
+    const itemSchema = schema.itemSchema;
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "array",
+        message: schema.message,
+        itemSchema,
+        refinements: newRefinements,
+        validator: ((value) => {
+            if (!Array.isArray(value)) {
+                return schema.message || ERROR_MESSAGES_COMPOSITION.array;
+            }
+            let coercedArray = null;
+            for (let i = 0; i < value.length; i++) {
+                const itemResult = itemSchema.validator(value[i]);
+                if (itemResult === true) {
+                    if (coercedArray) {
+                        coercedArray[i] = value[i];
+                    }
+                }
+                else if (isCoerced(itemResult)) {
+                    if (!coercedArray) {
+                        coercedArray = value.slice(0, i);
+                    }
+                    coercedArray[i] = itemResult.coerced;
+                }
+                else {
+                    return `[${i}]: ${itemResult}`;
+                }
+            }
+            const finalArray = coercedArray ?? value;
+            for (let i = 0; i < newRefinements.length; i++) {
+                const result = newRefinements[i](finalArray);
+                if (result !== true)
+                    return result;
+            }
+            if (coercedArray) {
+                return { coerced: coercedArray };
+            }
+            return true;
+        }),
+    };
+};
+//# sourceMappingURL=array.js.map

package/dist/kanon/schemas/constraints/refine/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/array.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;GAKG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAA6D,EAC7D,UAAyD,EAChC,EAAE;IAC3B,MAAM,UAAU,GAAI,MAAkC,CAAC,UAAU,CAAC;IAIlE,MAAM,cAAc,GAA+C,MAAM,CAAC,WAAW;QACnF,CAAC,CAAC,CAAC,GAAI,MAAM,CAAC,WAA0D,EAAE,UAAU,CAAC;QACrF,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,OAAgB;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU;QACV,WAAW,EAAE,cAA4D;QACzE,SAAS,EAAE,CAAC,CAAC,KAAc,EAAE,EAAE;YAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC,OAAO,IAAI,0BAA0B,CAAC,KAAK,CAAC;YAC5D,CAAC;YAED,IAAI,YAAY,GAAqB,IAAI,CAAC;YAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,YAAY,EAAE,CAAC;wBACjB,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;qBAAM,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjC,IAAI,CAAC,YAAY,EAAE,CAAC;wBAClB,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACnC,CAAC;oBACD,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,CAAC,MAAM,UAAU,EAAE,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,MAAM,UAAU,GAAG,YAAY,IAAI,KAAK,CAAC;YAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,UAAuB,CAAC,CAAC;gBAC1D,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,MAAM,CAAC;YACrC,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;YACnC,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAyC;KAC3C,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/bigint.d.ts

@@ -0,0 +1,11 @@
+import { BigIntConstraint } from "../../../types/constraints";
+import { BigIntSchema } from "../../../types/primitives";
+/**
+ * Adds a refinement to a bigint schema.
+ * Preserves coercion from the base schema.
+ * Returns a base BigIntSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineBigInt: (schema: BigIntSchema | BigIntConstraint, refinement: (value: bigint) => true | string) => BigIntSchema;
+//# sourceMappingURL=bigint.d.ts.map

package/dist/kanon/schemas/constraints/refine/bigint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/bigint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,GACvB,QAAQ,YAAY,GAAG,gBAAgB,EACvC,YAAY,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,KAC3C,YAwCF,CAAC"}

package/dist/kanon/schemas/constraints/refine/bigint.js

@@ -0,0 +1,47 @@
+/**
+ * Adds a refinement to a bigint schema.
+ * Preserves coercion from the base schema.
+ * Returns a base BigIntSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineBigInt = (schema, refinement) => {
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "bigint",
+        message: schema.message,
+        refinements: newRefinements,
+        validator: (value) => {
+            // First, run the base validator (which may coerce the value and run previous refinements)
+            const baseResult = schema.validator(value);
+            // If base validation failed, return the error
+            if (typeof baseResult === "string") {
+                return baseResult;
+            }
+            // Get the actual bigint value (either original or coerced)
+            let bigintValue;
+            if (baseResult === true) {
+                // Value was already a valid bigint
+                bigintValue = value;
+            }
+            else {
+                // Value was coerced
+                bigintValue = baseResult.coerced;
+            }
+            // Only apply the NEW refinement (previous ones were already run by base validator)
+            const result = refinement(bigintValue);
+            if (result !== true)
+                return result;
+            // Return coerced result if coercion happened, otherwise true
+            // Stryker disable next-line ConditionalExpression,BooleanLiteral: baseResult is true or {coerced} here - both paths produce valid parser output
+            if (baseResult !== true) {
+                return { coerced: bigintValue };
+            }
+            return true;
+        },
+    };
+};
+//# sourceMappingURL=bigint.js.map

package/dist/kanon/schemas/constraints/refine/bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/bigint.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAuC,EACvC,UAA4C,EAC9B,EAAE;IAChB,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW;QACvC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,KAAc,EAAyC,EAAE;YACnE,0FAA0F;YAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE3C,8CAA8C;YAC9C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,2DAA2D;YAC3D,IAAI,WAAmB,CAAC;YACxB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,mCAAmC;gBACnC,WAAW,GAAG,KAAe,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,CAAC;YAED,mFAAmF;YACnF,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;YAEnC,6DAA6D;YAC7D,gJAAgJ;YAChJ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/date.d.ts

@@ -0,0 +1,11 @@
+import { DateConstraint } from "../../../types/constraints";
+import { DateSchema } from "../../../types/primitives";
+/**
+ * Adds a refinement to a date schema.
+ * Preserves coercion from the base schema.
+ * Returns a base DateSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineDate: (schema: DateSchema | DateConstraint, refinement: (value: Date) => true | string) => DateSchema;
+//# sourceMappingURL=date.d.ts.map

package/dist/kanon/schemas/constraints/refine/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;;;;;GAMG;AAEH,eAAO,MAAM,UAAU,GACrB,QAAQ,UAAU,GAAG,cAAc,EACnC,YAAY,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,GAAG,MAAM,KACzC,UAuCF,CAAC"}

package/dist/kanon/schemas/constraints/refine/date.js

@@ -0,0 +1,46 @@
+/**
+ * Adds a refinement to a date schema.
+ * Preserves coercion from the base schema.
+ * Returns a base DateSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineDate = (schema, refinement) => {
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "date",
+        message: schema.message,
+        refinements: newRefinements,
+        validator: (value) => {
+            // First, run the base validator (which may coerce the value and run previous refinements)
+            const baseResult = schema.validator(value);
+            // If base validation failed, return the error
+            if (typeof baseResult === "string") {
+                return baseResult;
+            }
+            // Get the actual Date value (either original or coerced)
+            let dateValue;
+            if (baseResult === true) {
+                // Value was already a valid Date
+                dateValue = value;
+            }
+            else {
+                // Value was coerced
+                dateValue = baseResult.coerced;
+            }
+            // Only apply the NEW refinement (previous ones were already run by base validator)
+            const result = refinement(dateValue);
+            if (result !== true)
+                return result;
+            // Return coerced result if coercion happened, otherwise true
+            if (baseResult !== true) {
+                return { coerced: dateValue };
+            }
+            return true;
+        },
+    };
+};
+//# sourceMappingURL=date.js.map

package/dist/kanon/schemas/constraints/refine/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/date.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAmC,EACnC,UAA0C,EAC9B,EAAE;IACd,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW;QACvC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,KAAc,EAAuC,EAAE;YACjE,0FAA0F;YAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE3C,8CAA8C;YAC9C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,yDAAyD;YACzD,IAAI,SAAe,CAAC;YACpB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,iCAAiC;gBACjC,SAAS,GAAG,KAAa,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC;YACjC,CAAC;YAED,mFAAmF;YACnF,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;YAEnC,6DAA6D;YAC7D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YAChC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/map.d.ts

@@ -0,0 +1,11 @@
+import { MapConstraint } from "../../../types/constraints";
+import { MapSchema } from "../../../types/composites";
+import { GenericSchema, Infer } from "../../../types/base";
+/**
+ * Adds a refinement to a map schema.
+ * Returns a base MapSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineMap: <KeySchema extends GenericSchema, ValueSchema extends GenericSchema>(schema: MapSchema<KeySchema, ValueSchema> | MapConstraint<KeySchema, ValueSchema>, refinement: (value: Map<Infer<KeySchema>, Infer<ValueSchema>>) => true | string) => MapSchema<KeySchema, ValueSchema>;
+//# sourceMappingURL=map.d.ts.map

package/dist/kanon/schemas/constraints/refine/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAGpE;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,GACpB,SAAS,SAAS,aAAa,EAC/B,WAAW,SAAS,aAAa,EAEjC,QAAQ,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC,EACjF,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,KAC9E,SAAS,CAAC,SAAS,EAAE,WAAW,CAqElC,CAAC"}

package/dist/kanon/schemas/constraints/refine/map.js

@@ -0,0 +1,72 @@
+import { isCoerced } from "../../../types/base";
+import { ERROR_MESSAGES_COMPOSITION } from "../../../core/consts/messages";
+/**
+ * Adds a refinement to a map schema.
+ * Returns a base MapSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineMap = (schema, refinement) => {
+    const keySchema = schema.keySchema;
+    const valueSchema = schema.valueSchema;
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "map",
+        message: schema.message,
+        keySchema,
+        valueSchema,
+        refinements: newRefinements,
+        validator: ((value) => {
+            if (!(value instanceof Map)) {
+                return schema.message || ERROR_MESSAGES_COMPOSITION.map;
+            }
+            let coercedMap = null;
+            for (const [key, val] of value.entries()) {
+                const keyResult = keySchema.validator(key);
+                let finalKey = key;
+                if (keyResult === true) {
+                    // key is valid as-is
+                }
+                else if (isCoerced(keyResult)) {
+                    if (!coercedMap) {
+                        coercedMap = new Map(value);
+                    }
+                    finalKey = keyResult.coerced;
+                    coercedMap.delete(key);
+                }
+                else {
+                    return `Key: ${keyResult}`;
+                }
+                const valueResult = valueSchema.validator(val);
+                if (valueResult === true) {
+                    if (coercedMap && finalKey !== key) {
+                        coercedMap.set(finalKey, val);
+                    }
+                }
+                else if (isCoerced(valueResult)) {
+                    if (!coercedMap) {
+                        coercedMap = new Map(value);
+                    }
+                    coercedMap.set(finalKey, valueResult.coerced);
+                }
+                else {
+                    return `Value: ${valueResult}`;
+                }
+            }
+            const finalMap = coercedMap ?? value;
+            for (let i = 0; i < newRefinements.length; i++) {
+                const result = newRefinements[i](finalMap);
+                if (result !== true)
+                    return result;
+            }
+            if (coercedMap) {
+                return { coerced: coercedMap };
+            }
+            return true;
+        }),
+    };
+};
+//# sourceMappingURL=map.js.map

package/dist/kanon/schemas/constraints/refine/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/map.ts"],"names":[],"mappings":"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"}

package/dist/kanon/schemas/constraints/refine/number.d.ts

@@ -0,0 +1,11 @@
+import { NumberConstraint } from "../../../types/constraints";
+import { NumberSchema } from "../../../types/primitives";
+/**
+ * Adds a refinement to a number schema.
+ * Preserves coercion from the base schema.
+ * Returns a base NumberSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineNumber: (schema: NumberSchema | NumberConstraint, refinement: (value: number) => true | string) => NumberSchema;
+//# sourceMappingURL=number.d.ts.map

package/dist/kanon/schemas/constraints/refine/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,GACvB,QAAQ,YAAY,GAAG,gBAAgB,EACvC,YAAY,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,KAC3C,YAuCF,CAAC"}

package/dist/kanon/schemas/constraints/refine/number.js

@@ -0,0 +1,46 @@
+/**
+ * Adds a refinement to a number schema.
+ * Preserves coercion from the base schema.
+ * Returns a base NumberSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineNumber = (schema, refinement) => {
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "number",
+        message: schema.message,
+        refinements: newRefinements,
+        validator: (value) => {
+            // First, run the base validator (which may coerce the value and run previous refinements)
+            const baseResult = schema.validator(value);
+            // If base validation failed, return the error
+            if (typeof baseResult === "string") {
+                return baseResult;
+            }
+            // Get the actual number value (either original or coerced)
+            let numberValue;
+            if (baseResult === true) {
+                // Value was already a valid number
+                numberValue = value;
+            }
+            else {
+                // Value was coerced
+                numberValue = baseResult.coerced;
+            }
+            // Only apply the NEW refinement (previous ones were already run by base validator)
+            const result = refinement(numberValue);
+            if (result !== true)
+                return result;
+            // Return coerced result if coercion happened, otherwise true
+            if (baseResult !== true) {
+                return { coerced: numberValue };
+            }
+            return true;
+        },
+    };
+};
+//# sourceMappingURL=number.js.map

package/dist/kanon/schemas/constraints/refine/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/number.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAuC,EACvC,UAA4C,EAC9B,EAAE;IAChB,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW;QACvC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,KAAc,EAAyC,EAAE;YACnE,0FAA0F;YAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE3C,8CAA8C;YAC9C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,2DAA2D;YAC3D,IAAI,WAAmB,CAAC;YACxB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,mCAAmC;gBACnC,WAAW,GAAG,KAAe,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,CAAC;YAED,mFAAmF;YACnF,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;YAEnC,6DAA6D;YAC7D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/object.d.ts

@@ -0,0 +1,15 @@
+import { ObjectConstraint } from "../../../types/constraints";
+import { ObjectSchema } from "../../../types/composites";
+import { GenericSchema, Infer } from "../../../types/base";
+type InferObjectEntries<T extends Record<string, GenericSchema>> = {
+    [K in keyof T]: Infer<T[K]>;
+};
+/**
+ * Adds a refinement to an object schema.
+ * Returns a base ObjectSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineObject: <T extends Record<string, GenericSchema>>(schema: ObjectSchema<T> | ObjectConstraint<T>, refinement: (value: InferObjectEntries<T>) => true | string) => ObjectSchema<T>;
+export {};
+//# sourceMappingURL=object.d.ts.map

package/dist/kanon/schemas/constraints/refine/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAGpE,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAClE,QAAQ,YAAY,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAC7C,YAAY,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,KAC1D,YAAY,CAAC,CAAC,CAiDhB,CAAC"}

package/dist/kanon/schemas/constraints/refine/object.js

@@ -0,0 +1,56 @@
+import { isCoerced } from "../../../types/base";
+import { ERROR_MESSAGES_COMPOSITION } from "../../../core/consts/messages";
+/**
+ * Adds a refinement to an object schema.
+ * Returns a base ObjectSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineObject = (schema, refinement) => {
+    const entries = schema.entries;
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "object",
+        message: schema.message,
+        entries,
+        refinements: newRefinements,
+        validator: ((value) => {
+            if (typeof value !== "object" || value === null || Array.isArray(value)) {
+                return schema.message || ERROR_MESSAGES_COMPOSITION.object;
+            }
+            const obj = value;
+            let coercedObj = null;
+            for (const key in entries) {
+                const entryResult = entries[key].validator(obj[key]);
+                if (entryResult === true) {
+                    if (coercedObj) {
+                        coercedObj[key] = obj[key];
+                    }
+                }
+                else if (isCoerced(entryResult)) {
+                    if (!coercedObj) {
+                        coercedObj = { ...obj };
+                    }
+                    coercedObj[key] = entryResult.coerced;
+                }
+                else {
+                    return `${key}: ${entryResult}`;
+                }
+            }
+            const finalObj = coercedObj ?? value;
+            for (let i = 0; i < newRefinements.length; i++) {
+                const result = newRefinements[i](finalObj);
+                if (result !== true)
+                    return result;
+            }
+            if (coercedObj) {
+                return { coerced: coercedObj };
+            }
+            return true;
+        }),
+    };
+};
+//# sourceMappingURL=object.js.map

package/dist/kanon/schemas/constraints/refine/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/object.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAMzE;;;;;GAKG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAA6C,EAC7C,UAA2D,EAC1C,EAAE;IACnB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW;QACvC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAA6D,CAAC;QACxF,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO;QACP,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,CAAC,KAAc,EAAE,EAAE;YAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxE,OAAO,MAAM,CAAC,OAAO,IAAI,0BAA0B,CAAC,MAAM,CAAC;YAC7D,CAAC;YAED,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,IAAI,UAAU,GAAmC,IAAI,CAAC;YAEtD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACzB,IAAI,UAAU,EAAE,CAAC;wBACf,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;qBAAM,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,UAAU,EAAE,CAAC;wBAChB,UAAU,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;oBAC1B,CAAC;oBACD,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,GAAG,KAAK,WAAW,EAAE,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,UAAU,IAAI,KAAK,CAAC;YAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,QAAiC,CAAC,CAAC;gBACpE,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,MAAM,CAAC;YACrC,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YACjC,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAiC;KACnC,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/set.d.ts

@@ -0,0 +1,11 @@
+import { SetConstraint } from "../../../types/constraints";
+import { SetSchema } from "../../../types/composites";
+import { GenericSchema, Infer } from "../../../types/base";
+/**
+ * Adds a refinement to a set schema.
+ * Returns a base SetSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineSet: <ItemSchema extends GenericSchema>(schema: SetSchema<ItemSchema> | SetConstraint<ItemSchema>, refinement: (value: Set<Infer<ItemSchema>>) => true | string) => SetSchema<ItemSchema>;
+//# sourceMappingURL=set.d.ts.map

package/dist/kanon/schemas/constraints/refine/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAGpE;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,GAAI,UAAU,SAAS,aAAa,EACxD,QAAQ,SAAS,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,EACzD,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,KAC3D,SAAS,CAAC,UAAU,CAuDtB,CAAC"}

package/dist/kanon/schemas/constraints/refine/set.js

@@ -0,0 +1,60 @@
+import { isCoerced } from "../../../types/base";
+import { ERROR_MESSAGES_COMPOSITION } from "../../../core/consts/messages";
+/**
+ * Adds a refinement to a set schema.
+ * Returns a base SetSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineSet = (schema, refinement) => {
+    const itemSchema = schema.itemSchema;
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "set",
+        message: schema.message,
+        itemSchema,
+        refinements: newRefinements,
+        validator: ((value) => {
+            if (!(value instanceof Set)) {
+                return schema.message || ERROR_MESSAGES_COMPOSITION.set;
+            }
+            let coercedSet = null;
+            for (const item of value) {
+                const itemResult = itemSchema.validator(item);
+                if (itemResult === true) {
+                    if (coercedSet) {
+                        coercedSet.add(item);
+                    }
+                }
+                else if (isCoerced(itemResult)) {
+                    if (!coercedSet) {
+                        coercedSet = new Set();
+                        for (const prev of value) {
+                            if (prev === item)
+                                break;
+                            coercedSet.add(prev);
+                        }
+                    }
+                    coercedSet.add(itemResult.coerced);
+                }
+                else {
+                    return `Item: ${itemResult}`;
+                }
+            }
+            const finalSet = coercedSet ?? value;
+            for (let i = 0; i < newRefinements.length; i++) {
+                const result = newRefinements[i](finalSet);
+                if (result !== true)
+                    return result;
+            }
+            if (coercedSet) {
+                return { coerced: coercedSet };
+            }
+            return true;
+        }),
+    };
+};
+//# sourceMappingURL=set.js.map

package/dist/kanon/schemas/constraints/refine/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/set.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;GAKG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,MAAyD,EACzD,UAA4D,EACrC,EAAE;IACzB,MAAM,UAAU,GAAI,MAAgC,CAAC,UAAU,CAAC;IAIhE,MAAM,cAAc,GAA6C,MAAM,CAAC,WAAW;QACjF,CAAC,CAAC,CAAC,GAAI,MAAM,CAAC,WAAwD,EAAE,UAAU,CAAC;QACnF,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,KAAc;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU;QACV,WAAW,EAAE,cAA0D;QACvE,SAAS,EAAE,CAAC,CAAC,KAAc,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,MAAM,CAAC,OAAO,IAAI,0BAA0B,CAAC,GAAG,CAAC;YAC1D,CAAC;YAED,IAAI,UAAU,GAAwB,IAAI,CAAC;YAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,UAAU,EAAE,CAAC;wBACf,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;qBAAM,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjC,IAAI,CAAC,UAAU,EAAE,CAAC;wBAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;wBACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,IAAI,IAAI,KAAK,IAAI;gCAAE,MAAM;4BACzB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBACvB,CAAC;oBACH,CAAC;oBACD,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACN,OAAO,SAAS,UAAU,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,UAAU,IAAI,KAAK,CAAC;YAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,QAAmB,CAAC,CAAC;gBACtD,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,MAAM,CAAC;YACrC,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YACjC,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAuC;KACzC,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/refine/string.d.ts

@@ -0,0 +1,11 @@
+import { StringConstraint } from "../../../types/constraints";
+import { StringSchema } from "../../../types/primitives";
+/**
+ * Adds a refinement to a string schema.
+ * Preserves coercion from the base schema.
+ * Returns a base StringSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+export declare const refineString: (schema: StringSchema | StringConstraint, refinement: (value: string) => true | string) => StringSchema;
+//# sourceMappingURL=string.d.ts.map

package/dist/kanon/schemas/constraints/refine/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,GACvB,QAAQ,YAAY,GAAG,gBAAgB,EACvC,YAAY,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,KAC3C,YAuCF,CAAC"}

package/dist/kanon/schemas/constraints/refine/string.js

@@ -0,0 +1,46 @@
+/**
+ * Adds a refinement to a string schema.
+ * Preserves coercion from the base schema.
+ * Returns a base StringSchema - the caller is responsible for adding constraints.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export const refineString = (schema, refinement) => {
+    const newRefinements = schema.refinements
+        ? [...schema.refinements, refinement]
+        : [refinement];
+    return {
+        type: "string",
+        message: schema.message,
+        refinements: newRefinements,
+        validator: (value) => {
+            // First, run the base validator (which may coerce the value and run previous refinements)
+            const baseResult = schema.validator(value);
+            // If base validation failed, return the error
+            if (typeof baseResult === "string") {
+                return baseResult;
+            }
+            // Get the actual string value (either original or coerced)
+            let stringValue;
+            if (baseResult === true) {
+                // Value was already a valid string
+                stringValue = value;
+            }
+            else {
+                // Value was coerced
+                stringValue = baseResult.coerced;
+            }
+            // Only apply the NEW refinement (previous ones were already run by base validator)
+            const result = refinement(stringValue);
+            if (result !== true)
+                return result;
+            // Return coerced result if coercion happened, otherwise true
+            if (baseResult !== true) {
+                return { coerced: stringValue };
+            }
+            return true;
+        },
+    };
+};
+//# sourceMappingURL=string.js.map

package/dist/kanon/schemas/constraints/refine/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../src/kanon/schemas/constraints/refine/string.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAuC,EACvC,UAA4C,EAC9B,EAAE;IAChB,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW;QACvC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,KAAc,EAAyC,EAAE;YACnE,0FAA0F;YAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE3C,8CAA8C;YAC9C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,2DAA2D;YAC3D,IAAI,WAAmB,CAAC;YACxB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,mCAAmC;gBACnC,WAAW,GAAG,KAAe,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,CAAC;YAED,mFAAmF;YACnF,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;YAEnC,6DAA6D;YAC7D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/kanon/schemas/constraints/set.d.ts

@@ -0,0 +1,10 @@
+import { SetConstraint } from "../../types/constraints";
+import { SetSchema } from "../../types/composites";
+import { GenericSchema } from "../../types/base";
+/**
+ * Adds set constraints to a base schema.
+ *
+ * @since 2.0.0
+ */
+export declare function addSetConstraints<ItemSchema extends GenericSchema>(baseSchema: SetSchema<ItemSchema>): SetConstraint<ItemSchema>;
+//# sourceMappingURL=set.d.ts.map

package/dist/kanon/schemas/constraints/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../src/kanon/schemas/constraints/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAS,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,aAAa,EAChE,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,GAChC,aAAa,CAAC,UAAU,CAAC,CA0B3B"}

package/dist/kanon/schemas/constraints/set.js

@@ -0,0 +1,22 @@
+import { refineSet } from "../../schemas/constraints/refine/set";
+import { ERROR_MESSAGES_COMPOSITION } from "../../core/consts/messages";
+/**
+ * Adds set constraints to a base schema.
+ *
+ * @since 2.0.0
+ */
+/*@__INLINE__*/
+export function addSetConstraints(baseSchema) {
+    return {
+        ...baseSchema,
+        minSize: (min, errorMessage) => 
+        /*@__INLINE__*/ addSetConstraints(refineSet(baseSchema, (value) => value.size >= min ||
+            errorMessage ||
+            ERROR_MESSAGES_COMPOSITION.setMinSize(min))),
+        maxSize: (max, errorMessage) => 
+        /*@__INLINE__*/ addSetConstraints(refineSet(baseSchema, (value) => value.size <= max ||
+            errorMessage ||
+            ERROR_MESSAGES_COMPOSITION.setMaxSize(max))),
+    };
+}
+//# sourceMappingURL=set.js.map