@webkrafters/react-observable-context 4.1.0-alpha.1 → 4.1.0-alpha.3

package/README.md

@@ -200,15 +200,16 @@ store.setState({ ...state, a: { ...state.a, b: [ { ...first, y: 30 }, 22, ...res
 ```
 
 <h3 id="setstate-tags"><b><i><u>Rewriting state using tag commands</u></i></b></h3>
-By default <code>store.setState</code> merges new changes into current state. To overwrite current state slices with new state values, <b>7</b> tag commands have been provided for:
+By default, <code>store.setState</code> recursively merges new changes into current state.<br />
+To overwrite current state slices with new values, <b>7</b> tag commands have been provided:
 <ol>
-	<li><span style="margin-left: 10px"><code>@@CLEAR:</code> setting state slice to its corresponding empty value</span></li>
-	<li><span style="margin-left: 10px"><code>@@DELETE:</code> deleting properties</span></li>
-	<li><span style="margin-left: 10px"><code>@@MOVE:</code> moving array elements</span></li>
-	<li><span style="margin-left: 10px"><code>@@PUSH:</code> pushing new items into an array</span></li>
-	<li><span style="margin-left: 10px"><code>@@REPLACE:</code> replacing property values</span></li>
-	<li><span style="margin-left: 10px"><code>@@SET:</code> setting property values</span></li>
-	<li><span style="margin-left: 10px"><code>@@SPLICE:</code> splicing array items</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@CLEAR:</i></b> sets state slice to its corresponding empty value</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@DELETE:</i></b> removes plain object properties and array items</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@MOVE:</i></b> moves array elements</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@PUSH:</i></b> pushes new items into an array</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@REPLACE:</i></b> replaces property values</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@SET:</i></b> sets property values</span></li>
+	<li><span style="margin-left: 10px"><b style="margin-right: 6px"><i>@@SPLICE:</i></b> splices array items</span></li>
 </ol>
 <b>Examples:</b><br /><br />
 

package/dist/main/hooks/use-state-manager/index.d.ts

@@ -3,7 +3,7 @@ export type Listener<T extends import("../../../types").State> = import("../../.
 export type State = import("../../../types").State;
 export type StoreInternal<T extends import("../../../types").State> = import("../../../types").StoreInternal<T>;
 declare function useStateManager<T extends import("../../../types").State>(initStateValue: T): {
-    select: (clientId: string, ...propertyPaths?: string[]) => {
+    select: (clientId: string, ...propertyPaths?: import("../../../types").PropertyPathTokens) => {
         [propertyPaths: string]: Readonly<any>;
     };
     state: T;

package/dist/main/hooks/use-store/index.d.ts

@@ -12,10 +12,10 @@ export type State = import("../../../types").State;
 export type MutableRefObject<T> = import('react').MutableRefObject<T>;
 import _setState from "../../set-state";
 declare function useStore<T extends import("../../../types").State>(prehooks: Prehooks<T>, value: T, storage?: IStorage<T>): {
-    getState: (clientId: string, ...propertyPaths?: string[]) => {
+    getState: (clientId: string, ...propertyPaths?: import("../../../types").PropertyPathTokens) => {
         [propertyPaths: string]: Readonly<any>;
     };
-    resetState: (propertyPaths?: string[]) => void;
+    resetState: (propertyPaths?: any[]) => void;
     setState: (changes: import("../../../types").UpdatePayload<import("../../../types").PartialState<T>>) => void;
     subscribe: (listener: import("../../../types").Listener<T>) => VoidFunction;
     unlinkCache: (clientId: string) => void;

package/dist/main/index.d.ts

@@ -70,7 +70,7 @@ export type SelectorMap<T extends import("../types").State> = {
 export type StoreInternal<T extends import("../types").State> = import("../types").StoreInternal<T>;
 export type PartialStore<T extends import("../types").State> = {
     data?: import("../types").Data;
-    resetState?: (propertyPaths?: string[]) => void;
+    resetState?: (propertyPaths?: any[]) => void;
     setState?: (changes: import("../types").UpdatePayload<import("../types").PartialState<T>>) => void;
 };
 export type Store<T extends import("../types").State> = import("../types").Store<T>;

package/dist/main/set-state/index.d.ts

@@ -1,7 +1,7 @@
 export default setState;
 export type TagKey = import("./tag-functions").TagKey;
-export type HasArrayRoot<K extends KeyTypes = string> = HasRoot<K, Array<any>>;
-export type HasObjectRoot<K extends KeyTypes = string> = K extends number ? {
+export type HasArrayRoot<K extends import("../../types").KeyType = string> = HasRoot<K, Array<any>>;
+export type HasObjectRoot<K extends import("../../types").KeyType = string> = K extends number ? {
     [rootKey: number]: {
         [x: string]: any;
     };
@@ -16,14 +16,14 @@ export type HasObjectRoot<K extends KeyTypes = string> = K extends number ? {
         [x: string]: any;
     };
 };
-export type HasRoot<K extends KeyTypes = string, T> = K extends number ? {
+export type HasRoot<K extends import("../../types").KeyType = string, T> = K extends number ? {
     [rootKey: number]: T;
 } | [T] : K extends string ? {
     [rootKey: string]: T;
 } : {
     [rootKey: symbol]: T;
 };
-export type KeyTypes = number | string | symbol;
+export type KeyType = import("../../types").KeyType;
 export type Listener<T extends import("../../types").State> = import("../../types").Listener<T>;
 export type UpdatePayload<T> = import("../../types").UpdatePayload<T>;
 export type PartialState<T extends import("../../types").State> = import("../../types").PartialState<T>;

package/dist/main/set-state/tag-functions/index.d.ts

@@ -1,4 +1,4 @@
-export function $clear(state: T, stateKey: K, stats: Stats, changes: (import("../../../types").ClearCommand | import("../../../types").BaseType)[] | (T & { [K_1 in K]: import("../../../types").ClearCommand & {
+export function $clear(state: T, stateKey: K, stats: Stats, changes: (import("../../../types").BaseType | import("../../../types").ClearCommand)[] | (T & { [K_1 in K]: import("../../../types").ClearCommand & {
     [x: string]: any;
 }; })): void;
 export const $delete: TagFunction<T, K, import("../../../types").DeleteCommand<T[K]>>;

package/dist/main/set-state/tag-functions/index.js

@@ -290,7 +290,7 @@ exports["default"] = _default;
 var isClosedTag = function () {
   var NO_PARAM_TAGS = _defineProperty({}, _constants.CLEAR_TAG, null);
   return function (tag) {
-    return tag in NO_PARAM_TAGS;
+    return tag in NO_PARAM_TAGS && !Array.isArray(tag);
   };
 }();
 exports.isClosedTag = isClosedTag;

package/dist/types.d.ts

@@ -1,5 +1,8 @@
 declare const _default: any;
 export default _default;
+export type BaseType = any[] | {
+    [x: string]: any;
+} | Scalar;
 export type Data = {
     [selectorKey: string]: Readonly<any>;
 };
@@ -33,14 +36,29 @@ export type PropertyInfo<T extends any[] | State> = {
     source: T;
     value: any;
 };
+export type PropertyPath<T extends State> = keyof T | KeyType | KeyType[];
+export type PropertyPathTokens = Array<KeyType>;
+export type Scalar = boolean | KeyType;
+export type KeyType = number | string | symbol;
+export type SelectorMap<T extends State> = {
+    [dataPropKey: string]: PropertyPath<T>;
+    [dataPropKey: number]: PropertyPath<T>;
+    [dataPropKey: symbol]: PropertyPath<T>;
+} & {
+    [dataPropKey: string]: "@@STATE" | ["@@STATE"];
+    [dataPropKey: number]: "@@STATE" | ["@@STATE"];
+    [dataPropKey: symbol]: "@@STATE" | ["@@STATE"];
+};
 export type State = {
     [x: string]: any;
+    [x: number]: any;
+    [x: symbol]: any;
 };
 export type StoreInternal<T extends State> = {
-    resetState: (propertyPaths?: string[]) => void;
+    resetState: (propertyPaths?: any[]) => void;
     setState: (changes: UpdatePayload<PartialState<T>>) => void;
 } & {
-    getState: (clientId: string, ...propertyPaths?: string[]) => {
+    getState: (clientId: string, ...propertyPaths?: PropertyPathTokens) => {
         [propertyPaths: string]: Readonly<any>;
     };
     subscribe: (listener: Listener<T>) => Unsubscribe;
@@ -48,7 +66,7 @@ export type StoreInternal<T extends State> = {
 };
 export type Store<T extends State> = {
     data: Data;
-    resetState: (propertyPaths?: string[]) => void;
+    resetState: (propertyPaths?: PropertyPath[]) => void;
     setState: (changes: UpdatePayload<PartialState<T>>) => void;
 };
 export type UpdateStats = {
@@ -84,7 +102,4 @@ export type PUSH_TAG = typeof import("./constants").PUSH_TAG;
 export type REPLACE_TAG = typeof import("./constants").REPLACE_TAG;
 export type SET_TAG = typeof import("./constants").SET_TAG;
 export type SPLICE_TAG = typeof import("./constants").SPLICE_TAG;
-export type Unsubscribe = VoidFunction;
-export type BaseType = string | number | boolean | symbol | any[] | {
-    [x: string]: any;
-};
+export type Unsubscribe = VoidFunction;

package/package.json

@@ -133,5 +133,5 @@
     "test:watch": "eslint --fix && jest --updateSnapshot --watchAll"
   },
   "types": "dist/main/index.d.ts",
-  "version": "4.1.0-alpha.1"
+  "version": "4.1.0-alpha.3"
 }