rita-workspace 0.5.36 → 0.5.38

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

@@ -794,7 +794,13 @@ function WorkspaceProvider({ children, lang = "en" }) {
           active = wsDrawings.find((d) => d.id === lastDrawingId) || null;
         }
         if (!active && wsDrawings.length > 0) {
-          active = wsDrawings[0];
+          const globalLastActiveId = localStorage.getItem("rita-workspace-last-active-drawing");
+          if (globalLastActiveId) {
+            active = wsDrawings.find((d) => d.id === globalLastActiveId) || null;
+          }
+          if (!active) {
+            active = wsDrawings[0];
+          }
         }
         if (active) {
           setActiveDrawing2(active);
@@ -808,6 +814,11 @@ function WorkspaceProvider({ children, lang = "en" }) {
     }
     init();
   }, []);
+  (0, import_react.useEffect)(() => {
+    if (activeDrawing?.id) {
+      localStorage.setItem("rita-workspace-last-active-drawing", activeDrawing.id);
+    }
+  }, [activeDrawing?.id]);
   const refreshDrawings = (0, import_react.useCallback)(async () => {
     if (!workspace) return;
     try {
@@ -2197,7 +2208,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

@@ -722,7 +722,13 @@ function WorkspaceProvider({ children, lang = "en" }) {
           active = wsDrawings.find((d) => d.id === lastDrawingId) || null;
         }
         if (!active && wsDrawings.length > 0) {
-          active = wsDrawings[0];
+          const globalLastActiveId = localStorage.getItem("rita-workspace-last-active-drawing");
+          if (globalLastActiveId) {
+            active = wsDrawings.find((d) => d.id === globalLastActiveId) || null;
+          }
+          if (!active) {
+            active = wsDrawings[0];
+          }
         }
         if (active) {
           setActiveDrawing2(active);
@@ -736,6 +742,11 @@ function WorkspaceProvider({ children, lang = "en" }) {
     }
     init();
   }, []);
+  useEffect(() => {
+    if (activeDrawing?.id) {
+      localStorage.setItem("rita-workspace-last-active-drawing", activeDrawing.id);
+    }
+  }, [activeDrawing?.id]);
   const refreshDrawings = useCallback(async () => {
     if (!workspace) return;
     try {
@@ -2125,7 +2136,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.36",
+  "version": "0.5.38",
   "description": "Multi-drawing workspace feature for Rita (Excalidraw fork)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",