@xaendar/types 0.3.38 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaendar/types",
-  "version": "0.3.38",
+  "version": "0.4.0",
   "description": "A library containing common types shared across packages and consumers",
   "sideEffects": false,
   "type": "module",

package/xaendar-types.es.d.ts

@@ -4,10 +4,29 @@
  */
 export declare type AbstractConstructor<T extends object = object, Statics extends Record<string, unknown> | undefined = undefined> = (abstract new (...args: any[]) => T) & (Statics extends undefined ? object : Statics);
 
-export declare type AccessorDecorator<Class extends Object, Field = unknown, ReturnTypeField = Field> = (value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, ReturnTypeField>) => {
-    get?: () => ReturnTypeField;
-    set?: (value: ReturnTypeField) => void;
-    init?: (initialValue: Field) => ReturnTypeField;
+/**
+ * Represents a class accessor decorator function.
+ *
+ * Note: the `context` parameter uses `Field` (not `ReturnTypeField`) because
+ * `ClassAccessorDecoratorContext` is tied to the original field type.
+ *
+ * @template Class - The class that owns the decorated accessor.
+ * @template Value - The original type of the accessor's value.
+ * @template ActualValue - The type returned/set by the replacement accessor (defaults to `InitialValue`).
+ */
+export declare type AccessorDecorator<Class extends object, Value = unknown> = (value: ClassAccessorDecoratorValue<Value>, context: ClassAccessorDecoratorContext<Class, Value>) => {
+    /**
+     * Replacement getter returning a value of `Value`.
+     */
+    get?(this: Class): Value;
+    /**
+     * Replacement setter accepting a value of `Value`.
+     */
+    set?(this: Class, value: Value): void;
+    /**
+     * Initializer called with the original field value; should return a `Value`.
+     */
+    init?(this: Class, initialValue: Value): Value;
 } | void;
 
 /**
@@ -19,9 +38,21 @@ export declare type Beautify<T extends Object> = {
     [K in keyof T]: T[K];
 } & {};
 
+/**
+ * Represents the accessor descriptor passed to a class accessor decorator,
+ * containing the original `get` and `set` methods of the decorated accessor.
+ *
+ * @template Field - The type of the accessor's value.
+ */
 export declare type ClassAccessorDecoratorValue<Field = unknown> = {
-    get?: () => Field;
-    set: (value: Field) => void;
+    /**
+     * Returns the current value of the accessor.
+     */
+    get(this: unknown): Field;
+    /**
+     * Sets the value of the accessor.
+     */
+    set(this: unknown, value: Field): void;
 };
 
 declare type ClassDecorator_2<T extends Object, Statics extends {