Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

5.0 KB
Raw Blame
// Locale selection and persistence. Catalog content lives in ../locales.
import { useSyncExternalStore } from "react";
import {
  locales,
  isLang,
  resolveLang,
  visualTitleFrames,
  type CopyKey,
  type Lang,
  type TitleFrameKey,
  type TitleContent,
} from "../locales";

export type { CopyKey, Lang, TitleFrameKey } from "../locales";
export type CopyMode = "text" | "vis";

const LANG_STORAGE_KEY = "piik:ui-lang";
const MODE_STORAGE_KEY = "piik:ui-mode";

interface CopyPrefs {
  lang: Lang;
  vis: boolean;
}

function readStored(): Partial<CopyPrefs> {
  try {
    const lang = window.localStorage.getItem(LANG_STORAGE_KEY);
    const mode = window.localStorage.getItem(MODE_STORAGE_KEY);
    return {
      ...(isLang(lang) ? { lang } : {}),
      ...(mode === "text" || mode === "vis" ? { vis: mode === "vis" } : {}),
    };
  } catch {
    return {};
  }
}

const stored = readStored();
let explicit = Object.keys(stored).length > 0;
const state: CopyPrefs = {
  lang: resolveLang(typeof navigator === "undefined" ? undefined : navigator.language),
  vis: false,
  ...stored,
};

function syncDocumentLanguage(): void {
  if (typeof document !== "undefined") {
    document.documentElement.lang = locales[state.lang].tag;
  }
}

syncDocumentLanguage();

const listeners = new Set<() => void>();

// Applies values without persisting (storage-event sync path); commit() is
// the persisting variant for local user actions.
function apply(next: Partial<CopyPrefs>): void {
  if (next.lang) state.lang = next.lang;
  if (next.vis !== undefined) state.vis = next.vis;
  syncDocumentLanguage();
  listeners.forEach((listener) => listener());
}

function commit(next: Partial<CopyPrefs>): void {
  explicit = true;
  apply(next);
  try {
    window.localStorage.setItem(LANG_STORAGE_KEY, state.lang);
    window.localStorage.setItem(MODE_STORAGE_KEY, state.vis ? "vis" : "text");
  } catch {
    // Restricted storage only disables persistence.
  }
}

// Cross-tab sync: a commit in another tab re-applies the persisted values
// here. Identical-value writes fire no storage event, so tabs converge
// without re-notify loops.
if (typeof window !== "undefined") {
  window.addEventListener("storage", (event) => {
    if (event.key === LANG_STORAGE_KEY || event.key === MODE_STORAGE_KEY) {
      const stored = readStored();
      explicit = Object.keys(stored).length > 0;
      apply(stored);
    }
  });
}

// Non-React setter for local choices and product previews.
export const setCopy = commit;

export function hasCopyPreference(): boolean {
  return explicit;
}

// Older launchers do not distinguish a user choice from their system default.
// Treat unmarked handoff values as temporary defaults, never persisted choices.
export function applyLaunchCopy(next: Partial<CopyPrefs>, explicitChoice: boolean): void {
  if (explicitChoice) commit(next);
  else if (!explicit) apply(next);
}

export function isCopyKey(value: string): value is CopyKey {
  return Object.hasOwn(locales.zh.copy, value);
}

export function t(lang: Lang, key: CopyKey, vars?: Record<string, string>): string {
  let value = locales[lang].copy[key];
  if (vars) {
    for (const [name, replacement] of Object.entries(vars)) {
      value = value.replace(`{${name}}`, () => replacement);
    }
  }
  return value;
}

export function getTitleFrames(
  lang: Lang,
  visual: boolean,
  key: TitleFrameKey,
): TitleContent {
  return visual ? visualTitleFrames[key] : locales[lang].titleFrames[key];
}

// Non-hook accessor for transient notices composed outside React render
// (pages keep resolved strings in state; a language switch leaves an already
// shown notice in its original language until replaced).
export function say(key: CopyKey, vars?: Record<string, string>): string {
  return t(state.lang, key, vars);
}

// The selected language for composers that run outside React render (say()).
export function currentLang(): Lang {
  return state.lang;
}

// Locale-aware joins for composed notices.
export function joinSentences(lang: Lang, parts: string[]): string {
  return parts.join(lang === "zh" ? ";" : "; ");
}
export function joinItems(lang: Lang, parts: string[]): string {
  return parts.join(lang === "zh" ? "、" : ", ");
}

export interface Copy {
  lang: Lang;
  vis: boolean;
  t: (key: CopyKey, vars?: Record<string, string>) => string;
  titleFrames: (key: TitleFrameKey) => TitleContent;
  setLang: (lang: Lang) => void;
  setVis: (vis: boolean) => void;
}

export function useCopy(): Copy {
  const snapshot = () => `${state.lang}:${state.vis}`;
  const current = useSyncExternalStore(
    (listener) => {
      listeners.add(listener);
      return () => listeners.delete(listener);
    },
    snapshot,
    snapshot,
  );
  const [lang, vis] = current.split(":") as [Lang, string];
  const visual = vis === "true";
  return {
    lang,
    vis: visual,
    t: (key, vars) => t(lang, key, vars),
    titleFrames: (key) => getTitleFrames(lang, visual, key),
    setLang: (next) => commit({ lang: next, vis: false }),
    setVis: (next) => commit({ vis: next }),
  };
}