v0.12.0

.gitignore

@@ -135,6 +135,15 @@ dist
 
 /data/assets/
 
+# Maintainer-only game-data exports for the node importer (FModel
+# .umap dumps, persistent-level JSON, etc.). These can be hundreds
+# of MB and are regenerated from the game.
+/data/FactoryGame/
+/data/Persistent_Level.json
+
+# Generated map tile pyramid (uploaded to DigitalOcean Spaces, not shipped in build)
+/dist-map-tiles/
+
 # intellij idea
 .idea
 

CLAUDE.md

@@ -149,6 +149,25 @@ Savegame files (`.sav`) are parsed using `@etothepii/satisfactory-file-parser` i
 
 ## Code Conventions
 
+### Definition of Done (for agents and humans)
+
+Before declaring any code change complete (and before reporting "done" to the user), run **both** of these on the touched files / project:
+
+```bash
+npm run lint          # Biome (formatting + linting)
+npm run check-types   # tsc --noEmit
+```
+
+If either fails:
+
+1. Fix the issues (use `npm run format` or `npx biome check --write <files>` for autofixable formatting).
+2. Re-run both commands until clean.
+3. Only then summarise the change to the user.
+
+For a focused check on just the files you touched, scope biome explicitly: `npx biome check --write <paths…>`. Do **not** rely solely on a focused check — a final `npm run lint && npm run check-types` is the contract.
+
+If tests cover the touched area, also run `npm test -- --run`.
+
 ### Writing Style
 
 - **Do not use em dashes (`—`)** in code comments, UI copy, notification messages, commit messages, or any text that ships to users. Prefer commas, parentheses, colons, or separate sentences. Applies to both source code and generated text.

README.md

@@ -55,6 +55,34 @@ npm run parse-docs
 - Copy the exported `FactoryGame` folder to `data/assets/` (FactoryGame should be a subfolder of `data/assets/`)
 - Run the `npm run parse-docs -- --with-images` command to generate the images
 
+### Resource Node Data (Map)
+
+The map view in `src/map/` ships with a curated copy of every resource node, deposit, fracking core/satellite, and geyser placement at `src/recipes/WorldResourceNodes.json`. The list is rebuilt from the game's persistent level whenever the game updates.
+
+To regenerate after a Satisfactory update:
+
+1. Load the game in [FModel](https://fmodel.app) (same setup as Image Generation above).
+2. Navigate to `FactoryGame/Content/FactoryGame/Map/GameLevel01/Persistent_Level.umap`.
+3. Right-click → **Save Properties (.json)**.
+4. Move the resulting `Persistent_Level.json` (~100MB) to `data/Persistent_Level.json` in this repo. The file is gitignored so it stays out of commits.
+5. Run:
+
+   ```bash
+   npm run extract-world-nodes
+   ```
+
+   The script does a two-pass walk over the export: first to collect every `BP_ResourceNode_C` / `BP_ResourceDeposit_C` / `BP_FrackingCore_C` / `BP_FrackingSatellite_C` / `BP_ResourceNodeGeyser_C` actor with its resource and purity, then to bind each one's `RootComponent` transform for world coordinates. The output is sorted deterministically and a diff vs. the previous bundled file is printed.
+
+   Useful flags:
+
+   - `--dry-run` — parse and report without writing.
+   - `--input <path>` / `--output <path>` — override defaults.
+   - `--verbose` — log every emitted node (debug).
+
+6. Review the diff in the script's summary output, then commit `src/recipes/WorldResourceNodes.json`.
+
+> **Heads up:** the parser holds the entire 100MB JSON in memory. If you see out-of-memory errors, prefix the command with `NODE_OPTIONS="--max-old-space-size=4096"`.
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package.json

@@ -1,7 +1,7 @@
 {
   "name": "satisfactory-logistics",
   "private": true,
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,23 +13,29 @@
     "preview": "vite preview",
     "supabase:types": "npx supabase gen types typescript --project-id nymrtujjmzbhxcimjsci > ./src/core/database.types.ts",
     "parse-docs": "tsx scripts/parseDocs.ts",
-    "generate-pwa-icons": "tsx scripts/generatePwaIcons.ts"
+    "extract-world-nodes": "tsx scripts/extractWorldNodes.ts",
+    "generate-pwa-icons": "tsx scripts/generatePwaIcons.ts",
+    "generate-map-tiles": "tsx scripts/generateMapTiles.ts",
+    "dump-save": "tsx scripts/dumpSavegame.ts"
   },
   "dependencies": {
     "@caldwell619/react-kanban": "^0.0.11",
     "@clickbar/dot-diver": "^1.0.7",
     "@dagrejs/dagre": "^1.1.4",
-    "@etothepii/satisfactory-file-parser": "^3.3.1",
+    "@etothepii/satisfactory-file-parser": "^4.0.1",
     "@hello-pangea/dnd": "^18.0.0",
     "@mantine/colors-generator": "^9.0.0",
     "@mantine/core": "^9.0.0",
+    "@mantine/dropzone": "^9.0.2",
     "@mantine/hooks": "^9.0.0",
     "@mantine/modals": "^9.0.0",
     "@mantine/notifications": "^9.0.0",
     "@mantine/tiptap": "^9.0.2",
     "@nivo/sankey": "^0.99.0",
     "@sentry/react": "^8.37.1",
     "@sentry/vite-plugin": "^5.2.0",
+    "@streamparser/json": "^0.0.22",
+    "@streamparser/json-whatwg": "^0.0.22",
     "@supabase/auth-ui-react": "^0.4.7",
     "@supabase/auth-ui-shared": "^0.1.8",
     "@supabase/sentry-js-integration": "^0.3.0",
@@ -58,6 +64,7 @@
     "idb-keyval": "^6.2.2",
     "immer": "^10.2.0",
     "js-base64": "^3.7.8",
+    "leaflet": "^1.9.4",
     "lodash": "^4.18.1",
     "loglevel": "^1.9.2",
     "loglevel-plugin-prefix": "^0.8.4",
@@ -67,6 +74,7 @@
     "pako": "^2.1.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
+    "react-leaflet": "^5.0.0",
     "react-rnd": "^10.5.3",
     "react-router-dom": "^6.28.0",
     "short-uuid": "^5.2.0",
@@ -79,6 +87,7 @@
     "@types/base-64": "^1.0.2",
     "@types/canvas-confetti": "^1.9.0",
     "@types/chroma-js": "^2.4.4",
+    "@types/leaflet": "^1.9.21",
     "@types/lodash": "^4.17.24",
     "@types/node": "^25.5.0",
     "@types/pako": "^2.0.4",