toolbox-x 1.0.0

package/dist/http-status-BAZdtr7-.d.mts

@@ -0,0 +1,65 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { zn as LooseLiteral } from "./object-B0TV3eHx.mjs";
+import { n as HTTP_STATUS_DATA } from "./constants-CLS_bgKD.mjs";
+
+//#region src/types/http-status.d.ts
+/** Mapped type of HTTP status entries */
+type $HttpStatusMap = (typeof HTTP_STATUS_DATA)[number];
+/** HTTP status name variants: `name` or `readableName` */
+type $StatusNameVar = 'name' | 'readableName';
+/** * Categories of HTTP status codes: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
+type StatusCategory = $HttpStatusMap['category'];
+/** - Extracts standard HTTP status codes by the given `Category` name. Defaults to all {@link StatusCategory categories}. */
+type HttpStatusCode<Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target['code'] : never : never : never;
+/** Standard HTTP Status Code, e.g. `404`, `500` etc. + any number */
+type StatusCode = LooseLiteral<HttpStatusCode>;
+/**
+ * - Extracts standard HTTP status names filtered by {@link $StatusNameVar variant} and {@link StatusCategory category}.
+ *   - Defaults to all `variants` and `categories`.
+ *
+ * @remarks
+ * - `Name` selects either the `name` (CONSTANT_CASE) or `readableName` (Title Case).
+ * - `Category` restricts results to the chosen HTTP status {@link StatusCategory category}.
+ * - Produces a union of all matching literal status name values.
+ */
+type HttpStatusName<Name extends $StatusNameVar = $StatusNameVar, Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target[Name] : never : never : never;
+/** Standard HTTP status name in `CONSTANT_CASE`, e.g. `"INTERNAL_SERVER_ERROR"` + any string */
+type StatusName = LooseLiteral<HttpStatusName>;
+/** HTTP status name (`CONSTANT_CASE`) in {@link StatusEntry} interface */
+type EntryStatusName = LooseLiteral<HttpStatusName<'name'>>;
+/** HTTP status name (`Title Case`) in {@link StatusEntry} interface */
+type EntryReadableName = LooseLiteral<HttpStatusName<'readableName'>>;
+/** * Shape of an HTTP status entry. */
+interface StatusEntry {
+  /** HTTP Status Code, e.g. `404`, `500` etc. */
+  code: StatusCode;
+  /** HTTP status name in `CONSTANT_CASE`, e.g. `"NOT_FOUND"`, `"INTERNAL_SERVER_ERROR"` */
+  name: EntryStatusName;
+  /** HTTP status name in `Title Case` form, e.g. `"Not Found"`, `"Internal Server Error"`  */
+  readableName: EntryReadableName;
+  /** Link to full `MDN` Docs if available */
+  link?: string;
+  /** Short message, Can override using `httpStatus.setMessage` method */
+  message: string;
+  /** A brief description of the status code */
+  description: string;
+  /** The type of HTTP Status: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
+  category: StatusCategory;
+}
+//#endregion
+export { HttpStatusCode as a, StatusCode as c, EntryStatusName as i, StatusEntry as l, $StatusNameVar as n, HttpStatusName as o, EntryReadableName as r, StatusCategory as s, $HttpStatusMap as t, StatusName as u };

package/dist/http-status-U_3MtoGb.d.cts

@@ -0,0 +1,65 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { zn as LooseLiteral } from "./object-Blq0Amdv.cjs";
+import { n as HTTP_STATUS_DATA } from "./constants-qm8FafmD.cjs";
+
+//#region src/types/http-status.d.ts
+/** Mapped type of HTTP status entries */
+type $HttpStatusMap = (typeof HTTP_STATUS_DATA)[number];
+/** HTTP status name variants: `name` or `readableName` */
+type $StatusNameVar = 'name' | 'readableName';
+/** * Categories of HTTP status codes: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
+type StatusCategory = $HttpStatusMap['category'];
+/** - Extracts standard HTTP status codes by the given `Category` name. Defaults to all {@link StatusCategory categories}. */
+type HttpStatusCode<Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target['code'] : never : never : never;
+/** Standard HTTP Status Code, e.g. `404`, `500` etc. + any number */
+type StatusCode = LooseLiteral<HttpStatusCode>;
+/**
+ * - Extracts standard HTTP status names filtered by {@link $StatusNameVar variant} and {@link StatusCategory category}.
+ *   - Defaults to all `variants` and `categories`.
+ *
+ * @remarks
+ * - `Name` selects either the `name` (CONSTANT_CASE) or `readableName` (Title Case).
+ * - `Category` restricts results to the chosen HTTP status {@link StatusCategory category}.
+ * - Produces a union of all matching literal status name values.
+ */
+type HttpStatusName<Name extends $StatusNameVar = $StatusNameVar, Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target[Name] : never : never : never;
+/** Standard HTTP status name in `CONSTANT_CASE`, e.g. `"INTERNAL_SERVER_ERROR"` + any string */
+type StatusName = LooseLiteral<HttpStatusName>;
+/** HTTP status name (`CONSTANT_CASE`) in {@link StatusEntry} interface */
+type EntryStatusName = LooseLiteral<HttpStatusName<'name'>>;
+/** HTTP status name (`Title Case`) in {@link StatusEntry} interface */
+type EntryReadableName = LooseLiteral<HttpStatusName<'readableName'>>;
+/** * Shape of an HTTP status entry. */
+interface StatusEntry {
+  /** HTTP Status Code, e.g. `404`, `500` etc. */
+  code: StatusCode;
+  /** HTTP status name in `CONSTANT_CASE`, e.g. `"NOT_FOUND"`, `"INTERNAL_SERVER_ERROR"` */
+  name: EntryStatusName;
+  /** HTTP status name in `Title Case` form, e.g. `"Not Found"`, `"Internal Server Error"`  */
+  readableName: EntryReadableName;
+  /** Link to full `MDN` Docs if available */
+  link?: string;
+  /** Short message, Can override using `httpStatus.setMessage` method */
+  message: string;
+  /** A brief description of the status code */
+  description: string;
+  /** The type of HTTP Status: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
+  category: StatusCategory;
+}
+//#endregion
+export { HttpStatusCode as a, StatusCode as c, EntryStatusName as i, StatusEntry as l, $StatusNameVar as n, HttpStatusName as o, EntryReadableName as r, StatusCategory as s, $HttpStatusMap as t, StatusName as u };

package/dist/http-status.cjs

@@ -0,0 +1,173 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_constants = require('./constants-BIBDKY1u.cjs');
+
+//#region src/http-status/HttpStatus.ts
+/**
+* @class Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
+*
+* @remarks
+* - Supports lookup by code or name (both `SOME_NAME` and `Some Name` formats).
+* - Allows adding custom codes and overriding messages for existing ones.
+* - Provides pre-grouped categories for quick filtering (see {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus#groups-static-property HttpStatus.Groups}).
+* - Intended to be reusable — create multiple instances if you want separate registries.
+*
+* @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/misc/httpStatus httpStatus} for the default preloaded singleton instance.
+*
+* @example
+* // Using the class directly
+* const customStatus = new HttpStatus();
+* customStatus.addCode({
+*   code: 799,
+*   name: 'CUSTOM_ERROR',
+*   readableName: 'Custom Error',
+*   message: 'Something custom happened',
+*   description: 'This is an example of a user-defined HTTP status.',
+*   category: 'clientError'
+* });
+*
+* console.log(customStatus.getByCode(799)?.readableName);
+* // "Custom Error"
+*
+* console.log(customStatus.getByCode(404)?.name);
+* // "NOT_FOUND"
+*
+* console.log(customStatus.getByCode(404)?.message);
+* // "Not Found"
+*/
+var HttpStatus = class HttpStatus {
+	#codesByNumber;
+	#codesByName;
+	/**
+	* * Static category groups for quick reference.
+	* @remarks Populated at runtime from default and the provided data.
+	*/
+	static Groups = {
+		informational: [],
+		success: [],
+		redirection: [],
+		clientError: [],
+		serverError: []
+	};
+	constructor() {
+		this.#codesByNumber = /* @__PURE__ */ new Map();
+		this.#codesByName = /* @__PURE__ */ new Map();
+		for (const entry of require_constants.HTTP_STATUS_DATA) {
+			this.#storeEntry(entry);
+			HttpStatus.Groups[entry.category].push(entry.code);
+		}
+	}
+	/** * Get status entry by numeric HTTP code. */
+	getByCode(code) {
+		return this.#codesByNumber.get(code);
+	}
+	/** * Get status entry by name (either as `SOME_NAME` or `Some Name`). */
+	getByName(name) {
+		return this.#codesByName.get(name);
+	}
+	/**
+	* * Override the short message of an existing code.
+	* @param code HTTP status code.
+	* @param newMessage Custom message.
+	* @returns `true` if updated, `false` if code not found.
+	*/
+	setMessage(code, newMessage) {
+		const entry = this.#codesByNumber.get(code);
+		if (!entry) return false;
+		else {
+			entry.message = newMessage;
+			return true;
+		}
+	}
+	/**
+	* * Add one or more new HTTP status code entries.
+	*
+	* @remarks
+	* - New entries are compared **by their `code` value** to determine uniqueness.
+	* - If a code already exists, it will be skipped and not overwritten.
+	* - Returns `true` if at least one code was successfully added.
+	* - Returns `false` if all provided codes already exist.
+	*
+	* @param entries One or more status entries to add.
+	* @returns `true` if at least one code was added, otherwise `false`.
+	*/
+	addCode(...entries) {
+		let added = false;
+		for (const entry of entries) if (!this.#codesByNumber.has(entry.code)) {
+			this.#storeEntry(entry);
+			HttpStatus.Groups[entry.category].push(entry.code);
+			added = true;
+		}
+		return added;
+	}
+	/**
+	* * Add/override one or more HTTP status code entries.
+	*
+	* @remarks New entries use their `code` value as the comparison key and will overwrite existing ones.
+	*
+	* @param entries One or more status entries to add/override.
+	* @returns The modified instance with the newly added/updated entries.
+	*/
+	addOrOverrideCode(...entries) {
+		for (const entry of entries) {
+			this.#storeEntry(entry);
+			HttpStatus.Groups[entry.category].push(entry.code);
+		}
+		return this;
+	}
+	/**
+	* * List all codes, optionally filtered by category.
+	* @param category Optional category filter.
+	* @returns Array of status entries.
+	*/
+	list(category) {
+		const entries = [...this.#codesByNumber.values()];
+		if (!category) return entries;
+		else return entries.filter((entry) => entry.category === category);
+	}
+	/** * Internal helper to store an entry in all lookup maps. */
+	#storeEntry(entry) {
+		this.#codesByNumber.set(entry.code, { ...entry });
+		this.#codesByName.set(entry.name, { ...entry });
+		this.#codesByName.set(entry.readableName, { ...entry });
+	}
+};
+/**
+* * Default singleton instance of {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus HttpStatus} class.
+*
+* @remarks
+* - Preloaded with all MDN-based HTTP status codes.
+* - Useful when you do not need multiple independent registries.
+* - Provides immediate access to lookups, category groupings, and
+*   mutation methods without manual instantiation.
+*
+* @example
+* import { httpStatus } from 'nhb-toolbox';
+*
+* console.log(httpStatus.getByCode(404)?.readableName);
+* // "Not Found"
+*
+* httpStatus.setMessage(404, 'This page is gone');
+* console.log(httpStatus.getByCode(404)?.message);
+* // "This page is gone"
+*/
+const httpStatus = new HttpStatus();
+
+//#endregion
+exports.HttpStatus = HttpStatus;
+exports.httpStatus = httpStatus;

package/dist/http-status.d.cts

@@ -0,0 +1,142 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { $ as Maybe } from "./object-Blq0Amdv.cjs";
+import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "./http-status-U_3MtoGb.cjs";
+
+//#region src/http-status/HttpStatus.d.ts
+/**
+ * @class Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
+ *
+ * @remarks
+ * - Supports lookup by code or name (both `SOME_NAME` and `Some Name` formats).
+ * - Allows adding custom codes and overriding messages for existing ones.
+ * - Provides pre-grouped categories for quick filtering (see {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus#groups-static-property HttpStatus.Groups}).
+ * - Intended to be reusable — create multiple instances if you want separate registries.
+ *
+ * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/misc/httpStatus httpStatus} for the default preloaded singleton instance.
+ *
+ * @example
+ * // Using the class directly
+ * const customStatus = new HttpStatus();
+ * customStatus.addCode({
+ *   code: 799,
+ *   name: 'CUSTOM_ERROR',
+ *   readableName: 'Custom Error',
+ *   message: 'Something custom happened',
+ *   description: 'This is an example of a user-defined HTTP status.',
+ *   category: 'clientError'
+ * });
+ *
+ * console.log(customStatus.getByCode(799)?.readableName);
+ * // "Custom Error"
+ *
+ * console.log(customStatus.getByCode(404)?.name);
+ * // "NOT_FOUND"
+ *
+ * console.log(customStatus.getByCode(404)?.message);
+ * // "Not Found"
+ */
+declare class HttpStatus {
+  #private;
+  /**
+   * * Static category groups for quick reference.
+   * @remarks Populated at runtime from default and the provided data.
+   */
+  static Groups: Record<StatusCategory, StatusCode[]>;
+  constructor();
+  /**
+   * * Get status entry by standard numeric HTTP code.
+   * @param code Standard HTTP status code.
+   * @returns Matching standard status entry.
+   */
+  getByCode(code: HttpStatusCode): StatusEntry;
+  /**
+   * * Get status entry by numeric HTTP code.
+   * @param code HTTP status code.
+   * @returns Matching status entry or `undefined` if not found.
+   */
+  getByCode(code: StatusCode): Maybe<StatusEntry>;
+  /**
+   * * Get status entry by standard name (either as `SOME_NAME` or `Some Name`).
+   * @param name Standard status name either as `SOME_NAME` or `Some Name`.
+   * @returns Matching standard status entry.
+   */
+  getByName(name: HttpStatusName): StatusEntry;
+  /**
+   * * Get status entry by name (either as `SOME_NAME` or `Some Name`).
+   * @param name Status name either as `SOME_NAME` or `Some Name`.
+   * @returns Matching status entry or `undefined` if not found.
+   */
+  getByName(name: StatusName): Maybe<StatusEntry>;
+  /**
+   * * Override the short message of an existing code.
+   * @param code HTTP status code.
+   * @param newMessage Custom message.
+   * @returns `true` if updated, `false` if code not found.
+   */
+  setMessage(code: StatusCode, newMessage: string): boolean;
+  /**
+   * * Add one or more new HTTP status code entries.
+   *
+   * @remarks
+   * - New entries are compared **by their `code` value** to determine uniqueness.
+   * - If a code already exists, it will be skipped and not overwritten.
+   * - Returns `true` if at least one code was successfully added.
+   * - Returns `false` if all provided codes already exist.
+   *
+   * @param entries One or more status entries to add.
+   * @returns `true` if at least one code was added, otherwise `false`.
+   */
+  addCode(...entries: StatusEntry[]): boolean;
+  /**
+   * * Add/override one or more HTTP status code entries.
+   *
+   * @remarks New entries use their `code` value as the comparison key and will overwrite existing ones.
+   *
+   * @param entries One or more status entries to add/override.
+   * @returns The modified instance with the newly added/updated entries.
+   */
+  addOrOverrideCode(...entries: StatusEntry[]): HttpStatus;
+  /**
+   * * List all codes, optionally filtered by category.
+   * @param category Optional category filter.
+   * @returns Array of status entries.
+   */
+  list(category?: StatusCategory): StatusEntry[];
+}
+/**
+ * * Default singleton instance of {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus HttpStatus} class.
+ *
+ * @remarks
+ * - Preloaded with all MDN-based HTTP status codes.
+ * - Useful when you do not need multiple independent registries.
+ * - Provides immediate access to lookups, category groupings, and
+ *   mutation methods without manual instantiation.
+ *
+ * @example
+ * import { httpStatus } from 'nhb-toolbox';
+ *
+ * console.log(httpStatus.getByCode(404)?.readableName);
+ * // "Not Found"
+ *
+ * httpStatus.setMessage(404, 'This page is gone');
+ * console.log(httpStatus.getByCode(404)?.message);
+ * // "This page is gone"
+ */
+declare const httpStatus: HttpStatus;
+//#endregion
+export { HttpStatus, httpStatus };

package/dist/http-status.d.mts

@@ -0,0 +1,142 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { $ as Maybe } from "./object-B0TV3eHx.mjs";
+import { a as HttpStatusCode, c as StatusCode, l as StatusEntry, o as HttpStatusName, s as StatusCategory, u as StatusName } from "./http-status-BAZdtr7-.mjs";
+
+//#region src/http-status/HttpStatus.d.ts
+/**
+ * @class Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
+ *
+ * @remarks
+ * - Supports lookup by code or name (both `SOME_NAME` and `Some Name` formats).
+ * - Allows adding custom codes and overriding messages for existing ones.
+ * - Provides pre-grouped categories for quick filtering (see {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus#groups-static-property HttpStatus.Groups}).
+ * - Intended to be reusable — create multiple instances if you want separate registries.
+ *
+ * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/misc/httpStatus httpStatus} for the default preloaded singleton instance.
+ *
+ * @example
+ * // Using the class directly
+ * const customStatus = new HttpStatus();
+ * customStatus.addCode({
+ *   code: 799,
+ *   name: 'CUSTOM_ERROR',
+ *   readableName: 'Custom Error',
+ *   message: 'Something custom happened',
+ *   description: 'This is an example of a user-defined HTTP status.',
+ *   category: 'clientError'
+ * });
+ *
+ * console.log(customStatus.getByCode(799)?.readableName);
+ * // "Custom Error"
+ *
+ * console.log(customStatus.getByCode(404)?.name);
+ * // "NOT_FOUND"
+ *
+ * console.log(customStatus.getByCode(404)?.message);
+ * // "Not Found"
+ */
+declare class HttpStatus {
+  #private;
+  /**
+   * * Static category groups for quick reference.
+   * @remarks Populated at runtime from default and the provided data.
+   */
+  static Groups: Record<StatusCategory, StatusCode[]>;
+  constructor();
+  /**
+   * * Get status entry by standard numeric HTTP code.
+   * @param code Standard HTTP status code.
+   * @returns Matching standard status entry.
+   */
+  getByCode(code: HttpStatusCode): StatusEntry;
+  /**
+   * * Get status entry by numeric HTTP code.
+   * @param code HTTP status code.
+   * @returns Matching status entry or `undefined` if not found.
+   */
+  getByCode(code: StatusCode): Maybe<StatusEntry>;
+  /**
+   * * Get status entry by standard name (either as `SOME_NAME` or `Some Name`).
+   * @param name Standard status name either as `SOME_NAME` or `Some Name`.
+   * @returns Matching standard status entry.
+   */
+  getByName(name: HttpStatusName): StatusEntry;
+  /**
+   * * Get status entry by name (either as `SOME_NAME` or `Some Name`).
+   * @param name Status name either as `SOME_NAME` or `Some Name`.
+   * @returns Matching status entry or `undefined` if not found.
+   */
+  getByName(name: StatusName): Maybe<StatusEntry>;
+  /**
+   * * Override the short message of an existing code.
+   * @param code HTTP status code.
+   * @param newMessage Custom message.
+   * @returns `true` if updated, `false` if code not found.
+   */
+  setMessage(code: StatusCode, newMessage: string): boolean;
+  /**
+   * * Add one or more new HTTP status code entries.
+   *
+   * @remarks
+   * - New entries are compared **by their `code` value** to determine uniqueness.
+   * - If a code already exists, it will be skipped and not overwritten.
+   * - Returns `true` if at least one code was successfully added.
+   * - Returns `false` if all provided codes already exist.
+   *
+   * @param entries One or more status entries to add.
+   * @returns `true` if at least one code was added, otherwise `false`.
+   */
+  addCode(...entries: StatusEntry[]): boolean;
+  /**
+   * * Add/override one or more HTTP status code entries.
+   *
+   * @remarks New entries use their `code` value as the comparison key and will overwrite existing ones.
+   *
+   * @param entries One or more status entries to add/override.
+   * @returns The modified instance with the newly added/updated entries.
+   */
+  addOrOverrideCode(...entries: StatusEntry[]): HttpStatus;
+  /**
+   * * List all codes, optionally filtered by category.
+   * @param category Optional category filter.
+   * @returns Array of status entries.
+   */
+  list(category?: StatusCategory): StatusEntry[];
+}
+/**
+ * * Default singleton instance of {@link https://toolbox.nazmul-nhb.dev/docs/classes/HttpStatus HttpStatus} class.
+ *
+ * @remarks
+ * - Preloaded with all MDN-based HTTP status codes.
+ * - Useful when you do not need multiple independent registries.
+ * - Provides immediate access to lookups, category groupings, and
+ *   mutation methods without manual instantiation.
+ *
+ * @example
+ * import { httpStatus } from 'nhb-toolbox';
+ *
+ * console.log(httpStatus.getByCode(404)?.readableName);
+ * // "Not Found"
+ *
+ * httpStatus.setMessage(404, 'This page is gone');
+ * console.log(httpStatus.getByCode(404)?.message);
+ * // "This page is gone"
+ */
+declare const httpStatus: HttpStatus;
+//#endregion
+export { HttpStatus, httpStatus };