Make clearing TypeDoc fields from local storage optional (#2908)

Author: jsmith2-coveo

site/development/local-storage.md

@@ -17,3 +17,7 @@ To enable local storage, use:
 `window.TypeDoc.enableLocalStorage();`
 
 **Note:** Local storage is enabled by default.
+
+To disable local storage without clearing it, use:
+
+`window.TypeDoc.disableWritingLocalStorage();`

src/lib/output/themes/default/assets/typedoc/Application.ts

@@ -17,13 +17,17 @@ declare global {
             [k: `kind_${number}`]: string;
         };
         TypeDoc: {
+            disableWritingLocalStorage: () => void;
             disableLocalStorage: () => void;
             enableLocalStorage: () => void;
         };
     }
 }
 
 window.TypeDoc ||= {
+    disableWritingLocalStorage() {
+        storage.disableWritingLocalStorage();
+    },
     disableLocalStorage: () => {
         storage.disable();
     },

src/lib/output/themes/default/assets/typedoc/utils/storage.ts

@@ -29,6 +29,9 @@ try {
 export const storage = {
     getItem: (key: string) => _storage.getItem(key),
     setItem: (key: string, value: string) => _storage.setItem(key, value),
+    disableWritingLocalStorage() {
+        _storage = noOpStorageImpl;
+    },
     disable() {
         localStorage.clear();
         _storage = noOpStorageImpl;