@bhbr/better-things 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# Description
+
+This package defines a generic class BetterObject that allows for safer subclassing. In particular:
+
+- it provides a simple method `defaults` for setting default values of all properties at object creation,
+
+- and a method `mutabilities` that defined permissions for changing the properties' values and defaults on or after object creation or when subclassing.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/BetterObject.d.ts

@@ -0,0 +1,36 @@
+export declare class BetterObject {
+    private static classDeclarations;
+    properties: Array<string>;
+    private indirectlyWritableProperties;
+    mutabilities(): object;
+    defaults(): object;
+    constructor(args?: object);
+    private registerOwnClassDeclaration;
+    private static initializeClassDeclarations;
+    private prototypes;
+    ancestry(): Array<string>;
+    isInstanceOf(cls: string): boolean;
+    private checkConstructorArgs;
+    private setProperties;
+    private accessorArgs;
+    private nonAccessorArgs;
+    private setProperty;
+    private setExistingProperty;
+    createProperty(prop: string, value: any): void;
+    removeProperty(prop: string): void;
+    isAccessor(prop: string): boolean;
+    private propertyDescriptors;
+    propertyDescriptor(prop: string): PropertyDescriptor | undefined;
+    private getAccessor;
+    mutability(prop: string): string;
+    isWritable(prop: string): boolean;
+    synchronizeUpdateArguments(args: object): object;
+    private checkUpdateArgs;
+    update(args?: object): void;
+    private removeUnchangedProperties;
+    fullDefaults(): object;
+    fullMutabilities(): object;
+    copyFrom(obj: BetterObject): void;
+    static clearClassDeclarations(): void;
+}
+//# sourceMappingURL=BetterObject.d.ts.map

package/dist/BetterObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetterObject.d.ts","sourceRoot":"","sources":["../src/BetterObject.ts"],"names":[],"mappings":"AAOA,qBAAa,YAAY;IA6BxB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAQ;IACxC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,CAAC,4BAA4B,CAAQ;IAG5C,YAAY,IAAI,MAAM;IACtB,QAAQ,IAAI,MAAM;gBAKN,IAAI,GAAE,MAAW;IAqC7B,OAAO,CAAC,2BAA2B;IA6BnC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAc1C,OAAO,CAAC,UAAU;IAYlB,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;IAIzB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIlC,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,mBAAmB;IAa3B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAwBvC,cAAc,CAAC,IAAI,EAAE,MAAM;IAK3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUjC,OAAO,CAAC,mBAAmB;IAU3B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAKhE,OAAO,CAAC,WAAW;IAKnB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,UAAU,CAAC,IAAI,EAAE,MAAM;IAIvB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQhD,OAAO,CAAC,eAAe;IASvB,MAAM,CAAC,IAAI,GAAE,MAAW;IAUxB,OAAO,CAAC,yBAAyB;IAsBjC,YAAY,IAAI,MAAM;IAItB,gBAAgB,IAAI,MAAM;IAI1B,QAAQ,CAAC,GAAG,EAAE,YAAY;IAQ1B,MAAM,CAAC,sBAAsB;CAK7B"}

package/dist/BetterObject.js

@@ -0,0 +1,295 @@
+import { equal } from '@bhbr/egalite';
+import { isInstanceOf, ancestry } from '@bhbr/upper-class';
+import { remove } from '@bhbr/betray';
+import { ClassDeclaration } from './ClassDeclaration.js';
+import { AssignmentError } from './Errors.js';
+export class BetterObject {
+    // These properties need to be treated separately so we can modify them without declaring a public writable property. They are hidden inside this private dictionary, and modified by calling the update method, which internally accesses this dictionary.
+    mutabilities() { return {}; }
+    defaults() { return {}; }
+    // Empty base implementations that ground the recursive buildup of the fullMutabilities and fullDefaults
+    constructor(args = {}) {
+        // Create the static classDeclarations object if it hasn't been done yet
+        if (BetterObject.classDeclarations === undefined) {
+            BetterObject.initializeClassDeclarations();
+        }
+        // If this is the first instance of a subclass, register the class declaration
+        if (BetterObject.classDeclarations[this.constructor.name] === undefined) {
+            // This requires all ancestor classes to be registered already, so loop over their prototypes
+            let protos = this.prototypes();
+            for (let obj of protos) {
+                if (BetterObject.classDeclarations[obj.constructor.name] !== undefined) {
+                    continue;
+                }
+                obj.registerOwnClassDeclaration();
+            }
+        }
+        // Initialize the list of properties
+        Object.defineProperty(this, 'properties', {
+            value: [],
+            writable: false,
+            enumerable: true
+        });
+        Object.defineProperty(this, 'indirectlyWritableProperties', {
+            value: {},
+            writable: false,
+            enumerable: true
+        });
+        // Are the initialization values valid?
+        this.checkConstructorArgs(args);
+        // If yes, complement them with the default values and set them
+        let initialArgs = this.fullDefaults();
+        Object.assign(initialArgs, args);
+        initialArgs = this.synchronizeUpdateArguments(initialArgs);
+        this.setProperties(initialArgs);
+    }
+    registerOwnClassDeclaration() {
+        let parentClass = Object.getPrototypeOf(this);
+        // Get the mutabilities
+        var mutabilities = this.mutabilities();
+        // If the class does not subclass the mutabilities() method, this would just call super method. In that case set the mutabilities to an empty object to express that nothing has changed in the subclass.
+        let parentMutabilities = parentClass.mutabilities();
+        if (equal(parentMutabilities, mutabilities)) {
+            mutabilities = {};
+        }
+        // Get the defaults function/method
+        // In order to decide whether this one has been overridden, evaluate both the method and the super method and compare the generated defaults objects. If they are the same, retain a function that creates an empty object.
+        let defaultsObject = this.defaults();
+        let parentDefaultsObject = parentClass.defaults();
+        let flag = equal(parentDefaultsObject, defaultsObject);
+        let defaultsFunction = flag ? function () { return {}; } : this.defaults;
+        // Create the class declaration from the class name, parent class declaration, mutabilities object and defaults function
+        let classDeclarationName = this.constructor.name;
+        let parentClassName = parentClass.constructor.name;
+        let parentClassDeclaration = BetterObject.classDeclarations[parentClassName];
+        BetterObject.classDeclarations[classDeclarationName] = new ClassDeclaration({
+            name: classDeclarationName,
+            parent: parentClassDeclaration,
+            mutabilities: mutabilities,
+            defaults: defaultsFunction
+        });
+    }
+    static initializeClassDeclarations() {
+        BetterObject.classDeclarations = {
+            // The first entry is for the base class
+            BetterObject: new ClassDeclaration({
+                name: 'BetterObject',
+                parent: null,
+                mutabilities: {},
+                defaults: function () { return {}; }
+            })
+        };
+    }
+    // TODO: map the following three methods to the functions imported from upper-class
+    prototypes() {
+        // A list of the class's prototype object, from BetterObject to the class itself
+        let ret = [];
+        var obj = Object.getPrototypeOf(this);
+        while (obj != null) {
+            ret.push(obj);
+            obj = Object.getPrototypeOf(obj);
+        }
+        ret.pop(); // superfluous entry of type Object
+        return ret.reverse();
+    }
+    ancestry() {
+        return ancestry(this);
+    }
+    isInstanceOf(cls) {
+        return isInstanceOf(this, cls);
+    }
+    checkConstructorArgs(args) {
+        // Only properties with mutability 'always', 'on_update' or 'on_init' can be set in the constructor call
+        for (let [prop, value] of Object.entries(args)) {
+            if (this.mutability(prop) === 'never' || this.mutability(prop) === 'in_subclass') {
+                throw new AssignmentError(`Property ${prop} in class ${this.constructor.name} cannot be assigned new value ${value} in constructor`);
+            }
+        }
+    }
+    setProperties(args = {}) {
+        // Accessors (abstract properties that are just setters, e. g. a Circle's midpoint) are set only after all non-accessors have been set. So we split the args along that separation.
+        // Set the non-accessors (properties that have their own state)
+        let nonAccessorArgs = this.nonAccessorArgs(args);
+        for (let [prop, value] of Object.entries(nonAccessorArgs)) {
+            this.setProperty(prop, value);
+        }
+        // Set the accessors (abstract properties)
+        let accessorArgs = this.accessorArgs(args);
+        for (let [prop, value] of Object.entries(accessorArgs)) {
+            this.setProperty(prop, value);
+        }
+    }
+    accessorArgs(args) {
+        let accessorArgs = {};
+        for (let [prop, value] of Object.entries(args)) {
+            if (this.isAccessor(prop)) {
+                accessorArgs[prop] = value;
+            }
+        }
+        return accessorArgs;
+    }
+    nonAccessorArgs(args) {
+        let nonAccessorArgs = {};
+        for (let [prop, value] of Object.entries(args)) {
+            if (!this.isAccessor(prop)) {
+                nonAccessorArgs[prop] = value;
+            }
+        }
+        return nonAccessorArgs;
+    }
+    setProperty(prop, value) {
+        if (!this.properties.includes(prop) && !this.isAccessor(prop)) {
+            this.createProperty(prop, value);
+        }
+        else {
+            this.setExistingProperty(prop, value);
+        }
+    }
+    setExistingProperty(prop, value) {
+        if (this.isAccessor(prop)) {
+            let accessor = this.getAccessor(prop);
+            accessor.call(this, value);
+            return;
+        }
+        if (this.isWritable(prop)) {
+            this[prop] = value;
+        }
+        else {
+            this.indirectlyWritableProperties[prop] = value;
+        }
+    }
+    createProperty(prop, value) {
+        // i. e. a property that can only the changed via the update() method
+        let isSettable = (this.mutability(prop) == 'always');
+        if (isSettable) {
+            Object.defineProperty(this, prop, {
+                value: value,
+                writable: true,
+                enumerable: true
+            });
+        }
+        else {
+            this.indirectlyWritableProperties[prop] = value;
+            Object.defineProperty(this, prop, {
+                get() {
+                    return this.indirectlyWritableProperties[prop];
+                },
+                set(newValue) {
+                    throw new AssignmentError(`Use the update method to change the value of property ${prop} in class ${this.constructor.name}`);
+                },
+                enumerable: true
+            });
+        }
+        this.properties.push(prop);
+    }
+    removeProperty(prop) {
+        this[prop] = undefined;
+        remove(this.properties, prop);
+    }
+    isAccessor(prop) {
+        if (Object.keys(this.indirectlyWritableProperties).includes(prop)) {
+            return false;
+        }
+        let pd = this.propertyDescriptor(prop);
+        if (pd === undefined) {
+            return false;
+        }
+        if (!pd.enumerable) {
+            return true;
+        }
+        let s = pd['set'];
+        let flag = (s !== undefined);
+        return flag;
+    }
+    propertyDescriptors() {
+        let pds = {};
+        var obj = this;
+        while (obj) {
+            pds = Object.assign(pds, Object.getOwnPropertyDescriptors(obj));
+            obj = Object.getPrototypeOf(obj);
+        }
+        return pds;
+    }
+    propertyDescriptor(prop) {
+        let pds = this.propertyDescriptors();
+        return pds[prop];
+    }
+    getAccessor(prop) {
+        let pd = this.propertyDescriptor(prop);
+        return (pd === undefined || pd.enumerable) ? undefined : pd.set;
+    }
+    mutability(prop) {
+        return BetterObject.classDeclarations[this.constructor.name].mutability(prop);
+    }
+    isWritable(prop) {
+        return (this.mutability(prop) === 'always');
+    }
+    synchronizeUpdateArguments(args) {
+        /*
+        Override this method to resolve possible conflicts in update arguments.
+        Example: Should Circle({ midpoint: ..., anchor: ... }) silently fit the radius or raise an error?
+        */
+        return args;
+    }
+    checkUpdateArgs(args) {
+        // Check whether any properites are not updatable
+        for (let [prop, value] of Object.entries(args)) {
+            if (this.mutability(prop) !== 'always' && this.mutability(prop) !== 'on_update') {
+                throw new AssignmentError(`Property ${prop} in class ${this.constructor.name} is not updatable, cannot be assigned new value ${value} after initialization`);
+            }
+        }
+    }
+    update(args = {}) {
+        /*
+        Override this method in subclasses. It MUST at some point call super.update(args).
+        */
+        this.checkUpdateArgs(args);
+        args = this.synchronizeUpdateArguments(args);
+        args = this.removeUnchangedProperties(args); // for performance
+        this.setProperties(args);
+    }
+    removeUnchangedProperties(args) {
+        for (let [prop, value] of Object.entries(args)) {
+            if (this[prop] === undefined) {
+                continue;
+            }
+            if (typeof value != 'object' || value === null) {
+                if (this[prop] === value) {
+                    delete args[prop];
+                }
+            }
+            else if (value.constructor.name == 'Transform') {
+                if (this[prop].equals(value)) {
+                    delete args[prop];
+                }
+            }
+            else if (equal(this[prop], value)) {
+                delete args[prop];
+            }
+            else { // any other kind of object
+                if (this[prop] == value) {
+                    delete args[prop];
+                }
+            }
+        }
+        return args;
+    }
+    fullDefaults() {
+        return BetterObject.classDeclarations[this.constructor.name].fullDefaults();
+    }
+    fullMutabilities() {
+        return BetterObject.classDeclarations[this.constructor.name].fullMutabilities;
+    }
+    copyFrom(obj) {
+        let argsDict = {};
+        for (let prop of obj.properties) {
+            argsDict[prop] = obj[prop];
+        }
+        this.update(argsDict);
+    }
+    static clearClassDeclarations() {
+        // for testing
+        BetterObject.classDeclarations = undefined;
+    }
+}
+//# sourceMappingURL=BetterObject.js.map

package/dist/BetterObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetterObject.js","sourceRoot":"","sources":["../src/BetterObject.ts"],"names":[],"mappings":"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"}

package/dist/ClassDeclaration.d.ts

@@ -0,0 +1,18 @@
+export declare class ClassDeclaration {
+    name: string;
+    parent: ClassDeclaration | null;
+    mutabilities: object;
+    defaults: () => object;
+    fullMutabilities: object;
+    fullDefaults: object;
+    private static mutabilityOrder;
+    private static compatibleMutabilities;
+    constructor(args: object);
+    mutability(prop: string): string;
+    private initializeFullMutabilities;
+    private initializeFullDefaults;
+    checkMutabilities(): void;
+    checkDefaults(): void;
+    ancestry(): Array<string>;
+}
+//# sourceMappingURL=ClassDeclaration.d.ts.map

package/dist/ClassDeclaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDeclaration.d.ts","sourceRoot":"","sources":["../src/ClassDeclaration.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAgB;IAI5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,MAAM,CAAA;IAEtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IAMpB,OAAO,CAAC,MAAM,CAAC,eAAe,CAE7B;IACD,OAAO,CAAC,MAAM,CAAC,sBAAsB;gBAKzB,IAAI,EAAE,MAAM;IAUxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKhC,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,sBAAsB;IAS9B,iBAAiB;IAUjB,aAAa;IAUb,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;CAYzB"}

package/dist/ClassDeclaration.js

@@ -0,0 +1,75 @@
+import { MutabilityError, AssignmentError } from './Errors.js';
+export class ClassDeclaration {
+    static compatibleMutabilities(oldMut, newMut) {
+        // Is the dictionary of newMutabilities a valid extension of the oldMutabilities? It is only valid if mutabilities of existing properties get restricted, they can never be expanded again.
+        return (ClassDeclaration.mutabilityOrder[oldMut] <= ClassDeclaration.mutabilityOrder[newMut]);
+    }
+    constructor(args) {
+        this.name = args['name'];
+        this.parent = args['parent'];
+        this.mutabilities = Object.assign({}, args['mutabilities']); // a fresh copy (so it can be altered without propagating back into the parent classes)
+        this.defaults = args['defaults']; // a *function* object that will create a fresh default object for each new object instance (including e. g. new DOM elements)
+        this.initializeFullMutabilities(); // collect and merge the mutabilities objects of all ancestor classes
+        this.initializeFullDefaults(); // collect and merge the defaults objects (return values of the defaults functions) of all parent classes
+    }
+    mutability(prop) {
+        // If the class doesn't specify a mutability, look into the ancestor classes. If they don't either, the default mutability is 'always'.
+        return this.mutabilities[prop] ?? this.fullMutabilities[prop] ?? 'always';
+    }
+    initializeFullMutabilities() {
+        // Collect and merge the mutabilities objects of all ancestor classes into a single object
+        this.fullMutabilities = {};
+        // Collect the entire mutabilities from all ancestor classes
+        if (this.parent) {
+            Object.assign(this.fullMutabilities, this.parent.fullMutabilities);
+        }
+        // Check whether the own mutabilities are compatible with them, then update
+        this.checkMutabilities();
+        Object.assign(this.fullMutabilities, this.mutabilities);
+    }
+    initializeFullDefaults() {
+        // Collect and merge the defaults of all ancestor classes, as a function
+        this.checkDefaults();
+        this.fullDefaults = function () {
+            let parentDefaults = this.parent ? this.parent.fullDefaults() : {};
+            return Object.assign(parentDefaults, this.defaults());
+        }.bind(this);
+    }
+    checkMutabilities() {
+        // Are the mutabilities specified in the class's mutabilities() method compatible with the ones inherited from the parent class?
+        for (let [prop, newMut] of Object.entries(this.mutabilities)) {
+            let oldMut = this.parent ? this.parent.mutability(prop) : 'always';
+            if (!ClassDeclaration.compatibleMutabilities(oldMut, newMut)) {
+                throw new MutabilityError(`Mutability of property ${prop} in class ${this.name} cannot be changed from ${oldMut} to ${newMut}`);
+            }
+        }
+    }
+    checkDefaults() {
+        // Are the default values specified in the class's defaults() method compatible with the mutabilities inherited from the parent class?
+        for (let [prop, value] of Object.entries(this.defaults())) {
+            let oldMut = this.parent ? this.parent.mutability(prop) : 'always';
+            if (oldMut === 'never') {
+                throw new AssignmentError(`Property ${prop} in class ${this.name} is immutable, cannot be assigned new default value ${value}`);
+            }
+        }
+    }
+    ancestry() {
+        // For debugging, a list of the names of the parent classes:
+        // ['BetterObject', ..., <this.parent.name>, <this.name>]
+        let ret = [];
+        var dec = this;
+        while (dec != null) {
+            ret.push(dec.name);
+            dec = dec.parent;
+        }
+        return ret.reverse();
+    }
+}
+/*
+Comparing mutabilities: from laxest ('always') to strictest ('never'). A subclass can change a property's mutability only to a stricter level.
+See BetterObject for a description of the mutability levels.
+*/
+ClassDeclaration.mutabilityOrder = {
+    'always': 0, 'on_update': 1, 'on_init': 2, 'in_subclass': 3, 'never': 4
+};
+//# sourceMappingURL=ClassDeclaration.js.map

package/dist/ClassDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassDeclaration.js","sourceRoot":"","sources":["../src/ClassDeclaration.ts"],"names":[],"mappings":"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"}

package/dist/Errors.d.ts

@@ -0,0 +1,7 @@
+export declare class MutabilityError extends Error {
+    name: string;
+}
+export declare class AssignmentError extends Error {
+    name: string;
+}
+//# sourceMappingURL=Errors.d.ts.map

package/dist/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../src/Errors.ts"],"names":[],"mappings":"AACA,qBAAa,eAAgB,SAAQ,KAAK;IACzC,IAAI,SAAoB;CACxB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACzC,IAAI,SAAoB;CACxB"}

package/dist/Errors.js

@@ -0,0 +1,13 @@
+export class MutabilityError extends Error {
+    constructor() {
+        super(...arguments);
+        this.name = 'MutabilityError';
+    }
+}
+export class AssignmentError extends Error {
+    constructor() {
+        super(...arguments);
+        this.name = 'AssignmentError';
+    }
+}
+//# sourceMappingURL=Errors.js.map

package/dist/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../src/Errors.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAA1C;;QACC,SAAI,GAAG,iBAAiB,CAAA;IACzB,CAAC;CAAA;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAA1C;;QACC,SAAI,GAAG,iBAAiB,CAAA;IACzB,CAAC;CAAA"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@bhbr/better-things",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "A generic class BetterObject for safer subclassing",
+  "type": "module",
+  "main": "./dist/better-things.js",
+  "types": "./dist/better-things.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/better-things.d.ts",
+      "import": "./dist/better-things.js"
+    }
+  },
+  "files": [
+    "dist/*.js",
+    "dist/*.d.ts",
+    "dist/*.js.map",
+    "dist/*.d.ts.map"
+  ],
+  "scripts": {
+    "build": "cd build && ./build.sh",
+    "test": "node dist/_tests/better-things_tests.js",
+    "prepack": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bhbr/better-things"
+  },
+  "bugs": {
+    "url": "https://github.com/bhbr/better-things/issues"
+  },
+  "homepage": "https://github.com/bhbr/better-things#readme",
+  "keywords": [],
+  "author": "Ben Hambrecht",
+  "license": "ISC",
+  "devDependencies": {
+    "@bhbr/tsts": "^1.1.3"
+  },
+  "dependencies": {
+    "@bhbr/betray": "^1.0.0",
+    "@bhbr/egalite": "^1.1.4"
+  }
+}