@zudojs/types 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -13,4 +13,3 @@ export * from "./typeGuards/index.js";
 export * from "./typeUtilities/index.js";
 export * from "./typeConverters/index.js";
 export * from "./runtime/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -13,4 +13,3 @@ export * from "./typeGuards/index.js";
 export * from "./typeUtilities/index.js";
 export * from "./typeConverters/index.js";
 export * from "./runtime/index.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/index.d.ts

@@ -9,4 +9,3 @@ export type { Clock, ClockSeconds, Random, PseudoRandom, } from "./runtime.core.
 export { systemClock, systemClockSeconds, defineSecureRandom, systemRandom, FixedClock, } from "./runtime.core.js";
 export { SeededRandom } from "./runtime.seeded.js";
 export { MAX_RANDOM_INT_BOUND } from "./runtime.int.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.js

@@ -8,4 +8,3 @@
 export { systemClock, systemClockSeconds, defineSecureRandom, systemRandom, FixedClock, } from "./runtime.core.js";
 export { SeededRandom } from "./runtime.seeded.js";
 export { MAX_RANDOM_INT_BOUND } from "./runtime.int.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/runtime.core.d.ts

@@ -85,4 +85,3 @@ export declare class FixedClock implements Clock {
     advance(deltaMs: number): void;
 }
 export {};
-//# sourceMappingURL=runtime.core.d.ts.map

package/dist/runtime/runtime.core.js

@@ -84,4 +84,3 @@ export class FixedClock {
         this.current += deltaMs;
     }
 }
-//# sourceMappingURL=runtime.core.js.map

package/dist/runtime/runtime.int.d.ts

@@ -28,4 +28,3 @@ export declare function assertIntBound(max: number, owner: string): void;
 export declare function sampleInt(max: number, nextWord: WordSource): number;
 /** Returns one cryptographically secure unsigned 32-bit word. */
 export declare function cryptoWord(): number;
-//# sourceMappingURL=runtime.int.d.ts.map

package/dist/runtime/runtime.int.js

@@ -51,4 +51,3 @@ export function cryptoWord() {
     }
     return cryptoBuffer[0];
 }
-//# sourceMappingURL=runtime.int.js.map

package/dist/runtime/runtime.seeded.d.ts

@@ -28,4 +28,3 @@ export declare class SeededRandom implements PseudoRandom {
     /** Advances the mulberry32 state and returns an unsigned 32-bit word. */
     private next;
 }
-//# sourceMappingURL=runtime.seeded.d.ts.map

package/dist/runtime/runtime.seeded.js

@@ -67,4 +67,3 @@ export class SeededRandom {
         return (t ^ (t >>> 14)) >>> 0;
     }
 }
-//# sourceMappingURL=runtime.seeded.js.map

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";
-//# sourceMappingURL=index.d.ts.map
+export { formatCount } from "./typeConverters.count.js";
+export { characterLength, jsonStringByteLength, } from "./typeConverters.length.js";

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";
-//# sourceMappingURL=index.js.map
+export { formatCount } from "./typeConverters.count.js";
+export { characterLength, jsonStringByteLength, } from "./typeConverters.length.js";

package/dist/typeConverters/typeConverters.core.d.ts

@@ -82,4 +82,3 @@ export declare function kebabToCamel(str: string): string;
  * Convert camelCase or PascalCase to kebab-case.
  */
 export declare function camelToKebab(str: string): string;
-//# sourceMappingURL=typeConverters.core.d.ts.map

package/dist/typeConverters/typeConverters.core.js

@@ -199,4 +199,3 @@ export function camelToKebab(str) {
         .map((word) => word.toLowerCase())
         .join("-");
 }
-//# sourceMappingURL=typeConverters.core.js.map

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

@@ -0,0 +1,19 @@
+/**
+ * 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;

package/dist/typeConverters/typeConverters.count.js

@@ -0,0 +1,21 @@
+/**
+ * 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}`;
+}

package/dist/typeConverters/typeConverters.length.d.ts

@@ -0,0 +1,33 @@
+/**
+ * String length helpers that count what a person or the wire sees rather
+ * than UTF-16 code units.
+ *
+ * @module typeConverters/length
+ */
+/**
+ * Number of Unicode code points in a string.
+ *
+ * `String.prototype.length` counts UTF-16 code units, so an emoji or any
+ * other character outside the Basic Multilingual Plane counts as two. A
+ * constraint phrased in "characters" should count with this instead.
+ *
+ * @example
+ * characterLength("abc");  // 3
+ * characterLength("🛒🛒"); // 2 ("🛒🛒".length is 4)
+ */
+export declare function characterLength(value: string): number;
+/**
+ * Bytes that `JSON.stringify(value)` occupies when encoded as UTF-8, the
+ * surrounding quotes and JSON escapes included.
+ *
+ * `value.length * 2` (the UTF-16 size) undercounts every character above
+ * U+07FF: "₦" is three bytes on the wire, so a payload limit measured that
+ * way let bodies half again larger than the limit through. Lone surrogates
+ * are counted as `JSON.stringify` writes them, as a `\uXXXX` escape.
+ *
+ * @example
+ * jsonStringByteLength("ab");   // 4  — "ab" with quotes
+ * jsonStringByteLength("₦");    // 5  — 3 bytes plus quotes
+ * jsonStringByteLength("\n");   // 4  — written as \n
+ */
+export declare function jsonStringByteLength(value: string): number;

package/dist/typeConverters/typeConverters.length.js

@@ -0,0 +1,85 @@
+/**
+ * String length helpers that count what a person or the wire sees rather
+ * than UTF-16 code units.
+ *
+ * @module typeConverters/length
+ */
+/** Control characters that `JSON.stringify` writes as a two-byte escape. */
+const SHORT_ESCAPES = new Set([
+    0x08, 0x09, 0x0a, 0x0c, 0x0d,
+]);
+/** A string JSON writes byte-for-byte: printable ASCII without `"` or `\`. */
+const PLAIN_ASCII = /^[\x20\x21\x23-\x5b\x5d-\x7e]*$/;
+function isHighSurrogate(code) {
+    return code >= 0xd800 && code <= 0xdbff;
+}
+function isLowSurrogate(code) {
+    return code >= 0xdc00 && code <= 0xdfff;
+}
+/**
+ * Number of Unicode code points in a string.
+ *
+ * `String.prototype.length` counts UTF-16 code units, so an emoji or any
+ * other character outside the Basic Multilingual Plane counts as two. A
+ * constraint phrased in "characters" should count with this instead.
+ *
+ * @example
+ * characterLength("abc");  // 3
+ * characterLength("🛒🛒"); // 2 ("🛒🛒".length is 4)
+ */
+export function characterLength(value) {
+    let count = 0;
+    for (let i = 0; i < value.length; i++) {
+        if (isHighSurrogate(value.charCodeAt(i)) &&
+            i + 1 < value.length &&
+            isLowSurrogate(value.charCodeAt(i + 1))) {
+            i++;
+        }
+        count++;
+    }
+    return count;
+}
+/**
+ * Bytes that `JSON.stringify(value)` occupies when encoded as UTF-8, the
+ * surrounding quotes and JSON escapes included.
+ *
+ * `value.length * 2` (the UTF-16 size) undercounts every character above
+ * U+07FF: "₦" is three bytes on the wire, so a payload limit measured that
+ * way let bodies half again larger than the limit through. Lone surrogates
+ * are counted as `JSON.stringify` writes them, as a `\uXXXX` escape.
+ *
+ * @example
+ * jsonStringByteLength("ab");   // 4  — "ab" with quotes
+ * jsonStringByteLength("₦");    // 5  — 3 bytes plus quotes
+ * jsonStringByteLength("\n");   // 4  — written as \n
+ */
+export function jsonStringByteLength(value) {
+    if (PLAIN_ASCII.test(value))
+        return value.length + 2;
+    let bytes = 2;
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x20) {
+            bytes += SHORT_ESCAPES.has(code) ? 2 : 6;
+        }
+        else if (code < 0x80) {
+            bytes += code === 0x22 || code === 0x5c ? 2 : 1;
+        }
+        else if (code < 0x800) {
+            bytes += 2;
+        }
+        else if (isHighSurrogate(code) &&
+            i + 1 < value.length &&
+            isLowSurrogate(value.charCodeAt(i + 1))) {
+            bytes += 4;
+            i++;
+        }
+        else if (isHighSurrogate(code) || isLowSurrogate(code)) {
+            bytes += 6;
+        }
+        else {
+            bytes += 3;
+        }
+    }
+    return bytes;
+}

package/dist/typeGuards/index.d.ts

@@ -4,4 +4,3 @@
  * @module typeGuards
  */
 export { MAX_EMAIL_LENGTH, isPlainObject, isNonNullObject, isNonEmptyString, isPositiveNumber, isFiniteNumber, isInteger, isDate, isUrl, isEmail, isUuid, isUuidV4, isIsoDateString, isIsoDateTimeString, isArrayOfType, isDefined, isFunction, isPromise, isThenable, } from "./typeGuards.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/typeGuards/index.js

@@ -4,4 +4,3 @@
  * @module typeGuards
  */
 export { MAX_EMAIL_LENGTH, isPlainObject, isNonNullObject, isNonEmptyString, isPositiveNumber, isFiniteNumber, isInteger, isDate, isUrl, isEmail, isUuid, isUuidV4, isIsoDateString, isIsoDateTimeString, isArrayOfType, isDefined, isFunction, isPromise, isThenable, } from "./typeGuards.core.js";
-//# sourceMappingURL=index.js.map

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

@@ -111,4 +111,3 @@ export declare function isPromise(value: unknown): value is Promise<unknown>;
  * makes those calls throw at the point the guard was supposed to make safe.
  */
 export declare function isThenable(value: unknown): value is PromiseLike<unknown>;
-//# sourceMappingURL=typeGuards.core.d.ts.map

package/dist/typeGuards/typeGuards.core.js

@@ -216,4 +216,3 @@ export function isThenable(value) {
         "then" in value &&
         typeof value.then === "function");
 }
-//# sourceMappingURL=typeGuards.core.js.map

package/dist/typeUtilities/index.d.ts

@@ -4,4 +4,3 @@
  * @module typeUtilities
  */
 export type { DeepReadonly, DeepPartial, DeepRequired, Prettify, StringKeysOf, NumberKeysOf, PartialExcept, RequiredExcept, PartialKeys, OptionalKeyNames, RequireKeys, AsyncReturnType, Nullable, Undefinable, Maybe, MaybePromise, NestedKeyOf, NestedValueOf, OmitByValue, PickByValue, } from "./typeUtilities.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/typeUtilities/index.js

@@ -4,4 +4,3 @@
  * @module typeUtilities
  */
 export {};
-//# sourceMappingURL=index.js.map

package/dist/typeUtilities/typeUtilities.core.d.ts

@@ -112,4 +112,3 @@ export type OmitByValue<T, ValueType> = Pick<T, {
 export type PickByValue<T, ValueType> = Pick<T, {
     [K in keyof T]: T[K] extends ValueType ? K : never;
 }[keyof T]>;
-//# sourceMappingURL=typeUtilities.core.d.ts.map

package/dist/typeUtilities/typeUtilities.core.js

@@ -4,4 +4,3 @@
  * @module typeUtilities/typeUtilities
  */
 export {};
-//# sourceMappingURL=typeUtilities.core.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/types",
-  "version": "1.1.1",
+  "version": "1.3.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"
   },