medieval-kit/my-registry/models/wooden-bench/model.ts
CRT 50c7fc60b9 Translate the whole repository to English
The kit is going public, so everything a reader sees is now English:
27 model sources, the core vocabulary, meta.ts (titles, descriptions and
every slider label), the viewer UI, all script output, REFERENCE.md and
the READMEs.

Rules applied: only comments, doc comments and human-facing strings were
touched. Identifiers, numbers, logic, registry item ids, part names and
material slot names are unchanged — those are a published contract and
were already English.

Verified rather than assumed: for all 53 changed .ts files the code
skeleton (source with comments stripped and string contents replaced by a
placeholder) is byte-identical before and after. Full gate is green —
typecheck, registry conformance, ~510 model checks, GLB round trip and a
production build.

Also fixed here:
- index.html and viewer.html were missed by the translation pass because
  the file list only covered .ts/.md/.css. Both had lang="tr" and Turkish
  titles.
- The viewer formatted triangle counts with toLocaleString('tr-TR'), which
  prints 15.425 rather than 15,425.
- REFERENCE.md's model table header did not match what
  scripts/catalog-table.ts emits, so the next regeneration would have
  silently changed it. Aligned to the generator.
- Removed scripts/probe.ts and scripts/zdiag.ts; they were throwaway
  diagnostics that got committed by accident.
2026-08-21 14:35:13 +07:00

125 lines
4.4 KiB
TypeScript

/**
* @medieval-kit/wooden-bench
*
* The bench that sits beside the trestle table. In the middle ages a chair was
* a status object; what people actually sat on was a bench, so a hall scene
* needs one even more than it needs the table.
*
* Its structure is a simplified version of the table's: two thick end boards, a
* stretcher between them, the seat on top. But one thing differs from the
* table — the seat IS fixed to the legs. The table's top could be lifted away,
* a bench's seat cannot; so the legs are joined by tenons that run into the
* seat, and those tenons show through the top of it. That is the signature of
* medieval joinery.
*/
import {
boxGeometry,
chamferedBoxGeometry,
createKitModel,
createTinter,
jitter,
mergeColoured,
taperedBoxGeometry,
} from '../core/index.ts'
export interface WoodenBenchConfig {
/** Bench length (metres). */
readonly length: number
/** Seat height (metres). */
readonly height: number
/** Seat width (metres). */
readonly width: number
/** Outward splay of the legs. 0 = upright. */
readonly splay: number
/** How far the legs stand in from the ends, as a fraction of the length. */
readonly inset: number
readonly seed: number
}
export const woodenBenchDefaults: WoodenBenchConfig = {
length: 1.62,
height: 0.45,
width: 0.3,
splay: 0.24,
inset: 0.13,
seed: 31,
}
export type WoodenBenchParts = 'seat' | 'legs' | 'stretcher'
export function createModel(overrides: Partial<WoodenBenchConfig> = {}) {
return createKitModel<WoodenBenchConfig, 'oak', WoodenBenchParts>({
id: 'wooden-bench',
defaults: woodenBenchDefaults,
slots: ['oak'],
build: ({ config, random }) => {
const tint = createTinter(random)
const half = config.height / 2
const seatThickness = config.height * 0.09
const seatTop = half
const seatBottom = seatTop - seatThickness
const timber = config.width * 0.09
// --- Seat ----------------------------------------------------------
// A single thick board. Using two boards is not as natural on a bench
// as it is on the table: the seat must not have a gap down the middle.
const seatPieces = [chamferedBoxGeometry(
[config.length, config.width * 0.95],
[config.length * 0.995, config.width],
seatThickness,
timber * 0.4,
[0, seatBottom + seatThickness / 2, 0],
tint('oak', 0.05),
)]
// --- Legs ----------------------------------------------------------
const legX = config.length * (0.5 - config.inset)
const legHeight = seatBottom - (-half)
const legWidth = config.width * 0.66
const spread = legWidth * config.splay
const legPieces = []
for (const side of [-1, 1]) {
// Leg board: it widens on the way down. The splay is in the measure,
// not in the angle — widening the bottom face instead of rotating is
// both cheaper and lets the foot sit FLAT on the ground, whereas a
// rotated leg stands on its edge.
legPieces.push(taperedBoxGeometry(
[legWidth + spread * 2, timber * 1.35],
[legWidth, timber * 1.35],
legHeight,
[side * legX, -half + legHeight / 2, 0],
tint('oak', -0.02),
))
// Tenon: the end of the leg that runs THROUGH the seat and shows on
// top of it. It overshoots the seat's top face — the most recognisable
// detail of a medieval bench.
legPieces.push(chamferedBoxGeometry(
[legWidth * 0.34, timber * 0.85],
[legWidth * 0.32, timber * 0.8],
seatThickness * 1.9,
timber * 0.16,
[side * legX, seatBottom + seatThickness * 0.75, jitter(random, timber * 0.1)],
tint('oak', 0.09),
))
}
// --- Stretcher -----------------------------------------------------
// The batten tying the two legs together. It runs INTO the legs: its
// ends stay inside solid material so that no face ends up coplanar.
const stretcherY = -half + legHeight * 0.34
const stretcher = mergeColoured([boxGeometry(
[legX * 2 + legWidth * 0.4, timber * 1.5, timber * 0.95],
[0, stretcherY, 0],
tint('oak', -0.06),
)])
return {
seat: { slot: 'oak' as const, geometry: mergeColoured(seatPieces) },
legs: { slot: 'oak' as const, geometry: mergeColoured(legPieces) },
stretcher: { slot: 'oak' as const, geometry: stretcher },
}
},
}, overrides)
}