\n \n

Gingham Mill

\n\n

\n bolt —\n cloth —\n repeat —\n

\n\n

\n \n \n

\n \n

\n\n

\n\n \n

\n\n

the clothPattern

\n\n

Sample book

\n\n

warp & weftYarns

\n\n

\n Primary\n \n \n \n

\n Opacity\n \n 100%\n

\n\n

\n Secondary\n \n \n \n

\n Opacity\n \n 100%\n

\n\n

\n Accent\n \n \n \n

\n Opacity\n \n 100%\n

\n\n

\n Balance\n \n even\n

Which set of threads shows at a crossing. Even gives you the classic three tones from two colors.

\n\n

settGrid

\n\n

\n Check width\n

\n px\n 0.160 in\n

\n\n \n\n

\n Check height\n

\n px\n 0.160 in\n

\n\n

\n Line weight\n \n 14%\n

\n\n

\n Band shuffle\n \n 234\n

\n\n

\n Grain angle\n \n 0°\n

\n \n \n \n

\n\n

\n Shift across\n \n 0 px\n

\n Shift down\n \n 0 px\n

\n\n

interlacingWeave

Flat keeps every check a solid block — the cleanest export and the smallest file.

\n\n

\n Threads per check\n \n 6\n

\n Weave contrast\n \n 75%\n

\n Yarn variation\n \n 5%\n

\n\n

\n Grain\n \n off\n

Grain is per-pixel noise. It exports exactly in raster formats; SVG approximates it with a turbulence filter.

\n\n

the boltCloth size

\n\n

\n Width\n

\n px\n in\n

\n\n

\n Height\n

\n px\n in\n

\n\n

\n Resolution\n

\n ppi\n print\n

\n\n

\n \n \n \n \n \n

\n \n

\n\n \n

\n\n

\n \n one repeat\n

\n\n

\n \n \n \n \n

\n \n \n

\n\n \n

cutting tableExport

\n\n

\n \n \n \n \n \n

\n\n

\n Quality\n \n 92\n

\n JPEG matte\n \n

\n\n

Take it somewhere else

\n \n \n \n \n \n

\n\n

\n Nothing leaves your machine. Every pixel here is drawn by your browser —\n there is no render server, and no image is ever uploaded.\n

\n\n

\n\n\n\n\n",[19,79],"1133fa07-d19a-46c8-87e4-f53039f0ae24","gingham.js","4f9923b6-a603-11f1-af46-1607ee4eb77e",14,["D",1788266856889],"/**\n * gingham.js — the loom.\n *\n * Pure geometry + color. No DOM, no side effects. Everything downstream\n * (canvas preview, SVG export, CSS export, preset chips) is drawn from the\n * single tile this module builds, so every output format agrees exactly.\n *\n * Model: a woven cloth is warp threads (columns) crossed by weft threads\n * (rows). Each axis is a repeating sequence of bands; each band is dyed with\n * one of three yarns. The color at an intersection is a mix of its warp yarn\n * and its weft yarn — which is why classic gingham reads as three tones from\n * two colors (white/white, white/red, red/red).\n */\n\nexport const YARN = { GROUND: 0, PRIMARY: 1, ACCENT: 2 };\n\nexport const STYLES = [\n { id: \"check\", name: \"Gingham\", blurb: \"The classic even check\", accent: false },\n { id: \"windowpane\", name: \"Windowpane\", blurb: \"Thin lines, wide panes\", accent: false },\n { id: \"tattersall\", name: \"Tattersall\", blurb: \"Two colors of fine line\", accent: true },\n { id: \"triple\", name: \"Triple check\", blurb: \"Three-tone grid\", accent: true },\n { id: \"madras\", name: \"Madras\", blurb: \"Irregular, seeded bands\", accent: true },\n { id: \"stripe\", name: \"Bengal stripe\", blurb: \"Warp only, no cross-check\", accent: false },\n];\n\nexport const WEAVES = [\n { id: \"flat\", name: \"Flat\" },\n { id: \"plain\", name: \"Plain\" },\n { id: \"twill\", name: \"Twill\" },\n { id: \"basket\", name: \"Basket\" },\n];\n\n/* ------------------------------------------------------------------ color */\n\nexport function mulberry32(a) {\n return function () {\n a |= 0;\n a = (a + 0x6d2b79f5) | 0;\n let t = Math.imul(a ^ (a >>> 15), 1 | a);\n t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n };\n}\n\nexport function hexToRgb(hex) {\n let h = String(hex || \"\").trim().replace(/^#/, \"\");\n if (h.length === 3) h = h.split(\"\").map((c) => c + c).join(\"\");\n if (h.length === 8) h = h.slice(0, 6);\n if (!/^[0-9a-fA-F]{6}$/.test(h)) h = \"000000\";\n const n = parseInt(h, 16);\n return { r: (n >> 16) & 255, g: (n >> 8) & 255, b: n & 255 };\n}\n\nexport function rgbToHex({ r, g, b }) {\n const c = (v) => Math.max(0, Math.min(255, Math.round(v))).toString(16).padStart(2, \"0\");\n return \"#\" + c(r) + c(g) + c(b);\n}\n\nexport function yarn(hex, alpha) {\n const { r, g, b } = hexToRgb(hex);\n return { r, g, b, a: Math.max(0, Math.min(1, alpha)) };\n}\n\n/** Mix two colors in premultiplied space so transparency survives correctly. */\nexport function mixPremul(c1, c2, t) {\n const u = 1 - t;\n const a = c1.a * u + c2.a * t;\n if (a <= 1e-6) return { r: 0, g: 0, b: 0, a: 0 };\n return {\n r: (c1.r * c1.a * u + c2.r * c2.a * t) / a,\n g: (c1.g * c1.a * u + c2.g * c2.a * t) / a,\n b: (c1.b * c1.a * u + c2.b * c2.a * t) / a,\n a,\n };\n}\n\n/** Multiply lightness — used for per-thread yarn variation. */\nexport function shade(c, f) {\n return { r: c.r * f, g: c.g * f, b: c.b * f, a: c.a };\n}\n\nexport function toFill(c) {\n const fill = rgbToHex(c);\n const op = Math.round(c.a * 1000) / 1000;\n const css = op >= 1\n ? fill\n : `rgba(${Math.round(c.r)},${Math.round(c.g)},${Math.round(c.b)},${op})`;\n return { fill, op, css };\n}\n\nexport function relLuminance(hex) {\n const { r, g, b } = hexToRgb(hex);\n const f = (v) => {\n const s = v / 255;\n return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);\n };\n return 0.2126 * f(r) + 0.7152 * f(g) + 0.0722 * f(b);\n}\n\n/* ------------------------------------------------------------------ bands */\n\n/** Band sequence for one axis, in units of the check size. */\nfunction bandSpec(cfg, axis) {\n const r = Math.max(0.04, Math.min(0.96, cfg.lineRatio));\n const G = YARN.GROUND, P = YARN.PRIMARY, A = YARN.ACCENT;\n switch (cfg.style) {\n case \"windowpane\":\n return [{ u: r, y: P }, { u: 1 - r, y: G }];\n case \"tattersall\":\n return [{ u: r, y: P }, { u: 1 - r, y: G }, { u: r, y: A }, { u: 1 - r, y: G }];\n case \"triple\":\n return [{ u: 1, y: G }, { u: 1, y: P }, { u: 1, y: G }, { u: 1, y: A }];\n case \"stripe\":\n return axis === \"warp\" ? [{ u: 1, y: G }, { u: 1, y: P }] : [{ u: 1, y: G }];\n case \"madras\":\n return madrasBands(cfg.seed + (axis === \"warp\" ? 0 : 1013));\n case \"check\":\n default:\n return [{ u: 1, y: G }, { u: 1, y: P }];\n }\n}\n\nfunction madrasBands(seed) {\n const rnd = mulberry32(seed >>> 0);\n const widths = [0.5, 0.75, 1, 1, 1.5, 2, 3];\n const pick = () => widths[Math.floor(rnd() * widths.length)];\n const groups = 4 + Math.floor(rnd() * 4);\n const out = [];\n for (let i = 0; i < groups; i++) {\n out.push({ u: pick(), y: YARN.GROUND });\n out.push({ u: rnd() < 0.62 ? 0.5 : pick(), y: rnd() < 0.6 ? YARN.PRIMARY : YARN.ACCENT });\n }\n return out;\n}\n\n/**\n * Turn float widths into whole pixels without losing the total. Cumulative\n * rounding keeps every band edge on a pixel boundary, so the tile stays crisp\n * and the SVG and the PNG land on exactly the same coordinates.\n */\nfunction snapWidths(units, scale) {\n let acc = 0, emitted = 0;\n const out = [];\n for (const u of units) {\n acc += u * scale;\n const w = Math.max(1, Math.round(acc) - emitted);\n out.push(w);\n emitted += w;\n }\n return out;\n}\n\n/**\n * Expand bands into strands. Flat cloth gets one strand per band; a woven\n * cloth subdivides each band into individual threads that can pass over and\n * under each other.\n */\nfunction strands(pxWidths, spec, threadPx, rnd, jitter) {\n const out = [];\n let x = 0, i = 0;\n for (let b = 0; b < pxWidths.length; b++) {\n const bandW = pxWidths[b], y = spec[b].y;\n if (!threadPx) {\n out.push({ x, w: bandW, y, j: 1, i: i++ });\n x += bandW;\n continue;\n }\n const count = Math.max(1, Math.round(bandW / threadPx));\n const parts = snapWidths(new Array(count).fill(1), bandW / count);\n let used = 0;\n for (let k = 0; k < count; k++) {\n const w = k === count - 1 ? bandW - used : parts[k];\n used += w;\n if (w <= 0) continue;\n out.push({ x, w, y, j: 1 + (rnd() - 0.5) * 2 * jitter, i: i++ });\n x += w;\n }\n }\n return out;\n}\n\nfunction warpOnTop(weave, i, j) {\n switch (weave) {\n case \"twill\": return (((i - j) % 4) + 4) % 4 < 2;\n case \"basket\": return ((i >> 1) + (j >> 1)) % 2 === 0;\n case \"plain\":\n default: return (i + j) % 2 === 0;\n }\n}\n\nconst MAX_RECTS = 44000;\n\n/**\n * Build one repeat of the cloth.\n * Returns integer-pixel rects covering a tile of exactly w x h.\n */\nexport function buildTile(cfg) {\n const warpSpec = bandSpec(cfg, \"warp\");\n const weftSpec = bandSpec(cfg, \"weft\");\n const warpPx = snapWidths(warpSpec.map((b) => b.u), Math.max(1, cfg.checkX));\n const weftPx = snapWidths(weftSpec.map((b) => b.u), Math.max(1, cfg.checkY));\n const tileW = warpPx.reduce((a, b) => a + b, 0);\n const tileH = weftPx.reduce((a, b) => a + b, 0);\n\n const woven = cfg.weave !== \"flat\";\n let threadPx = null;\n if (woven) {\n threadPx = Math.max(1, Math.round(Math.min(cfg.checkX, cfg.checkY) / cfg.threads));\n // Keep the tile within a rect budget so huge weaves cannot stall export.\n while (Math.ceil(tileW / threadPx) * Math.ceil(tileH / threadPx) > MAX_RECTS) threadPx++;\n }\n\n const jitter = woven ? cfg.jitter : 0;\n const cols = strands(warpPx, warpSpec, threadPx, mulberry32(cfg.seed + 7), jitter);\n const rows = strands(weftPx, weftSpec, threadPx, mulberry32(cfg.seed + 991), jitter);\n\n const yarns = [cfg.colors.secondary, cfg.colors.primary, cfg.colors.accent];\n const depth = woven ? cfg.weaveDepth : 0;\n const base = Math.max(0, Math.min(1, cfg.blend));\n\n const rects = [];\n for (const row of rows) {\n let run = null;\n for (const col of cols) {\n let t = base;\n if (woven) {\n t = warpOnTop(cfg.weave, col.i, row.i) ? base * (1 - depth) : base + (1 - base) * depth;\n }\n let c = mixPremul(yarns[col.y], yarns[row.y], t);\n if (jitter) c = shade(c, col.j * (1 - t) + row.j * t);\n const f = toFill(c);\n // Merge equal neighbours into runs: keeps flat gingham at 4 rects and\n // trims a woven tile substantially.\n if (run && run.css === f.css) {\n run.w += col.w;\n } else {\n run = { x: col.x, y: row.x, w: col.w, h: row.w, ...f };\n rects.push(run);\n }\n }\n }\n\n return { w: tileW, h: tileH, rects, threadPx, cols: cols.length, rows: rows.length };\n}\n\n/* -------------------------------------------------------------- measuring */\n\nexport const CM_PER_IN = 2.54;\n\nexport function pxToUnit(px, ppi, unit) {\n const inches = px / Math.max(1, ppi);\n return unit === \"cm\" ? inches * CM_PER_IN : inches;\n}\n\nexport function unitToPx(value, ppi, unit) {\n const inches = unit === \"cm\" ? value / CM_PER_IN : value;\n return inches * Math.max(1, ppi);\n}\n\nexport function fmtLen(px, ppi, unit, digits) {\n const v = pxToUnit(px, ppi, unit);\n const d = digits != null ? digits : v < 1 ? 3 : v < 10 ? 2 : 1;\n return v.toFixed(d);\n}\n",[19,86],"861db297-da87-4a2c-8c5c-ea36b1005f69","favicon.svg","4f644cc2-a603-11f1-b365-1607ee4eb77e",10,["D",1788266857181],"\n",[19,93],"9a122d0a-45e6-4344-962b-ebb0404c03c9","app.js","4f78532a-a603-11f1-b20a-1607ee4eb77e",11,["D",1788266857184],"/**\n * app.js — the mill floor.\n *\n * Holds the working state, keeps the controls and the cloth in step, draws the\n * rulers, and cuts the finished piece. Everything runs locally: the only\n * network requests this page makes are for its own files and fonts.\n */\n\nimport {\n buildTile, yarn, fmtLen, pxToUnit, unitToPx,\n STYLES, WEAVES, relLuminance, hexToRgb, rgbToHex,\n} from \"./gingham.js\";\nimport {\n paint, toSVG, tileSVG, rasterCanvas, canvasToBlob, supportsFormat, toCSS,\n} from \"./render.js\";\nimport {\n defaults, PRESETS, applyPreset, randomBolt, boltNumber, encodeConfig, decodeConfig,\n} from \"./presets.js\";\n\nconst $ = (id) => document.getElementById(id);\n\nlet state = (location.hash.length > 1 && decodeConfig(location.hash.slice(1))) || defaults();\nlet zoom = \"fit\";\nlet tile = null;\nlet view = { scale: 1, dispW: 0, dispH: 0, sx: 0, sy: 0 };\n\nconst swatchScroll = $(\"swatchScroll\");\nconst swatch = $(\"swatch\");\nconst preview = $(\"preview\");\nconst pctx = preview.getContext(\"2d\");\n\n/* ----------------------------------------------------------- state → engine */\n\nfunction engineCfg(s) {\n return {\n style: s.style,\n checkX: s.checkX,\n checkY: s.checkY,\n lineRatio: s.lineRatio,\n seed: s.seed,\n blend: s.blend,\n weave: s.weave,\n threads: s.threads,\n weaveDepth: s.weaveDepth,\n jitter: s.jitter,\n grain: s.grain,\n angle: s.angle,\n offsetX: s.offsetX,\n offsetY: s.offsetY,\n colors: {\n primary: yarn(s.primary.hex, s.primary.alpha),\n secondary: yarn(s.secondary.hex, s.secondary.alpha),\n accent: yarn(s.accent.hex, s.accent.alpha),\n },\n };\n}\n\nfunction styleDef() {\n return STYLES.find((s) => s.id === state.style) || STYLES[0];\n}\n\n/* ------------------------------------------------------------------ chrome */\n\n/** Lift a color until it can carry small text on the indigo ground. */\nfunction readableOnDark(hex) {\n let c = hexToRgb(hex);\n for (let i = 0; i < 14 && relLuminance(rgbToHex(c)) < 0.3; i++) {\n c = { r: c.r + (255 - c.r) * 0.2, g: c.g + (255 - c.g) * 0.2, b: c.b + (255 - c.b) * 0.2 };\n }\n return rgbToHex(c);\n}\n\n/** The instrument takes its accent from the cloth on the loom. */\nfunction tintUI() {\n let src = \"#d8a13a\";\n if (state.primary.alpha > 0.25) src = state.primary.hex;\n else if (state.secondary.alpha > 0.25) src = state.secondary.hex;\n const accent = readableOnDark(src);\n const root = document.documentElement.style;\n root.setProperty(\"--accent\", accent);\n root.setProperty(\"--accent-ink\", relLuminance(accent) > 0.45 ? \"#11161c\" : \"#f7f4ec\");\n}\n\nlet toastTimer;\nfunction toast(msg) {\n const el = $(\"toast\");\n el.textContent = msg;\n el.classList.add(\"is-up\");\n clearTimeout(toastTimer);\n toastTimer = setTimeout(() => el.classList.remove(\"is-up\"), 2200);\n}\n\n/* ---------------------------------------------------------------- preview */\n\nfunction drawPreview(cfg) {\n const availW = Math.max(40, swatchScroll.clientWidth);\n const availH = Math.max(40, swatchScroll.clientHeight);\n const W = state.width, H = state.height;\n\n const scale = zoom === \"fit\" ? Math.min(availW / W, availH / H, 1) : 1;\n const dispW = Math.max(1, Math.round(W * scale));\n const dispH = Math.max(1, Math.round(H * scale));\n swatch.style.width = dispW + \"px\";\n swatch.style.height = dispH + \"px\";\n\n const viewW = Math.min(dispW, availW);\n const viewH = Math.min(dispH, availH);\n const sx = Math.min(swatchScroll.scrollLeft, Math.max(0, dispW - viewW));\n const sy = Math.min(swatchScroll.scrollTop, Math.max(0, dispH - viewH));\n\n // Lay the cloth in the middle of the table when it fits; the rulers follow it.\n const padX = zoom === \"fit\" ? Math.max(0, Math.floor((availW - dispW) / 2)) : 0;\n const padY = zoom === \"fit\" ? Math.max(0, Math.floor((availH - dispH) / 2)) : 0;\n swatch.style.marginLeft = padX + \"px\";\n swatch.style.marginTop = padY + \"px\";\n\n const dpr = Math.min(2, window.devicePixelRatio || 1);\n preview.style.left = sx + \"px\";\n preview.style.top = sy + \"px\";\n preview.style.width = viewW + \"px\";\n preview.style.height = viewH + \"px\";\n preview.width = Math.max(1, Math.round(viewW * dpr));\n preview.height = Math.max(1, Math.round(viewH * dpr));\n\n paint(pctx, cfg, W, H, scale * dpr, {\n tile,\n viewX: Math.round(sx * dpr),\n viewY: Math.round(sy * dpr),\n viewW: preview.width,\n viewH: preview.height,\n });\n\n view = { scale, dispW, dispH, sx, sy, padX, padY };\n\n // The mat is ruled in whatever unit you are working in.\n const gridPx = unitToPx(1, state.ppi, state.unit) * scale;\n const step = gridPx > 14 ? gridPx : gridPx > 3 ? gridPx * 4 : 0;\n document.getElementById(\"mat\").style.setProperty(\n \"--mat-grid\", step ? `${step}px ${step}px` : \"0 0\");\n}\n\n/* ----------------------------------------------------------------- rulers */\n\nconst TICK_LADDER = [1, 2, 5, 10, 20, 50, 100, 200, 500];\n\nfunction subdivisions(unitPx, unit) {\n if (unit === \"cm\") {\n if (unitPx > 90) return 10;\n if (unitPx > 45) return 5;\n return unitPx > 22 ? 2 : 1;\n }\n if (unitPx > 150) return 8;\n if (unitPx > 76) return 4;\n return unitPx > 36 ? 2 : 1;\n}\n\nfunction drawRuler(cv, axis) {\n const dpr = Math.min(2, window.devicePixelRatio || 1);\n const cssLen = (axis === \"x\" ? cv.clientWidth : cv.clientHeight) ||\n (axis === \"x\" ? swatchScroll.clientWidth : swatchScroll.clientHeight);\n const thick = 30;\n cv.width = Math.max(1, Math.round((axis === \"x\" ? cssLen : thick) * dpr));\n cv.height = Math.max(1, Math.round((axis === \"x\" ? thick : cssLen) * dpr));\n\n const ctx = cv.getContext(\"2d\");\n ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n const css = getComputedStyle(document.documentElement);\n const accent = css.getPropertyValue(\"--accent\").trim() || \"#d8a13a\";\n ctx.clearRect(0, 0, cv.width, cv.height);\n\n const unitPx = unitToPx(1, state.ppi, state.unit) * view.scale;\n if (!isFinite(unitPx) || unitPx <= 0) return;\n\n let step = TICK_LADDER.find((s) => s * unitPx >= 38) || 500;\n const subs = subdivisions(unitPx * step, state.unit);\n const scroll = axis === \"x\" ? view.sx : view.sy;\n const pad = (axis === \"x\" ? view.padX : view.padY) || 0;\n const clothLen = axis === \"x\" ? view.dispW : view.dispH;\n const minor = unitPx * step / subs;\n\n ctx.font = \"500 9px 'IBM Plex Mono', ui-monospace, monospace\";\n ctx.textBaseline = axis === \"x\" ? \"alphabetic\" : \"middle\";\n\n // The cloth edge, marked in the accent so the zero point is unmistakable.\n ctx.fillStyle = accent;\n const edge = Math.max(0, Math.min(cssLen - pad, clothLen - scroll));\n if (axis === \"x\") ctx.fillRect(pad, thick - 1.5, edge, 1.5);\n else ctx.fillRect(thick - 1.5, pad, 1.5, edge);\n\n let i = 0;\n for (;; i++) {\n const pos = i * minor - scroll + pad;\n if (pos > cssLen + 1) break;\n if (i * minor > clothLen + 1) break;\n if (pos < -1) continue;\n\n const isMajor = i % subs === 0;\n const isHalf = !isMajor && subs % 2 === 0 && i % (subs / 2) === 0;\n const len = isMajor ? 11 : isHalf ? 7 : 4;\n ctx.fillStyle = isMajor ? \"#93a6b8\" : \"#4d6175\";\n\n if (axis === \"x\") {\n ctx.fillRect(Math.round(pos), thick - 2 - len, 1, len);\n if (isMajor) {\n const label = String((i / subs) * step);\n ctx.fillStyle = \"#93a6b8\";\n ctx.fillText(label, Math.round(pos) + 3, 11);\n }\n } else {\n ctx.fillRect(thick - 2 - len, Math.round(pos), len, 1);\n if (isMajor) {\n const label = String((i / subs) * step);\n ctx.fillStyle = \"#93a6b8\";\n ctx.save();\n ctx.translate(4, Math.round(pos) + 9);\n ctx.fillText(label, 0, 0);\n ctx.restore();\n }\n }\n }\n}\n\nfunction drawRulers() {\n drawRuler($(\"rulerTop\"), \"x\");\n drawRuler($(\"rulerLeft\"), \"y\");\n}\n\n/* -------------------------------------------------------------- readouts */\n\nfunction unitName() {\n return state.unit === \"cm\" ? \"cm\" : \"in\";\n}\n\nfunction updateReadouts() {\n const u = unitName();\n $(\"specBolt\").textContent = \"№ \" + boltNumber(state);\n $(\"specSize\").textContent =\n `${state.width}×${state.height} px · ${fmtLen(state.width, state.ppi, state.unit, 2)}×${fmtLen(state.height, state.ppi, state.unit, 2)} ${u} @ ${state.ppi} ppi`;\n\n const across = state.width / tile.w;\n const down = state.height / tile.h;\n $(\"specRepeat\").textContent = `${tile.w}×${tile.h} px · ${across.toFixed(1)}×${down.toFixed(1)}`;\n\n $(\"caliperText\").textContent =\n `one repeat — ${tile.w}×${tile.h} px, ${fmtLen(tile.w, state.ppi, state.unit)}×${fmtLen(tile.h, state.ppi, state.unit)} ${u}` +\n (tile.threadPx ? ` · ${tile.threadPx} px thread` : \"\");\n\n $(\"checkXOut\").textContent = `${fmtLen(state.checkX, state.ppi, state.unit)} ${u}`;\n $(\"checkYOut\").textContent = `${fmtLen(state.checkY, state.ppi, state.unit)} ${u}`;\n $(\"unitBadge\").textContent = u;\n for (const el of document.querySelectorAll(\".unit-label\")) el.textContent = u;\n\n const mp = (state.width * state.height) / 1e6;\n const warn = $(\"sizeWarn\");\n if (mp > 16) {\n warn.hidden = false;\n warn.textContent = `${mp.toFixed(1)} megapixels. Raster export will take a moment and needs about ${(mp * 4).toFixed(0)} MB of memory; mobile Safari caps canvases near 16 MP.`;\n } else {\n warn.hidden = true;\n }\n\n const ppiNote = state.ppi >= 250 ? \"print\" : state.ppi >= 144 ? \"retina\" : \"screen\";\n $(\"ppiNote\").textContent = ppiNote;\n}\n\n/* ------------------------------------------------------------ render loop */\n\nlet queued = false;\nfunction schedule() {\n if (queued) return;\n queued = true;\n requestAnimationFrame(() => {\n queued = false;\n const cfg = engineCfg(state);\n tile = buildTile(cfg);\n tintUI();\n drawPreview(cfg);\n drawRulers();\n updateReadouts();\n pushHash();\n });\n}\n\nlet hashTimer;\nfunction pushHash() {\n clearTimeout(hashTimer);\n hashTimer = setTimeout(() => {\n history.replaceState(null, \"\", \"#\" + encodeConfig(state));\n }, 500);\n}\n\n/* ------------------------------------------------------------- build UI */\n\nfunction buildStyleGrid() {\n const grid = $(\"styleGrid\");\n grid.innerHTML = \"\";\n for (const s of STYLES) {\n const b = document.createElement(\"button\");\n b.type = \"button\";\n b.className = \"style-btn\";\n b.dataset.style = s.id;\n b.textContent = s.name;\n b.setAttribute(\"role\", \"radio\");\n b.addEventListener(\"click\", () => {\n if (state.style === \"stripe\" && s.id !== \"stripe\" && state.blend === 0) state.blend = 0.5;\n if (s.id === \"stripe\" && state.blend === 0.5) state.blend = 0;\n state.style = s.id;\n syncControls();\n schedule();\n });\n grid.appendChild(b);\n }\n}\n\nfunction buildWeaveSeg() {\n const seg = $(\"weaveSeg\");\n seg.innerHTML = \"\";\n for (const w of WEAVES) {\n const b = document.createElement(\"button\");\n b.type = \"button\";\n b.className = \"seg-btn\";\n b.dataset.weave = w.id;\n b.textContent = w.name.toLowerCase();\n b.addEventListener(\"click\", () => {\n state.weave = w.id;\n syncControls();\n schedule();\n });\n seg.appendChild(b);\n }\n}\n\nconst CHIP_PX = 96;\n\nfunction buildChips() {\n const wrap = $(\"presetChips\");\n wrap.innerHTML = \"\";\n for (const preset of PRESETS) {\n const btn = document.createElement(\"button\");\n btn.type = \"button\";\n btn.className = \"chip\";\n btn.title = preset.note;\n\n const cv = document.createElement(\"canvas\");\n cv.width = cv.height = CHIP_PX;\n const cfg = engineCfg(applyPreset(defaults(), preset));\n // Normalise every chip to show roughly two repeats, so the sample book\n // reads as a set rather than a jumble of scales.\n const probe = buildTile(cfg);\n const k = Math.min(4, Math.max(0.06, (CHIP_PX / 2.2) / Math.max(probe.w, probe.h)));\n const chipCfg = {\n ...cfg,\n checkX: Math.max(1, Math.round(cfg.checkX * k)),\n checkY: Math.max(1, Math.round(cfg.checkY * k)),\n grain: 0,\n };\n const ctx = cv.getContext(\"2d\");\n paint(ctx, chipCfg, CHIP_PX, CHIP_PX, 1);\n // Slide a checkerboard underneath so a transparent yarn reads as clear\n // rather than as the panel behind it.\n ctx.globalCompositeOperation = \"destination-over\";\n ctx.fillStyle = \"#c9c9c9\";\n ctx.fillRect(0, 0, CHIP_PX, CHIP_PX);\n ctx.fillStyle = \"#9a9a9a\";\n for (let y = 0; y < CHIP_PX; y += 8) {\n for (let x = 0; x < CHIP_PX; x += 8) {\n if (((x + y) / 8) % 2 === 0) ctx.fillRect(x, y, 8, 8);\n }\n }\n ctx.globalCompositeOperation = \"source-over\";\n\n const name = document.createElement(\"b\");\n name.textContent = preset.name;\n btn.append(cv, name);\n btn.addEventListener(\"click\", () => {\n const keep = { width: state.width, height: state.height, ppi: state.ppi, unit: state.unit, matte: state.matte };\n state = { ...applyPreset(defaults(), preset), ...keep };\n syncControls();\n schedule();\n toast(`${preset.name} — ${preset.note}`);\n });\n wrap.appendChild(btn);\n }\n}\n\n/* --------------------------------------------------- controls → state ← */\n\nfunction syncControls() {\n const s = state;\n\n for (const b of document.querySelectorAll(\".style-btn\")) {\n const on = b.dataset.style === s.style;\n b.classList.toggle(\"is-on\", on);\n b.setAttribute(\"aria-checked\", on ? \"true\" : \"false\");\n }\n $(\"styleBlurb\").textContent = styleDef().blurb + \".\";\n\n for (const b of document.querySelectorAll(\"#weaveSeg .seg-btn\")) {\n b.classList.toggle(\"is-on\", b.dataset.weave === s.weave);\n }\n for (const b of document.querySelectorAll(\"[data-unit]\")) {\n b.classList.toggle(\"is-on\", b.dataset.unit === s.unit);\n }\n for (const b of document.querySelectorAll(\"[data-backdrop]\")) {\n b.classList.toggle(\"is-on\", b.dataset.backdrop === s.backdrop);\n }\n for (const b of document.querySelectorAll(\"[data-zoom]\")) {\n b.classList.toggle(\"is-on\", b.dataset.zoom === zoom);\n }\n swatch.dataset.backdrop = s.backdrop;\n\n for (const key of [\"primary\", \"secondary\", \"accent\"]) {\n setVal($(key + \"Color\"), s[key].hex);\n setVal($(key + \"Hex\"), s[key].hex);\n $(key + \"Alpha\").value = Math.round(s[key].alpha * 100);\n $(key + \"AlphaOut\").textContent =\n s[key].alpha === 0 ? \"clear\" : Math.round(s[key].alpha * 100) + \"%\";\n }\n $(\"accentYarn\").hidden = !styleDef().accent;\n\n $(\"blend\").value = Math.round(s.blend * 100);\n $(\"blendOut\").textContent =\n s.blend === 0.5 ? \"even\" : s.blend === 0 ? \"warp\" : s.blend === 1 ? \"weft\" : Math.round(s.blend * 100) + \"%\";\n\n setVal($(\"checkX\"), s.checkX);\n setVal($(\"checkY\"), s.checkY);\n $(\"linkChecks\").classList.toggle(\"is-on\", s.linkChecks);\n $(\"linkChecks\").setAttribute(\"aria-pressed\", s.linkChecks ? \"true\" : \"false\");\n $(\"checkYRow\").hidden = s.linkChecks;\n\n $(\"lineRatioRow\").hidden = !(s.style === \"windowpane\" || s.style === \"tattersall\");\n $(\"lineRatio\").value = Math.round(s.lineRatio * 100);\n $(\"lineRatioOut\").textContent = Math.round(s.lineRatio * 100) + \"%\";\n\n $(\"seedRow\").hidden = s.style !== \"madras\";\n $(\"seed\").value = s.seed;\n $(\"seedOut\").textContent = s.seed;\n\n $(\"angle\").value = s.angle;\n $(\"angleOut\").textContent = s.angle + \"°\";\n $(\"offsetX\").value = s.offsetX;\n $(\"offsetXOut\").textContent = s.offsetX + \" px\";\n $(\"offsetY\").value = s.offsetY;\n $(\"offsetYOut\").textContent = s.offsetY + \" px\";\n\n for (const el of document.querySelectorAll(\".weave-only\")) el.hidden = s.weave === \"flat\";\n $(\"weaveHint\").textContent = s.weave === \"flat\"\n ? \"Flat keeps every check a solid block — the cleanest export and the smallest file.\"\n : \"Threads pass over and under each other. Zoom to 1:1 to see the interlacing.\";\n\n $(\"threads\").value = s.threads;\n $(\"threadsOut\").textContent = s.threads;\n $(\"weaveDepth\").value = Math.round(s.weaveDepth * 100);\n $(\"weaveDepthOut\").textContent = Math.round(s.weaveDepth * 100) + \"%\";\n $(\"jitter\").value = Math.round(s.jitter * 100);\n $(\"jitterOut\").textContent = Math.round(s.jitter * 100) + \"%\";\n $(\"grain\").value = Math.round(s.grain * 100);\n $(\"grainOut\").textContent = s.grain === 0 ? \"off\" : Math.round(s.grain * 100) + \"%\";\n\n setVal($(\"width\"), s.width);\n setVal($(\"height\"), s.height);\n setVal($(\"ppi\"), s.ppi);\n setVal($(\"widthUnit\"), round2(pxToUnit(s.width, s.ppi, s.unit)));\n setVal($(\"heightUnit\"), round2(pxToUnit(s.height, s.ppi, s.unit)));\n $(\"matteColor\").value = s.matte;\n}\n\n/** Never overwrite the field currently under the cursor. */\nfunction setVal(el, v) {\n if (el !== document.activeElement) el.value = v;\n}\n\nfunction round2(v) {\n return Math.round(v * 100) / 100;\n}\n\nfunction clampInt(v, lo, hi, fallback) {\n const n = Math.round(Number(v));\n if (!isFinite(n)) return fallback;\n return Math.max(lo, Math.min(hi, n));\n}\n\n/* --------------------------------------------------------------- wiring */\n\nfunction wire() {\n // Yarn colors\n for (const key of [\"primary\", \"secondary\", \"accent\"]) {\n $(key + \"Color\").addEventListener(\"input\", (e) => {\n state[key] = { hex: e.target.value, alpha: state[key].alpha > 0 ? state[key].alpha : 1 };\n syncControls();\n schedule();\n });\n $(key + \"Hex\").addEventListener(\"change\", (e) => {\n const v = e.target.value.trim();\n if (/^#?[0-9a-fA-F]{3}$|^#?[0-9a-fA-F]{6}$/.test(v)) {\n state[key].hex = rgbToHex(hexToRgb(v));\n }\n syncControls();\n schedule();\n });\n $(key + \"Alpha\").addEventListener(\"input\", (e) => {\n state[key].alpha = Number(e.target.value) / 100;\n syncControls();\n schedule();\n });\n }\n for (const b of document.querySelectorAll(\"[data-clear]\")) {\n b.addEventListener(\"click\", () => {\n const k = b.dataset.clear;\n state[k].alpha = state[k].alpha === 0 ? 1 : 0;\n syncControls();\n schedule();\n });\n }\n\n slider(\"blend\", (v) => (state.blend = v / 100));\n slider(\"lineRatio\", (v) => (state.lineRatio = v / 100));\n slider(\"seed\", (v) => (state.seed = v));\n slider(\"angle\", (v) => (state.angle = v));\n slider(\"offsetX\", (v) => (state.offsetX = v));\n slider(\"offsetY\", (v) => (state.offsetY = v));\n slider(\"threads\", (v) => (state.threads = v));\n slider(\"weaveDepth\", (v) => (state.weaveDepth = v / 100));\n slider(\"jitter\", (v) => (state.jitter = v / 100));\n slider(\"grain\", (v) => (state.grain = v / 100));\n\n $(\"checkX\").addEventListener(\"input\", (e) => {\n state.checkX = clampInt(e.target.value, 1, 2000, state.checkX);\n if (state.linkChecks) state.checkY = state.checkX;\n syncControls();\n schedule();\n });\n $(\"checkY\").addEventListener(\"input\", (e) => {\n state.checkY = clampInt(e.target.value, 1, 2000, state.checkY);\n syncControls();\n schedule();\n });\n $(\"linkChecks\").addEventListener(\"click\", () => {\n state.linkChecks = !state.linkChecks;\n if (state.linkChecks) state.checkY = state.checkX;\n syncControls();\n schedule();\n });\n\n for (const b of document.querySelectorAll(\"#angleQuick .tiny\")) {\n b.addEventListener(\"click\", () => {\n state.angle = Number(b.dataset.angle);\n syncControls();\n schedule();\n });\n }\n\n // Cloth size: pixels and physical length stay in step through the ppi.\n $(\"width\").addEventListener(\"input\", (e) => {\n state.width = clampInt(e.target.value, 1, 20000, state.width);\n syncControls();\n schedule();\n });\n $(\"height\").addEventListener(\"input\", (e) => {\n state.height = clampInt(e.target.value, 1, 20000, state.height);\n syncControls();\n schedule();\n });\n $(\"ppi\").addEventListener(\"input\", (e) => {\n state.ppi = clampInt(e.target.value, 1, 2400, state.ppi);\n syncControls();\n schedule();\n });\n $(\"widthUnit\").addEventListener(\"input\", (e) => {\n const n = Number(e.target.value);\n if (!isFinite(n) || n <= 0) return;\n state.width = clampInt(unitToPx(n, state.ppi, state.unit), 1, 20000, state.width);\n $(\"width\").value = state.width;\n schedule();\n });\n $(\"heightUnit\").addEventListener(\"input\", (e) => {\n const n = Number(e.target.value);\n if (!isFinite(n) || n <= 0) return;\n state.height = clampInt(unitToPx(n, state.ppi, state.unit), 1, 20000, state.height);\n $(\"height\").value = state.height;\n schedule();\n });\n\n for (const b of document.querySelectorAll(\"#sizeQuick .tiny\")) {\n b.addEventListener(\"click\", () => {\n const [w, h, p] = b.dataset.size.split(\",\").map(Number);\n state.width = w;\n state.height = h;\n state.ppi = p;\n syncControls();\n schedule();\n });\n }\n\n for (const b of document.querySelectorAll(\"[data-unit]\")) {\n b.addEventListener(\"click\", () => {\n state.unit = b.dataset.unit;\n syncControls();\n schedule();\n });\n }\n for (const b of document.querySelectorAll(\"[data-backdrop]\")) {\n b.addEventListener(\"click\", () => {\n state.backdrop = b.dataset.backdrop;\n syncControls();\n schedule();\n });\n }\n for (const b of document.querySelectorAll(\"[data-zoom]\")) {\n b.addEventListener(\"click\", () => {\n zoom = b.dataset.zoom;\n swatchScroll.scrollTo(0, 0);\n syncControls();\n schedule();\n });\n }\n\n $(\"matteColor\").addEventListener(\"input\", (e) => (state.matte = e.target.value));\n $(\"quality\").addEventListener(\"input\", (e) => ($(\"qualityOut\").textContent = e.target.value));\n\n $(\"randomBolt\").addEventListener(\"click\", pullBolt);\n\n swatchScroll.addEventListener(\"scroll\", () => schedule(), { passive: true });\n\n let resizeTimer;\n window.addEventListener(\"resize\", () => {\n clearTimeout(resizeTimer);\n resizeTimer = setTimeout(schedule, 80);\n });\n\n // The first paint can land before fonts and flex have settled, which would\n // leave the cloth scaled to a stale box.\n if (window.ResizeObserver) {\n new ResizeObserver(() => schedule()).observe(swatchScroll);\n }\n if (document.fonts && document.fonts.ready) document.fonts.ready.then(schedule);\n\n document.addEventListener(\"keydown\", (e) => {\n if (e.metaKey || e.ctrlKey || e.altKey) return;\n const t = e.target;\n if (t && (t.tagName === \"INPUT\" || t.tagName === \"TEXTAREA\")) return;\n if (e.key === \"r\" || e.key === \"R\") {\n e.preventDefault();\n pullBolt();\n }\n });\n\n wireExport();\n}\n\nfunction slider(id, apply) {\n $(id).addEventListener(\"input\", (e) => {\n apply(Number(e.target.value));\n syncControls();\n schedule();\n });\n}\n\nfunction pullBolt() {\n const keep = { width: state.width, height: state.height, ppi: state.ppi, unit: state.unit, matte: state.matte, backdrop: state.backdrop };\n state = { ...randomBolt(defaults()), ...keep };\n syncControls();\n schedule();\n toast(\"Bolt № \" + boltNumber(state));\n}\n\n/* --------------------------------------------------------------- export */\n\nconst MIME = {\n png: \"image/png\",\n jpeg: \"image/jpeg\",\n webp: \"image/webp\",\n avif: \"image/avif\",\n};\n\nfunction baseName() {\n return `gingham-${state.style}-${state.width}x${state.height}-${state.ppi}ppi`;\n}\n\nfunction download(blob, filename) {\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = filename;\n document.body.appendChild(a);\n a.click();\n a.remove();\n setTimeout(() => URL.revokeObjectURL(url), 4000);\n}\n\nasync function exportFormat(fmt) {\n const cfg = engineCfg(state);\n if (fmt === \"svg\") {\n const svg = toSVG(cfg, state.width, state.height, { tile, title: `Gingham № ${boltNumber(state)}` });\n download(new Blob([svg], { type: \"image/svg+xml\" }), baseName() + \".svg\");\n toast(`SVG cut — ${(svg.length / 1024).toFixed(1)} KB, ${tile.rects.length} shapes per repeat`);\n return;\n }\n\n const mime = MIME[fmt];\n const opaque = fmt === \"jpeg\";\n toast(\"Weaving \" + fmt.toUpperCase() + \"…\");\n await new Promise((r) => setTimeout(r, 16));\n\n let canvas;\n try {\n canvas = rasterCanvas(cfg, state.width, state.height, { tile, matte: opaque ? state.matte : null });\n } catch (err) {\n toast(\"That canvas is too large for this browser. Try fewer pixels.\");\n return;\n }\n const blob = await canvasToBlob(canvas, mime, Number($(\"quality\").value) / 100);\n if (!blob) {\n toast(\"This browser could not encode \" + fmt.toUpperCase() + \".\");\n return;\n }\n download(blob, `${baseName()}.${fmt === \"jpeg\" ? \"jpg\" : fmt}`);\n toast(`${fmt.toUpperCase()} cut — ${(blob.size / 1024).toFixed(0)} KB`);\n}\n\nasync function copyText(text, note) {\n try {\n await navigator.clipboard.writeText(text);\n toast(note);\n } catch {\n toast(\"Clipboard blocked by the browser.\");\n }\n}\n\nasync function runAction(act) {\n const cfg = engineCfg(state);\n if (act === \"tile-svg\") {\n download(new Blob([tileSVG(cfg, { tile })], { type: \"image/svg+xml\" }), `${baseName()}-tile.svg`);\n toast(`Seamless tile — ${tile.w}×${tile.h} px`);\n } else if (act === \"tile-png\") {\n const c = rasterCanvas(cfg, tile.w, tile.h, { tile });\n const blob = await canvasToBlob(c, \"image/png\");\n download(blob, `${baseName()}-tile.png`);\n toast(`Seamless tile — ${tile.w}×${tile.h} px`);\n } else if (act === \"css\") {\n copyText(toCSS(cfg, { tile }), \"CSS rule copied\");\n } else if (act === \"clipboard\") {\n try {\n const c = rasterCanvas(cfg, state.width, state.height, { tile });\n const blob = await canvasToBlob(c, \"image/png\");\n await navigator.clipboard.write([new ClipboardItem({ \"image/png\": blob })]);\n toast(\"PNG copied to the clipboard\");\n } catch {\n toast(\"This browser will not accept an image on the clipboard.\");\n }\n } else if (act === \"link\") {\n const url = location.origin + location.pathname + \"#\" + encodeConfig(state);\n copyText(url, \"Link copied — the pattern travels in the URL\");\n }\n}\n\nfunction wireExport() {\n for (const b of document.querySelectorAll(\"[data-fmt]\")) {\n b.addEventListener(\"click\", () => exportFormat(b.dataset.fmt));\n }\n for (const b of document.querySelectorAll(\"[data-act]\")) {\n b.addEventListener(\"click\", () => runAction(b.dataset.act));\n }\n supportsFormat(\"image/avif\").then((ok) => {\n if (ok) document.querySelector('[data-fmt=\"avif\"]').hidden = false;\n });\n supportsFormat(\"image/webp\").then((ok) => {\n if (!ok) document.querySelector('[data-fmt=\"webp\"]').hidden = true;\n });\n}\n\n/* ------------------------------------------------------------------ boot */\n\nbuildStyleGrid();\nbuildWeaveSeg();\nbuildChips();\nwire();\nsyncControls();\nschedule();\n\nwindow.addEventListener(\"hashchange\", () => {\n const next = decodeConfig(location.hash.slice(1));\n if (next) {\n state = next;\n syncControls();\n schedule();\n }\n});\n",[19,100],"092abfc9-fa48-4219-832a-6de2fa02327d",2,["D",1788266856689],"directory",[19],{"_40":106,"_13":19,"_43":46,"_45":-5,"_47":48,"_49":107,"_51":52,"_53":159,"_17":55,"_56":109,"_57":-5,"_59":60,"_61":-5,"_124":160,"_18":161},{"_40":151,"_13":152,"_43":153,"_45":-5,"_47":48,"_49":154,"_51":52,"_53":155,"_17":55,"_56":24,"_57":156,"_59":60,"_61":-5,"_124":157,"_18":158},{"_40":143,"_13":144,"_43":145,"_45":-5,"_47":48,"_49":146,"_51":52,"_53":147,"_17":55,"_56":24,"_57":148,"_59":60,"_61":-5,"_124":149,"_18":150},{"_40":135,"_13":136,"_43":137,"_45":-5,"_47":48,"_49":138,"_51":52,"_53":139,"_17":55,"_56":24,"_57":140,"_59":60,"_61":-5,"_124":141,"_18":142},{"_40":127,"_13":128,"_43":129,"_45":-5,"_47":48,"_49":130,"_51":52,"_53":131,"_17":55,"_56":24,"_57":132,"_59":60,"_61":-5,"_124":133,"_18":134},{"_40":117,"_13":118,"_43":119,"_45":-5,"_47":48,"_49":120,"_51":52,"_53":121,"_17":107,"_56":122,"_57":123,"_59":60,"_61":14,"_124":125,"_18":126},"9dc531ea-b521-4d7a-bffd-c3b7ecefb41b","main.ts","efa982fe-a583-11f1-ae6f-1607ee4eb77e",15,["D",1788266866282],"http","/**\n * Gingham Mill — HTTP entry point.\n *\n * This val serves static files and nothing else. Every pattern is built,\n * previewed and encoded in the visitor's browser; no image data is ever sent\n * back here.\n */\n\nimport { Hono } from \"https://esm.sh/hono@4.6.14\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors so stack traces survive.\napp.onError((err) => {\n throw err;\n});\n\napp.get(\"/\", async (c) => c.html(await readFile(\"/frontend/index.html\", import.meta.url)));\napp.get(\"/favicon.svg\", (c) => serveFile(\"/frontend/favicon.svg\", import.meta.url));\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\n\nexport default app.fetch;\n","children",[],[118],"ed891044-f717-4f8a-be3a-35ea6ce76efd","deno.json","4f278300-a603-11f1-af46-1607ee4eb77e",3,["D",1788266856821],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[128],"08ab2085-214e-40f7-8946-8f2c16899878","README.md","4f8e6336-a603-11f1-b1e8-1607ee4eb77e",13,["D",1788266857482],"# Gingham Mill\n\nA gingham loom that runs entirely in your browser. Set the cloth size in pixels\nat a given resolution, pick the yarns, choose how fine the check is, and cut the\nresult as SVG, PNG, JPEG, WEBP, AVIF, a seamless tile, or a CSS rule.\n\nNo render server, no uploads. `main.ts` serves static files; everything else\nhappens on the client.\n\n## How it works\n\nA woven cloth is warp threads (columns) crossed by weft threads (rows). Each\naxis is a repeating sequence of bands, and each band is dyed with one of three\nyarns. The color at a crossing is a mix of its warp yarn and its weft yarn —\nwhich is why classic gingham reads as three tones from only two colors.\n\nEverything downstream draws from one tile, so the preview, the SVG and the PNG\nare the same geometry. Band edges are snapped to whole pixels with cumulative\nrounding, which keeps the tile seamless and the exports crisp.\n\nTransparency is carried through in premultiplied space, so a transparent\nsecondary yarn gives you a check that stays semi-transparent where it should and\nfully opaque where the colored threads cross — ready to layer over other art.\n\n## Files\n\n| File | Role |\n| --- | --- |\n| `main.ts` | Hono app; serves `frontend/` |\n| `frontend/gingham.js` | The loom: bands, weave structures, color mixing, measuring |\n| `frontend/render.js` | Canvas painting, SVG output, raster encoding, CSS output |\n| `frontend/presets.js` | Defaults, the sample book, the random-bolt generator, URL codec |\n| `frontend/app.js` | State, controls, rulers, export |\n| `frontend/style.css` | Everything visual |\n\n## Pattern styles\n\n- **Gingham** — the classic even check\n- **Windowpane** — thin lines, wide panes\n- **Tattersall** — two colors of fine line\n- **Triple check** — three-tone grid\n- **Madras** — irregular seeded bands\n- **Bengal stripe** — warp only, no cross-check\n\nAny of them can be woven flat (solid blocks, smallest files) or with a real\nplain, twill or basket interlacing, where individual threads pass over and under\neach other.\n\n## Sharing\n\nThe whole pattern is encoded into the URL fragment, so a link reproduces the\nexact cloth without a database.\n",[],[136],"2da416d9-baee-471f-adcf-e5205dc2eec6","AGENTS.md","4f327742-a603-11f1-981f-1607ee4eb77e",4,["D",1788266856887],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider\n refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure\n about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious\n operations)\n- Follow modern ES6+ conventions and functional programming practices if\n possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nconst TABLE_NAME = \"todo_app_users_2\";\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(\n `SELECT * FROM ${TABLE_NAME} WHERE id = ?`,\n [1],\n);\n```\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\",\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport {\n parseProject,\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\"\nurls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's _extremely importing_ to note that `parseProject` and other\nStandard Library utilities ONLY RUN ON THE SERVER. If you need access to this\ndata on the client, run it in the server and pass it to the client by splicing\nit into the HTML page or by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use\n `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})`\n instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode\n symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use:\n `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys)\n unless otherwise specified\n- **View Source:** Add a view source link by importing & using\n `import.meta.url.replace(\"esm.sh\", \"val.town)\"` (or passing this data to the\n client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add\n `` to HTML to capture\n client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local\n resolution; Avoid catches that merely log or return 500s. Let errors bubble up\n with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but\n generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure\n compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer\n simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with\n `?deps=react@18.2.0,react-dom@18.2.0` and start the file with\n `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same\n version\n- **Styling:** Default to using TailwindCSS via\n `` unless otherwise\n specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project\n files:\n ```ts\n import {\n readFile,\n serveFile,\n } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async (c) => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to\n see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of\n React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with\n `export default app.fetch // This is the entry point for HTTP vals`",[],[144],"172cffe0-c950-4e2a-97ca-d3f3910ebb2d",".vtignore","4f38d2ae-a603-11f1-80c7-1607ee4eb77e",5,["D",1788266856919],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[],[152],["D",1788266856689],[162,163,164,165,166,167,168],[19],{"_40":99,"_13":100,"_43":101,"_45":46,"_47":48,"_49":102,"_51":52,"_53":187,"_17":55,"_56":68,"_57":104,"_59":60,"_61":-5,"_124":188,"_18":189},{"_40":92,"_13":93,"_43":94,"_45":46,"_47":48,"_49":95,"_51":52,"_53":184,"_17":55,"_56":24,"_57":97,"_59":60,"_61":-5,"_124":185,"_18":186},{"_40":85,"_13":86,"_43":87,"_45":46,"_47":48,"_49":88,"_51":52,"_53":181,"_17":55,"_56":68,"_57":90,"_59":60,"_61":-5,"_124":182,"_18":183},{"_40":78,"_13":79,"_43":80,"_45":46,"_47":48,"_49":81,"_51":52,"_53":178,"_17":55,"_56":24,"_57":83,"_59":60,"_61":-5,"_124":179,"_18":180},{"_40":71,"_13":72,"_43":73,"_45":46,"_47":48,"_49":74,"_51":52,"_53":175,"_17":55,"_56":68,"_57":76,"_59":60,"_61":-5,"_124":176,"_18":177},{"_40":63,"_13":64,"_43":65,"_45":46,"_47":48,"_49":66,"_51":52,"_53":172,"_17":55,"_56":68,"_57":69,"_59":60,"_61":-5,"_124":173,"_18":174},{"_40":41,"_13":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":169,"_17":55,"_56":24,"_57":58,"_59":60,"_61":-5,"_124":170,"_18":171},["D",1788266857112],[],[19,42],["D",1788266856889],[],[19,64],["D",1788266857067],[],[19,72],["D",1788266857027],[],[19,79],["D",1788266856889],[],[19,86],["D",1788266857181],[],[19,93],["D",1788266857184],[],[19,100],"75660a3c-e06e-422b-93df-36d3591bbbe3",["D",1788212150485],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","userId","b8f52b40-db4b-11ef-9fdc-e7ba3d98ed08","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","c0309a09-c920-43c3-9d64-1db94f641c1a","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_243":239},"org",{"_11":12,"_237":-5,"_238":239,"_200":201,"_240":241,"_242":60},"branch",{"_17":120,"_13":16,"_40":48,"_229":190,"_230":-5,"_231":-5,"_232":-5,"_233":-5,"_234":-5,"_235":14,"_236":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yczhIY1pIYWJ5ZnVPVjgxM0R2OENRWTJlTW0ifQ","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_40":190,"_13":14,"_53":327,"_192":-5,"_193":60,"_194":195,"_196":195,"_197":198,"_199":-5,"_200":201,"_202":119,"_203":52,"_204":-5,"_205":-5,"_206":55,"_207":208,"_209":-5,"_210":-5,"_211":-5,"_212":-5,"_213":214,"_215":214,"_216":217,"_218":217,"_219":217,"_220":214,"_221":214,"_222":328,"_224":329,"_226":330,"_228":60},[288,296,297,298,299,300],"files",[288,289,290,291,292,293,294,295,296,297,298,299,300],"counts",{"_278":55,"_279":280,"_281":55,"_32":282,"_283":284},[264,265,266,267,268,269,270],{"_40":106,"_13":19,"_43":46,"_45":-5,"_47":48,"_49":107,"_51":52,"_53":108,"_17":55,"_56":109,"_57":-5,"_59":60,"_61":-5,"_18":263},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},[19],{"_40":99,"_13":100,"_43":101,"_45":46,"_47":48,"_49":102,"_51":52,"_53":103,"_17":55,"_56":68,"_57":104,"_59":60,"_61":-5,"_18":277},{"_40":92,"_13":93,"_43":94,"_45":46,"_47":48,"_49":95,"_51":52,"_53":96,"_17":55,"_56":24,"_57":97,"_59":60,"_61":-5,"_18":276},{"_40":85,"_13":86,"_43":87,"_45":46,"_47":48,"_49":88,"_51":52,"_53":89,"_17":55,"_56":68,"_57":90,"_59":60,"_61":-5,"_18":275},{"_40":78,"_13":79,"_43":80,"_45":46,"_47":48,"_49":81,"_51":52,"_53":82,"_17":55,"_56":24,"_57":83,"_59":60,"_61":-5,"_18":274},{"_40":71,"_13":72,"_43":73,"_45":46,"_47":48,"_49":74,"_51":52,"_53":75,"_17":55,"_56":68,"_57":76,"_59":60,"_61":-5,"_18":273},{"_40":63,"_13":64,"_43":65,"_45":46,"_47":48,"_49":66,"_51":52,"_53":67,"_17":55,"_56":68,"_57":69,"_59":60,"_61":-5,"_18":272},{"_40":41,"_13":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_17":55,"_56":24,"_57":58,"_59":60,"_61":-5,"_18":271},[19,42],[19,64],[19,72],[19,79],[19,86],[19,93],[19,100],"pulls","branches",1,"forks",{"_285":55,"_287":55},"connections",{"_285":55,"_286":55},"count","unfilledCount","emptyCount",{"_40":106,"_13":19,"_43":46,"_45":-5,"_47":48,"_49":107,"_51":52,"_53":159,"_17":55,"_56":109,"_57":-5,"_59":60,"_61":-5,"_124":325,"_18":326},{"_40":99,"_13":100,"_43":101,"_45":46,"_47":48,"_49":102,"_51":52,"_53":187,"_17":55,"_56":68,"_57":104,"_59":60,"_61":-5,"_124":323,"_18":324},{"_40":92,"_13":93,"_43":94,"_45":46,"_47":48,"_49":95,"_51":52,"_53":184,"_17":55,"_56":24,"_57":97,"_59":60,"_61":-5,"_124":321,"_18":322},{"_40":85,"_13":86,"_43":87,"_45":46,"_47":48,"_49":88,"_51":52,"_53":181,"_17":55,"_56":68,"_57":90,"_59":60,"_61":-5,"_124":319,"_18":320},{"_40":78,"_13":79,"_43":80,"_45":46,"_47":48,"_49":81,"_51":52,"_53":178,"_17":55,"_56":24,"_57":83,"_59":60,"_61":-5,"_124":317,"_18":318},{"_40":71,"_13":72,"_43":73,"_45":46,"_47":48,"_49":74,"_51":52,"_53":175,"_17":55,"_56":68,"_57":76,"_59":60,"_61":-5,"_124":315,"_18":316},{"_40":63,"_13":64,"_43":65,"_45":46,"_47":48,"_49":66,"_51":52,"_53":172,"_17":55,"_56":68,"_57":69,"_59":60,"_61":-5,"_124":313,"_18":314},{"_40":41,"_13":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":169,"_17":55,"_56":24,"_57":58,"_59":60,"_61":-5,"_124":311,"_18":312},{"_40":151,"_13":152,"_43":153,"_45":-5,"_47":48,"_49":154,"_51":52,"_53":155,"_17":55,"_56":24,"_57":156,"_59":60,"_61":-5,"_124":309,"_18":310},{"_40":143,"_13":144,"_43":145,"_45":-5,"_47":48,"_49":146,"_51":52,"_53":147,"_17":55,"_56":24,"_57":148,"_59":60,"_61":-5,"_124":307,"_18":308},{"_40":135,"_13":136,"_43":137,"_45":-5,"_47":48,"_49":138,"_51":52,"_53":139,"_17":55,"_56":24,"_57":140,"_59":60,"_61":-5,"_124":305,"_18":306},{"_40":127,"_13":128,"_43":129,"_45":-5,"_47":48,"_49":130,"_51":52,"_53":131,"_17":55,"_56":24,"_57":132,"_59":60,"_61":-5,"_124":303,"_18":304},{"_40":117,"_13":118,"_43":119,"_45":-5,"_47":48,"_49":120,"_51":52,"_53":121,"_17":107,"_56":122,"_57":123,"_59":60,"_61":14,"_124":301,"_18":302},[],[118],[],[128],[],[136],[],[144],[],[152],[],[19,42],[],[19,64],[],[19,72],[],[19,79],[],[19,86],[],[19,93],[],[19,100],[289,290,291,292,293,294,295],[19],["D",1788212150485],{"_11":12,"_243":239},{"_11":12,"_237":-5,"_238":239,"_200":201,"_240":241,"_242":60},{"_17":120,"_13":16,"_40":48,"_229":190,"_230":-5,"_231":-5,"_232":-5,"_233":-5,"_234":-5,"_235":14,"_236":12},"ctx",{"_222":-5,"_260":364,"_365":366,"_367":368,"_369":60,"_370":60,"_371":60,"_372":52,"_373":-5,"_374":-7,"_375":-7,"_376":55,"_377":60,"_378":60,"_379":-5,"_380":60,"_381":60,"_382":60,"_383":-5},"ENV",{"_335":336,"_337":338,"_339":16,"_340":341,"_342":343,"_344":345,"_346":347,"_348":349,"_350":351,"_352":353,"_354":355,"_356":357,"_358":359,"_360":361,"_362":363},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]