From a36dbc7ce82846f5f4e6e830fdc04606adbc7066 Mon Sep 17 00:00:00 2001
From: giswqs <giswqs@gmail.com>
Date: Mon, 10 Aug 2026 01:02:13 -0400
Subject: [PATCH 1/4] Write embedded GeoJSON compactly when saving a project
 (#1829)

`serializeProject` pretty-printed the entire `.geolibre.json`, so every
coordinate value got its own indented line. Coordinate arrays are never
hand-edited, and the whitespace cost roughly three bytes for every byte
of data: a project embedding 367k features weighed 158 MB and 5.9M lines
pretty-printed, but 61 MB and 668 lines compact. Files that large made
reopening unreliable, with layers rendering briefly and then vanishing as
the tab ran out of memory.

Serialization now indents the project structure as before but hands each
GeoJSON feature, geometry and collection to `JSON.stringify` with no
spacing, so files stay readable and diffable while dropping the bloat.
This applies everywhere projects are serialized: save, share, autosave,
collaboration sync and the embed bridge.

Two related fixes on the save path:

- `buildCurrentProject` no longer serializes the project it returns. Every
  caller re-serialized after redacting credentials, so the unused string
  doubled the peak memory of a save.
- Serialization throws `RangeError: Invalid string length` past V8's
  ~536 MB string cap. That escaped `void handleSave()` as an unhandled
  rejection, so Save silently did nothing; it now reports a visible error
  suggesting PMTiles or FlatGeobuf.

The embed prompt also warns above 50 MB of embedded data, pointing at
PMTiles/FlatGeobuf rather than embedding features.
---
 .../layout/toolbar/ProjectFileDialogs.tsx     | 15 ++-
 .../src/hooks/useProjectFileActions.ts        | 52 +++++++++--
 .../geolibre-desktop/src/i18n/locales/ar.json |  2 +
 .../geolibre-desktop/src/i18n/locales/de.json |  2 +
 .../geolibre-desktop/src/i18n/locales/en.json |  2 +
 .../geolibre-desktop/src/i18n/locales/es.json |  2 +
 .../geolibre-desktop/src/i18n/locales/fa.json |  2 +
 .../geolibre-desktop/src/i18n/locales/fr.json |  2 +
 .../geolibre-desktop/src/i18n/locales/hi.json |  2 +
 .../geolibre-desktop/src/i18n/locales/id.json |  2 +
 .../geolibre-desktop/src/i18n/locales/it.json |  2 +
 .../geolibre-desktop/src/i18n/locales/ja.json |  2 +
 .../geolibre-desktop/src/i18n/locales/ka.json |  2 +
 .../geolibre-desktop/src/i18n/locales/ko.json |  2 +
 .../geolibre-desktop/src/i18n/locales/nl.json |  2 +
 .../geolibre-desktop/src/i18n/locales/pt.json |  2 +
 .../geolibre-desktop/src/i18n/locales/ru.json |  2 +
 .../geolibre-desktop/src/i18n/locales/th.json |  2 +
 .../geolibre-desktop/src/i18n/locales/tr.json |  2 +
 .../geolibre-desktop/src/i18n/locales/zh.json |  2 +
 packages/core/src/project.ts                  | 85 ++++++++++++++++-
 tests/core-project.test.ts                    | 91 +++++++++++++++++++
 22 files changed, 268 insertions(+), 11 deletions(-)

diff --git a/apps/geolibre-desktop/src/components/layout/toolbar/ProjectFileDialogs.tsx b/apps/geolibre-desktop/src/components/layout/toolbar/ProjectFileDialogs.tsx
index 25dc296fd..7e1fd00cd 100644
--- a/apps/geolibre-desktop/src/components/layout/toolbar/ProjectFileDialogs.tsx
+++ b/apps/geolibre-desktop/src/components/layout/toolbar/ProjectFileDialogs.tsx
@@ -11,7 +11,10 @@ import {
 } from "@geolibre/ui";
 import { useRef } from "react";
 import { useTranslation } from "react-i18next";
-import type { ProjectFileActions } from "../../../hooks/useProjectFileActions";
+import {
+  LARGE_EMBED_WARNING_BYTES,
+  type ProjectFileActions,
+} from "../../../hooks/useProjectFileActions";
 import { SaveTemplateDialog } from "../SaveTemplateDialog";
 
 interface ProjectFileDialogsProps {
@@ -250,6 +253,16 @@ export function ProjectFileDialogs({ projectFiles }: ProjectFileDialogsProps) {
               )}
             </DialogDescription>
           </DialogHeader>
+          {(projectFiles.embedVectorDataPrompt?.bytes ?? 0) >= LARGE_EMBED_WARNING_BYTES ? (
+            <p
+              role="alert"
+              className="rounded-md border border-amber-500/40 bg-amber-500/10 p-3 text-sm text-amber-700 dark:text-amber-300"
+            >
+              {t("toolbar.item.embedVectorLargeWarning", {
+                size: formatByteSize(projectFiles.embedVectorDataPrompt?.bytes ?? 0),
+              })}
+            </p>
+          ) : null}
           <div className="flex justify-end gap-2">
             <Button
               variant="outline"
diff --git a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
index 1f467c149..2a0faf397 100644
--- a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
+++ b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
@@ -7,6 +7,7 @@ import {
   serializeProject,
   useAppStore,
   type GeoLibreLayer,
+  type GeoLibreProject,
 } from "@geolibre/core";
 import {
   addArcGISLayer,
@@ -58,6 +59,17 @@ export interface CredentialStripPrompt {
   resolve: (choice: "strip" | "keep" | "cancel") => void;
 }
 
+/**
+ * Embedded-data size above which the save prompt warns that the project will be
+ * slow (or impossible) to reopen and points at PMTiles/FlatGeobuf instead.
+ *
+ * Embedded GeoJSON is parsed and held in memory in full when the project is
+ * reopened, so a browser tab can run out of memory and drop the layers with no
+ * error (GeoLibre#1829). 50 MB is well under that cliff while leaving ordinary
+ * projects unbothered.
+ */
+export const LARGE_EMBED_WARNING_BYTES = 50 * 1024 * 1024;
+
 /**
  * A pending "embed local vector data?" prompt, shown on the web when saving a
  * project that has local-file Add Vector Layer layers whose data would
@@ -654,16 +666,41 @@ export function useProjectFileActions(mapControllerRef: MapControllerRef) {
       comments: state.comments,
       metadata: state.metadata,
     });
+    // The serialized text is deliberately not returned: every caller
+    // re-serializes after redacting credentials, so producing it here doubled
+    // the peak memory of a save for a project embedding large vector layers
+    // (GeoLibre#1829).
     return {
       project,
       defaultProjectName,
-      content: serializeProject(project),
       // Expose the path read from this same snapshot so callers don't take a
       // second `getState()` read that could be misread as a separate instant.
       projectPath: state.projectPath,
     };
   };
 
+  // Serializing a project runs synchronously and throws `RangeError: Invalid
+  // string length` once the text passes V8's ~536 MB string cap, which a
+  // project embedding large vector layers can still reach. Unguarded, that
+  // throw escaped `void handleSave()` as an unhandled rejection and Save
+  // silently did nothing (GeoLibre#1829), so report it instead of returning
+  // text. Returns null when the project could not be serialized.
+  const serializeForSave = (project: GeoLibreProject): string | null => {
+    try {
+      return serializeProject(project);
+    } catch (error) {
+      console.error("Failed to serialize project", error);
+      // Only the string-length cap means "too large"; anything else is a real
+      // serialization bug and must not be filed under a size problem.
+      setActionError(
+        error instanceof RangeError
+          ? t("toolbar.error.projectTooLargeToSave")
+          : t("toolbar.error.couldNotSaveProject"),
+      );
+      return null;
+    }
+  };
+
   // Ask whether to strip credentials (environment variables, geocoder keys,
   // layer tokens) before writing the file. The promise resolves when the user
   // picks an option in the dialog.
@@ -837,27 +874,24 @@ export function useProjectFileActions(mapControllerRef: MapControllerRef) {
     // first, so the serialized content below reflects the user's choice.
     const layersForSave = await resolveLayersForSave();
     if (layersForSave === "cancel") return false;
-    const { project, defaultProjectName, content, projectPath } = buildCurrentProject(
+    const { project, defaultProjectName, projectPath } = buildCurrentProject(
       undefined,
       layersForSave.layers,
     );
     // Credentials are serialized in plain text for a local project that needs
     // them. Make keeping them an explicit choice and use the same central
     // redaction pass as every external egress.
-    let contentToSave = content;
+    let contentToSave: string | null;
     const projectToEgress = excludeHiddenFieldsFromProject(project);
     const redacted = redactProjectCredentials(projectToEgress);
     if (redacted.redactedPaths.length > 0) {
       const choice = await askStripCredentials(redacted.redactedCount);
       if (choice === "cancel") return false;
-      if (choice === "strip") {
-        contentToSave = serializeProject(redacted.project);
-      } else {
-        contentToSave = serializeProject(projectToEgress);
-      }
+      contentToSave = serializeForSave(choice === "strip" ? redacted.project : projectToEgress);
     } else {
-      contentToSave = serializeProject(projectToEgress);
+      contentToSave = serializeForSave(projectToEgress);
     }
+    if (contentToSave === null) return false;
     // Projects opened from a URL have no writable path, so both Save and
     // Save As fall back to the save dialog for them.
     const existingLocalPath = projectPath && !isHttpUrl(projectPath) ? projectPath : null;
diff --git a/apps/geolibre-desktop/src/i18n/locales/ar.json b/apps/geolibre-desktop/src/i18n/locales/ar.json
index 7d794f9d6..8af39f3a4 100644
--- a/apps/geolibre-desktop/src/i18n/locales/ar.json
+++ b/apps/geolibre-desktop/src/i18n/locales/ar.json
@@ -2820,6 +2820,7 @@
       "embedVectorTitle": "هل تريد تضمين البيانات المتجهة المحلية؟",
       "embedVectorDesc": "يحتوي هذا المشروع على {{count}} من الطبقات المتجهة المحلية المحملة من جهازك. لا يستطيع المتصفح إعادة قراءتها عند إعادة فتح المشروع، لذا يجب تضمين بياناتها في ملف المشروع حتى يمكن استعادتها. يضيف التضمين نحو {{size}} إلى حجم الملف.",
       "embedVectorDescDesktop": "يحتوي هذا المشروع على {{count}} من الطبقات المتجهة المحلية المحملة من جهازك. ضمِّن بياناتها لجعل المشروع مكتفيًا بذاته (يضيف نحو {{size}})، أو احفظ مراجع الملفات التي يعاد تحميلها من القرص عند إعادة فتح المشروع. تُبقي المراجع الملف صغيرًا لكنها تتعطل إذا نُقل ملف مصدر أو حُذف لاحقًا.",
+      "embedVectorLargeWarning": "تضمين حوالي {{size}} ينتج ملف مشروع كبير جدًا. قد تكون إعادة فتحه بطيئة أو قد تفشل تمامًا، لأنه يجب تحليل كل معلم والاحتفاظ به في الذاكرة دفعة واحدة. لبيانات بهذا الحجم، حوِّل الطبقات إلى PMTiles أو FlatGeobuf وأضفها كطبقات بعيدة بدلاً من تضمينها.",
       "embedVectorEmbedButton": "تضمين البيانات",
       "embedVectorReferenceButton": "حفظ مراجع الملفات",
       "embedVectorSkipButton": "حفظ دون البيانات",
@@ -2951,6 +2952,7 @@
       "couldNotOpenRecentProject": "تعذر فتح المشروع الأخير.",
       "couldNotLoadRecentProject": "تعذر تحميل المشروع الأخير.",
       "couldNotSaveProject": "تعذر حفظ المشروع.",
+      "projectTooLargeToSave": "هذا المشروع أكبر من أن يُحفَظ. حوِّل بياناته المتجهة المضمَّنة إلى PMTiles أو FlatGeobuf وأضفها كطبقات بعيدة بدلاً من تضمين المعالم.",
       "couldNotExportHtml": "تعذر تصدير المشروع إلى HTML.",
       "osmPbfNoFeatures": "لم يُعثر في ملف OSM PBF هذا على أي معالم نقاط أو خطوط أو مضلعات.",
       "couldNotLoadOsmPbf": "تعذر تحميل ملف OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/de.json b/apps/geolibre-desktop/src/i18n/locales/de.json
index 7b95dd2d1..672c064dd 100644
--- a/apps/geolibre-desktop/src/i18n/locales/de.json
+++ b/apps/geolibre-desktop/src/i18n/locales/de.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Lokale Vektordaten einbetten?",
       "embedVectorDesc": "Dieses Projekt enthält {{count}} lokale Vektorebene(n), die von Ihrem Computer geladen wurden. Der Browser kann sie beim erneuten Öffnen des Projekts nicht erneut einlesen, daher müssen ihre Daten in die Projektdatei eingebettet werden, damit sie wiederhergestellt werden können. Das Einbetten fügt der Datei etwa {{size}} hinzu.",
       "embedVectorDescDesktop": "Dieses Projekt enthält {{count}} lokale Vektorebene(n), die von Ihrem Computer geladen wurden. Betten Sie ihre Daten ein, um das Projekt eigenständig zu machen (fügt etwa {{size}} hinzu), oder speichern Sie Dateiverweise, die beim erneuten Öffnen des Projekts von der Festplatte neu geladen werden. Verweise halten die Datei klein, funktionieren aber nicht mehr, wenn eine Quelldatei später verschoben oder gelöscht wird.",
+      "embedVectorLargeWarning": "Etwa {{size}} einzubetten ergibt eine sehr große Projektdatei. Das erneute Öffnen kann langsam sein oder ganz fehlschlagen, da jedes Objekt auf einmal geparst und im Speicher gehalten werden muss. Konvertieren Sie Daten dieser Größe in PMTiles oder FlatGeobuf und fügen Sie sie als Remote-Layer hinzu, statt sie einzubetten.",
       "embedVectorEmbedButton": "Daten einbetten",
       "embedVectorReferenceButton": "Dateiverweise speichern",
       "embedVectorSkipButton": "Ohne Daten speichern",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Das zuletzt verwendete Projekt konnte nicht geöffnet werden.",
       "couldNotLoadRecentProject": "Das zuletzt verwendete Projekt konnte nicht geladen werden.",
       "couldNotSaveProject": "Projekt konnte nicht gespeichert werden.",
+      "projectTooLargeToSave": "Dieses Projekt ist zu groß zum Speichern. Konvertieren Sie die eingebetteten Vektordaten in PMTiles oder FlatGeobuf und fügen Sie sie als Remote-Layer hinzu, statt die Objekte einzubetten.",
       "couldNotExportHtml": "Projekt konnte nicht als HTML exportiert werden.",
       "osmPbfNoFeatures": "In dieser OSM-PBF-Datei wurden keine Punkt-, Linien- oder Polygonobjekte gefunden.",
       "couldNotLoadOsmPbf": "Die OSM-PBF-Datei konnte nicht geladen werden.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/en.json b/apps/geolibre-desktop/src/i18n/locales/en.json
index 9b94a43b7..999b1e099 100644
--- a/apps/geolibre-desktop/src/i18n/locales/en.json
+++ b/apps/geolibre-desktop/src/i18n/locales/en.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Embed local vector data?",
       "embedVectorDesc": "This project has {{count}} local vector layer(s) loaded from your computer. The browser cannot re-read them when the project is reopened, so their data must be embedded in the project file to be restored. Embedding adds about {{size}} to the file.",
       "embedVectorDescDesktop": "This project has {{count}} local vector layer(s) loaded from your computer. Embed their data to make the project self-contained (adds about {{size}}), or save file references that reload from disk when the project is reopened. References keep the file small but break if a source file is later moved or deleted.",
+      "embedVectorLargeWarning": "Embedding about {{size}} makes a very large project file. Reopening it may be slow or fail outright, because every feature has to be parsed and held in memory at once. For data this size, convert the layers to PMTiles or FlatGeobuf and add them as remote layers instead of embedding them.",
       "embedVectorEmbedButton": "Embed data",
       "embedVectorReferenceButton": "Save file references",
       "embedVectorSkipButton": "Save without data",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Could not open the recent project.",
       "couldNotLoadRecentProject": "Could not load the recent project.",
       "couldNotSaveProject": "Could not save the project.",
+      "projectTooLargeToSave": "This project is too large to save. Convert its embedded vector data to PMTiles or FlatGeobuf and add those as remote layers instead of embedding the features.",
       "couldNotExportHtml": "Could not export the project to HTML.",
       "osmPbfNoFeatures": "No point, line, or polygon features were found in this OSM PBF file.",
       "couldNotLoadOsmPbf": "Could not load the OSM PBF file.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/es.json b/apps/geolibre-desktop/src/i18n/locales/es.json
index ef734dbe5..34494a5e8 100644
--- a/apps/geolibre-desktop/src/i18n/locales/es.json
+++ b/apps/geolibre-desktop/src/i18n/locales/es.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "¿Incrustar datos vectoriales locales?",
       "embedVectorDesc": "Este proyecto tiene {{count}} capa(s) vectorial(es) local(es) cargadas desde su equipo. El navegador no puede volver a leerlas cuando se reabre el proyecto, así que sus datos deben incrustarse en el archivo del proyecto para poder restaurarse. Incrustarlas añade aproximadamente {{size}} al archivo.",
       "embedVectorDescDesktop": "Este proyecto tiene {{count}} capa(s) vectorial(es) local(es) cargadas desde su equipo. Incruste sus datos para hacer el proyecto autónomo (añade aproximadamente {{size}}), o guarde referencias de archivo que se recarguen desde el disco al reabrir el proyecto. Las referencias mantienen el archivo pequeño, pero se rompen si el archivo de origen se mueve o elimina más adelante.",
+      "embedVectorLargeWarning": "Incrustar unos {{size}} genera un archivo de proyecto muy grande. Volver a abrirlo puede ser lento o fallar por completo, porque hay que analizar y mantener en memoria todas las entidades a la vez. Para datos de este tamaño, convierta las capas a PMTiles o FlatGeobuf y añádalas como capas remotas en lugar de incrustarlas.",
       "embedVectorEmbedButton": "Incrustar datos",
       "embedVectorReferenceButton": "Guardar referencias de archivo",
       "embedVectorSkipButton": "Guardar sin datos",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "No se pudo abrir el proyecto reciente.",
       "couldNotLoadRecentProject": "No se pudo cargar el proyecto reciente.",
       "couldNotSaveProject": "No se pudo guardar el proyecto.",
+      "projectTooLargeToSave": "Este proyecto es demasiado grande para guardarlo. Convierta sus datos vectoriales incrustados a PMTiles o FlatGeobuf y añádalos como capas remotas en lugar de incrustar las entidades.",
       "couldNotExportHtml": "No se pudo exportar el proyecto a HTML.",
       "osmPbfNoFeatures": "No se encontraron entidades de puntos, líneas o polígonos en este archivo OSM PBF.",
       "couldNotLoadOsmPbf": "No se pudo cargar el archivo OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/fa.json b/apps/geolibre-desktop/src/i18n/locales/fa.json
index 10bf891be..e58404f99 100644
--- a/apps/geolibre-desktop/src/i18n/locales/fa.json
+++ b/apps/geolibre-desktop/src/i18n/locales/fa.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "دادهٔ برداری محلی جاسازی شود؟",
       "embedVectorDesc": "این پروژه {{count}} لایهٔ برداری محلی دارد که از رایانهٔ شما بارگیری شده است. مرورگر هنگام باز شدن دوبارهٔ پروژه نمی‌تواند آن‌ها را دوباره بخواند، پس برای بازیابی باید داده‌شان در فایل پروژه جاسازی شود. جاسازی حدود {{size}} به فایل می‌افزاید.",
       "embedVectorDescDesktop": "این پروژه {{count}} لایهٔ برداری محلی دارد که از رایانهٔ شما بارگیری شده است. داده‌شان را جاسازی کنید تا پروژه خودبسنده شود (حدود {{size}} می‌افزاید)، یا ارجاع‌های فایل را ذخیره کنید تا هنگام باز شدن دوبارهٔ پروژه از دیسک بارگیری شوند. ارجاع‌ها فایل را کوچک نگه می‌دارند اما اگر فایل مبدأ بعداً جابه‌جا یا حذف شود می‌شکنند.",
+      "embedVectorLargeWarning": "جاسازی حدود {{size}} یک فایل پروژهٔ بسیار بزرگ می‌سازد. بازکردن دوبارهٔ آن ممکن است کند باشد یا کاملاً شکست بخورد، چون همهٔ عارضه‌ها باید یکجا تجزیه و در حافظه نگهداری شوند. برای داده‌ای در این اندازه، لایه‌ها را به PMTiles یا FlatGeobuf تبدیل کنید و به‌جای جاسازی، آن‌ها را به‌صورت لایهٔ راه دور اضافه کنید.",
       "embedVectorEmbedButton": "جاسازی داده",
       "embedVectorReferenceButton": "ذخیرهٔ ارجاع‌های فایل",
       "embedVectorSkipButton": "ذخیره بدون داده",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "باز کردن پروژهٔ اخیر ممکن نشد.",
       "couldNotLoadRecentProject": "بارگیری پروژهٔ اخیر ممکن نشد.",
       "couldNotSaveProject": "ذخیرهٔ پروژه ممکن نشد.",
+      "projectTooLargeToSave": "این پروژه برای ذخیره‌شدن بیش از حد بزرگ است. داده‌های برداری جاسازی‌شدهٔ آن را به PMTiles یا FlatGeobuf تبدیل کنید و به‌جای جاسازی عارضه‌ها، آن‌ها را به‌صورت لایهٔ راه دور اضافه کنید.",
       "couldNotExportHtml": "خروجی پروژه به HTML ممکن نشد.",
       "osmPbfNoFeatures": "در این فایل OSM PBF هیچ عارضهٔ نقطه‌ای، خطی یا چندضلعی یافت نشد.",
       "couldNotLoadOsmPbf": "بارگیری فایل OSM PBF ممکن نشد.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/fr.json b/apps/geolibre-desktop/src/i18n/locales/fr.json
index 19191aad5..9c52d5281 100644
--- a/apps/geolibre-desktop/src/i18n/locales/fr.json
+++ b/apps/geolibre-desktop/src/i18n/locales/fr.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Intégrer les données vectorielles locales ?",
       "embedVectorDesc": "Ce projet contient {{count}} couche(s) vectorielle(s) locale(s) chargée(s) depuis votre ordinateur. Le navigateur ne peut pas les relire lorsque le projet est rouvert, leurs données doivent donc être intégrées dans le fichier de projet pour être restaurées. L'intégration ajoute environ {{size}} au fichier.",
       "embedVectorDescDesktop": "Ce projet contient {{count}} couche(s) vectorielle(s) locale(s) chargée(s) depuis votre ordinateur. Intégrez leurs données pour rendre le projet autonome (ajoute environ {{size}}), ou enregistrez des références de fichiers qui se rechargent depuis le disque lorsque le projet est rouvert. Les références gardent le fichier léger mais se rompent si un fichier source est ensuite déplacé ou supprimé.",
+      "embedVectorLargeWarning": "Incorporer environ {{size}} produit un fichier de projet très volumineux. Sa réouverture peut être lente, voire échouer, car chaque entité doit être analysée et conservée en mémoire en une seule fois. Pour des données de cette taille, convertissez les couches en PMTiles ou FlatGeobuf et ajoutez-les comme couches distantes plutôt que de les incorporer.",
       "embedVectorEmbedButton": "Intégrer les données",
       "embedVectorReferenceButton": "Enregistrer les références de fichiers",
       "embedVectorSkipButton": "Enregistrer sans les données",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Impossible d'ouvrir le projet récent.",
       "couldNotLoadRecentProject": "Impossible de charger le projet récent.",
       "couldNotSaveProject": "Impossible d'enregistrer le projet.",
+      "projectTooLargeToSave": "Ce projet est trop volumineux pour être enregistré. Convertissez ses données vectorielles incorporées en PMTiles ou FlatGeobuf et ajoutez-les comme couches distantes plutôt que d'incorporer les entités.",
       "couldNotExportHtml": "Impossible d'exporter le projet en HTML.",
       "osmPbfNoFeatures": "Aucune entité de point, ligne ou polygone n'a été trouvée dans ce fichier OSM PBF.",
       "couldNotLoadOsmPbf": "Impossible de charger le fichier OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/hi.json b/apps/geolibre-desktop/src/i18n/locales/hi.json
index cd4486485..a76ca015f 100644
--- a/apps/geolibre-desktop/src/i18n/locales/hi.json
+++ b/apps/geolibre-desktop/src/i18n/locales/hi.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "स्थानीय वेक्टर डेटा एम्बेड करें?",
       "embedVectorDesc": "इस प्रोजेक्ट में आपके कंप्यूटर से लोड की गई {{count}} स्थानीय वेक्टर परत(ें) हैं। प्रोजेक्ट को फिर से खोलने पर ब्राउज़र उन्हें दोबारा नहीं पढ़ सकता, इसलिए उन्हें पुनर्स्थापित करने के लिए उनका डेटा प्रोजेक्ट फ़ाइल में एम्बेड किया जाना चाहिए। एम्बेड करने से फ़ाइल में लगभग {{size}} जुड़ जाता है।",
       "embedVectorDescDesktop": "इस प्रोजेक्ट में आपके कंप्यूटर से लोड की गई {{count}} स्थानीय वेक्टर परत(ें) हैं। प्रोजेक्ट को स्व-निहित बनाने के लिए उनका डेटा एम्बेड करें (इससे लगभग {{size}} जुड़ जाता है), या फ़ाइल संदर्भ सहेजें जो प्रोजेक्ट को फिर से खोलने पर डिस्क से फिर से लोड हों। संदर्भ फ़ाइल को छोटा रखते हैं लेकिन यदि स्रोत फ़ाइल बाद में स्थानांतरित या हटा दी जाए तो टूट जाते हैं।",
+      "embedVectorLargeWarning": "लगभग {{size}} एम्बेड करने से प्रोजेक्ट फ़ाइल बहुत बड़ी हो जाती है। इसे दोबारा खोलना धीमा हो सकता है या पूरी तरह विफल हो सकता है, क्योंकि हर फ़ीचर को एक साथ पार्स करके मेमोरी में रखना पड़ता है। इस आकार के डेटा के लिए, लेयर को PMTiles या FlatGeobuf में बदलें और उन्हें एम्बेड करने के बजाय रिमोट लेयर के रूप में जोड़ें।",
       "embedVectorEmbedButton": "डेटा एम्बेड करें",
       "embedVectorReferenceButton": "फ़ाइल संदर्भ सहेजें",
       "embedVectorSkipButton": "बिना डेटा के सहेजें",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "हाल का प्रोजेक्ट नहीं खोला जा सका।",
       "couldNotLoadRecentProject": "हाल का प्रोजेक्ट लोड नहीं किया जा सका।",
       "couldNotSaveProject": "प्रोजेक्ट सहेजा नहीं जा सका।",
+      "projectTooLargeToSave": "यह प्रोजेक्ट सहेजने के लिए बहुत बड़ा है। इसके एम्बेड किए गए वेक्टर डेटा को PMTiles या FlatGeobuf में बदलें और फ़ीचर एम्बेड करने के बजाय उन्हें रिमोट लेयर के रूप में जोड़ें।",
       "couldNotExportHtml": "प्रोजेक्ट को HTML में निर्यात नहीं किया जा सका।",
       "osmPbfNoFeatures": "इस OSM PBF फ़ाइल में कोई बिंदु, रेखा, या बहुभुज फ़ीचर नहीं मिले।",
       "couldNotLoadOsmPbf": "OSM PBF फ़ाइल लोड नहीं की जा सकी।",
diff --git a/apps/geolibre-desktop/src/i18n/locales/id.json b/apps/geolibre-desktop/src/i18n/locales/id.json
index 527667726..9bc459fc5 100644
--- a/apps/geolibre-desktop/src/i18n/locales/id.json
+++ b/apps/geolibre-desktop/src/i18n/locales/id.json
@@ -2586,6 +2586,7 @@
       "embedVectorTitle": "Sematkan data vektor lokal?",
       "embedVectorDesc": "Proyek ini memiliki {{count}} layer vektor lokal yang dimuat dari komputer Anda. Browser tidak dapat membaca ulang layer ini saat proyek dibuka kembali, sehingga datanya harus disematkan dalam file proyek untuk dipulihkan. Menyematkan menambah sekitar {{size}} ke file.",
       "embedVectorDescDesktop": "Proyek ini memiliki {{count}} layer vektor lokal yang dimuat dari komputer Anda. Sematkan datanya agar proyek mandiri (menambah sekitar {{size}}), atau simpan referensi file yang dimuat ulang dari disk saat proyek dibuka kembali. Referensi menjaga file tetap kecil tetapi rusak jika file sumber kemudian dipindahkan atau dihapus.",
+      "embedVectorLargeWarning": "Menyematkan sekitar {{size}} menghasilkan berkas proyek yang sangat besar. Membukanya kembali bisa lambat atau gagal sama sekali, karena setiap fitur harus diurai dan disimpan di memori sekaligus. Untuk data sebesar ini, konversikan lapisan ke PMTiles atau FlatGeobuf dan tambahkan sebagai lapisan jarak jauh alih-alih menyematkannya.",
       "embedVectorEmbedButton": "Sematkan data",
       "embedVectorReferenceButton": "Simpan referensi file",
       "embedVectorSkipButton": "Simpan tanpa data",
@@ -2697,6 +2698,7 @@
       "couldNotOpenRecentProject": "Tidak dapat membuka proyek terbaru.",
       "couldNotLoadRecentProject": "Tidak dapat memuat proyek terbaru.",
       "couldNotSaveProject": "Tidak dapat menyimpan proyek.",
+      "projectTooLargeToSave": "Proyek ini terlalu besar untuk disimpan. Konversikan data vektor yang disematkan ke PMTiles atau FlatGeobuf dan tambahkan sebagai lapisan jarak jauh alih-alih menyematkan fiturnya.",
       "couldNotExportHtml": "Tidak dapat mengekspor proyek ke HTML.",
       "osmPbfNoFeatures": "Tidak ditemukan fitur titik, garis, atau poligon dalam file OSM PBF ini.",
       "couldNotLoadOsmPbf": "Tidak dapat memuat file OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/it.json b/apps/geolibre-desktop/src/i18n/locales/it.json
index 9ca7ed5d7..326fe4781 100644
--- a/apps/geolibre-desktop/src/i18n/locales/it.json
+++ b/apps/geolibre-desktop/src/i18n/locales/it.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Incorporare i dati vettoriali locali?",
       "embedVectorDesc": "Questo progetto ha {{count}} livello/i vettoriale/i locale/i caricato/i dal tuo computer. Il browser non può rileggerli quando il progetto viene riaperto, quindi i loro dati devono essere incorporati nel file di progetto per essere ripristinati. L'incorporamento aggiunge circa {{size}} al file.",
       "embedVectorDescDesktop": "Questo progetto ha {{count}} livello/i vettoriale/i locale/i caricato/i dal tuo computer. Incorpora i loro dati per rendere il progetto autonomo (aggiunge circa {{size}}), oppure salva i riferimenti ai file che vengono ricaricati dal disco quando il progetto viene riaperto. I riferimenti mantengono il file di dimensioni ridotte, ma smettono di funzionare se un file di origine viene successivamente spostato o eliminato.",
+      "embedVectorLargeWarning": "Incorporare circa {{size}} produce un file di progetto molto grande. Riaprirlo può essere lento o fallire del tutto, perché ogni elemento deve essere analizzato e tenuto in memoria tutto insieme. Per dati di queste dimensioni, converti i livelli in PMTiles o FlatGeobuf e aggiungili come livelli remoti anziché incorporarli.",
       "embedVectorEmbedButton": "Incorpora dati",
       "embedVectorReferenceButton": "Salva riferimenti ai file",
       "embedVectorSkipButton": "Salva senza dati",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Impossibile aprire il progetto recente.",
       "couldNotLoadRecentProject": "Impossibile caricare il progetto recente.",
       "couldNotSaveProject": "Impossibile salvare il progetto.",
+      "projectTooLargeToSave": "Questo progetto è troppo grande per essere salvato. Converti i suoi dati vettoriali incorporati in PMTiles o FlatGeobuf e aggiungili come livelli remoti anziché incorporare gli elementi.",
       "couldNotExportHtml": "Impossibile esportare il progetto in HTML.",
       "osmPbfNoFeatures": "Nessun elemento punto, linea o poligono trovato in questo file OSM PBF.",
       "couldNotLoadOsmPbf": "Impossibile caricare il file OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/ja.json b/apps/geolibre-desktop/src/i18n/locales/ja.json
index 12df26f6e..5f0ceddfb 100644
--- a/apps/geolibre-desktop/src/i18n/locales/ja.json
+++ b/apps/geolibre-desktop/src/i18n/locales/ja.json
@@ -2586,6 +2586,7 @@
       "embedVectorTitle": "ローカルのベクターデータを埋め込みますか?",
       "embedVectorDesc": "このプロジェクトには、お使いのコンピューターから読み込まれたローカルのベクターレイヤーが {{count}} 個あります。プロジェクトを再度開いたときにブラウザがこれらを再読み込みすることはできないため、復元するにはデータをプロジェクトファイルに埋め込む必要があります。埋め込むとファイルサイズが約 {{size}} 増加します。",
       "embedVectorDescDesktop": "このプロジェクトには、お使いのコンピューターから読み込まれたローカルのベクターレイヤーが {{count}} 個あります。データを埋め込んでプロジェクトを自己完結型にする（約 {{size}} 増加）か、プロジェクトを再度開いたときにディスクから再読み込みされるファイル参照として保存できます。参照はファイルサイズを小さく保ちますが、元のファイルが後で移動または削除されると読み込めなくなります。",
+      "embedVectorLargeWarning": "約 {{size}} を埋め込むと、プロジェクトファイルが非常に大きくなります。すべてのフィーチャを一度に解析してメモリに保持する必要があるため、再度開くときに時間がかかったり、失敗したりすることがあります。このサイズのデータは、レイヤーを PMTiles または FlatGeobuf に変換し、埋め込む代わりにリモートレイヤーとして追加してください。",
       "embedVectorEmbedButton": "データを埋め込む",
       "embedVectorReferenceButton": "ファイル参照を保存",
       "embedVectorSkipButton": "データなしで保存",
@@ -2697,6 +2698,7 @@
       "couldNotOpenRecentProject": "最近使用したプロジェクトを開けませんでした。",
       "couldNotLoadRecentProject": "最近使用したプロジェクトを読み込めませんでした。",
       "couldNotSaveProject": "プロジェクトを保存できませんでした。",
+      "projectTooLargeToSave": "このプロジェクトは大きすぎて保存できません。埋め込まれたベクターデータを PMTiles または FlatGeobuf に変換し、フィーチャを埋め込む代わりにリモートレイヤーとして追加してください。",
       "couldNotExportHtml": "プロジェクトを HTML にエクスポートできませんでした。",
       "osmPbfNoFeatures": "この OSM PBF ファイルにはポイント、ライン、ポリゴンのいずれのフィーチャも見つかりませんでした。",
       "couldNotLoadOsmPbf": "OSM PBF ファイルを読み込めませんでした。",
diff --git a/apps/geolibre-desktop/src/i18n/locales/ka.json b/apps/geolibre-desktop/src/i18n/locales/ka.json
index 178ab419c..99de0e994 100644
--- a/apps/geolibre-desktop/src/i18n/locales/ka.json
+++ b/apps/geolibre-desktop/src/i18n/locales/ka.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "ჩავრთოთ ლოკალური ვექტორული მონაცემები?",
       "embedVectorDesc": "ამ პროექტს აქვს {{count}} ლოკალური ვექტორული შრე, ჩატვირთული თქვენი კომპიუტერიდან. ბრაუზერს არ შეუძლია მათი ხელახლა წაკითხვა პროექტის ხელახლა გახსნისას, ამიტომ აღსადგენად მათი მონაცემები უნდა ჩაიდოს პროექტის ფაილში. ჩართვა ფაილს დაახლოებით {{size}}-ს მატებს.",
       "embedVectorDescDesktop": "ამ პროექტს აქვს {{count}} ლოკალური ვექტორული შრე, ჩატვირთული თქვენი კომპიუტერიდან. ჩართეთ მათი მონაცემები, რომ პროექტი თვითკმარი გახდეს (მატებს დაახლ. {{size}}-ს), ან შეინახეთ ფაილის მიმართვები, რომლებიც პროექტის ხელახლა გახსნისას დისკიდან იტვირთება. მიმართვები ფაილს პატარას ტოვებს, მაგრამ ფუჭდება, თუ წყარო ფაილი მოგვიანებით გადაინაცვლებს ან წაიშლება.",
+      "embedVectorLargeWarning": "დაახლოებით {{size}}-ის ჩაშენება ძალიან დიდ პროექტის ფაილს ქმნის. მისი ხელახლა გახსნა შეიძლება ნელი იყოს ან საერთოდ ჩავარდეს, რადგან ყველა ობიექტი ერთდროულად უნდა დამუშავდეს და მეხსიერებაში ინახებოდეს. ამ ზომის მონაცემებისთვის გადაიყვანეთ ფენები PMTiles-ში ან FlatGeobuf-ში და ჩაშენების ნაცვლად დაამატეთ ისინი დისტანციურ ფენებად.",
       "embedVectorEmbedButton": "მონაცემების ჩართვა",
       "embedVectorReferenceButton": "ფაილის მიმართვების შენახვა",
       "embedVectorSkipButton": "შენახვა მონაცემების გარეშე",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "ბოლო პროექტის გახსნა ვერ მოხერხდა.",
       "couldNotLoadRecentProject": "ბოლო პროექტის ჩატვირთვა ვერ მოხერხდა.",
       "couldNotSaveProject": "პროექტის შენახვა ვერ მოხერხდა.",
+      "projectTooLargeToSave": "ეს პროექტი ძალიან დიდია შესანახად. გადაიყვანეთ მისი ჩაშენებული ვექტორული მონაცემები PMTiles-ში ან FlatGeobuf-ში და ობიექტების ჩაშენების ნაცვლად დაამატეთ ისინი დისტანციურ ფენებად.",
       "couldNotExportHtml": "პროექტის HTML-ში ექსპორტი ვერ მოხერხდა.",
       "osmPbfNoFeatures": "ამ OSM PBF ფაილში წერტილოვანი, ხაზოვანი ან პოლიგონური ობიექტები ვერ მოიძებნა.",
       "couldNotLoadOsmPbf": "OSM PBF ფაილის ჩატვირთვა ვერ მოხერხდა.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/ko.json b/apps/geolibre-desktop/src/i18n/locales/ko.json
index 55dcd5474..6aa09b871 100644
--- a/apps/geolibre-desktop/src/i18n/locales/ko.json
+++ b/apps/geolibre-desktop/src/i18n/locales/ko.json
@@ -2586,6 +2586,7 @@
       "embedVectorTitle": "로컬 벡터 데이터를 포함하시겠습니까?",
       "embedVectorDesc": "이 프로젝트에는 컴퓨터에서 불러온 로컬 벡터 레이어가 {{count}}개 있습니다. 프로젝트를 다시 열 때 브라우저가 이 파일들을 다시 읽을 수 없으므로, 복원하려면 데이터를 프로젝트 파일에 포함해야 합니다. 포함하면 파일 크기가 약 {{size}} 늘어납니다.",
       "embedVectorDescDesktop": "이 프로젝트에는 컴퓨터에서 불러온 로컬 벡터 레이어가 {{count}}개 있습니다. 데이터를 포함하면 프로젝트가 독립적으로 완결되지만(약 {{size}} 추가), 프로젝트를 다시 열 때 디스크에서 다시 불러오는 파일 참조로 저장할 수도 있습니다. 참조는 파일 크기를 작게 유지하지만 원본 파일이 나중에 이동되거나 삭제되면 깨집니다.",
+      "embedVectorLargeWarning": "약 {{size}}를 포함하면 프로젝트 파일이 매우 커집니다. 모든 피처를 한 번에 파싱해 메모리에 유지해야 하므로 다시 열 때 느리거나 아예 실패할 수 있습니다. 이 정도 크기의 데이터는 레이어를 PMTiles 또는 FlatGeobuf로 변환한 뒤, 포함하지 말고 원격 레이어로 추가하세요.",
       "embedVectorEmbedButton": "데이터 포함",
       "embedVectorReferenceButton": "파일 참조 저장",
       "embedVectorSkipButton": "데이터 없이 저장",
@@ -2697,6 +2698,7 @@
       "couldNotOpenRecentProject": "최근 프로젝트를 열 수 없습니다.",
       "couldNotLoadRecentProject": "최근 프로젝트를 불러올 수 없습니다.",
       "couldNotSaveProject": "프로젝트를 저장할 수 없습니다.",
+      "projectTooLargeToSave": "이 프로젝트는 너무 커서 저장할 수 없습니다. 포함된 벡터 데이터를 PMTiles 또는 FlatGeobuf로 변환한 뒤, 피처를 포함하지 말고 원격 레이어로 추가하세요.",
       "couldNotExportHtml": "프로젝트를 HTML로 내보낼 수 없습니다.",
       "osmPbfNoFeatures": "이 OSM PBF 파일에서 점, 선, 폴리곤 피처를 찾을 수 없습니다.",
       "couldNotLoadOsmPbf": "OSM PBF 파일을 불러올 수 없습니다.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/nl.json b/apps/geolibre-desktop/src/i18n/locales/nl.json
index 94fb78443..9c2b8fcd2 100644
--- a/apps/geolibre-desktop/src/i18n/locales/nl.json
+++ b/apps/geolibre-desktop/src/i18n/locales/nl.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Lokale vectorgegevens insluiten?",
       "embedVectorDesc": "Dit project bevat {{count}} lokale vectorlaag/-lagen die vanaf uw computer zijn geladen. De browser kan deze niet opnieuw lezen wanneer het project opnieuw wordt geopend, dus de gegevens moeten in het projectbestand worden ingesloten om te kunnen worden hersteld. Insluiten voegt ongeveer {{size}} toe aan het bestand.",
       "embedVectorDescDesktop": "Dit project bevat {{count}} lokale vectorlaag/-lagen die vanaf uw computer zijn geladen. Sluit de gegevens in om het project op zichzelf staand te maken (voegt ongeveer {{size}} toe), of sla bestandsverwijzingen op die opnieuw worden geladen vanaf schijf wanneer het project opnieuw wordt geopend. Verwijzingen houden het bestand klein, maar breken als een bronbestand later wordt verplaatst of verwijderd.",
+      "embedVectorLargeWarning": "Ongeveer {{size}} insluiten levert een zeer groot projectbestand op. Opnieuw openen kan traag zijn of helemaal mislukken, omdat elk object in één keer moet worden ingelezen en in het geheugen gehouden. Zet gegevens van dit formaat om naar PMTiles of FlatGeobuf en voeg ze toe als externe lagen in plaats van ze in te sluiten.",
       "embedVectorEmbedButton": "Gegevens insluiten",
       "embedVectorReferenceButton": "Bestandsverwijzingen opslaan",
       "embedVectorSkipButton": "Opslaan zonder gegevens",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Het recente project kon niet worden geopend.",
       "couldNotLoadRecentProject": "Het recente project kon niet worden geladen.",
       "couldNotSaveProject": "Het project kon niet worden opgeslagen.",
+      "projectTooLargeToSave": "Dit project is te groot om op te slaan. Zet de ingesloten vectorgegevens om naar PMTiles of FlatGeobuf en voeg die toe als externe lagen in plaats van de objecten in te sluiten.",
       "couldNotExportHtml": "Het project kon niet naar HTML worden geëxporteerd.",
       "osmPbfNoFeatures": "Er zijn geen punt-, lijn- of polygoonfeatures gevonden in dit OSM PBF-bestand.",
       "couldNotLoadOsmPbf": "Het OSM PBF-bestand kon niet worden geladen.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/pt.json b/apps/geolibre-desktop/src/i18n/locales/pt.json
index b97237686..45d3341f7 100644
--- a/apps/geolibre-desktop/src/i18n/locales/pt.json
+++ b/apps/geolibre-desktop/src/i18n/locales/pt.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Incorporar dados vetoriais locais?",
       "embedVectorDesc": "Este projeto tem {{count}} camada(s) vetorial(is) local(is) carregada(s) do seu computador. O navegador não pode relê-las quando o projeto é reaberto, então seus dados precisam ser incorporados no arquivo do projeto para serem restaurados. A incorporação adiciona cerca de {{size}} ao arquivo.",
       "embedVectorDescDesktop": "Este projeto tem {{count}} camada(s) vetorial(is) local(is) carregada(s) do seu computador. Incorpore seus dados para tornar o projeto autocontido (adiciona cerca de {{size}}), ou salve referências de arquivo que recarregam do disco quando o projeto é reaberto. As referências mantêm o arquivo pequeno, mas quebram se um arquivo de origem for movido ou excluído posteriormente.",
+      "embedVectorLargeWarning": "Incorporar cerca de {{size}} gera um arquivo de projeto muito grande. Reabri-lo pode ser lento ou falhar completamente, porque todas as feições precisam ser lidas e mantidas na memória de uma só vez. Para dados desse tamanho, converta as camadas para PMTiles ou FlatGeobuf e adicione-as como camadas remotas em vez de incorporá-las.",
       "embedVectorEmbedButton": "Incorporar dados",
       "embedVectorReferenceButton": "Salvar referências de arquivo",
       "embedVectorSkipButton": "Salvar sem dados",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Não foi possível abrir o projeto recente.",
       "couldNotLoadRecentProject": "Não foi possível carregar o projeto recente.",
       "couldNotSaveProject": "Não foi possível salvar o projeto.",
+      "projectTooLargeToSave": "Este projeto é grande demais para ser salvo. Converta seus dados vetoriais incorporados para PMTiles ou FlatGeobuf e adicione-os como camadas remotas em vez de incorporar as feições.",
       "couldNotExportHtml": "Não foi possível exportar o projeto para HTML.",
       "osmPbfNoFeatures": "Nenhuma feição de ponto, linha ou polígono foi encontrada neste arquivo OSM PBF.",
       "couldNotLoadOsmPbf": "Não foi possível carregar o arquivo OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/ru.json b/apps/geolibre-desktop/src/i18n/locales/ru.json
index 0121e2e09..6eb439982 100644
--- a/apps/geolibre-desktop/src/i18n/locales/ru.json
+++ b/apps/geolibre-desktop/src/i18n/locales/ru.json
@@ -2727,6 +2727,7 @@
       "embedVectorTitle": "Встроить локальные векторные данные?",
       "embedVectorDesc": "В этом проекте загружено локальных векторных слоёв с вашего компьютера: {{count}}. Браузер не может повторно прочитать их при повторном открытии проекта, поэтому их данные должны быть встроены в файл проекта для восстановления. Встраивание добавляет к файлу около {{size}}.",
       "embedVectorDescDesktop": "В этом проекте загружено локальных векторных слоёв с вашего компьютера: {{count}}. Встройте их данные, чтобы сделать проект автономным (добавляет около {{size}}), либо сохраните ссылки на файлы, которые будут перезагружаться с диска при повторном открытии проекта. Ссылки сохраняют файл небольшим, но перестают работать, если исходный файл позже перемещён или удалён.",
+      "embedVectorLargeWarning": "Встраивание около {{size}} создаёт очень большой файл проекта. Его повторное открытие может быть медленным или вовсе не удаться, поскольку все объекты приходится разбирать и держать в памяти одновременно. Для данных такого размера преобразуйте слои в PMTiles или FlatGeobuf и добавьте их как удалённые слои вместо встраивания.",
       "embedVectorEmbedButton": "Встроить данные",
       "embedVectorReferenceButton": "Сохранить ссылки на файлы",
       "embedVectorSkipButton": "Сохранить без данных",
@@ -2850,6 +2851,7 @@
       "couldNotOpenRecentProject": "Не удалось открыть недавний проект.",
       "couldNotLoadRecentProject": "Не удалось загрузить недавний проект.",
       "couldNotSaveProject": "Не удалось сохранить проект.",
+      "projectTooLargeToSave": "Этот проект слишком велик для сохранения. Преобразуйте встроенные векторные данные в PMTiles или FlatGeobuf и добавьте их как удалённые слои вместо встраивания объектов.",
       "couldNotExportHtml": "Не удалось экспортировать проект в HTML.",
       "osmPbfNoFeatures": "В этом файле OSM PBF не найдено ни точечных, ни линейных, ни полигональных объектов.",
       "couldNotLoadOsmPbf": "Не удалось загрузить файл OSM PBF.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/th.json b/apps/geolibre-desktop/src/i18n/locales/th.json
index 04c5caeb7..840a0bdd5 100644
--- a/apps/geolibre-desktop/src/i18n/locales/th.json
+++ b/apps/geolibre-desktop/src/i18n/locales/th.json
@@ -2586,6 +2586,7 @@
       "embedVectorTitle": "ฝังข้อมูลเวกเตอร์ในเครื่องหรือไม่?",
       "embedVectorDesc": "โปรเจกต์นี้มีเลเยอร์เวกเตอร์ในเครื่อง {{count}} เลเยอร์ที่โหลดมาจากคอมพิวเตอร์ของคุณ เบราว์เซอร์ไม่สามารถอ่านไฟล์เหล่านั้นซ้ำได้เมื่อเปิดโปรเจกต์อีกครั้ง จึงต้องฝังข้อมูลไว้ในไฟล์โปรเจกต์เพื่อให้กู้คืนได้ การฝังข้อมูลจะเพิ่มขนาดไฟล์ประมาณ {{size}}",
       "embedVectorDescDesktop": "โปรเจกต์นี้มีเลเยอร์เวกเตอร์ในเครื่อง {{count}} เลเยอร์ที่โหลดมาจากคอมพิวเตอร์ของคุณ คุณสามารถฝังข้อมูลเพื่อให้โปรเจกต์สมบูรณ์ในตัว (เพิ่มขนาดประมาณ {{size}}) หรือบันทึกเป็นการอ้างอิงไฟล์ที่จะโหลดจากดิสก์เมื่อเปิดโปรเจกต์อีกครั้ง การอ้างอิงจะทำให้ไฟล์มีขนาดเล็ก แต่จะใช้ไม่ได้หากไฟล์ต้นทางถูกย้ายหรือลบในภายหลัง",
+      "embedVectorLargeWarning": "การฝังข้อมูลประมาณ {{size}} ทำให้ไฟล์โปรเจกต์มีขนาดใหญ่มาก การเปิดใหม่อาจช้าหรือล้มเหลวไปเลย เพราะต้องแยกวิเคราะห์และเก็บทุกฟีเจอร์ไว้ในหน่วยความจำพร้อมกัน สำหรับข้อมูลขนาดนี้ ให้แปลงชั้นข้อมูลเป็น PMTiles หรือ FlatGeobuf แล้วเพิ่มเป็นชั้นข้อมูลระยะไกลแทนการฝัง",
       "embedVectorEmbedButton": "ฝังข้อมูล",
       "embedVectorReferenceButton": "บันทึกเป็นการอ้างอิงไฟล์",
       "embedVectorSkipButton": "บันทึกโดยไม่รวมข้อมูล",
@@ -2697,6 +2698,7 @@
       "couldNotOpenRecentProject": "ไม่สามารถเปิดโปรเจกต์ล่าสุดได้",
       "couldNotLoadRecentProject": "ไม่สามารถโหลดโปรเจกต์ล่าสุดได้",
       "couldNotSaveProject": "ไม่สามารถบันทึกโปรเจกต์ได้",
+      "projectTooLargeToSave": "โปรเจกต์นี้ใหญ่เกินกว่าจะบันทึกได้ ให้แปลงข้อมูลเวกเตอร์ที่ฝังไว้เป็น PMTiles หรือ FlatGeobuf แล้วเพิ่มเป็นชั้นข้อมูลระยะไกลแทนการฝังฟีเจอร์",
       "couldNotExportHtml": "ไม่สามารถส่งออกโปรเจกต์เป็น HTML ได้",
       "osmPbfNoFeatures": "ไม่พบฟีเจอร์แบบจุด เส้น หรือรูปหลายเหลี่ยมในไฟล์ OSM PBF นี้",
       "couldNotLoadOsmPbf": "ไม่สามารถโหลดไฟล์ OSM PBF ได้",
diff --git a/apps/geolibre-desktop/src/i18n/locales/tr.json b/apps/geolibre-desktop/src/i18n/locales/tr.json
index 5d3ca1497..46189f0ce 100644
--- a/apps/geolibre-desktop/src/i18n/locales/tr.json
+++ b/apps/geolibre-desktop/src/i18n/locales/tr.json
@@ -2633,6 +2633,7 @@
       "embedVectorTitle": "Yerel vektör verisi gömülsün mü?",
       "embedVectorDesc": "Bu projede bilgisayarınızdan yüklenmiş {{count}} yerel vektör katmanı var. Tarayıcı, proje yeniden açıldığında bunları yeniden okuyamaz; bu nedenle geri yüklenebilmeleri için verilerinin proje dosyasına gömülmesi gerekir. Gömme, dosyaya yaklaşık {{size}} ekler.",
       "embedVectorDescDesktop": "Bu projede bilgisayarınızdan yüklenmiş {{count}} yerel vektör katmanı var. Projeyi kendi kendine yeterli hale getirmek için verilerini gömün (yaklaşık {{size}} ekler) veya proje yeniden açıldığında diskten yeniden yüklenen dosya referansları kaydedin. Referanslar dosyayı küçük tutar ancak kaynak dosya daha sonra taşınır veya silinirse bozulur.",
+      "embedVectorLargeWarning": "Yaklaşık {{size}} gömmek çok büyük bir proje dosyası oluşturur. Her nesnenin aynı anda ayrıştırılıp bellekte tutulması gerektiğinden dosyayı yeniden açmak yavaş olabilir veya tamamen başarısız olabilir. Bu boyuttaki veriler için katmanları PMTiles ya da FlatGeobuf biçimine dönüştürün ve gömmek yerine uzak katman olarak ekleyin.",
       "embedVectorEmbedButton": "Veriyi göm",
       "embedVectorReferenceButton": "Dosya referanslarını kaydet",
       "embedVectorSkipButton": "Verisiz kaydet",
@@ -2748,6 +2749,7 @@
       "couldNotOpenRecentProject": "Son proje açılamadı.",
       "couldNotLoadRecentProject": "Son proje yüklenemedi.",
       "couldNotSaveProject": "Proje kaydedilemedi.",
+      "projectTooLargeToSave": "Bu proje kaydedilemeyecek kadar büyük. Gömülü vektör verilerini PMTiles ya da FlatGeobuf biçimine dönüştürün ve nesneleri gömmek yerine uzak katman olarak ekleyin.",
       "couldNotExportHtml": "Proje HTML'e dışa aktarılamadı.",
       "osmPbfNoFeatures": "Bu OSM PBF dosyasında nokta, çizgi veya poligon öğesi bulunamadı.",
       "couldNotLoadOsmPbf": "OSM PBF dosyası yüklenemedi.",
diff --git a/apps/geolibre-desktop/src/i18n/locales/zh.json b/apps/geolibre-desktop/src/i18n/locales/zh.json
index 924fa251e..ebd3dc7f2 100644
--- a/apps/geolibre-desktop/src/i18n/locales/zh.json
+++ b/apps/geolibre-desktop/src/i18n/locales/zh.json
@@ -2586,6 +2586,7 @@
       "embedVectorTitle": "是否嵌入本地矢量数据？",
       "embedVectorDesc": "此项目包含 {{count}} 个从您计算机加载的本地矢量图层。项目重新打开时浏览器无法重新读取这些文件，因此必须将其数据嵌入项目文件中才能恢复。嵌入会为文件增加约 {{size}} 的大小。",
       "embedVectorDescDesktop": "此项目包含 {{count}} 个从您计算机加载的本地矢量图层。您可以嵌入它们的数据以使项目自包含（增加约 {{size}}），也可以保存文件引用，在项目重新打开时从磁盘重新加载。引用可保持文件较小，但若源文件之后被移动或删除则会失效。",
+      "embedVectorLargeWarning": "嵌入约 {{size}} 会生成非常大的项目文件。由于必须一次性解析并在内存中保留全部要素，重新打开时可能很慢，甚至直接失败。对于这种大小的数据，请将图层转换为 PMTiles 或 FlatGeobuf，并以远程图层的方式添加，而不要嵌入。",
       "embedVectorEmbedButton": "嵌入数据",
       "embedVectorReferenceButton": "保存文件引用",
       "embedVectorSkipButton": "不含数据保存",
@@ -2697,6 +2698,7 @@
       "couldNotOpenRecentProject": "无法打开最近的项目。",
       "couldNotLoadRecentProject": "无法加载最近的项目。",
       "couldNotSaveProject": "无法保存项目。",
+      "projectTooLargeToSave": "此项目过大，无法保存。请将其嵌入的矢量数据转换为 PMTiles 或 FlatGeobuf，并以远程图层的方式添加，而不要嵌入要素。",
       "couldNotExportHtml": "无法将项目导出为 HTML。",
       "osmPbfNoFeatures": "在此 OSM PBF 文件中未找到点、线或面要素。",
       "couldNotLoadOsmPbf": "无法加载 OSM PBF 文件。",
diff --git a/packages/core/src/project.ts b/packages/core/src/project.ts
index cc6431bd0..20fad0bd8 100644
--- a/packages/core/src/project.ts
+++ b/packages/core/src/project.ts
@@ -106,8 +106,91 @@ export function createEmptyProject(
   };
 }
 
+/**
+ * GeoJSON `type` values that mark a subtree as feature data rather than project
+ * structure. Everything under one of these is written compactly by
+ * {@link serializeProject}.
+ */
+const GEOJSON_TYPES = new Set([
+  "FeatureCollection",
+  "Feature",
+  "GeometryCollection",
+  "Point",
+  "MultiPoint",
+  "LineString",
+  "MultiLineString",
+  "Polygon",
+  "MultiPolygon",
+]);
+
+/** One level of indentation in a serialized project. */
+const PROJECT_INDENT = "  ";
+
+/** Whether a value is a GeoJSON feature, geometry, or collection. */
+function isGeoJsonValue(value: object): boolean {
+  const type = (value as { type?: unknown }).type;
+  return typeof type === "string" && GEOJSON_TYPES.has(type);
+}
+
+/**
+ * Serialize a value exactly as `JSON.stringify(value, null, 2)` would, except
+ * that GeoJSON features, geometries and collections are written compactly on a
+ * single line.
+ *
+ * Coordinate arrays are never hand-edited, but indenting them costs roughly
+ * three bytes of whitespace for every one byte of data: a project embedding
+ * 13,000 features weighed 179 MB pretty-printed and 54 MB compact
+ * (GeoLibre#1829), which is the difference between reopening and running the
+ * tab out of memory. The surrounding project structure stays indented so the
+ * file is still readable and diffs still make sense.
+ *
+ * @param value Value to serialize.
+ * @param depth Current nesting depth, driving the indent width.
+ * @returns The serialized text, or undefined for values `JSON.stringify` also
+ *   drops (undefined, functions, symbols).
+ */
+function serializeProjectValue(value: unknown, depth: number): string | undefined {
+  if (value !== null && typeof value === "object") {
+    // Honor the toJSON hook the way JSON.stringify does, so a value that
+    // replaces itself is inspected in its replaced form.
+    const toJSON = (value as { toJSON?: unknown }).toJSON;
+    if (typeof toJSON === "function") {
+      value = (toJSON as (key: string) => unknown).call(value, "");
+    }
+  }
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  // Feature data: hand the whole subtree to JSON.stringify with no spacing.
+  if (isGeoJsonValue(value)) return JSON.stringify(value);
+
+  const pad = PROJECT_INDENT.repeat(depth + 1);
+  const closePad = PROJECT_INDENT.repeat(depth);
+  if (Array.isArray(value)) {
+    if (value.length === 0) return "[]";
+    // An unserializable array entry becomes null, matching JSON.stringify.
+    const entries = value.map((entry) => serializeProjectValue(entry, depth + 1) ?? "null");
+    return `[\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}]`;
+  }
+  const entries: string[] = [];
+  for (const [key, entry] of Object.entries(value)) {
+    const serialized = serializeProjectValue(entry, depth + 1);
+    // An unserializable object value is omitted, matching JSON.stringify.
+    if (serialized === undefined) continue;
+    entries.push(`${JSON.stringify(key)}: ${serialized}`);
+  }
+  if (entries.length === 0) return "{}";
+  return `{\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}}`;
+}
+
+/**
+ * Serialize a project to `.geolibre.json` text: indented project structure with
+ * compact (unindented) embedded GeoJSON. See {@link serializeProjectValue} for
+ * why the two halves are formatted differently.
+ *
+ * @param project Project to serialize.
+ * @returns The file contents to write.
+ */
 export function serializeProject(project: GeoLibreProject): string {
-  return JSON.stringify(project, null, 2);
+  return serializeProjectValue(project, 0) ?? "null";
 }
 
 export function parseProject(json: string): GeoLibreProject {
diff --git a/tests/core-project.test.ts b/tests/core-project.test.ts
index e13d10f6b..0e79a673a 100644
--- a/tests/core-project.test.ts
+++ b/tests/core-project.test.ts
@@ -567,6 +567,97 @@ describe("project parsing", () => {
   });
 });
 
+describe("project serialization", () => {
+  /** A layer whose features carry enough coordinates to show the whitespace cost. */
+  const featureRichLayer = () =>
+    geojsonLayer({
+      id: "cities",
+      geojson: {
+        type: "FeatureCollection",
+        features: Array.from({ length: 200 }, (_, index) => ({
+          type: "Feature" as const,
+          properties: { name: `City ${index}` },
+          geometry: {
+            type: "LineString" as const,
+            coordinates: Array.from(
+              { length: 20 },
+              (_, point) => [index / 10 + point, point / 10] as [number, number],
+            ),
+          },
+        })),
+      },
+    });
+
+  it("writes embedded GeoJSON compactly while indenting the project structure", () => {
+    const project = createEmptyProject("Compact");
+    project.layers = [featureRichLayer()];
+    const text = serializeProject(project);
+
+    // The structure stays readable...
+    assert.match(text, /^\{\n {2}"version":/);
+    assert.match(text, /\n {2}"layers": \[\n {4}\{\n {6}"id": "cities",/);
+    // ...but the whole feature collection sits on one line, so no coordinate
+    // ever gets its own line of indentation (GeoLibre#1829).
+    assert.match(
+      text,
+      /\n {6}"geojson": \{"type":"FeatureCollection","features":\[\{"type":"Feature"/,
+    );
+    assert.ok(!text.includes('"coordinates": ['), "coordinate arrays must not be pretty-printed");
+  });
+
+  it("compacts an embedded GeoJSON copy held in layer metadata", () => {
+    const project = createEmptyProject("Embedded");
+    const { geojson, ...layer } = featureRichLayer();
+    project.layers = [{ ...layer, metadata: { embeddedGeoJSON: geojson } }];
+    const text = serializeProject(project);
+
+    assert.match(text, /"embeddedGeoJSON": \{"type":"FeatureCollection"/);
+    assert.ok(!text.includes('"coordinates": ['));
+  });
+
+  it("keeps a feature-heavy project within a few percent of a fully minified file", () => {
+    const project = createEmptyProject("Sized");
+    project.layers = [featureRichLayer()];
+    const minified = JSON.stringify(project).length;
+
+    // Pretty-printing every coordinate used to cost more than 3x; the structure
+    // that stays indented is a rounding error next to the feature data.
+    assert.ok(
+      serializeProject(project).length < minified * 1.05,
+      "serialized project should be close to the minified size",
+    );
+  });
+
+  it("formats a project without GeoJSON exactly as JSON.stringify does", () => {
+    const project = createEmptyProject("Plain");
+    assert.equal(serializeProject(project), JSON.stringify(project, null, 2));
+  });
+
+  it("matches JSON.stringify for values it drops, empty containers, and toJSON", () => {
+    const project = createEmptyProject("Edges");
+    project.metadata = {
+      dropped: undefined,
+      inArray: [undefined, () => "fn", 1],
+      notFinite: Number.NaN,
+      emptyObject: {},
+      emptyArray: [],
+      nested: { deep: { deeper: [1, { two: 2 }] } },
+      date: new Date("2026-08-10T00:00:00.000Z"),
+      quote: 'a "quoted" \\ value\n',
+    };
+    assert.equal(serializeProject(project), JSON.stringify(project, null, 2));
+  });
+
+  it("round-trips a feature-heavy project through parseProject", () => {
+    const project = createEmptyProject("Round trip");
+    project.layers = [featureRichLayer()];
+    assert.deepEqual(
+      parseProject(serializeProject(project)).layers[0].geojson,
+      project.layers[0].geojson,
+    );
+  });
+});
+
 describe("multi-map grid persistence", () => {
   it("omits the grid keys for a default single-map project", () => {
     const project = projectFromStore({

From cf44621ca03d654f7a26c7d0b708bb65f4bf1c7d Mon Sep 17 00:00:00 2001
From: giswqs <giswqs@gmail.com>
Date: Mon, 10 Aug 2026 01:12:48 -0400
Subject: [PATCH 2/4] Address review feedback

- Detect circular references in the project serializer and throw the
  TypeError JSON.stringify raises, instead of recursing until the stack
  overflows. The RangeError an overflow raises is indistinguishable from
  the string-length cap the save path reads as "project too large".
- Visit sparse array holes by index rather than mapping, so a hole is
  written as null the way JSON.stringify writes it (mapping skipped the
  hole and emitted invalid JSON).
- Pass the property name (or stringified array index) to a value's
  toJSON hook, matching the key JSON.stringify supplies.
- Narrow the "project too large to save" message to the string-length
  RangeError, so other RangeErrors report a generic save failure.
---
 .../src/hooks/useProjectFileActions.ts        |  7 +-
 packages/core/src/project.ts                  | 66 +++++++++++++------
 tests/core-project.test.ts                    | 36 ++++++++++
 3 files changed, 87 insertions(+), 22 deletions(-)

diff --git a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
index 2a0faf397..b9c2c0e03 100644
--- a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
+++ b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
@@ -691,9 +691,12 @@ export function useProjectFileActions(mapControllerRef: MapControllerRef) {
     } catch (error) {
       console.error("Failed to serialize project", error);
       // Only the string-length cap means "too large"; anything else is a real
-      // serialization bug and must not be filed under a size problem.
+      // serialization bug and must not be filed under a size problem. Matching
+      // on `RangeError` alone was too broad — a stack overflow raises one too,
+      // and pointing that at PMTiles/FlatGeobuf would send the user chasing a
+      // size problem they do not have.
       setActionError(
-        error instanceof RangeError
+        error instanceof RangeError && error.message.includes("Invalid string length")
           ? t("toolbar.error.projectTooLargeToSave")
           : t("toolbar.error.couldNotSaveProject"),
       );
diff --git a/packages/core/src/project.ts b/packages/core/src/project.ts
index 20fad0bd8..d6c5154f2 100644
--- a/packages/core/src/project.ts
+++ b/packages/core/src/project.ts
@@ -146,39 +146,65 @@ function isGeoJsonValue(value: object): boolean {
  *
  * @param value Value to serialize.
  * @param depth Current nesting depth, driving the indent width.
+ * @param key Property name (or stringified array index) this value sits under,
+ *   `""` at the root — the argument `JSON.stringify` passes to `toJSON`.
+ * @param ancestors Containers currently open on the recursion stack, used to
+ *   detect cycles.
  * @returns The serialized text, or undefined for values `JSON.stringify` also
  *   drops (undefined, functions, symbols).
  */
-function serializeProjectValue(value: unknown, depth: number): string | undefined {
+function serializeProjectValue(
+  value: unknown,
+  depth: number,
+  key: string,
+  ancestors: Set<object>,
+): string | undefined {
   if (value !== null && typeof value === "object") {
     // Honor the toJSON hook the way JSON.stringify does, so a value that
-    // replaces itself is inspected in its replaced form.
+    // replaces itself is inspected in its replaced form. It receives the same
+    // key JSON.stringify would pass, since a custom hook may branch on it.
     const toJSON = (value as { toJSON?: unknown }).toJSON;
     if (typeof toJSON === "function") {
-      value = (toJSON as (key: string) => unknown).call(value, "");
+      value = (toJSON as (key: string) => unknown).call(value, key);
     }
   }
   if (value === null || typeof value !== "object") return JSON.stringify(value);
   // Feature data: hand the whole subtree to JSON.stringify with no spacing.
   if (isGeoJsonValue(value)) return JSON.stringify(value);
 
-  const pad = PROJECT_INDENT.repeat(depth + 1);
-  const closePad = PROJECT_INDENT.repeat(depth);
-  if (Array.isArray(value)) {
-    if (value.length === 0) return "[]";
-    // An unserializable array entry becomes null, matching JSON.stringify.
-    const entries = value.map((entry) => serializeProjectValue(entry, depth + 1) ?? "null");
-    return `[\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}]`;
-  }
-  const entries: string[] = [];
-  for (const [key, entry] of Object.entries(value)) {
-    const serialized = serializeProjectValue(entry, depth + 1);
-    // An unserializable object value is omitted, matching JSON.stringify.
-    if (serialized === undefined) continue;
-    entries.push(`${JSON.stringify(key)}: ${serialized}`);
+  // A cycle would recurse until the stack overflowed, and the RangeError that
+  // raises is indistinguishable from the string-length cap the save path reads
+  // as "project too large". Fail the way JSON.stringify does instead. Only the
+  // open ancestors are tracked, so a value referenced twice side by side (not a
+  // cycle) still serializes.
+  if (ancestors.has(value)) throw new TypeError("Converting circular structure to JSON");
+  ancestors.add(value);
+  try {
+    const pad = PROJECT_INDENT.repeat(depth + 1);
+    const closePad = PROJECT_INDENT.repeat(depth);
+    if (Array.isArray(value)) {
+      if (value.length === 0) return "[]";
+      // Indexed rather than mapped so a sparse array's holes are visited: like
+      // an unserializable entry, a hole becomes null, matching JSON.stringify.
+      const entries = Array.from(
+        { length: value.length },
+        (_unused, index) =>
+          serializeProjectValue(value[index], depth + 1, String(index), ancestors) ?? "null",
+      );
+      return `[\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}]`;
+    }
+    const entries: string[] = [];
+    for (const [entryKey, entry] of Object.entries(value)) {
+      const serialized = serializeProjectValue(entry, depth + 1, entryKey, ancestors);
+      // An unserializable object value is omitted, matching JSON.stringify.
+      if (serialized === undefined) continue;
+      entries.push(`${JSON.stringify(entryKey)}: ${serialized}`);
+    }
+    if (entries.length === 0) return "{}";
+    return `{\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}}`;
+  } finally {
+    ancestors.delete(value);
   }
-  if (entries.length === 0) return "{}";
-  return `{\n${pad}${entries.join(`,\n${pad}`)}\n${closePad}}`;
 }
 
 /**
@@ -190,7 +216,7 @@ function serializeProjectValue(value: unknown, depth: number): string | undefine
  * @returns The file contents to write.
  */
 export function serializeProject(project: GeoLibreProject): string {
-  return serializeProjectValue(project, 0) ?? "null";
+  return serializeProjectValue(project, 0, "", new Set()) ?? "null";
 }
 
 export function parseProject(json: string): GeoLibreProject {
diff --git a/tests/core-project.test.ts b/tests/core-project.test.ts
index 0e79a673a..cb674a0b3 100644
--- a/tests/core-project.test.ts
+++ b/tests/core-project.test.ts
@@ -648,6 +648,42 @@ describe("project serialization", () => {
     assert.equal(serializeProject(project), JSON.stringify(project, null, 2));
   });
 
+  it("writes a sparse array's holes as null, matching JSON.stringify", () => {
+    const project = createEmptyProject("Sparse");
+    // eslint-disable-next-line no-sparse-arrays
+    project.metadata = { gappy: [1, , 2] };
+    const text = serializeProject(project);
+    assert.equal(text, JSON.stringify(project, null, 2));
+    assert.deepEqual((JSON.parse(text) as typeof project).metadata.gappy, [1, null, 2]);
+  });
+
+  it("passes the property key to a custom toJSON, as JSON.stringify does", () => {
+    const project = createEmptyProject("Keys");
+    const probe = { toJSON: (key: string) => `saw:${key}` };
+    project.metadata = { named: probe, list: [probe] };
+    assert.equal(serializeProject(project), JSON.stringify(project, null, 2));
+    const parsed = JSON.parse(serializeProject(project)) as typeof project;
+    assert.equal(parsed.metadata.named, "saw:named");
+    assert.deepEqual(parsed.metadata.list, ["saw:0"]);
+  });
+
+  it("throws on a circular reference instead of overflowing the stack", () => {
+    const project = createEmptyProject("Cyclic");
+    const cycle: Record<string, unknown> = {};
+    cycle.self = cycle;
+    project.metadata = { cycle };
+    // A RangeError here would be read as "project too large to save" by the
+    // save path, sending the user after a size problem they do not have.
+    assert.throws(() => serializeProject(project), TypeError);
+  });
+
+  it("serializes a value referenced twice side by side without calling it a cycle", () => {
+    const project = createEmptyProject("Shared");
+    const shared = { shared: true };
+    project.metadata = { first: shared, second: shared };
+    assert.equal(serializeProject(project), JSON.stringify(project, null, 2));
+  });
+
   it("round-trips a feature-heavy project through parseProject", () => {
     const project = createEmptyProject("Round trip");
     project.layers = [featureRichLayer()];

From 5c106b242fd2e572e37f5b6e292c44d78d0195ff Mon Sep 17 00:00:00 2001
From: giswqs <giswqs@gmail.com>
Date: Mon, 10 Aug 2026 01:23:08 -0400
Subject: [PATCH 3/4] Address review feedback

- Unwrap boxed Number/String/Boolean objects to their primitives, the way
  JSON.stringify does, instead of recursing over their (empty) own
  properties and writing {}.
- Document that isGeoJsonValue discriminates on the `type` string alone,
  so a future schema field must not reuse one of those nine names for a
  non-GeoJSON value.
---
 packages/core/src/project.ts | 16 +++++++++++++++-
 tests/core-project.test.ts   | 19 +++++++++++++++++++
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/project.ts b/packages/core/src/project.ts
index d6c5154f2..a99c03aad 100644
--- a/packages/core/src/project.ts
+++ b/packages/core/src/project.ts
@@ -126,7 +126,16 @@ const GEOJSON_TYPES = new Set([
 /** One level of indentation in a serialized project. */
 const PROJECT_INDENT = "  ";
 
-/** Whether a value is a GeoJSON feature, geometry, or collection. */
+/**
+ * Whether a value is a GeoJSON feature, geometry, or collection.
+ *
+ * Decided from the `type` string alone, so this is an implicit contract on the
+ * project schema: no field may store a non-GeoJSON object under a `type` of one
+ * of the nine {@link GEOJSON_TYPES} names, or it would silently be written
+ * compact as if it were feature data. Nothing in `types.ts` does today; a new
+ * field that wants one of those names (a drawing-tool or geometry-filter config,
+ * say) needs a different discriminator.
+ */
 function isGeoJsonValue(value: object): boolean {
   const type = (value as { type?: unknown }).type;
   return typeof type === "string" && GEOJSON_TYPES.has(type);
@@ -169,6 +178,11 @@ function serializeProjectValue(
     }
   }
   if (value === null || typeof value !== "object") return JSON.stringify(value);
+  // A boxed Number/String/Boolean writes as its primitive rather than as an
+  // object, the way JSON.stringify unwraps it.
+  if (value instanceof Number || value instanceof String || value instanceof Boolean) {
+    return JSON.stringify(value);
+  }
   // Feature data: hand the whole subtree to JSON.stringify with no spacing.
   if (isGeoJsonValue(value)) return JSON.stringify(value);
 
diff --git a/tests/core-project.test.ts b/tests/core-project.test.ts
index cb674a0b3..29fa6b883 100644
--- a/tests/core-project.test.ts
+++ b/tests/core-project.test.ts
@@ -667,6 +667,25 @@ describe("project serialization", () => {
     assert.deepEqual(parsed.metadata.list, ["saw:0"]);
   });
 
+  it("unwraps boxed primitives the way JSON.stringify does", () => {
+    const project = createEmptyProject("Boxed");
+    project.metadata = {
+      // eslint-disable-next-line no-new-wrappers
+      count: new Number(7),
+      // eslint-disable-next-line no-new-wrappers
+      label: new String("x"),
+      // eslint-disable-next-line no-new-wrappers
+      flag: new Boolean(true),
+    };
+    const text = serializeProject(project);
+    assert.equal(text, JSON.stringify(project, null, 2));
+    assert.deepEqual((JSON.parse(text) as typeof project).metadata, {
+      count: 7,
+      label: "x",
+      flag: true,
+    });
+  });
+
   it("throws on a circular reference instead of overflowing the stack", () => {
     const project = createEmptyProject("Cyclic");
     const cycle: Record<string, unknown> = {};

From a1060d2464d063a39aac83b0b08cd2441efde206 Mon Sep 17 00:00:00 2001
From: giswqs <giswqs@gmail.com>
Date: Mon, 10 Aug 2026 01:32:06 -0400
Subject: [PATCH 4/4] Address review feedback

Detect the "too large to serialize" failure across webview engines, not
just V8. GeoLibre's Tauri webview is JavaScriptCore on macOS and Linux,
which reports an out-of-memory error rather than V8's "Invalid string
length", so matching only V8's wording left desktop users on those
platforms with the generic save failure instead of the PMTiles/FlatGeobuf
guidance. The check now tests the message against the known engine
phrasings, still narrow enough that a cycle or other real serialization
bug reports generically.
---
 .../src/hooks/useProjectFileActions.ts        | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
index b9c2c0e03..2924633ae 100644
--- a/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
+++ b/apps/geolibre-desktop/src/hooks/useProjectFileActions.ts
@@ -70,6 +70,23 @@ export interface CredentialStripPrompt {
  */
 export const LARGE_EMBED_WARNING_BYTES = 50 * 1024 * 1024;
 
+/**
+ * Messages engines raise when a string passes their maximum length, which is
+ * how "this project is too large to serialize" surfaces.
+ *
+ * Matched by text rather than by error class because there is no typed signal:
+ * V8 (Chromium, WebView2) throws `RangeError: Invalid string length`,
+ * JavaScriptCore (the macOS and Linux Tauri webviews) reports an out-of-memory
+ * error, and SpiderMonkey says "allocation size overflow". Matching only V8's
+ * wording would leave desktop users on every other webview with the generic
+ * failure message instead of the guidance this exists to give.
+ *
+ * Deliberately narrow: a genuine serialization bug (a cycle, say, which reads
+ * "Converting circular structure to JSON") must not be filed under size.
+ */
+const SERIALIZATION_TOO_LARGE_PATTERN =
+  /invalid string length|out of memory|allocation size overflow|string too long/i;
+
 /**
  * A pending "embed local vector data?" prompt, shown on the web when saving a
  * project that has local-file Add Vector Layer layers whose data would
@@ -696,7 +713,7 @@ export function useProjectFileActions(mapControllerRef: MapControllerRef) {
       // and pointing that at PMTiles/FlatGeobuf would send the user chasing a
       // size problem they do not have.
       setActionError(
-        error instanceof RangeError && error.message.includes("Invalid string length")
+        error instanceof Error && SERIALIZATION_TOO_LARGE_PATTERN.test(error.message)
           ? t("toolbar.error.projectTooLargeToSave")
           : t("toolbar.error.couldNotSaveProject"),
       );