Merge pull request #6 from typescript-package/develop

v2.0.0

Author: wwwdev-ai

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@typescript-package/core",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "author": "wwwdev.io <[email protected]>",
   "description": "A TypeScript library with features used across other `typescript-package` libraries.",
   "license": "MIT",

package.json

@@ -4,5 +4,5 @@
  * @returns {string} The return value is a `string` of the object class name.
  * @author https://javascript.plainenglish.io/the-best-way-to-type-check-in-vanilla-js-55197b4f45ec
  */
-export const typeOf = (value: any): string =>
-  Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
+export const typeOf = (value: any): string => 
+  Object.prototype.toString.call(value).slice(8, -1);

src/lib/type-of.func.ts

@@ -3,9 +3,31 @@
  * @export
  * @abstract
  * @class Value
- * @template Type 
+ * @template Type The type of the privately stored `#value`.
  */
+
 export abstract class Value<Type> {
+  /**
+   * @description Returns the `string` tag representation of the `Value` class when used in `Object.prototype.toString.call(instance)`.
+   * The `tag` getter returns the actual class name defined with the `Symbol.toStringTag()` of the child class.
+   * @public
+   * @readonly
+   * @type {string}
+   */
+  public get [Symbol.toStringTag]() {
+    return 'Value';
+  }
+
+  /**
+   * @description Returns the string tag of the current instance defined by the `Symbol.toStringTag`.
+   * @public
+   * @returns {string | undefined} The extracted class name, such as `'Value'`, or `undefined` if extraction fails.
+   */
+  public get tag(): string | undefined {
+    const tag = Object.prototype.toString.call(this).slice(8, -1);
+    return tag !== 'Object' ? tag : undefined;
+  }
+
   /**
    * @description Returns the privately stored value of generic type variable `Type`.
    * @public
@@ -16,7 +38,6 @@ export abstract class Value<Type> {
     return this.#value;
   }
 
-  
   /**
    * @description Privately stored value of generic type variable `Type`.
    * @type {Type}

src/lib/value.class.ts

@@ -0,0 +1,11 @@
+import { Value } from "../lib";
+
+export class TestValue<Type> extends Value<Type> {
+  public override get [Symbol.toStringTag]() {
+    return 'TestValue';
+  }
+}
+
+const value = new TestValue('test');
+
+console.log(`tag, `, value.tag);