@typedly/data 1.0.0 → 2.0.0

package/README.md

@@ -23,8 +23,12 @@ A **TypeScript** type definitions package for [**@typescript-package/data**](htt
   - [Interface](#interface)
     - [`DataConstructor`](#dataconstructor)
     - [`DataShape`](#datashape)
+    - [`ValueConstructor`](#valueconstructor)
+    - [`ValueShape`](#valueshape)
   - [Type](#type)
     - [`DataConstructorInput`](#dataconstructorinput)
+    - [`DataConstructorTuple`](#dataconstructortuple)
+- [Full example usage](#full-example-usage)
 - [Contributing](#contributing)
 - [Support](#support)
 - [Code of Conduct](#code-of-conduct)
@@ -55,8 +59,11 @@ import {
   // Interface.
   DataConstructor,
   DataShape,
+  ValueConstructor,
+  ValueShape,
   // Type.
-  DataConstructorInput
+  DataConstructorInput,
+  DataConstructorTuple,
 } from '@typedly/data';
 ```
 
@@ -67,9 +74,82 @@ import {
 The constructor interface for data types.
 
 ```typescript
-import { DataConstructor } from '@typedly/data';
+import { DataConstructor, DataShape } from '@typedly/data';
+
+// Import DataShape and DataConstructor.
+// Create a data class that implements `DataShape` of `Type`.
+export class ProfileData<
+  Value extends { age: number, name: string }
+> implements DataShape<Value> {
+
+  get value(): Value {
+    return {
+      age: this.#age,
+      name: this.#name
+    } as Value;
+  }
+
+  #age;
+  #name;
+  constructor(value: Value, ...args: any[]) {
+    console.log(`Instantiated DataConstructor`, value, ...args);
+    this.#age = value.age;
+    this.#name = value.name;
+  }
+
+  set(value: Value): this { this.validate(value); return this; }
+  clear(): this { return this; }
+  destroy(): this { return this; }
+  lock(): this { return this; };
+  validate(value: Value): boolean {
+    return true;
+  }
+}
+
+// Create `ProfileClass` with customizable data.
+export class ProfileClass<
+  Value extends { age: number, name: string },
+  DataType extends DataShape<Value>,
+  Args extends any[]
+> {
+
+  public get age(): Value['age'] {
+    return this.#data.value.age;
+  }
+
+  public get name(): Value['name'] {
+    return this.#data.value.name;
+  }
+
+  public get data() {
+    return this.#data;
+  }
+
+  #data: DataType;
+
+  constructor(value: Value, dataCtor: DataConstructor<Value, DataType>);
+  constructor(value: Value, dataCtor: [DataConstructor<Value, DataType>, ...Args]);
+  constructor(value: Value, dataCtor: any) {
+    // ...implementation
+    console.log(`DataConstructor`, value, dataCtor[1]);
+    this.#data = Array.isArray(dataCtor)
+      ? new dataCtor[0](value, ...dataCtor.slice(1))
+      : new dataCtor(value);
+  }
+}
+
+// Initialize.
+// const frankProfile: ProfileClass<object, ProfileData<object>, any[]>
+const frankProfile = new ProfileClass({ age: 37, name: 'Frank' }, ProfileData);
 
-export const ctor: DataConstructor<number, DataShape<number>, any[]> = TestData;
+frankProfile.age; // 37
+frankProfile.name; // Frank
+
+// Set the data.
+frankProfile.data.set({ age: 37, name: 'Frank' });
+frankProfile.data.clear();
+frankProfile.data.lock();
+frankProfile.data.value;
 ```
 
 [Source](https://github.com/typedly/data/blob/main/src/lib/interface/data-constructor.interface.ts)
@@ -93,6 +173,24 @@ class TestData implements DataShape<number> {
 
 [Source](https://github.com/typedly/data/blob/main/src/lib/interface/data-shape.interface.ts)
 
+#### `ValueConstructor`
+
+```typescript
+import { ValueConstructor } from '@typedly/data';
+```
+
+[Source](https://github.com/typedly/data/blob/main/src/lib/interface/value-constructor.interface.ts)
+
+#### `ValueShape`
+
+The shape of a `Value` type.
+
+```typescript
+import { ValueShape } from '@typedly/data';
+```
+
+[Source](https://github.com/typedly/data/blob/main/src/lib/interface/value-shape.interface.ts)
+
 ### Type
 
 #### `DataConstructorInput`
@@ -100,23 +198,139 @@ class TestData implements DataShape<number> {
 The input type for data constructors, with arguments support.
 
 ```typescript
-import { DataConstructorInput, DataShape } from '@typedly/data';
-
-function createData<Value, DataType extends DataShape<Value>>(
-  input: DataConstructorInput<Value, DataType>,
-  value: Value
-): DataType {
-  if (Array.isArray(input)) {
-    const [Ctor, ...args] = input;
-    return new Ctor(value, ...args);
-  } else {
-    return new input(value);
-  }
-}
+import { DataConstructorInput } from '@typedly/data';
 ```
 
 [Source](https://github.com/typedly/data/blob/main/src/lib/type/data-constructor-input.type.ts)
 
+#### `DataConstructorTuple`
+
+The input type for data constructors, with arguments support.
+
+```typescript
+import { DataConstructorTuple } from '@typedly/data';
+```
+
+[Source](https://github.com/typedly/data/blob/main/src/lib/type/data-constructor-tuple.type.ts)
+
+### Full example usage
+
+```typescript
+import { DataConstructor, DataShape, ValueConstructor, ValueShape } from '@typedly/data';
+
+// Import ValueShape and ValueConstructor.
+// Create a profile data value.
+export class ProfileDataValue<
+  Type extends { age: number, name: string },
+  Args extends any[] = any[]
+> implements ValueShape<Type> {
+  get value(): Type {
+    return {
+      age: this.#age,
+      name: this.#name
+    } as Type;
+  }
+
+  #age: Type['age'];
+  #name: Type['name'];
+
+  constructor(value: Type, ...args: Args) {
+    console.log(`Instantiated ValueConstructor`, value, ...args);
+    this.#age = value.age;
+    this.#name = value.name;
+  }
+
+  set(value: Type): this { return this; }
+}
+
+export class ProfileDataOfValue<
+  Value extends { age: number, name: string },
+  Args extends any[] = any[],
+  ValueInstance extends ValueShape<Value> = ProfileDataValue<Value, Args>,
+> implements DataShape<Value> {
+
+  get value(): Value {
+    return {
+    } as Value;
+  }
+
+  get valueInstance(): ValueInstance {
+    return this.#value;
+  }
+
+  #value;
+  constructor(
+    value: Value,
+    valueCtor: ValueConstructor<Value, ValueInstance, Args> = ProfileDataValue<Value, Args> as any,
+    ...args: Args
+  ) {
+    console.log(`Instantiated DataConstructor`, value, ...args);
+    this.#value = new valueCtor(value, ...args);
+  }
+
+  set(value: Value): this { this.validate(value); return this; }
+  clear(): this { return this; }
+  destroy(): this { return this; }
+  lock(): this { return this; };
+  validate(value: Value): boolean {
+    return true;
+  }
+}
+
+// const profileDataOfValue: ProfileDataOfValue<{
+//     age: number;
+//     name: string;
+// }, ProfileDataValue<{
+//     age: number;
+//     name: string;
+// }, []>, []>
+const profileDataOfValue = new ProfileDataOfValue({
+  age: 37,
+  name: 'Mark'
+}, ProfileDataValue);
+
+const dataSymbol = Symbol('data');
+
+// Create `ProfileClass` with customizable data.
+export class ProfileClass<
+  Value extends { age: number, name: string },
+  DataType extends DataShape<Value>,
+  Args extends any[]
+> {
+
+  public get age(): Value['age'] {
+    return this.#data.value.age;
+  }
+
+  public get name(): Value['name'] {
+    return this.#data.value.name;
+  }
+
+  public get [dataSymbol]() {
+    return this.#data;
+  }
+
+  #data: DataType;
+
+  constructor(value: Value, dataCtor: DataConstructor<Value, DataType, Args>);
+  constructor(value: Value, dataCtor: [DataConstructor<Value, DataType, Args>, ...Args]);
+  constructor(value: Value, dataCtor: any) {
+    // ...implementation
+    console.log(`DataConstructor`, value, dataCtor[1]);
+    this.#data = Array.isArray(dataCtor)
+      ? new dataCtor[0](value, ...dataCtor.slice(1))
+      : new dataCtor(value);
+  }
+}
+
+const markProfile = new ProfileClass({ age: 37, name: 'Mark' }, ProfileDataOfValue);
+
+markProfile.age // 37
+markProfile.name // Mark
+markProfile[dataSymbol].value // { age, name }
+markProfile[dataSymbol].valueInstance.set({ age: 27, name: 'Frank' });
+```
+
 ## Contributing
 
 Your contributions are valued! If you'd like to contribute, please feel free to submit a pull request. Help is always appreciated.
@@ -209,7 +423,7 @@ MIT © typedly ([license][typedly-license])
 
 <!-- Package: typedly -->
   <!-- npm -->
-  [typedly-npm-badge-svg]: https://badge.fury.io/js/@typedly%2Fdata.svg
+  [typedly-npm-badge-svg]: https://badge.fury.io/gh/typedly%2Fdata.svg
   [typedly-npm-badge]: https://badge.fury.io/js/@typedly%2Fdata
 
 <!-- GIT -->

package/index.d.ts

@@ -26,12 +26,45 @@ interface DataShape<Value> {
 interface DataConstructor<Value, Instance extends DataShape<Value>, Args extends readonly any[] = any[]> extends DataConstructor$1<Value, DataShape<Value>, Instance, [...Args]> {
 }
 
+/**
+ * @description The value shape.
+ * @export
+ * @interface ValueShape
+ * @template Type The type of value.
+ */
+interface ValueShape<Type> {
+    get value(): Type;
+    set(value: Type): this;
+}
+
+/**
+ * @description The constructor for value in data for advanced customization.
+ * @export
+ * @interface ValueConstructor
+ * @template Value The value type.
+ * @template {ValueShape<Value>} Instance The instance.
+ * @template {readonly any[]} [Args=any[]] Additional arguments passed to the constructor.
+ * @extends {BaseDataConstructor<Value, ValueShape<Value>, Instance, [...Args]>}
+ */
+interface ValueConstructor<Value, Instance extends ValueShape<Value>, Args extends readonly any[] = any[]> extends DataConstructor$1<Value, ValueShape<Value>, Instance, [...Args]> {
+}
+
+/**
+ * @description The type to provide data constructor with arguments.
+ * @export
+ * @template Value The value type.
+ * @template {DataShape<Value>} Instance The shape of the instance.
+ * @template {any[]} [Args=any[]] Additional Arguments passed to the instance.
+ */
+type DataConstructorTuple<Value, Instance extends DataShape<Value>, Args extends any[] = any[]> = [DataConstructor<Value, Instance, Args>, ...Args];
+
 /**
  * @description The input type for data constructors, with arguments support.
  * @export
  * @template Value The value type.
  * @template {DataShape<Value>} Instance The data instance type.
+ * @template {any[]} [Args=any[]] The arguments to pass to instance.
  */
-type DataConstructorInput<Value, Instance extends DataShape<Value>> = [DataConstructor<Value, Instance>, ...any[]] | DataConstructor<Value, Instance>;
+type DataConstructorInput<Value, Instance extends DataShape<Value>, Args extends any[] = any[]> = DataConstructor<Value, Instance, Args> | DataConstructorTuple<Value, Instance, Args>;
 
-export type { DataConstructor, DataConstructorInput, DataShape };
+export type { DataConstructor, DataConstructorInput, DataConstructorTuple, DataShape, ValueConstructor, ValueShape };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typedly/data",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "author": "wwwdev.io <dev@wwwdev.io>",
   "description": "A TypeScript type definitions package for @typescript-package/data.",
   "license": "MIT",