@flashist/appframework 0.0.224 → 0.0.226

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flashist/appframework",
-  "version": "0.0.224",
+  "version": "0.0.226",
   "scripts": {
     "build": "gulp",
     "publish:patch": "npm version patch && npm run build && cd ./dist && npm publish",

package/pages/views/PagesView.js

@@ -21,7 +21,7 @@ export class PagesView extends AppResizableContainer {
         //     let tempPageClass = pagesModuleState.pageIdToViewClassMap[singlePageId];
         //     this.viewStack.addViewClass(tempPageClass, singlePageId);
         // }
-        const appState = appStorage().getState();
+        const appState = appStorage().getMutableState();
         let pageIds = Object.keys(appState.pages.pageIdToViewClassMap);
         for (let singlePageId of pageIds) {
             let tempPageClass = appState.pages.pageIdToViewClassMap[singlePageId];

package/pages/views/PagesView.js.map

@@ -1 +1 @@
-{"version":3,"file":"PagesView.js","sourceRoot":"","sources":["../../../src/pages/views/PagesView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,mCAAmC,EAAE,MAAM,mEAAmE,CAAC;AACxH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAIxD,MAAM,OAAO,SAAU,SAAQ,qBAAqB;IAMtC,YAAY,CAAC,GAAG,IAAI;QAC1B,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEzB,6CAA6C;QAE7C,IAAI,CAAC,SAAS,GAAG,IAAI,mCAAmC,EAAgB,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9B,wEAAwE;QACxE,6DAA6D;QAC7D,6CAA6C;QAC7C,iFAAiF;QACjF,4EAA4E;QAC5E,qDAAqD;QAErD,8DAA8D;QAC9D,IAAI;QAEJ,oHAAoH;QACpH,8EAA8E;QAC9E,sCAAsC;QACtC,+EAA+E;QAC/E,gEAAgE;QAChE,IAAI;QAEJ,MAAM,QAAQ,GAAqB,UAAU,EAAE,CAAC,QAAQ,EAAoB,CAAC;QAC7E,IAAI,OAAO,GAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACzE,KAAK,IAAI,YAAY,IAAI,OAAO,EAAE;YAC9B,IAAI,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACtE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;SAC5D;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAES,YAAY;QAClB,KAAK,CAAC,YAAY,EAAE,CAAC;QAErB,6CAA6C;QAC7C,uBAAuB;QACvB,sCAAsC;QACtC,0BAA0B;QAC1B,KAAK;QACL,gDAAgD;QAChD,cAAc;QAEd,QAAQ;QACR,IAAI;IACR,CAAC;IAED,qCAAqC;IACrC,8BAA8B;IAC9B,IAAI;IAEG,eAAe;QAClB,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,QAAQ,EAAoB,CAAC,KAAK,CAAC,MAAM,CAAC;QAEnF,IAAI,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAES,OAAO;QACb,KAAK,CAAC,OAAO,EAAE,CAAC;QAEhB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE;YAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,EAAE;gBAC1C,UAAU,EAAE,CAAC,MAAM,EAAoB,CACnC,8BAA8B,EAC9B;oBACI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;oBAC7C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;iBAChD,CACJ,CAAC;aACL;SACJ;IACL,CAAC;CACJ"}
+{"version":3,"file":"PagesView.js","sourceRoot":"","sources":["../../../src/pages/views/PagesView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,mCAAmC,EAAE,MAAM,mEAAmE,CAAC;AACxH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAIxD,MAAM,OAAO,SAAU,SAAQ,qBAAqB;IAMtC,YAAY,CAAC,GAAG,IAAI;QAC1B,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEzB,6CAA6C;QAE7C,IAAI,CAAC,SAAS,GAAG,IAAI,mCAAmC,EAAgB,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9B,wEAAwE;QACxE,6DAA6D;QAC7D,6CAA6C;QAC7C,iFAAiF;QACjF,4EAA4E;QAC5E,qDAAqD;QAErD,8DAA8D;QAC9D,IAAI;QAEJ,oHAAoH;QACpH,8EAA8E;QAC9E,sCAAsC;QACtC,+EAA+E;QAC/E,gEAAgE;QAChE,IAAI;QAEJ,MAAM,QAAQ,GAAqB,UAAU,EAAE,CAAC,eAAe,EAAoB,CAAC;QACpF,IAAI,OAAO,GAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACzE,KAAK,IAAI,YAAY,IAAI,OAAO,EAAE;YAC9B,IAAI,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACtE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;SAC5D;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAES,YAAY;QAClB,KAAK,CAAC,YAAY,EAAE,CAAC;QAErB,6CAA6C;QAC7C,uBAAuB;QACvB,sCAAsC;QACtC,0BAA0B;QAC1B,KAAK;QACL,gDAAgD;QAChD,cAAc;QAEd,QAAQ;QACR,IAAI;IACR,CAAC;IAED,qCAAqC;IACrC,8BAA8B;IAC9B,IAAI;IAEG,eAAe;QAClB,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,QAAQ,EAAoB,CAAC,KAAK,CAAC,MAAM,CAAC;QAEnF,IAAI,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAES,OAAO;QACb,KAAK,CAAC,OAAO,EAAE,CAAC;QAEhB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE;YAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,EAAE;gBAC1C,UAAU,EAAE,CAAC,MAAM,EAAoB,CACnC,8BAA8B,EAC9B;oBACI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;oBAC7C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;iBAChD,CACJ,CAAC;aACL;SACJ;IACL,CAAC;CACJ"}

package/state/data/AppStateStorage.d.ts

@@ -27,7 +27,7 @@ export declare class AppStateStorage extends BaseObjectWithGlobalDispatcher {
 
      * @returns
      */
-    changePropertyWrapper<StateType extends object>(): <WrapperStateType extends Partial<Flatten<StateType, never>[DeepKeyType]>, DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType) => <WrapperDeepKeyType extends keyof Flatten<WrapperStateType, never>>(wrapperKey: WrapperDeepKeyType, value: DeepPartial<Flatten<WrapperStateType, never>[WrapperDeepKeyType]>) => void;
+    changePropertyWrapper<StateType extends object>(): <WrapperStateType extends Partial<Flatten<StateType, never>[DeepKeyType]>, DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType) => <WrapperDeepKeyType extends keyof Flatten<WrapperStateType, never>>(wrapperKey: WrapperDeepKeyType, value: DeepPartial<Flatten<WrapperStateType, never>[WrapperDeepKeyType], {}>) => void;
     protected isInitialized: boolean;
     protected state: object;
     protected pathsHelperDataCache: {
@@ -44,9 +44,9 @@ export declare class AppStateStorage extends BaseObjectWithGlobalDispatcher {
     getValue<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType) => Partial<Flatten<StateType, never>[DeepKeyType]>;
     protected innerGetValue<StateType, DeepKeyType extends keyof Flatten<StateType>, ValueType extends Flatten<StateType>[DeepKeyType]>(stateForTypings: StateType, deepKey: DeepKeyType): Partial<ValueType>;
     protected processStateAction<StateType, DeepKeyType extends keyof Flatten<StateType>, ValueType extends Flatten<StateType>[DeepKeyType]>(stateForTypings: StateType, deepKey: DeepKeyType, config: IAppStateChangeConfigVO<ValueType>): any;
-    substitute<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType, value: DeepPartial<Flatten<StateType, never>[DeepKeyType]>) => void;
+    substitute<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType, value: DeepPartial<Flatten<StateType, never>[DeepKeyType], {}>) => void;
     protected innerSubstitute<StateType, DeepKeyType extends keyof Flatten<StateType>, ValueType extends Flatten<StateType>[DeepKeyType]>(stateForTypings: StateType, deepKey: DeepKeyType, value: DeepPartial<ValueType>): void;
-    change<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType, value: DeepPartial<Flatten<StateType, never>[DeepKeyType]>) => void;
+    change<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>>(key: DeepKeyType, value: DeepPartial<Flatten<StateType, never>[DeepKeyType], {}>) => void;
     protected innerChange<StateType, DeepKeyType extends keyof Flatten<StateType>, ValueType extends Flatten<StateType>[DeepKeyType]>(stateForTypings: StateType, deepKey: DeepKeyType, value: DeepPartial<ValueType>): void;
     delete<StateType extends object>(): <DeepKeyType extends keyof Flatten<StateType, never>, ValueType extends Flatten<StateType, never>[DeepKeyType] & any[] = Flatten<StateType, never>[DeepKeyType] & any[]>(key: DeepKeyType) => Flatten<StateType, never>[DeepKeyType];
     protected innerDelete<StateType, DeepKeyType extends keyof Flatten<StateType>, ValueType extends Flatten<StateType>[DeepKeyType]>(stateForTypings: StateType, deepKey: DeepKeyType): ValueType;

package/state/data/DeepPartialTypings.d.ts

@@ -1,3 +1,83 @@
-export type DeepPartial<T> = T extends object ? {
-    [P in keyof T]?: DeepPartial<T[P]>;
-} : T;
+import { BuiltIns } from "./DeepReadableTypings";
+/**
+@see DeepPartial
+*/
+export type DeepPartialOptions = {
+    /**
+    Whether to affect the individual elements of arrays and tuples.
+
+    @default false
+    */
+    readonly recurseIntoArrays?: boolean;
+};
+/**
+Create a type from another type with all keys and nested keys set to optional.
+
+Use-cases:
+- Merging a default settings/config object with another object, the second object would be a deep partial of the default object.
+- Mocking and testing complex entities, where populating an entire object with its keys would be redundant in terms of the mock or test.
+
+@example
+```
+import type {DeepPartial} from 'type-fest';
+
+const settings: Settings = {
+    textEditor: {
+        fontSize: 14;
+        fontColor: '#000000';
+        fontWeight: 400;
+    }
+    autocomplete: false;
+    autosave: true;
+};
+
+const applySavedSettings = (savedSettings: DeepPartial<Settings>) => {
+    return {...settings, ...savedSettings};
+}
+
+settings = applySavedSettings({textEditor: {fontWeight: 500}});
+```
+
+By default, this does not affect elements in array and tuple types. You can change this by passing `{recurseIntoArrays: true}` as the second type argument:
+
+```
+import type {DeepPartial} from 'type-fest';
+
+interface Settings {
+    languages: string[];
+}
+
+const partialSettings: DeepPartial<Settings, {recurseIntoArrays: true}> = {
+    languages: [undefined]
+};
+```
+
+@category Object
+@category Array
+@category Set
+@category Map
+*/
+export type DeepPartial<T, Options extends DeepPartialOptions = {}> = T extends BuiltIns ? T : T extends Map<infer KeyType, infer ValueType> ? DeepPartialMap<KeyType, ValueType, Options> : T extends Set<infer ItemType> ? DeepPartialSet<ItemType, Options> : T extends ReadonlyMap<infer KeyType, infer ValueType> ? DeepPartialReadonlyMap<KeyType, ValueType, Options> : T extends ReadonlySet<infer ItemType> ? DeepPartialReadonlySet<ItemType, Options> : T extends ((...arguments_: any[]) => unknown) ? T | undefined : T extends object ? T extends ReadonlyArray<infer ItemType> ? Options['recurseIntoArrays'] extends true ? ItemType[] extends T ? readonly ItemType[] extends T ? ReadonlyArray<DeepPartial<ItemType | undefined, Options>> : Array<DeepPartial<ItemType | undefined, Options>> : DeepPartialObject<T, Options> : T : DeepPartialObject<T, Options> : unknown;
+/**
+Same as `DeepPartial`, but accepts only `Map`s and as inputs. Internal helper for `DeepPartial`.
+*/
+type DeepPartialMap<KeyType, ValueType, Options extends DeepPartialOptions> = {} & Map<DeepPartial<KeyType, Options>, DeepPartial<ValueType, Options>>;
+/**
+Same as `DeepPartial`, but accepts only `Set`s as inputs. Internal helper for `DeepPartial`.
+*/
+type DeepPartialSet<T, Options extends DeepPartialOptions> = {} & Set<DeepPartial<T, Options>>;
+/**
+Same as `DeepPartial`, but accepts only `ReadonlyMap`s as inputs. Internal helper for `DeepPartial`.
+*/
+type DeepPartialReadonlyMap<KeyType, ValueType, Options extends DeepPartialOptions> = {} & ReadonlyMap<DeepPartial<KeyType, Options>, DeepPartial<ValueType, Options>>;
+/**
+Same as `DeepPartial`, but accepts only `ReadonlySet`s as inputs. Internal helper for `DeepPartial`.
+*/
+type DeepPartialReadonlySet<T, Options extends DeepPartialOptions> = {} & ReadonlySet<DeepPartial<T, Options>>;
+/**
+Same as `DeepPartial`, but accepts only `object`s as inputs. Internal helper for `DeepPartial`.
+*/
+type DeepPartialObject<ObjectType extends object, Options extends DeepPartialOptions> = {
+    [KeyType in keyof ObjectType]?: DeepPartial<ObjectType[KeyType], Options>;
+};
+export {};

package/state/data/DeepReadableTypings.d.ts

@@ -1,3 +1,58 @@
-export type DeepReadonly<T> = T extends Function ? T : T extends object ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T extends never ? never : T;
+export type HasMultipleCallSignatures<T extends (...arguments_: any[]) => unknown> = T extends {
+    (...arguments_: infer A): unknown;
+    (...arguments_: any[]): unknown;
+} ? unknown[] extends A ? false : true : false;
+export type Primitive = null | undefined | string | number | boolean | symbol | bigint;
+export type BuiltIns = Primitive | Date | RegExp;
+/**
+Convert `object`s, `Map`s, `Set`s, and `Array`s and all of their keys/elements into immutable structures recursively.
+
+This is useful when a deeply nested structure needs to be exposed as completely immutable, for example, an imported JSON module or when receiving an API response that is passed around.
+
+Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/13923) if you want to have this type as a built-in in TypeScript.
+
+@example
+```
+// data.json
+{
+    "foo": ["bar"]
+}
+
+// main.ts
+import type {DeepReadonly} from 'type-fest';
+import dataJson = require('./data.json');
+
+const data: DeepReadonly<typeof dataJson> = dataJson;
+
+export default data;
+
+// test.ts
+import data from './main';
+
+data.foo.push('bar');
+//=> error TS2339: Property 'push' does not exist on type 'readonly string[]'
+```
+
+Note that types containing overloaded functions are not made deeply readonly due to a [TypeScript limitation](https://github.com/microsoft/TypeScript/issues/29732).
+
+@category Object
+@category Array
+@category Set
+@category Map
+*/
+export type DeepReadonly<T> = T extends BuiltIns ? T : T extends (...arguments_: any[]) => unknown ? {} extends DeepReadonlyObject<T> ? T : HasMultipleCallSignatures<T> extends true ? T : ((...arguments_: Parameters<T>) => ReturnType<T>) & DeepReadonlyObject<T> : T extends Readonly<ReadonlyMap<infer KeyType, infer ValueType>> ? DeepReadonlyMap<KeyType, ValueType> : T extends Readonly<ReadonlySet<infer ItemType>> ? DeepReadonlySet<ItemType> : T extends readonly [] | readonly [...never[]] ? readonly [] : T extends readonly [infer U, ...infer V] ? readonly [DeepReadonly<U>, ...DeepReadonly<V>] : T extends readonly [...infer U, infer V] ? readonly [...DeepReadonly<U>, DeepReadonly<V>] : T extends ReadonlyArray<infer ItemType> ? ReadonlyArray<DeepReadonly<ItemType>> : T extends object ? DeepReadonlyObject<T> : unknown;
+/**
+Same as `DeepReadonly`, but accepts only `ReadonlyMap`s as inputs. Internal helper for `DeepReadonly`.
+*/
+type DeepReadonlyMap<KeyType, ValueType> = {} & Readonly<ReadonlyMap<DeepReadonly<KeyType>, DeepReadonly<ValueType>>>;
+/**
+Same as `DeepReadonly`, but accepts only `ReadonlySet`s as inputs. Internal helper for `DeepReadonly`.
+*/
+type DeepReadonlySet<ItemType> = {} & Readonly<ReadonlySet<DeepReadonly<ItemType>>>;
+/**
+Same as `DeepReadonly`, but accepts only `object`s as inputs. Internal helper for `DeepReadonly`.
+*/
+type DeepReadonlyObject<ObjectType extends object> = {
+    readonly [KeyType in keyof ObjectType]: DeepReadonly<ObjectType[KeyType]>;
+};
+export {};