`, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_341":342,"_343":344},"routes/_app.x.$handle.$name",{"_104":103,"_32":49,"_113":94,"_27":114,"_13":14,"_115":-5,"_11":116,"_117":118,"_119":120,"_121":122,"_123":124,"_21":-5,"_125":-5,"_126":-5,"_127":25,"_128":129,"_130":63,"_131":-5,"_132":-5,"_133":134},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_47":48,"_32":49,"_36":50,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":57,"_58":-5,"_18":59,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":87,"_88":89,"_90":91,"_92":25},"version",15,"changes",[19,20],"aiChatInfo","userId",{"_21":41,"_23":-7,"_24":25,"_26":25,"_27":42,"_29":42},{"_21":22,"_23":-7,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":-5,"_36":37,"_38":14,"_39":40,"_24":25},"previous","deleted",false,"deletedHere","path","licenses","latestPath","fileId","8ced916c-bb95-4edc-8c6c-b06828592ace","name","fileType","directory","content","createdAt",["D",1788842443602],"branchVersion","branchId","242054ff-3ca3-4962-9fd2-94e6539fc3eb",{"_30":43,"_32":44,"_33":21,"_35":45,"_36":46,"_38":14,"_39":40,"_24":25},"licenses/three-MIT.txt","739cafb2-ab3f-11f1-8ee8-1607ee4eb77e","three-MIT.txt","The MIT License\n\nCopyright © 2010-2025 three.js authors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n",["D",1788842443602],"id","9ffa70f9-aba3-4109-8e8d-0fb8a9a9ec93","milliarder-game",["D",1788815610474],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Playable vertical slice for Миллиардер game","imageUrl","fe39b163-4b50-466e-82d1-8bd01133e4b6","pinnedFileId","01a07db8-12e1-737f-8f4d-b1244c5546ee","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","01a03585-eb44-758d-92a4-77db1a9a243c","tursoName","9ffa70f9aba341098e8d0fb8a9a9ec93","tursoHostname","9ffa70f9aba341098e8d0fb8a9a9ec93-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789512044203],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_104":103,"_112":108},"org",{"_104":103,"_105":106,"_107":108,"_18":59,"_109":110,"_111":25},"branch",{"_13":93,"_32":94,"_47":40,"_95":48,"_96":-5,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":49,"_102":103},"isOwned",45,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","oromaskevic23","handle","displayName","Олександр Ромаскевич","avatar","https://lh3.googleusercontent.com/a/ACg8ocIo1MJ3hDjpQrinMIRok3d2YY1vpHgehs8m2u1_vc7pmFovRGI=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_47":48,"_32":49,"_36":336,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":57,"_58":-5,"_18":59,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":337,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":338,"_88":339,"_90":340,"_92":25},"tree",[197,210,212,213,214,215,216],"files",[197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216],"counts",{"_187":67,"_188":145,"_189":67,"_190":191,"_192":193},"contents",[135,136,137,138,139,140,141],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_47":182,"_32":183,"_30":184,"_144":-5,"_39":40,"_38":145,"_146":63,"_36":185,"_13":67,"_33":34,"_35":-5,"_24":25,"_150":-5,"_27":186},{"_47":179,"_32":28,"_30":31,"_144":-5,"_39":40,"_38":14,"_146":63,"_36":180,"_13":67,"_33":34,"_35":-5,"_24":25,"_150":-5,"_27":181},{"_47":173,"_32":174,"_30":175,"_144":-5,"_39":40,"_38":145,"_146":63,"_36":176,"_13":67,"_33":21,"_35":177,"_24":25,"_150":-5,"_27":178},{"_47":167,"_32":168,"_30":169,"_144":-5,"_39":40,"_38":145,"_146":25,"_36":170,"_13":67,"_33":21,"_35":171,"_24":25,"_150":-5,"_27":172},{"_47":160,"_32":161,"_30":162,"_144":-5,"_39":40,"_38":163,"_146":63,"_36":164,"_13":67,"_33":157,"_35":165,"_24":25,"_150":-5,"_27":166},{"_47":152,"_32":153,"_30":154,"_144":-5,"_39":40,"_38":155,"_146":63,"_36":156,"_13":67,"_33":157,"_35":158,"_24":25,"_150":-5,"_27":159},{"_47":142,"_32":143,"_30":61,"_144":-5,"_39":40,"_38":145,"_146":25,"_36":147,"_13":67,"_33":148,"_35":149,"_24":25,"_150":49,"_27":151},"51af2f9a-ea31-4dc6-a784-06a0a1d2824c","index.ts","parentId",1,"latest",["D",1788815610474],"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root /\napp.get(\"/\", (c) => c.html(Root()));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\n// View source redirect\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Add your API routes here\n// app.get(\"/api/data\", c => c.json({ hello: \"world\" }));\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","label",[143],"b4ebd463-2356-40b1-bfb1-e62cd0c12059","game_engine_tests.ts","609ef6b4-ab02-11f1-9d9d-1607ee4eb77e",8,["D",1788816212411],"script","import { INITIAL, command, deserialize, helpNearestNpc, move, passiveIncome, serialize, simulateNpcTick } from \"./frontend/gameEngine.ts\";\n\nconst results:{name:string;pass:boolean;detail?:string}[]=[];\nfunction test(name:string,fn:()=>void){try{fn();results.push({name,pass:true})}catch(e){results.push({name,pass:false,detail:String((e as Error).message??e)})}}\nfunction ok(v:any,m=\"assertion failed\"){if(!v)throw new Error(m)}\nfunction eq(a:any,b:any,m=\"not equal\"){if(JSON.stringify(a)!==JSON.stringify(b))throw new Error(`${m}: ${JSON.stringify(a)} != ${JSON.stringify(b)}`)}\nconst clone=()=>structuredClone(INITIAL);\n\ntest(\"initial state uses fictional credits\",()=>{ok(INITIAL.credits===100000);ok(INITIAL.version===1)});\ntest(\"movement changes position deterministically\",()=>{const s=move(clone(),1,0);eq(s.player.x,52)});\ntest(\"movement clamps world bounds\",()=>{let s=clone();s.player.x=95;eq(move(s,1,0).player.x,96)});\ntest(\"business purchase is atomic\",()=>{const s=command(clone(),\"OPEN_BUSINESS\");eq(s.credits,75000);eq(s.businesses,1)});\ntest(\"insufficient funds do not create business\",()=>{let s=clone();s.credits=24999;const n=command(s,\"OPEN_BUSINESS\");eq(n.businesses,0);eq(n.credits,24999)});\ntest(\"property purchase is atomic\",()=>{const s=command(clone(),\"BUY_PROPERTY\");eq(s.properties,1);eq(s.credits,70000)});\ntest(\"vehicle requires ownership\",()=>{const s=command(clone(),\"TOGGLE_VEHICLE\");eq(s.vehicle.active,false)});\ntest(\"owned vehicle toggles and increases movement speed\",()=>{let s=command(clone(),\"BUY_CAR\");s=command(s,\"TOGGLE_VEHICLE\");ok(s.vehicle.active);const n=move(s,1,0);eq(n.player.x,s.player.x+4)});\ntest(\"passive income matches business count\",()=>{let s=clone();s.businesses=3;const n=passiveIncome(s);eq(n.credits,102250)});\ntest(\"help requires proximity\",()=>{const s=helpNearestNpc(clone());eq(s.helped,0)});\ntest(\"nearby NPC help writes memory once\",()=>{let s=clone();s.player={x:72,y:70};s=helpNearestNpc(s);eq(s.helped,1);eq(s.npcs[0].state,\"HELPED\");ok(s.npcs[0].memory.includes(\"PLAYER_HELPED\"));const n=helpNearestNpc(s);eq(n.helped,1)});\ntest(\"helped NPC can progress to thriving\",()=>{let s=clone();s.player={x:72,y:70};s=helpNearestNpc(s);const n=simulateNpcTick(s,12);eq(n.npcs[0].state,\"THRIVING\")});\ntest(\"save round trip preserves state\",()=>{let s=command(clone(),\"OPEN_BUSINESS\");s=move(s,1,-1);eq(deserialize(serialize(s)),s)});\ntest(\"corrupt save fails closed\",()=>{let threw=false;try{deserialize('{\"version\":2,\"credits\":1,\"npcs\":[]}')}catch{threw=true}ok(threw)});\ntest(\"event log is bounded\",()=>{let s=clone();for(let i=0;i<30;i++)s=command(s,\"COMPLETE_CONTRACT\");ok(s.events.length<=20)});\n\nconst passed=results.filter(x=>x.pass).length,failed=results.length-passed;\nconsole.log(JSON.stringify({suite:\"MILLIARDER_GAME_ENGINE\",passed,failed,total:results.length,status:failed===0?\"PASS\":\"FAIL\",results},null,2));\nif(failed)throw new Error(`${failed} tests failed`);\nexport default {passed,failed,total:results.length,results};\n",[153],"e6445a33-ba64-40b8-8def-628bf9aaac9a","dubai_engine_tests.ts","7313109a-ab3f-11f1-a749-1607ee4eb77e",14,["D",1788842442638],"import assert from \"node:assert/strict\";\nimport { test } from \"node:test\";\nimport { INITIAL } from \"./frontend/gameEngine.ts\";\nimport {\n WORLD_HALF, CHUNK_SIZE, DISTRICTS, VEHICLES, LOCATIONS, MISSIONS,\n createDubaiState, applyAction, actionFeedback, stepSimulation,\n serializeDubai, deserializeDubai, getChunkKeys, generateChunk, isRoad,\n isWalkable, getDistrict, getTraffic,\n} from \"./frontend/dubaiEngine.ts\";\nimport type { DubaiState } from \"./frontend/dubaiEngine.ts\";\n\nconst action = (s: DubaiState, type: string, target?: string, id = `${type}-${s.transactionSeq + 1}`) => applyAction(s, { id, type, target });\nconst locate = (s: DubaiState, id: string): DubaiState => { const l = LOCATIONS.find(l => l.id === id)!; return { ...s, position: { x: l.x, z: l.z } }; };\nconst idle = { throttle: 0, steer: 0, brake: false };\nconst purchase = () => action(createDubaiState(), \"BUY_VEHICLE\", VEHICLES[0].id);\n\ntest(\"M1 migration preserves credits, progression, NPC memory and original input\", () => {\n const legacy = JSON.parse(JSON.stringify(INITIAL));\n legacy.credits = 77777; legacy.cars = 2; legacy.properties = 1; legacy.businesses = 1;\n legacy.npcs[0].memory = [\"PLAYER_HELPED\"]; legacy.npcs[0].state = \"HELPED\"; legacy.npcs[0].trust = 25;\n const prior = JSON.stringify(legacy), s = deserializeDubai(prior);\n assert.equal(s.version, 2); assert.deepEqual(s.core, legacy); assert.equal(s.garage.length, 2);\n assert.equal(s.properties.length, 1); assert.equal(s.businesses.length, 1);\n assert.ok(s.npcs[0].memory.includes(\"PLAYER_HELPED\"));\n assert.equal(action(s, \"HELP_NPC\", s.npcs[0].id), s);\n assert.equal(JSON.stringify(legacy), prior);\n});\ntest(\"nine districts cover bounded 6.144km world with stable streamed chunks\", () => {\n assert.equal(WORLD_HALF * 2, 6144); assert.equal(CHUNK_SIZE, 256); assert.equal(DISTRICTS.length, 9);\n for (const d of DISTRICTS) assert.equal(getDistrict(d.x, d.z).id, d.id);\n const keys = getChunkKeys(0, 0); assert.equal(keys.length, 25); assert.equal(new Set(keys).size, 25);\n assert.deepEqual(getChunkKeys(0, 0), keys); assert.equal(getChunkKeys(NaN, 0).length, 0);\n assert.ok(getChunkKeys(WORLD_HALF, WORLD_HALF).every(k => k.split(\",\").every(n => Number(n) >= -12 && Number(n) < 12)));\n});\ntest(\"buildings regenerate deterministically without occupying roads\", () => {\n let count = 0;\n for (const key of getChunkKeys(512, 512)) {\n const [x, z] = key.split(\",\").map(Number);\n const a = generateChunk(x, z), b = generateChunk(x, z);\n assert.deepEqual(a, b);\n for (const building of a.buildings) {\n count++; assert.equal(isRoad(building.x, building.z), false); assert.equal(isWalkable(building.x, building.z), false);\n for (const dx of [-1, 1]) for (const dz of [-1, 1]) assert.equal(isRoad(building.x + dx * building.width / 2, building.z + dz * building.depth / 2), false);\n }\n }\n assert.ok(count > 300); assert.equal(generateChunk(12, 0).buildings.length, 0); assert.equal(isWalkable(Infinity, 0), false);\n});\ntest(\"twelve original vehicle profiles have meaningful handling differences\", () => {\n assert.equal(VEHICLES.length, 12); assert.equal(new Set(VEHICLES.map(v => v.id)).size, 12);\n assert.ok(new Set(VEHICLES.map(v => v.acceleration)).size >= 10);\n assert.ok(new Set(VEHICLES.map(v => v.mass)).size >= 10);\n assert.ok(VEHICLES.every(v => v.price > 0 && v.braking > 0 && v.grip > 0 && v.maxSpeed > 0));\n});\ntest(\"purchase is atomic, idempotent, immutable and ownership blocks new-ID duplicate\", () => {\n const initial = createDubaiState(), before = JSON.stringify(initial);\n const s = action(initial, \"BUY_VEHICLE\", VEHICLES[0].id, \"purchase-1\");\n assert.equal(s.core.credits, 82000); assert.equal(s.core.cars, 1); assert.equal(s.garage.length, 1);\n assert.equal(JSON.stringify(initial), before);\n assert.equal(action(s, \"BUY_VEHICLE\", VEHICLES[0].id, \"purchase-1\"), s);\n assert.equal(action(s, \"BUY_VEHICLE\", VEHICLES[0].id, \"purchase-2\"), s);\n});\ntest(\"cost, proximity and unsupported-action rejections consume neither money nor command IDs\", () => {\n const initial = createDubaiState();\n const poor = { ...initial, core: { ...initial.core, credits: 17999 } };\n assert.equal(action(poor, \"BUY_VEHICLE\", VEHICLES[0].id), poor);\n const far = { ...initial, position: { x: 1024, z: 0 } };\n assert.equal(action(far, \"BUY_VEHICLE\", VEHICLES[0].id), far);\n assert.equal(action(initial, \"COMPLETE_CONTRACT\"), initial);\n assert.equal(action(initial, \"WITHDRAW_FUNDS\"), initial);\n assert.equal(action(initial, \"BUY_VEHICLE\", VEHICLES[0].id, \"__ proto__\"), initial);\n assert.equal(initial.processedCommands.length, 0);\n assert.ok(actionFeedback(far, { id: \"feedback\", type: \"BUY_VEHICLE\", target: VEHICLES[0].id }).includes(\"60\"));\n});\ntest(\"first mission requires acceptance and real traversal before a single reward\", () => {\n const initial = createDubaiState(), mission = MISSIONS[0];\n assert.equal(action(initial, \"COMPLETE_MISSION\", mission.id), initial);\n const accepted = action(initial, \"ACCEPT_MISSION\", mission.id);\n assert.equal(accepted.activeMission, mission.id);\n assert.equal(action(accepted, \"COMPLETE_MISSION\", mission.id), accepted);\n let driven = action(action(accepted, \"BUY_VEHICLE\", VEHICLES[0].id), \"TOGGLE_VEHICLE\");\n for (let i = 0; i < 180 && Math.abs(driven.position.z - mission.destination.z) > 50; i++) driven = stepSimulation(driven, { throttle: 1, steer: 0, brake: false }, 0.1);\n assert.ok(Math.abs(driven.position.z - mission.destination.z) < 55);\n const earned = action(driven, \"COMPLETE_MISSION\", mission.id);\n assert.equal(earned.activeMission, null); assert.equal(earned.core.credits, 94000);\n assert.deepEqual(earned.completedMissions, [mission.id]);\n assert.equal(action(earned, \"COMPLETE_MISSION\", mission.id), earned);\n assert.equal(action({ ...earned, position: mission.start }, \"ACCEPT_MISSION\", mission.id).core.credits, earned.core.credits);\n});\ntest(\"mission target mismatch and a second simultaneous contract are rejected\", () => {\n const s = action(createDubaiState(), \"ACCEPT_MISSION\", MISSIONS[0].id);\n assert.equal(action(s, \"ACCEPT_MISSION\", MISSIONS[1].id), s);\n assert.equal(action({ ...s, position: MISSIONS[0].destination }, \"COMPLETE_MISSION\", MISSIONS[1].id).core.credits, s.core.credits);\n});\ntest(\"property and business ownership require specific location and preserve M1 purchase economics\", () => {\n const initial = createDubaiState();\n assert.equal(action(initial, \"BUY_PROPERTY\", \"civic-apartment\"), initial);\n const property = action(locate(initial, \"civic-apartment\"), \"BUY_PROPERTY\", \"civic-apartment\");\n assert.equal(property.core.credits, 70000); assert.equal(property.core.properties, 1); assert.equal(property.core.reputation, 13);\n const business = action(locate(property, \"civic-cafe\"), \"OPEN_BUSINESS\", \"civic-cafe\");\n assert.equal(business.core.credits, 45000); assert.equal(business.core.businesses, 1); assert.equal(business.core.reputation, 17);\n assert.equal(action(business, \"OPEN_BUSINESS\", \"civic-cafe\"), business);\n});\ntest(\"business income accrues once per crossed game hour including midnight\", () => {\n const owned = action(locate(createDubaiState(), \"civic-cafe\"), \"OPEN_BUSINESS\", \"civic-cafe\");\n const boundary = { ...owned, clock: 539.9 };\n const first = stepSimulation(boundary, idle, 0.1);\n assert.equal(first.core.credits, owned.core.credits + 750);\n const second = stepSimulation(first, idle, 0.1);\n assert.equal(second.core.credits, first.core.credits);\n const midnight = stepSimulation({ ...owned, clock: 1439.9 }, idle, 0.1);\n assert.equal(midnight.core.credits, owned.core.credits + 750); assert.ok(midnight.clock < 1);\n});\ntest(\"time-step clamp prevents a large delta from minting hours of income or teleporting\", () => {\n const s = action(purchase(), \"TOGGLE_VEHICLE\");\n assert.deepEqual(stepSimulation(s, { throttle: 1, steer: 1, brake: false }, 999999), stepSimulation(s, { throttle: 1, steer: 1, brake: false }, 0.1));\n assert.equal(stepSimulation(s, idle, NaN), s); assert.equal(stepSimulation(s, idle, -1), s);\n assert.equal(stepSimulation(s, { throttle: Infinity, steer: 0, brake: false }, 0.1), s);\n});\ntest(\"NPC help is proximity-bound, costs credits, changes needs and remembers permanently\", () => {\n const initial = createDubaiState(), npc = initial.npcs[0];\n const helped = action(initial, \"HELP_NPC\", npc.id);\n assert.equal(helped.core.credits, 95000); assert.equal(helped.core.helped, 1); assert.equal(helped.core.kindness, 10);\n assert.equal(helped.npcs[0].needs.support, 0); assert.equal(helped.npcs[0].money, npc.money + 5000);\n assert.equal(helped.npcs[0].relationships.player, 25); assert.equal(helped.npcs[0].mood, \"grateful\");\n assert.ok(helped.npcs[0].memory.includes(\"PLAYER_HELPED\"));\n assert.equal(action(helped, \"HELP_NPC\", npc.id), helped);\n const restored = deserializeDubai(serializeDubai(helped));\n assert.equal(action(restored, \"HELP_NPC\", npc.id), restored);\n});\ntest(\"NPC schedule changes destination and needs while keeping help memory\", () => {\n const day = createDubaiState();\n const atWork = stepSimulation(day, idle, 0.1);\n assert.ok(atWork.npcs[0].z < day.npcs[0].z); assert.equal(atWork.npcs[0].mood, \"busy\");\n const night = stepSimulation({ ...day, clock: 1380 }, idle, 0.1);\n assert.ok(night.npcs[0].x > day.npcs[0].x); assert.ok(night.npcs[0].needs.rest < day.npcs[0].needs.rest);\n});\ntest(\"vehicle interaction requires ownership, stopped speed and permitted garage location\", () => {\n const initial = createDubaiState(); assert.equal(action(initial, \"TOGGLE_VEHICLE\"), initial);\n let s = action(purchase(), \"TOGGLE_VEHICLE\"); assert.equal(s.driving, true);\n s = stepSimulation(s, { throttle: 1, steer: 0, brake: false }, 0.1);\n assert.ok(s.speed > 0.5); assert.equal(action(s, \"TOGGLE_VEHICLE\"), s);\n const stopped = { ...s, speed: 0 };\n const exited = action(stopped, \"TOGGLE_VEHICLE\"); assert.equal(exited.driving, false);\n assert.equal(action({ ...exited, position: { x: 1024, z: 0 } }, \"SELECT_VEHICLE\", VEHICLES[0].id).transactionSeq, exited.transactionSeq);\n});\ntest(\"vehicle acceleration and wet braking depend on original handling profile\", () => {\n const s = action(purchase(), \"TOGGLE_VEHICLE\");\n const fast = { ...s, selectedVehicle: \"nayir-pulse\", garage: [...s.garage, \"nayir-pulse\"], core: { ...s.core, cars: 2 } };\n assert.ok(stepSimulation(fast, { throttle: 1, steer: 0, brake: false }, 0.1).speed > stepSimulation(s, { throttle: 1, steer: 0, brake: false }, 0.1).speed);\n const rolling = { ...s, speed: 20, position: { x: 0, z: -100 } };\n assert.ok(stepSimulation({ ...rolling, weather: \"rain\" }, { throttle: 0, steer: 0, brake: true }, 0.1).speed > stepSimulation(rolling, { throttle: 0, steer: 0, brake: true }, 0.1).speed);\n});\ntest(\"collision stops cars before buildings, pedestrians and world boundary\", () => {\n const s = action(purchase(), \"TOGGLE_VEHICLE\");\n const nearBuilding = { ...s, npcs: [], position: { x: 20, z: 168 }, heading: Math.PI / 2, speed: 54 };\n const buildingStop = stepSimulation(nearBuilding, { throttle: 1, steer: 0, brake: false }, 0.1);\n assert.equal(buildingStop.speed, 0); assert.deepEqual(buildingStop.position, nearBuilding.position);\n const pedestrian = { ...s, position: { x: 0, z: 0 }, heading: 0, speed: 25, npcs: [{ ...s.npcs[0], x: 0, z: -4 }] };\n assert.equal(stepSimulation(pedestrian, { throttle: 1, steer: 0, brake: false }, 0.1).speed, 0);\n const edge = { ...s, position: { x: 0, z: -WORLD_HALF + 4 }, speed: 50 };\n assert.equal(stepSimulation(edge, { throttle: 1, steer: 0, brake: false }, 0.1).speed, 0);\n});\ntest(\"interior transitions require proximity, private ownership and being on foot\", () => {\n const initial = createDubaiState();\n const inside = action(initial, \"ENTER_INTERIOR\", \"civic-office\"); assert.equal(inside.interior, \"civic-office\");\n const moved = stepSimulation(inside, { throttle: 1, steer: 1, brake: false }, 0.1); assert.deepEqual(moved.position, inside.position);\n assert.equal(action(inside, \"EXIT_INTERIOR\").interior, null);\n const unowned = locate(initial, \"civic-apartment\"); assert.equal(action(unowned, \"ENTER_INTERIOR\", \"civic-apartment\"), unowned);\n const driving = action(purchase(), \"TOGGLE_VEHICLE\"); assert.equal(action(driving, \"ENTER_INTERIOR\", \"civic-office\"), driving);\n});\ntest(\"canonical save round-trips owned assets, NPCs, weather, missions and replay history\", () => {\n let s = action(purchase(), \"SET_WEATHER\", \"rain\");\n s = action(s, \"ACCEPT_MISSION\", MISSIONS[0].id);\n assert.deepEqual(deserializeDubai(serializeDubai(s)), s);\n});\ntest(\"strict save allowlist rejects corruption, prototype injection and unknown fields\", () => {\n const raw = JSON.parse(serializeDubai(createDubaiState()));\n assert.throws(() => deserializeDubai(\"not json\"), /INVALID_DUBAI_SAVE/);\n assert.throws(() => deserializeDubai(\" \".repeat(200001)), /INVALID_DUBAI_SAVE/);\n for (const mutate of [\n (s: any) => s.version = 3,\n (s: any) => s.admin = true,\n (s: any) => s.core.credits = -1,\n (s: any) => s.core.credits = \"100000\",\n (s: any) => s.position.x = 999999,\n (s: any) => s.position.z = null,\n (s: any) => s.weather = \"money-rain\",\n (s: any) => s.garage = [\"not-an-owned-model\"],\n (s: any) => s.driving = true,\n (s: any) => s.activeMission = \"made-up-task\",\n (s: any) => s.npcs[0].schedule = [],\n (s: any) => s.npcs[0].needs.support = 101,\n (s: any) => s.npcs[0].relationships.owner = 1,\n (s: any) => s.processedCommands = [\"same\", \"same\"],\n (s: any) => s.processedCommands = Array.from({ length: 257 }, (_, i) => `cmd-${i}`),\n ]) {\n const copy = JSON.parse(JSON.stringify(raw)); mutate(copy);\n assert.throws(() => deserializeDubai(JSON.stringify(copy)), /INVALID_DUBAI_SAVE/);\n }\n assert.throws(() => deserializeDubai(JSON.stringify(raw).replace('\"version\":2', '\"__proto__\":{\"polluted\":true},\"version\":2')), /INVALID_DUBAI_SAVE/);\n assert.equal(({} as any).polluted, undefined);\n});\ntest(\"save cannot restore a completed active mission, illegal interior or embedded building\", () => {\n const s = createDubaiState();\n assert.throws(() => deserializeDubai(JSON.stringify({ ...s, activeMission: MISSIONS[0].id, completedMissions: [MISSIONS[0].id] })));\n assert.throws(() => deserializeDubai(JSON.stringify({ ...s, interior: \"civic-apartment\", position: { x: -28, z: 128 } })));\n const building = generateChunk(1, 1).buildings[0];\n assert.throws(() => deserializeDubai(JSON.stringify({ ...s, position: { x: building.x, z: building.z } })));\n});\ntest(\"eviction of bounded replay IDs never permits duplicate asset or mission reward\", () => {\n let s = action(createDubaiState(), \"BUY_VEHICLE\", VEHICLES[0].id, \"old-purchase\");\n s = action(s, \"ACCEPT_MISSION\", MISSIONS[0].id, \"old-accept\");\n s = action({ ...s, position: MISSIONS[0].destination }, \"COMPLETE_MISSION\", MISSIONS[0].id, \"old-complete\");\n for (let i = 0; i < 300; i++) s = action(s, \"SET_WEATHER\", i % 2 ? \"rain\" : \"clear\", `weather-${i}`);\n assert.equal(s.processedCommands.length, 256); assert.equal(s.processedCommands.includes(\"old-purchase\"), false);\n const home = { ...s, position: { x: 0, z: 0 } };\n assert.equal(action(home, \"BUY_VEHICLE\", VEHICLES[0].id, \"old-purchase\"), home);\n assert.equal(action(home, \"ACCEPT_MISSION\", MISSIONS[0].id, \"old-accept\"), home);\n assert.equal(action(home, \"COMPLETE_MISSION\", MISSIONS[0].id, \"old-complete\"), home);\n});\ntest(\"ambient traffic is deterministic, road-bound and has no economy side effects\", () => {\n const a = getTraffic(480); assert.equal(a.length, 36); assert.deepEqual(a, getTraffic(480));\n assert.ok(a.every(car => isRoad(car.x, car.z))); assert.notDeepEqual(a, getTraffic(481));\n assert.deepEqual(getTraffic(NaN), []);\n});\n",[161],"026bbebb-31cd-47d2-b6d6-d9461023d18d","README.md","01a07db8-12e1-737f-8f4d-affb8f7bade3",["D",1788815610474],"# React + Hono Starter\n\nA minimal starter template for building client-side React apps with a Hono\nbackend on Val Town. Click **Remix** to get your own copy.\n\n## Picking a starter\n\n| Starter | When to pick it |\n| --- | --- |\n| [`basic-html-starter`](https://www.val.town/x/templates/basic-html-starter) | Static HTML pages. Sprinkle of vanilla JS. No server-side rendering. |\n| [`hono-jsx-starter`](https://www.val.town/x/templates/hono-jsx-starter) | Dynamic server-rendered HTML with JSX. API routes. No React, no SPA. |\n| **[`react-hono-starter`](https://www.val.town/x/templates/react-hono-starter)** *(you're here)* | Client-side React SPA with a Hono API backend. |\n\n**Want to build UI?** Start writing React components in\n[`frontend/components/`](/frontend/components/). Import them into `App.tsx` and\nyou're good to go. Styling is [Twind](https://twind.style/) — just use Tailwind\nutility classes, zero config.\n\n**Want to add an API?** Add routes in [`index.ts`](/index.ts) (there's a\ncommented-out example). Fetch them from your React components.\n\n## Architecture\n\n```mermaid\ngraph LR\n Browser -->|\"GET /\"| Hono[\"index.ts
(Hono server)\"]\n Hono -->|serves| HTML[\"root.tsx\"]\n HTML -->|loads| Entry[\"index.tsx\"]\n Entry -->|renders| App[\"App.tsx\"]\n App -->|renders| Counter[\"Counter.tsx\"]\n```\n\n## File structure\n\n```\nindex.ts ← Hono backend (serves frontend + API routes)\nfrontend/\n root.tsx ← HTML shell (stamps immutable asset URLs)\n index.tsx ← React entrypoint (mounts )\n favicon.svg ← App icon\n components/\n App.tsx ← Root component (layout + view source link)\n Counter.tsx ← Example component with state\n```\n\n## How it works\n\n1. **`index.ts`** is the HTTP entrypoint — a Hono server that serves the\n frontend and any API routes you add.\n2. **`frontend/root.tsx`** is the HTML shell — it loads Twind and stamps\n immutable asset URLs for the favicon and React entrypoint.\n3. **`frontend/index.tsx`** mounts the React app.\n4. **`frontend/components/App.tsx`** is the root layout — add new components\n alongside it.\n5. **`frontend/components/Counter.tsx`** is an example stateful component —\n replace it with your own!\n\n## Next steps\n\n- Add API routes in `index.ts`\n- Add new components in `frontend/components/`\n- Add a SQLite database — see the\n [React Hono Example](https://www.val.town/x/stevekrouse/reactHonoExample) for\n a full-stack example with database, queries, and shared types\n\nTemplate updates and upgrade paths for existing remixes: [CHANGELOG.md](/CHANGELOG.md)\n",[168],"ba45aebd-cdf4-4c35-9f88-9861103f4132","CHANGELOG.md","01a07db8-12e1-737f-8f4d-abf751b50929",["D",1788815610474],"# Changelog\n\n## 2026-07-30 — Immutable asset caching\n\nFrontend files are now served at version-addressed URLs\n(`/__immutable/45/frontend/index.tsx`) with\n`Cache-Control: public, max-age=31536000, immutable`, so repeat visits load the\nwhole client graph from the browser cache — roughly 3× faster (~665ms → ~157ms\nmeasured). Publishing your val bumps its version, which changes every URL, so\ncaches invalidate automatically. Old-version URLs return 404 after a publish\n(like Next.js build assets); a reload picks up the new version.\n\nWhat changed in the template:\n\n- `frontend/index.html` → [`frontend/root.tsx`](/frontend/root.tsx): the HTML\n shell is now JSX and stamps asset URLs with `immutableFileUrl()`\n- [`index.ts`](/index.ts): serves `Root()` at `/`, and one\n `app.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path))` route\n serves all frontend files\n\n### Upgrading an existing remix\n\nYour copy of this template doesn't update automatically. Two options:\n\n**Minimal (most of the benefit):** point both routes at `serveImmutableFile` —\nyour existing bare URLs redirect into versioned space, the new route serves\nthem, and the whole module graph gets cached (costs one redirect per page view):\n\n```ts\nimport { serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\n\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/frontend/**/*\", (c) => serveImmutableFile(c.req.path)); // was serveFile\n```\n\n**Full upgrade (also removes the redirect):** three self-contained steps —\nno other files needed. Adjust the ``, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter\n

Diff · v15