Redesign 3D gallery as single hall per artist with exit navigation.

Restore React client source, add hall-to-hall navigation via painting influences grouped by movement, and update documentation.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Danila Khodjaef
2026-06-19 10:10:13 +03:00
co-authored by Cursor
parent 44d3d4359a
commit 08f99d7a29
25 changed files with 2954 additions and 218 deletions
+7
View File
@@ -0,0 +1,7 @@
<svg xmlns="http://www.w3.org/2000/svg" width="300" height="240" viewBox="0 0 300 240">
<rect width="300" height="240" fill="#4a3728"/>
<rect x="20" y="20" width="260" height="180" fill="#5c4a3a" stroke="#8B6914" stroke-width="4"/>
<path d="M60 160 L100 80 L140 140 L180 60 L240 160" fill="none" stroke="#8B7355" stroke-width="2"/>
<circle cx="150" cy="100" r="20" fill="#6b5a4a"/>
<text x="150" y="220" text-anchor="middle" fill="#8B7355" font-size="12" font-family="serif">Artwork</text>
</svg>

After

Width:  |  Height:  |  Size: 507 B

+6
View File
@@ -0,0 +1,6 @@
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="200" viewBox="0 0 200 200">
<rect width="200" height="200" fill="#3d2b1f"/>
<circle cx="100" cy="80" r="40" fill="#5c4a3a"/>
<ellipse cx="100" cy="170" rx="55" ry="35" fill="#5c4a3a"/>
<text x="100" y="195" text-anchor="middle" fill="#8B7355" font-size="10" font-family="serif">Portrait</text>
</svg>

After

Width:  |  Height:  |  Size: 369 B

+3 -117
View File
@@ -1,122 +1,8 @@
import { useState } from 'react'
import reactLogo from './assets/react.svg'
import viteLogo from './assets/vite.svg'
import heroImg from './assets/hero.png'
import './App.css'
import HomePage from './pages/HomePage'
import './index.css'
function App() {
const [count, setCount] = useState(0)
return (
<>
<section id="center">
<div className="hero">
<img src={heroImg} className="base" width="170" height="179" alt="" />
<img src={reactLogo} className="framework" alt="React logo" />
<img src={viteLogo} className="vite" alt="Vite logo" />
</div>
<div>
<h1>Get started</h1>
<p>
Edit <code>src/App.tsx</code> and save to test <code>HMR</code>
</p>
</div>
<button
type="button"
className="counter"
onClick={() => setCount((count) => count + 1)}
>
Count is {count}
</button>
</section>
<div className="ticks"></div>
<section id="next-steps">
<div id="docs">
<svg className="icon" role="presentation" aria-hidden="true">
<use href="/icons.svg#documentation-icon"></use>
</svg>
<h2>Documentation</h2>
<p>Your questions, answered</p>
<ul>
<li>
<a href="https://vite.dev/" target="_blank">
<img className="logo" src={viteLogo} alt="" />
Explore Vite
</a>
</li>
<li>
<a href="https://react.dev/" target="_blank">
<img className="button-icon" src={reactLogo} alt="" />
Learn more
</a>
</li>
</ul>
</div>
<div id="social">
<svg className="icon" role="presentation" aria-hidden="true">
<use href="/icons.svg#social-icon"></use>
</svg>
<h2>Connect with us</h2>
<p>Join the Vite community</p>
<ul>
<li>
<a href="https://github.com/vitejs/vite" target="_blank">
<svg
className="button-icon"
role="presentation"
aria-hidden="true"
>
<use href="/icons.svg#github-icon"></use>
</svg>
GitHub
</a>
</li>
<li>
<a href="https://chat.vite.dev/" target="_blank">
<svg
className="button-icon"
role="presentation"
aria-hidden="true"
>
<use href="/icons.svg#discord-icon"></use>
</svg>
Discord
</a>
</li>
<li>
<a href="https://x.com/vite_js" target="_blank">
<svg
className="button-icon"
role="presentation"
aria-hidden="true"
>
<use href="/icons.svg#x-icon"></use>
</svg>
X.com
</a>
</li>
<li>
<a href="https://bsky.app/profile/vite.dev" target="_blank">
<svg
className="button-icon"
role="presentation"
aria-hidden="true"
>
<use href="/icons.svg#bluesky-icon"></use>
</svg>
Bluesky
</a>
</li>
</ul>
</div>
</section>
<div className="ticks"></div>
<section id="spacer"></section>
</>
)
return <HomePage />
}
export default App
+69
View File
@@ -0,0 +1,69 @@
import type {
TimelineData,
YearBounds,
Artist,
ArtistDetail,
PaintingDetail,
ArtistNavigation,
} from '../types';
const API = '/api';
async function fetchJson<T>(url: string): Promise<T> {
const res = await fetch(url);
if (!res.ok) throw new Error(`API error: ${res.status}`);
return res.json();
}
export function imageUrl(path: string | null | undefined): string {
if (!path) return '/placeholder-art.svg';
return `/images/${path}`;
}
/** Image for 3D gallery — local cached files only (API fetch is too slow for realtime 3D) */
export function galleryImageUrl(painting: {
thumbnail_path?: string | null;
image_path?: string | null;
}): string | null {
if (painting.thumbnail_path) return `/images/${painting.thumbnail_path}`;
if (painting.image_path) return `/images/${painting.image_path}`;
return null;
}
export function paintingImageUrl(painting: {
id: number;
image_path?: string | null;
thumbnail_path?: string | null;
}): string {
if (painting.image_path) return `/images/${painting.image_path}`;
if (painting.thumbnail_path) return `/images/${painting.thumbnail_path}`;
return `/api/paintings/${painting.id}/image?size=full`;
}
export async function preloadArtistImages(artistId: number): Promise<{ fetched: number; total: number }> {
const res = await fetch(`${API}/artists/${artistId}/preload-images`, { method: 'POST' });
if (!res.ok) throw new Error('Preload failed');
return res.json();
}
export const api = {
getBounds: () => fetchJson<YearBounds>(`${API}/bounds`),
getTimeline: (start: number, end: number) =>
fetchJson<TimelineData>(`${API}/timeline?start=${start}&end=${end}`),
getArtists: (start?: number, end?: number, movementId?: number) => {
const params = new URLSearchParams();
if (start != null) params.set('start', String(start));
if (end != null) params.set('end', String(end));
if (movementId != null) params.set('movement_id', String(movementId));
return fetchJson<Artist[]>(`${API}/artists?${params}`);
},
getArtist: (id: number) => fetchJson<ArtistDetail>(`${API}/artists/${id}`),
getArtistNavigation: (id: number) =>
fetchJson<ArtistNavigation>(`${API}/artists/${id}/navigation`),
getPainting: (id: number) => fetchJson<PaintingDetail>(`${API}/paintings/${id}`),
};
+121
View File
@@ -0,0 +1,121 @@
.artist-bio {
min-height: 100vh;
background: linear-gradient(180deg, #1a1a2e 0%, #16213e 100%);
color: #e8d5b5;
}
.bio-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 16px 24px;
border-bottom: 2px solid #c9a96e;
}
.bio-header h1 {
font-family: 'Georgia', serif;
font-size: 28px;
margin: 0;
color: #e8d5b5;
}
.back-btn,
.gallery-btn {
padding: 8px 16px;
border: 1px solid #c9a96e;
background: rgba(201, 169, 110, 0.15);
color: #e8d5b5;
border-radius: 4px;
cursor: pointer;
font-family: 'Georgia', serif;
font-size: 14px;
transition: background 0.2s;
}
.back-btn:hover,
.gallery-btn:hover {
background: rgba(201, 169, 110, 0.35);
}
.bio-content {
display: flex;
gap: 40px;
max-width: 900px;
margin: 40px auto;
padding: 0 24px;
}
.bio-portrait {
flex-shrink: 0;
}
.bio-portrait img {
width: 240px;
height: 300px;
object-fit: cover;
border: 4px solid #c9a96e;
border-radius: 4px;
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
}
.bio-text {
flex: 1;
}
.bio-meta {
display: flex;
gap: 16px;
margin-bottom: 16px;
}
.bio-lifespan {
color: #c9a96e;
font-family: 'Georgia', serif;
font-size: 16px;
}
.bio-movement {
padding: 2px 10px;
background: rgba(201, 169, 110, 0.15);
border: 1px solid rgba(201, 169, 110, 0.3);
border-radius: 12px;
font-size: 13px;
color: #c9a96e;
}
.bio-summary {
font-family: 'Georgia', serif;
font-size: 18px;
line-height: 1.6;
color: #e8d5b5;
font-style: italic;
margin-bottom: 20px;
}
.bio-full p {
font-family: 'Georgia', serif;
font-size: 15px;
line-height: 1.7;
color: rgba(232, 213, 181, 0.85);
margin-bottom: 12px;
}
.bio-empty {
color: rgba(232, 213, 181, 0.5);
font-style: italic;
}
.bio-source {
margin-top: 24px;
font-size: 12px;
color: rgba(201, 169, 110, 0.5);
border-top: 1px solid rgba(201, 169, 110, 0.2);
padding-top: 12px;
}
@media (max-width: 768px) {
.bio-content {
flex-direction: column;
align-items: center;
}
}
+71
View File
@@ -0,0 +1,71 @@
import type { Artist } from '../types';
import { imageUrl } from '../api/client';
import './ArtistBio.css';
interface Props {
artist: Artist & { movement_name?: string };
onBack: () => void;
onEnterGallery: () => void;
}
export default function ArtistBio({ artist, onBack, onEnterGallery }: Props) {
const lifespan =
artist.birth_year && artist.death_year
? `${artist.birth_year} ${artist.death_year}`
: artist.birth_year
? `b. ${artist.birth_year}`
: '';
return (
<div className="artist-bio">
<header className="bio-header">
<button className="back-btn" onClick={onBack}> Back</button>
<h1>{artist.name}</h1>
<button className="gallery-btn" onClick={onEnterGallery}>Enter Gallery</button>
</header>
<div className="bio-content">
<div className="bio-portrait">
<img
src={imageUrl(artist.portrait_path)}
alt={artist.name}
onError={(e) => {
(e.target as HTMLImageElement).src = '/placeholder-portrait.svg';
}}
/>
</div>
<div className="bio-text">
<div className="bio-meta">
{lifespan && <span className="bio-lifespan">{lifespan}</span>}
{artist.movement_name && (
<span className="bio-movement">{artist.movement_name}</span>
)}
</div>
{artist.bio_short && (
<p className="bio-summary">{artist.bio_short}</p>
)}
{artist.bio_full && (
<div className="bio-full">
{artist.bio_full.split('\n').map((para, i) => (
<p key={i}>{para}</p>
))}
</div>
)}
{!artist.bio_full && !artist.bio_short && (
<p className="bio-empty">Biographical information not yet available.</p>
)}
{artist.wikipedia_title && (
<p className="bio-source">
Information sourced from Wikipedia article: {artist.wikipedia_title}
</p>
)}
</div>
</div>
</div>
);
}
+118
View File
@@ -0,0 +1,118 @@
.movements-container {
padding: 16px;
display: flex;
flex-direction: column;
gap: 4px;
}
.movements-empty {
padding: 48px;
text-align: center;
color: rgba(201, 169, 110, 0.6);
font-family: 'Georgia', serif;
}
.movement-row {
display: flex;
align-items: stretch;
min-height: 90px;
}
.movement-label {
width: 160px;
flex-shrink: 0;
display: flex;
flex-direction: column;
justify-content: center;
padding-right: 12px;
text-align: right;
}
.movement-name {
font-family: 'Georgia', serif;
font-size: 13px;
font-weight: 600;
color: #e8d5b5;
}
.movement-era {
font-size: 10px;
color: rgba(201, 169, 110, 0.5);
margin-top: 2px;
}
.movement-band-track {
flex: 1;
position: relative;
min-height: 80px;
background: rgba(0, 0, 0, 0.2);
border-radius: 4px;
border: 1px solid rgba(201, 169, 110, 0.1);
}
.movement-band {
position: absolute;
top: 4px;
bottom: 4px;
border-radius: 3px;
min-width: 40px;
}
.artist-portrait {
position: absolute;
top: 50%;
transform: translate(-50%, -50%);
background: none;
border: 2px solid rgba(201, 169, 110, 0.6);
border-radius: 50%;
width: 56px;
height: 56px;
padding: 0;
cursor: pointer;
overflow: visible;
transition: transform 0.2s, border-color 0.2s, box-shadow 0.2s;
z-index: 2;
}
.artist-portrait:hover {
transform: translate(-50%, -50%) scale(1.15);
border-color: #c9a96e;
box-shadow: 0 4px 16px rgba(201, 169, 110, 0.4);
z-index: 10;
}
.artist-portrait img {
width: 100%;
height: 100%;
object-fit: cover;
border-radius: 50%;
}
.artist-portrait .artist-name {
position: absolute;
top: 100%;
left: 50%;
transform: translateX(-50%);
white-space: nowrap;
font-size: 10px;
color: #e8d5b5;
margin-top: 4px;
opacity: 0;
transition: opacity 0.2s;
pointer-events: none;
text-shadow: 0 1px 3px rgba(0, 0, 0, 0.9);
}
.artist-portrait:hover .artist-name {
opacity: 1;
}
@media (max-width: 768px) {
.movement-label {
width: 100px;
}
.artist-portrait {
width: 44px;
height: 44px;
}
}
+119
View File
@@ -0,0 +1,119 @@
import type { ArtMovement, Artist } from '../types';
import { imageUrl } from '../api/client';
import './MovementBands.css';
interface Props {
movements: ArtMovement[];
artists: Artist[];
viewStart: number;
viewEnd: number;
onArtistClick: (artistId: number) => void;
}
function yearToPercent(year: number, start: number, end: number): number {
return ((year - start) / (end - start)) * 100;
}
function artistInView(artist: Artist, viewStart: number, viewEnd: number): boolean {
const birth = artist.birth_year ?? viewStart;
const death = artist.death_year ?? viewEnd;
return death >= viewStart && birth <= viewEnd;
}
function artistTimelineYear(artist: Artist): number {
if (artist.birth_year && artist.death_year) {
return Math.round((artist.birth_year + artist.death_year) / 2);
}
return artist.birth_year ?? artist.death_year ?? 0;
}
export default function MovementBands({ movements, artists, viewStart, viewEnd, onArtistClick }: Props) {
const artistsByMovement = new Map<number, Artist[]>();
for (const artist of artists) {
if (!artist.movement_id || !artistInView(artist, viewStart, viewEnd)) continue;
const list = artistsByMovement.get(artist.movement_id) || [];
list.push(artist);
artistsByMovement.set(artist.movement_id, list);
}
const visibleMovements = movements.filter(
(m) => m.end_year >= viewStart && m.start_year <= viewEnd && (artistsByMovement.get(m.id)?.length ?? 0) > 0
);
if (visibleMovements.length === 0) {
return (
<div className="movements-empty">
<p>No art movements in this time range. Zoom out to explore more periods.</p>
</div>
);
}
return (
<div className="movements-container">
{visibleMovements.map((movement) => {
const left = yearToPercent(Math.max(movement.start_year, viewStart), viewStart, viewEnd);
const right = yearToPercent(Math.min(movement.end_year, viewEnd), viewStart, viewEnd);
const width = right - left;
if (width <= 0) return null;
const movementArtists = artistsByMovement.get(movement.id) || [];
return (
<div key={movement.id} className="movement-row">
<div className="movement-label">
<span className="movement-name">{movement.name}</span>
{movement.era_name && <span className="movement-era">{movement.era_name}</span>}
</div>
<div className="movement-band-track">
<div
className="movement-band"
style={{
left: `${left}%`,
width: `${width}%`,
borderLeft: movement.start_definite
? `3px solid ${movement.color}`
: 'none',
borderRight: movement.end_definite
? `3px solid ${movement.color}`
: 'none',
background: `linear-gradient(90deg,
${movement.start_definite ? movement.color : 'transparent'} 0%,
${movement.color}33 10%,
${movement.color}33 90%,
${movement.end_definite ? movement.color : 'transparent'} 100%)`,
}}
>
{movementArtists.map((artist) => {
const timelineYear = artistTimelineYear(artist);
const artistLeft = yearToPercent(timelineYear, viewStart, viewEnd);
if (artistLeft < left || artistLeft > right) return null;
const relLeft = ((artistLeft - left) / width) * 100;
return (
<button
key={artist.id}
className="artist-portrait"
style={{ left: `${relLeft}%` }}
onClick={() => onArtistClick(artist.id)}
title={`${artist.name} (${artist.birth_year}${artist.death_year})`}
>
<img
src={imageUrl(artist.portrait_path)}
alt={artist.name}
onError={(e) => {
(e.target as HTMLImageElement).src = '/placeholder-portrait.svg';
}}
/>
<span className="artist-name">{artist.name}</span>
</button>
);
})}
</div>
</div>
</div>
);
})}
</div>
);
}
+314
View File
@@ -0,0 +1,314 @@
.painting-detail {
min-height: 100vh;
background: linear-gradient(180deg, #1a1a2e 0%, #0f0f1a 100%);
color: #e8d5b5;
}
.painting-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 16px 24px;
border-bottom: 2px solid #c9a96e;
background: rgba(26, 26, 46, 0.95);
position: sticky;
top: 0;
z-index: 50;
}
.painting-title-block h1 {
font-family: 'Georgia', serif;
font-size: 24px;
margin: 0;
color: #e8d5b5;
}
.painting-meta {
margin: 4px 0 0;
color: #c9a96e;
font-size: 14px;
}
.back-btn,
.bio-btn {
padding: 8px 16px;
border: 1px solid #c9a96e;
background: rgba(201, 169, 110, 0.15);
color: #e8d5b5;
border-radius: 4px;
cursor: pointer;
font-family: 'Georgia', serif;
font-size: 14px;
white-space: nowrap;
transition: background 0.2s;
}
.back-btn:hover,
.bio-btn:hover {
background: rgba(201, 169, 110, 0.35);
}
.painting-layout {
display: grid;
grid-template-columns: minmax(300px, 360px) 1fr minmax(300px, 360px);
gap: 0;
min-height: calc(100vh - 80px);
}
.influence-panel {
padding: 20px 16px;
overflow-y: auto;
max-height: calc(100vh - 80px);
}
.influence-left,
.influence-right {
min-width: 300px;
max-width: 360px;
}
.influence-left {
border-right: 1px solid rgba(201, 169, 110, 0.2);
background: rgba(0, 0, 0, 0.2);
}
.influence-right {
border-left: 1px solid rgba(201, 169, 110, 0.2);
background: rgba(0, 0, 0, 0.2);
}
.influence-panel h3 {
font-family: 'Georgia', serif;
color: #c9a96e;
font-size: 16px;
margin: 0 0 16px;
text-align: center;
border-bottom: 1px solid rgba(201, 169, 110, 0.3);
padding-bottom: 8px;
}
.no-influences {
font-size: 13px;
color: rgba(232, 213, 181, 0.5);
text-align: center;
font-style: italic;
}
.influence-list {
display: flex;
flex-direction: column;
gap: 16px;
}
.influence-card-expanded {
background: rgba(201, 169, 110, 0.08);
border: 1px solid rgba(201, 169, 110, 0.2);
border-radius: 8px;
overflow: hidden;
}
.influence-image-btn {
display: block;
width: 100%;
padding: 0;
border: none;
background: #2a1f15;
cursor: pointer;
}
.influence-image-btn img {
width: 100%;
height: 140px;
object-fit: cover;
display: block;
transition: opacity 0.2s;
}
.influence-image-btn:hover img {
opacity: 0.85;
}
.influence-body {
padding: 12px;
display: flex;
flex-direction: column;
gap: 8px;
}
.influence-title-btn {
background: none;
border: none;
padding: 0;
text-align: left;
cursor: pointer;
color: inherit;
}
.influence-title-btn:hover strong {
color: #c9a96e;
}
.influence-title-btn strong {
display: block;
font-size: 14px;
color: #e8d5b5;
transition: color 0.2s;
}
.influence-title-btn span {
font-size: 11px;
color: #c9a96e;
}
.influence-aspects {
display: flex;
flex-wrap: wrap;
gap: 4px;
}
.aspect-tag {
font-size: 10px;
padding: 2px 8px;
border-radius: 10px;
background: rgba(201, 169, 110, 0.15);
border: 1px solid rgba(201, 169, 110, 0.3);
color: #c9a96e;
text-transform: capitalize;
}
.influence-notes {
font-size: 12px;
color: rgba(232, 213, 181, 0.8);
margin: 0;
line-height: 1.55;
}
.influence-quote {
margin: 0;
padding: 10px 12px;
border-left: 3px solid #c9a96e;
background: rgba(0, 0, 0, 0.2);
border-radius: 0 4px 4px 0;
}
.influence-quote p {
margin: 0 0 6px;
font-family: 'Georgia', serif;
font-size: 12px;
font-style: italic;
color: rgba(232, 213, 181, 0.9);
line-height: 1.5;
}
.influence-quote footer {
font-size: 11px;
color: rgba(201, 169, 110, 0.7);
}
.influence-quote cite {
font-style: normal;
}
.influence-source-link {
font-size: 11px;
color: #87b5d8;
text-decoration: none;
border-bottom: 1px dotted rgba(135, 181, 216, 0.4);
align-self: flex-start;
}
.influence-source-link:hover {
color: #a8d4f5;
border-bottom-color: #a8d4f5;
}
.influence-card {
display: flex;
gap: 10px;
padding: 8px;
background: rgba(201, 169, 110, 0.08);
border: 1px solid rgba(201, 169, 110, 0.2);
border-radius: 6px;
cursor: pointer;
text-align: left;
color: inherit;
transition: background 0.2s, border-color 0.2s;
}
.influence-card:hover {
background: rgba(201, 169, 110, 0.2);
border-color: #c9a96e;
}
.influence-card img {
width: 64px;
height: 64px;
object-fit: cover;
border-radius: 4px;
flex-shrink: 0;
}
.influence-info {
display: flex;
flex-direction: column;
gap: 2px;
min-width: 0;
}
.influence-info strong {
font-size: 13px;
color: #e8d5b5;
}
.influence-info span {
font-size: 11px;
color: #c9a96e;
}
.painting-center {
display: flex;
flex-direction: column;
align-items: center;
padding: 24px;
}
.painting-frame-large {
max-width: 700px;
width: 100%;
border: 8px solid #5c3d2e;
border-image: linear-gradient(135deg, #8B6914, #c9a96e, #8B6914) 1;
box-shadow: 0 8px 32px rgba(0, 0, 0, 0.5), inset 0 0 0 2px #c9a96e;
background: #2a1f15;
padding: 4px;
}
.painting-frame-large img {
width: 100%;
display: block;
}
.painting-description {
max-width: 700px;
margin-top: 20px;
padding: 16px;
background: rgba(201, 169, 110, 0.08);
border-radius: 6px;
border: 1px solid rgba(201, 169, 110, 0.15);
}
.painting-description p {
margin: 0;
font-family: 'Georgia', serif;
font-size: 14px;
line-height: 1.7;
color: rgba(232, 213, 181, 0.85);
}
@media (max-width: 1024px) {
.painting-layout {
grid-template-columns: 1fr;
}
.influence-panel {
max-height: none;
}
}
+149
View File
@@ -0,0 +1,149 @@
import type { PaintingDetail } from '../types';
import { paintingImageUrl } from '../api/client';
import './PaintingDetail.css';
interface Props {
data: PaintingDetail;
onBack: () => void;
onPaintingClick: (paintingId: number) => void;
onArtistBio: () => void;
}
function InfluenceCard({
inf,
onPaintingClick,
}: {
inf: PaintingDetail['influencedBy'][0];
onPaintingClick: (id: number) => void;
}) {
const aspects = inf.aspects
? inf.aspects.split(',').map((a) => a.trim()).filter(Boolean)
: [];
return (
<article className="influence-card-expanded">
<button
type="button"
className="influence-image-btn"
onClick={() => onPaintingClick(inf.id)}
title={`View ${inf.title}`}
>
<img
src={paintingImageUrl({ id: inf.id, image_path: inf.image_path })}
alt={inf.title}
onError={(e) => {
(e.target as HTMLImageElement).src = '/placeholder-art.svg';
}}
/>
</button>
<div className="influence-body">
<button type="button" className="influence-title-btn" onClick={() => onPaintingClick(inf.id)}>
<strong>{inf.title}</strong>
<span>{inf.artist_name}{inf.year ? `, ${inf.year}` : ''}</span>
</button>
{aspects.length > 0 && (
<div className="influence-aspects">
{aspects.map((aspect) => (
<span key={aspect} className="aspect-tag">{aspect}</span>
))}
</div>
)}
{inf.notes && <p className="influence-notes">{inf.notes}</p>}
{inf.quote && (
<blockquote className="influence-quote">
<p>&ldquo;{inf.quote}&rdquo;</p>
{(inf.source_author || inf.source) && (
<footer>
{inf.source_author}
{inf.source && <cite>, {inf.source}</cite>}
</footer>
)}
</blockquote>
)}
{inf.source_url && (
<a
className="influence-source-link"
href={inf.source_url}
target="_blank"
rel="noopener noreferrer"
onClick={(e) => e.stopPropagation()}
>
Read source: {inf.source_author || inf.source || 'Reference'}
</a>
)}
</div>
</article>
);
}
export default function PaintingDetailView({ data, onBack, onPaintingClick, onArtistBio }: Props) {
const { painting, influencedBy, influenced } = data;
return (
<div className="painting-detail">
<header className="painting-header">
<button className="back-btn" onClick={onBack}> Back to Gallery</button>
<div className="painting-title-block">
<h1>{painting.title}</h1>
<p className="painting-meta">
{painting.artist_name}
{painting.year && ` · ${painting.year}`}
</p>
</div>
<button className="bio-btn" onClick={onArtistBio}>
About {painting.artist_name}
</button>
</header>
<div className="painting-layout">
<aside className="influence-panel influence-left">
<h3>Influenced By</h3>
{influencedBy.length === 0 ? (
<p className="no-influences">No documented influences for this work.</p>
) : (
<div className="influence-list">
{influencedBy.map((inf) => (
<InfluenceCard key={inf.id} inf={inf} onPaintingClick={onPaintingClick} />
))}
</div>
)}
</aside>
<main className="painting-center">
<div className="painting-frame-large">
<img
src={paintingImageUrl(painting)}
alt={painting.title}
onError={(e) => {
(e.target as HTMLImageElement).src = '/placeholder-art.svg';
}}
/>
</div>
{painting.description && (
<div className="painting-description">
<p>{painting.description}</p>
</div>
)}
</main>
<aside className="influence-panel influence-right">
<h3>Influenced</h3>
{influenced.length === 0 ? (
<p className="no-influences">No documented works influenced by this painting yet.</p>
) : (
<div className="influence-list">
{influenced.map((inf) => (
<InfluenceCard key={inf.id} inf={inf} onPaintingClick={onPaintingClick} />
))}
</div>
)}
</aside>
</div>
</div>
);
}
+129
View File
@@ -0,0 +1,129 @@
.timeline-wrapper {
background: linear-gradient(180deg, #1a1a2e 0%, #16213e 100%);
border-bottom: 2px solid #c9a96e;
padding: 12px 16px 8px;
position: sticky;
top: 0;
z-index: 100;
}
.timeline-controls {
display: flex;
align-items: center;
gap: 8px;
margin-bottom: 8px;
}
.timeline-controls button {
width: 32px;
height: 32px;
border: 1px solid #c9a96e;
background: rgba(201, 169, 110, 0.15);
color: #e8d5b5;
border-radius: 4px;
cursor: pointer;
font-size: 18px;
line-height: 1;
transition: background 0.2s;
}
.timeline-controls button:hover {
background: rgba(201, 169, 110, 0.35);
}
.timeline-range {
margin-left: 12px;
color: #c9a96e;
font-family: 'Georgia', serif;
font-size: 14px;
letter-spacing: 0.5px;
}
.timeline-container {
position: relative;
height: 72px;
cursor: grab;
user-select: none;
border: 1px solid rgba(201, 169, 110, 0.3);
border-radius: 4px;
overflow: hidden;
}
.timeline-container:active {
cursor: grabbing;
}
.timeline-track {
position: absolute;
inset: 0;
display: flex;
}
.era-block {
position: absolute;
top: 0;
bottom: 0;
display: flex;
align-items: center;
justify-content: center;
overflow: hidden;
}
.era-label {
color: rgba(255, 255, 255, 0.85);
font-family: 'Georgia', serif;
font-size: 13px;
font-weight: 600;
text-shadow: 0 1px 3px rgba(0, 0, 0, 0.8);
white-space: nowrap;
pointer-events: none;
}
.timeline-ticks {
position: absolute;
bottom: 0;
left: 0;
right: 0;
height: 24px;
}
.tick {
position: absolute;
bottom: 0;
transform: translateX(-50%);
border-left: 1px solid rgba(201, 169, 110, 0.4);
height: 8px;
}
.tick span {
position: absolute;
bottom: 10px;
left: 50%;
transform: translateX(-50%);
font-size: 10px;
color: rgba(201, 169, 110, 0.7);
white-space: nowrap;
}
.brush-handle {
position: absolute;
top: 0;
bottom: 0;
width: 6px;
transform: translateX(-50%);
cursor: ew-resize;
background: rgba(201, 169, 110, 0.5);
opacity: 0;
transition: opacity 0.2s;
}
.timeline-container:hover .brush-handle {
opacity: 1;
}
.timeline-hint {
margin: 6px 0 0;
font-size: 11px;
color: rgba(201, 169, 110, 0.5);
text-align: center;
}
+192
View File
@@ -0,0 +1,192 @@
import { useRef, useState, useCallback, useEffect } from 'react';
import type { HistoricalEra } from '../types';
import './Timeline.css';
interface Props {
eras: HistoricalEra[];
viewStart: number;
viewEnd: number;
onViewChange: (start: number, end: number) => void;
absoluteMin: number;
absoluteMax: number;
}
function yearToPercent(year: number, start: number, end: number): number {
return ((year - start) / (end - start)) * 100;
}
function formatYear(year: number): string {
if (year < 0) return `${Math.abs(year)} BCE`;
return `${year} CE`;
}
export default function Timeline({ eras, viewStart, viewEnd, onViewChange, absoluteMin, absoluteMax }: Props) {
const containerRef = useRef<HTMLDivElement>(null);
const [dragging, setDragging] = useState<'left' | 'right' | 'pan' | null>(null);
const dragStart = useRef({ x: 0, viewStart: 0, viewEnd: 0 });
const span = viewEnd - viewStart;
const tickInterval = span > 500 ? 100 : span > 200 ? 50 : span > 50 ? 25 : span > 10 ? 5 : 1;
const ticks: number[] = [];
const firstTick = Math.ceil(viewStart / tickInterval) * tickInterval;
for (let y = firstTick; y <= viewEnd; y += tickInterval) ticks.push(y);
const handleWheel = useCallback(
(e: React.WheelEvent) => {
e.preventDefault();
const rect = containerRef.current?.getBoundingClientRect();
if (!rect) return;
const ratio = (e.clientX - rect.left) / rect.width;
const centerYear = viewStart + ratio * span;
const factor = e.deltaY > 0 ? 1.15 : 0.85;
const newSpan = Math.max(10, Math.min(absoluteMax - absoluteMin, span * factor));
let newStart = centerYear - ratio * newSpan;
let newEnd = centerYear + (1 - ratio) * newSpan;
if (newStart < absoluteMin) { newEnd += absoluteMin - newStart; newStart = absoluteMin; }
if (newEnd > absoluteMax) { newStart -= newEnd - absoluteMax; newEnd = absoluteMax; }
onViewChange(Math.round(newStart), Math.round(newEnd));
},
[viewStart, span, absoluteMin, absoluteMax, onViewChange]
);
const handleMouseDown = (e: React.MouseEvent, mode: 'left' | 'right' | 'pan') => {
e.preventDefault();
setDragging(mode);
dragStart.current = { x: e.clientX, viewStart, viewEnd };
};
useEffect(() => {
if (!dragging) return;
const onMove = (e: MouseEvent) => {
const rect = containerRef.current?.getBoundingClientRect();
if (!rect) return;
const dx = e.clientX - dragStart.current.x;
const yearDelta = (dx / rect.width) * span;
if (dragging === 'pan') {
let ns = dragStart.current.viewStart - yearDelta;
let ne = dragStart.current.viewEnd - yearDelta;
if (ns < absoluteMin) { ne += absoluteMin - ns; ns = absoluteMin; }
if (ne > absoluteMax) { ns -= ne - absoluteMax; ne = absoluteMax; }
onViewChange(Math.round(ns), Math.round(ne));
} else if (dragging === 'left') {
const ns = Math.min(dragStart.current.viewEnd - 10, dragStart.current.viewStart + yearDelta);
onViewChange(Math.round(ns), viewEnd);
} else {
const ne = Math.max(dragStart.current.viewStart + 10, dragStart.current.viewEnd + yearDelta);
onViewChange(viewStart, Math.round(ne));
}
};
const onUp = () => setDragging(null);
window.addEventListener('mousemove', onMove);
window.addEventListener('mouseup', onUp);
return () => { window.removeEventListener('mousemove', onMove); window.removeEventListener('mouseup', onUp); };
}, [dragging, span, viewStart, viewEnd, absoluteMin, absoluteMax, onViewChange]);
const zoomIn = () => {
const center = (viewStart + viewEnd) / 2;
const newSpan = Math.max(10, span * 0.5);
onViewChange(Math.round(center - newSpan / 2), Math.round(center + newSpan / 2));
};
const zoomOut = () => {
const center = (viewStart + viewEnd) / 2;
const newSpan = Math.min(absoluteMax - absoluteMin, span * 2);
let ns = center - newSpan / 2;
let ne = center + newSpan / 2;
if (ns < absoluteMin) { ne += absoluteMin - ns; ns = absoluteMin; }
if (ne > absoluteMax) { ns -= ne - absoluteMax; ne = absoluteMax; }
onViewChange(Math.round(ns), Math.round(ne));
};
const resetView = () => onViewChange(absoluteMin, absoluteMax);
return (
<div className="timeline-wrapper">
<div className="timeline-controls">
<button onClick={zoomIn} title="Zoom in">+</button>
<button onClick={zoomOut} title="Zoom out"></button>
<button onClick={resetView} title="Reset view"></button>
<span className="timeline-range">
{formatYear(viewStart)} {formatYear(viewEnd)}
</span>
</div>
<div
ref={containerRef}
className="timeline-container"
onWheel={handleWheel}
onMouseDown={(e) => handleMouseDown(e, 'pan')}
>
<div className="timeline-track">
{eras.map((era) => {
const left = yearToPercent(Math.max(era.start_year, viewStart), viewStart, viewEnd);
const right = yearToPercent(Math.min(era.end_year, viewEnd), viewStart, viewEnd);
if (right <= 0 || left >= 100) return null;
return (
<div
key={era.id}
className="era-block"
style={{
left: `${Math.max(0, left)}%`,
width: `${Math.min(100, right) - Math.max(0, left)}%`,
borderLeft: era.start_definite ? '2px solid rgba(255,255,255,0.6)' : undefined,
borderRight: era.end_definite ? '2px solid rgba(255,255,255,0.6)' : undefined,
background: `linear-gradient(90deg,
${era.start_definite ? 'var(--era-color)' : 'transparent'} 0%,
var(--era-color) 15%,
var(--era-color) 85%,
${era.end_definite ? 'var(--era-color)' : 'transparent'} 100%)`,
['--era-color' as string]: getEraColor(era.name),
}}
title={era.description}
>
<span className="era-label">{era.name}</span>
</div>
);
})}
</div>
<div className="timeline-ticks">
{ticks.map((year) => (
<div
key={year}
className="tick"
style={{ left: `${yearToPercent(year, viewStart, viewEnd)}%` }}
>
<span>{formatYear(year)}</span>
</div>
))}
</div>
<div
className="brush-handle brush-left"
style={{ left: '0%' }}
onMouseDown={(e) => { e.stopPropagation(); handleMouseDown(e, 'left'); }}
/>
<div
className="brush-handle brush-right"
style={{ left: '100%' }}
onMouseDown={(e) => { e.stopPropagation(); handleMouseDown(e, 'right'); }}
/>
</div>
<p className="timeline-hint">
Scroll to zoom · Drag to pan · Use +/ buttons to zoom into a historical period
</p>
</div>
);
}
function getEraColor(name: string): string {
const colors: Record<string, string> = {
'Ancient': 'rgba(139,115,85,0.7)',
'Medieval': 'rgba(74,85,104,0.7)',
'Renaissance': 'rgba(184,134,11,0.7)',
'Baroque': 'rgba(139,0,0,0.6)',
'Neoclassicism & Romanticism': 'rgba(70,130,180,0.6)',
'Modern': 'rgba(100,100,120,0.6)',
'Contemporary': 'rgba(60,60,80,0.7)',
};
return colors[name] || 'rgba(100,100,100,0.5)';
}
+364
View File
@@ -0,0 +1,364 @@
.virtual-gallery {
display: flex;
flex-direction: column;
height: 100vh;
background: #1a1008;
}
.gallery-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 12px 20px;
background: linear-gradient(180deg, #2a1f15 0%, #1a1008 100%);
border-bottom: 2px solid #c9a96e;
}
.gallery-title-block {
flex: 1;
text-align: center;
min-width: 0;
}
.gallery-header h2 {
font-family: 'Georgia', serif;
color: #e8d5b5;
margin: 0;
font-size: 22px;
}
.gallery-career-path {
margin: 4px 0 0;
font-size: 12px;
color: rgba(201, 169, 110, 0.75);
font-family: 'Georgia', serif;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.gallery-header-meta {
display: flex;
align-items: center;
gap: 12px;
}
.gallery-work-count {
font-size: 13px;
color: rgba(232, 213, 181, 0.65);
font-family: 'Georgia', serif;
}
.gallery-back-btn,
.gallery-bio-btn {
padding: 8px 16px;
border: 1px solid #c9a96e;
background: rgba(201, 169, 110, 0.15);
color: #e8d5b5;
border-radius: 4px;
cursor: pointer;
font-family: 'Georgia', serif;
font-size: 14px;
transition: background 0.2s;
}
.gallery-back-btn:hover,
.gallery-bio-btn:hover {
background: rgba(201, 169, 110, 0.35);
}
.gallery-canvas-container {
flex: 1;
min-height: 0;
position: relative;
}
.gallery-loading-overlay {
position: absolute;
inset: 0;
z-index: 10;
display: flex;
align-items: center;
justify-content: center;
background: rgba(13, 9, 6, 0.85);
color: #e8d5b5;
font-family: Georgia, serif;
font-size: 16px;
}
.gallery-sync-badge {
inset: auto;
top: 12px;
right: 12px;
left: auto;
bottom: auto;
padding: 8px 14px;
border-radius: 6px;
background: rgba(13, 9, 6, 0.75);
border: 1px solid rgba(201, 169, 110, 0.35);
font-size: 13px;
pointer-events: none;
}
.gallery-controls {
display: flex;
gap: 24px;
padding: 12px 20px;
background: #2a1f15;
border-top: 1px solid rgba(201, 169, 110, 0.3);
}
.control-pad {
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
.control-pad button {
width: 44px;
height: 44px;
border: 1px solid #c9a96e;
background: rgba(201, 169, 110, 0.15);
color: #e8d5b5;
border-radius: 4px;
cursor: pointer;
font-size: 16px;
transition: background 0.2s;
}
.control-pad button:hover {
background: rgba(201, 169, 110, 0.35);
}
.control-row {
display: flex;
gap: 4px;
}
.gallery-instructions {
flex: 1;
}
.gallery-instructions h4 {
margin: 0 0 6px;
color: #c9a96e;
font-family: 'Georgia', serif;
font-size: 14px;
}
.gallery-instructions ul {
margin: 0;
padding: 0;
list-style: none;
display: flex;
flex-wrap: wrap;
gap: 8px 20px;
}
.gallery-instructions li {
font-size: 12px;
color: rgba(232, 213, 181, 0.7);
}
.gallery-instructions kbd {
display: inline-block;
padding: 1px 6px;
border: 1px solid rgba(201, 169, 110, 0.4);
border-radius: 3px;
background: rgba(0, 0, 0, 0.3);
font-size: 11px;
color: #c9a96e;
}
.gallery-exit-hint {
position: absolute;
bottom: 16px;
left: 50%;
transform: translateX(-50%);
z-index: 12;
padding: 10px 18px;
border-radius: 6px;
background: rgba(13, 9, 6, 0.82);
border: 1px solid rgba(212, 175, 55, 0.55);
color: #f5e6c8;
font-family: Georgia, serif;
font-size: 14px;
pointer-events: none;
}
.gallery-exit-hint kbd {
padding: 1px 6px;
border: 1px solid rgba(201, 169, 110, 0.5);
border-radius: 3px;
background: rgba(0, 0, 0, 0.35);
font-size: 12px;
}
.exit-nav-overlay {
position: fixed;
inset: 0;
z-index: 100;
display: flex;
align-items: center;
justify-content: center;
background: rgba(8, 5, 3, 0.72);
padding: 24px;
}
.exit-nav-panel {
width: min(960px, 100%);
max-height: min(85vh, 720px);
display: flex;
flex-direction: column;
background: linear-gradient(180deg, #2a1f15 0%, #1a1008 100%);
border: 2px solid #c9a96e;
border-radius: 8px;
box-shadow: 0 16px 48px rgba(0, 0, 0, 0.55);
overflow: hidden;
}
.exit-nav-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 16px 20px;
border-bottom: 1px solid rgba(201, 169, 110, 0.35);
}
.exit-nav-header h2 {
margin: 0;
font-family: Georgia, serif;
color: #e8d5b5;
font-size: 20px;
font-weight: normal;
}
.exit-nav-close {
width: 36px;
height: 36px;
border: 1px solid rgba(201, 169, 110, 0.45);
border-radius: 4px;
background: transparent;
color: #e8d5b5;
font-size: 22px;
line-height: 1;
cursor: pointer;
}
.exit-nav-close:hover {
background: rgba(201, 169, 110, 0.2);
}
.exit-nav-columns {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 0;
overflow: auto;
flex: 1;
min-height: 0;
}
.exit-nav-column {
padding: 16px 20px 24px;
overflow-y: auto;
}
.exit-nav-column:first-child {
border-right: 1px solid rgba(201, 169, 110, 0.25);
}
.exit-nav-column h3 {
margin: 0 0 14px;
font-family: Georgia, serif;
color: #c9a96e;
font-size: 16px;
font-weight: normal;
text-transform: uppercase;
letter-spacing: 0.06em;
}
.exit-nav-movement {
margin-bottom: 18px;
}
.exit-nav-movement h4 {
margin: 0 0 8px;
padding-left: 10px;
border-left: 3px solid #8b7355;
font-family: Georgia, serif;
color: #e8d5b5;
font-size: 14px;
font-weight: normal;
}
.exit-nav-movement ul {
list-style: none;
margin: 0;
padding: 0;
}
.exit-nav-movement li + li {
margin-top: 6px;
}
.exit-nav-movement button {
display: flex;
align-items: center;
gap: 10px;
width: 100%;
padding: 8px 10px;
border: 1px solid transparent;
border-radius: 4px;
background: rgba(0, 0, 0, 0.2);
color: #e8d5b5;
font-family: Georgia, serif;
font-size: 14px;
text-align: left;
cursor: pointer;
transition: background 0.15s, border-color 0.15s;
}
.exit-nav-movement button:hover {
background: rgba(201, 169, 110, 0.18);
border-color: rgba(201, 169, 110, 0.4);
}
.exit-nav-movement img {
width: 40px;
height: 40px;
border-radius: 50%;
object-fit: cover;
background: #3d2b1f;
flex-shrink: 0;
}
.exit-nav-movement span {
display: flex;
flex-direction: column;
gap: 2px;
}
.exit-nav-movement small {
font-size: 11px;
color: rgba(232, 213, 181, 0.6);
}
.exit-nav-empty,
.exit-nav-loading {
margin: 0;
font-size: 13px;
color: rgba(232, 213, 181, 0.55);
font-style: italic;
}
@media (max-width: 640px) {
.exit-nav-columns {
grid-template-columns: 1fr;
}
.exit-nav-column:first-child {
border-right: none;
border-bottom: 1px solid rgba(201, 169, 110, 0.25);
}
}
+803
View File
@@ -0,0 +1,803 @@
import { useRef, useState, useEffect, useMemo, Suspense, useCallback } from 'react';
import { Canvas, useFrame, useThree } from '@react-three/fiber';
import { Text, Environment } from '@react-three/drei';
import * as THREE from 'three';
import type {
ArtistDetail,
Painting,
ArtistPeriod,
ArtistNavigation,
MovementArtistGroup,
} from '../types';
import { galleryImageUrl, imageUrl, api, preloadArtistImages } from '../api/client';
import './VirtualGallery.css';
interface Props {
data: ArtistDetail;
onPaintingClick: (paintingId: number) => void;
onNavigateArtist: (artistId: number) => void;
onBack: () => void;
onBioClick: () => void;
}
const WALL_HEIGHT = 4.2;
const WALL_THICKNESS = 0.18;
const MOUNT_OFFSET = 0.06;
const EYE_HEIGHT = 1.65;
const HANG_HEIGHT = 1.55;
const FRAME_GAP = 0.18;
const MIN_FRAME_W = 0.45;
const MAX_FRAME_W = 1.05;
const MAX_FRAME_H = 1.35;
const MIN_HALL_SIZE = 9;
const MAX_FRAMES_PER_WALL = 10;
const DOOR_WIDTH = 2.4;
const DOOR_HEIGHT = 2.5;
type WallSide = 'back' | 'left' | 'right';
interface FrameSlot {
position: [number, number, number];
rotationY: number;
maxW: number;
maxH: number;
}
interface WallSegment {
side: WallSide;
label: string;
paintings: Painting[];
slots: FrameSlot[];
}
interface HallLayout {
width: number;
depth: number;
segments: WallSegment[];
}
function layoutRow(count: number, span: number) {
const gap = FRAME_GAP;
const padding = 1.4;
const available = span - padding;
let frameW = Math.min(MAX_FRAME_W, (available - (count - 1) * gap) / Math.max(count, 1));
frameW = Math.max(MIN_FRAME_W, frameW);
const frameH = Math.min(MAX_FRAME_H, frameW * 1.22);
const rowWidth = count * frameW + (count - 1) * gap;
const slots: { offset: number; maxW: number; maxH: number }[] = [];
for (let i = 0; i < count; i++) {
slots.push({
offset: -rowWidth / 2 + frameW / 2 + i * (frameW + gap),
maxW: frameW,
maxH: frameH,
});
}
return { slots, spanNeeded: Math.max(span, rowWidth + padding) };
}
function buildHallLayout(paintings: Painting[], periods: ArtistPeriod[]): HallLayout {
const byPeriod = new Map<number, Painting[]>();
for (const p of paintings) {
const key = p.period_id || 0;
const list = byPeriod.get(key) || [];
list.push(p);
byPeriod.set(key, list);
}
const periodGroups: { label: string; paintings: Painting[] }[] = [];
for (const period of periods) {
const list = byPeriod.get(period.id) || [];
if (list.length > 0) {
periodGroups.push({
label: period.name,
paintings: [...list].sort((a, b) => (a.year || 0) - (b.year || 0)),
});
}
}
const other = byPeriod.get(0) || [];
if (other.length > 0) {
periodGroups.push({
label: 'Other Works',
paintings: [...other].sort((a, b) => (a.year || 0) - (b.year || 0)),
});
}
if (periodGroups.length === 0 && paintings.length > 0) {
periodGroups.push({
label: 'Works',
paintings: [...paintings].sort((a, b) => (a.year || 0) - (b.year || 0)),
});
}
const walls: WallSide[] = ['back', 'left', 'right'];
const wallBuckets: { label: string; paintings: Painting[] }[][] = [[], [], []];
periodGroups.forEach((group, i) => {
wallBuckets[i % 3].push(group);
});
let width = MIN_HALL_SIZE;
let depth = MIN_HALL_SIZE;
const segments: WallSegment[] = [];
const addWallFrames = (side: WallSide, groups: { label: string; paintings: Painting[] }[]) => {
if (groups.length === 0) return;
const flat: Painting[] = [];
const labels: string[] = [];
for (const g of groups) {
for (const p of g.paintings) {
if (flat.length >= MAX_FRAMES_PER_WALL) break;
flat.push(p);
}
if (flat.length <= MAX_FRAMES_PER_WALL) labels.push(g.label);
}
const label = labels.join(' · ');
const span = side === 'back' ? width : depth;
const { spanNeeded } = layoutRow(flat.length, span);
if (side === 'back') depth = Math.max(depth, spanNeeded);
else width = Math.max(width, spanNeeded);
segments.push({ side, label, paintings: flat, slots: [] });
};
walls.forEach((side, i) => addWallFrames(side, wallBuckets[i]));
width = Math.max(width, MIN_HALL_SIZE);
depth = Math.max(depth, MIN_HALL_SIZE);
const halfW = width / 2;
const halfD = depth / 2;
const y = HANG_HEIGHT;
const inset = WALL_THICKNESS / 2 + MOUNT_OFFSET;
for (const seg of segments) {
const row = layoutRow(seg.paintings.length, seg.side === 'back' ? width : depth);
seg.slots = row.slots.map((s) => {
if (seg.side === 'back') {
return {
maxW: s.maxW,
maxH: s.maxH,
rotationY: 0,
position: [s.offset, y, -halfD + inset],
};
}
if (seg.side === 'left') {
return {
maxW: s.maxW,
maxH: s.maxH,
rotationY: Math.PI / 2,
position: [-halfW + inset, y, s.offset],
};
}
return {
maxW: s.maxW,
maxH: s.maxH,
rotationY: -Math.PI / 2,
position: [halfW - inset, y, s.offset],
};
});
}
return { width, depth, segments };
}
function computeFrameSize(aspect: number, maxW: number, maxH: number) {
let w = maxW;
let h = w / aspect;
if (h > maxH) {
h = maxH;
w = h * aspect;
}
return { width: w, height: h };
}
function usePaintingTexture(url: string | null) {
const [texture, setTexture] = useState<THREE.Texture | null>(null);
const [failed, setFailed] = useState(!url);
useEffect(() => {
if (!url) {
setTexture(null);
setFailed(true);
return;
}
setFailed(false);
let disposed = false;
let loaded: THREE.Texture | null = null;
const loader = new THREE.TextureLoader();
loader.setCrossOrigin('anonymous');
loader.load(
url,
(tex) => {
if (disposed) {
tex.dispose();
return;
}
loaded = tex;
tex.colorSpace = THREE.SRGBColorSpace;
tex.anisotropy = 4;
setTexture(tex);
},
undefined,
() => {
if (!disposed) setFailed(true);
}
);
return () => {
disposed = true;
loaded?.dispose();
setTexture(null);
};
}, [url]);
return { texture, failed };
}
function PaintingFrame({
painting,
position,
rotationY,
maxWidth,
maxHeight,
onClick,
}: {
painting: Painting;
position: [number, number, number];
rotationY: number;
maxWidth: number;
maxHeight: number;
onClick: () => void;
}) {
const [hovered, setHovered] = useState(false);
const [aspect, setAspect] = useState(1.33);
const { width, height } = computeFrameSize(aspect, maxWidth, maxHeight);
const frameDepth = 0.06;
const matBorder = 0.05;
const url = galleryImageUrl(painting);
const { texture, failed } = usePaintingTexture(url);
useEffect(() => {
const img = texture?.image as HTMLImageElement | undefined;
if (img?.width && img.height) {
setAspect(img.width / img.height);
}
}, [texture]);
return (
<group position={position} rotation={[0, rotationY, 0]}>
<spotLight
position={[0, height / 2 + 0.25, 0.3]}
angle={0.5}
penumbra={0.75}
intensity={hovered ? 2.6 : 1.9}
distance={4.5}
color="#fff8ee"
/>
<mesh
position={[0, 0, frameDepth / 2]}
castShadow
onClick={(e) => {
e.stopPropagation();
onClick();
}}
onPointerOver={() => setHovered(true)}
onPointerOut={() => setHovered(false)}
>
<boxGeometry args={[width + matBorder * 2 + 0.04, height + matBorder * 2 + 0.04, frameDepth]} />
<meshStandardMaterial color={hovered ? '#c9a227' : '#6b4f1d'} roughness={0.45} metalness={0.5} />
</mesh>
<mesh position={[0, 0, frameDepth + 0.002]}>
<boxGeometry args={[width + matBorder * 2, height + matBorder * 2, 0.008]} />
<meshStandardMaterial color="#f5f0e6" roughness={0.95} />
</mesh>
<mesh position={[0, 0, frameDepth + 0.006]} renderOrder={2}>
<planeGeometry args={[width, height]} />
<meshBasicMaterial
map={texture}
color={texture ? '#ffffff' : failed ? '#8a7355' : '#4a3828'}
toneMapped={false}
/>
</mesh>
</group>
);
}
function GalleryWall({
position,
size,
rotation = [0, 0, 0],
color = '#ebe4d8',
}: {
position: [number, number, number];
size: [number, number];
rotation?: [number, number, number];
color?: string;
}) {
const [w, h] = size;
return (
<mesh position={position} rotation={rotation} receiveShadow>
<boxGeometry args={[w, h, WALL_THICKNESS]} />
<meshStandardMaterial color={color} roughness={0.92} />
</mesh>
);
}
function ExitPortal({
position,
active,
onActivate,
}: {
position: [number, number, number];
active: boolean;
onActivate: () => void;
}) {
const [hovered, setHovered] = useState(false);
const glow = active || hovered;
return (
<group position={position}>
<mesh
position={[0, DOOR_HEIGHT / 2, 0]}
onClick={(e) => {
e.stopPropagation();
onActivate();
}}
onPointerOver={() => setHovered(true)}
onPointerOut={() => setHovered(false)}
>
<boxGeometry args={[DOOR_WIDTH, DOOR_HEIGHT, 0.12]} />
<meshStandardMaterial
color={glow ? '#d4af37' : '#8b6914'}
emissive={glow ? '#5a4010' : '#000000'}
emissiveIntensity={glow ? 0.45 : 0}
roughness={0.55}
metalness={0.35}
/>
</mesh>
<Text
position={[0, DOOR_HEIGHT + 0.25, 0.08]}
fontSize={0.22}
color={glow ? '#f5e6c8' : '#c9a96e'}
anchorX="center"
>
EXIT
</Text>
</group>
);
}
function ArtistHall({
layout,
artistName,
onPaintingClick,
onExitActivate,
nearExit,
}: {
layout: HallLayout;
artistName: string;
onPaintingClick: (id: number) => void;
onExitActivate: () => void;
nearExit: boolean;
}) {
const { width, depth, segments } = layout;
const halfW = width / 2;
const halfD = depth / 2;
return (
<group>
{/* Floor & ceiling — open centre, no furniture */}
<mesh rotation={[-Math.PI / 2, 0, 0]} position={[0, 0, 0]} receiveShadow>
<planeGeometry args={[width + 0.4, depth + 0.4]} />
<meshStandardMaterial color="#4a3020" roughness={0.78} />
</mesh>
<mesh rotation={[Math.PI / 2, 0, 0]} position={[0, WALL_HEIGHT, 0]}>
<planeGeometry args={[width + 0.4, depth + 0.4]} />
<meshStandardMaterial color="#2a2018" roughness={0.9} />
</mesh>
{/* Back wall */}
<GalleryWall position={[0, WALL_HEIGHT / 2, -halfD]} size={[width, WALL_HEIGHT]} color="#f0ebe3" />
{/* Left wall */}
<GalleryWall
position={[-halfW, WALL_HEIGHT / 2, 0]}
size={[depth, WALL_HEIGHT]}
rotation={[0, Math.PI / 2, 0]}
color="#e8e2d8"
/>
{/* Right wall */}
<GalleryWall
position={[halfW, WALL_HEIGHT / 2, 0]}
size={[depth, WALL_HEIGHT]}
rotation={[0, Math.PI / 2, 0]}
color="#e8e2d8"
/>
{/* Front wall — two segments with door gap */}
<GalleryWall
position={[-(DOOR_WIDTH / 2 + (width - DOOR_WIDTH) / 4), WALL_HEIGHT / 2, halfD]}
size={[(width - DOOR_WIDTH) / 2, WALL_HEIGHT]}
color="#f0ebe3"
/>
<GalleryWall
position={[(DOOR_WIDTH / 2 + (width - DOOR_WIDTH) / 4), WALL_HEIGHT / 2, halfD]}
size={[(width - DOOR_WIDTH) / 2, WALL_HEIGHT]}
color="#f0ebe3"
/>
{/* Crown molding on back wall */}
<mesh position={[0, WALL_HEIGHT - 0.08, -halfD + WALL_THICKNESS / 2]}>
<boxGeometry args={[width, 0.14, 0.1]} />
<meshStandardMaterial color="#b8956a" roughness={0.5} metalness={0.25} />
</mesh>
<Text
position={[0, WALL_HEIGHT - 0.45, -halfD + WALL_THICKNESS + 0.02]}
fontSize={0.28}
color="#4a3020"
anchorX="center"
>
{artistName.toUpperCase()}
</Text>
{segments.map((seg) => (
<group key={`${seg.side}-${seg.label}`}>
{seg.paintings.map((painting, i) => (
<PaintingFrame
key={painting.id}
painting={painting}
position={seg.slots[i].position}
rotationY={seg.slots[i].rotationY}
maxWidth={seg.slots[i].maxW}
maxHeight={seg.slots[i].maxH}
onClick={() => onPaintingClick(painting.id)}
/>
))}
{seg.label && (
<Text
position={[
seg.side === 'back' ? 0 : seg.side === 'left' ? -halfW + 0.15 : halfW - 0.15,
WALL_HEIGHT - 0.85,
seg.side === 'back' ? -halfD + 0.15 : 0,
]}
rotation={[0, seg.side === 'left' ? Math.PI / 2 : seg.side === 'right' ? -Math.PI / 2 : 0, 0]}
fontSize={0.14}
color="#6b5344"
anchorX="center"
>
{seg.label}
</Text>
)}
</group>
))}
<ExitPortal
position={[0, 0, halfD - WALL_THICKNESS / 2 - 0.02]}
active={nearExit}
onActivate={onExitActivate}
/>
<pointLight position={[0, WALL_HEIGHT - 0.4, 0]} intensity={0.5} color="#fff5e8" distance={width + depth} />
<pointLight position={[0, WALL_HEIGHT - 0.4, -halfD / 2]} intensity={0.35} color="#fff0dd" distance={12} />
</group>
);
}
function CameraController({
position,
target,
}: {
position: THREE.Vector3;
target: THREE.Vector3;
}) {
const { camera } = useThree();
useFrame(() => {
camera.position.lerp(position, 0.12);
camera.lookAt(target);
});
return null;
}
function NavigationPanel({
navigation,
loading,
onSelect,
onClose,
}: {
navigation: ArtistNavigation | null;
loading: boolean;
onSelect: (artistId: number) => void;
onClose: () => void;
}) {
const renderColumn = (title: string, groups: MovementArtistGroup[], emptyHint: string) => (
<div className="exit-nav-column">
<h3>{title}</h3>
{loading && <p className="exit-nav-loading">Loading</p>}
{!loading && groups.length === 0 && <p className="exit-nav-empty">{emptyHint}</p>}
{!loading &&
groups.map((group) => (
<div key={group.movement_id ?? group.movement_name} className="exit-nav-movement">
<h4 style={{ borderColor: group.movement_color }}>{group.movement_name}</h4>
<ul>
{group.artists.map((artist) => (
<li key={artist.id}>
<button type="button" onClick={() => onSelect(artist.id)}>
<img src={imageUrl(artist.portrait_path)} alt="" />
<span>
{artist.name}
{artist.birth_year && (
<small>
{artist.birth_year}
{artist.death_year ? `${artist.death_year}` : ''}
</small>
)}
</span>
</button>
</li>
))}
</ul>
</div>
))}
</div>
);
return (
<div className="exit-nav-overlay" role="dialog" aria-modal="true">
<div className="exit-nav-panel">
<header className="exit-nav-header">
<h2>Choose your path</h2>
<button type="button" className="exit-nav-close" onClick={onClose} aria-label="Close">
×
</button>
</header>
<div className="exit-nav-columns">
{renderColumn(
'Predecessors',
navigation?.predecessors ?? [],
'No documented predecessors via painting influences.'
)}
{renderColumn(
'Successors',
navigation?.successors ?? [],
'No documented successors via painting influences.'
)}
</div>
</div>
</div>
);
}
export default function VirtualGallery({
data,
onPaintingClick,
onNavigateArtist,
onBack,
onBioClick,
}: Props) {
const [artist, setArtist] = useState(data.artist);
const [periods, setPeriods] = useState(data.periods);
const [paintings, setPaintings] = useState(data.paintings);
const [syncStatus, setSyncStatus] = useState('');
const [showExitNav, setShowExitNav] = useState(false);
const [navigation, setNavigation] = useState<ArtistNavigation | null>(null);
const [navLoading, setNavLoading] = useState(false);
const [nearExit, setNearExit] = useState(false);
useEffect(() => {
let cancelled = false;
(async () => {
try {
setSyncStatus('Syncing images…');
const timeout = new Promise<void>((resolve) => setTimeout(resolve, 2000));
await Promise.race([preloadArtistImages(data.artist.id), timeout]);
const fresh = await api.getArtist(data.artist.id);
if (!cancelled) {
setArtist(fresh.artist);
setPeriods(fresh.periods);
setPaintings(fresh.paintings);
const withImg = fresh.paintings.filter((p) => p.image_path || p.thumbnail_path).length;
setSyncStatus(
withImg < fresh.paintings.length
? `${withImg} of ${fresh.paintings.length} works have images`
: ''
);
}
} catch {
if (!cancelled) setSyncStatus('');
}
})();
return () => {
cancelled = true;
};
}, [data.artist.id]);
const layout = useMemo(() => buildHallLayout(paintings, periods), [paintings, periods]);
const halfW = layout.width / 2 - 0.8;
const halfD = layout.depth / 2 - 0.8;
const exitZ = layout.depth / 2 - 0.6;
const initialPos = useMemo(
() => new THREE.Vector3(0, EYE_HEIGHT, layout.depth / 2 - 2.2),
[layout.depth]
);
const initialTarget = useMemo(
() => new THREE.Vector3(0, HANG_HEIGHT, -layout.depth / 4),
[layout.depth]
);
const [camPos, setCamPos] = useState(() => initialPos.clone());
const [camTarget, setCamTarget] = useState(() => initialTarget.clone());
const keysPressed = useRef<Set<string>>(new Set());
const camPosRef = useRef(camPos);
const camTargetRef = useRef(camTarget);
camPosRef.current = camPos;
camTargetRef.current = camTarget;
useEffect(() => {
setCamPos(initialPos.clone());
setCamTarget(initialTarget.clone());
setShowExitNav(false);
setNearExit(false);
}, [data.artist.id, initialPos, initialTarget]);
const openExitNav = useCallback(async () => {
setShowExitNav(true);
setNavLoading(true);
try {
const nav = await api.getArtistNavigation(artist.id);
setNavigation(nav);
} catch {
setNavigation({ predecessors: [], successors: [] });
} finally {
setNavLoading(false);
}
}, [artist.id]);
const moveCamera = useCallback(
(forward: number, strafe: number, rotY: number) => {
const pos = camPosRef.current.clone();
const target = camTargetRef.current.clone();
const angle = Math.atan2(target.x - pos.x, target.z - pos.z);
if (rotY !== 0) {
const newAngle = angle + rotY;
const dist = pos.distanceTo(target);
target.x = pos.x + Math.sin(newAngle) * dist;
target.z = pos.z + Math.cos(newAngle) * dist;
} else {
const newAngle = angle;
pos.x += Math.sin(newAngle) * forward + Math.sin(newAngle + Math.PI / 2) * strafe;
pos.z += Math.cos(newAngle) * forward + Math.cos(newAngle + Math.PI / 2) * strafe;
target.x += Math.sin(newAngle) * forward + Math.sin(newAngle + Math.PI / 2) * strafe;
target.z += Math.cos(newAngle) * forward + Math.cos(newAngle + Math.PI / 2) * strafe;
}
pos.x = Math.max(-halfW, Math.min(halfW, pos.x));
target.x = Math.max(-halfW, Math.min(halfW, target.x));
pos.z = Math.max(-halfD, Math.min(exitZ, pos.z));
target.z = Math.max(-halfD, Math.min(exitZ, target.z));
setCamPos(pos);
setCamTarget(target);
const atExit = pos.z > exitZ - 0.8 && Math.abs(pos.x) < DOOR_WIDTH / 2 + 0.6;
setNearExit(atExit);
},
[halfW, halfD, exitZ]
);
useEffect(() => {
const onKeyDown = (e: KeyboardEvent) => {
keysPressed.current.add(e.key);
if ((e.key === 'e' || e.key === 'E') && nearExit && !showExitNav) {
openExitNav();
}
};
const onKeyUp = (e: KeyboardEvent) => keysPressed.current.delete(e.key);
window.addEventListener('keydown', onKeyDown);
window.addEventListener('keyup', onKeyUp);
const interval = setInterval(() => {
const keys = keysPressed.current;
if (keys.has('ArrowUp') || keys.has('w')) moveCamera(-0.1, 0, 0);
if (keys.has('ArrowDown') || keys.has('s')) moveCamera(0.1, 0, 0);
if (keys.has('ArrowLeft') || keys.has('a')) moveCamera(0, -0.08, 0);
if (keys.has('ArrowRight') || keys.has('d')) moveCamera(0, 0.08, 0);
}, 16);
return () => {
window.removeEventListener('keydown', onKeyDown);
window.removeEventListener('keyup', onKeyUp);
clearInterval(interval);
};
}, [moveCamera, nearExit, showExitNav, openExitNav]);
const handleNavigate = (artistId: number) => {
setShowExitNav(false);
onNavigateArtist(artistId);
};
return (
<div className="virtual-gallery">
<div className="gallery-header">
<button className="gallery-back-btn" onClick={onBack}> Back to Timeline</button>
<div className="gallery-title-block">
<h2>{artist.name}</h2>
<p className="gallery-career-path">Personal hall · {paintings.length} works on the walls</p>
</div>
<div className="gallery-header-meta">
<button className="gallery-bio-btn" onClick={onBioClick}>Biography</button>
</div>
</div>
<div className="gallery-canvas-container">
{syncStatus && (
<div className="gallery-loading-overlay gallery-sync-badge">
<p>{syncStatus}</p>
</div>
)}
{nearExit && !showExitNav && (
<div className="gallery-exit-hint">At the exit click the doorway or press <kbd>E</kbd></div>
)}
<Canvas shadows camera={{ fov: 58, position: [0, EYE_HEIGHT, 2], near: 0.1, far: 80 }}>
<color attach="background" args={['#0d0906']} />
<fog attach="fog" args={['#0d0906', 18, 55]} />
<ambientLight intensity={0.42} />
<directionalLight position={[3, 9, 4]} intensity={0.65} castShadow shadow-mapSize={[1024, 1024]} />
<Suspense fallback={null}>
<Environment preset="apartment" environmentIntensity={0.15} />
</Suspense>
<ArtistHall
layout={layout}
artistName={artist.name}
onPaintingClick={onPaintingClick}
onExitActivate={openExitNav}
nearExit={nearExit}
/>
<CameraController position={camPos} target={camTarget} />
</Canvas>
</div>
{showExitNav && (
<NavigationPanel
navigation={navigation}
loading={navLoading}
onSelect={handleNavigate}
onClose={() => setShowExitNav(false)}
/>
)}
<div className="gallery-controls">
<div className="control-pad">
<button onClick={() => moveCamera(-0.35, 0, 0)} title="Walk forward"></button>
<div className="control-row">
<button onClick={() => moveCamera(0, -0.28, 0)} title="Step left"></button>
<button onClick={() => moveCamera(0.35, 0, 0)} title="Walk toward exit"></button>
<button onClick={() => moveCamera(0, 0.28, 0)} title="Step right"></button>
</div>
</div>
<div className="gallery-instructions">
<h4>{artist.name}&apos;s Hall</h4>
<ul>
<li><kbd>W</kbd> / <kbd></kbd> Walk into the room</li>
<li><kbd>S</kbd> / <kbd></kbd> Walk toward the exit</li>
<li><kbd>A</kbd> / <kbd>D</kbd> Step sideways along the walls</li>
<li>Paintings hang on three walls the centre stays open</li>
<li>Click a painting for details, or use the exit to visit related artists</li>
</ul>
</div>
</div>
</div>
);
}
+29 -97
View File
@@ -1,111 +1,43 @@
:root {
--text: #6b6375;
--text-h: #08060d;
--bg: #fff;
--border: #e5e4e7;
--code-bg: #f4f3ec;
--accent: #aa3bff;
--accent-bg: rgba(170, 59, 255, 0.1);
--accent-border: rgba(170, 59, 255, 0.5);
--social-bg: rgba(244, 243, 236, 0.5);
--shadow:
rgba(0, 0, 0, 0.1) 0 10px 15px -3px, rgba(0, 0, 0, 0.05) 0 4px 6px -2px;
--sans: system-ui, 'Segoe UI', Roboto, sans-serif;
--heading: system-ui, 'Segoe UI', Roboto, sans-serif;
--mono: ui-monospace, Consolas, monospace;
font: 18px/145% var(--sans);
letter-spacing: 0.18px;
color-scheme: light dark;
color: var(--text);
background: var(--bg);
font-synthesis: none;
text-rendering: optimizeLegibility;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
@media (max-width: 1024px) {
font-size: 16px;
}
}
@media (prefers-color-scheme: dark) {
:root {
--text: #9ca3af;
--text-h: #f3f4f6;
--bg: #16171d;
--border: #2e303a;
--code-bg: #1f2028;
--accent: #c084fc;
--accent-bg: rgba(192, 132, 252, 0.15);
--accent-border: rgba(192, 132, 252, 0.5);
--social-bg: rgba(47, 48, 58, 0.5);
--shadow:
rgba(0, 0, 0, 0.4) 0 10px 15px -3px, rgba(0, 0, 0, 0.25) 0 4px 6px -2px;
}
#social .button-icon {
filter: invert(1) brightness(2);
}
}
#root {
width: 1126px;
max-width: 100%;
margin: 0 auto;
text-align: center;
border-inline: 1px solid var(--border);
min-height: 100svh;
display: flex;
flex-direction: column;
*,
*::before,
*::after {
box-sizing: border-box;
}
html, body, #root {
margin: 0;
padding: 0;
min-height: 100vh;
}
body {
margin: 0;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
background: #0f0f1a;
color: #e8d5b5;
-webkit-font-smoothing: antialiased;
}
h1,
h2 {
font-family: var(--heading);
font-weight: 500;
color: var(--text-h);
button {
font-family: inherit;
}
h1 {
font-size: 56px;
letter-spacing: -1.68px;
margin: 32px 0;
@media (max-width: 1024px) {
font-size: 36px;
margin: 20px 0;
}
}
h2 {
font-size: 24px;
line-height: 118%;
letter-spacing: -0.24px;
margin: 0 0 8px;
@media (max-width: 1024px) {
font-size: 20px;
}
}
p {
margin: 0;
img {
max-width: 100%;
}
code,
.counter {
font-family: var(--mono);
display: inline-flex;
::-webkit-scrollbar {
width: 8px;
}
::-webkit-scrollbar-track {
background: rgba(0, 0, 0, 0.2);
}
::-webkit-scrollbar-thumb {
background: rgba(201, 169, 110, 0.3);
border-radius: 4px;
color: var(--text-h);
}
code {
font-size: 15px;
line-height: 135%;
padding: 4px 8px;
background: var(--code-bg);
::-webkit-scrollbar-thumb:hover {
background: rgba(201, 169, 110, 0.5);
}
+43
View File
@@ -0,0 +1,43 @@
.home-page {
min-height: 100vh;
background: linear-gradient(180deg, #0f0f1a 0%, #1a1a2e 40%, #16213e 100%);
}
.site-header {
text-align: center;
padding: 24px 16px 8px;
}
.site-header h1 {
font-family: 'Georgia', 'Times New Roman', serif;
font-size: 32px;
color: #e8d5b5;
margin: 0;
letter-spacing: 2px;
}
.site-subtitle {
color: rgba(201, 169, 110, 0.6);
font-family: 'Georgia', serif;
font-size: 14px;
margin: 8px 0 0;
font-style: italic;
}
.loading {
text-align: center;
padding: 48px;
color: rgba(201, 169, 110, 0.6);
font-family: 'Georgia', serif;
font-size: 16px;
}
.error-banner {
margin: 16px;
padding: 12px 16px;
background: rgba(139, 0, 0, 0.3);
border: 1px solid rgba(255, 100, 100, 0.4);
border-radius: 6px;
color: #ffaaaa;
text-align: center;
}
+159
View File
@@ -0,0 +1,159 @@
import { useState, useEffect, useCallback } from 'react';
import Timeline from '../components/Timeline';
import MovementBands from '../components/MovementBands';
import VirtualGallery from '../components/VirtualGallery';
import PaintingDetailView from '../components/PaintingDetail';
import ArtistBio from '../components/ArtistBio';
import { api } from '../api/client';
import type { TimelineData, Artist, ArtistDetail, PaintingDetail } from '../types';
import './HomePage.css';
type View =
| { type: 'timeline' }
| { type: 'gallery'; artistId: number; data: ArtistDetail }
| { type: 'painting'; paintingId: number; data: PaintingDetail; returnTo: View }
| { type: 'bio'; artistId: number; data: ArtistDetail; returnTo: View };
export default function HomePage() {
const [view, setView] = useState<View>({ type: 'timeline' });
const [bounds, setBounds] = useState({ min: -800, max: 2025 });
const [viewStart, setViewStart] = useState(-800);
const [viewEnd, setViewEnd] = useState(2025);
const [timelineData, setTimelineData] = useState<TimelineData>({ eras: [], movements: [] });
const [artists, setArtists] = useState<Artist[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
api.getBounds()
.then((b) => {
const min = b.min_year ?? -800;
const max = b.max_year ?? 2025;
setBounds({ min, max });
setViewStart(min);
setViewEnd(max);
})
.catch(() => {});
}, []);
const loadTimelineData = useCallback(async (start: number, end: number) => {
try {
setLoading(true);
const [timeline, artistList] = await Promise.all([
api.getTimeline(start, end),
api.getArtists(start, end),
]);
setTimelineData(timeline);
setArtists(artistList);
setError(null);
} catch {
setError('Could not load gallery data. Is the server running?');
} finally {
setLoading(false);
}
}, []);
useEffect(() => {
loadTimelineData(viewStart, viewEnd);
}, [viewStart, viewEnd, loadTimelineData]);
const handleViewChange = (start: number, end: number) => {
setViewStart(start);
setViewEnd(end);
};
const handleArtistClick = async (artistId: number) => {
try {
const data = await api.getArtist(artistId);
setView({ type: 'gallery', artistId, data });
} catch {
setError('Failed to load artist gallery.');
}
};
const handlePaintingClick = async (paintingId: number) => {
try {
const data = await api.getPainting(paintingId);
setView((prev) => ({
type: 'painting',
paintingId,
data,
returnTo: prev,
}));
} catch {
setError('Failed to load painting details.');
}
};
const handleBioClick = (artistData: ArtistDetail, returnTo: View) => {
setView({ type: 'bio', artistId: artistData.artist.id, data: artistData, returnTo });
};
if (view.type === 'gallery') {
return (
<VirtualGallery
data={view.data}
onPaintingClick={handlePaintingClick}
onNavigateArtist={handleArtistClick}
onBack={() => setView({ type: 'timeline' })}
onBioClick={() => handleBioClick(view.data, view)}
/>
);
}
if (view.type === 'painting') {
return (
<PaintingDetailView
data={view.data}
onBack={() => setView(view.returnTo)}
onPaintingClick={handlePaintingClick}
onArtistBio={async () => {
const artistData = await api.getArtist(view.data.painting.artist_id);
setView({ type: 'bio', artistId: artistData.artist.id, data: artistData, returnTo: view });
}}
/>
);
}
if (view.type === 'bio') {
return (
<ArtistBio
artist={view.data.artist}
onBack={() => setView(view.returnTo)}
onEnterGallery={() => setView({ type: 'gallery', artistId: view.artistId, data: view.data })}
/>
);
}
return (
<div className="home-page">
<header className="site-header">
<h1>Virtual Art Gallery</h1>
<p className="site-subtitle">Explore the flowing connections of art history</p>
</header>
<Timeline
eras={timelineData.eras}
viewStart={viewStart}
viewEnd={viewEnd}
onViewChange={handleViewChange}
absoluteMin={bounds.min}
absoluteMax={bounds.max}
/>
{error && <div className="error-banner">{error}</div>}
{loading ? (
<div className="loading">Loading art history...</div>
) : (
<MovementBands
movements={timelineData.movements}
artists={artists}
viewStart={viewStart}
viewEnd={viewEnd}
onArtistClick={handleArtistClick}
/>
)}
</div>
);
}
+120
View File
@@ -0,0 +1,120 @@
export interface HistoricalEra {
id: number;
name: string;
start_year: number;
end_year: number;
start_definite: boolean;
end_definite: boolean;
description: string;
sort_order: number;
}
export interface ArtMovement {
id: number;
name: string;
start_year: number;
end_year: number;
start_definite: boolean;
end_definite: boolean;
era_id: number;
era_name?: string;
description: string;
color: string;
}
export interface Artist {
id: number;
name: string;
birth_year: number;
death_year: number;
movement_id: number;
movement_name?: string;
movement_color?: string;
portrait_path: string;
bio_short: string;
bio_full: string;
wikipedia_title: string;
century: number;
}
export interface ArtistPeriod {
id: number;
artist_id: number;
name: string;
start_year: number;
end_year: number;
description: string;
sort_order: number;
}
export interface Painting {
id: number;
artist_id: number;
period_id: number;
title: string;
year: number;
year_end?: number;
description: string;
image_path: string;
thumbnail_path?: string;
wikipedia_title: string;
sort_order: number;
artist_name?: string;
}
export interface InfluenceLink {
notes: string;
source: string;
aspects?: string;
quote?: string;
source_author?: string;
source_url?: string;
id: number;
title: string;
year: number;
image_path: string;
artist_name: string;
artist_id: number;
}
export interface PaintingDetail {
painting: Painting & { artist_name: string; artist_portrait: string };
influencedBy: InfluenceLink[];
influenced: InfluenceLink[];
}
export interface ArtistDetail {
artist: Artist & { movement_name: string };
periods: ArtistPeriod[];
paintings: Painting[];
}
export interface TimelineData {
eras: HistoricalEra[];
movements: ArtMovement[];
}
export interface YearBounds {
min_year: number;
max_year: number;
}
export interface NavigationArtist {
id: number;
name: string;
birth_year: number | null;
death_year: number | null;
portrait_path: string | null;
}
export interface MovementArtistGroup {
movement_id: number | null;
movement_name: string;
movement_color: string;
artists: NavigationArtist[];
}
export interface ArtistNavigation {
predecessors: MovementArtistGroup[];
successors: MovementArtistGroup[];
}