@dereekb/model 13.12.2 → 13.12.3

package/index.cjs.js

@@ -2934,40 +2934,126 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */ var iso8601DayStringType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isISO8601DayString(val) || ctx.mustBe('a valid ISO 8601 day string');
 });
 
 /**
  * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
  */ var NON_NEGATIVE_NUMBER = 'number >= 0';
 /**
  * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
  */ var NON_NEGATIVE_INTEGER = 'number.integer >= 0';
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */ var minuteOfDayType = arktype.type('number').narrow(function(val, ctx) {
     return val != null && util.isMinuteOfDay(val) || ctx.mustBe('a valid minute of the day (0-1439)');
 });
 
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */ var e164PhoneNumberType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumber(val, false) || ctx.mustBe('a valid E.164 phone number without an extension');
 });
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */ var e164PhoneNumberWithOptionalExtensionType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumber(val, true) || ctx.mustBe('a valid E.164 phone number');
 });
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */ var e164PhoneNumberWithExtensionType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumberWithExtension(val) || ctx.mustBe('a valid E.164 phone number with an extension');
 });
 
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */ var latLngPointType = arktype.type({
     lat: '-90 <= number <= 90',
     lng: '-180 <= number <= 180'
@@ -2976,15 +3062,47 @@ function _ts_generator(thisArg, body) {
 });
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */ var latLngStringType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isLatLngString(val) || ctx.mustBe('a valid lat,lng string (e.g. "30.5,-96.3")');
 });
 
 /**
  * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
  */ var NON_EMPTY_STRING = 'string > 0';
 /**
  * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
  */ var EMAIL_STRING = 'string.email';
 /**
  * Creates an ArkType string definition for a non-empty string with a maximum length.
@@ -2995,12 +3113,20 @@ function _ts_generator(thisArg, body) {
  * @param maxLength - The maximum number of characters allowed (inclusive).
  * @returns The ArkType string definition.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
  * @example
  * ```ts
  * const userType = type({
  *   displayName: nonEmptyStringWithMaxLength(64)
  * });
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function nonEmptyStringWithMaxLength(maxLength) {
     return "".concat(NON_EMPTY_STRING, " & string <= ").concat(maxLength);
 }
@@ -3011,10 +3137,17 @@ function _ts_generator(thisArg, body) {
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function uniqueKeyedType(readKey) {
     var isUniqueKeyed = util.isUniqueKeyedFunction(readKey);
     return arktype.type('unknown[]').narrow(function(val, ctx) {
@@ -3024,11 +3157,33 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */ var websiteUrlType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isWebsiteUrl(val) || ctx.mustBe('a valid website URL');
 });
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */ var websiteUrlWithPrefixType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isWebsiteUrlWithPrefix(val) || ctx.mustBe('a valid website URL starting with http:// or https://');
 });

package/index.esm.js

@@ -2932,40 +2932,126 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */ var iso8601DayStringType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isISO8601DayString(val) || ctx.mustBe('a valid ISO 8601 day string');
 });
 
 /**
  * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
  */ var NON_NEGATIVE_NUMBER = 'number >= 0';
 /**
  * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
  */ var NON_NEGATIVE_INTEGER = 'number.integer >= 0';
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */ var minuteOfDayType = type('number').narrow(function(val, ctx) {
     return val != null && isMinuteOfDay(val) || ctx.mustBe('a valid minute of the day (0-1439)');
 });
 
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */ var e164PhoneNumberType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumber(val, false) || ctx.mustBe('a valid E.164 phone number without an extension');
 });
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */ var e164PhoneNumberWithOptionalExtensionType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumber(val, true) || ctx.mustBe('a valid E.164 phone number');
 });
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */ var e164PhoneNumberWithExtensionType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumberWithExtension(val) || ctx.mustBe('a valid E.164 phone number with an extension');
 });
 
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */ var latLngPointType = type({
     lat: '-90 <= number <= 90',
     lng: '-180 <= number <= 180'
@@ -2974,15 +3060,47 @@ function _ts_generator(thisArg, body) {
 });
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */ var latLngStringType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isLatLngString(val) || ctx.mustBe('a valid lat,lng string (e.g. "30.5,-96.3")');
 });
 
 /**
  * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
  */ var NON_EMPTY_STRING = 'string > 0';
 /**
  * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
  */ var EMAIL_STRING = 'string.email';
 /**
  * Creates an ArkType string definition for a non-empty string with a maximum length.
@@ -2993,12 +3111,20 @@ function _ts_generator(thisArg, body) {
  * @param maxLength - The maximum number of characters allowed (inclusive).
  * @returns The ArkType string definition.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
  * @example
  * ```ts
  * const userType = type({
  *   displayName: nonEmptyStringWithMaxLength(64)
  * });
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function nonEmptyStringWithMaxLength(maxLength) {
     return "".concat(NON_EMPTY_STRING, " & string <= ").concat(maxLength);
 }
@@ -3009,10 +3135,17 @@ function _ts_generator(thisArg, body) {
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function uniqueKeyedType(readKey) {
     var isUniqueKeyed = isUniqueKeyedFunction(readKey);
     return type('unknown[]').narrow(function(val, ctx) {
@@ -3022,11 +3155,33 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */ var websiteUrlType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isWebsiteUrl(val) || ctx.mustBe('a valid website URL');
 });
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */ var websiteUrlWithPrefixType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isWebsiteUrlWithPrefix(val) || ctx.mustBe('a valid website URL starting with http:// or https://');
 });

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dereekb/model",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "sideEffects": false,
   "peerDependencies": {
-    "@dereekb/util": "13.12.2",
+    "@dereekb/util": "13.12.3",
     "arktype": "^2.2.0",
     "make-error": "^1.3.6"
   },

package/src/lib/validator/date.d.ts

@@ -1,4 +1,14 @@
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */
 export declare const iso8601DayStringType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/number.d.ts

@@ -1,12 +1,44 @@
 /**
  * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
  */
 export declare const NON_NEGATIVE_NUMBER: "number >= 0";
 /**
  * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
  */
 export declare const NON_NEGATIVE_INTEGER: "number.integer >= 0";
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */
 export declare const minuteOfDayType: import("arktype/internal/variants/number.ts").NumberType<number, {}>;

package/src/lib/validator/phone.d.ts

@@ -1,12 +1,45 @@
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */
 export declare const e164PhoneNumberType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */
 export declare const e164PhoneNumberWithOptionalExtensionType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */
 export declare const e164PhoneNumberWithExtensionType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/point.d.ts

@@ -1,5 +1,16 @@
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */
 export declare const latLngPointType: import("arktype/internal/variants/object.ts").ObjectType<{
     lat: number;
@@ -7,5 +18,16 @@ export declare const latLngPointType: import("arktype/internal/variants/object.t
 }, {}>;
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */
 export declare const latLngStringType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/string.d.ts

@@ -1,9 +1,30 @@
 /**
  * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
  */
 export declare const NON_EMPTY_STRING: "string > 0";
 /**
  * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
  */
 export declare const EMAIL_STRING: "string.email";
 /**
@@ -15,11 +36,19 @@ export declare const EMAIL_STRING: "string.email";
  * @param maxLength - The maximum number of characters allowed (inclusive).
  * @returns The ArkType string definition.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
  * @example
  * ```ts
  * const userType = type({
  *   displayName: nonEmptyStringWithMaxLength(64)
  * });
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function nonEmptyStringWithMaxLength<N extends number>(maxLength: N): `string > 0 & string <= ${N}`;

package/src/lib/validator/unique.d.ts

@@ -5,9 +5,16 @@ import { type ReadKeyFunction } from '@dereekb/util';
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function uniqueKeyedType<T>(readKey: ReadKeyFunction<T>): import("arktype/internal/variants/array.ts").ArrayType<unknown[], {}>;

package/src/lib/validator/url.d.ts

@@ -1,8 +1,30 @@
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */
 export declare const websiteUrlType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */
 export declare const websiteUrlWithPrefixType: import("arktype/internal/variants/string.ts").StringType<string, {}>;