@mudlet/mudlet-web 0.5.0 → 1.0.1

package/dist-lib/storage/appStore.d.ts

@@ -2,6 +2,15 @@ import { type AppSchema, type MudConnection, type AliasNode, type ButtonNode, ty
 import type { MudletVariable } from '../import/mudletVariables';
 import type { MudletImportResult } from '../import/mudletXmlImport';
 import type { WindowOpenOptions } from '../ui/windows/types';
+import { MIGRATION_BACKUP_KEY } from './profileStorage';
+/** One node lifted out of a per-connection list, with the position it occupied.
+ *  Positions are indices into the flat array, which is what carries sibling
+ *  order in this schema — so putting them back at those indices reinstates the
+ *  tree exactly, subtree included. */
+export interface RestoredNode<T> {
+    index: number;
+    node: T;
+}
 interface AppStore extends AppSchema {
     /** Adds a connection and returns its newly generated id (so callers can
      *  immediately attach per-profile data like saved login credentials). */
@@ -26,6 +35,7 @@ interface AppStore extends AppSchema {
     /** Replace the set of global names flagged to persist (Mudlet save-list).
      *  Edited from the Variables view; triggers a profile-data save. */
     setVariableSaveList: (connectionId: string, saveList: string[]) => void;
+    setVariableHidden: (connectionId: string, hidden: string[]) => void;
     /** Replace the captured variable values without disturbing the save-list
      *  reference — so the engine can refresh them on save without re-triggering
      *  the save subscription (which keys on the save-list, not values). */
@@ -65,6 +75,14 @@ interface AppStore extends AppSchema {
     addButton: (connectionId: string, data: Omit<ButtonNode, 'id'>) => string;
     updateButton: (connectionId: string, id: string, patch: Partial<Omit<ButtonNode, 'id'>>) => void;
     removeButton: (connectionId: string, id: string) => void;
+    /** Put deleted nodes back where they were — the undo half of the six
+     *  `removeX` actions above. See `spliceBack`. */
+    restoreScripts: (connectionId: string, entries: ReadonlyArray<RestoredNode<ScriptNode>>) => void;
+    restoreAliases: (connectionId: string, entries: ReadonlyArray<RestoredNode<AliasNode>>) => void;
+    restoreTriggers: (connectionId: string, entries: ReadonlyArray<RestoredNode<TriggerNode>>) => void;
+    restoreTimers: (connectionId: string, entries: ReadonlyArray<RestoredNode<TimerNode>>) => void;
+    restoreKeybindings: (connectionId: string, entries: ReadonlyArray<RestoredNode<KeyNode>>) => void;
+    restoreButtons: (connectionId: string, entries: ReadonlyArray<RestoredNode<ButtonNode>>) => void;
     moveScript: (connectionId: string, id: string, newParentId: string | null, insertBeforeId: string | null) => void;
     moveAlias: (connectionId: string, id: string, newParentId: string | null, insertBeforeId: string | null) => void;
     moveTrigger: (connectionId: string, id: string, newParentId: string | null, insertBeforeId: string | null) => void;
@@ -98,18 +116,16 @@ interface PersistedConnectionData {
     layoutSnapshot?: WindowLayoutSnapshot;
     variables?: ProfileVariables;
 }
-/** localStorage key + schema version for the persisted store. Exported so the
- *  cross-tab sync (crossTabSync.ts) can match `storage` events to this store and
- *  reject writes from a different schema version. */
-export declare const MUDIX_STORE_NAME = "mudix_v1";
-export declare const MUDIX_STORE_VERSION = 21;
+export declare const MUDLET_STORE_NAME = "mudlet_v1";
+export declare const MUDLET_STORE_VERSION = 21;
 /** One-time localStorage key holding pre-v21 per-profile UI/layout/settings
  *  slices, stashed by the v21 migration so they can be moved into each profile's
- *  VFS (.mudix/profile.json) the first time it's opened. Kept separate from the
+ *  VFS (.mudlet/profile.json) the first time it's opened. Kept separate from the
  *  persisted store blob so editing the connections list (which rewrites the
  *  blob) can't drop un-migrated profiles' data. Consumed per-profile by
- *  loadProfileData, then removed when empty. */
-export declare const MIGRATION_BACKUP_KEY = "mudix_profile_migration_v21";
+ *  loadProfileData, then removed when empty. Defined next to the rest of the
+ *  per-profile storage inventory so profile deletion can sweep it. */
+export { MIGRATION_BACKUP_KEY };
 export declare const useAppStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<AppStore>, "setState" | "persist"> & {
     setState(partial: AppStore | Partial<AppStore> | ((state: AppStore) => AppStore | Partial<AppStore>), replace?: false | undefined): unknown;
     setState(state: AppStore | ((state: AppStore) => AppStore), replace: true): unknown;
@@ -129,4 +145,3 @@ export declare const useAppStore: import("zustand").UseBoundStore<Omit<import("z
         }, unknown>>;
     };
 }>;
-export {};

package/dist-lib/storage/hooks.d.ts

@@ -1,4 +1,4 @@
-import { type ClientSettings, type ProfileSettings, type Theme } from './schema';
+import { type ClientSettings, type EditorSettings, type ProfileSettings, type Theme } from './schema';
 /**
  * Active profile id, provided by ProfileSession. `null` outside a profile
  * (e.g. on the connection screen) — settings consumers fall through to
@@ -15,3 +15,7 @@ export declare function useClientField<K extends keyof ClientSettings>(key: K):
  *  current theme (e.g. CodeMirror editors). Outside a profile (no context) it
  *  resolves to the launcher theme. */
 export declare function useEffectiveTheme(): Theme;
+/** The script editor's display options, each falling back to its default.
+ *  Returns a stable-shaped object, so read the individual fields in a
+ *  dependency array rather than the object itself. */
+export declare function useEditorSettings(): Required<EditorSettings>;

package/dist-lib/storage/index.d.ts

@@ -1,4 +1,4 @@
-export { type AppSchema, type MudConnection, type ConnectionMode, type ClientSettings, type ProfileSettings, type MapperSettings, type PlayerMarkerSettings, type MapInfoBgColor, type ProtocolSettings, type BooleanProtocolKey, type Theme, type OutputFontSource, APP_DEFAULTS, PROFILE_DEFAULTS, MAPPER_DEFAULTS, PLAYER_MARKER_DEFAULTS, MAP_INFO_BG_DEFAULT, PROTOCOL_DEFAULTS, WS_SUBPROTOCOL_CHOICES, DEFAULT_PROXY_URL, connectionUrl, connectionDisplayAddr, connectionSecureTransport, connectionNameTaken, uniqueConnectionName, effectiveProxyUrl, proxyCanInspectCertificates, selectProfileField } from './schema';
+export { type AppSchema, type MudConnection, type ConnectionMode, type ClientSettings, type ProfileSettings, type MapperSettings, type EditorSettings, type PlayerMarkerSettings, type MapInfoBgColor, type ProtocolSettings, type BooleanProtocolKey, type Theme, type OutputFontSource, APP_DEFAULTS, PROFILE_DEFAULTS, MAPPER_DEFAULTS, symbolFontSource, PLAYER_MARKER_DEFAULTS, MAP_INFO_BG_DEFAULT, PROTOCOL_DEFAULTS, WS_SUBPROTOCOL_CHOICES, SEARCH_ENGINES, DEFAULT_SEARCH_ENGINE, resolveSearchEngine, DEFAULT_PROXY_URL, connectionUrl, connectionDisplayAddr, connectionNameTaken, uniqueConnectionName, type PortValidation, validatePort, DEFAULT_MUD_PORT, type HostValidation, validateHost, type UrlValidation, validateWsUrl, type ProxyValidation, validateProxyUrl, withProxyParams, effectiveProxyUrl, proxyCanInspectCertificates, selectProfileField } from './schema';
 export { useAppStore } from './appStore';
 export { initCrossTabSync } from './crossTabSync';
-export { ConnectionIdContext, useConnectionId, useProfileField, useClientField, useEffectiveTheme } from './hooks';
+export { ConnectionIdContext, useConnectionId, useProfileField, useClientField, useEffectiveTheme, useEditorSettings } from './hooks';

package/dist-lib/storage/mapStorage.d.ts

@@ -1,2 +1,4 @@
 export declare function saveMap(connectionId: string, data: ArrayBuffer): Promise<void>;
+/** Drop one profile's map. Keyed by connection id, so it can't reach another's. */
+export declare function deleteMap(connectionId: string): Promise<void>;
 export declare function loadMap(connectionId: string): Promise<ArrayBuffer | null>;

package/dist-lib/storage/persistentStorage.d.ts

@@ -4,7 +4,9 @@ export declare function persistenceSupported(): boolean;
 export declare function isPersisted(): Promise<boolean>;
 /** Ask the browser to exempt this origin's storage from eviction, at most once
  *  per page session. Resolves to whether storage is persistent afterwards —
- *  `false` on refusal or on a browser without the API. Never throws. */
+ *  `false` on refusal or on a browser without the API. Never throws. When the
+ *  brand opts out (`requestPersistentStorage: false`) nothing is requested and
+ *  this only reports the current state. */
 export declare function ensurePersistentStorage(): Promise<boolean>;
 /** Test seam: forget the one-per-session attempt. */
 export declare function resetPersistenceRequest(): void;

package/dist-lib/storage/profileStorage.d.ts

@@ -0,0 +1,15 @@
+/** localStorage key holding the one-time v21 profile-data migration backup,
+ *  a `{ [connectionId]: slices }` map consumed on each profile's next open. */
+export declare const MIGRATION_BACKUP_KEY = "mudlet_profile_migration_v21";
+/** Name of the IndexedDB database backing a profile's ZenFS mount. Must match
+ *  the `storeName` ProfileVFS.doMount passes to the IndexedDB backend. */
+export declare function profileVfsDatabaseName(connectionId: string): string;
+/**
+ * Erase everything stored for one profile outside the app store: its VFS
+ * database, its map, its linked-folder handle, its logs and its per-profile
+ * localStorage keys. See the inventory at the top of this file.
+ *
+ * Best-effort throughout — a store that fails to open must not stop the rest,
+ * and the caller (removeConnection) is synchronous and does not await this.
+ */
+export declare function deleteProfileStorage(connectionId: string): Promise<void>;

package/dist-lib/storage/profileVfsData.d.ts

@@ -11,9 +11,9 @@ import type { ProfileVFS } from '../scripting/vfs/ProfileVFS';
  * eliminating the multi-tab clobber the shared blob suffered.
  *
  * The file is dot-prefixed so it stays out of the way in the user-browsable
- * file area. `ProfileVFS.writeFile` creates the `.mudix/` parent dir for us.
+ * file area. `ProfileVFS.writeFile` creates the `.mudlet/` parent dir for us.
  */
-export declare const PROFILE_DATA_PATH = ".mudix/profile.json";
+export declare const PROFILE_DATA_PATH = ".mudlet/profile.json";
 export interface PersistedProfileData {
     version: number;
     scripts: ScriptNode[];
@@ -34,7 +34,7 @@ export interface PersistedProfileData {
     layoutSnapshot?: WindowLayoutSnapshot;
 }
 /**
- * Read `.mudix/profile.json` from the profile VFS and push it into the store
+ * Read `.mudlet/profile.json` from the profile VFS and push it into the store
  * for `connectionId`. Also completes the one-time v21 migration: if this
  * profile's UI/settings/layout slices haven't moved into the VFS yet, they're
  * pulled from the migration backup, hydrated, written to the VFS, and dropped