Koko210/immich-folio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: v0.19.0

Browse Source 
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>
This commit is contained in:
Ralksta
2026-09-29 22:50:30 +02:00
committed by GitHub
parent 5f251923f0
commit ad8b09700b
297 changed files with 19398 additions and 1800 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
lib/imageSize.ts
View File

@@ -62,3 +62,32 @@ export function resolveImageSize(sizeParam: string | null, widthParam: string |
explicit && fromWidth ? smaller(explicit, fromWidth) : (explicit ?? fromWidth ?? 'preview');
return smaller(resolved, MAX_SIZE);
}
/**
* The `?w=` written for each tier: the widest value that still resolves to it.
* `resolveImageSize(size, String(TIER_WIDTH[t]))` is `t` for every tier the
* ceiling allows, so the canonical URL fetches exactly the rendition the
* original width did.
*/
const TIER_WIDTH: Record<ImageSize, number> = { thumbnail: 250, preview: 1440, original: 3840 };
/**
* One URL per asset and tier, whatever width is asked for.
*
* The proxy answers every width inside a tier with the same bytes — Immich
* has one thumbnail and one preview per asset, and `MAX_SIZE` caps the rest —
* but each distinct `?w=` is a separate `immutable` cache entry. next/image
* writes eight or more widths into every srcset and the lightbox asked for the
* bare URL, so a grid tile and the same photo in the lightbox, or one tile
* before and after a rotation, downloaded the identical preview twice.
* Collapsing the width to its tier makes all of them one cache entry. `q` is
* dropped for the same reason: the proxy never read it.
*
* `width` defaults to "as large as the ceiling allows" — the lightbox's case.
*/
export function canonicalImageUrl(src: string, width: number = Number.MAX_SAFE_INTEGER): string {
const queryAt = src.indexOf('?');
const sizeParam = queryAt === -1 ? null : new URLSearchParams(src.slice(queryAt + 1)).get('size');
const tier = resolveImageSize(sizeParam, String(Math.max(1, Math.round(width))));
return `${src}${queryAt === -1 ? '?' : '&'}w=${TIER_WIDTH[tier]}`;
}