);
}
SquareFootageCalculator.convertState = function (state, from, to) {
if (from === to) return state;
const m2ft = 3.28084, ft2m = 0.3048;
const k = from === 'imperial' && to === 'metric' ? ft2m : m2ft;
const dec = from === 'imperial' && to === 'metric' ? 2 : 1;
return {
...state,
shapes: state.shapes.map(s => ({
...s,
length: +(s.length * k).toFixed(dec),
width: +(s.width * k).toFixed(dec),
diameter: +(s.diameter * k).toFixed(dec),
})),
};
};
SquareFootageCalculator.compute = function (state, units) {
const isImp = units === 'imperial';
const { shapes } = state;
let total = 0;
const rows = [];
shapes.forEach((s, i) => {
let a;
if (s.type === 'circle') a = Math.PI * Math.pow(toFt(s.diameter, isImp) / 2, 2);
else if (s.type === 'triangle') a = 0.5 * toFt(s.length, isImp) * toFt(s.width, isImp);
else a = toFt(s.length, isImp) * toFt(s.width, isImp);
total += a;
const display = isImp ? `${F.dec(a, 1)} sq ft` : `${F.dec(a * 0.092903, 2)} m²`;
rows.push({ label: `Section ${i + 1} (${s.type})`, value: display });
});
const sqM = total * 0.092903;
const acres = total / 43560;
const hectares = sqM / 10000;
return {
primary: { value: isImp ? total : sqM, decimals: isImp ? 1 : 2, unit: isImp ? 'sq ft' : 'm²', label: 'Total area' },
sub: shapes.length === 0
? 'Add sections above to compute total area.'
: isImp
? `Across ${shapes.length} section${shapes.length > 1 ? 's' : ''} — that's ${F.dec(sqM, 1)} m² or ${F.dec(acres, 4)} acres.`
: `Across ${shapes.length} section${shapes.length > 1 ? 's' : ''} — that's ${F.dec(total, 0)} sq ft or ${F.dec(hectares, 4)} hectares.`,
breakdown: rows.length === 0
? [{ label: 'No sections yet', value: '—' }]
: [...rows, { label: 'Total', value: isImp ? `${F.dec(total, 1)} sq ft` : `${F.dec(sqM, 2)} m²` }],
};
};
// ============================================================
// REGISTER
// ============================================================
Object.assign(window.Calcs, {
'tile-boxes': {
Component: TileCalculator,
initial: { length: 10, width: 8, tilePerBox: 10, waste: 10, pattern: 'straight' },
title: 'Tile Box Calculator',
subtitle: 'Boxes of tile needed for any floor, wall, or backsplash — adjustable waste factor.',
category: 'tile',
formula: [
['area', '= L × W'],
['with waste', '= area × (1 + waste %)'],
['boxes', '= ceil(adjusted ÷ coverage per box)'],
],
howWorks: `Tile is sold by the box and each box covers a known number of square feet — usually printed on the carton. We compute your surface area, add a waste factor for cuts and breakage, then divide by box coverage and round up. Straight layouts need about 10% waste, diagonal layouts 15%, and herringbone or mosaic patterns 20% or more. Keep one full box from the same dye lot for future repairs — manufacturers' color batches shift over time.`,
},
'roof-pitch': {
Component: RoofPitchCalculator,
initial: { rise: 6, run: 12 },
title: 'Roof Pitch Calculator',
subtitle: 'Convert any rise-over-run into pitch ratio, degrees of slope, and area multiplier.',
category: 'roofing',
formula: [
['pitch ratio', '= rise ÷ run × 12'],
['angle (deg)', '= arctan(rise ÷ run)'],
['slope %', '= (rise ÷ run) × 100'],
['area multiplier', '= √(1 + (rise ÷ run)²)'],
],
howWorks: `Roof pitch is the steepness of a roof, usually expressed as inches of rise per 12 inches of horizontal run. A 6/12 pitch means the roof rises 6 inches for every 12 inches of horizontal distance, equal to about 26.6°. We compute the pitch in three common forms: the /12 ratio that roofers use, the angle in degrees, and the slope percentage. The area multiplier tells you how much more roof surface there is than the footprint below — useful when ordering shingles, underlayment, or estimating labor.`,
},
'board-feet': {
Component: BoardFeetCalculator,
initial: { thickness: 2, width: 4, length: 8, qty: 10 },
title: 'Board Feet Calculator',
subtitle: 'Total board feet for any thickness, width, and length — the hardwood pricing unit.',
category: 'lumber',
formula: [
['per board', '= (T × W × L) ÷ 12'],
['total', '= per board × quantity'],
['', '(T, W in inches; L in feet)'],
],
howWorks: `A board foot is 144 cubic inches of wood — a piece 1 inch thick, 12 inches wide, and 1 foot long. Hardwoods and rough lumber are usually priced per board foot, while dimensional softwoods are typically sold per linear foot. To compute it: multiply thickness in inches × width in inches × length in feet, then divide by 12. Lumber thickness is also sold in quarters: 4/4 ("four-quarter") is one inch thick, 8/4 is two inches, and so on.`,
},
'mulch': {
Component: MulchCalculator,
initial: { shape: 'rect', length: 20, width: 6, diameter: 10, depth: 3 },
title: 'Mulch Calculator',
subtitle: 'Cubic yards and bag counts for garden beds at any depth.',
category: 'landscape',
formula: [
['area', '= L × W (or πr² for circles)'],
['volume (ft³)', '= area × (depth ÷ 12)'],
['cubic yards', '= volume ÷ 27'],
['bags (2 ft³)', '= ceil(volume ÷ 2)'],
],
howWorks: `Mulch keeps moisture in, weeds out, and soil temperature steady. Three inches is the sweet spot for most beds — any thicker and you risk root rot or pests bedding down for the season. We compute the volume of your bed, then offer it two ways: by the cubic yard for bulk delivery (typically cheaper above 3 yards) and by the 2-cubic-foot bag for smaller jobs. Bulk mulch is usually delivered loose and dumped at your driveway; bag mulch is easier to carry through gates but adds up fast.`,
},
'stair-stringer': {
Component: StairStringerCalculator,
initial: { totalRise: 108, riserHeight: 7.5 },
title: 'Stair Stringer Calculator',
subtitle: 'Total rise, riser count, tread depth, and stringer length for a code-compliant staircase.',
category: 'lumber',
formula: [
['risers', '= round(total rise ÷ target)'],
['actual riser', '= total rise ÷ risers'],
['treads', '= risers − 1'],
['total run', '= treads × tread depth'],
['stringer length', '= √(rise² + run²)'],
],
howWorks: `A stringer is the diagonal board that supports each step. To lay one out: measure the total vertical rise from finished floor to finished floor, divide by a target riser height (7 to 7.75 inches is typical), and round to the nearest whole number. That's your riser count — risers minus one is the tread count. Multiply tread depth (10 to 11 inches) by tread count to get the total run. The hypotenuse of rise and run is your stringer length, plus a few inches for the connection at the top and bottom. Codes vary by jurisdiction — verify locally before cutting.`,
},
'gravel': {
Component: GravelCalculator,
initial: { length: 20, width: 10, depth: 4, gravelType: 'crushed' },
title: 'Gravel Calculator',
subtitle: 'Cubic yards and tons of gravel for driveways, paths, and drainage.',
category: 'landscape',
formula: [
['volume (ft³)', '= L × W × (depth ÷ 12)'],
['cubic yards', '= volume ÷ 27'],
['tons', '= cubic yards × density'],
['', '(density: pea 1.4, crushed 1.5)'],
],
howWorks: `Gravel is sold by the cubic yard for delivery and by the ton at the scale. Driveways need 4 to 6 inches over a compacted base; garden paths get by with 2 to 3 inches. Pea gravel is rounded and looks great but rolls underfoot; crushed gravel locks together into a firmer surface and stays put. Most landscape suppliers will deliver a half-yard or more — call before ordering, because cubic-yard pricing usually beats per-bag pricing by a wide margin once you're past one yard.`,
},
'square-footage': {
Component: SquareFootageCalculator,
initial: { shapes: [{ id: 'init-1', type: 'rect', length: 12, width: 10, diameter: 6 }] },
title: 'Square Footage Calculator',
subtitle: 'Compute total area for rooms or yards made of multiple rectangles, circles, and triangles.',
category: 'paint',
formula: [
['rectangle', '= L × W'],
['circle', '= π × (D ÷ 2)²'],
['triangle', '= ½ × base × height'],
['total', '= sum of all sections'],
],
howWorks: `Many spaces aren't simple rectangles — an L-shaped room, a yard with a round flower bed, a kitchen with a peninsula. Break the space into rectangles, circles, and triangles, compute each one separately, and add them up. That's what this calculator does. For curves that aren't circles, approximate with a few triangles — even a rough breakdown gets you within 5% of the true area. The result is useful for paint, flooring, sod, fertilizer, anything sold by area.`,
},
});