kopia lustrzana https://github.com/Tldraw/Tldraw
225 wiersze
5.4 KiB
TypeScript
225 wiersze
5.4 KiB
TypeScript
import { atom } from '@tldraw/state'
|
|
import { getDefaultTranslationLocale } from '@tldraw/tlschema'
|
|
import { getFromLocalStorage, setInLocalStorage, structuredClone } from '@tldraw/utils'
|
|
import { T } from '@tldraw/validate'
|
|
import { uniqueId } from '../utils/uniqueId'
|
|
|
|
const USER_DATA_KEY = 'TLDRAW_USER_DATA_v3'
|
|
|
|
/**
|
|
* A user of tldraw
|
|
*
|
|
* @public
|
|
*/
|
|
export interface TLUserPreferences {
|
|
id: string
|
|
name?: string | null
|
|
locale?: string | null
|
|
color?: string | null
|
|
animationSpeed?: number | null
|
|
edgeScrollSpeed?: number | null
|
|
isDarkMode?: boolean | null
|
|
isSnapMode?: boolean | null
|
|
isWrapMode?: boolean | null
|
|
}
|
|
|
|
interface UserDataSnapshot {
|
|
version: number
|
|
user: TLUserPreferences
|
|
}
|
|
|
|
interface UserChangeBroadcastMessage {
|
|
type: typeof broadcastEventKey
|
|
origin: string
|
|
data: UserDataSnapshot
|
|
}
|
|
|
|
const userTypeValidator: T.Validator<TLUserPreferences> = T.object<TLUserPreferences>({
|
|
id: T.string,
|
|
name: T.string.nullable().optional(),
|
|
locale: T.string.nullable().optional(),
|
|
color: T.string.nullable().optional(),
|
|
isDarkMode: T.boolean.nullable().optional(),
|
|
animationSpeed: T.number.nullable().optional(),
|
|
edgeScrollSpeed: T.number.nullable().optional(),
|
|
isSnapMode: T.boolean.nullable().optional(),
|
|
isWrapMode: T.boolean.nullable().optional(),
|
|
})
|
|
|
|
const Versions = {
|
|
AddAnimationSpeed: 1,
|
|
AddIsSnapMode: 2,
|
|
MakeFieldsNullable: 3,
|
|
AddEdgeScrollSpeed: 4,
|
|
AddExcalidrawSelectMode: 5,
|
|
} as const
|
|
|
|
const CURRENT_VERSION = Math.max(...Object.values(Versions))
|
|
|
|
function migrateSnapshot(data: { version: number; user: any }) {
|
|
if (data.version < Versions.AddAnimationSpeed) {
|
|
data.user.animationSpeed = 1
|
|
}
|
|
if (data.version < Versions.AddIsSnapMode) {
|
|
data.user.isSnapMode = false
|
|
}
|
|
if (data.version < Versions.MakeFieldsNullable) {
|
|
// noop
|
|
}
|
|
if (data.version < Versions.AddEdgeScrollSpeed) {
|
|
data.user.edgeScrollSpeed = 1
|
|
}
|
|
if (data.version < Versions.AddExcalidrawSelectMode) {
|
|
data.user.isWrapMode = false
|
|
}
|
|
|
|
// finally
|
|
data.version = CURRENT_VERSION
|
|
}
|
|
|
|
/** @internal */
|
|
export const USER_COLORS = [
|
|
'#FF802B',
|
|
'#EC5E41',
|
|
'#F2555A',
|
|
'#F04F88',
|
|
'#E34BA9',
|
|
'#BD54C6',
|
|
'#9D5BD2',
|
|
'#7B66DC',
|
|
'#02B1CC',
|
|
'#11B3A3',
|
|
'#39B178',
|
|
'#55B467',
|
|
] as const
|
|
|
|
function getRandomColor() {
|
|
return USER_COLORS[Math.floor(Math.random() * USER_COLORS.length)]
|
|
}
|
|
|
|
/** @internal */
|
|
export function userPrefersDarkUI() {
|
|
if (typeof window === 'undefined') {
|
|
return false
|
|
}
|
|
return window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false
|
|
}
|
|
|
|
/** @internal */
|
|
export function userPrefersReducedMotion() {
|
|
if (typeof window === 'undefined') {
|
|
return false
|
|
}
|
|
return window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches ?? false
|
|
}
|
|
|
|
/** @public */
|
|
export const defaultUserPreferences = Object.freeze({
|
|
name: 'New User',
|
|
locale: getDefaultTranslationLocale(),
|
|
color: getRandomColor(),
|
|
isDarkMode: false,
|
|
edgeScrollSpeed: 1,
|
|
animationSpeed: userPrefersReducedMotion() ? 0 : 1,
|
|
isSnapMode: false,
|
|
isWrapMode: false,
|
|
}) satisfies Readonly<Omit<TLUserPreferences, 'id'>>
|
|
|
|
/** @public */
|
|
export function getFreshUserPreferences(): TLUserPreferences {
|
|
return {
|
|
id: uniqueId(),
|
|
}
|
|
}
|
|
|
|
function migrateUserPreferences(userData: unknown): TLUserPreferences {
|
|
if (userData === null || typeof userData !== 'object') {
|
|
return getFreshUserPreferences()
|
|
}
|
|
|
|
if (!('version' in userData) || !('user' in userData) || typeof userData.version !== 'number') {
|
|
return getFreshUserPreferences()
|
|
}
|
|
|
|
const snapshot = structuredClone(userData) as any
|
|
|
|
migrateSnapshot(snapshot)
|
|
|
|
try {
|
|
return userTypeValidator.validate(snapshot.user)
|
|
} catch (e) {
|
|
return getFreshUserPreferences()
|
|
}
|
|
}
|
|
|
|
function loadUserPreferences(): TLUserPreferences {
|
|
const userData = (JSON.parse(getFromLocalStorage(USER_DATA_KEY) || 'null') ??
|
|
null) as null | UserDataSnapshot
|
|
|
|
return migrateUserPreferences(userData)
|
|
}
|
|
|
|
const globalUserPreferences = atom<TLUserPreferences | null>('globalUserData', null)
|
|
|
|
function storeUserPreferences() {
|
|
setInLocalStorage(
|
|
USER_DATA_KEY,
|
|
JSON.stringify({
|
|
version: CURRENT_VERSION,
|
|
user: globalUserPreferences.get(),
|
|
})
|
|
)
|
|
}
|
|
|
|
/** @public */
|
|
export function setUserPreferences(user: TLUserPreferences) {
|
|
userTypeValidator.validate(user)
|
|
globalUserPreferences.set(user)
|
|
storeUserPreferences()
|
|
broadcastUserPreferencesChange()
|
|
}
|
|
|
|
const isTest = typeof process !== 'undefined' && process.env.NODE_ENV === 'test'
|
|
|
|
const channel =
|
|
typeof BroadcastChannel !== 'undefined' && !isTest
|
|
? new BroadcastChannel('tldraw-user-sync')
|
|
: null
|
|
|
|
channel?.addEventListener('message', (e) => {
|
|
const data = e.data as undefined | UserChangeBroadcastMessage
|
|
if (data?.type === broadcastEventKey && data?.origin !== getBroadcastOrigin()) {
|
|
globalUserPreferences.set(migrateUserPreferences(data.data))
|
|
}
|
|
})
|
|
|
|
let _broadcastOrigin = null as null | string
|
|
function getBroadcastOrigin() {
|
|
if (_broadcastOrigin === null) {
|
|
_broadcastOrigin = uniqueId()
|
|
}
|
|
return _broadcastOrigin
|
|
}
|
|
const broadcastEventKey = 'tldraw-user-preferences-change' as const
|
|
|
|
function broadcastUserPreferencesChange() {
|
|
channel?.postMessage({
|
|
type: broadcastEventKey,
|
|
origin: getBroadcastOrigin(),
|
|
data: {
|
|
user: getUserPreferences(),
|
|
version: CURRENT_VERSION,
|
|
},
|
|
} satisfies UserChangeBroadcastMessage)
|
|
}
|
|
|
|
/** @public */
|
|
export function getUserPreferences(): TLUserPreferences {
|
|
let prefs = globalUserPreferences.get()
|
|
if (!prefs) {
|
|
prefs = loadUserPreferences()
|
|
globalUserPreferences.set(prefs)
|
|
}
|
|
return prefs
|
|
}
|