risei 2.0.0 → 2.0.1

package/test-target-objects/InterSpoofer.js

@@ -1,230 +0,0 @@
-/**/
-
-import MethodSpoofer from "../system/MethodSpoofer.js";
-import PropertySpoofer from "../system/PropertySpoofer.js";
-import PropertiesTarget from "./PropertiesTarget.js";
-
-/* &cruft, maybe drop this after direct testing of groundwork 
-           and reversing it is possible with .do / .undo */
-export default class InterSpoofer {
-    // region Components
-
-    #methodSpoofer = new MethodSpoofer();
-    #propSpoofer = new PropertySpoofer();
-
-    // endregion Components
-
-    // region Gathered names of all spoofables
-
-    static staticProps = [ "staticBaseValueProp", "staticBaseAccessorProp", "staticValueProp", "staticAccessorProp" ];
-    static staticMethods = [ "staticBaseMethod", "staticMethod" ];
-    static props = [ "instanceBaseValueProp", "instanceBaseAccessorProp", "valueProp", "accessorProp" ];
-    static methods = [ "instanceBaseMethod", "instanceMethod" ];
-
-    static allMethods = [ InterSpoofer.staticMethods, InterSpoofer.methods ];
-    static allNames = [ InterSpoofer.staticProps, InterSpoofer.staticMethods, InterSpoofer.props, InterSpoofer.methods ];
-
-    // endregion Gathered names of all spoofables
-
-    // region Gathered original method defs and values
-
-    static #origDefs = InterSpoofer.#bundleDefs(
-        PropertiesTarget, new PropertiesTarget(), ...InterSpoofer.allMethods
-    );
-
-    static #origValues = InterSpoofer.#bundleValues(
-        PropertiesTarget, new PropertiesTarget(), ...InterSpoofer.allNames
-    );
-
-    // endregion Gathered original method defs and values
-
-    // region Methods to test spoofers
-
-    /* If these methods all pass, then the spoofers work 
-       together without breaking each other's changes. */
-
-    spoofMethodsThenProps(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let values = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return values;
-    }
-    
-    spoofPropsThenMethods(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let values = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return values;
-    }
-
-    spoofAndUnspoofMethodsThenProps(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#methodSpoofer.unspoof(test);
-        this.#propSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofAndUnspoofPropsThenMethods(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#propSpoofer.unspoof(test);
-        this.#methodSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofMethodsFirstAndUnspoofThemLast(test) /* passed */ {
-        this.#methodSpoofer.spoof(test);
-        this.#propSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#propSpoofer.unspoof(test);
-        this.#methodSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    spoofPropsFirstAndUnspoofThemLast(test) /* passed */ {
-        this.#propSpoofer.spoof(test);
-        this.#methodSpoofer.spoof(test);
-
-        let type = test.type;
-        let target = test.target;
-
-        let before = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.#methodSpoofer.unspoof(test);
-        this.#propSpoofer.unspoof(test);
-
-        let after = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-
-        this.reverseAllSpoofs(type, target);
-
-        return { before, after };
-    }
-
-    // endregion Methods to test spoofers
-
-    /* To ensure topic class isolated between tests. */
-    reverseAllSpoofs(type, target) /* verified */ {
-        /* Setting known properties and methods of target type 
-           back to their stored original definitions / values. */
-
-        for (let name of InterSpoofer.staticProps) {
-            type[name] = InterSpoofer.#origValues[name];
-        }
-
-        for (let name of InterSpoofer.staticMethods) {
-            type[name] = InterSpoofer.#origDefs[name];
-        }
-
-        /* Plain instance properties shouldn't need to be reversed. */
-
-        for (let name of InterSpoofer.methods) {
-            type.prototype[name] = InterSpoofer.#origDefs[name];
-        }
-
-        for (let name of InterSpoofer.props) {
-            target[name] = InterSpoofer.#origValues[name];
-        }
-
-        let reversed = InterSpoofer.#bundleValues(type, target, ...InterSpoofer.allNames);
-    }
-
-    // region Internals
-
-    static #bundleDefs(type, target, staticMethods, methods) /* verified */ {
-        /* All callables asked for are stored as copies for restoring. */
-
-        let output = { };
-
-        for (let name of staticMethods) {
-            output[name] = InterSpoofer.#copyMethod(type[name]);
-        }
-
-        for (let name of methods) {
-            output[name] = InterSpoofer.#copyMethod(target[name]);
-        }
-
-        return output;
-    }
-
-    static #bundleValues(type, target, staticProps, staticMethods, props, methods) /* verified */ {
-        /* Everything asked for is dropped into an object, either 
-           property values or return values of calling methods. */
-
-        let output = { };
-
-        for (let name of staticProps) {
-            output[name] = type[name];
-        }
-
-        for (let name of staticMethods) {
-            output[name] = type[name]();
-        }
-
-        for (let name of props) {
-            output[name] = target[name];
-        }
-
-        for (let name of methods) {
-            output[name] = target[name]();
-        }
-
-        return output;
-    }
-
-    static #copyMethod(method) /* verified */ {
-        let passer = [ method ];
-        passer = [ ...passer ];
-        let copy = passer[0];
-
-        return copy;
-    }
-
-    // endregion Internals
-}

package/test-target-objects/MixedContents.js

@@ -1,33 +0,0 @@
-/**/
-
-export default class MixedContents {
-    first = 1;
-    second = "2";
-    third = { three: 3 };
-    
-    static fourth = 4;
-    static fifth = "5";
-    
-    getInstanceValueOf(name) {
-        return this[name];
-    }
-    
-    getInstanceProduct() {
-        let a = this.first;
-        let b = Number(this.second);
-        let c = this.third.three;
-
-        return a * b * c;
-    }
-    
-    static getStaticValueOf(name) {
-        return MixedContents[name];
-    }
-    
-    static getStaticProduct() {
-        let a = MixedContents.fourth;
-        let b = Number(MixedContents.fifth);
-
-        return a * b;
-    }
-}

package/test-target-objects/MutationTarget.js

@@ -1,37 +0,0 @@
-/**/
-
-export default class MutationTarget {
-    #map;
-    #array;
-
-    constructor(map, array) {
-        this.#map = map;
-        this.#array = array;
-    }
-
-    mutateInitors() {
-        // Map mutation allows for consecutive mutations.
-        let rawKey = this.#map.size + 1;
-        this.#map.set(rawKey.toString(), "C");
-        this.#array.shift();
-        
-        return { map: this.#map, array: this.#array };
-    }
-
-    mutateArgs(array, tuple) {
-        array.push(10);
-        tuple.changes += 10;
-        
-        return { array, tuple };
-    }
-    
-    replaceArg(array, index, replacement) {
-        // The previous element is added at the end for comparison.
-        array.push(array[index].toString());
-
-        // The new element is set at the original index.
-        array[index] = replacement;
-
-        return array;
-    }
-}

package/test-target-objects/ObjectComposer.js

@@ -1,34 +0,0 @@
-/**/
-
-export default class ObjectComposer {
-    constructor() {
-        /* No operations. */
-    }
-    
-    /* Target of spoofing. */
-    supplySomeObject() {
-        throw new Error("supplyObjectA() must be spoofed in tests.");
-    }
-    
-    enact(chain, method) {
-        // Invoke the method to be spoofed.
-        let target = this.supplySomeObject();
-        
-        // Traverse the spoofed return 
-        // value's object tree.
-        for (let link of chain) {
-            target = target[link];
-        }
-        
-        // Invoke the method at chain end for its return value.
-        let output = target[method]();
-        return output;
-    }
-    
-    doubleEnact(chainOne, methodOne, chainTwo, methodTwo) {
-        let outputOne = this.enact(chainOne, methodOne);
-        let outputTwo = this.enact(chainTwo, methodTwo);
-        
-        return [ outputOne, outputTwo ];
-    }
-}

package/test-target-objects/PolySpoofableInner.js

@@ -1,29 +0,0 @@
-/**/
-
-export default class PolySpoofableInner {
-    constructor() {
-        /* No operations. */
-    }
-    
-    /* Spoofing target. */
-    addOrTimes(numbers) {
-        let a = numbers.supplyA();
-        let b = numbers.supplyB();
-        
-        return a + b;
-    }
-    
-    /* Spoofing target. */
-    minusOrOver(numbers) {
-        let a = numbers.supplyA();
-        let b = numbers.supplyB();
-    
-        return a - b;
-    }
-
-    /* Spoofing target.  Nested object. */
-    numberHost = { 
-        supplyC: () => { return 15; }, 
-        supplyD: () => { return 18; } 
-    }
-}

package/test-target-objects/PolySpoofableOuter.js

@@ -1,52 +0,0 @@
-/**/
-
-import PolySpoofableInner from "./PolySpoofableInner.js";
-
-export default class PolySpoofableOuter {
-    /* Spoofing target. */
-    #inner;
-
-    constructor() {
-        this.#inner = new PolySpoofableInner();
-    }
-    
-    /* Not intended to be spoofed, but to use spoofs. */
-    combinedNumbers(numbers) {
-        let first = this.#inner.addOrTimes(numbers);
-        let second = this.#inner.minusOrOver(numbers);
-        
-        let combined = this.combiner(first, second);
-        return combined;
-    }
-    
-    /* Spoofing target. */
-    combiner(first, second) {
-        let combined = Math.pow(first, second);
-        return combined;
-    }
-    
-    /* Not intended to be spoofed, but to use spoofs. */
-    combinedPlusHosted(numbers) {
-        let combined = this.combinedNumbers(numbers);
-        let third = this.#inner.numberHost.supplyC();
-        let fourth = this.#inner.numberHost.supplyD();
-        
-        return combined + third - fourth;
-    }
-    
-    /* Not intended to be spoofed, but to use arg with spoofs. */
-    combinedArgAAndB(inner) {
-        let first = inner.supplyA();
-        let second = inner.supplyB();
-        
-        return first + second;
-    }
-    
-    /* Not intended to be spoofed, but to use arg with spoofs. */
-    combinedArgHostedCAndD(inner) {
-        let third = inner.numberHost.supplyC();
-        let fourth = inner.numberHost.supplyD();
-        
-        return third - fourth;
-    }
-}

package/test-target-objects/PropertiesTarget.js

@@ -1,98 +0,0 @@
-/**/
-
-/* Rarely or never directly addressed elsewhere. */
-export class PropertyBase {
-    // region Static members
-
-    static staticBaseValueProp = 5;
-
-    // region .staticBaseAccessorProp
-
-    static #staticAccessedField = "6th";
-
-    static get staticBaseAccessorProp() {
-        return PropertyBase.#staticAccessedField;
-    }
-
-    static set staticBaseAccessorProp(value) {
-        PropertyBase.#staticAccessedField = value;
-    }
-
-    // endregion .staticBaseAccessorProp
-
-    static staticBaseMethod() {
-        return "base static";
-    }
-
-    // endregion Static members
-
-    // region Instance members
-
-    instanceBaseValueProp = 7;
-
-    // region .instanceBaseAccessorProp
-
-    #instanceAccessedProp = "8th";
-
-    get instanceBaseAccessorProp() {
-        return this.#instanceAccessedProp;
-    }
-
-    set instanceBaseAccessorProp(value) {
-        this.#instanceAccessedProp = value;
-    }
-
-    // endregion .instanceBaseAccessorProp
-
-    instanceBaseMethod() {
-        return "base instance";
-    }
-
-    // endregion Instance members
-}
-
-export default class PropertiesTarget extends PropertyBase {
-    // region Static members
-
-    static staticValueProp = 3;
-
-    // region .staticAccessorProp
-
-    static #staticAccessorValue = "4th";
-    
-    static get staticAccessorProp() {
-        return this.#staticAccessorValue;
-    }
-    
-    static set staticAccessorProp(value) {
-        this.#staticAccessorValue = value;
-    }
-
-    // endregion .staticAccessorProp
-
-    static staticMethod() {
-        return "static";
-    }
-
-    // endregion Static members
-
-    // region Instance members
-
-    valueProp = 1;
-
-    #accessorValue = "2nd";
-    
-    get accessorProp() {
-        return this.#accessorValue;
-    }
-
-    set accessorProp(value) {
-        this.#accessorValue = value;
-    }
-    
-    instanceMethod() {
-        return "instance";
-    }
-
-    // endregion Instance members
-}

package/test-target-objects/Returner.js

@@ -1,7 +0,0 @@
-/**/
-
-export default class Returner {
-    returnArg(arg) {
-        return arg;
-    }
-}

package/test-target-objects/Searcher.js

@@ -1,25 +0,0 @@
-/**/
-
-export default class Searcher {
-    constructor() {
-        /* No operations.*/
-    }
-
-    findLinear(sought, subject) /* passed */ {
-        // Fail path.  All edge cases return false.
-        if (subject === undefined) {
-            return false;
-        }
-
-        // Main path.
-        for (let item of subject) {
-            if (item === sought) {
-                return true;
-            }
-        }
-
-        // Never found.
-        return false;
-    }
-
-}

package/test-target-objects/Sorter.js

@@ -1,91 +0,0 @@
-/**/
-
-export default class Sorter {
-    constructor() {
-        /* No operations. */
-    }
-
-    countSort(subject) /* passed */ {
-        // To store indices for sorting to.
-        let sites = subject
-            .map(x => 0);
-
-        // Finding positions.
-        for (let at = 0; at < subject.length; at++) {
-            for (let on = 0; on < subject.length; on++) {
-                if (subject[on] < subject[at]) {
-                    sites[at]++;
-                }
-            }
-        }
-
-        // To retain reordered items.
-        let output = sites
-            .map(x => 0);
-
-        // Placing into output positions.
-        for (let at = 0; at < sites.length; at++) {
-            let to = sites[at];
-            output[to] = subject[at];
-        }
-
-        // Back to caller.
-        return output;
-    }
-
-    mergeSort(subject) /* passed */ {
-        return this.#mergeRecursor(subject);
-    }
-    
-    // region Private dependencies of mergeSort()
-
-    #mergeRecursor(subject, level) /* verified */ {
-        // Can't split for further merging.
-        if (subject.length === 1) {
-            return subject;
-        }
-
-        // Splitting for recursing at next level.
-        let { left, right } = this.#splitInHalf(subject);
-
-        // Actual recursion, calling next level directly.
-        let lefts = this.#mergeRecursor(left);
-        let rights = this.#mergeRecursor(right);
-
-        // Actually merging, then back to caller.
-        let merged = this.#merge(lefts, rights);
-        return merged;
-    }
-
-    #splitInHalf(subject) /* verified */ {
-        // These slicing args ensure no lost items.
-        let left = subject.slice(0, subject.length / 2);
-        let right = subject.slice(left.length, subject.length);
-
-        return { left, right };
-    }
-
-    #merge(lefts, rights) /* verified */ {
-        // To hold output.
-        let merged = [];
-
-        // While both sides have items, pop the lowest 
-        // of the two at the top to the output.
-        while (lefts.length > 0 && rights.length > 0) {
-            let side = lefts[0] < rights[0] ? lefts : rights;
-            let next = side.shift();
-
-            merged.push(next);
-        }
-
-        // When one side is done, pop the rest of the other.
-        let surplus = lefts.length > rights.length ? lefts : rights;
-        merged.push(...surplus);
-
-        // Back to caller.
-        return merged;
-    }
-
-    // endregion Private dependencies of mergeSort()
-
-}

package/test-target-objects/Spoofable.js

@@ -1,36 +0,0 @@
-/**/
-
-export default class Spoofable {
-    #member;
-
-    constructor(member) {
-        /* Optional member to test spoofing with SOF. */
-        if (member) {
-            this.#member = member;
-        }
-    }
-    
-    /* Member to test spoofing with SCF. */
-    spoofNumber(a, b) { return a + b; }
-    
-    /* Member to test spoofing with SCF. 
-     * Enables testing of spoofNumber() spoofing that 
-     * returns no value (the spoofed method is empty). */
-    callSpoofNumber(a, b) {
-        let result = this.spoofNumber(a, b);
-        
-        if (result === undefined) {
-            return "spoofNumber() internal call: no return value";
-        }
-        
-        return result;
-    }
-
-    /* Member to test spoofing with SCF. */
-    spoofText(t, u) { return `Texts "${ t }" and "${ u }".`; }
-    
-    /* Member to test spoofing with SOF. */
-    callMemberMethod() {
-        return member.something();
-    }
-}