pixelweaver 0.1.0

package/docs/_README.md

@@ -0,0 +1,117 @@
+---
+title: README.md
+---
+# PixelWeaver
+
+A pixel art sprite editor built with Svelte 5 and wesktop.
+
+## Overview
+
+PixelWeaver is a desktop-class pixel art editor that runs in a native window or browser. The frontend is built with Svelte 5 (runes, vanilla Vite) and dockview-core for panel docking. The backend is a Python server using wesktop (ASGI micro-router + granian) with pywebview for native desktop windows. An MCP server exposes drawing and project tools for AI agent integration.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Frontend | Svelte 5, TypeScript, dockview-core, Vite |
+| Server | Python 3.13+, wesktop (ASGI + granian), Pydantic, Pillow |
+| Desktop | pywebview (native OS window) |
+| CLI | strictcli |
+| Icons | unplugin-icons with Iconify (lucide set) |
+| AI integration | MCP server (stdio) |
+
+## Install
+
+```bash
+npm install
+uv sync
+```
+
+## Quick Start
+
+Development mode (Vite HMR + wesktop server):
+
+```bash
+pixelweaver dev
+```
+
+Headless server (port 7779):
+
+```bash
+pixelweaver serve
+```
+
+Desktop window:
+
+```bash
+npm run build
+pixelweaver open
+```
+
+Browser mode:
+
+```bash
+npm run build
+pixelweaver open --browser
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `pixelweaver dev` | Development mode with Vite HMR |
+| `pixelweaver serve` | Start the headless API server |
+| `pixelweaver open` | Launch desktop window (pywebview) |
+| `pixelweaver open --browser` | Launch in default browser |
+| `pixelweaver new <name>` | Create a new project on disk |
+| `pixelweaver list` | List projects on disk |
+| `pixelweaver mcp` | Start the MCP tool server (stdio) |
+| `pixelweaver diagnose` | Check runtime environment and dependencies |
+| `pixelweaver config show` | Display current configuration |
+| `pixelweaver config set <key> <value>` | Set a config value |
+| `pixelweaver config edit` | Open config file in editor |
+| `pixelweaver config path` | Print config file path |
+
+## Architecture
+
+```
+src/                     Svelte 5 frontend (Vite)
+  lib/
+    plugins/             Plugin system (tools, panels, exporters, importers)
+    ...
+server/
+  src/pixelweaver/
+    cli.py               CLI entry point (strictcli)
+    main.py              ASGI app factory and routes
+    state.py             In-memory project state
+    storage.py           Project persistence
+    bridge.py            pywebview desktop bridge
+    websocket.py         WebSocket handlers
+    mcp_server.py        MCP server for AI agents
+    protocol.py          Shared protocol types
+    ...
+docs/                    Documentation (selfdoc)
+```
+
+The frontend communicates with the server over HTTP and WebSocket. In desktop mode, pywebview opens a native window pointing at the local server. In development mode, `pixelweaver dev` starts both Vite (with HMR) and the wesktop server behind a proxy.
+
+## Plugin System
+
+Plugins are discovered via `import.meta.glob` at bootstrap. Each plugin exports a `register(api)` function that receives a `PluginAPI` with methods for registering commands, tools, panels, exporters, importers, shortcuts, menu items, and toolbar items. Eight reactive registries (backed by SvelteMap) power the UI.
+
+## Development
+
+```bash
+npm install              # Install frontend dependencies
+uv sync                  # Install server dependencies
+pixelweaver dev          # Start dev server (Vite + wesktop)
+npm run build            # Build frontend to dist/
+npm run check            # TypeScript checks
+npm run lint             # ESLint
+npm run test             # Vitest (frontend)
+uv run pytest            # Pytest (server)
+```
+
+## License
+
+MIT

package/docs/cli-config.md

@@ -0,0 +1,35 @@
+---
+title: pixelweaver config
+description: "Reference for the pixelweaver config command group — subcommands, flags, arguments, and usage details for the config group in the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 1
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver config
+
+Manage configuration
+
+## config path
+
+Print the config file path
+
+## config show
+
+Show all config values with source attribution
+
+## config set
+
+Set a config value
+
+### Arguments
+
+| Name | Required | Description |
+|------|----------|-------------|
+| `key` | yes | Config key to set |
+| `value` | yes | Value to set |
+
+## config edit
+
+Open the config file in $EDITOR

package/docs/cli-dev.md

@@ -0,0 +1,21 @@
+---
+title: pixelweaver dev
+description: "Reference for the pixelweaver dev command — usage, flags, arguments, and examples for the dev subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 2
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver dev
+
+Development mode with Vite HMR
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--host` |  | str | 127.0.0.1 |  | Bind address |
+| `--port` |  | int | 7779 |  | Port |
+| `--vite-port` |  | int | 5173 |  | Vite dev server port |
+| `--data-dir` |  | str | ./projects |  | Projects directory |

package/docs/cli-diagnose.md

@@ -0,0 +1,12 @@
+---
+title: pixelweaver diagnose
+description: "Reference for the pixelweaver diagnose command — usage, flags, arguments, and examples for the diagnose subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 3
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver diagnose
+
+Check runtime environment and dependencies

package/docs/cli-index.md

@@ -0,0 +1,30 @@
+---
+title: pixelweaver CLI Reference
+description: "Complete CLI reference for pixelweaver — all available commands, subcommands, flags, arguments, and usage examples with detailed descriptions."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 0
+order: 91
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver CLI Reference
+
+PixelWeaver collaboration server
+
+Version: 0.1.0
+
+## Commands
+
+- [serve](cli-serve.html) -- Start the server
+- [new](cli-new.html) -- Create a new project on disk
+- [list](cli-list.html) -- List projects on disk
+- [mcp](cli-mcp.html) -- Start the MCP tool server (stdio)
+- [dev](cli-dev.html) -- Development mode with Vite HMR
+- [open](cli-open.html) -- Launch desktop window
+- [diagnose](cli-diagnose.html) -- Check runtime environment and dependencies
+- [stop](cli-stop.html) -- Stop the running server
+
+## Command Groups
+
+- [config](cli-config.html) -- Manage configuration

package/docs/cli-list.md

@@ -0,0 +1,18 @@
+---
+title: pixelweaver list
+description: "Reference for the pixelweaver list command — usage, flags, arguments, and examples for the list subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 4
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver list
+
+List projects on disk
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--data-dir` |  | str | ./projects |  | Projects directory |

package/docs/cli-mcp.md

@@ -0,0 +1,18 @@
+---
+title: pixelweaver mcp
+description: "Reference for the pixelweaver mcp command — usage, flags, arguments, and examples for the mcp subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 5
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver mcp
+
+Start the MCP tool server (stdio)
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--data-dir` |  | str | ./projects |  | Projects directory |

package/docs/cli-new.md

@@ -0,0 +1,26 @@
+---
+title: pixelweaver new
+description: "Reference for the pixelweaver new command — usage, flags, arguments, and examples for the new subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 6
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver new
+
+Create a new project on disk
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--width` |  | int |  |  | Canvas width in pixels |
+| `--height` |  | int |  |  | Canvas height in pixels |
+| `--data-dir` |  | str | ./projects |  | Projects directory |
+
+## Arguments
+
+| Name | Required | Description |
+|------|----------|-------------|
+| `name` | yes | Project name |

package/docs/cli-open.md

@@ -0,0 +1,21 @@
+---
+title: pixelweaver open
+description: "Reference for the pixelweaver open command — usage, flags, arguments, and examples for the open subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 7
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver open
+
+Launch desktop window
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--host` |  | str | 127.0.0.1 |  | Bind address |
+| `--port` |  | int | 7779 |  | Port |
+| `--browser` |  | bool |  |  | Open in browser instead of native window |
+| `--data-dir` |  | str | ./projects |  | Projects directory |

package/docs/cli-serve.md

@@ -0,0 +1,21 @@
+---
+title: pixelweaver serve
+description: "Reference for the pixelweaver serve command — usage, flags, arguments, and examples for the serve subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 8
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver serve
+
+Start the server
+
+## Flags
+
+| Name | Short | Type | Default | Env | Description |
+|------|-------|------|---------|-----|-------------|
+| `--host` |  | str | 127.0.0.1 |  | Bind address |
+| `--port` |  | int | 7779 |  | Port |
+| `--reload` |  | bool |  |  | Auto-reload on file changes |
+| `--data-dir` |  | str | ./projects |  | Projects directory |

package/docs/cli-stop.md

@@ -0,0 +1,12 @@
+---
+title: pixelweaver stop
+description: "Reference for the pixelweaver stop command — usage, flags, arguments, and examples for the stop subcommand of the pixelweaver CLI."
+generated: true
+nav_group: "CLI Reference"
+nav_order: 9
+---
+<!-- generated by selfdoc gen (strictcli), do not edit -->
+
+# pixelweaver stop
+
+Stop the running server

package/docs/gen-index.md

@@ -0,0 +1,36 @@
+---
+title: API Reference
+description: "Complete auto-generated API reference index — browse all modules, classes, and functions with their signatures and docstrings."
+generated: true
+nav_group: "API Reference"
+nav_order: 0
+order: 90
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# API Reference
+
+- [server.src.pixelweaver](server-src-pixelweaver.html)
+- [server.src.pixelweaver.__main__](server-src-pixelweaver-__main__.html)
+- [server.src.pixelweaver.autosave](server-src-pixelweaver-autosave.html)
+- [server.src.pixelweaver.bridge](server-src-pixelweaver-bridge.html)
+- [server.src.pixelweaver.cli](server-src-pixelweaver-cli.html)
+- [server.src.pixelweaver.config](server-src-pixelweaver-config.html)
+- [server.src.pixelweaver.connections](server-src-pixelweaver-connections.html)
+- [server.src.pixelweaver.main](server-src-pixelweaver-main.html)
+- [server.src.pixelweaver.mcp_bridge](server-src-pixelweaver-mcp_bridge.html)
+- [server.src.pixelweaver.mcp_drawing_tools](server-src-pixelweaver-mcp_drawing_tools.html)
+- [server.src.pixelweaver.mcp_export_tools](server-src-pixelweaver-mcp_export_tools.html)
+- [server.src.pixelweaver.mcp_frame_tools](server-src-pixelweaver-mcp_frame_tools.html)
+- [server.src.pixelweaver.mcp_history_tools](server-src-pixelweaver-mcp_history_tools.html)
+- [server.src.pixelweaver.mcp_layer_tools](server-src-pixelweaver-mcp_layer_tools.html)
+- [server.src.pixelweaver.mcp_lock](server-src-pixelweaver-mcp_lock.html)
+- [server.src.pixelweaver.mcp_project_tools](server-src-pixelweaver-mcp_project_tools.html)
+- [server.src.pixelweaver.mcp_read_tools](server-src-pixelweaver-mcp_read_tools.html)
+- [server.src.pixelweaver.mcp_registry](server-src-pixelweaver-mcp_registry.html)
+- [server.src.pixelweaver.mcp_resources](server-src-pixelweaver-mcp_resources.html)
+- [server.src.pixelweaver.mcp_server](server-src-pixelweaver-mcp_server.html)
+- [server.src.pixelweaver.protocol](server-src-pixelweaver-protocol.html)
+- [server.src.pixelweaver.state](server-src-pixelweaver-state.html)
+- [server.src.pixelweaver.storage](server-src-pixelweaver-storage.html)
+- [server.src.pixelweaver.websocket](server-src-pixelweaver-websocket.html)

package/docs/index.md

@@ -0,0 +1,13 @@
+---
+title: PixelWeaver
+description: "PixelWeaver -- collaborative pixel art editor with real-time multi-user drawing, native desktop mode via pywebview, and MCP tool integration."
+date: 2026-05-25
+---
+
+# PixelWeaver
+
+Welcome to the PixelWeaver documentation.
+
+## API Reference
+
+:-: ref path="pixelweaver"

package/docs/server-src-pixelweaver-__main__.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.__main__
+description: "Enable python -m pixelweaver."
+generated: true
+nav_group: "API Reference"
+nav_order: 2
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.__main__
+
+:-: ref path="server.src.pixelweaver.__main__"

package/docs/server-src-pixelweaver-autosave.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.autosave
+description: "Auto-save: periodic flush of in-memory state to disk."
+generated: true
+nav_group: "API Reference"
+nav_order: 3
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.autosave
+
+:-: ref path="server.src.pixelweaver.autosave"

package/docs/server-src-pixelweaver-bridge.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.bridge
+description: "Desktop file I/O bridge for pywebview."
+generated: true
+nav_group: "API Reference"
+nav_order: 4
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.bridge
+
+:-: ref path="server.src.pixelweaver.bridge"

package/docs/server-src-pixelweaver-cli.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.cli
+description: "PixelWeaver CLI."
+generated: true
+nav_group: "API Reference"
+nav_order: 5
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.cli
+
+:-: ref path="server.src.pixelweaver.cli"

package/docs/server-src-pixelweaver-config.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.config
+description: "Process-wide configuration for PixelWeaver server."
+generated: true
+nav_group: "API Reference"
+nav_order: 6
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.config
+
+:-: ref path="server.src.pixelweaver.config"

package/docs/server-src-pixelweaver-connections.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.connections
+description: "WebSocket connection manager for PixelWeaver."
+generated: true
+nav_group: "API Reference"
+nav_order: 7
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.connections
+
+:-: ref path="server.src.pixelweaver.connections"

package/docs/server-src-pixelweaver-main.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.main
+description: "wesktop application for PixelWeaver collaboration server."
+generated: true
+nav_group: "API Reference"
+nav_order: 8
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.main
+
+:-: ref path="server.src.pixelweaver.main"

package/docs/server-src-pixelweaver-mcp_bridge.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_bridge
+description: "MCP Bridge -- HTTP client that forwards MCP state to/from the collab server."
+generated: true
+nav_group: "API Reference"
+nav_order: 9
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_bridge
+
+:-: ref path="server.src.pixelweaver.mcp_bridge"

package/docs/server-src-pixelweaver-mcp_drawing_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_drawing_tools
+description: "Drawing tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 10
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_drawing_tools
+
+:-: ref path="server.src.pixelweaver.mcp_drawing_tools"

package/docs/server-src-pixelweaver-mcp_export_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_export_tools
+description: "Export and curated high-level tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 11
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_export_tools
+
+:-: ref path="server.src.pixelweaver.mcp_export_tools"

package/docs/server-src-pixelweaver-mcp_frame_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_frame_tools
+description: "Frame tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 12
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_frame_tools
+
+:-: ref path="server.src.pixelweaver.mcp_frame_tools"

package/docs/server-src-pixelweaver-mcp_history_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_history_tools
+description: "History tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 13
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_history_tools
+
+:-: ref path="server.src.pixelweaver.mcp_history_tools"

package/docs/server-src-pixelweaver-mcp_layer_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_layer_tools
+description: "Layer tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 14
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_layer_tools
+
+:-: ref path="server.src.pixelweaver.mcp_layer_tools"

package/docs/server-src-pixelweaver-mcp_lock.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_lock
+description: "Mutex for MCP command execution."
+generated: true
+nav_group: "API Reference"
+nav_order: 15
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_lock
+
+:-: ref path="server.src.pixelweaver.mcp_lock"

package/docs/server-src-pixelweaver-mcp_project_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_project_tools
+description: "Project and canvas tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 16
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_project_tools
+
+:-: ref path="server.src.pixelweaver.mcp_project_tools"

package/docs/server-src-pixelweaver-mcp_read_tools.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_read_tools
+description: "Read/introspection tools for MCP registry."
+generated: true
+nav_group: "API Reference"
+nav_order: 17
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_read_tools
+
+:-: ref path="server.src.pixelweaver.mcp_read_tools"

package/docs/server-src-pixelweaver-mcp_registry.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_registry
+description: "MCP command registry for PixelWeaver."
+generated: true
+nav_group: "API Reference"
+nav_order: 18
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_registry
+
+:-: ref path="server.src.pixelweaver.mcp_registry"

package/docs/server-src-pixelweaver-mcp_resources.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_resources
+description: "MCP resources for PixelWeaver."
+generated: true
+nav_group: "API Reference"
+nav_order: 19
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_resources
+
+:-: ref path="server.src.pixelweaver.mcp_resources"

package/docs/server-src-pixelweaver-mcp_server.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.mcp_server
+description: "MCP tool server for PixelWeaver."
+generated: true
+nav_group: "API Reference"
+nav_order: 20
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.mcp_server
+
+:-: ref path="server.src.pixelweaver.mcp_server"

package/docs/server-src-pixelweaver-protocol.md

@@ -0,0 +1,12 @@
+---
+title: server.src.pixelweaver.protocol
+description: "Pydantic models for the PixelWeaver WebSocket JSON protocol."
+generated: true
+nav_group: "API Reference"
+nav_order: 21
+---
+<!-- generated by selfdoc gen, do not edit -->
+
+# server.src.pixelweaver.protocol
+
+:-: ref path="server.src.pixelweaver.protocol"