Release v0.19.0. See the `## [0.19.0] — 2026-09-29` section of [CHANGELOG.md](https://github.com/ralksta/immich-folio/blob/dev/CHANGELOG.md) for the full list. Highlights: client proofing links (#683), custom content pages (#738), asset picker search (#740), concurrent-edit detection (#742), env-locked settings (#739), an accessibility baseline (#741), three security fixes with advisories (#737, #755, #759), and a pre-release quality pass (#780–#797). --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: ralksta <ralksta@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com> Co-authored-by: Ralf <rohlenbo79@gmail.com> Co-authored-by: Paul Thies <110185070+ImScheinox@users.noreply.github.com> Co-authored-by: lancetm714 <108419425+lancetm714@users.noreply.github.com> Co-authored-by: Lance Martin <lancetaylor95@gmail.com>
212 lines
7.2 KiB
TypeScript
212 lines
7.2 KiB
TypeScript
'use client';
|
|
|
|
import * as Icons from '../Icons';
|
|
import OptionGrid, { toOptions } from '../fields/OptionGrid';
|
|
import {
|
|
PHOTO_GRID_COLUMNS_MAX,
|
|
PHOTO_GRID_COLUMNS_MIN,
|
|
PHOTO_GRID_GAP_MAX,
|
|
} from '@/lib/config/schema';
|
|
import { FieldError } from './fields';
|
|
import type { SectionProps } from './types';
|
|
|
|
const LAYOUTS = ['masonry', 'uniform', 'showcase', 'filmstrip', 'editorial-flow', 'justified'];
|
|
const ASPECT_RATIOS = ['1', '3/2', '2/3', '16/9', 'auto'];
|
|
|
|
const LAYOUT_INFO: Record<string, { label: string; desc: string }> = {
|
|
masonry: {
|
|
label: 'Masonry',
|
|
desc: 'Dynamic pinterest-style staggered columns',
|
|
},
|
|
uniform: { label: 'Uniform Grid', desc: 'Clean equal aspect ratio grid' },
|
|
showcase: {
|
|
label: 'Showcase',
|
|
desc: 'Featured hero photos mixed with smaller tiles',
|
|
},
|
|
filmstrip: {
|
|
label: 'Filmstrip',
|
|
desc: 'Horizontal scrollable film strip timeline',
|
|
},
|
|
'editorial-flow': {
|
|
label: 'Editorial Flow',
|
|
desc: 'Magazine story layout with varying photo sizes',
|
|
},
|
|
justified: {
|
|
label: 'Justified (Experimental)',
|
|
desc: 'Equal-height rows that fill the full width',
|
|
},
|
|
};
|
|
const LAYOUT_OPTIONS = toOptions(LAYOUTS, LAYOUT_INFO);
|
|
|
|
function LayoutPreview({ value }: { value: string }) {
|
|
return (
|
|
<div className="grid-card-preview">
|
|
<div className={`mini-layout-demo layout-demo-${value}`}>
|
|
{value === 'masonry' && (
|
|
<div className="demo-masonry-col-group">
|
|
<div className="demo-col">
|
|
<div className="demo-tile h-high" />
|
|
<div className="demo-tile h-low" />
|
|
</div>
|
|
<div className="demo-col">
|
|
<div className="demo-tile h-low" />
|
|
<div className="demo-tile h-high" />
|
|
</div>
|
|
<div className="demo-col">
|
|
<div className="demo-tile h-med" />
|
|
<div className="demo-tile h-med" />
|
|
</div>
|
|
</div>
|
|
)}
|
|
{value === 'uniform' && (
|
|
<div className="demo-uniform-grid">
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
</div>
|
|
)}
|
|
{value === 'showcase' && (
|
|
<div className="demo-showcase-grid">
|
|
<div className="demo-tile demo-hero" />
|
|
<div className="demo-col">
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
</div>
|
|
</div>
|
|
)}
|
|
{value === 'filmstrip' && (
|
|
<div className="demo-filmstrip-row">
|
|
<div className="demo-tile strip" />
|
|
<div className="demo-tile strip" />
|
|
<div className="demo-tile strip" />
|
|
</div>
|
|
)}
|
|
{value === 'editorial-flow' && (
|
|
<div className="demo-editorial-flow">
|
|
<div className="demo-tile wide" />
|
|
<div className="demo-row">
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile" />
|
|
</div>
|
|
</div>
|
|
)}
|
|
{value === 'justified' && (
|
|
<div className="demo-editorial-flow">
|
|
<div className="demo-row">
|
|
<div className="demo-tile wide" />
|
|
<div className="demo-tile" />
|
|
</div>
|
|
<div className="demo-row">
|
|
<div className="demo-tile" />
|
|
<div className="demo-tile wide" />
|
|
</div>
|
|
</div>
|
|
)}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
const ASPECT_RATIO_INFO: Record<string, { label: string; desc: string }> = {
|
|
'1': { label: 'Square (1:1)', desc: '1:1 ratio square crops' },
|
|
'3/2': { label: 'Landscape (3:2)', desc: 'Standard 35mm DSLR landscape' },
|
|
'2/3': { label: 'Portrait (2:3)', desc: 'Vertical portrait orientation' },
|
|
'16/9': { label: 'Cinema (16:9)', desc: 'Widescreen 16:9 cinematic ratio' },
|
|
auto: {
|
|
label: 'Original Auto',
|
|
desc: 'Uncropped original image proportions',
|
|
},
|
|
};
|
|
const ASPECT_RATIO_OPTIONS = toOptions(ASPECT_RATIOS, ASPECT_RATIO_INFO);
|
|
|
|
function AspectRatioPreview({ value }: { value: string }) {
|
|
return (
|
|
<div className="ratio-card-preview">
|
|
<div className={`mini-aspect-box ratio-${value.replace('/', '-')}`}>
|
|
<div className="mini-aspect-inner" />
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
export default function GridSection({ settings, update, fieldErrors }: SectionProps) {
|
|
return (
|
|
<div className="settings-panel">
|
|
<div className="settings-section-header">
|
|
<h3>
|
|
<Icons.IconGrid size={18} /> Grid & Layout Engine
|
|
</h3>
|
|
<p className="settings-section-sub">
|
|
Configure photography gallery column structures and thumbnail aspect ratios.
|
|
</p>
|
|
</div>
|
|
|
|
<OptionGrid
|
|
label="Layout Algorithm"
|
|
options={LAYOUT_OPTIONS}
|
|
value={settings.grid?.layout || 'masonry'}
|
|
onSelect={(v) => update('grid.layout', v)}
|
|
cardClassName="grid-layout-card"
|
|
renderPreview={(o) => <LayoutPreview value={o.value} />}
|
|
/>
|
|
|
|
<OptionGrid
|
|
label="Aspect Ratio"
|
|
options={ASPECT_RATIO_OPTIONS}
|
|
value={settings.grid?.aspectRatio || '1'}
|
|
onSelect={(v) => update('grid.aspectRatio', v)}
|
|
cardClassName="ratio-card"
|
|
renderPreview={(o) => <AspectRatioPreview value={o.value} />}
|
|
/>
|
|
|
|
<div className="settings-section-divider" />
|
|
|
|
<div className="settings-section-header">
|
|
<h3>
|
|
<Icons.IconColumns size={18} /> Spacing & Columns
|
|
</h3>
|
|
<p className="settings-section-sub">
|
|
Adjust column counts and grid gap spacing. The column count also tiles the album covers on
|
|
a subpage; their spacing stays with the theme unless a page overrides it.
|
|
</p>
|
|
</div>
|
|
|
|
<div className="admin-field-row">
|
|
<div className="admin-field">
|
|
<label htmlFor="grid-columns">
|
|
Columns ({PHOTO_GRID_COLUMNS_MIN} - {PHOTO_GRID_COLUMNS_MAX})
|
|
</label>
|
|
<input
|
|
id="grid-columns"
|
|
type="number"
|
|
min={PHOTO_GRID_COLUMNS_MIN}
|
|
max={PHOTO_GRID_COLUMNS_MAX}
|
|
value={settings.grid?.columns ?? 3}
|
|
onChange={(e) => update('grid.columns', parseInt(e.target.value) || 3)}
|
|
aria-invalid={fieldErrors?.['grid.columns'] ? true : undefined}
|
|
aria-describedby={fieldErrors?.['grid.columns'] ? 'grid-columns-error' : undefined}
|
|
/>
|
|
<FieldError id="grid-columns-error" message={fieldErrors?.['grid.columns']} />
|
|
</div>
|
|
<div className="admin-field">
|
|
<label htmlFor="grid-gap-spacing">Gap Spacing (px)</label>
|
|
<input
|
|
id="grid-gap-spacing"
|
|
type="number"
|
|
min={0}
|
|
max={PHOTO_GRID_GAP_MAX}
|
|
value={settings.grid?.gap ?? 12}
|
|
onChange={(e) => update('grid.gap', parseInt(e.target.value) || 0)}
|
|
aria-invalid={fieldErrors?.['grid.gap'] ? true : undefined}
|
|
aria-describedby={fieldErrors?.['grid.gap'] ? 'grid-gap-error' : undefined}
|
|
/>
|
|
<FieldError id="grid-gap-error" message={fieldErrors?.['grid.gap']} />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|