Updated README more.

Also working on making sure npm does not install redundant copies of packages

Author: Steve Thompson

README.md

@@ -532,6 +532,10 @@ prepend(values: any[]): this
 forEach(iterationFunction): this
     // Behaves same as Array.forEach()
     // iterationFunction = function(currentValue, currentIndex?, entireArray?){...}
+    
+set(newArray): this
+    // Changes value of this.data to newArray without breaking its memory reference.
+    // So if there are copies of this.data, the copies will be updated as well.
 
 protected  _createGetterAndOrSetterForEach(
 		propertyNames: string[],
@@ -556,17 +560,18 @@ runMethod_and_returnThis(
 
 ```
 // changing the array content:
-arr.data = [1,2,3,4,5,6,7];
+arr.data = [{prop1: 'yes', prop2: 'no'}, {prop1: 'no', prop2: 'yes'}];
 ```
 
 ## Performance
 
 PublicArray has a large number of dependencies.  You should keep this in mind when optimizing  
-the performance of your app. If your code only uses one property of PublicArray, like for  
-instance `.replace`, you will get a slight performance boost if you just use an instance of  
-PublicArrayReplacer instead:
+the performance of your app. For example, say your code only uses PublicArray's `.replace` property  
+and nothing else.  Since `.replace` is an instance of PublicArrayReplacer, you will get a slight   
+performance boost if you just instantiate PublicArrayReplacer instead of PublicArray:
 ```
-let replace = new PublicArrayReplacer(arr);
+let replace = new PublicArrayReplacer(array);
+replace.adjacentAt(2, ['just', 'an', 'example']);
 ```
 ## Inheritance Chain
 

dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PublicArray } from './privy/PublicArray';
+import { PublicArray } from './privy/PublicArray_previous';
 
 
 export declare function getPublicArray(array?: any[]): PublicArray;

dist/privy/PublicArray.d.ts

@@ -37,19 +37,17 @@ export declare class PublicArray extends PublicArrayContent {
 	private _sort;
 
 
-	/***************
-	 Public Properties:
+	// Public Properties:
 
-	 readonly copy: PublicArray; // independent copy of this instance.
-	 readonly filter: PublicArrayFilter;
-	 readonly getConverted: PublicArrayGetterConverter;
-	 readonly get: PublicArrayGetter;
-	 readonly getAndRemove: PublicArrayGetterRemover;
-	 readonly insert: PublicArrayInserter;
-	 readonly remove: PublicArrayRemover;
-	 readonly replace: PublicArrayReplacer;
-	 readonly sort: PublicArraySorter;
-	 ***************/
+	readonly copy: PublicArray; // independent copy of this instance.
+	readonly filter: PublicArrayFilter;
+	readonly getConverted: PublicArrayGetterConverter;
+	readonly get: PublicArrayGetter;
+	readonly getAndRemove: PublicArrayGetterRemover;
+	readonly insert: PublicArrayInserter;
+	readonly remove: PublicArrayRemover;
+	readonly replace: PublicArrayReplacer;
+	readonly sort: PublicArraySorter;
 
 
 	constructor(
@@ -69,14 +67,17 @@ export declare class PublicArray extends PublicArrayContent {
 	);
 
 
-	readonly copy: PublicArray;
-
-
 	append(values: any[]): this;
 
 
 	prepend(values: any[]): this;
 
 
-	forEach(iterationFunction: any): this;
+	forEach(
+		iterationFunction: (currentValue: any, currentIndex?: number, entireArray?: any[]) => any
+	): this;
+
+
+	set(newArray: any[]): this;
+
 }

dist/privy/PublicArray.js

@@ -14,6 +14,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 var array_append_prepend_1 = require("@writetome51/array-append-prepend");
+var set_array_1 = require("@writetome51/set-array");
 var di_factory_1 = require("@writetome51/di-factory");
 var public_array_content_1 = require("@writetome51/public-array-content");
 /**************
@@ -32,19 +33,6 @@ var public_array_content_1 = require("@writetome51/public-array-content");
  *************/
 var PublicArray = /** @class */ (function (_super) {
     __extends(PublicArray, _super);
-    /***************
-     Public Properties:
-
-     readonly  copy: PublicArray; // independent copy of this instance.
-     readonly  filter: PublicArrayFilter;
-     readonly  getConverted: PublicArrayGetterConverter;
-     readonly  get: PublicArrayGetter;
-     readonly  getAndRemove: PublicArrayGetterRemover;
-     readonly  insert: PublicArrayInserter;
-     readonly  remove: PublicArrayRemover;
-     readonly  replace: PublicArrayReplacer;
-     readonly  sort: PublicArraySorter;
-     ***************/
     function PublicArray(
     // begin injected dependencies...
     _filter, _getConverted, _get, _getAndRemove, _insert, _remove, _replace, _sort, 
@@ -89,11 +77,13 @@ var PublicArray = /** @class */ (function (_super) {
     PublicArray.prototype.prepend = function (values) {
         return this.returnThis_after(array_append_prepend_1.prepend(values, this.data));
     };
-    // this.forEach(iterationFunction)
-    // iterationFunction = function(currentItem, currentIndex?, entireArray?){...}
     PublicArray.prototype.forEach = function (iterationFunction) {
         return this.returnThis_after(this.data.forEach(iterationFunction));
     };
+    // Use this for changing value of this.data without breaking its memory reference.
+    PublicArray.prototype.set = function (newArray) {
+        return this.returnThis_after(set_array_1.setArray(this.data, newArray));
+    };
     return PublicArray;
 }(public_array_content_1.PublicArrayContent));
 exports.PublicArray = PublicArray;

dist/tests.d.ts

@@ -1,4 +1,15 @@
 export {};
+/****************
+
+
+let otherArr = arr.data;
+
+otherArr.length = 0;
+
+console.log(otherArr);
+
+console.log(arr.data);
+ *************/
 /************
  arr.remove.allAfterFirst(6);
  arr.remove.allBeforeFirst(3);

dist/tests.js

@@ -4,9 +4,11 @@ var index_1 = require("./index");
 console.log('hello');
 //let arr = new PublicArrayReplacer([1, 2, 3, 4, 5, 6, 7, 8, 9]);
 var arr = index_1.getPublicArray([1, 2, 3, 4, 5, 6, 7, 8, 9]);
-console.log(arr.remove.byIndex(0).byIndexes([1, 3, 5]).adjacentAt(1, 2));
+console.log(arr.remove.byIndex(0).byIndexes([1, 3, 5]).adjacentAt(1, 2)); // [2, 8, 9]
 var arrCopy = arr.copy;
-console.log(arrCopy);
+arrCopy.data = [1, 2];
+console.log(arrCopy.data);
+console.log(arr.data);
 /****************
 
 

lib/privy/PublicArray.ts

@@ -1,4 +1,5 @@
 import { append, prepend } from '@writetome51/array-append-prepend';
+import { setArray } from '@writetome51/set-array';
 import { DIFactory } from '@writetome51/di-factory';
 import { PublicArrayRemover } from '@writetome51/public-array-remover';
 import { PublicArrayContent } from '@writetome51/public-array-content';
@@ -29,10 +30,10 @@ import { PublicArrayFilter } from '@writetome51/public-array-filter';
 
 export class PublicArray extends PublicArrayContent {
 
-	/***************
-	 Public Properties:
 
-	 readonly  copy: PublicArray; // independent copy of this instance.
+	 //Public Properties:
+
+	 //readonly  copy: PublicArray; // independent copy of this instance.
 	 readonly  filter: PublicArrayFilter;
 	 readonly  getConverted: PublicArrayGetterConverter;
 	 readonly  get: PublicArrayGetter;
@@ -41,7 +42,7 @@ export class PublicArray extends PublicArrayContent {
 	 readonly  remove: PublicArrayRemover;
 	 readonly  replace: PublicArrayReplacer;
 	 readonly  sort: PublicArraySorter;
-	 ***************/
+
 
 
 	constructor(
@@ -94,11 +95,16 @@ export class PublicArray extends PublicArrayContent {
 	}
 
 
-	// this.forEach(iterationFunction)
-	// iterationFunction = function(currentItem, currentIndex?, entireArray?){...}
-	forEach(iterationFunction): this {
+	forEach(iterationFunction: (currentValue, currentIndex?, entireArray?) => any): this {
 		return this.returnThis_after(this.data.forEach(iterationFunction));
 	}
 
 
+	// Use this for changing value of this.data without breaking its memory reference.
+	set(newArray): this {
+		return this.returnThis_after(setArray(this.data, newArray));
+	}
+
+
 }
+

lib/tests.ts

@@ -4,9 +4,11 @@ import { PublicArrayReplacer } from '@writetome51/public-array-replacer';
 console.log('hello');
 //let arr = new PublicArrayReplacer([1, 2, 3, 4, 5, 6, 7, 8, 9]);
 let arr = getPublicArray([1, 2, 3, 4, 5, 6, 7, 8, 9]);
-console.log(arr.remove.byIndex(0).byIndexes([1,3,5]).adjacentAt(1, 2));
+console.log(arr.remove.byIndex(0).byIndexes([1,3,5]).adjacentAt(1, 2));// [2, 8, 9]
 let arrCopy = arr.copy;
-console.log(arrCopy);
+arrCopy.data = [1,2];
+console.log(arrCopy.data);
+console.log(arr.data);
 
 /****************
 

package.json

@@ -39,6 +39,7 @@
     "@writetome51/public-array-getter-remover": "~1.0.0",
     "@writetome51/public-array-filter": "~1.0.5",
     "@writetome51/array-append-prepend": "~1.0.3",
-    "@writetome51/di-factory": "~1.0.0"
+    "@writetome51/di-factory": "~1.0.0",
+    "@writetome51/set-array": "~1.0.0"
   }
 }