@ac-kit/core 0.2.0 → 0.4.0

package/dist/string/ascii/is-ascii-graphic.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Equivalent to C's `isgraph` — whether `code` is an ASCII character with a
+ * visible glyph: `!` through `~`, which is every printable character except the
+ * space.
+ */
+export declare function isAsciiGraphic(code: number): boolean;
+//# sourceMappingURL=is-ascii-graphic.d.ts.map

package/dist/string/ascii/is-ascii-graphic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-graphic.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-graphic.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/string/ascii/is-ascii-graphic.js

@@ -0,0 +1,10 @@
+import { EXCLAMATION_MARK, TILDE } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isgraph` — whether `code` is an ASCII character with a
+ * visible glyph: `!` through `~`, which is every printable character except the
+ * space.
+ */
+export function isAsciiGraphic(code) {
+    return code >= EXCLAMATION_MARK && code <= TILDE;
+}
+//# sourceMappingURL=is-ascii-graphic.js.map

package/dist/string/ascii/is-ascii-graphic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-graphic.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-graphic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,IAAI,IAAI,gBAAgB,IAAI,IAAI,IAAI,KAAK,CAAC;AAClD,CAAC"}

package/dist/string/ascii/is-ascii-printable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Equivalent to C's `isprint` — whether `code` is an ASCII printable character:
+ * the space through `~`. {@link isAsciiGraphic} is the same set without the
+ * space.
+ */
+export declare function isAsciiPrintable(code: number): boolean;
+//# sourceMappingURL=is-ascii-printable.d.ts.map

package/dist/string/ascii/is-ascii-printable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-printable.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-printable.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/string/ascii/is-ascii-printable.js

@@ -0,0 +1,10 @@
+import { SPACE, TILDE } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isprint` — whether `code` is an ASCII printable character:
+ * the space through `~`. {@link isAsciiGraphic} is the same set without the
+ * space.
+ */
+export function isAsciiPrintable(code) {
+    return code >= SPACE && code <= TILDE;
+}
+//# sourceMappingURL=is-ascii-printable.js.map

package/dist/string/ascii/is-ascii-printable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-printable.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-printable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC;AACvC,CAAC"}

package/dist/string/ascii/is-ascii-punctuation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `ispunct` — whether `code` is an ASCII punctuation or
+ * symbol character: printable, visible, and neither a letter nor a digit.
+ */
+export declare function isAsciiPunctuation(code: number): boolean;
+//# sourceMappingURL=is-ascii-punctuation.d.ts.map

package/dist/string/ascii/is-ascii-punctuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-punctuation.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-punctuation.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/string/ascii/is-ascii-punctuation.js

@@ -0,0 +1,10 @@
+import { isAsciiAlphaNumeric } from "./is-ascii-alpha-numeric.js";
+import { isAsciiGraphic } from "./is-ascii-graphic.js";
+/**
+ * Equivalent to C's `ispunct` — whether `code` is an ASCII punctuation or
+ * symbol character: printable, visible, and neither a letter nor a digit.
+ */
+export function isAsciiPunctuation(code) {
+    return isAsciiGraphic(code) && !isAsciiAlphaNumeric(code);
+}
+//# sourceMappingURL=is-ascii-punctuation.js.map

package/dist/string/ascii/is-ascii-punctuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-punctuation.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-punctuation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ac-kit/core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Foundational JavaScript and TypeScript extensions with no domain knowledge: guards, type helpers, collection and string utilities, JSON, pattern matching, promises, time, errors and a byte cursor.",
   "keywords": [
     "esm",
@@ -9,15 +9,15 @@
     "typescript",
     "utilities"
   ],
-  "homepage": "https://anthochamp.github.io/node-essentials/api/core/",
+  "homepage": "https://anthochamp.pages.grenadine.io/node-essentials/api/core/",
   "bugs": {
-    "url": "https://github.com/anthochamp/node-essentials/issues"
+    "url": "https://git.grenadine.io/anthochamp/node-essentials/issues"
   },
   "license": "BSD-3-Clause",
   "author": "Anthony Champagne <dev@anthonychampagne.fr>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "url": "git+https://git.grenadine.io/anthochamp/node-essentials.git",
     "directory": "packages/core"
   },
   "files": [
@@ -45,20 +45,20 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@types/web": "^0.0.354",
+    "@types/web": "^0.0.359",
     "type-fest": "^5.8.0"
   },
   "devDependencies": {
     "@ac-kit/tsconfig": "0.1.0",
     "@ac-kit/typedoc-config": "0.1.0",
     "@ac-kit/vitest-config": "0.1.1",
-    "@types/node": "26.5.1",
+    "@types/node": "26.6.5",
     "@typescript/native": "typescript@7.0.2",
     "rimraf": "6.1.3",
     "typedoc": "0.28.20",
     "typescript": "@typescript/typescript6@6.0.2",
-    "vite": "8.3.0",
-    "vitest": "5.0.0"
+    "vite": "8.3.5",
+    "vitest": "5.0.5"
   },
   "engines": {
     "node": ">=24"

package/dist/system/net/ephemeral-port.d.ts

@@ -1,13 +0,0 @@
-/** First port of the RFC 6335 dynamic / private range. */
-export declare const EPHEMERAL_PORT_MIN_VALUE = 49152;
-/** Last port of the RFC 6335 dynamic / private range. */
-export declare const EPHEMERAL_PORT_MAX_VALUE = 65535;
-/**
- * Get a random ephemeral port number in the range suggested by RFC 6335 and the
- * Internet Assigned Numbers Authority (IANA) for dynamic or private ports
- * (between 49152 and 65535).
- *
- * @returns A random ephemeral port number.
- */
-export declare function getRandomEphemeralPort(): number;
-//# sourceMappingURL=ephemeral-port.d.ts.map

package/dist/system/net/ephemeral-port.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ephemeral-port.d.ts","sourceRoot":"","sources":["../../../src/system/net/ephemeral-port.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAK9C;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAK/C"}

package/dist/system/net/ephemeral-port.js

@@ -1,19 +0,0 @@
-/** First port of the RFC 6335 dynamic / private range. */
-export const EPHEMERAL_PORT_MIN_VALUE = 49152;
-/** Last port of the RFC 6335 dynamic / private range. */
-export const EPHEMERAL_PORT_MAX_VALUE = 65535;
-const EPHEMERAL_PORT_COUNT = EPHEMERAL_PORT_MAX_VALUE - EPHEMERAL_PORT_MIN_VALUE + 1;
-/**
- * Get a random ephemeral port number in the range suggested by RFC 6335 and the
- * Internet Assigned Numbers Authority (IANA) for dynamic or private ports
- * (between 49152 and 65535).
- *
- * @returns A random ephemeral port number.
- */
-export function getRandomEphemeralPort() {
-    const draw = new Uint16Array(1);
-    crypto.getRandomValues(draw);
-    // 65536 is an exact multiple of the 16384-port range, so the modulo is unbiased.
-    return EPHEMERAL_PORT_MIN_VALUE + (draw[0] % EPHEMERAL_PORT_COUNT);
-}
-//# sourceMappingURL=ephemeral-port.js.map

package/dist/system/net/ephemeral-port.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ephemeral-port.js","sourceRoot":"","sources":["../../../src/system/net/ephemeral-port.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,yDAAyD;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,MAAM,oBAAoB,GACzB,wBAAwB,GAAG,wBAAwB,GAAG,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACrC,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,iFAAiF;IACjF,OAAO,wBAAwB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,oBAAoB,CAAC,CAAC;AACrE,CAAC"}

package/dist/system/net/inet-address.d.ts

@@ -1,20 +0,0 @@
-/** Represents an Internet address with IP family and address. */
-export type InetAddress = {
-    /** IP family: 4 for IPv4, 6 for IPv6, or null for unknown family. */
-    family: 4 | 6 | null;
-    /** IP address string. */
-    address: string;
-};
-/**
- * Composes an InetAddress from a family and address. Validates and converts the
- * family to ensure it is 4, 6, or null.
- *
- * @param family The IP family, either as a string ('IPv4', 'IPv6'), number (4,
- *   6), or null for unknown.
- * @param address The IP address string.
- * @returns An InetAddress object.
- * @throws {UnsupportedError} If the family is not valid (not 'IPv4'/'IPv6' or
- *   4/6 or null).
- */
-export declare function composeInetAddress(family: string | number | null, address: string): InetAddress;
-//# sourceMappingURL=inet-address.d.ts.map

package/dist/system/net/inet-address.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inet-address.d.ts","sourceRoot":"","sources":["../../../src/system/net/inet-address.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACzB,qEAAqE;IACrE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC9B,OAAO,EAAE,MAAM,GACb,WAAW,CA6Bb"}

package/dist/system/net/inet-address.js

@@ -1,42 +0,0 @@
-import { UnsupportedError } from "@ac-kit/core";
-/**
- * Composes an InetAddress from a family and address. Validates and converts the
- * family to ensure it is 4, 6, or null.
- *
- * @param family The IP family, either as a string ('IPv4', 'IPv6'), number (4,
- *   6), or null for unknown.
- * @param address The IP address string.
- * @returns An InetAddress object.
- * @throws {UnsupportedError} If the family is not valid (not 'IPv4'/'IPv6' or
- *   4/6 or null).
- */
-export function composeInetAddress(family, address) {
-    let validatedFamily;
-    if (typeof family === "string") {
-        if (family === "IPv4") {
-            validatedFamily = 4;
-        }
-        else if (family === "IPv6") {
-            validatedFamily = 6;
-        }
-        else {
-            throw new UnsupportedError(`Unsupported IP family: ${family}. Expected 'IPv4' or 'IPv6'.`);
-        }
-    }
-    else if (typeof family === "number") {
-        if (family === 4 || family === 6) {
-            validatedFamily = family;
-        }
-        else {
-            throw new UnsupportedError(`Unsupported IP family: ${family}. Expected 4 (IPv4) or 6 (IPv6).`);
-        }
-    }
-    else {
-        validatedFamily = null;
-    }
-    return {
-        family: validatedFamily,
-        address,
-    };
-}
-//# sourceMappingURL=inet-address.js.map

package/dist/system/net/inet-address.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inet-address.js","sourceRoot":"","sources":["../../../src/system/net/inet-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CACjC,MAA8B,EAC9B,OAAe;IAEf,IAAI,eAA6B,CAAC;IAElC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACvB,eAAe,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,eAAe,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,gBAAgB,CACzB,0BAA0B,MAAM,8BAA8B,CAC9D,CAAC;QACH,CAAC;IACF,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,eAAe,GAAG,MAAM,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,gBAAgB,CACzB,0BAA0B,MAAM,kCAAkC,CAClE,CAAC;QACH,CAAC;IACF,CAAC;SAAM,CAAC;QACP,eAAe,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,OAAO;QACN,MAAM,EAAE,eAAe;QACvB,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/system/net/inet-endpoint.d.ts

@@ -1,7 +0,0 @@
-import { InetAddress } from "./inet-address.js";
-/** Represents an Internet endpoint with IP family, address, and port. */
-export type InetEndpoint = InetAddress & {
-    /** Port number. */
-    port: number;
-};
-//# sourceMappingURL=inet-endpoint.d.ts.map

package/dist/system/net/inet-endpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inet-endpoint.d.ts","sourceRoot":"","sources":["../../../src/system/net/inet-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACxC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/system/net/inet-endpoint.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=inet-endpoint.js.map

package/dist/system/net/inet-endpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inet-endpoint.js","sourceRoot":"","sources":["../../../src/system/net/inet-endpoint.ts"],"names":[],"mappings":""}