atom.io 0.11.0 → 0.12.1

package/react-devtools/dist/{index.d.mts → index.d.cts}

@@ -92,26 +92,30 @@ interface JunctionSchema<ASide extends string, BSide extends string> extends Obj
     readonly between: [a: ASide, b: BSide];
     readonly cardinality: Cardinality;
 }
+type BaseExternalStoreConfiguration = {
+    addRelation: (a: string, b: string) => void;
+    deleteRelation: (a: string, b: string) => void;
+    replaceRelationsSafely: (a: string, bs: string[]) => void;
+    replaceRelationsUnsafely: (a: string, bs: string[]) => void;
+    getRelatedKeys: (key: string) => Set<string> | undefined;
+    has: (a: string, b?: string) => boolean;
+};
+type ExternalStoreWithContentConfiguration<Content extends Object$1> = {
+    getContent: (contentKey: string) => Content | undefined;
+    setContent: (contentKey: string, content: Content) => void;
+    deleteContent: (contentKey: string) => void;
+};
+type Empty<Obj extends object> = {
+    [Key in keyof Obj]?: undefined;
+};
+type ExternalStoreConfiguration<Content extends Object$1 | null> = Content extends Object$1 ? BaseExternalStoreConfiguration & ExternalStoreWithContentConfiguration<Content> : BaseExternalStoreConfiguration & Empty<ExternalStoreWithContentConfiguration<Object$1>>;
 type JunctionAdvancedConfiguration<Content extends Object$1 | null> = {
-    externalStore?: (Content extends null ? {
-        getContent?: undefined;
-        setContent?: undefined;
-        deleteContent?: undefined;
-    } : {
-        getContent: (contentKey: string) => Content | undefined;
-        setContent: (contentKey: string, content: Content) => void;
-        deleteContent: (contentKey: string) => void;
-    }) & {
-        addRelation: (a: string, b: string) => void;
-        deleteRelation: (a: string, b: string) => void;
-        getRelatedKeys: (key: string) => Set<string> | undefined;
-        has: (a: string, b?: string) => boolean;
-    };
+    externalStore?: ExternalStoreConfiguration<Content>;
     isContent?: Refinement<unknown, Content>;
     makeContentKey?: (a: string, b: string) => string;
 };
 type JunctionJSON<ASide extends string, BSide extends string, Content extends Object$1 | null> = JunctionEntries<Content> & JunctionSchema<ASide, BSide>;
-declare class Junction<ASide extends string, BSide extends string, Content extends Object$1 | null = null> {
+declare class Junction<const ASide extends string, const BSide extends string, const Content extends Object$1 | null = null> {
     readonly a: ASide;
     readonly b: BSide;
     readonly cardinality: Cardinality;
@@ -122,6 +126,8 @@ declare class Junction<ASide extends string, BSide extends string, Content exten
     getRelatedKeys(key: string): Set<string> | undefined;
     protected addRelation(a: string, b: string): void;
     protected deleteRelation(a: string, b: string): void;
+    protected replaceRelationsUnsafely(a: string, bs: string[]): void;
+    protected replaceRelationsSafely(a: string, bs: string[]): void;
     protected getContentInternal(contentKey: string): Content | undefined;
     protected setContent(contentKey: string, content: Content): void;
     protected deleteContent(contentKey: string): void;
@@ -134,6 +140,9 @@ declare class Junction<ASide extends string, BSide extends string, Content exten
     delete(a: string, b?: string): this;
     delete(relation: Record<ASide | BSide, string> | Record<ASide, string> | Record<BSide, string>, b?: undefined): this;
     getRelatedKey(key: string): string | undefined;
+    replaceRelations(a: string, relations: Content extends null ? string[] : Record<string, Content>, config?: {
+        reckless: boolean;
+    }): this;
     getContent(a: string, b: string): Content | undefined;
     getRelationEntries(input: Record<ASide, string> | Record<BSide, string>): [string, Content][];
     has(a: string, b?: string): boolean;
@@ -143,6 +152,8 @@ interface Transceiver<Signal extends Json.Serializable> {
     do: (update: Signal) => void;
     undo: (update: Signal) => void;
     subscribe: (key: string, fn: (update: Signal) => void) => () => void;
+    cacheUpdateNumber: number;
+    getUpdateNumber: (update: Signal) => number;
 }
 
 /**
@@ -158,7 +169,7 @@ declare class Tracker<Mutable extends Transceiver<any>> {
     private updateCore;
     mutableState: MutableAtomToken<Mutable, Json.Serializable>;
     latestUpdateState: AtomToken<typeof this.Update | null>;
-    constructor(mutableState: MutableAtomToken<Mutable, Json.Serializable>, store?: Store);
+    constructor(mutableState: MutableAtomToken<Mutable, Json.Serializable>, store: Store);
 }
 
 interface MutableAtom<T> extends Atom<T> {
@@ -247,7 +258,8 @@ type Atom<T> = {
         newValue: T;
         oldValue: T;
     }>;
-    default: T;
+    default: T | (() => T);
+    cleanup?: () => void;
 };
 
 type AtomTokenIndex = StateTokenIndex<AtomToken<unknown>>;

package/react-devtools/dist/index.d.ts

@@ -92,26 +92,30 @@ interface JunctionSchema<ASide extends string, BSide extends string> extends Obj
     readonly between: [a: ASide, b: BSide];
     readonly cardinality: Cardinality;
 }
+type BaseExternalStoreConfiguration = {
+    addRelation: (a: string, b: string) => void;
+    deleteRelation: (a: string, b: string) => void;
+    replaceRelationsSafely: (a: string, bs: string[]) => void;
+    replaceRelationsUnsafely: (a: string, bs: string[]) => void;
+    getRelatedKeys: (key: string) => Set<string> | undefined;
+    has: (a: string, b?: string) => boolean;
+};
+type ExternalStoreWithContentConfiguration<Content extends Object$1> = {
+    getContent: (contentKey: string) => Content | undefined;
+    setContent: (contentKey: string, content: Content) => void;
+    deleteContent: (contentKey: string) => void;
+};
+type Empty<Obj extends object> = {
+    [Key in keyof Obj]?: undefined;
+};
+type ExternalStoreConfiguration<Content extends Object$1 | null> = Content extends Object$1 ? BaseExternalStoreConfiguration & ExternalStoreWithContentConfiguration<Content> : BaseExternalStoreConfiguration & Empty<ExternalStoreWithContentConfiguration<Object$1>>;
 type JunctionAdvancedConfiguration<Content extends Object$1 | null> = {
-    externalStore?: (Content extends null ? {
-        getContent?: undefined;
-        setContent?: undefined;
-        deleteContent?: undefined;
-    } : {
-        getContent: (contentKey: string) => Content | undefined;
-        setContent: (contentKey: string, content: Content) => void;
-        deleteContent: (contentKey: string) => void;
-    }) & {
-        addRelation: (a: string, b: string) => void;
-        deleteRelation: (a: string, b: string) => void;
-        getRelatedKeys: (key: string) => Set<string> | undefined;
-        has: (a: string, b?: string) => boolean;
-    };
+    externalStore?: ExternalStoreConfiguration<Content>;
     isContent?: Refinement<unknown, Content>;
     makeContentKey?: (a: string, b: string) => string;
 };
 type JunctionJSON<ASide extends string, BSide extends string, Content extends Object$1 | null> = JunctionEntries<Content> & JunctionSchema<ASide, BSide>;
-declare class Junction<ASide extends string, BSide extends string, Content extends Object$1 | null = null> {
+declare class Junction<const ASide extends string, const BSide extends string, const Content extends Object$1 | null = null> {
     readonly a: ASide;
     readonly b: BSide;
     readonly cardinality: Cardinality;
@@ -122,6 +126,8 @@ declare class Junction<ASide extends string, BSide extends string, Content exten
     getRelatedKeys(key: string): Set<string> | undefined;
     protected addRelation(a: string, b: string): void;
     protected deleteRelation(a: string, b: string): void;
+    protected replaceRelationsUnsafely(a: string, bs: string[]): void;
+    protected replaceRelationsSafely(a: string, bs: string[]): void;
     protected getContentInternal(contentKey: string): Content | undefined;
     protected setContent(contentKey: string, content: Content): void;
     protected deleteContent(contentKey: string): void;
@@ -134,6 +140,9 @@ declare class Junction<ASide extends string, BSide extends string, Content exten
     delete(a: string, b?: string): this;
     delete(relation: Record<ASide | BSide, string> | Record<ASide, string> | Record<BSide, string>, b?: undefined): this;
     getRelatedKey(key: string): string | undefined;
+    replaceRelations(a: string, relations: Content extends null ? string[] : Record<string, Content>, config?: {
+        reckless: boolean;
+    }): this;
     getContent(a: string, b: string): Content | undefined;
     getRelationEntries(input: Record<ASide, string> | Record<BSide, string>): [string, Content][];
     has(a: string, b?: string): boolean;
@@ -143,6 +152,8 @@ interface Transceiver<Signal extends Json.Serializable> {
     do: (update: Signal) => void;
     undo: (update: Signal) => void;
     subscribe: (key: string, fn: (update: Signal) => void) => () => void;
+    cacheUpdateNumber: number;
+    getUpdateNumber: (update: Signal) => number;
 }
 
 /**
@@ -158,7 +169,7 @@ declare class Tracker<Mutable extends Transceiver<any>> {
     private updateCore;
     mutableState: MutableAtomToken<Mutable, Json.Serializable>;
     latestUpdateState: AtomToken<typeof this.Update | null>;
-    constructor(mutableState: MutableAtomToken<Mutable, Json.Serializable>, store?: Store);
+    constructor(mutableState: MutableAtomToken<Mutable, Json.Serializable>, store: Store);
 }
 
 interface MutableAtom<T> extends Atom<T> {
@@ -247,7 +258,8 @@ type Atom<T> = {
         newValue: T;
         oldValue: T;
     }>;
-    default: T;
+    default: T | (() => T);
+    cleanup?: () => void;
 };
 
 type AtomTokenIndex = StateTokenIndex<AtomToken<unknown>>;