ensure minimizer is correctly persisted

closes #5

Author: buzinas

.changeset/new-steaks-listen.md

@@ -0,0 +1,6 @@
+---
+"@react-trace/kit": patch
+"@react-trace/core": patch
+---
+
+Ensure minimizer is correctly persisted

apps/website/docs/guide/configuration.mdx

@@ -12,6 +12,7 @@ When using the batteries-included `@react-trace/kit`, the default export accepts
 | ----------------- | -------------------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------- |
 | `root`            | `string`                                                       | —                | **Required.** Absolute path to the project root.                             |
 | `position`        | `'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right'` | `'bottom-right'` | Where the floating toolbar is placed on screen.                              |
+| `minimized`       | `boolean`                                                      | `false`          | Start with the widget minimized.                                             |
 | `editingDisabled` | `boolean`                                                      | `false`          | Disables inline editing in the preview panel and hides save/expand controls. |
 | `editor`          | `EditorPreset`                                                 | `'vscode'`       | Default editor for the "Open in Editor" action.                              |
 | `plugins`         | `TracePlugin[]`                                                | `[]`             | Additional plugin instances, appended after the 4 built-in plugins.          |

packages/core/README.md

@@ -63,6 +63,7 @@ export function Root() {
 - `root: string` — absolute project root path
 - `plugins?: TracePlugin[]` — plugin instances to mount
 - `position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'` — initial toolbar position
+- `minimized?: boolean` — whether the widget starts minimized by default
 
 ## Plugin model
 

packages/core/src/components/Trace.tsx

@@ -21,11 +21,14 @@ export function Trace({
   root,
   plugins = [],
   position = 'bottom-right',
+  minimized = false,
 }: TraceProps) {
   const [jotaiStore] = useState(() => {
     const store = createWidgetStore()
     store.set(projectRootAtom, root)
-    store.set(coreSettingsAtom, { position })
+    if (!store.get(coreSettingsAtom)) {
+      store.set(coreSettingsAtom, { position, minimized })
+    }
     return store
   })
 

packages/core/src/store.ts

@@ -23,7 +23,7 @@ export const projectRootAtom = atom<string>('')
 const settingsAtom = atomFamily((root: string) =>
   atomWithStorage<TraceSettings>(
     `react-trace:settings:${root}`,
-    { core: { position: 'bottom-right' } },
+    { core: { position: 'bottom-right', minimized: false } },
     createJSONStorage<TraceSettings>(() => localStorage),
     { getOnInit: typeof window !== 'undefined' },
   ),

packages/core/src/types.ts

@@ -44,11 +44,12 @@ export interface TraceProps {
   root: string
   plugins?: TracePlugin[]
   position?: WidgetPosition
+  minimized?: boolean
 }
 
 export interface TraceSettings {
   core: {
     position: WidgetPosition
-    minimized?: boolean
+    minimized: boolean
   }
 }

packages/react-trace/README.md

@@ -52,6 +52,7 @@ The default export supports the following props today:
 | ----------------- | -------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------ |
 | `root`            | `string`                                                       | —                | Required absolute path to the project root.                                          |
 | `position`        | `'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right'` | `'bottom-right'` | Controls where the Trace widget is placed on screen.                                 |
+| `minimized`       | `boolean`                                                      | `false`          | Controls whether the widget starts minimized or not.                                 |
 | `editingDisabled` | `boolean`                                                      | `false`          | Disables inline editing in the preview panel and hides the Save and expand controls. |
 | `editor`          | `EditorPreset`                                                 | `'vscode'`       | Sets the default editor used by the Open in Editor action.                           |
 
@@ -87,8 +88,9 @@ export function Root() {
       <Trace
         root={import.meta.env.VITE_ROOT}
         position="bottom-left"
+        minimized
         editor="cursor"
-        editingDisabled={false}
+        editingDisabled
       />
     </>
   )