@ayapapa-npm/contracts-js 0.3.0 → 0.4.1

package/README.md

@@ -1,4 +1,10 @@
 [![CI](https://github.com/ayapapa/contracts-js/actions/workflows/ci.yml/badge.svg)](https://github.com/ayapapa/contracts-js/actions/workflows/ci.yml)
+![Coverage](https://raw.githubusercontent.com/ayapapa/contracts-js/main/badges/coverage-total.svg)
+![Branches](https://raw.githubusercontent.com/ayapapa/contracts-js/main/badges/coverage-branches.svg)
+![Functions](https://raw.githubusercontent.com/ayapapa/contracts-js/main/badges/coverage-functions.svg)
+![Lines](https://raw.githubusercontent.com/ayapapa/contracts-js/main/badges/coverage-lines.svg)
+![Statements](https://raw.githubusercontent.com/ayapapa/contracts-js/main/badges/coverage-statements.svg)
+
 # contracts-js
 A lightweight Design by Contract library for JavaScript.</br>
 Provides runtime contract checks based on Design by Contract principles.</br>
@@ -126,6 +132,9 @@ Contracts.INVARIANT(
 );
 ```
 
+## API Reference
+[API document](docs/api.md)
+
 ## Usage
 
 ```javascript

package/dist/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -32,30 +33,39 @@ var Contracts = class _Contracts {
   /** Debug mode state */
   static DEBUG_MODE = false;
   /** default configuration */
-  static defaultConf = {
+  static #defaultConf = {
     debug: false,
     logger: console
   };
+  /** Current config. */
+  static #config = { ..._Contracts.#defaultConf };
   /** logger */
-  static logger = console;
+  //private static logger: LogProvider = console;
   /**
    * Configures contract checking behavior.
    *
    * @param config
-   * Configuration options.
-   *
-   * The `debug` property enables or disables
-   * debug-only contract checks.
-   *
+   * Configuration options. <br>
+   * <br>
+   * The `debug` property toggles the behavior—specifically, 
+   * throwing an exception or outputting to the console when the condition is 
+   * false—for the validation of contracts intended for use during debugging (methods ending in `_DEBUG`). <br>
+   * <br>
    * When `debug` is `true`,
-   * methods ending with `_DEBUG` perform validation.
-   *
-   * When `debug` is `false` or omitted,
-   * methods ending with `_DEBUG` skip validation.
-   * 
+   * methods ending with `_DEBUG` perform validation. <br>
+   * <br>
+   * When `debug` is `false`,
+   * methods ending with `_DEBUG` skip validation. <br>
+   *  <br>
    * Is the `logger` property is specified, 
    * it is used instead of the standard logger, `console`.
-   * This module uses only the `error` method of the `logger`.
+   * This module uses only the `error` method of the `logger`. <br>
+   * <br>
+   * Note: If the value of a property is `undefined`, it is treated as unspecified.
+   * 
+   * @param reset
+   * If `true`, unspecified values ​​are saved to the settings as default values. <br>
+   * If `false`, unspecified values ​​remain at their current settings.
    *
    * @example
    * // Use a logger that is slightly more advanced than the standard logger—namely, `console`.
@@ -65,9 +75,36 @@ var Contracts = class _Contracts {
    * Contracts.setConfig({ debug: true, logger: prettyConsole });
    * // Node: ` The `logger` property is optional.
    */
-  static setConfig(config) {
-    _Contracts.DEBUG_MODE = Boolean(config?.debug);
-    _Contracts.logger = config?.logger ?? console;
+  static setConfig(config, reset = true) {
+    const rConf = { ...config };
+    for (let key of Object.keys(rConf)) {
+      if (rConf[key] == null) delete rConf[key];
+    }
+    if (reset) _Contracts.#config = { ..._Contracts.getDefaultConfig() };
+    Object.assign(_Contracts.#config, rConf);
+    _Contracts.DEBUG_MODE = _Contracts.#config.debug;
+  }
+  /**
+   * Get the default configurations.
+   * @returns Default configurations.
+   */
+  static getDefaultConfig() {
+    return { ..._Contracts.#defaultConf };
+  }
+  /**
+   * Get the current configurations.
+   * @returns Default configurations.
+   */
+  static getConfig() {
+    _Contracts.#config.debug = _Contracts.DEBUG_MODE;
+    return { ..._Contracts.#config };
+  }
+  /**
+   * Reset the current configurations to the default configurations.
+   * @returns Default configurations.
+   */
+  static resetConfig() {
+    _Contracts.setConfig({}, true);
   }
   /**
    * Verifies an intermediate condition during execution.
@@ -87,7 +124,7 @@ var Contracts = class _Contracts {
    * - Check temporary assumptions during execution.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -144,7 +181,7 @@ var Contracts = class _Contracts {
    * - Check internal assumptions while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -199,7 +236,7 @@ var Contracts = class _Contracts {
    * - Check required external conditions.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -263,7 +300,7 @@ var Contracts = class _Contracts {
    * - Perform additional argument checks while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -319,7 +356,7 @@ var Contracts = class _Contracts {
    * - Verify that processing completed correctly.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -385,7 +422,7 @@ var Contracts = class _Contracts {
    * - Confirm internal behavior while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -441,7 +478,7 @@ var Contracts = class _Contracts {
    * INVARIANT represents conditions that must always remain true.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -504,7 +541,7 @@ var Contracts = class _Contracts {
    * - Detect unexpected state changes while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param [ngMsg]
    * Failure message.
@@ -562,7 +599,7 @@ var Contracts = class _Contracts {
    * @internal
    * 
    * @param isOk
-   * Condition result.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param prefix
    * Contract type prefix used in the error message.
@@ -602,9 +639,7 @@ var Contracts = class _Contracts {
       const msg = `[${prefix}] ${ngMsg ?? ""}`;
       if (ErrorClass) {
         const err = eParams ? new ErrorClass(msg, eParams) : new ErrorClass(msg);
-        if (eProps) {
-          Object.assign(err, eProps);
-        }
+        eProps && Object.assign(err, eProps);
         throw err;
       }
       if (ngMsg) {
@@ -626,7 +661,7 @@ var Contracts = class _Contracts {
    * @internal
    * 
    * @param isOk
-   * Condition result.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param prefix
    * Contract type prefix used in the error message.
@@ -671,7 +706,7 @@ var Contracts = class _Contracts {
    * @internal
    */
   static getLogger() {
-    return _Contracts.logger ?? console;
+    return _Contracts.#config.logger;
   }
 };
 

package/dist/index.d.cts

@@ -58,33 +58,38 @@ type ConfigKey = keyof Config;
  * @module Contracts
  */
 declare class Contracts {
+    #private;
     /**
      * Static fields
      */
     /** Debug mode state */
     static DEBUG_MODE: boolean;
-    /** default configuration */
-    private static readonly defaultConf;
     /** logger */
-    private static logger;
     /**
      * Configures contract checking behavior.
      *
      * @param config
-     * Configuration options.
-     *
-     * The `debug` property enables or disables
-     * debug-only contract checks.
-     *
+     * Configuration options. <br>
+     * <br>
+     * The `debug` property toggles the behavior—specifically,
+     * throwing an exception or outputting to the console when the condition is
+     * false—for the validation of contracts intended for use during debugging (methods ending in `_DEBUG`). <br>
+     * <br>
      * When `debug` is `true`,
-     * methods ending with `_DEBUG` perform validation.
-     *
-     * When `debug` is `false` or omitted,
-     * methods ending with `_DEBUG` skip validation.
-     *
+     * methods ending with `_DEBUG` perform validation. <br>
+     * <br>
+     * When `debug` is `false`,
+     * methods ending with `_DEBUG` skip validation. <br>
+     *  <br>
      * Is the `logger` property is specified,
      * it is used instead of the standard logger, `console`.
-     * This module uses only the `error` method of the `logger`.
+     * This module uses only the `error` method of the `logger`. <br>
+     * <br>
+     * Note: If the value of a property is `undefined`, it is treated as unspecified.
+     *
+     * @param reset
+     * If `true`, unspecified values ​​are saved to the settings as default values. <br>
+     * If `false`, unspecified values ​​remain at their current settings.
      *
      * @example
      * // Use a logger that is slightly more advanced than the standard logger—namely, `console`.
@@ -94,7 +99,22 @@ declare class Contracts {
      * Contracts.setConfig({ debug: true, logger: prettyConsole });
      * // Node: ` The `logger` property is optional.
      */
-    static setConfig(config: Config): void;
+    static setConfig(config: Config, reset?: boolean): void;
+    /**
+     * Get the default configurations.
+     * @returns Default configurations.
+     */
+    static getDefaultConfig(): Required<Config>;
+    /**
+     * Get the current configurations.
+     * @returns Default configurations.
+     */
+    static getConfig(): Required<Config>;
+    /**
+     * Reset the current configurations to the default configurations.
+     * @returns Default configurations.
+     */
+    static resetConfig(): void;
     /**
      * Verifies an intermediate condition during execution.
      *
@@ -113,7 +133,7 @@ declare class Contracts {
      * - Check temporary assumptions during execution.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -165,7 +185,7 @@ declare class Contracts {
      * - Check internal assumptions while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -215,7 +235,7 @@ declare class Contracts {
      * - Check required external conditions.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -274,7 +294,7 @@ declare class Contracts {
      * - Perform additional argument checks while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -325,7 +345,7 @@ declare class Contracts {
      * - Verify that processing completed correctly.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -386,7 +406,7 @@ declare class Contracts {
      * - Confirm internal behavior while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -437,7 +457,7 @@ declare class Contracts {
      * INVARIANT represents conditions that must always remain true.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -495,7 +515,7 @@ declare class Contracts {
      * - Detect unexpected state changes while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param [ngMsg]
      * Failure message.
@@ -548,7 +568,7 @@ declare class Contracts {
      * @internal
      *
      * @param isOk
-     * Condition result.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param prefix
      * Contract type prefix used in the error message.
@@ -591,7 +611,7 @@ declare class Contracts {
      * @internal
      *
      * @param isOk
-     * Condition result.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param prefix
      * Contract type prefix used in the error message.

package/dist/index.d.ts

@@ -58,33 +58,38 @@ type ConfigKey = keyof Config;
  * @module Contracts
  */
 declare class Contracts {
+    #private;
     /**
      * Static fields
      */
     /** Debug mode state */
     static DEBUG_MODE: boolean;
-    /** default configuration */
-    private static readonly defaultConf;
     /** logger */
-    private static logger;
     /**
      * Configures contract checking behavior.
      *
      * @param config
-     * Configuration options.
-     *
-     * The `debug` property enables or disables
-     * debug-only contract checks.
-     *
+     * Configuration options. <br>
+     * <br>
+     * The `debug` property toggles the behavior—specifically,
+     * throwing an exception or outputting to the console when the condition is
+     * false—for the validation of contracts intended for use during debugging (methods ending in `_DEBUG`). <br>
+     * <br>
      * When `debug` is `true`,
-     * methods ending with `_DEBUG` perform validation.
-     *
-     * When `debug` is `false` or omitted,
-     * methods ending with `_DEBUG` skip validation.
-     *
+     * methods ending with `_DEBUG` perform validation. <br>
+     * <br>
+     * When `debug` is `false`,
+     * methods ending with `_DEBUG` skip validation. <br>
+     *  <br>
      * Is the `logger` property is specified,
      * it is used instead of the standard logger, `console`.
-     * This module uses only the `error` method of the `logger`.
+     * This module uses only the `error` method of the `logger`. <br>
+     * <br>
+     * Note: If the value of a property is `undefined`, it is treated as unspecified.
+     *
+     * @param reset
+     * If `true`, unspecified values ​​are saved to the settings as default values. <br>
+     * If `false`, unspecified values ​​remain at their current settings.
      *
      * @example
      * // Use a logger that is slightly more advanced than the standard logger—namely, `console`.
@@ -94,7 +99,22 @@ declare class Contracts {
      * Contracts.setConfig({ debug: true, logger: prettyConsole });
      * // Node: ` The `logger` property is optional.
      */
-    static setConfig(config: Config): void;
+    static setConfig(config: Config, reset?: boolean): void;
+    /**
+     * Get the default configurations.
+     * @returns Default configurations.
+     */
+    static getDefaultConfig(): Required<Config>;
+    /**
+     * Get the current configurations.
+     * @returns Default configurations.
+     */
+    static getConfig(): Required<Config>;
+    /**
+     * Reset the current configurations to the default configurations.
+     * @returns Default configurations.
+     */
+    static resetConfig(): void;
     /**
      * Verifies an intermediate condition during execution.
      *
@@ -113,7 +133,7 @@ declare class Contracts {
      * - Check temporary assumptions during execution.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -165,7 +185,7 @@ declare class Contracts {
      * - Check internal assumptions while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -215,7 +235,7 @@ declare class Contracts {
      * - Check required external conditions.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -274,7 +294,7 @@ declare class Contracts {
      * - Perform additional argument checks while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -325,7 +345,7 @@ declare class Contracts {
      * - Verify that processing completed correctly.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -386,7 +406,7 @@ declare class Contracts {
      * - Confirm internal behavior while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -437,7 +457,7 @@ declare class Contracts {
      * INVARIANT represents conditions that must always remain true.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param ngMsg
      * Failure message.
@@ -495,7 +515,7 @@ declare class Contracts {
      * - Detect unexpected state changes while debugging.
      *
      * @param isOk
-     * Condition result to verify.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param [ngMsg]
      * Failure message.
@@ -548,7 +568,7 @@ declare class Contracts {
      * @internal
      *
      * @param isOk
-     * Condition result.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param prefix
      * Contract type prefix used in the error message.
@@ -591,7 +611,7 @@ declare class Contracts {
      * @internal
      *
      * @param isOk
-     * Condition result.
+     * Condition result(`boolean`)  to be verified.
      *
      * @param prefix
      * Contract type prefix used in the error message.

package/dist/index.js

@@ -6,30 +6,39 @@ var Contracts = class _Contracts {
   /** Debug mode state */
   static DEBUG_MODE = false;
   /** default configuration */
-  static defaultConf = {
+  static #defaultConf = {
     debug: false,
     logger: console
   };
+  /** Current config. */
+  static #config = { ..._Contracts.#defaultConf };
   /** logger */
-  static logger = console;
+  //private static logger: LogProvider = console;
   /**
    * Configures contract checking behavior.
    *
    * @param config
-   * Configuration options.
-   *
-   * The `debug` property enables or disables
-   * debug-only contract checks.
-   *
+   * Configuration options. <br>
+   * <br>
+   * The `debug` property toggles the behavior—specifically, 
+   * throwing an exception or outputting to the console when the condition is 
+   * false—for the validation of contracts intended for use during debugging (methods ending in `_DEBUG`). <br>
+   * <br>
    * When `debug` is `true`,
-   * methods ending with `_DEBUG` perform validation.
-   *
-   * When `debug` is `false` or omitted,
-   * methods ending with `_DEBUG` skip validation.
-   * 
+   * methods ending with `_DEBUG` perform validation. <br>
+   * <br>
+   * When `debug` is `false`,
+   * methods ending with `_DEBUG` skip validation. <br>
+   *  <br>
    * Is the `logger` property is specified, 
    * it is used instead of the standard logger, `console`.
-   * This module uses only the `error` method of the `logger`.
+   * This module uses only the `error` method of the `logger`. <br>
+   * <br>
+   * Note: If the value of a property is `undefined`, it is treated as unspecified.
+   * 
+   * @param reset
+   * If `true`, unspecified values ​​are saved to the settings as default values. <br>
+   * If `false`, unspecified values ​​remain at their current settings.
    *
    * @example
    * // Use a logger that is slightly more advanced than the standard logger—namely, `console`.
@@ -39,9 +48,36 @@ var Contracts = class _Contracts {
    * Contracts.setConfig({ debug: true, logger: prettyConsole });
    * // Node: ` The `logger` property is optional.
    */
-  static setConfig(config) {
-    _Contracts.DEBUG_MODE = Boolean(config?.debug);
-    _Contracts.logger = config?.logger ?? console;
+  static setConfig(config, reset = true) {
+    const rConf = { ...config };
+    for (let key of Object.keys(rConf)) {
+      if (rConf[key] == null) delete rConf[key];
+    }
+    if (reset) _Contracts.#config = { ..._Contracts.getDefaultConfig() };
+    Object.assign(_Contracts.#config, rConf);
+    _Contracts.DEBUG_MODE = _Contracts.#config.debug;
+  }
+  /**
+   * Get the default configurations.
+   * @returns Default configurations.
+   */
+  static getDefaultConfig() {
+    return { ..._Contracts.#defaultConf };
+  }
+  /**
+   * Get the current configurations.
+   * @returns Default configurations.
+   */
+  static getConfig() {
+    _Contracts.#config.debug = _Contracts.DEBUG_MODE;
+    return { ..._Contracts.#config };
+  }
+  /**
+   * Reset the current configurations to the default configurations.
+   * @returns Default configurations.
+   */
+  static resetConfig() {
+    _Contracts.setConfig({}, true);
   }
   /**
    * Verifies an intermediate condition during execution.
@@ -61,7 +97,7 @@ var Contracts = class _Contracts {
    * - Check temporary assumptions during execution.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -118,7 +154,7 @@ var Contracts = class _Contracts {
    * - Check internal assumptions while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -173,7 +209,7 @@ var Contracts = class _Contracts {
    * - Check required external conditions.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -237,7 +273,7 @@ var Contracts = class _Contracts {
    * - Perform additional argument checks while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -293,7 +329,7 @@ var Contracts = class _Contracts {
    * - Verify that processing completed correctly.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -359,7 +395,7 @@ var Contracts = class _Contracts {
    * - Confirm internal behavior while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -415,7 +451,7 @@ var Contracts = class _Contracts {
    * INVARIANT represents conditions that must always remain true.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param ngMsg
    * Failure message.
@@ -478,7 +514,7 @@ var Contracts = class _Contracts {
    * - Detect unexpected state changes while debugging.
    *
    * @param isOk
-   * Condition result to verify.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param [ngMsg]
    * Failure message.
@@ -536,7 +572,7 @@ var Contracts = class _Contracts {
    * @internal
    * 
    * @param isOk
-   * Condition result.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param prefix
    * Contract type prefix used in the error message.
@@ -576,9 +612,7 @@ var Contracts = class _Contracts {
       const msg = `[${prefix}] ${ngMsg ?? ""}`;
       if (ErrorClass) {
         const err = eParams ? new ErrorClass(msg, eParams) : new ErrorClass(msg);
-        if (eProps) {
-          Object.assign(err, eProps);
-        }
+        eProps && Object.assign(err, eProps);
         throw err;
       }
       if (ngMsg) {
@@ -600,7 +634,7 @@ var Contracts = class _Contracts {
    * @internal
    * 
    * @param isOk
-   * Condition result.
+   * Condition result(`boolean`)  to be verified.
    *
    * @param prefix
    * Contract type prefix used in the error message.
@@ -645,7 +679,7 @@ var Contracts = class _Contracts {
    * @internal
    */
   static getLogger() {
-    return _Contracts.logger ?? console;
+    return _Contracts.#config.logger;
   }
 };
 

package/package.json

@@ -1,38 +1,43 @@
-{
-  "name": "@ayapapa-npm/contracts-js",
-  "version": "0.3.0",
-  "description": "A lightweight Design by Contract library for JavaScript.",
-  "license": "MIT",
-  "author": "ayapapa",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --out-dir dist --clean --dts",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:debug": "vitest --inspect-brk --run",
-    "test:watch": "vitest",
-    "check": "npm run typecheck && npm run build && npm run test",
-    "release:check": "npm run typecheck && npm run build && npm run test",
-    "prepublishOnly": "npm run release:check"
-  },
-  "devDependencies": {
-    "@types/node": "^26.2.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.10"
-  },
-  "allowScripts": {
-    "esbuild@0.28.1": true
-  }
-}
+{
+  "name": "@ayapapa-npm/contracts-js",
+  "version": "0.4.1",
+  "description": "A lightweight Design by Contract library for JavaScript.",
+  "license": "MIT",
+  "author": "ayapapa",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --out-dir dist --clean --dts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:debug": "vitest --inspect-brk --run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "coverage": "vitest run --coverage",
+    "coverage:ui": "vitest run --coverage && start coverage/index.html",
+    "check": "npm run typecheck && npm run build && npm run test",
+    "release:check": "npm run check",
+    "prepublishOnly": "npm run release:check"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "@vitest/ui": "^4.1.11",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.0",
+    "typescript": "^5.9.3",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11"
+  }
+}