@warlock.js/seal 5.37.1 → 5.38.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@warlock.js/seal` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.38.0 - 2026-10-25
+
+### Added
+
+- `humanizeAttribute(key)` turns a field key into words (`max_dumbbell_kg` becomes "Max dumbbell kg").
+
+### Changed
+
+- `ObjectValidator#partial()` keeps its types: the named keys (all keys when none are named) become optional in the inferred shape.
+
+### Fixed
+
+- `toJsonSchema("openai-strict")` keeps an optional `v.enum()`, `v.literal()`, `in()` list or union nullable: `null` is added to an `enum`, a `const` becomes `anyOf: [{ const }, { type: "null" }]`, `anyOf`/`oneOf` gain one `{ type: "null" }` branch, and `allOf`/`$ref` schemas are wrapped in `anyOf`. Before, such fields were listed in `required` with no way to send `null`.
+- `.nullable()` on an enum, a literal, a scalar or a union no longer produces a `type` of `[undefined, "null"]` for `draft-2020-12`; the same shapes as above are used, and `openapi-3.0` adds `null` to the `enum` next to `nullable: true`. A nullable single literal now emits `anyOf: [{ const }, { type: "null" }]` instead of a bare `const`.
+- `.internal()` marks a field as set by the server. It validates and infers like any other field; `ObjectValidator#withoutInternal()` returns the schema without those fields (type included) for request validation, and `internalKeys()` lists them. `BaseValidator#isServerSet()` reads the mark.
+- `translateAttribute` passed to `v.validate(schema, data, options)` now translates the `:input` placeholder too; before, only the global config's translator was used for attribute labels.
+
 ## 5.34.3 - 2026-10-20
 
 ### Changed

package/cjs/index.cjs

@@ -26,14 +26,36 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_required_methods = require("./required-methods-Bh481cKm.cjs");
-const require_object = require("./object-Um5Ds4ch.cjs");
-const require_string = require("./string-BOKt6UtS.cjs");
+const require_required_methods = require("./required-methods-Bt9oNJ5V.cjs");
+const require_object = require("./object-BK6x62QZ.cjs");
+const require_string = require("./string-bc4YzeXc.cjs");
 let _mongez_reinforcements = require("@mongez/reinforcements");
 let _mongez_supportive_is = require("@mongez/supportive-is");
 let dayjs = require("dayjs");
 dayjs = __toESM(dayjs, 1);
 
+//#region ../../packages/seal/src/helpers/humanize-attribute.ts
+/**
+* Turn a field key into readable words for a validation message.
+*
+* Splits on underscores, hyphens, dots and camel-case boundaries, lowercases
+* the words and capitalises the first one. A key without letters (such as an
+* array index) is returned unchanged.
+*
+* @example
+* ```ts
+* humanizeAttribute("max_dumbbell_kg"); // "Max dumbbell kg"
+* humanizeAttribute("firstName"); // "First name"
+* humanizeAttribute("userID"); // "User id"
+* ```
+*/
+function humanizeAttribute(attribute) {
+	if (!/[A-Za-z]/.test(attribute)) return attribute;
+	const words = attribute.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[_\-.]+/g, " ").trim().replace(/\s+/g, " ").toLowerCase();
+	return words.charAt(0).toUpperCase() + words.slice(1);
+}
+
+//#endregion
 //#region ../../packages/seal/src/validators/any-validator.ts
 /**
 * Any validator - accepts any value
@@ -2512,16 +2534,19 @@ var ScalarValidator = class extends require_string.PrimitiveValidator {
 	* // → { enum: ["active", "inactive"] }
 	* ```
 	*/
-	toJsonSchema(_target = "draft-2020-12") {
+	toJsonSchema(target = "draft-2020-12") {
+		let schema;
 		const inOpts = require_required_methods.getRuleOptions(this.rules, "in");
-		if (inOpts?.values && Array.isArray(inOpts.values)) return { enum: inOpts.values };
 		const enumOpts = require_required_methods.getRuleOptions(this.rules, "enum");
-		if (enumOpts?.enum && Array.isArray(enumOpts.enum)) return { enum: enumOpts.enum };
-		return { oneOf: [
+		if (inOpts?.values && Array.isArray(inOpts.values)) schema = { enum: [...inOpts.values] };
+		else if (enumOpts?.enum && Array.isArray(enumOpts.enum)) schema = { enum: [...enumOpts.enum] };
+		else schema = { oneOf: [
 			{ type: "string" },
 			{ type: "number" },
 			{ type: "boolean" }
 		] };
+		if (this.isNullable) require_required_methods.applyNullable(schema, target);
+		return schema;
 	}
 };
 
@@ -2706,7 +2731,9 @@ var UnionValidator = class extends require_required_methods.BaseValidator {
 	* ```
 	*/
 	toJsonSchema(target = "draft-2020-12") {
-		return { oneOf: (require_required_methods.getRuleOptions(this.rules, "union")?.validators ?? []).map((v) => v.toJsonSchema(target)) };
+		const schema = { oneOf: (require_required_methods.getRuleOptions(this.rules, "union")?.validators ?? []).map((v) => v.toJsonSchema(target)) };
+		if (this.isNullable) require_required_methods.applyNullable(schema, target);
+		return schema;
 	}
 };
 
@@ -2993,6 +3020,7 @@ exports.hasPlugin = hasPlugin;
 exports.hexColorRule = require_required_methods.hexColorRule;
 exports.hslColorRule = require_required_methods.hslColorRule;
 exports.htmlEscapeMutator = require_string.htmlEscapeMutator;
+exports.humanizeAttribute = humanizeAttribute;
 exports.humanizeSize = require_required_methods.humanizeSize;
 exports.inRule = require_required_methods.inRule;
 exports.instanceofRule = require_required_methods.instanceofRule;