rita-workspace 0.5.36 → 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

@@ -2197,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

@@ -2125,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.36",
+  "version": "0.5.37",
   "description": "Multi-drawing workspace feature for Rita (Excalidraw fork)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",