pixelweaver 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (392) hide show
  1. package/.env.development +1 -0
  2. package/.github/workflows/ci.yml +22 -0
  3. package/.github/workflows/publish.yml +18 -0
  4. package/.prettierignore +5 -0
  5. package/.prettierrc +16 -0
  6. package/.python-version +1 -0
  7. package/.rlsbl/bases/.github/workflows/ci.yml +21 -0
  8. package/.rlsbl/bases/.github/workflows/publish.yml +18 -0
  9. package/.rlsbl/bases/.rlsbl/changes/unreleased.jsonl +0 -0
  10. package/.rlsbl/bases/.rlsbl/hooks/post-release.sh +8 -0
  11. package/.rlsbl/bases/.rlsbl/hooks/pre-checks.sh +5 -0
  12. package/.rlsbl/bases/.rlsbl/hooks/pre-release.sh +8 -0
  13. package/.rlsbl/bases/.rlsbl/lint/go.toml +17 -0
  14. package/.rlsbl/bases/.rlsbl/lint/npm.toml +19 -0
  15. package/.rlsbl/bases/.rlsbl/lint/python.toml +25 -0
  16. package/.rlsbl/bases/CHANGELOG.md +5 -0
  17. package/.rlsbl/bases/LICENSE +21 -0
  18. package/.rlsbl/changes/.validated +1 -0
  19. package/.rlsbl/changes/0.1.0.jsonl +85 -0
  20. package/.rlsbl/changes/0.1.0.md +13 -0
  21. package/.rlsbl/changes/unreleased.jsonl +0 -0
  22. package/.rlsbl/config.json +6 -0
  23. package/.rlsbl/hashes.json +14 -0
  24. package/.rlsbl/hooks/post-release.sh +8 -0
  25. package/.rlsbl/hooks/pre-checks.sh +5 -0
  26. package/.rlsbl/hooks/pre-release.sh +8 -0
  27. package/.rlsbl/lint/go.toml +17 -0
  28. package/.rlsbl/lint/npm.toml +19 -0
  29. package/.rlsbl/lint/python.toml +25 -0
  30. package/.rlsbl/releases/unreleased.toml +0 -0
  31. package/.rlsbl/releases/v0.1.0.toml +3 -0
  32. package/.rlsbl/version +1 -0
  33. package/.selfdoc/hashes/hashes.json +146 -0
  34. package/.strictcli/schema.json +227 -0
  35. package/CHANGELOG.md +17 -0
  36. package/CLAUDE.md +100 -0
  37. package/LICENSE +21 -0
  38. package/README.md +116 -0
  39. package/assets/icon.png +0 -0
  40. package/docs/_README.md +117 -0
  41. package/docs/cli-config.md +35 -0
  42. package/docs/cli-dev.md +21 -0
  43. package/docs/cli-diagnose.md +12 -0
  44. package/docs/cli-index.md +30 -0
  45. package/docs/cli-list.md +18 -0
  46. package/docs/cli-mcp.md +18 -0
  47. package/docs/cli-new.md +26 -0
  48. package/docs/cli-open.md +21 -0
  49. package/docs/cli-serve.md +21 -0
  50. package/docs/cli-stop.md +12 -0
  51. package/docs/gen-index.md +36 -0
  52. package/docs/index.md +13 -0
  53. package/docs/server-src-pixelweaver-__main__.md +12 -0
  54. package/docs/server-src-pixelweaver-autosave.md +12 -0
  55. package/docs/server-src-pixelweaver-bridge.md +12 -0
  56. package/docs/server-src-pixelweaver-cli.md +12 -0
  57. package/docs/server-src-pixelweaver-config.md +12 -0
  58. package/docs/server-src-pixelweaver-connections.md +12 -0
  59. package/docs/server-src-pixelweaver-main.md +12 -0
  60. package/docs/server-src-pixelweaver-mcp_bridge.md +12 -0
  61. package/docs/server-src-pixelweaver-mcp_drawing_tools.md +12 -0
  62. package/docs/server-src-pixelweaver-mcp_export_tools.md +12 -0
  63. package/docs/server-src-pixelweaver-mcp_frame_tools.md +12 -0
  64. package/docs/server-src-pixelweaver-mcp_history_tools.md +12 -0
  65. package/docs/server-src-pixelweaver-mcp_layer_tools.md +12 -0
  66. package/docs/server-src-pixelweaver-mcp_lock.md +12 -0
  67. package/docs/server-src-pixelweaver-mcp_project_tools.md +12 -0
  68. package/docs/server-src-pixelweaver-mcp_read_tools.md +12 -0
  69. package/docs/server-src-pixelweaver-mcp_registry.md +12 -0
  70. package/docs/server-src-pixelweaver-mcp_resources.md +12 -0
  71. package/docs/server-src-pixelweaver-mcp_server.md +12 -0
  72. package/docs/server-src-pixelweaver-protocol.md +12 -0
  73. package/docs/server-src-pixelweaver-state.md +12 -0
  74. package/docs/server-src-pixelweaver-storage.md +12 -0
  75. package/docs/server-src-pixelweaver-websocket.md +12 -0
  76. package/docs/server-src-pixelweaver.md +12 -0
  77. package/e2e/app-launch.test.ts +35 -0
  78. package/e2e/menus.test.ts +26 -0
  79. package/e2e/tools.test.ts +27 -0
  80. package/e2e/undo-redo.test.ts +11 -0
  81. package/eslint.config.js +62 -0
  82. package/index.html +13 -0
  83. package/package.json +48 -0
  84. package/playwright.config.ts +19 -0
  85. package/plugins/builtin/.gitkeep +0 -0
  86. package/plugins/builtin/advanced-fill-tool.ts +146 -0
  87. package/plugins/builtin/circle-tool.ts +186 -0
  88. package/plugins/builtin/diamond-tool.ts +182 -0
  89. package/plugins/builtin/dither-tool.ts +186 -0
  90. package/plugins/builtin/drawing-primitives-plugin.ts +362 -0
  91. package/plugins/builtin/drawing-utils.test.ts +495 -0
  92. package/plugins/builtin/drawing-utils.ts +431 -0
  93. package/plugins/builtin/effects/blur.ts +97 -0
  94. package/plugins/builtin/effects/color-effects.ts +278 -0
  95. package/plugins/builtin/effects/flip.ts +83 -0
  96. package/plugins/builtin/effects/glow.ts +118 -0
  97. package/plugins/builtin/effects/outline.ts +110 -0
  98. package/plugins/builtin/effects/rotate.ts +357 -0
  99. package/plugins/builtin/effects/scale.ts +258 -0
  100. package/plugins/builtin/effects/shadow.ts +111 -0
  101. package/plugins/builtin/effects/sharpen.ts +102 -0
  102. package/plugins/builtin/effects.test.ts +715 -0
  103. package/plugins/builtin/eraser-tool.ts +23 -0
  104. package/plugins/builtin/eyedropper-tool.ts +83 -0
  105. package/plugins/builtin/fill-tool.ts +93 -0
  106. package/plugins/builtin/gradient-tool.ts +204 -0
  107. package/plugins/builtin/gradient.test.ts +142 -0
  108. package/plugins/builtin/importers/aseprite-importer-plugin.ts +174 -0
  109. package/plugins/builtin/importers/aseprite-parser.ts +497 -0
  110. package/plugins/builtin/importers/piskel-importer-plugin.ts +222 -0
  111. package/plugins/builtin/importers/sky-spec-plugin.ts +409 -0
  112. package/plugins/builtin/line-tool.ts +267 -0
  113. package/plugins/builtin/make-stroke-tool.ts +271 -0
  114. package/plugins/builtin/noise-dither.test.ts +151 -0
  115. package/plugins/builtin/noise-tool.ts +131 -0
  116. package/plugins/builtin/pattern-stamp-tool.ts +162 -0
  117. package/plugins/builtin/pencil-tool.ts +25 -0
  118. package/plugins/builtin/rect-tool.ts +179 -0
  119. package/plugins/builtin/selection-tool.ts +388 -0
  120. package/plugins/builtin/selection.test.ts +195 -0
  121. package/plugins/builtin/tool-plugins.test.ts +529 -0
  122. package/public/favicon.svg +7 -0
  123. package/public/sw.js +91 -0
  124. package/pyproject.toml +49 -0
  125. package/scripts/eslint-wave-a-list.sh +24 -0
  126. package/scripts/eslint-wave-a-status.sh +25 -0
  127. package/scripts/fix-index-signature-access.py +127 -0
  128. package/scripts/fix-unchecked-index.py +128 -0
  129. package/scripts/fix-unchecked-vars.py +127 -0
  130. package/scripts/fix-wave-a-bangs.py +36 -0
  131. package/scripts/fix-wave-a-templates.py +108 -0
  132. package/scripts/fix-wave-b-void-expr.py +167 -0
  133. package/scripts/generate-command-params.py +540 -0
  134. package/scripts/migrate-single-frame-to-multi.py +171 -0
  135. package/scripts/smoke-test.sh +77 -0
  136. package/selfdoc.json +10 -0
  137. package/server/README.md +0 -0
  138. package/server/src/pixelweaver/__init__.py +1 -0
  139. package/server/src/pixelweaver/__main__.py +4 -0
  140. package/server/src/pixelweaver/autosave.py +114 -0
  141. package/server/src/pixelweaver/bridge.py +127 -0
  142. package/server/src/pixelweaver/cli.py +199 -0
  143. package/server/src/pixelweaver/config.py +24 -0
  144. package/server/src/pixelweaver/connections.py +54 -0
  145. package/server/src/pixelweaver/main.py +271 -0
  146. package/server/src/pixelweaver/mcp_bridge.py +189 -0
  147. package/server/src/pixelweaver/mcp_drawing_tools.py +178 -0
  148. package/server/src/pixelweaver/mcp_export_tools.py +291 -0
  149. package/server/src/pixelweaver/mcp_frame_tools.py +423 -0
  150. package/server/src/pixelweaver/mcp_history_tools.py +106 -0
  151. package/server/src/pixelweaver/mcp_layer_tools.py +64 -0
  152. package/server/src/pixelweaver/mcp_lock.py +37 -0
  153. package/server/src/pixelweaver/mcp_project_tools.py +302 -0
  154. package/server/src/pixelweaver/mcp_read_tools.py +163 -0
  155. package/server/src/pixelweaver/mcp_registry.py +247 -0
  156. package/server/src/pixelweaver/mcp_resources.py +312 -0
  157. package/server/src/pixelweaver/mcp_server.py +234 -0
  158. package/server/src/pixelweaver/protocol.py +219 -0
  159. package/server/src/pixelweaver/state.py +267 -0
  160. package/server/src/pixelweaver/storage.py +293 -0
  161. package/server/src/pixelweaver/websocket.py +282 -0
  162. package/server/tests/__init__.py +0 -0
  163. package/server/tests/conftest.py +17 -0
  164. package/server/tests/test_api.py +96 -0
  165. package/server/tests/test_bridge.py +161 -0
  166. package/server/tests/test_health.py +9 -0
  167. package/server/tests/test_integration.py +86 -0
  168. package/server/tests/test_mcp_bridge.py +293 -0
  169. package/server/tests/test_mcp_lock.py +34 -0
  170. package/server/tests/test_mcp_registry.py +679 -0
  171. package/server/tests/test_mcp_resources.py +648 -0
  172. package/server/tests/test_protocol.py +125 -0
  173. package/server/tests/test_state.py +87 -0
  174. package/server/tests/test_storage.py +306 -0
  175. package/server/tests/test_websocket.py +275 -0
  176. package/src/App.svelte +107 -0
  177. package/src/app.css +215 -0
  178. package/src/lib/animation/AnimationPreviewPanel.svelte +667 -0
  179. package/src/lib/animation/animation-commands.test.ts +228 -0
  180. package/src/lib/animation/animation-commands.ts +540 -0
  181. package/src/lib/animation/animation-preview-panel-plugin.ts +25 -0
  182. package/src/lib/animation/animation-preview.svelte.ts +151 -0
  183. package/src/lib/animation/clipboard.ts +134 -0
  184. package/src/lib/animation/frame-model.svelte.ts +437 -0
  185. package/src/lib/animation/frame-model.test.ts +314 -0
  186. package/src/lib/animation/frame-selection.svelte.ts +77 -0
  187. package/src/lib/animation/frame-tags.svelte.ts +238 -0
  188. package/src/lib/animation/frame-tags.test.ts +136 -0
  189. package/src/lib/animation/import.test.ts +141 -0
  190. package/src/lib/animation/import.ts +112 -0
  191. package/src/lib/animation/spritesheet-export.test.ts +239 -0
  192. package/src/lib/animation/spritesheet-export.ts +314 -0
  193. package/src/lib/canvas/CanvasViewport.svelte +216 -0
  194. package/src/lib/canvas/canvas-init-plugin.ts +178 -0
  195. package/src/lib/canvas/canvas-renderer.ts +408 -0
  196. package/src/lib/canvas/canvas-state.svelte.ts +232 -0
  197. package/src/lib/canvas/canvas-state.test.ts +139 -0
  198. package/src/lib/canvas/input-handler.ts +221 -0
  199. package/src/lib/canvas/input-plugin.ts +150 -0
  200. package/src/lib/canvas/onion-skin.ts +94 -0
  201. package/src/lib/canvas/pixel-buffer.test.ts +249 -0
  202. package/src/lib/canvas/pixel-buffer.ts +151 -0
  203. package/src/lib/canvas/render-state.svelte.ts +18 -0
  204. package/src/lib/canvas/shape-preview-state.svelte.ts +36 -0
  205. package/src/lib/canvas/tile-mode.test.ts +53 -0
  206. package/src/lib/canvas/tile-mode.ts +92 -0
  207. package/src/lib/canvas/viewport-utils.ts +24 -0
  208. package/src/lib/canvas/zoom-utils.ts +31 -0
  209. package/src/lib/color/.gitkeep +0 -0
  210. package/src/lib/color/color-commands.ts +87 -0
  211. package/src/lib/color/color-state.svelte.ts +98 -0
  212. package/src/lib/color/color-state.test.ts +91 -0
  213. package/src/lib/color/color-utils.test.ts +220 -0
  214. package/src/lib/color/color-utils.ts +243 -0
  215. package/src/lib/color/palette-state.svelte.ts +127 -0
  216. package/src/lib/color/palette-state.test.ts +154 -0
  217. package/src/lib/color/palette.ts +79 -0
  218. package/src/lib/core/bootstrap.ts +66 -0
  219. package/src/lib/core/command-params.generated.ts +1549 -0
  220. package/src/lib/core/command-params.ts +20 -0
  221. package/src/lib/core/command-runner.ts +79 -0
  222. package/src/lib/core/commands.ts +134 -0
  223. package/src/lib/core/dispatcher.test.ts +548 -0
  224. package/src/lib/core/dispatcher.ts +361 -0
  225. package/src/lib/core/index.test.ts +7 -0
  226. package/src/lib/core/notification-state.svelte.ts +119 -0
  227. package/src/lib/core/plugin-api.ts +210 -0
  228. package/src/lib/core/plugin-discovery.test.ts +53 -0
  229. package/src/lib/core/plugin-discovery.ts +65 -0
  230. package/src/lib/core/plugin-loader.test.ts +159 -0
  231. package/src/lib/core/plugin-loader.ts +240 -0
  232. package/src/lib/core/plugin-types.ts +286 -0
  233. package/src/lib/core/registries.svelte.ts +74 -0
  234. package/src/lib/core/tool-options-state.svelte.ts +61 -0
  235. package/src/lib/dock/DockLayout.svelte +375 -0
  236. package/src/lib/dock/TabAddMenu.svelte +90 -0
  237. package/src/lib/dock/dock-persistence.ts +46 -0
  238. package/src/lib/dock/dock-plugin.ts +49 -0
  239. package/src/lib/dock/dock-presets.ts +156 -0
  240. package/src/lib/dock/dock-state.svelte.ts +77 -0
  241. package/src/lib/dock/dock-types.ts +2 -0
  242. package/src/lib/dock/dockview-theme.css +226 -0
  243. package/src/lib/dock/dockview-theme.ts +17 -0
  244. package/src/lib/dock/header-action-renderer.ts +77 -0
  245. package/src/lib/edit/clipboard-state.ts +34 -0
  246. package/src/lib/export/download.ts +201 -0
  247. package/src/lib/export/png-metadata.ts +181 -0
  248. package/src/lib/history/ActionLogPanel.svelte +418 -0
  249. package/src/lib/history/action-log-panel-plugin.ts +24 -0
  250. package/src/lib/history/action-log.svelte.ts +172 -0
  251. package/src/lib/history/action-log.test.ts +168 -0
  252. package/src/lib/history/history-commands.ts +403 -0
  253. package/src/lib/history/macros.svelte.ts +320 -0
  254. package/src/lib/history/macros.test.ts +224 -0
  255. package/src/lib/history/replay-engine.test.ts +241 -0
  256. package/src/lib/history/replay-engine.ts +149 -0
  257. package/src/lib/history/spec-format.test.ts +250 -0
  258. package/src/lib/history/spec-format.ts +210 -0
  259. package/src/lib/iso/SeamCheckerPanel.svelte +251 -0
  260. package/src/lib/iso/iso-math.test.ts +77 -0
  261. package/src/lib/iso/iso-math.ts +77 -0
  262. package/src/lib/iso/seam-checker-panel-plugin.ts +25 -0
  263. package/src/lib/iso/seam-checker.test.ts +126 -0
  264. package/src/lib/iso/seam-checker.ts +93 -0
  265. package/src/lib/iso/tessellation.ts +67 -0
  266. package/src/lib/layers/compositor.test.ts +193 -0
  267. package/src/lib/layers/compositor.ts +175 -0
  268. package/src/lib/layers/layer-commands.test.ts +263 -0
  269. package/src/lib/layers/layer-commands.ts +429 -0
  270. package/src/lib/layers/layer-tree.svelte.ts +516 -0
  271. package/src/lib/layers/layer-tree.test.ts +383 -0
  272. package/src/lib/layers/layer-types.ts +56 -0
  273. package/src/lib/leveleditor/LevelEditorViewport.svelte +1808 -0
  274. package/src/lib/leveleditor/MapPropertiesPanel.svelte +266 -0
  275. package/src/lib/leveleditor/TilePickerPanel.svelte +324 -0
  276. package/src/lib/leveleditor/depth-sort.test.ts +70 -0
  277. package/src/lib/leveleditor/depth-sort.ts +39 -0
  278. package/src/lib/leveleditor/level-editor-commands.ts +353 -0
  279. package/src/lib/leveleditor/level-editor-viewport-plugin.ts +25 -0
  280. package/src/lib/leveleditor/map-properties-panel-plugin.ts +25 -0
  281. package/src/lib/leveleditor/map-state.svelte.ts +372 -0
  282. package/src/lib/leveleditor/map-state.test.ts +243 -0
  283. package/src/lib/leveleditor/tile-picker-panel-plugin.ts +25 -0
  284. package/src/lib/leveleditor/tile-source-registry.svelte.ts +91 -0
  285. package/src/lib/leveleditor/tiled-export.test.ts +144 -0
  286. package/src/lib/leveleditor/tiled-export.ts +374 -0
  287. package/src/lib/pywebview.d.ts +15 -0
  288. package/src/lib/recovery/.gitkeep +0 -0
  289. package/src/lib/recovery/idb-store.ts +118 -0
  290. package/src/lib/recovery/recovery-manager.test.ts +321 -0
  291. package/src/lib/recovery/recovery-manager.ts +115 -0
  292. package/src/lib/recovery/recovery-plugin.ts +55 -0
  293. package/src/lib/recovery/recovery-state.svelte.ts +21 -0
  294. package/src/lib/recovery/sw-plugin.ts +18 -0
  295. package/src/lib/recovery/sw-register.ts +17 -0
  296. package/src/lib/save/directory-format.ts +42 -0
  297. package/src/lib/save/project-snapshot.ts +139 -0
  298. package/src/lib/save/recent-projects.ts +56 -0
  299. package/src/lib/save/save-state.svelte.ts +35 -0
  300. package/src/lib/save/storage.ts +167 -0
  301. package/src/lib/save/zip-format.ts +45 -0
  302. package/src/lib/shortcuts/.gitkeep +0 -0
  303. package/src/lib/shortcuts/ShortcutEditorPanel.svelte +690 -0
  304. package/src/lib/shortcuts/default-bindings.ts +61 -0
  305. package/src/lib/shortcuts/shortcut-editor-panel-plugin.ts +25 -0
  306. package/src/lib/shortcuts/shortcut-init.ts +380 -0
  307. package/src/lib/shortcuts/shortcut-manager.test.ts +466 -0
  308. package/src/lib/shortcuts/shortcut-manager.ts +281 -0
  309. package/src/lib/shortcuts/shortcut-state.svelte.ts +78 -0
  310. package/src/lib/shortcuts/shortcuts-plugin.ts +17 -0
  311. package/src/lib/sync/patch-applicator.ts +300 -0
  312. package/src/lib/sync/patch-types.ts +65 -0
  313. package/src/lib/sync/project-manager.ts +108 -0
  314. package/src/lib/sync/sync-init.ts +152 -0
  315. package/src/lib/sync/sync-plugin.ts +19 -0
  316. package/src/lib/sync/sync-state.svelte.ts +56 -0
  317. package/src/lib/sync/ws-client.test.ts +604 -0
  318. package/src/lib/sync/ws-client.ts +574 -0
  319. package/src/lib/tools/.gitkeep +0 -0
  320. package/src/lib/ui/.gitkeep +0 -0
  321. package/src/lib/ui/AboutDialog.svelte +113 -0
  322. package/src/lib/ui/ColorPicker.svelte +761 -0
  323. package/src/lib/ui/ContextMenu.svelte +216 -0
  324. package/src/lib/ui/ExportDialog.svelte +747 -0
  325. package/src/lib/ui/FrameStrip.svelte +854 -0
  326. package/src/lib/ui/LayerPanel.svelte +810 -0
  327. package/src/lib/ui/MenuBar.svelte +590 -0
  328. package/src/lib/ui/NewProjectDialog.svelte +803 -0
  329. package/src/lib/ui/PluginManagerPanel.svelte +475 -0
  330. package/src/lib/ui/PromptDialog.svelte +252 -0
  331. package/src/lib/ui/RecoveryDialog.svelte +295 -0
  332. package/src/lib/ui/ResizeDialog.svelte +416 -0
  333. package/src/lib/ui/StatusBar.svelte +145 -0
  334. package/src/lib/ui/ToolbarPanel.svelte +488 -0
  335. package/src/lib/ui/animation-menu-commands.ts +194 -0
  336. package/src/lib/ui/command-palette/CommandPalette.svelte +232 -0
  337. package/src/lib/ui/command-palette/command-palette-plugin.ts +30 -0
  338. package/src/lib/ui/command-palette/command-palette-state.svelte.ts +190 -0
  339. package/src/lib/ui/command-palette/command-palette.test.ts +129 -0
  340. package/src/lib/ui/dialog-state.svelte.ts +70 -0
  341. package/src/lib/ui/edit-commands.ts +271 -0
  342. package/src/lib/ui/file-commands.ts +275 -0
  343. package/src/lib/ui/file-open.ts +99 -0
  344. package/src/lib/ui/help-commands.ts +93 -0
  345. package/src/lib/ui/image-commands.ts +181 -0
  346. package/src/lib/ui/layer-menu-commands.ts +420 -0
  347. package/src/lib/ui/menu-builder.ts +224 -0
  348. package/src/lib/ui/notifications/NotificationBanner.svelte +137 -0
  349. package/src/lib/ui/notifications/notification-plugin.ts +29 -0
  350. package/src/lib/ui/notifications/notification-state.svelte.ts +9 -0
  351. package/src/lib/ui/plugin-manager-panel-plugin.ts +26 -0
  352. package/src/lib/ui/plugin-state.svelte.ts +62 -0
  353. package/src/lib/ui/select-commands.ts +75 -0
  354. package/src/lib/ui/theme-plugin.ts +18 -0
  355. package/src/lib/ui/theme.svelte.ts +45 -0
  356. package/src/lib/ui/theme.test.ts +51 -0
  357. package/src/lib/ui/toolbar-config.ts +90 -0
  358. package/src/lib/ui/toolbar-plugin.ts +39 -0
  359. package/src/lib/ui/view-commands.ts +629 -0
  360. package/src/lib/variants/BisectionExportDialog.svelte +500 -0
  361. package/src/lib/variants/VariantPanel.svelte +822 -0
  362. package/src/lib/variants/bisection-export.test.ts +113 -0
  363. package/src/lib/variants/bisection-export.ts +148 -0
  364. package/src/lib/variants/palette-extraction.test.ts +111 -0
  365. package/src/lib/variants/palette-extraction.ts +84 -0
  366. package/src/lib/variants/palette-interpolation.test.ts +113 -0
  367. package/src/lib/variants/palette-interpolation.ts +87 -0
  368. package/src/lib/variants/palette-swap.test.ts +101 -0
  369. package/src/lib/variants/palette-swap.ts +114 -0
  370. package/src/lib/variants/variant-commands.ts +594 -0
  371. package/src/lib/variants/variant-panel-plugin.ts +27 -0
  372. package/src/lib/variants/variant-randomizer.ts +101 -0
  373. package/src/lib/variants/variant-state.svelte.ts +166 -0
  374. package/src/lib/variants/variant-state.test.ts +138 -0
  375. package/src/main.ts +14 -0
  376. package/src/vite-env.d.ts +3 -0
  377. package/svelte.config.js +2 -0
  378. package/todo/.done/audit-design-decisions.md +812 -0
  379. package/todo/.done/audit-implementation-plan.md +1235 -0
  380. package/todo/.done/happy-path-polish.md +177 -0
  381. package/todo/.done/pixelweaver-full-build.md +937 -0
  382. package/todo/.done/server-multi-frame-design.md +405 -0
  383. package/todo/.done/typed-dispatcher-design.md +435 -0
  384. package/todo/.done/unified-toolbar-and-action-system.md +323 -0
  385. package/todo/.obsolete/comprehensive-audit-obsolete-items.md +33 -0
  386. package/todo/.obsolete/tauri-desktop-bundle.md +424 -0
  387. package/todo/comprehensive-audit.md +1085 -0
  388. package/tsconfig.app.json +26 -0
  389. package/tsconfig.json +7 -0
  390. package/tsconfig.node.json +20 -0
  391. package/uv.lock +1167 -0
  392. package/vite.config.ts +32 -0
@@ -0,0 +1,500 @@
1
+ <script lang="ts">
2
+ /**
3
+ * BisectionExportDialog -- modal preview for variant atlas export.
4
+ *
5
+ * Shows a preview of the generated atlas (rows = variants, cols = frames)
6
+ * with a checkerboard transparency background. The user can choose a scale
7
+ * factor before confirming the export, which triggers PNG + JSON metadata
8
+ * downloads.
9
+ */
10
+
11
+ import { canvasState } from '../canvas/canvas-state.svelte.js';
12
+ import * as layerTree from '../layers/layer-tree.svelte.js';
13
+ import * as frameModel from '../animation/frame-model.svelte.js';
14
+ import * as variantState from './variant-state.svelte.js';
15
+ import { exportVariantAtlas } from './bisection-export.js';
16
+ import { notificationState } from '../core/notification-state.svelte.js';
17
+ import { downloadCompanionFiles } from '../export/download.js';
18
+ import type { Layer } from '../layers/layer-types.js';
19
+
20
+ /** Recursively find a layer's name by ID in the tree. */
21
+ function findGroupName(id: string, tree: Layer[]): string | null {
22
+ for (const layer of tree) {
23
+ if (layer.id === id) return layer.name;
24
+ if (layer.type === 'group' && layer.children) {
25
+ const found = findGroupName(id, layer.children);
26
+ if (found) return found;
27
+ }
28
+ }
29
+ return null;
30
+ }
31
+
32
+ // --- Props ---
33
+
34
+ interface Props {
35
+ open: boolean;
36
+ groupId: string | null;
37
+ onClose: () => void;
38
+ }
39
+
40
+ let { open, groupId, onClose }: Props = $props();
41
+
42
+ // --- Local state ---
43
+
44
+ let dialogEl: HTMLDialogElement | undefined = $state();
45
+ let previewCanvasEl: HTMLCanvasElement | undefined = $state();
46
+ let scale = $state(1);
47
+ let exporting = $state(false);
48
+ let errorMessage = $state('');
49
+
50
+ // Atlas metadata computed during preview generation, reused for export
51
+ let atlasWidth = $state(0);
52
+ let atlasHeight = $state(0);
53
+ let variantCount = $state(0);
54
+ let frameCount = $state(0);
55
+ let groupName = $state('');
56
+
57
+ const scaleOptions = [1, 2, 4];
58
+
59
+ // --- Preview generation ---
60
+
61
+ // Regenerate the atlas preview whenever the dialog opens or groupId changes
62
+ $effect(() => {
63
+ if (!open || !groupId || !previewCanvasEl) return;
64
+
65
+ const presets = variantState.getPresets();
66
+ const frames = frameModel.getFrames();
67
+ const layers = layerTree.getLayers();
68
+
69
+ if (presets.length === 0 || frames.length === 0) {
70
+ errorMessage = 'No variants or frames to preview.';
71
+ return;
72
+ }
73
+
74
+ try {
75
+ const atlas = exportVariantAtlas(
76
+ groupId,
77
+ layers,
78
+ frames,
79
+ presets,
80
+ canvasState.canvasWidth,
81
+ canvasState.canvasHeight,
82
+ );
83
+
84
+ atlasWidth = atlas.width;
85
+ atlasHeight = atlas.height;
86
+ variantCount = presets.length;
87
+ frameCount = frames.length;
88
+
89
+ // Resolve group name for the filename (recursive search)
90
+ groupName = findGroupName(groupId, layers) ?? 'variants';
91
+
92
+ // Fit preview within a max bounding box, preserving aspect ratio
93
+ const maxW = 480;
94
+ const maxH = 300;
95
+ const scaleX = maxW / atlas.width;
96
+ const scaleY = maxH / atlas.height;
97
+ const fitScale = Math.min(scaleX, scaleY, 1);
98
+ const displayW = Math.max(1, Math.round(atlas.width * fitScale));
99
+ const displayH = Math.max(1, Math.round(atlas.height * fitScale));
100
+
101
+ const canvas = previewCanvasEl;
102
+ canvas.width = displayW;
103
+ canvas.height = displayH;
104
+ const ctx = canvas.getContext('2d');
105
+ if (!ctx) throw new Error('Failed to get 2d context for preview canvas');
106
+ ctx.imageSmoothingEnabled = false;
107
+
108
+ const imageData = atlas.toImageData();
109
+ const tmpCanvas = new OffscreenCanvas(atlas.width, atlas.height);
110
+ const tmpCtx = tmpCanvas.getContext('2d');
111
+ if (!tmpCtx) throw new Error('Failed to get 2d context for tmp canvas');
112
+ tmpCtx.putImageData(imageData, 0, 0);
113
+
114
+ ctx.clearRect(0, 0, displayW, displayH);
115
+ ctx.drawImage(tmpCanvas, 0, 0, displayW, displayH);
116
+
117
+ errorMessage = '';
118
+ } catch (err) {
119
+ errorMessage = err instanceof Error ? err.message : 'Failed to generate atlas preview.';
120
+ }
121
+ });
122
+
123
+ // --- Export handler ---
124
+
125
+ async function handleExport() {
126
+ if (exporting || !groupId) return;
127
+ exporting = true;
128
+ errorMessage = '';
129
+
130
+ try {
131
+ const presets = variantState.getPresets();
132
+ const frames = frameModel.getFrames();
133
+ const layers = layerTree.getLayers();
134
+
135
+ if (presets.length === 0 || frames.length === 0) {
136
+ throw new Error('No variants or frames to export.');
137
+ }
138
+
139
+ // Regenerate atlas at the selected scale
140
+ const w = canvasState.canvasWidth;
141
+ const h = canvasState.canvasHeight;
142
+ const atlas = exportVariantAtlas(groupId, layers, frames, presets, w, h);
143
+
144
+ // Render atlas to an offscreen canvas with the chosen scale factor
145
+ const scaledW = atlas.width * scale;
146
+ const scaledH = atlas.height * scale;
147
+ const exportCanvas = new OffscreenCanvas(scaledW, scaledH);
148
+ const ctx = exportCanvas.getContext('2d');
149
+ if (!ctx) throw new Error('Failed to get 2d context for export canvas');
150
+ ctx.imageSmoothingEnabled = false;
151
+
152
+ const imageData = atlas.toImageData();
153
+ const tmpCanvas = new OffscreenCanvas(atlas.width, atlas.height);
154
+ const tmpCtx = tmpCanvas.getContext('2d');
155
+ if (!tmpCtx) throw new Error('Failed to get 2d context for tmp canvas');
156
+ tmpCtx.putImageData(imageData, 0, 0);
157
+ ctx.drawImage(tmpCanvas, 0, 0, scaledW, scaledH);
158
+
159
+ const blob = await exportCanvas.convertToBlob({ type: 'image/png' });
160
+
161
+ // Build companion metadata JSON
162
+ const metadata = {
163
+ format: 'pixelweaver-variant-atlas',
164
+ version: '1.0.0',
165
+ atlas: {
166
+ width: scaledW,
167
+ height: scaledH,
168
+ cellWidth: w * scale,
169
+ cellHeight: h * scale,
170
+ rows: presets.length,
171
+ columns: frames.length,
172
+ },
173
+ variants: presets.map((p, i) => ({
174
+ index: i,
175
+ name: p.name,
176
+ row: i,
177
+ })),
178
+ frames: frames.map((_f, i) => ({
179
+ index: i,
180
+ column: i,
181
+ durationMs: frameModel.getFrameDuration(i),
182
+ })),
183
+ };
184
+ const jsonBlob = new Blob(
185
+ [JSON.stringify(metadata, null, 2)],
186
+ { type: 'application/json' },
187
+ );
188
+
189
+ const saved = await downloadCompanionFiles([
190
+ { blob, filename: `${groupName}-variants.png`, filterName: 'PNG Image', filterExtensions: ['png'] },
191
+ { blob: jsonBlob, filename: `${groupName}-variants.json`, filterName: 'JSON File', filterExtensions: ['json'] },
192
+ ]);
193
+ if (!saved) return; // user cancelled native dialog
194
+
195
+ notify(`Exported ${String(presets.length)} variants to PNG.`, 'success');
196
+ onClose();
197
+ } catch (err) {
198
+ errorMessage = err instanceof Error ? err.message : 'Export failed.';
199
+ } finally {
200
+ exporting = false;
201
+ }
202
+ }
203
+
204
+ // --- Utilities ---
205
+
206
+ function notify(message: string, type: 'info' | 'warning' | 'success') {
207
+ notificationState.push({
208
+ id: `bisection-export-${crypto.randomUUID()}`,
209
+ message,
210
+ type,
211
+ autoDismissMs: 4000,
212
+ });
213
+ }
214
+
215
+ // Reset state when dialog opens
216
+ $effect(() => {
217
+ if (open) {
218
+ scale = 1;
219
+ exporting = false;
220
+ errorMessage = '';
221
+ atlasWidth = 0;
222
+ atlasHeight = 0;
223
+ variantCount = 0;
224
+ frameCount = 0;
225
+ }
226
+ });
227
+
228
+ // Sync native <dialog> open state with the `open` prop
229
+ $effect(() => {
230
+ if (!dialogEl) return;
231
+ if (open && !dialogEl.open) {
232
+ dialogEl.showModal();
233
+ } else if (!open && dialogEl.open) {
234
+ dialogEl.close();
235
+ }
236
+ });
237
+
238
+ // Close on backdrop click
239
+ function handleDialogClick(e: MouseEvent) {
240
+ if (e.target === dialogEl) {
241
+ onClose();
242
+ }
243
+ }
244
+ </script>
245
+
246
+ <dialog
247
+ bind:this={dialogEl}
248
+ class="pw-dialog"
249
+ onclick={handleDialogClick}
250
+ onclose={onClose}
251
+ >
252
+ {#if open}
253
+ <div class="modal">
254
+ <h2 class="modal-title">Export Variant Atlas</h2>
255
+
256
+ <!-- Preview canvas -->
257
+ <div class="preview-section">
258
+ <canvas
259
+ bind:this={previewCanvasEl}
260
+ class="preview-canvas"
261
+ ></canvas>
262
+ {#if atlasWidth > 0}
263
+ <div class="preview-info">
264
+ <span class="preview-dimensions">{atlasWidth} x {atlasHeight} px</span>
265
+ <span class="preview-meta">
266
+ {variantCount} variant{variantCount === 1 ? '' : 's'},
267
+ {frameCount} frame{frameCount === 1 ? '' : 's'}
268
+ </span>
269
+ </div>
270
+ {/if}
271
+ </div>
272
+
273
+ <!-- Scale selector -->
274
+ <div class="form-row">
275
+ <label class="form-label">Scale</label>
276
+ <div class="scale-group">
277
+ {#each scaleOptions as s (s)}
278
+ <button
279
+ class="scale-btn"
280
+ class:scale-btn--active={scale === s}
281
+ onclick={() => scale = s}
282
+ >{s}x</button>
283
+ {/each}
284
+ </div>
285
+ {#if scale > 1 && atlasWidth > 0}
286
+ <span class="scale-hint">{atlasWidth * scale} x {atlasHeight * scale} px</span>
287
+ {/if}
288
+ </div>
289
+
290
+ <!-- Error message -->
291
+ {#if errorMessage}
292
+ <div class="error-msg">{errorMessage}</div>
293
+ {/if}
294
+
295
+ <!-- Actions -->
296
+ <div class="modal-actions">
297
+ <button class="btn btn--cancel" onclick={onClose}>Cancel</button>
298
+ <button
299
+ class="btn btn--primary"
300
+ onclick={handleExport}
301
+ disabled={exporting || atlasWidth === 0}
302
+ >
303
+ {exporting ? 'Exporting...' : 'Export'}
304
+ </button>
305
+ </div>
306
+ </div>
307
+ {/if}
308
+ </dialog>
309
+
310
+ <style>
311
+ /* Reuse the same dialog/modal pattern from ExportDialog */
312
+ .pw-dialog {
313
+ margin: 0;
314
+ padding: 0;
315
+ border: none;
316
+ background: transparent;
317
+ max-width: none;
318
+ max-height: none;
319
+ width: 100vw;
320
+ height: 100vh;
321
+ color: inherit;
322
+ }
323
+
324
+ .pw-dialog[open] {
325
+ display: flex;
326
+ align-items: center;
327
+ justify-content: center;
328
+ }
329
+
330
+ .pw-dialog::backdrop {
331
+ background: rgba(0, 0, 0, 0.5);
332
+ }
333
+
334
+ .modal {
335
+ background: var(--bg-panel);
336
+ border: 1px solid var(--border);
337
+ border-radius: 6px;
338
+ box-shadow: var(--shadow-md);
339
+ width: 540px;
340
+ max-width: 90vw;
341
+ padding: 24px;
342
+ color: var(--text-primary);
343
+ }
344
+
345
+ .modal-title {
346
+ font-size: 18px;
347
+ font-weight: 600;
348
+ margin-bottom: 20px;
349
+ color: var(--text-primary);
350
+ }
351
+
352
+ /* Preview section */
353
+ .preview-section {
354
+ display: flex;
355
+ flex-direction: column;
356
+ align-items: center;
357
+ gap: 6px;
358
+ margin-bottom: 14px;
359
+ padding: 12px;
360
+ background: var(--bg-toolbar);
361
+ border: 1px solid var(--border);
362
+ border-radius: var(--radius-md);
363
+ }
364
+
365
+ .preview-canvas {
366
+ /* Checkerboard background to show transparency */
367
+ background-image:
368
+ linear-gradient(45deg, var(--bg-primary) 25%, transparent 25%),
369
+ linear-gradient(-45deg, var(--bg-primary) 25%, transparent 25%),
370
+ linear-gradient(45deg, transparent 75%, var(--bg-primary) 75%),
371
+ linear-gradient(-45deg, transparent 75%, var(--bg-primary) 75%);
372
+ background-size: 8px 8px;
373
+ background-position: 0 0, 0 4px, 4px -4px, -4px 0px;
374
+ image-rendering: pixelated;
375
+ }
376
+
377
+ .preview-info {
378
+ display: flex;
379
+ flex-direction: column;
380
+ align-items: center;
381
+ gap: 2px;
382
+ }
383
+
384
+ .preview-dimensions {
385
+ font-size: var(--text-base);
386
+ color: var(--text-muted);
387
+ }
388
+
389
+ .preview-meta {
390
+ font-size: var(--text-sm, 11px);
391
+ color: var(--text-muted);
392
+ }
393
+
394
+ /* Form layout */
395
+ .form-row {
396
+ display: flex;
397
+ align-items: center;
398
+ gap: 8px;
399
+ margin-bottom: 14px;
400
+ }
401
+
402
+ .form-label {
403
+ width: 80px;
404
+ flex-shrink: 0;
405
+ font-size: var(--text-lg);
406
+ color: var(--text-secondary);
407
+ }
408
+
409
+ /* Scale buttons */
410
+ .scale-group {
411
+ display: flex;
412
+ gap: 6px;
413
+ }
414
+
415
+ .scale-btn {
416
+ background: var(--bg-toolbar);
417
+ border: 1px solid var(--border);
418
+ border-radius: var(--radius-md);
419
+ color: var(--text-secondary);
420
+ font-size: var(--text-base);
421
+ padding: 4px 12px;
422
+ cursor: pointer;
423
+ transition: background var(--transition-fast), border-color var(--transition-fast);
424
+ }
425
+
426
+ .scale-btn:hover {
427
+ background: var(--bg-primary);
428
+ color: var(--text-primary);
429
+ border-color: var(--accent);
430
+ }
431
+
432
+ .scale-btn--active {
433
+ background: var(--accent);
434
+ color: #ffffff;
435
+ border-color: var(--accent);
436
+ }
437
+
438
+ .scale-btn--active:hover {
439
+ background: var(--accent-hover);
440
+ }
441
+
442
+ .scale-hint {
443
+ font-size: var(--text-base);
444
+ color: var(--text-muted);
445
+ margin-left: 4px;
446
+ }
447
+
448
+ /* Error message */
449
+ .error-msg {
450
+ background: rgba(255, 74, 106, 0.1);
451
+ border: 1px solid var(--error);
452
+ border-radius: var(--radius-md);
453
+ color: var(--error);
454
+ font-size: var(--text-base);
455
+ padding: 8px 10px;
456
+ margin-bottom: 12px;
457
+ }
458
+
459
+ /* Action buttons */
460
+ .modal-actions {
461
+ display: flex;
462
+ justify-content: flex-end;
463
+ gap: 8px;
464
+ margin-top: 20px;
465
+ }
466
+
467
+ .btn {
468
+ border: none;
469
+ border-radius: var(--radius-md);
470
+ font-size: var(--text-lg);
471
+ padding: 8px 20px;
472
+ cursor: pointer;
473
+ font-weight: 500;
474
+ }
475
+
476
+ .btn:disabled {
477
+ opacity: 0.5;
478
+ cursor: default;
479
+ }
480
+
481
+ .btn--cancel {
482
+ background: var(--bg-toolbar);
483
+ color: var(--text-secondary);
484
+ border: 1px solid var(--border);
485
+ }
486
+
487
+ .btn--cancel:hover {
488
+ background: var(--bg-primary);
489
+ color: var(--text-primary);
490
+ }
491
+
492
+ .btn--primary {
493
+ background: var(--accent);
494
+ color: #ffffff;
495
+ }
496
+
497
+ .btn--primary:hover:not(:disabled) {
498
+ background: var(--accent-hover);
499
+ }
500
+ </style>