@zudojs/types 1.1.0 → 1.2.0

package/dist/typeConverters/index.d.ts

@@ -1,7 +1,8 @@
 /**
- * Runtime type conversion helpers: JSON parsing, string/number/boolean conversion, case transforms.
+ * Runtime type conversion helpers: JSON parsing, string/number/boolean conversion, case transforms, count formatting.
  *
  * @module typeConverters
  */
 export { safeJsonParse, toString, toNumber, toBoolean, toArray, mapToObject, objectToMap, snakeToCamel, camelToSnake, kebabToCamel, camelToKebab, } from "./typeConverters.core.js";
+export { formatCount } from "./typeConverters.count.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/typeConverters/index.js

@@ -1,7 +1,8 @@
 /**
- * Runtime type conversion helpers: JSON parsing, string/number/boolean conversion, case transforms.
+ * Runtime type conversion helpers: JSON parsing, string/number/boolean conversion, case transforms, count formatting.
  *
  * @module typeConverters
  */
 export { safeJsonParse, toString, toNumber, toBoolean, toArray, mapToObject, objectToMap, snakeToCamel, camelToSnake, kebabToCamel, camelToKebab, } from "./typeConverters.core.js";
+export { formatCount } from "./typeConverters.count.js";
 //# sourceMappingURL=index.js.map

package/dist/typeConverters/typeConverters.count.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Count-and-noun formatting for human-readable messages.
+ *
+ * @module typeConverters/count
+ */
+/**
+ * Formats a count with the singular or plural form of a noun, so messages
+ * read "at least 1 character" rather than "at least 1 characters".
+ *
+ * Only an exact count of 1 (or -1) is singular; 0, fractions and everything
+ * else take the plural. The plural defaults to the singular plus "s"; pass it
+ * explicitly for irregular nouns.
+ *
+ * @example
+ * formatCount(1, "character");          // "1 character"
+ * formatCount(3, "item");               // "3 items"
+ * formatCount(2, "entry", "entries");   // "2 entries"
+ */
+export declare function formatCount(count: number, singular: string, plural?: string): string;
+//# sourceMappingURL=typeConverters.count.d.ts.map

package/dist/typeConverters/typeConverters.count.js

@@ -0,0 +1,22 @@
+/**
+ * Count-and-noun formatting for human-readable messages.
+ *
+ * @module typeConverters/count
+ */
+/**
+ * Formats a count with the singular or plural form of a noun, so messages
+ * read "at least 1 character" rather than "at least 1 characters".
+ *
+ * Only an exact count of 1 (or -1) is singular; 0, fractions and everything
+ * else take the plural. The plural defaults to the singular plus "s"; pass it
+ * explicitly for irregular nouns.
+ *
+ * @example
+ * formatCount(1, "character");          // "1 character"
+ * formatCount(3, "item");               // "3 items"
+ * formatCount(2, "entry", "entries");   // "2 entries"
+ */
+export function formatCount(count, singular, plural = `${singular}s`) {
+    return `${count} ${Math.abs(count) === 1 ? singular : plural}`;
+}
+//# sourceMappingURL=typeConverters.count.js.map

package/dist/typeGuards/typeGuards.core.d.ts

@@ -52,9 +52,8 @@ export declare const MAX_EMAIL_LENGTH = 254;
  * This is the monorepo's reference email check. `ValidationPattern.EMAIL`
  * in `@zudojs/constants` (and therefore `createEmailAddress` and the schema
  * `email` format) encodes the same acceptance set, including the 254
- * character bound. `@zudojs/validation`'s `email` constraint still carries
- * its own copy of the pattern without the length bound; until it delegates
- * here, an address over 254 characters passes that constraint only.
+ * character bound, and `@zudojs/validation`'s `email` constraint uses that
+ * pattern, so all three accept exactly the same addresses.
  */
 export declare function isEmail(value: unknown): value is string;
 /**
@@ -86,6 +85,10 @@ export declare function isIsoDateString(value: unknown): value is string;
 export declare function isIsoDateTimeString(value: unknown): value is string;
 /**
  * Check if a value is an array of a specific element type.
+ *
+ * Every index in `0..length-1` is read, so a hole is tested as `undefined`
+ * rather than skipped. `Array.prototype.every` skips holes, which made
+ * `new Array(3)` satisfy every guard and narrow three holes to `T[]`.
  */
 export declare function isArrayOfType<T>(value: unknown, guard: (item: unknown) => item is T): value is T[];
 /**

package/dist/typeGuards/typeGuards.core.js

@@ -79,9 +79,8 @@ export const MAX_EMAIL_LENGTH = 254;
  * This is the monorepo's reference email check. `ValidationPattern.EMAIL`
  * in `@zudojs/constants` (and therefore `createEmailAddress` and the schema
  * `email` format) encodes the same acceptance set, including the 254
- * character bound. `@zudojs/validation`'s `email` constraint still carries
- * its own copy of the pattern without the length bound; until it delegates
- * here, an address over 254 characters passes that constraint only.
+ * character bound, and `@zudojs/validation`'s `email` constraint uses that
+ * pattern, so all three accept exactly the same addresses.
  */
 export function isEmail(value) {
     if (typeof value !== "string")
@@ -170,11 +169,19 @@ export function isIsoDateTimeString(value) {
 }
 /**
  * Check if a value is an array of a specific element type.
+ *
+ * Every index in `0..length-1` is read, so a hole is tested as `undefined`
+ * rather than skipped. `Array.prototype.every` skips holes, which made
+ * `new Array(3)` satisfy every guard and narrow three holes to `T[]`.
  */
 export function isArrayOfType(value, guard) {
     if (!Array.isArray(value))
         return false;
-    return value.every(guard);
+    for (let index = 0; index < value.length; index++) {
+        if (!guard(value[index]))
+            return false;
+    }
+    return true;
 }
 /**
  * Check if a value is defined (not null or undefined).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/types",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Shared type guards, utility types, and type converters for the Zudojs framework.",
   "license": "MIT",
   "author": {
@@ -29,9 +29,9 @@
     "node": ">=24.0.0"
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.6.2",
     "typescript": "7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.1"
   },
   "publishConfig": {
     "access": "public"
@@ -42,7 +42,7 @@
     "type-guards",
     "utilities"
   ],
-  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "homepage": "https://zudojs.oyinlola.site/docs/packages-types",
   "bugs": {
     "url": "https://github.com/oyinlola-tech/zudo/issues"
   },