mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-21 11:43:11 +00:00
Home ganha a seção Faça parte com os três modelos e a rota /cards concentra catálogo + compositor client-side (dialog desktop, bottom drawer mobile): nome no slot medido do mestre com Brexter 700 e foto full-bleed sob o overlay oficial (pan/zoom clampados), download PNG sem conta e sem enviar nome/foto. Núcleo puro em src/lib/card* com unit tests; e2e cobre home→deep-link, nome→PNG real, erro fail-closed, foto e drawer mobile. Sem migration/PII.
126 lines
3.6 KiB
TypeScript
126 lines
3.6 KiB
TypeScript
/**
|
|
* S13 — pure cover/pan/zoom math for the photo card models. The visitor photo
|
|
* is drawn full-bleed under the master overlay and must always cover the
|
|
* transparent window: `clampCardPhotoTransform` keeps the zoom inside
|
|
* [1, 4] and pins the offsets so no gap can open at the window edges.
|
|
*
|
|
* `centerCardPhotoTransform` is the initial framing (cover on the window, not
|
|
* on the whole card) so the face lands on the visible area of the frame.
|
|
*/
|
|
|
|
import type { CardRect } from './cardModels'
|
|
|
|
export const CARD_PHOTO_MIN_ZOOM = 1
|
|
export const CARD_PHOTO_MAX_ZOOM = 4
|
|
|
|
export type CardPhotoSize = {
|
|
width: number
|
|
height: number
|
|
}
|
|
|
|
export type CardPhotoTransform = {
|
|
zoom: number
|
|
offsetX: number
|
|
offsetY: number
|
|
}
|
|
|
|
const clamp = (value: number, min: number, max: number): number =>
|
|
Math.min(Math.max(value, min), max)
|
|
|
|
export const coverScale = (source: CardPhotoSize, window: CardRect): number => {
|
|
if (source.width <= 0 || source.height <= 0 || window.width <= 0 || window.height <= 0) return 1
|
|
|
|
return Math.max(window.width / source.width, window.height / source.height)
|
|
}
|
|
|
|
export const cardPhotoDrawRect = (
|
|
transform: CardPhotoTransform,
|
|
source: CardPhotoSize,
|
|
window: CardRect,
|
|
): CardRect => {
|
|
const clamped = clampCardPhotoTransform(transform, source, window)
|
|
const scale = coverScale(source, window) * clamped.zoom
|
|
|
|
return {
|
|
x: clamped.offsetX,
|
|
y: clamped.offsetY,
|
|
width: source.width * scale,
|
|
height: source.height * scale,
|
|
}
|
|
}
|
|
|
|
export const clampCardPhotoTransform = (
|
|
transform: CardPhotoTransform,
|
|
source: CardPhotoSize,
|
|
window: CardRect,
|
|
): CardPhotoTransform => {
|
|
const zoom = clamp(transform.zoom, CARD_PHOTO_MIN_ZOOM, CARD_PHOTO_MAX_ZOOM)
|
|
const scale = coverScale(source, window) * zoom
|
|
const width = source.width * scale
|
|
const height = source.height * scale
|
|
|
|
return {
|
|
zoom,
|
|
offsetX: clamp(transform.offsetX, window.x + window.width - width, window.x),
|
|
offsetY: clamp(transform.offsetY, window.y + window.height - height, window.y),
|
|
}
|
|
}
|
|
|
|
export const centerCardPhotoTransform = (
|
|
source: CardPhotoSize,
|
|
window: CardRect,
|
|
): CardPhotoTransform => {
|
|
const scale = coverScale(source, window)
|
|
const width = source.width * scale
|
|
const height = source.height * scale
|
|
|
|
return {
|
|
zoom: CARD_PHOTO_MIN_ZOOM,
|
|
offsetX: window.x + (window.width - width) / 2,
|
|
offsetY: window.y + (window.height - height) / 2,
|
|
}
|
|
}
|
|
|
|
/** Nudges the offset by a step in card pixels, clamped to the window. */
|
|
export const panCardPhotoTransform = (
|
|
transform: CardPhotoTransform,
|
|
source: CardPhotoSize,
|
|
window: CardRect,
|
|
dx: number,
|
|
dy: number,
|
|
): CardPhotoTransform =>
|
|
clampCardPhotoTransform(
|
|
{ ...transform, offsetX: transform.offsetX + dx, offsetY: transform.offsetY + dy },
|
|
source,
|
|
window,
|
|
)
|
|
|
|
/**
|
|
* Rescales around a window anchor (used by the zoom control): keeps the point
|
|
* under `anchor` stable from old to new zoom, then clamps.
|
|
*/
|
|
export const zoomCardPhotoTransform = (
|
|
transform: CardPhotoTransform,
|
|
source: CardPhotoSize,
|
|
window: CardRect,
|
|
nextZoom: number,
|
|
anchor: { x: number; y: number } = {
|
|
x: window.x + window.width / 2,
|
|
y: window.y + window.height / 2,
|
|
},
|
|
): CardPhotoTransform => {
|
|
const zoom = clamp(nextZoom, CARD_PHOTO_MIN_ZOOM, CARD_PHOTO_MAX_ZOOM)
|
|
if (zoom === transform.zoom) return clampCardPhotoTransform(transform, source, window)
|
|
|
|
const ratio = zoom / transform.zoom
|
|
|
|
return clampCardPhotoTransform(
|
|
{
|
|
zoom,
|
|
offsetX: anchor.x - (anchor.x - transform.offsetX) * ratio,
|
|
offsetY: anchor.y - (anchor.y - transform.offsetY) * ratio,
|
|
},
|
|
source,
|
|
window,
|
|
)
|
|
}
|