siftlode/frontend/src/lib/hints.ts

// App-wide "hints" toggle: when on, Tooltip components reveal short explanatory
// captions on hover so the UI is somewhat self-documenting for new users. Experienced
// users can turn it off in Settings. Persisted to localStorage (+ server preferences).
import { createStore } from "./store";
import { LS } from "./storage";

function load(): boolean {
  try {
    return localStorage.getItem(LS.hints) !== "0"; // default ON
  } catch {
    return true;
  }
}

const store = createStore<boolean>(load());

export const hintsEnabled = store.get;
export const subscribeHints = store.subscribe;

export function setHintsEnabled(v: boolean): void {
  store.set(v);
  try {
    localStorage.setItem(LS.hints, v ? "1" : "0");
  } catch {
    /* ignore */
  }
}