`, 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",{"_318":319,"_320":321},"routes/_app.x.$handle.$name",{"_98":97,"_31":43,"_107":88,"_26":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":24,"_122":123,"_124":57,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_31":43,"_36":44,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":55,"_56":57,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":24},"version",14,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":27,"_32":33,"_34":35,"_36":37,"_38":14,"_39":40,"_23":24},"previous","deleted",false,"deletedHere","path","dubai_engine_tests.ts","latestPath","fileId","7313109a-ab3f-11f1-a749-1607ee4eb77e","name","fileType","script","content","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","createdAt",["D",1788842442638],"branchVersion","branchId","242054ff-3ca3-4962-9fd2-94e6539fc3eb","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",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":53,"_103":104,"_105":24},"branch",{"_13":87,"_31":88,"_41":40,"_89":42,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":43,"_96":97},"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",{"_41":42,"_31":43,"_36":313,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":55,"_56":57,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":314,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":315,"_82":316,"_84":317,"_86":24},"tree",[183,196,197,198,199,200],"files",[183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200],"counts",{"_173":61,"_174":138,"_175":61,"_176":177,"_178":179},"contents",[129,130,131,132,133,134],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":167,"_31":168,"_29":169,"_137":-5,"_39":40,"_38":138,"_139":57,"_36":170,"_13":61,"_32":171,"_34":-5,"_23":24,"_143":-5,"_26":172},{"_41":161,"_31":162,"_29":163,"_137":-5,"_39":40,"_38":138,"_139":57,"_36":164,"_13":61,"_32":20,"_34":165,"_23":24,"_143":-5,"_26":166},{"_41":155,"_31":156,"_29":157,"_137":-5,"_39":40,"_38":138,"_139":24,"_36":158,"_13":61,"_32":20,"_34":159,"_23":24,"_143":-5,"_26":160},{"_41":152,"_31":27,"_29":30,"_137":-5,"_39":40,"_38":14,"_139":57,"_36":153,"_13":61,"_32":33,"_34":35,"_23":24,"_143":-5,"_26":154},{"_41":145,"_31":146,"_29":147,"_137":-5,"_39":40,"_38":148,"_139":57,"_36":149,"_13":61,"_32":33,"_34":150,"_23":24,"_143":-5,"_26":151},{"_41":135,"_31":136,"_29":55,"_137":-5,"_39":40,"_38":138,"_139":24,"_36":140,"_13":61,"_32":141,"_34":142,"_23":24,"_143":43,"_26":144},"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",[136],"b4ebd463-2356-40b1-bfb1-e62cd0c12059","game_engine_tests.ts","609ef6b4-ab02-11f1-9d9d-1607ee4eb77e",8,["D",1788816212411],"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",[146],"e6445a33-ba64-40b8-8def-628bf9aaac9a",["D",1788842442638],[27],"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",[156],"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 · v14