@ash-qw/dsh-theme-prts 0.1.91

package/src/client/preferences.js

@@ -0,0 +1,239 @@
+export const PRTS_STORAGE_KEY = 'dsh.ui.prts.v1'
+
+export const CONVERSATION_SCALE_DISTANCE_MIN = 16
+export const CONVERSATION_SCALE_DISTANCE_MAX = 240
+export const CONVERSATION_SCALE_DISTANCE_STEP = 8
+export const CONVERSATION_SCALE_DISTANCE_DEFAULT = 96
+
+export const CONVERSATION_SCALE_FOCUS_CONTRAST_MIN = 0
+export const CONVERSATION_SCALE_FOCUS_CONTRAST_MAX = 100
+export const CONVERSATION_SCALE_FOCUS_CONTRAST_STEP = 10
+export const CONVERSATION_SCALE_FOCUS_CONTRAST_DEFAULT = 70
+
+export const DEFAULT_PREFERENCES = Object.freeze({
+  version: 6,
+  enabled: false,
+  preset: 'standard-tactical',
+  texture: 'full',
+  glass: 'standard',
+  motion: 'system',
+  bootAnimation: true,
+  conversationParticleDensity: 'sparse',
+  heroParticleDensity: 'light',
+  particlePattern: 'orthogonal',
+  conversationScaleMaxDistance: CONVERSATION_SCALE_DISTANCE_DEFAULT,
+  conversationScaleFocusContrast: CONVERSATION_SCALE_FOCUS_CONTRAST_DEFAULT,
+})
+
+export const VISUAL_PRESETS = Object.freeze({
+  'standard-tactical': Object.freeze({
+    texture: 'full',
+    glass: 'standard',
+    motion: 'system',
+    conversationParticleDensity: 'sparse',
+    heroParticleDensity: 'light',
+    particlePattern: 'orthogonal',
+  }),
+  'clear-glass': Object.freeze({
+    texture: 'restrained',
+    glass: 'clear',
+    motion: 'system',
+    conversationParticleDensity: 'sparse',
+    heroParticleDensity: 'light',
+    particlePattern: 'orthogonal',
+  }),
+  'quiet-reading': Object.freeze({
+    texture: 'restrained',
+    glass: 'soft',
+    motion: 'reduced',
+    conversationParticleDensity: 'sparse',
+    heroParticleDensity: 'light',
+    particlePattern: 'orthogonal',
+  }),
+})
+
+
+export const PARTICLE_DETAIL_LEVELS = Object.freeze({
+  compact: Object.freeze({ conversationParticleDensity: 'sparse', heroParticleDensity: 'light' }),
+  standard: Object.freeze({ conversationParticleDensity: 'light', heroParticleDensity: 'standard' }),
+  precise: Object.freeze({ conversationParticleDensity: 'dense', heroParticleDensity: 'ultra' }),
+})
+export const PREFERENCE_GROUPS = Object.freeze({
+  background: Object.freeze(['texture']),
+  particles: Object.freeze(['conversationParticleDensity', 'heroParticleDensity']),
+  material: Object.freeze(['glass']),
+  accessibility: Object.freeze(['motion', 'bootAnimation']),
+  navigation: Object.freeze(['conversationScaleMaxDistance', 'conversationScaleFocusContrast']),
+})
+
+const TEXTURES = new Set(['off', 'restrained', 'full'])
+const GLASS_STRENGTHS = new Set(['off', 'soft', 'standard', 'clear'])
+const MOTIONS = new Set(['system', 'reduced'])
+const PARTICLE_DENSITIES = new Set(['sparse', 'light', 'standard', 'dense', 'ultra'])
+const PRESETS = new Set([...Object.keys(VISUAL_PRESETS), 'custom'])
+const PRESET_LINKED_KEYS = new Set(Object.keys(VISUAL_PRESETS['standard-tactical']))
+
+
+function matchedVisualPreset(value) {
+  for (const [preset, settings] of Object.entries(VISUAL_PRESETS)) {
+    if ([...PRESET_LINKED_KEYS].every(key => value[key] === settings[key])) return preset
+  }
+  return 'custom'
+}
+
+export function resolveParticleDetail(value) {
+  const normalized = normalizePreferences(value)
+  const exact = Object.entries(PARTICLE_DETAIL_LEVELS).find(([, settings]) => (
+    normalized.conversationParticleDensity === settings.conversationParticleDensity
+    && normalized.heroParticleDensity === settings.heroParticleDensity
+  ))
+  if (exact) return exact[0]
+  const rank = { sparse: 0, light: 1, standard: 2, dense: 3, ultra: 4 }
+  const score = ((rank[normalized.conversationParticleDensity] ?? 0) + (rank[normalized.heroParticleDensity] ?? 1)) / 2
+  return score < 1.5 ? 'compact' : score < 3 ? 'standard' : 'precise'
+}
+function booleanOr(value, fallback) {
+  return typeof value === 'boolean' ? value : fallback
+}
+
+function enumOr(value, allowed, fallback) {
+  return allowed.has(value) ? value : fallback
+}
+
+function scaleDistanceOr(value, fallback) {
+  const numeric = Number(value)
+  if (!Number.isFinite(numeric)) return fallback
+  const clamped = Math.min(CONVERSATION_SCALE_DISTANCE_MAX, Math.max(CONVERSATION_SCALE_DISTANCE_MIN, numeric))
+  return Math.round(clamped / CONVERSATION_SCALE_DISTANCE_STEP) * CONVERSATION_SCALE_DISTANCE_STEP
+}
+
+function scaleFocusContrastOr(value, fallback) {
+  const numeric = Number(value)
+  if (!Number.isFinite(numeric)) return fallback
+  const clamped = Math.min(CONVERSATION_SCALE_FOCUS_CONTRAST_MAX, Math.max(CONVERSATION_SCALE_FOCUS_CONTRAST_MIN, numeric))
+  return Math.round(clamped / CONVERSATION_SCALE_FOCUS_CONTRAST_STEP) * CONVERSATION_SCALE_FOCUS_CONTRAST_STEP
+}
+
+function normalizeGlass(input) {
+  if (input.glassEnabled === false || input.glass === 'off') return 'off'
+  if (input.glass === 'liquid') return 'clear'
+  return enumOr(input.glass, GLASS_STRENGTHS, DEFAULT_PREFERENCES.glass)
+}
+
+function legacyParticleDensities(input) {
+  const source = input.particleDensities !== null
+    && typeof input.particleDensities === 'object'
+    && !Array.isArray(input.particleDensities)
+    ? input.particleDensities
+    : null
+  const selected = source?.[input.particlePattern]
+  return {
+    conversation: input.conversationParticleDensity ?? selected?.conversation,
+    hero: input.heroParticleDensity ?? selected?.hero,
+  }
+}
+
+export function normalizePreferences(value) {
+  const input = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
+  const migratedPreset = input.version === 1 && !Object.hasOwn(input, 'preset')
+    ? 'custom'
+    : input.preset
+  const particlePreset = VISUAL_PRESETS[input.preset] ?? DEFAULT_PREFERENCES
+  const legacyDensities = legacyParticleDensities(input)
+  const normalized = {
+    version: 6,
+    enabled: booleanOr(input.enabled, DEFAULT_PREFERENCES.enabled),
+    preset: enumOr(migratedPreset, PRESETS, DEFAULT_PREFERENCES.preset),
+    texture: enumOr(input.texture, TEXTURES, DEFAULT_PREFERENCES.texture),
+    glass: normalizeGlass(input),
+    motion: input.motion === 'full' ? 'system' : enumOr(input.motion, MOTIONS, DEFAULT_PREFERENCES.motion),
+    bootAnimation: booleanOr(input.bootAnimation, DEFAULT_PREFERENCES.bootAnimation),
+    conversationParticleDensity: enumOr(legacyDensities.conversation, PARTICLE_DENSITIES, particlePreset.conversationParticleDensity),
+    heroParticleDensity: enumOr(legacyDensities.hero, PARTICLE_DENSITIES, particlePreset.heroParticleDensity),
+    particlePattern: 'orthogonal',
+    conversationScaleMaxDistance: scaleDistanceOr(
+      input.conversationScaleMaxDistance,
+      DEFAULT_PREFERENCES.conversationScaleMaxDistance,
+    ),
+    conversationScaleFocusContrast: scaleFocusContrastOr(
+      input.conversationScaleFocusContrast,
+      DEFAULT_PREFERENCES.conversationScaleFocusContrast,
+    ),
+  }
+  normalized.preset = matchedVisualPreset(normalized)
+  return normalized
+}
+
+export function applyVisualPreset(value, preset) {
+  const current = normalizePreferences(value)
+  const settings = VISUAL_PRESETS[preset]
+  if (!settings) return { ...current, preset: 'custom' }
+  return normalizePreferences({
+    ...current,
+    ...settings,
+  })
+}
+
+
+export function applyParticleDetail(value, level) {
+  const current = normalizePreferences(value)
+  const settings = PARTICLE_DETAIL_LEVELS[level]
+  return settings ? normalizePreferences({ ...current, ...settings }) : current
+}
+export function updatePreferenceValue(value, key, nextValue) {
+  if (key === 'preset') return applyVisualPreset(value, nextValue)
+  if (key === 'particleDetail') return applyParticleDetail(value, nextValue)
+  const current = normalizePreferences(value)
+  if (key === 'conversationParticleDensity' || key === 'heroParticleDensity') {
+    const density = enumOr(nextValue, PARTICLE_DENSITIES, current[key])
+    return normalizePreferences({ ...current, [key]: density })
+  }
+  return normalizePreferences({ ...current, [key]: nextValue })
+}
+
+export function resetPreferenceGroup(value, group) {
+  const current = normalizePreferences(value)
+  const keys = PREFERENCE_GROUPS[group]
+  if (!keys) return current
+  const reset = { ...current }
+  for (const key of keys) reset[key] = DEFAULT_PREFERENCES[key]
+  return normalizePreferences(reset)
+}
+
+export function loadPreferences(storage) {
+  try {
+    const raw = storage?.getItem(PRTS_STORAGE_KEY)
+    if (raw === null || raw === undefined) return { ...DEFAULT_PREFERENCES }
+    const parsed = JSON.parse(raw)
+    if (![1, 2, 3, 4, 5, 6].includes(parsed?.version)) return { ...DEFAULT_PREFERENCES }
+    return normalizePreferences(parsed)
+  } catch {
+    return { ...DEFAULT_PREFERENCES }
+  }
+}
+
+export function persistPreferences(storage, value) {
+  const normalized = normalizePreferences(value)
+  let persisted = false
+  try {
+    if (typeof storage?.setItem === 'function') {
+      storage.setItem(PRTS_STORAGE_KEY, JSON.stringify(normalized))
+      persisted = true
+    }
+  } catch {
+    // Private browsing or storage policy can make persistence unavailable.
+  }
+  return { preferences: normalized, persisted }
+}
+
+export function savePreferences(storage, value) {
+  return persistPreferences(storage, value).preferences
+}
+
+export function isSafeMode(search = '') {
+  try {
+    return new URLSearchParams(search).get('prts-safe') === '1'
+  } catch {
+    return false
+  }
+}

package/src/client/rc7-adapter.js

@@ -0,0 +1,83 @@
+function closestCommonContainer(root, nodes) {
+  let candidate = nodes[0]?.parentElement
+  while (candidate && candidate !== root) {
+    if (nodes.every(node => candidate === node || candidate.contains(node))) return candidate
+    candidate = candidate.parentElement
+  }
+  return root && nodes.every(node => root.contains(node)) ? root : null
+}
+
+export function resolveRc7Regions(document, report = () => {}) {
+  const root = document?.querySelector('[data-slot="root"]')
+  const sidebarSlot = root?.querySelector('[data-slot="sidebar"]')
+  const conversationSlot = root?.querySelector('[data-slot="conversation"]')
+  const detailsSlot = root?.querySelector('[data-slot="details"]')
+  if (!root || !sidebarSlot || !conversationSlot || !detailsSlot) {
+    report('required layout slots are unavailable', {
+      root: Boolean(root), sidebar: Boolean(sidebarSlot),
+      conversation: Boolean(conversationSlot), details: Boolean(detailsSlot),
+    })
+    return null
+  }
+  const sidebar = sidebarSlot?.parentElement
+  const center = conversationSlot?.parentElement
+  const details = detailsSlot?.parentElement
+
+  if (!sidebar || !center || !details) {
+    report('required layout region containers are unavailable', {
+      sidebar: Boolean(sidebar), conversation: Boolean(center), details: Boolean(details),
+    })
+    return null
+  }
+
+  const frame = closestCommonContainer(root, [sidebar, center, details])
+  if (!frame) {
+    report('common layout container is unavailable')
+    return null
+  }
+
+  return { root, frame, sidebar, center, details, sidebarSlot, conversationSlot, detailsSlot }
+}
+
+export function createRc7Adapter({ document, warn } = {}) {
+  const owned = []
+  let mounted
+  let lastDiagnostic
+  const writeWarning = typeof warn === 'function'
+    ? warn
+    : (...args) => document?.defaultView?.console?.warn?.(...args)
+
+  function reportLayoutIssue(message, details) {
+    const signature = `${message}:${JSON.stringify(details ?? {})}`
+    if (signature === lastDiagnostic) return
+    lastDiagnostic = signature
+    writeWarning(`[dsh-theme-prts] ${message}`, details)
+  }
+
+  return {
+    mount() {
+      if (mounted) return mounted
+      const regions = resolveRc7Regions(document, reportLayoutIssue)
+      if (!regions) return null
+      lastDiagnostic = undefined
+      for (const [node, value] of [
+        [regions.frame, 'frame'],
+        [regions.sidebar, 'sessions'],
+        [regions.center, 'operation'],
+        [regions.details, 'details'],
+      ]) {
+        owned.push([node, node.getAttribute('data-prts-region')])
+        node.setAttribute('data-prts-region', value)
+      }
+      mounted = regions
+      return mounted
+    },
+    dispose() {
+      for (const [node, previous] of owned.splice(0).reverse()) {
+        if (previous === null) node.removeAttribute('data-prts-region')
+        else node.setAttribute('data-prts-region', previous)
+      }
+      mounted = undefined
+    },
+  }
+}

package/src/client/resize-shield-adapter.js

@@ -0,0 +1,64 @@
+const RESIZE_SHIELD_ATTRIBUTE = 'data-prts-resize-shield'
+const DEFAULT_SETTLE_DELAY = 180
+
+export function createResizeShieldAdapter({
+  window,
+  settleDelay = DEFAULT_SETTLE_DELAY,
+} = {}) {
+  let targets = []
+  let settleTimer
+  let started = false
+
+  function setActive(active) {
+    for (const node of targets) {
+      if (!node || node.hasAttribute?.(RESIZE_SHIELD_ATTRIBUTE) === active) continue
+      node.toggleAttribute?.(RESIZE_SHIELD_ATTRIBUTE, active)
+    }
+  }
+
+  function clearTimer() {
+    if (settleTimer === undefined) return
+    window?.clearTimeout?.(settleTimer)
+    settleTimer = undefined
+  }
+
+  function settle() {
+    settleTimer = undefined
+    setActive(false)
+  }
+
+  function onResize() {
+    if (!started) return
+    setActive(true)
+    clearTimer()
+    settleTimer = window?.setTimeout?.(settle, settleDelay)
+  }
+
+  function dispose() {
+    clearTimer()
+    window?.removeEventListener?.('resize', onResize)
+    setActive(false)
+    targets = []
+    started = false
+  }
+
+  return {
+    start(nextTargets = []) {
+      const resolved = [...new Set(nextTargets)].filter(Boolean)
+      if (!window || !resolved.length) {
+        dispose()
+        return false
+      }
+      if (started) {
+        clearTimer()
+        setActive(false)
+        window.removeEventListener?.('resize', onResize)
+      }
+      targets = resolved
+      started = true
+      window.addEventListener?.('resize', onResize, { passive: true })
+      return true
+    },
+    dispose,
+  }
+}

package/src/client/settings-page.js

@@ -0,0 +1,62 @@
+export function createSettingsPage(React, meta = {}) {
+  const h = React.createElement
+
+  return function PrtsPluginSettingsPage({ useStore, updatePreference }) {
+    const { preferences } = useStore(state => ({ preferences: state.preferences }))
+    const safeMode = Boolean(meta.safeMode)
+    const enabled = Boolean(preferences.enabled) && !safeMode
+    const bootAnimation = preferences.bootAnimation !== false
+
+    const settingRow = ({ key, title, description, checked, disabled = false, onChange }) => h('div', {
+      className: 'prts-plugin-settings__row',
+      key,
+      'data-prts-plugin-setting': key,
+    },
+    h('span', { className: 'prts-plugin-settings__copy' },
+      h('strong', null, title),
+      h('small', null, description),
+    ),
+    h('button', {
+      type: 'button',
+      role: 'switch',
+      className: checked ? 'is-active' : '',
+      'aria-label': title,
+      'aria-checked': String(checked),
+      disabled,
+      onClick: onChange,
+    }, h('span', { 'aria-hidden': true })),
+    )
+
+    return h('section', {
+      className: 'prts-plugin-settings',
+      'data-prts-plugin-settings': '',
+      'data-prts-settings-enabled': String(enabled),
+      'aria-label': 'P.R.T.S. 插件设置',
+    },
+    h('header', { className: 'prts-plugin-settings__header' },
+      h('h3', null, 'P.R.T.S.'),
+      h('p', null, '完整外观设置位于主界面左上角的罗德岛徽记。'),
+    ),
+    safeMode && h('p', { className: 'prts-plugin-settings__safe', role: 'status' },
+      '安全模式已暂停主题。移除地址中的 ?prts-safe=1 后即可恢复。',
+    ),
+    h('div', { className: 'prts-plugin-settings__list' },
+      settingRow({
+        key: 'enabled',
+        title: '启用 P.R.T.S. 主题',
+        description: safeMode ? '安全模式下无法启用主题' : '控制 P.R.T.S. 外观是否加载',
+        checked: enabled,
+        disabled: safeMode,
+        onChange: () => { if (!safeMode) updatePreference('enabled', !preferences.enabled) },
+      }),
+      settingRow({
+        key: 'bootAnimation',
+        title: '播放启动动画',
+        description: '刷新或启用主题时显示 P.R.T.S. 启动动画',
+        checked: bootAnimation,
+        onChange: () => updatePreference('bootAnimation', !bootAnimation),
+      }),
+    ),
+    )
+  }
+}