{
  "schemaVersion": 1,
  "slug": "tile-calculator",
  "category": "household",
  "kind": "implementation",
  "independentValidation": false,
  "implementationHash": "538f611d2d22a5cd3bf1917455af27b371a0068dc67f9782b57b72ffc860b54a",
  "provenance": "Generated from the calculation contract used by the published page. Publication is not external validation.",
  "sourceFiles": [
    "data/calculators/tile-calculator.json",
    "src/engine.js"
  ],
  "runtimeSource": "/sources/engine.txt",
  "runtimeHash": "5c888d8898afbdee36267bb9977829e1e2ac568f6677c8ee87469c139864645c",
  "scope": "The compute function records implemented equations, constants, lookup tables and custom rules. Inputs record defaults and allowed values; outputs record precision and units. Defaults are examples, not recommendations. General background references are not evidence for this specific algorithm.",
  "publishedFormula": {
    "formula": "tile area = length_in × width_in/144; required = ceil(surface/tile area × (1 + waste/100)); boxes = ceil(required/tiles per box)",
    "vars": [],
    "note": "This is an area estimate, not a layout, grout-joint or cutting plan. Confirm box coverage and the installer’s allowance."
  },
  "externalEvidence": null,
  "contract": {
    "compute": "try{if((([\"dimensions\"].includes(String(areaMode)))&&(!Number.isFinite(length)||length<0.001||length>1000))||(([\"dimensions\"].includes(String(areaMode)))&&(!Number.isFinite(width)||width<0.001||width>1000))||((true)&&(!Number.isFinite(tileLength)||tileLength<0.5||tileLength>120))||((true)&&(!Number.isFinite(tileWidth)||tileWidth<0.5||tileWidth>120))||((true)&&(!Number.isFinite(waste)||waste<0||waste>50))||(([\"area\"].includes(String(areaMode)))&&(!Number.isFinite(areaInput)||areaInput<0.001||areaInput>1000000))||((true)&&(!Number.isFinite(tilesPerBox)||tilesPerBox<1||tilesPerBox>10000))||((true)&&(!Number.isFinite(pricePerBox)||pricePerBox<0||pricePerBox>1000000)))throw new Error('inputError');const calculate=function(){const h=(function context() {\n  const DAY=86400000;\n  const own=(o,k)=>Object.prototype.hasOwnProperty.call(o,k);\n  const fail=()=>{throw new Error('inputError');};\n  const num=(v,min=-Infinity,max=Infinity,integer=false)=>{\n    if(!Number.isFinite(v)||v<min||v>max||(integer&&!Number.isInteger(v)))fail();return v;\n  };\n  const choice=(v,values)=>{if(!values.includes(v))fail();return v;};\n  const date=s=>{if(typeof s!=='string'||!/^\\d{4}-\\d{2}-\\d{2}$/.test(s)||s.startsWith('0000'))fail();const d=new Date(s+'T00:00:00Z');if(!Number.isFinite(+d)||d.toISOString().slice(0,10)!==s)fail();return d;};\n  const iso=d=>{if(!Number.isFinite(+d)||d.getUTCFullYear()<1||d.getUTCFullYear()>9999)fail();return d.toISOString().slice(0,10);};\n  const shift=(d,n)=>{const r=new Date(+d+n*DAY);iso(r);return r;};\n  const month=(d,n)=>{const r=new Date(+d);r.setUTCDate(1);r.setUTCMonth(r.getUTCMonth()+n);const end=new Date(+r);end.setUTCMonth(end.getUTCMonth()+1,0);r.setUTCDate(Math.min(d.getUTCDate(),end.getUTCDate()));iso(r);return r;};\n  const weekdays=['Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday'];\n  const work=(d,count)=>{let n=Math.floor(count/7)*5;for(let k=0;k<count%7;k++){const w=(d.getUTCDay()+k)%7;if(w!==0&&w!==6)n++;}return n;};\n  const wholeMonths=(a,b)=>{let n=(b.getUTCFullYear()-a.getUTCFullYear())*12+b.getUTCMonth()-a.getUTCMonth();if(n>=0&&+month(a,n)>+b)n--;if(n<0&&+month(a,n)<+b)n++;return n;};\n  return {DAY,own,fail,num,choice,date,iso,shift,month,weekdays,work,wholeMonths};\n})();const result=(function(v,h){\n    const {num,choice}=h;choice(v.areaMode,['dimensions','area']);if(v.areaMode==='dimensions'){num(v.length,0.001,1000);num(v.width,0.001,1000);}else num(v.areaInput,0.001,1e6);\n    num(v.tileLength,0.001,120);num(v.tileWidth,0.001,120);num(v.waste,0,100);num(v.tilesPerBox,1,10000,true);num(v.pricePerBox,0,1e6);\n    const area=v.areaMode==='area'?v.areaInput:v.length*v.width,tileArea=v.tileLength*v.tileWidth/144,raw=area/tileArea;\n    const ceil=x=>Math.ceil(x-4*Number.EPSILON*Math.max(1,x)),tiles=ceil(raw),withWaste=ceil(raw*(1+v.waste/100)),boxesNeeded=ceil(withWaste/v.tilesPerBox);\n    return {area,tileArea,tiles,withWaste,tilesPerSqft:1/tileArea,tileAreaSqIn:tileArea*144,tilesNeeded:tiles,tilesWithWaste:withWaste,boxesNeeded,totalCost:boxesNeeded*v.pricePerBox,tilesLeftOver:boxesNeeded*v.tilesPerBox-withWaste,coveragePerBox:tileArea*v.tilesPerBox};\n  })({\"areaMode\":(areaMode),\"length\":(length),\"width\":(width),\"areaInput\":(areaInput),\"tileLength\":(tileLength),\"tileWidth\":(tileWidth),\"waste\":(waste),\"tilesPerBox\":(tilesPerBox),\"pricePerBox\":(pricePerBox)},h);return result;};const out=calculate();return Object.fromEntries([\"area\",\"tileArea\",\"tiles\",\"withWaste\",\"tilesPerSqft\",\"boxesNeeded\",\"totalCost\",\"tilesLeftOver\",\"coveragePerBox\"].map(k=>[k,out[k]??null]).concat(Object.entries(out).filter(([k])=>k.startsWith('__'))));}catch(error){return Object.assign(Object.fromEntries([\"area\",\"tileArea\",\"tiles\",\"withWaste\",\"tilesPerSqft\",\"boxesNeeded\",\"totalCost\",\"tilesLeftOver\",\"coveragePerBox\"].map(k=>[k,null])),{__error:error.message==='openingsExceedWallArea'?'openingsExceedWallArea':'inputError'});}",
    "inputs": [
      {
        "name": "length",
        "type": "number",
        "default": 12,
        "min": 0.001,
        "max": 1000,
        "step": 0.01,
        "slider": true,
        "strictRange": true,
        "requiredValue": true,
        "showWhen": {
          "areaMode": [
            "dimensions"
          ]
        }
      },
      {
        "name": "width",
        "type": "number",
        "default": 10,
        "min": 0.001,
        "max": 1000,
        "step": 0.01,
        "slider": true,
        "strictRange": true,
        "requiredValue": true,
        "showWhen": {
          "areaMode": [
            "dimensions"
          ]
        }
      },
      {
        "name": "tileLength",
        "type": "number",
        "default": 12,
        "min": 0.5,
        "max": 120,
        "step": 0.5,
        "slider": true,
        "strictRange": true,
        "requiredValue": true
      },
      {
        "name": "tileWidth",
        "type": "number",
        "default": 12,
        "min": 0.5,
        "max": 120,
        "step": 0.5,
        "slider": true,
        "strictRange": true,
        "requiredValue": true
      },
      {
        "name": "waste",
        "type": "number",
        "default": 10,
        "min": 0,
        "max": 50,
        "step": 1,
        "slider": true,
        "strictRange": true,
        "requiredValue": true
      },
      {
        "type": "select",
        "default": "dimensions",
        "options": [
          {
            "value": "dimensions"
          },
          {
            "value": "area"
          }
        ],
        "advanced": true,
        "name": "areaMode"
      },
      {
        "type": "number",
        "default": 120,
        "min": 0.001,
        "max": 1000000,
        "step": 0.01,
        "strictRange": true,
        "requiredValue": true,
        "advanced": true,
        "name": "areaInput",
        "showWhen": {
          "areaMode": [
            "area"
          ]
        }
      },
      {
        "type": "number",
        "default": 10,
        "min": 1,
        "max": 10000,
        "step": 1,
        "strictRange": true,
        "requiredValue": true,
        "advanced": true,
        "name": "tilesPerBox"
      },
      {
        "type": "number",
        "default": 35,
        "min": 0,
        "max": 1000000,
        "step": 0.01,
        "strictRange": true,
        "requiredValue": true,
        "advanced": true,
        "name": "pricePerBox"
      }
    ],
    "outputs": [
      {
        "name": "area",
        "precision": 1,
        "unit": "sq ft",
        "notation": "auto"
      },
      {
        "name": "tileArea",
        "precision": 3,
        "unit": "sq ft",
        "notation": "auto"
      },
      {
        "name": "tiles",
        "precision": 0,
        "unit": "",
        "notation": "auto"
      },
      {
        "name": "withWaste",
        "precision": 0,
        "unit": "",
        "notation": "auto"
      },
      {
        "name": "tilesPerSqft",
        "precision": 2,
        "unit": "pcs",
        "notation": "auto"
      },
      {
        "name": "boxesNeeded",
        "precision": 0,
        "unit": "",
        "notation": "auto"
      },
      {
        "name": "totalCost",
        "precision": 2,
        "unit": "$",
        "notation": "auto"
      },
      {
        "name": "tilesLeftOver",
        "precision": 0,
        "unit": "",
        "notation": "auto"
      },
      {
        "name": "coveragePerBox",
        "precision": 2,
        "unit": "sq ft",
        "notation": "auto"
      }
    ],
    "interpret": null
  }
}
