houdini 1.2.54 → 1.2.56

package/build/lib-esm/index.js

@@ -63855,6 +63855,35 @@ var GarbageCollector = class {
   }
 };
 
+// src/runtime/cache/stuff.ts
+function evaluateKey(key, variables = null) {
+  let evaluated = "";
+  let varName = "";
+  let inString = false;
+  for (const char of key) {
+    if (varName) {
+      if (varChars.includes(char)) {
+        varName += char;
+        continue;
+      }
+      const value = variables?.[varName.slice(1)];
+      evaluated += typeof value !== "undefined" ? JSON.stringify(value) : "undefined";
+      varName = "";
+    }
+    if (char === "$" && !inString) {
+      varName = "$";
+      continue;
+    }
+    if (char === '"') {
+      inString = !inString;
+    }
+    evaluated += char;
+  }
+  return evaluated;
+}
+var varChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789";
+var rootID = "_ROOT_";
+
 // src/runtime/cache/lists.ts
 var ListManager = class {
   rootID;
@@ -63921,11 +63950,15 @@ var ListManager = class {
     this.listsByField.get(parentID).get(list.key).push(handler);
   }
   removeIDFromAllLists(id, layer) {
+    let removed = false;
     for (const fieldMap of this.lists.values()) {
       for (const list of fieldMap.values()) {
-        list.removeID(id, void 0, layer);
+        if (list.removeID(id, void 0, layer)) {
+          removed = true;
+        }
       }
     }
+    return removed;
   }
   deleteField(parentID, field) {
     if (!this.listsByField.get(parentID)?.has(field)) {
@@ -64228,7 +64261,13 @@ var ListCollection = class {
     this.lists.forEach((list) => list.addToList(...args));
   }
   removeID(...args) {
-    this.lists.forEach((list) => list.removeID(...args));
+    let removed = false;
+    this.lists.forEach((list) => {
+      if (list.removeID(...args)) {
+        removed = true;
+      }
+    });
+    return removed;
   }
   remove(...args) {
     this.lists.forEach((list) => list.remove(...args));
@@ -64347,6 +64386,7 @@ var InMemoryStorage = class {
   }
   registerIDMapping(from, to) {
     this.idMaps[from] = to;
+    this.idMaps[to] = from;
   }
   createLayer(optimistic = false) {
     const layer = new Layer(this.idCount++);
@@ -64357,11 +64397,11 @@ var InMemoryStorage = class {
   insert(id, field, location, target) {
     return this.topLayer.insert(id, field, location, target);
   }
-  remove(id, field, target, layerToUser = this.topLayer) {
-    return layerToUser.remove(id, field, target);
+  remove(id, field, target, layer = this.topLayer) {
+    return layer.remove(id, field, target);
   }
-  delete(id, layerToUser = this.topLayer) {
-    return layerToUser.delete(id);
+  delete(id, layer = this.topLayer) {
+    return layer.delete(id);
   }
   deleteField(id, field) {
     return this.topLayer.deleteField(id, field);
@@ -64399,6 +64439,9 @@ var InMemoryStorage = class {
             return;
           }
           operations.remove.add(v);
+          if (this.idMaps[v]) {
+            operations.remove.add(this.idMaps[v]);
+          }
         });
         if (typeof layerValue === "undefined" && defaultValue) {
           const targetLayer = this.topLayer;
@@ -64425,7 +64468,11 @@ var InMemoryStorage = class {
               operations.remove.add(op.id);
             }
             if (isInsertOperation(op)) {
-              operations.insert[op.location].unshift(op.id);
+              if (op.location === OperationLocation.end) {
+                operations.insert[op.location].unshift(op.id);
+              } else {
+                operations.insert[op.location].push(op.id);
+              }
             }
             if (isDeleteOperation(op)) {
               return {
@@ -64671,7 +64718,7 @@ var Layer = class {
     }
     for (const [id, ops] of Object.entries(layer.operations)) {
       const fields = {};
-      for (const opMap of [this.operations[id], layer.operations[id]].filter(Boolean)) {
+      for (const opMap of [layer.operations[id], this.operations[id]].filter(Boolean)) {
         for (const [fieldName, operations] of Object.entries(opMap.fields || {})) {
           fields[fieldName] = [...fields[fieldName] || [], ...operations];
         }
@@ -64711,6 +64758,7 @@ var Layer = class {
       [id]: {
         ...this.operations[id],
         fields: {
+          ...this.operations[id]?.fields,
           [field]: [...this.operations[id]?.fields[field] || [], operation]
         }
       }
@@ -64736,34 +64784,6 @@ var OperationKind = {
   remove: "remove"
 };
 
-// src/runtime/cache/stuff.ts
-function evaluateKey(key, variables = null) {
-  let evaluated = "";
-  let varName = "";
-  let inString = false;
-  for (const char of key) {
-    if (varName) {
-      if (varChars.includes(char)) {
-        varName += char;
-        continue;
-      }
-      const value = variables?.[varName.slice(1)];
-      evaluated += typeof value !== "undefined" ? JSON.stringify(value) : "undefined";
-      varName = "";
-    }
-    if (char === "$" && !inString) {
-      varName = "$";
-      continue;
-    }
-    if (char === '"') {
-      inString = !inString;
-    }
-    evaluated += char;
-  }
-  return evaluated;
-}
-var varChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789";
-
 // src/runtime/cache/subscription.ts
 var InMemorySubscriptions = class {
   cache;
@@ -64775,6 +64795,9 @@ var InMemorySubscriptions = class {
   activeFields(parent) {
     return Object.keys(this.subscribers.get(parent) || {});
   }
+  copySubscribers(from, to) {
+    this.subscribers.set(to, this.subscribers.get(from) || /* @__PURE__ */ new Map());
+  }
   add({
     parent,
     spec,
@@ -64957,6 +64980,11 @@ var InMemorySubscriptions = class {
   get(id, field) {
     return this.subscribers.get(id)?.get(field)?.selections || [];
   }
+  getAll(id) {
+    return [...this.subscribers.get(id)?.values() || []].flatMap(
+      (fieldSub) => fieldSub.selections
+    );
+  }
   remove(id, selection, targets, variables, visited = []) {
     visited.push(id);
     const linkedIDs = [];
@@ -64998,7 +65026,7 @@ var InMemorySubscriptions = class {
     }
     const subscriberField = subscriber.get(fieldName);
     for (const spec of specs) {
-      const counts = subscriber.get(fieldName)?.referenceCounts;
+      const counts = subscriberField?.referenceCounts;
       if (!counts?.has(spec.set)) {
         continue;
       }
@@ -65021,24 +65049,23 @@ var InMemorySubscriptions = class {
       this.subscribers.delete(id);
     }
   }
-  removeAllSubscribers(id, targets, visited = []) {
-    visited.push(id);
-    const subscriber = this.subscribers.get(id);
-    for (const [key, val] of subscriber?.entries() ?? []) {
-      const subscribers = targets || val.selections.map(([spec]) => spec);
-      this.removeSubscribers(id, key, subscribers);
-      const { value, kind } = this.cache._internal_unstable.storage.get(id, key);
-      if (kind === "scalar") {
-        continue;
-      }
-      const nextTargets = Array.isArray(value) ? flatten(value) : [value];
-      for (const id2 of nextTargets) {
-        if (visited.includes(id2)) {
-          continue;
-        }
-        this.removeAllSubscribers(id2, subscribers, visited);
+  removeAllSubscribers(id, targets) {
+    if (!targets) {
+      targets = [...this.subscribers.get(id)?.values() || []].flatMap(
+        (spec) => spec.selections.flatMap((sel) => sel[0])
+      );
+    }
+    for (const target of targets) {
+      for (const subselection of this.findSubSelections(
+        target.parentID || rootID,
+        target.selection,
+        target.variables || {},
+        id
+      )) {
+        this.remove(id, subselection, targets, target.variables || {});
       }
     }
+    return;
   }
   get size() {
     let size = 0;
@@ -65049,6 +65076,32 @@ var InMemorySubscriptions = class {
     }
     return size;
   }
+  findSubSelections(parentID, selection, variables, searchTarget, selections = []) {
+    const __typename = this.cache._internal_unstable.storage.get(parentID, "__typename").value;
+    let targetSelection = getFieldsForType(selection, __typename, false);
+    for (const fieldSelection of Object.values(targetSelection || {})) {
+      if (!fieldSelection.selection) {
+        continue;
+      }
+      const key = evaluateKey(fieldSelection.keyRaw, variables || {});
+      const linkedRecord = this.cache._internal_unstable.storage.get(parentID, key);
+      const links = !Array.isArray(linkedRecord.value) ? [linkedRecord.value] : flatten(linkedRecord.value);
+      if (links.includes(searchTarget)) {
+        selections.push(fieldSelection.selection);
+      } else {
+        for (const link of links) {
+          this.findSubSelections(
+            link,
+            fieldSelection.selection,
+            variables,
+            searchTarget,
+            selections
+          );
+        }
+      }
+    }
+    return selections;
+  }
 };
 
 // src/runtime/cache/cache.ts
@@ -65126,11 +65179,17 @@ var Cache = class {
   }
   registerKeyMap(source, mapped) {
     this._internal_unstable.storage.registerIDMapping(source, mapped);
+    this._internal_unstable.subscriptions.copySubscribers(source, mapped);
   }
   delete(id, layer) {
-    this._internal_unstable.subscriptions.removeAllSubscribers(id);
-    this._internal_unstable.lists.removeIDFromAllLists(id, layer);
-    this._internal_unstable.storage.delete(id, layer);
+    const recordIDs = [this._internal_unstable.storage.idMaps[id], id].filter(
+      Boolean
+    );
+    for (const recordID of recordIDs) {
+      this._internal_unstable.subscriptions.removeAllSubscribers(recordID);
+      this._internal_unstable.lists.removeIDFromAllLists(recordID, layer);
+      this._internal_unstable.storage.delete(recordID, layer);
+    }
   }
   setConfig(config) {
     this._internal_unstable.setConfig(config);
@@ -65436,6 +65495,9 @@ var CacheInternal = class {
           layer,
           forceNotify
         });
+        let action = () => {
+          layer.writeLink(parent, key, linkedIDs);
+        };
         if (applyUpdates && updates) {
           if (key === "edges") {
             const newNodeIDs = [];
@@ -65470,8 +65532,26 @@ var CacheInternal = class {
             }
             if (update === "prepend") {
               linkedIDs = newIDs.concat(oldIDs);
+              if (layer?.optimistic) {
+                action = () => {
+                  for (const id of newIDs) {
+                    if (id) {
+                      layer.insert(parent, key, "start", id);
+                    }
+                  }
+                };
+              }
             } else if (update === "append") {
               linkedIDs = oldIDs.concat(newIDs);
+              if (layer?.optimistic) {
+                action = () => {
+                  for (const id of newIDs) {
+                    if (id) {
+                      layer.insert(parent, key, "end", id);
+                    }
+                  }
+                };
+              }
             } else if (update === "replace") {
               linkedIDs = newIDs;
             }
@@ -65490,7 +65570,7 @@ var CacheInternal = class {
           this.subscriptions.remove(lostID, fieldSelection, specs, variables);
         }
         if (contentChanged || oldIDs.length === 0 && newIDs.length === 0) {
-          layer.writeLink(parent, key, linkedIDs);
+          action();
         }
         for (const id of newIDs.filter((id2) => !oldIDs.includes(id2))) {
           if (id == null) {
@@ -65545,6 +65625,9 @@ var CacheInternal = class {
             if (!targetID) {
               continue;
             }
+            toNotify.push(
+              ...this.subscriptions.getAll(targetID).filter((sub) => sub[0].parentID !== targetID)
+            );
             this.cache.delete(targetID, layer);
           }
         }
@@ -65966,7 +66049,6 @@ function variableValue(value, args) {
     );
   }
 }
-var rootID = "_ROOT_";
 function defaultComponentField({
   cache,
   component,
@@ -66647,7 +66729,9 @@ var optimisticKeys = (cache, callbackCache = callbacks, keyCache = keys, objectI
               });
               delete callbackCache[optimisticValue];
             },
-            onIDChange: (optimisticValue, realValue) => cache.registerKeyMap(optimisticValue, realValue)
+            onIDChange: (optimisticValue, realValue) => {
+              cache.registerKeyMap(optimisticValue, realValue);
+            }
           }
         );
       }

package/build/runtime/cache/cache.d.ts

@@ -36,7 +36,7 @@ export declare class Cache {
     subscribe(spec: SubscriptionSpec, variables?: {}): void;
     unsubscribe(spec: SubscriptionSpec, variables?: {}): void;
     list(name: string, parentID?: string, allLists?: boolean): ListCollection;
-    registerKeyMap(source: string | number, mapped: string | number): void;
+    registerKeyMap(source: string, mapped: string): void;
     delete(id: string, layer?: Layer): void;
     setConfig(config: ConfigFile): void;
     markTypeStale(options?: {
@@ -153,7 +153,6 @@ export declare function evaluateVariables(variables: ValueMap, args: GraphQLObje
     [k: string]: GraphQLValue;
 };
 export declare function variableValue(value: ValueNode, args: GraphQLObject): GraphQLValue;
-export declare const rootID = "_ROOT_";
 export declare function fragmentReference({ component, prop, }: {
     component: {
         name: string;

package/build/runtime/cache/constants.d.ts

@@ -0,0 +1 @@
+export declare const rootID = "_ROOT_";

package/build/runtime/cache/lists.d.ts

@@ -21,7 +21,7 @@ export declare class ListManager {
         filters?: List['filters'];
         abstract?: boolean;
     }): void;
-    removeIDFromAllLists(id: string, layer?: Layer): void;
+    removeIDFromAllLists(id: string, layer?: Layer): boolean;
     deleteField(parentID: string, field: string): void;
     reset(): void;
 }
@@ -77,7 +77,7 @@ export declare class ListCollection {
     append(...args: Parameters<List['append']>): void;
     prepend(...args: Parameters<List['prepend']>): void;
     addToList(...args: Parameters<List['addToList']>): void;
-    removeID(...args: Parameters<List['removeID']>): void;
+    removeID(...args: Parameters<List['removeID']>): boolean;
     remove(...args: Parameters<List['remove']>): void;
     toggleElement(...args: Parameters<List['toggleElement']>): void;
     when(when?: ListWhen): ListCollection;

package/build/runtime/cache/storage.d.ts

@@ -3,15 +3,15 @@ export declare class InMemoryStorage {
     data: Layer[];
     private idCount;
     private rank;
-    private idMaps;
+    idMaps: Record<string, string>;
     constructor();
     get layerCount(): number;
     get nextRank(): number;
-    registerIDMapping(from: string | number, to: string | number): void;
+    registerIDMapping(from: string, to: string): void;
     createLayer(optimistic?: boolean): Layer;
     insert(id: string, field: string, location: OperationLocations, target: string): void;
-    remove(id: string, field: string, target: string, layerToUser?: Layer): void;
-    delete(id: string, layerToUser?: Layer): void;
+    remove(id: string, field: string, target: string, layer?: Layer): void;
+    delete(id: string, layer?: Layer): void;
     deleteField(id: string, field: string): void;
     getLayer(id: number): Layer;
     replaceID(replacement: {

package/build/runtime/cache/stuff.d.ts

@@ -1 +1,2 @@
 export declare function evaluateKey(key: string, variables?: Record<string, any> | null): string;
+export declare const rootID = "_ROOT_";

package/build/runtime/cache/subscription.d.ts

@@ -10,6 +10,7 @@ export declare class InMemorySubscriptions {
     private subscribers;
     private keyVersions;
     activeFields(parent: string): string[];
+    copySubscribers(from: string, to: string): void;
     add({ parent, spec, selection, variables, parentType, }: {
         parent: string;
         parentType?: string;
@@ -41,9 +42,11 @@ export declare class InMemorySubscriptions {
         parentType: string;
     }): void;
     get(id: string, field: string): FieldSelection[];
+    getAll(id: string): FieldSelection[];
     remove(id: string, selection: SubscriptionSelection, targets: SubscriptionSpec[], variables: {}, visited?: string[]): void;
     reset(): SubscriptionSpec[];
     private removeSubscribers;
-    removeAllSubscribers(id: string, targets?: SubscriptionSpec[], visited?: string[]): void;
+    removeAllSubscribers(id: string, targets?: SubscriptionSpec[]): void;
     get size(): number;
+    findSubSelections(parentID: string, selection: SubscriptionSelection, variables: {}, searchTarget: string, selections?: SubscriptionSelection[]): Array<SubscriptionSelection>;
 }

package/build/runtime-cjs/cache/cache.d.ts

@@ -36,7 +36,7 @@ export declare class Cache {
     subscribe(spec: SubscriptionSpec, variables?: {}): void;
     unsubscribe(spec: SubscriptionSpec, variables?: {}): void;
     list(name: string, parentID?: string, allLists?: boolean): ListCollection;
-    registerKeyMap(source: string | number, mapped: string | number): void;
+    registerKeyMap(source: string, mapped: string): void;
     delete(id: string, layer?: Layer): void;
     setConfig(config: ConfigFile): void;
     markTypeStale(options?: {
@@ -153,7 +153,6 @@ export declare function evaluateVariables(variables: ValueMap, args: GraphQLObje
     [k: string]: GraphQLValue;
 };
 export declare function variableValue(value: ValueNode, args: GraphQLObject): GraphQLValue;
-export declare const rootID = "_ROOT_";
 export declare function fragmentReference({ component, prop, }: {
     component: {
         name: string;

package/build/runtime-cjs/cache/cache.js

@@ -22,7 +22,6 @@ __export(cache_exports, {
   defaultComponentField: () => defaultComponentField,
   evaluateVariables: () => evaluateVariables,
   fragmentReference: () => fragmentReference,
-  rootID: () => rootID,
   variableValue: () => variableValue
 });
 module.exports = __toCommonJS(cache_exports);
@@ -50,7 +49,7 @@ class Cache {
       cache: this,
       storage: new import_storage.InMemoryStorage(),
       subscriptions: new import_subscription.InMemorySubscriptions(this),
-      lists: new import_lists.ListManager(this, rootID),
+      lists: new import_lists.ListManager(this, import_stuff.rootID),
       lifetimes: new import_gc.GarbageCollector(this),
       staleManager: new import_staleManager.StaleManager(this),
       disabled: disabled ?? typeof globalThis.window === "undefined",
@@ -87,7 +86,7 @@ class Cache {
       return;
     }
     return this._internal_unstable.subscriptions.add({
-      parent: spec.parentID || rootID,
+      parent: spec.parentID || import_stuff.rootID,
       spec,
       selection: spec.selection,
       variables
@@ -95,7 +94,7 @@ class Cache {
   }
   unsubscribe(spec, variables = {}) {
     return this._internal_unstable.subscriptions.remove(
-      spec.parentID || rootID,
+      spec.parentID || import_stuff.rootID,
       spec.selection,
       [spec],
       variables
@@ -112,11 +111,17 @@ class Cache {
   }
   registerKeyMap(source, mapped) {
     this._internal_unstable.storage.registerIDMapping(source, mapped);
+    this._internal_unstable.subscriptions.copySubscribers(source, mapped);
   }
   delete(id, layer) {
-    this._internal_unstable.subscriptions.removeAllSubscribers(id);
-    this._internal_unstable.lists.removeIDFromAllLists(id, layer);
-    this._internal_unstable.storage.delete(id, layer);
+    const recordIDs = [this._internal_unstable.storage.idMaps[id], id].filter(
+      Boolean
+    );
+    for (const recordID of recordIDs) {
+      this._internal_unstable.subscriptions.removeAllSubscribers(recordID);
+      this._internal_unstable.lists.removeIDFromAllLists(recordID, layer);
+      this._internal_unstable.storage.delete(recordID, layer);
+    }
   }
   setConfig(config) {
     this._internal_unstable.setConfig(config);
@@ -217,7 +222,7 @@ class Cache {
         notified.push(spec.set);
         spec.set(
           this._internal_unstable.getSelection({
-            parent: spec.parentID || rootID,
+            parent: spec.parentID || import_stuff.rootID,
             selection: spec.selection,
             variables: spec.variables?.() || {},
             ignoreMasking: false
@@ -277,7 +282,7 @@ class CacheInternal {
     data,
     selection,
     variables = {},
-    parent = rootID,
+    parent = import_stuff.rootID,
     applyUpdates,
     layer,
     toNotify = [],
@@ -422,6 +427,9 @@ class CacheInternal {
           layer,
           forceNotify
         });
+        let action = () => {
+          layer.writeLink(parent, key, linkedIDs);
+        };
         if (applyUpdates && updates) {
           if (key === "edges") {
             const newNodeIDs = [];
@@ -456,8 +464,26 @@ class CacheInternal {
             }
             if (update === "prepend") {
               linkedIDs = newIDs.concat(oldIDs);
+              if (layer?.optimistic) {
+                action = () => {
+                  for (const id of newIDs) {
+                    if (id) {
+                      layer.insert(parent, key, "start", id);
+                    }
+                  }
+                };
+              }
             } else if (update === "append") {
               linkedIDs = oldIDs.concat(newIDs);
+              if (layer?.optimistic) {
+                action = () => {
+                  for (const id of newIDs) {
+                    if (id) {
+                      layer.insert(parent, key, "end", id);
+                    }
+                  }
+                };
+              }
             } else if (update === "replace") {
               linkedIDs = newIDs;
             }
@@ -476,7 +502,7 @@ class CacheInternal {
           this.subscriptions.remove(lostID, fieldSelection, specs, variables);
         }
         if (contentChanged || oldIDs.length === 0 && newIDs.length === 0) {
-          layer.writeLink(parent, key, linkedIDs);
+          action();
         }
         for (const id of newIDs.filter((id2) => !oldIDs.includes(id2))) {
           if (id == null) {
@@ -531,6 +557,9 @@ class CacheInternal {
             if (!targetID) {
               continue;
             }
+            toNotify.push(
+              ...this.subscriptions.getAll(targetID).filter((sub) => sub[0].parentID !== targetID)
+            );
             this.cache.delete(targetID, layer);
           }
         }
@@ -540,7 +569,7 @@ class CacheInternal {
   }
   getSelection({
     selection,
-    parent = rootID,
+    parent = import_stuff.rootID,
     variables,
     stepsFromConnection = null,
     ignoreMasking,
@@ -884,7 +913,7 @@ class CacheInternal {
         }
       }
       this.writeSelection({
-        root: rootID,
+        root: import_stuff.rootID,
         selection: fields,
         parent: linkedID,
         data: entryObj,
@@ -952,7 +981,6 @@ function variableValue(value, args) {
     );
   }
 }
-const rootID = "_ROOT_";
 function fragmentReference({
   component,
   prop
@@ -991,6 +1019,5 @@ function defaultComponentField({
   defaultComponentField,
   evaluateVariables,
   fragmentReference,
-  rootID,
   variableValue
 });

package/build/runtime-cjs/cache/constants.d.ts

@@ -0,0 +1 @@
+export declare const rootID = "_ROOT_";

package/build/runtime-cjs/cache/constants.js

@@ -0,0 +1,28 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var constants_exports = {};
+__export(constants_exports, {
+  rootID: () => rootID
+});
+module.exports = __toCommonJS(constants_exports);
+const rootID = "_ROOT_";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rootID
+});

package/build/runtime-cjs/cache/lists.d.ts

@@ -21,7 +21,7 @@ export declare class ListManager {
         filters?: List['filters'];
         abstract?: boolean;
     }): void;
-    removeIDFromAllLists(id: string, layer?: Layer): void;
+    removeIDFromAllLists(id: string, layer?: Layer): boolean;
     deleteField(parentID: string, field: string): void;
     reset(): void;
 }
@@ -77,7 +77,7 @@ export declare class ListCollection {
     append(...args: Parameters<List['append']>): void;
     prepend(...args: Parameters<List['prepend']>): void;
     addToList(...args: Parameters<List['addToList']>): void;
-    removeID(...args: Parameters<List['removeID']>): void;
+    removeID(...args: Parameters<List['removeID']>): boolean;
     remove(...args: Parameters<List['remove']>): void;
     toggleElement(...args: Parameters<List['toggleElement']>): void;
     when(when?: ListWhen): ListCollection;