@kritzel/engine 0.4.31

package/dist/collection/locales/de-locale.js

@@ -0,0 +1,119 @@
+/**
+ * Built-in German locale.
+ */
+export const DE_LOCALE = {
+    code: 'de',
+    label: 'Deutsch',
+    terms: {
+        // Context menu
+        'menu.copy': 'Kopieren',
+        'menu.cut': 'Ausschneiden',
+        'menu.paste': 'Einfügen',
+        'menu.selectAll': 'Alles auswählen',
+        'menu.order': 'Anordnen',
+        'menu.bringToFront': 'In den Vordergrund',
+        'menu.sendToBack': 'In den Hintergrund',
+        'menu.moveUp': 'Nach vorne',
+        'menu.moveDown': 'Nach hinten',
+        'menu.align': 'Ausrichten',
+        'menu.alignLeft': 'Linksbündig ausrichten',
+        'menu.alignCenterHorizontal': 'Horizontal zentrieren',
+        'menu.alignRight': 'Rechtsbündig ausrichten',
+        'menu.alignTop': 'Oben ausrichten',
+        'menu.alignCenterVertical': 'Vertikal zentrieren',
+        'menu.alignBottom': 'Unten ausrichten',
+        'menu.group': 'Gruppieren',
+        'menu.ungroup': 'Gruppierung aufheben',
+        'menu.export': 'Exportieren',
+        'menu.exportAsSvg': 'Als SVG exportieren',
+        'menu.exportAsPng': 'Als PNG exportieren',
+        'menu.delete': 'Löschen',
+        // More menu
+        'menu.share': 'Teilen',
+        'menu.import': 'Importieren',
+        'menu.settings': 'Einstellungen',
+        'menu.logout': 'Abmelden',
+        // Settings dialog
+        'settings.dialogTitle': 'Einstellungen',
+        'settings.categories.general': 'Allgemein',
+        'settings.categories.viewport': 'Ansichtsfenster',
+        'settings.categories.shortcuts': 'Tastenkürzel',
+        'settings.categories.developer': 'Entwickleroptionen',
+        'settings.categories.about': 'Über',
+        'settings.general.title': 'Allgemeine Einstellungen',
+        'settings.general.theme.label': 'Design',
+        'settings.general.theme.description': 'Wählen Sie ein registriertes Farbdesign für die Editor-Oberfläche.',
+        'settings.general.language.label': 'Sprache',
+        'settings.general.language.description': 'Wählen Sie die Anzeigesprache für die Editor-Oberfläche.',
+        'settings.general.lockDrawingScale.label': 'Zeichenskalierung sperren',
+        'settings.general.lockDrawingScale.description': 'Wenn aktiviert, behalten gezeichnete Objekte unabhängig von der aktuellen Zoomstufe eine feste visuelle Größe.',
+        'settings.viewport.title': 'Ansichtsfenster-Einstellungen',
+        'settings.viewport.minZoom.label': 'Minimale Zoomstufe',
+        'settings.viewport.minZoom.description': 'Legt die minimale Zoomstufe fest. Niedrigere Werte ermöglichen weiteres Herauszoomen, um mehr von der Zeichenfläche zu sehen.',
+        'settings.viewport.maxZoom.label': 'Maximale Zoomstufe',
+        'settings.viewport.maxZoom.description': 'Legt die maximale Zoomstufe fest. Höhere Werte ermöglichen näheres Heranzoomen für Detailarbeit.',
+        'settings.viewport.boundaryLeft.label': 'Ansichtsfenster-Grenze links',
+        'settings.viewport.boundaryLeft.description': 'Linke Grenze in Weltkoordinaten. Legen Sie fest, wie weit das Ansichtsfenster nach links verschoben werden kann.',
+        'settings.viewport.boundaryRight.label': 'Ansichtsfenster-Grenze rechts',
+        'settings.viewport.boundaryRight.description': 'Rechte Grenze in Weltkoordinaten. Legen Sie fest, wie weit das Ansichtsfenster nach rechts verschoben werden kann.',
+        'settings.viewport.boundaryTop.label': 'Ansichtsfenster-Grenze oben',
+        'settings.viewport.boundaryTop.description': 'Obere Grenze in Weltkoordinaten. Legen Sie fest, wie weit das Ansichtsfenster nach oben verschoben werden kann.',
+        'settings.viewport.boundaryBottom.label': 'Ansichtsfenster-Grenze unten',
+        'settings.viewport.boundaryBottom.description': 'Untere Grenze in Weltkoordinaten. Legen Sie fest, wie weit das Ansichtsfenster nach unten verschoben werden kann.',
+        'settings.viewport.boundaryPlaceholder': 'Unendlich',
+        'settings.shortcuts.title': 'Tastenkürzel',
+        'settings.developer.title': 'Entwickleroptionen',
+        'settings.developer.showViewportInfo.label': 'Ansichtsfenster-Infos anzeigen',
+        'settings.developer.showViewportInfo.description': 'Zeigt Debug-Informationen zum Ansichtsfenster an, z. B. Position, Zoomstufe und Grenzen.',
+        'settings.developer.showObjectInfo.label': 'Objekt-Infos anzeigen',
+        'settings.developer.showObjectInfo.description': 'Zeigt Debug-Informationen zu Objekten auf der Zeichenfläche an.',
+        'settings.developer.showSyncProviderInfo.label': 'Sync-Provider-Infos anzeigen',
+        'settings.developer.showSyncProviderInfo.description': 'Zeigt Debug-Informationen zum Verbindungsstatus des Sync-Providers an.',
+        'settings.developer.showMigrationInfo.label': 'Migrations-Infos anzeigen',
+        'settings.developer.showMigrationInfo.description': 'Zeigt Debug-Informationen zu Datenmigrationen an.',
+        'settings.about.title': 'Über',
+        'settings.about.description': 'Kritzel – Eine Zeichenanwendung',
+        // Export dialog
+        'export.dialogTitle': 'Exportieren',
+        'export.tabs.viewport': 'Ansichtsfenster exportieren',
+        'export.tabs.workspace': 'Arbeitsbereich exportieren',
+        'export.format.label': 'Format',
+        'export.filename.label': 'Dateiname',
+        'export.filename.placeholder': 'Dateiname eingeben',
+        'export.exportButton': 'Exportieren',
+        // Workspace manager
+        'workspace.sharedTooltip': 'Geteilter Arbeitsbereich',
+        'workspace.rename': 'Umbenennen',
+        'workspace.delete': 'Löschen',
+        // Zoom panel
+        'zoom.zoomIn': 'Vergrößern',
+        'zoom.zoomOut': 'Verkleinern',
+        // Utility panel
+        'utility.undo': 'Rückgängig',
+        'utility.redo': 'Wiederholen',
+        'utility.delete': 'Ausgewählte Elemente löschen',
+        // Share dialog
+        'share.dialogTitle': 'Arbeitsbereich teilen',
+        'share.linkSharing.label': 'Link-Freigabe',
+        'share.linkSharing.enabledDescription': 'Jeder mit dem Link kann auf diesen Arbeitsbereich zugreifen.',
+        'share.linkSharing.disabledDescription': 'Die Link-Freigabe ist deaktiviert. Nur Sie können auf diesen Arbeitsbereich zugreifen.',
+        'share.linkSharing.toggleLabel': 'Link-Freigabe aktivieren',
+        'share.copyLink.title': 'Link kopieren',
+        'share.copyLink.copied': 'Kopiert!',
+        // Login dialog
+        'login.dialogTitle': 'Anmelden',
+        // Current user dialog
+        'currentUser.dialogTitle': 'Konto',
+        // Back to content
+        'backToContent.label': 'Zurück zum Inhalt',
+        // Tool config
+        'toolConfig.collapse': 'Einklappen',
+        'toolConfig.expand': 'Ausklappen',
+        // More menu button
+        'moreMenu.ariaLabel': 'Weitere Optionen',
+        // Editor
+        'editor.loading': 'Wird geladen...',
+        // Watermark
+        'watermark.poweredBy': 'Bereitgestellt von Kritzel',
+    },
+};

package/dist/collection/locales/en-locale.js

@@ -0,0 +1,120 @@
+/**
+ * Built-in English locale (default). Provides a complete set of term values
+ * that act as the ultimate fallback when other locales omit a key.
+ */
+export const EN_LOCALE = {
+    code: 'en',
+    label: 'English',
+    terms: {
+        // Context menu
+        'menu.copy': 'Copy',
+        'menu.cut': 'Cut',
+        'menu.paste': 'Paste',
+        'menu.selectAll': 'Select All',
+        'menu.order': 'Order',
+        'menu.bringToFront': 'Bring to Front',
+        'menu.sendToBack': 'Send to Back',
+        'menu.moveUp': 'Move Up',
+        'menu.moveDown': 'Move Down',
+        'menu.align': 'Align',
+        'menu.alignLeft': 'Align Left',
+        'menu.alignCenterHorizontal': 'Align Center Horizontally',
+        'menu.alignRight': 'Align Right',
+        'menu.alignTop': 'Align Top',
+        'menu.alignCenterVertical': 'Align Center Vertically',
+        'menu.alignBottom': 'Align Bottom',
+        'menu.group': 'Group',
+        'menu.ungroup': 'Ungroup',
+        'menu.export': 'Export',
+        'menu.exportAsSvg': 'Export as SVG',
+        'menu.exportAsPng': 'Export as PNG',
+        'menu.delete': 'Delete',
+        // More menu
+        'menu.share': 'Share',
+        'menu.import': 'Import',
+        'menu.settings': 'Settings',
+        'menu.logout': 'Logout',
+        // Settings dialog
+        'settings.dialogTitle': 'Settings',
+        'settings.categories.general': 'General',
+        'settings.categories.viewport': 'Viewport',
+        'settings.categories.shortcuts': 'Keyboard Shortcuts',
+        'settings.categories.developer': 'Developer Options',
+        'settings.categories.about': 'About',
+        'settings.general.title': 'General Settings',
+        'settings.general.theme.label': 'Theme',
+        'settings.general.theme.description': 'Select a registered color theme for the editor interface.',
+        'settings.general.language.label': 'Language',
+        'settings.general.language.description': 'Select the display language for the editor interface.',
+        'settings.general.lockDrawingScale.label': 'Lock Drawing Scale',
+        'settings.general.lockDrawingScale.description': 'When enabled, drawn objects maintain a fixed visual size regardless of the current zoom level.',
+        'settings.viewport.title': 'Viewport Settings',
+        'settings.viewport.minZoom.label': 'Minimum Zoom Level',
+        'settings.viewport.minZoom.description': 'Sets the minimum zoom level. Lower values allow zooming out further to see more of the canvas.',
+        'settings.viewport.maxZoom.label': 'Maximum Zoom Level',
+        'settings.viewport.maxZoom.description': 'Sets the maximum zoom level. Higher values allow zooming in closer for detailed work.',
+        'settings.viewport.boundaryLeft.label': 'Viewport Boundary Left',
+        'settings.viewport.boundaryLeft.description': 'Left boundary in world coordinates. Set to limit how far left the viewport can pan.',
+        'settings.viewport.boundaryRight.label': 'Viewport Boundary Right',
+        'settings.viewport.boundaryRight.description': 'Right boundary in world coordinates. Set to limit how far right the viewport can pan.',
+        'settings.viewport.boundaryTop.label': 'Viewport Boundary Top',
+        'settings.viewport.boundaryTop.description': 'Top boundary in world coordinates. Set to limit how far up the viewport can pan.',
+        'settings.viewport.boundaryBottom.label': 'Viewport Boundary Bottom',
+        'settings.viewport.boundaryBottom.description': 'Bottom boundary in world coordinates. Set to limit how far down the viewport can pan.',
+        'settings.viewport.boundaryPlaceholder': 'Infinite',
+        'settings.shortcuts.title': 'Keyboard Shortcuts',
+        'settings.developer.title': 'Developer Options',
+        'settings.developer.showViewportInfo.label': 'Show Viewport Info',
+        'settings.developer.showViewportInfo.description': 'Display viewport debug information such as position, zoom level, and boundaries.',
+        'settings.developer.showObjectInfo.label': 'Show Object Info',
+        'settings.developer.showObjectInfo.description': 'Display debug information about objects on the canvas.',
+        'settings.developer.showSyncProviderInfo.label': 'Show Sync Provider Info',
+        'settings.developer.showSyncProviderInfo.description': 'Display debug information about the sync provider connection status.',
+        'settings.developer.showMigrationInfo.label': 'Show Migration Info',
+        'settings.developer.showMigrationInfo.description': 'Display debug information about data migrations.',
+        'settings.about.title': 'About',
+        'settings.about.description': 'Kritzel - A drawing application',
+        // Export dialog
+        'export.dialogTitle': 'Export',
+        'export.tabs.viewport': 'Export Viewport',
+        'export.tabs.workspace': 'Export Workspace',
+        'export.format.label': 'Format',
+        'export.filename.label': 'Filename',
+        'export.filename.placeholder': 'Enter filename',
+        'export.exportButton': 'Export',
+        // Workspace manager
+        'workspace.sharedTooltip': 'Shared workspace',
+        'workspace.rename': 'Rename',
+        'workspace.delete': 'Delete',
+        // Zoom panel
+        'zoom.zoomIn': 'Zoom in',
+        'zoom.zoomOut': 'Zoom out',
+        // Utility panel
+        'utility.undo': 'Undo',
+        'utility.redo': 'Redo',
+        'utility.delete': 'Delete selected items',
+        // Share dialog
+        'share.dialogTitle': 'Share Workspace',
+        'share.linkSharing.label': 'Link sharing',
+        'share.linkSharing.enabledDescription': 'Anyone with the link can access this workspace.',
+        'share.linkSharing.disabledDescription': 'Link sharing is disabled. Only you can access this workspace.',
+        'share.linkSharing.toggleLabel': 'Enable link sharing',
+        'share.copyLink.title': 'Copy link',
+        'share.copyLink.copied': 'Copied!',
+        // Login dialog
+        'login.dialogTitle': 'Sign in',
+        // Current user dialog
+        'currentUser.dialogTitle': 'Account',
+        // Back to content
+        'backToContent.label': 'Back to content',
+        // Tool config
+        'toolConfig.collapse': 'Collapse',
+        'toolConfig.expand': 'Expand',
+        // More menu button
+        'moreMenu.ariaLabel': 'More options',
+        // Editor
+        'editor.loading': 'Loading...',
+        // Watermark
+        'watermark.poweredBy': 'Powered by Kritzel',
+    },
+};

package/dist/collection/locales/fr-locale.js

@@ -0,0 +1,119 @@
+/**
+ * Built-in French locale.
+ */
+export const FR_LOCALE = {
+    code: 'fr',
+    label: 'Français',
+    terms: {
+        // Context menu
+        'menu.copy': 'Copier',
+        'menu.cut': 'Couper',
+        'menu.paste': 'Coller',
+        'menu.selectAll': 'Tout sélectionner',
+        'menu.order': 'Ordre',
+        'menu.bringToFront': 'Mettre au premier plan',
+        'menu.sendToBack': "Mettre à l'arrière-plan",
+        'menu.moveUp': 'Avancer',
+        'menu.moveDown': 'Reculer',
+        'menu.align': 'Aligner',
+        'menu.alignLeft': 'Aligner à gauche',
+        'menu.alignCenterHorizontal': 'Centrer horizontalement',
+        'menu.alignRight': 'Aligner à droite',
+        'menu.alignTop': 'Aligner en haut',
+        'menu.alignCenterVertical': 'Centrer verticalement',
+        'menu.alignBottom': 'Aligner en bas',
+        'menu.group': 'Grouper',
+        'menu.ungroup': 'Dégrouper',
+        'menu.export': 'Exporter',
+        'menu.exportAsSvg': 'Exporter en SVG',
+        'menu.exportAsPng': 'Exporter en PNG',
+        'menu.delete': 'Supprimer',
+        // More menu
+        'menu.share': 'Partager',
+        'menu.import': 'Importer',
+        'menu.settings': 'Paramètres',
+        'menu.logout': 'Déconnexion',
+        // Settings dialog
+        'settings.dialogTitle': 'Paramètres',
+        'settings.categories.general': 'Général',
+        'settings.categories.viewport': "Fenêtre d'affichage",
+        'settings.categories.shortcuts': 'Raccourcis clavier',
+        'settings.categories.developer': 'Options développeur',
+        'settings.categories.about': 'À propos',
+        'settings.general.title': 'Paramètres généraux',
+        'settings.general.theme.label': 'Thème',
+        'settings.general.theme.description': "Sélectionnez un thème de couleurs enregistré pour l'interface de l'éditeur.",
+        'settings.general.language.label': 'Langue',
+        'settings.general.language.description': "Sélectionnez la langue d'affichage de l'interface de l'éditeur.",
+        'settings.general.lockDrawingScale.label': "Verrouiller l'échelle de dessin",
+        'settings.general.lockDrawingScale.description': "Lorsque cette option est activée, les objets dessinés conservent une taille visuelle fixe quel que soit le niveau de zoom actuel.",
+        'settings.viewport.title': "Paramètres de la fenêtre d'affichage",
+        'settings.viewport.minZoom.label': 'Niveau de zoom minimal',
+        'settings.viewport.minZoom.description': 'Définit le niveau de zoom minimal. Des valeurs plus faibles permettent de dézoomer davantage pour voir une plus grande partie du canevas.',
+        'settings.viewport.maxZoom.label': 'Niveau de zoom maximal',
+        'settings.viewport.maxZoom.description': 'Définit le niveau de zoom maximal. Des valeurs plus élevées permettent de zoomer davantage pour un travail détaillé.',
+        'settings.viewport.boundaryLeft.label': "Limite gauche de la fenêtre d'affichage",
+        'settings.viewport.boundaryLeft.description': "Limite gauche en coordonnées du monde. Définissez jusqu'où la fenêtre d'affichage peut se déplacer vers la gauche.",
+        'settings.viewport.boundaryRight.label': "Limite droite de la fenêtre d'affichage",
+        'settings.viewport.boundaryRight.description': "Limite droite en coordonnées du monde. Définissez jusqu'où la fenêtre d'affichage peut se déplacer vers la droite.",
+        'settings.viewport.boundaryTop.label': "Limite supérieure de la fenêtre d'affichage",
+        'settings.viewport.boundaryTop.description': "Limite supérieure en coordonnées du monde. Définissez jusqu'où la fenêtre d'affichage peut se déplacer vers le haut.",
+        'settings.viewport.boundaryBottom.label': "Limite inférieure de la fenêtre d'affichage",
+        'settings.viewport.boundaryBottom.description': "Limite inférieure en coordonnées du monde. Définissez jusqu'où la fenêtre d'affichage peut se déplacer vers le bas.",
+        'settings.viewport.boundaryPlaceholder': 'Infini',
+        'settings.shortcuts.title': 'Raccourcis clavier',
+        'settings.developer.title': 'Options développeur',
+        'settings.developer.showViewportInfo.label': "Afficher les infos de la fenêtre d'affichage",
+        'settings.developer.showViewportInfo.description': "Affiche les informations de débogage de la fenêtre d'affichage telles que la position, le niveau de zoom et les limites.",
+        'settings.developer.showObjectInfo.label': 'Afficher les infos des objets',
+        'settings.developer.showObjectInfo.description': 'Affiche les informations de débogage des objets sur le canevas.',
+        'settings.developer.showSyncProviderInfo.label': 'Afficher les infos du fournisseur de synchronisation',
+        'settings.developer.showSyncProviderInfo.description': "Affiche les informations de débogage sur l'état de connexion du fournisseur de synchronisation.",
+        'settings.developer.showMigrationInfo.label': 'Afficher les infos de migration',
+        'settings.developer.showMigrationInfo.description': 'Affiche les informations de débogage sur les migrations de données.',
+        'settings.about.title': 'À propos',
+        'settings.about.description': 'Kritzel - Une application de dessin',
+        // Export dialog
+        'export.dialogTitle': 'Exporter',
+        'export.tabs.viewport': "Exporter la fenêtre d'affichage",
+        'export.tabs.workspace': "Exporter l'espace de travail",
+        'export.format.label': 'Format',
+        'export.filename.label': 'Nom du fichier',
+        'export.filename.placeholder': 'Saisir le nom du fichier',
+        'export.exportButton': 'Exporter',
+        // Workspace manager
+        'workspace.sharedTooltip': 'Espace de travail partagé',
+        'workspace.rename': 'Renommer',
+        'workspace.delete': 'Supprimer',
+        // Zoom panel
+        'zoom.zoomIn': 'Zoom avant',
+        'zoom.zoomOut': 'Zoom arrière',
+        // Utility panel
+        'utility.undo': 'Annuler',
+        'utility.redo': 'Rétablir',
+        'utility.delete': 'Supprimer les éléments sélectionnés',
+        // Share dialog
+        'share.dialogTitle': "Partager l'espace de travail",
+        'share.linkSharing.label': 'Partage par lien',
+        'share.linkSharing.enabledDescription': 'Toute personne disposant du lien peut accéder à cet espace de travail.',
+        'share.linkSharing.disabledDescription': 'Le partage par lien est désactivé. Vous seul pouvez accéder à cet espace de travail.',
+        'share.linkSharing.toggleLabel': 'Activer le partage par lien',
+        'share.copyLink.title': 'Copier le lien',
+        'share.copyLink.copied': 'Copié !',
+        // Login dialog
+        'login.dialogTitle': 'Se connecter',
+        // Current user dialog
+        'currentUser.dialogTitle': 'Compte',
+        // Back to content
+        'backToContent.label': 'Retour au contenu',
+        // Tool config
+        'toolConfig.collapse': 'Réduire',
+        'toolConfig.expand': 'Développer',
+        // More menu button
+        'moreMenu.ariaLabel': "Plus d'options",
+        // Editor
+        'editor.loading': 'Chargement...',
+        // Watermark
+        'watermark.poweredBy': 'Propulsé par Kritzel',
+    },
+};

package/dist/collection/migrations/app-state.migrations.js

@@ -0,0 +1,47 @@
+/**
+ * Ordered list of schema migrations for the app-state Y.Doc.
+ * Each migration transforms the document from one schema version to the next.
+ *
+ * To add a new migration:
+ * 1. Bump CURRENT_APP_STATE_SCHEMA_VERSION in constants/schema.constants.ts
+ * 2. Append a new entry with fromVersion = old version, toVersion = new version
+ * 3. Implement the migrate() function — it must be idempotent
+ */
+export const APP_STATE_MIGRATIONS = [
+    {
+        fromVersion: 1,
+        toVersion: 2,
+        /**
+         * Converts workspace viewport from screen-space { translateX, translateY }
+         * to device-independent world-space { centerWorldX, centerWorldY }.
+         *
+         * Since viewport dimensions are not available during migration, uses the
+         * approximation: centerWorld = -translate / scale (world coordinate at screen origin).
+         */
+        migrate(_ydoc, maps) {
+            const workspacesMap = maps['workspaces'];
+            if (!workspacesMap)
+                return;
+            workspacesMap.forEach((serialized, key) => {
+                const viewport = serialized?.viewport;
+                if (!viewport)
+                    return;
+                // Idempotency: skip if already migrated
+                if ('centerWorldX' in viewport)
+                    return;
+                const scale = viewport.scale ?? 1;
+                const translateX = viewport.translateX ?? 0;
+                const translateY = viewport.translateY ?? 0;
+                const migrated = {
+                    ...serialized,
+                    viewport: {
+                        centerWorldX: -translateX / scale || 0,
+                        centerWorldY: -translateY / scale || 0,
+                        scale,
+                    },
+                };
+                workspacesMap.set(key, migrated);
+            });
+        },
+    },
+];

package/dist/collection/migrations/workspace.migrations.js

@@ -0,0 +1,67 @@
+const LEGACY_CUSTOM_ELEMENT_CLASS = 'KritzelCustomElement';
+const DYNAMIC_OBJECT_CLASS = 'KritzelDynamicObject';
+/**
+ * Rewrites the `__class__` discriminator in-place, recursing into nested children of groups.
+ * @returns True if anything was renamed.
+ */
+function renameCustomElementClass(value) {
+    if (Array.isArray(value)) {
+        return value.reduce((changed, entry) => renameCustomElementClass(entry) || changed, false);
+    }
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const record = value;
+    let changed = false;
+    if (record.__class__ === LEGACY_CUSTOM_ELEMENT_CLASS) {
+        record.__class__ = DYNAMIC_OBJECT_CLASS;
+        changed = true;
+    }
+    for (const key of Object.keys(record)) {
+        if (key === '__class__')
+            continue;
+        changed = renameCustomElementClass(record[key]) || changed;
+    }
+    return changed;
+}
+/**
+ * Ordered list of schema migrations for workspace Y.Docs.
+ * Each migration transforms the document from one schema version to the next.
+ *
+ * To add a new migration:
+ * 1. Bump CURRENT_WORKSPACE_SCHEMA_VERSION in constants/schema.constants.ts
+ * 2. Append a new entry with fromVersion = old version, toVersion = new version
+ * 3. Implement the migrate() function — it must be idempotent
+ */
+export const WORKSPACE_MIGRATIONS = [
+    {
+        fromVersion: 1,
+        toVersion: 2,
+        migrate(_ydoc, _maps) {
+            // No-op: adds optional userId property to objects.
+            // Existing objects without userId are valid (field is optional).
+        },
+    },
+    {
+        fromVersion: 2,
+        toVersion: 3,
+        /**
+         * Renames the `KritzelCustomElement` type discriminator to `KritzelDynamicObject`,
+         * including objects nested inside serialized groups.
+         */
+        migrate(_ydoc, maps) {
+            const objectsMap = maps['objects'];
+            if (!objectsMap)
+                return;
+            objectsMap.forEach((serialized, key) => {
+                if (!serialized || typeof serialized !== 'object')
+                    return;
+                // JSON round-trip instead of structuredClone: Yjs rejects cross-realm plain objects.
+                const clone = JSON.parse(JSON.stringify(serialized));
+                if (renameCustomElementClass(clone)) {
+                    objectsMap.set(key, clone);
+                }
+            });
+        },
+    },
+];