rita-workspace 0.5.35 → 0.5.37

package/README.md

@@ -26,6 +26,8 @@ yarn add rita-workspace
 
 ## Integration Guide
 
+> 📘 For the full host-app integration walkthrough (10 steps including auto-save debounce, switch effect, conflict handling, and replacing Excalidraw's "Open from file"), see [docs/INTEGRATION.md](./docs/INTEGRATION.md).
+
 ### 1. `App.tsx` - Add Provider
 
 ```tsx
@@ -124,6 +126,19 @@ const [workspaceEnabled] = useState(() =>
 - State stored in `sessionStorage` (not shared between tabs)
 - When disabled: auto-save to workspace skipped, drawing-switch disabled, footer hidden
 
+### Auto-start preference
+
+Users can opt into starting every new tab in workspace mode via a checkbox in `DrawingsDialog`. The preference is stored in `localStorage['rita-workspace-auto-start']` (`"true"` to enable, removed when disabled). The host app reads this flag at init time as a fallback when `sessionStorage` has no explicit value:
+
+```tsx
+const [workspaceEnabled] = useState(() => {
+  const sessionVal = sessionStorage.getItem("rita-workspace-enabled");
+  if (sessionVal === "true") return true;
+  if (sessionVal === "false") return false;
+  return localStorage.getItem("rita-workspace-auto-start") === "true";
+});
+```
+
 ## API Reference
 
 ### Components
@@ -131,7 +146,7 @@ const [workspaceEnabled] = useState(() =>
 | Component | Description |
 |-----------|-------------|
 | `WorkspaceProvider` | React context provider. Props: `lang`, `children` |
-| `DrawingsDialog` | Management dialog. Props: `open`, `onClose`, `onDrawingSelect`, `renderThumbnail` |
+| `DrawingsDialog` | Management dialog. Props: `open`, `onClose`, `onDrawingSelect` (called on both switch and create), `renderThumbnail` |
 
 ### Hooks
 
@@ -185,7 +200,7 @@ const {
   importWorkspace,    // () => Promise<void>
   exportDrawingAsExcalidraw, // (id) => Promise<void>
   exportAllDrawingsAsExcalidraw, // () => Promise<void> — downloads all as .excalidraw files
-  importExcalidrawFile,      // () => Promise<void>
+  importExcalidrawFile,      // () => Promise<void> — imports .excalidraw files; switches to the last imported drawing
 } = useWorkspace();
 ```
 

package/dist/index.js

@@ -1192,6 +1192,7 @@ function WorkspaceProvider({ children, lang = "en" }) {
         input.click();
       });
       if (!files || files.length === 0) return;
+      let lastImportedId = null;
       for (const file of Array.from(files)) {
         const text = await file.text();
         const data = JSON.parse(text);
@@ -1206,16 +1207,20 @@ function WorkspaceProvider({ children, lang = "en" }) {
           files: data.files || {}
         });
         await addDrawingToWorkspace(workspace.id, drawing.id);
+        lastImportedId = drawing.id;
       }
       const allDrawings = await getAllDrawings();
       const ws = await getOrCreateDefaultWorkspace();
       const wsDrawings = allDrawings.filter((dr) => ws.drawingIds.includes(dr.id));
       setWorkspace(ws);
       setDrawings(wsDrawings);
+      if (lastImportedId) {
+        await switchDrawing(lastImportedId);
+      }
     } catch (err) {
       setError(err instanceof Error ? err.message : "Failed to import drawing");
     }
-  }, [workspace, t]);
+  }, [workspace, t, switchDrawing]);
   const createFolder2 = (0, import_react.useCallback)(async (name) => {
     const now = Date.now();
     const tempId = `temp-${now}`;
@@ -1781,8 +1786,11 @@ var DrawingsDialog = ({
     setSwitchingId(null);
   }, [switchDrawing, onDrawingSelect]);
   const handleCreate = (0, import_react5.useCallback)(async (folderId) => {
-    await createNewDrawing(void 0, folderId, false);
-  }, [createNewDrawing]);
+    const created = await createNewDrawing(void 0, folderId);
+    if (created) {
+      onDrawingSelect?.(created);
+    }
+  }, [createNewDrawing, onDrawingSelect]);
   const handleStartEdit = (0, import_react5.useCallback)((drawing) => {
     setEditingId(drawing.id);
     setEditName(drawing.name);
@@ -2189,7 +2197,6 @@ var DrawingsDialog = ({
               },
               style: { background: "none", border: "none", cursor: "pointer", padding: "4px", fontSize: "14px", opacity: 0.5 },
               title: t.delete,
-              disabled: drawings.length <= 1,
               children: "\u{1F5D1}\uFE0F"
             }
           )

package/dist/index.mjs

@@ -1120,6 +1120,7 @@ function WorkspaceProvider({ children, lang = "en" }) {
         input.click();
       });
       if (!files || files.length === 0) return;
+      let lastImportedId = null;
       for (const file of Array.from(files)) {
         const text = await file.text();
         const data = JSON.parse(text);
@@ -1134,16 +1135,20 @@ function WorkspaceProvider({ children, lang = "en" }) {
           files: data.files || {}
         });
         await addDrawingToWorkspace(workspace.id, drawing.id);
+        lastImportedId = drawing.id;
       }
       const allDrawings = await getAllDrawings();
       const ws = await getOrCreateDefaultWorkspace();
       const wsDrawings = allDrawings.filter((dr) => ws.drawingIds.includes(dr.id));
       setWorkspace(ws);
       setDrawings(wsDrawings);
+      if (lastImportedId) {
+        await switchDrawing(lastImportedId);
+      }
     } catch (err) {
       setError(err instanceof Error ? err.message : "Failed to import drawing");
     }
-  }, [workspace, t]);
+  }, [workspace, t, switchDrawing]);
   const createFolder2 = useCallback(async (name) => {
     const now = Date.now();
     const tempId = `temp-${now}`;
@@ -1709,8 +1714,11 @@ var DrawingsDialog = ({
     setSwitchingId(null);
   }, [switchDrawing, onDrawingSelect]);
   const handleCreate = useCallback2(async (folderId) => {
-    await createNewDrawing(void 0, folderId, false);
-  }, [createNewDrawing]);
+    const created = await createNewDrawing(void 0, folderId);
+    if (created) {
+      onDrawingSelect?.(created);
+    }
+  }, [createNewDrawing, onDrawingSelect]);
   const handleStartEdit = useCallback2((drawing) => {
     setEditingId(drawing.id);
     setEditName(drawing.name);
@@ -2117,7 +2125,6 @@ var DrawingsDialog = ({
               },
               style: { background: "none", border: "none", cursor: "pointer", padding: "4px", fontSize: "14px", opacity: 0.5 },
               title: t.delete,
-              disabled: drawings.length <= 1,
               children: "\u{1F5D1}\uFE0F"
             }
           )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rita-workspace",
-  "version": "0.5.35",
+  "version": "0.5.37",
   "description": "Multi-drawing workspace feature for Rita (Excalidraw fork)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",