Files
immich-magic-proxy/app/src/client/state.ts
T

107 lines
4.1 KiB
TypeScript

// Shared mutable state for the client gallery. Every module that touches
// gallery-wide state goes through `state` rather than holding its own
// top-level `let`s. Layout / scroll-tuning constants live here too because
// they are read by multiple modules. SVG icon strings live in `icons.ts`.
import type { CommentsConfig, GalleryItem, LightboxConfig, MetadataConfig, GroupByDateMode } from '../shared/types.js'
// ----- layout / scroll tuning ----------------------------------------------
// Justified-rows target row height (matches Immich's main view)
export const TARGET_ROW_HEIGHT = 235
export const GAP = 4
export const MOBILE_BREAKPOINT = 640
export const MOBILE_COLS = 3
export const IMAGE_LOAD_MARGIN_PX = 300
export const SCROLL_SETTLE_MS = 100
export const BUFFER_VIEWPORTS = 1
// Cap on state.stickyTiles: dozens of screens of scroll-back, bounded DOM
export const STICKY_TILE_LIMIT = 1500
// Height reserved for each month header (must agree with .group-header CSS)
export const HEADER_HEIGHT = 48
// Vertical gap between groups
export const GROUP_GAP = 16
// Long-press threshold for entering select mode via touch/mouse
export const LONG_PRESS_MS = 500
// localStorage key for sidebar open state
export const SIDEBAR_STORAGE_KEY = 'ipp-sidebar-open'
// Width of the sidebar when docked (must match the CSS rule)
export const SIDEBAR_WIDTH = 360
// Height of the sidebar as a bottom sheet, as a fraction of the viewport (must match the CSS 60vh)
export const SIDEBAR_SHEET_FRACTION = 0.6
// ----- mutable state -------------------------------------------------------
export interface LayoutEntry {
index: number
left: number
top: number
width: number
height: number
}
export interface HeaderEntry {
label: string
top: number
height: number
}
export interface GroupSpec {
label: string | null
indices: number[]
}
// PhotoSwipeLightbox is an external module with no TS types in this project.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
type PhotoSwipeLightboxInstance = any
export const state = {
items: [] as GalleryItem[],
layout: [] as LayoutEntry[],
headers: [] as HeaderEntry[],
groupByDate: false as GroupByDateMode | false,
container: null as HTMLElement | null,
lightbox: null as PhotoSwipeLightboxInstance,
lightboxConfig: {} as Partial<LightboxConfig>,
metadataConfig: {
descriptionInCaption: false,
descriptionInSidebar: false,
sidebarHasContent: false,
locationWebLink: false
} as MetadataConfig,
// True while our pushed history entry is live
lightboxPushedHistory: false,
// Guards against re-entering the popstate handler during our own history.back()
closingFromHistory: false,
lastContainerW: 0,
renderedTiles: new Map<number, HTMLAnchorElement>(),
renderedHeaders: new Map<string, HTMLElement>(),
/*
Indices of tiles whose <img> has loaded. virtualize() never removes these,
so scrolling back reuses the mounted <img>: no placeholder flicker and no
re-fetch (password-protected shares serve thumbnails `no-store`). Ordered
most-recently-visible last and trimmed to STICKY_TILE_LIMIT from the head.
*/
stickyTiles: new Set<number>(),
// Selection mode (mode-toggle UX: hidden checkmarks until activated)
selectMode: false,
selected: new Set<string>(),
toolbarEl: null as HTMLElement | null,
countEl: null as HTMLElement | null,
selectAllBtn: null as HTMLButtonElement | null,
cancelBtn: null as HTMLButtonElement | null,
downloadBtn: null as HTMLButtonElement | null,
// Info sidebar open/closed. Persisted to localStorage so the choice
// survives navigation between slides and gallery reloads.
sidebarOpen: false,
// Base URL (`/share/meta/<key>`) for the on-demand per-asset metadata route.
metaBase: '',
// Comments API and per-photo counts; null when commenting isn't available
comments: null as CommentsConfig | null,
// Re-render callbacks registered by lightbox UI elements (sidebar, caption,
// download button). Each re-renders for the current slide. Invoked after a
// lazy item's detail arrives so the just-opened slide reflects it.
slideRefreshers: [] as Array<() => void>
}