dkdc-draw 0.1.1__tar.gz

dkdc_draw-0.1.1/Cargo.toml

@@ -0,0 +1,20 @@
+[workspace]
+resolver = "2"
+members = [
+    "crates/draw-core",
+    "crates/draw-app",
+    "crates/draw-webapp",
+    "crates/draw-cli",
+    "crates/draw-wasm",
+]
+default-members = [
+    "crates/draw-core",
+    "crates/draw-cli",
+    "crates/draw-wasm",
+]
+exclude = ["crates/draw-py"]
+
+[profile.release]
+lto = true
+strip = true
+codegen-units = 1

dkdc_draw-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dkdc.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dkdc_draw-0.1.1/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: dkdc-draw
+Version: 0.1.1
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Multimedia :: Graphics
+License-File: LICENSE
+Summary: Local-first drawing tool
+Keywords: graphics,drawing,canvas,sketch
+Home-Page: https://github.com/dkdc-io/draw
+Author-email: Cody <cody@dkdc.io>
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/dkdc-io/draw
+Project-URL: Repository, https://github.com/dkdc-io/draw
+
+# draw
+
+Local-first, sketch-style drawing tool. Excalidraw-inspired, built on Rust with a vanilla JS frontend.
+
+Single binary. No cloud. Your drawings live in `~/.config/draw/drawings/`.
+
+## Features
+
+- **9 tools**: Select, Rectangle, Ellipse, Diamond, Line, Arrow, Pen (freedraw), Text, Eraser
+- **Sketch-style fills**: hachure (diagonal lines), cross-hatch, solid, none
+- **Full interactions**: drag, resize, multi-select, rubber band, pan (scroll/space+drag), zoom (ctrl+scroll)
+- **Undo/redo**: all operations, including batched multi-element changes
+- **Copy/paste/duplicate** with proper ID remapping
+- **Z-ordering**: bring to front/back/forward/backward
+- **Styles**: stroke color/width/dash, fill color/pattern/density, opacity, font
+- **Export**: SVG and PNG
+- **Document management**: auto-save, dirty indicator, rename, list
+- **Desktop app**: native window via webview (same UI, no browser needed)
+- **Python bindings**: `import dkdc_draw`
+- **Keyboard-driven**: full shortcut set, `?` for help overlay
+
+## Install
+
+### From source (Rust)
+
+```bash
+cargo install dkdc-draw --features webapp
+```
+
+### From source (Python)
+
+```bash
+uv tool install dkdc-draw
+```
+
+### Development
+
+```bash
+bin/setup    # install dependencies
+bin/install  # build and install CLI
+```
+
+## Usage
+
+```bash
+draw --webapp       # launch web UI
+draw --app          # launch desktop app
+draw new [name]     # create new drawing
+draw open <file>    # open .draw.json file
+draw list           # list saved drawings
+draw export-svg <file> [-o output.svg]
+draw export-png <file> [-o output.png] [--scale 2.0]
+```
+
+### Python
+
+```python
+import dkdc_draw
+
+doc = dkdc_draw.new_document("sketch")
+dkdc_draw.save_document(doc, "sketch.draw.json")
+svg = dkdc_draw.export_svg(doc)
+```
+
+### Keyboard shortcuts
+
+| Key | Action |
+|-----|--------|
+| V | Select |
+| R | Rectangle |
+| O | Ellipse |
+| D | Diamond |
+| L | Line |
+| A | Arrow |
+| P | Pen (freedraw) |
+| T | Text |
+| E | Eraser |
+| G | Toggle grid snap |
+| ? | Help overlay |
+| Ctrl+Z | Undo |
+| Ctrl+Shift+Z | Redo |
+| Ctrl+S | Save |
+| Ctrl+A | Select all |
+| Ctrl+D | Duplicate |
+| Delete | Delete selected |
+| ] / [ | Bring to front / Send to back |
+
+## Architecture
+
+```
+crates/
+  draw-core/     Document model, serialization, SVG/PNG export, tiny-skia renderer
+  draw-cli/      CLI binary (clap)
+  draw-webapp/   Axum web server (port 1213) + embedded vanilla JS frontend
+  draw-app/      Desktop app (wry webview)
+  draw-wasm/     WASM bindings for the renderer
+  draw-py/       PyO3 Python bindings
+```
+
+## Development
+
+```bash
+bin/build    # build all (Rust + Python)
+bin/check    # run all checks (format, lint, test)
+bin/format   # format all code
+bin/test     # run all tests
+```
+
+## License
+
+MIT
+

dkdc_draw-0.1.1/README.md

@@ -0,0 +1,111 @@
+# draw
+
+Local-first, sketch-style drawing tool. Excalidraw-inspired, built on Rust with a vanilla JS frontend.
+
+Single binary. No cloud. Your drawings live in `~/.config/draw/drawings/`.
+
+## Features
+
+- **9 tools**: Select, Rectangle, Ellipse, Diamond, Line, Arrow, Pen (freedraw), Text, Eraser
+- **Sketch-style fills**: hachure (diagonal lines), cross-hatch, solid, none
+- **Full interactions**: drag, resize, multi-select, rubber band, pan (scroll/space+drag), zoom (ctrl+scroll)
+- **Undo/redo**: all operations, including batched multi-element changes
+- **Copy/paste/duplicate** with proper ID remapping
+- **Z-ordering**: bring to front/back/forward/backward
+- **Styles**: stroke color/width/dash, fill color/pattern/density, opacity, font
+- **Export**: SVG and PNG
+- **Document management**: auto-save, dirty indicator, rename, list
+- **Desktop app**: native window via webview (same UI, no browser needed)
+- **Python bindings**: `import dkdc_draw`
+- **Keyboard-driven**: full shortcut set, `?` for help overlay
+
+## Install
+
+### From source (Rust)
+
+```bash
+cargo install dkdc-draw --features webapp
+```
+
+### From source (Python)
+
+```bash
+uv tool install dkdc-draw
+```
+
+### Development
+
+```bash
+bin/setup    # install dependencies
+bin/install  # build and install CLI
+```
+
+## Usage
+
+```bash
+draw --webapp       # launch web UI
+draw --app          # launch desktop app
+draw new [name]     # create new drawing
+draw open <file>    # open .draw.json file
+draw list           # list saved drawings
+draw export-svg <file> [-o output.svg]
+draw export-png <file> [-o output.png] [--scale 2.0]
+```
+
+### Python
+
+```python
+import dkdc_draw
+
+doc = dkdc_draw.new_document("sketch")
+dkdc_draw.save_document(doc, "sketch.draw.json")
+svg = dkdc_draw.export_svg(doc)
+```
+
+### Keyboard shortcuts
+
+| Key | Action |
+|-----|--------|
+| V | Select |
+| R | Rectangle |
+| O | Ellipse |
+| D | Diamond |
+| L | Line |
+| A | Arrow |
+| P | Pen (freedraw) |
+| T | Text |
+| E | Eraser |
+| G | Toggle grid snap |
+| ? | Help overlay |
+| Ctrl+Z | Undo |
+| Ctrl+Shift+Z | Redo |
+| Ctrl+S | Save |
+| Ctrl+A | Select all |
+| Ctrl+D | Duplicate |
+| Delete | Delete selected |
+| ] / [ | Bring to front / Send to back |
+
+## Architecture
+
+```
+crates/
+  draw-core/     Document model, serialization, SVG/PNG export, tiny-skia renderer
+  draw-cli/      CLI binary (clap)
+  draw-webapp/   Axum web server (port 1213) + embedded vanilla JS frontend
+  draw-app/      Desktop app (wry webview)
+  draw-wasm/     WASM bindings for the renderer
+  draw-py/       PyO3 Python bindings
+```
+
+## Development
+
+```bash
+bin/build    # build all (Rust + Python)
+bin/check    # run all checks (format, lint, test)
+bin/format   # format all code
+bin/test     # run all tests
+```
+
+## License
+
+MIT

dkdc_draw-0.1.1/crates/draw-cli/Cargo.toml

@@ -0,0 +1,31 @@
+[package]
+name = "dkdc-draw"
+version = "0.1.1"
+edition = "2024"
+authors = ["Cody <cody@dkdc.io>"]
+description = "Local-first drawing tool"
+repository = "https://github.com/dkdc-io/draw"
+homepage = "https://github.com/dkdc-io/draw"
+license = "MIT"
+readme = "README.md"
+keywords = ["graphics", "drawing", "cli", "sketch"]
+categories = ["graphics", "command-line-utilities"]
+
+[lib]
+name = "draw"
+path = "src/lib.rs"
+
+[[bin]]
+name = "draw"
+path = "src/main.rs"
+
+[features]
+app = ["dep:dkdc-draw-app"]
+webapp = ["dep:dkdc-draw-webapp"]
+
+[dependencies]
+anyhow = "1"
+dkdc-draw-core = { version = "0.1.1", path = "../draw-core" }
+dkdc-draw-app = { version = "0.1.1", path = "../draw-app", optional = true }
+dkdc-draw-webapp = { version = "0.1.1", path = "../draw-webapp", optional = true }
+clap = { version = "4.5", features = ["derive"] }

dkdc_draw-0.1.1/crates/draw-cli/README.md

@@ -0,0 +1,111 @@
+# draw
+
+Local-first, sketch-style drawing tool. Excalidraw-inspired, built on Rust with a vanilla JS frontend.
+
+Single binary. No cloud. Your drawings live in `~/.config/draw/drawings/`.
+
+## Features
+
+- **9 tools**: Select, Rectangle, Ellipse, Diamond, Line, Arrow, Pen (freedraw), Text, Eraser
+- **Sketch-style fills**: hachure (diagonal lines), cross-hatch, solid, none
+- **Full interactions**: drag, resize, multi-select, rubber band, pan (scroll/space+drag), zoom (ctrl+scroll)
+- **Undo/redo**: all operations, including batched multi-element changes
+- **Copy/paste/duplicate** with proper ID remapping
+- **Z-ordering**: bring to front/back/forward/backward
+- **Styles**: stroke color/width/dash, fill color/pattern/density, opacity, font
+- **Export**: SVG and PNG
+- **Document management**: auto-save, dirty indicator, rename, list
+- **Desktop app**: native window via webview (same UI, no browser needed)
+- **Python bindings**: `import dkdc_draw`
+- **Keyboard-driven**: full shortcut set, `?` for help overlay
+
+## Install
+
+### From source (Rust)
+
+```bash
+cargo install dkdc-draw --features webapp
+```
+
+### From source (Python)
+
+```bash
+uv tool install dkdc-draw
+```
+
+### Development
+
+```bash
+bin/setup    # install dependencies
+bin/install  # build and install CLI
+```
+
+## Usage
+
+```bash
+draw --webapp       # launch web UI
+draw --app          # launch desktop app
+draw new [name]     # create new drawing
+draw open <file>    # open .draw.json file
+draw list           # list saved drawings
+draw export-svg <file> [-o output.svg]
+draw export-png <file> [-o output.png] [--scale 2.0]
+```
+
+### Python
+
+```python
+import dkdc_draw
+
+doc = dkdc_draw.new_document("sketch")
+dkdc_draw.save_document(doc, "sketch.draw.json")
+svg = dkdc_draw.export_svg(doc)
+```
+
+### Keyboard shortcuts
+
+| Key | Action |
+|-----|--------|
+| V | Select |
+| R | Rectangle |
+| O | Ellipse |
+| D | Diamond |
+| L | Line |
+| A | Arrow |
+| P | Pen (freedraw) |
+| T | Text |
+| E | Eraser |
+| G | Toggle grid snap |
+| ? | Help overlay |
+| Ctrl+Z | Undo |
+| Ctrl+Shift+Z | Redo |
+| Ctrl+S | Save |
+| Ctrl+A | Select all |
+| Ctrl+D | Duplicate |
+| Delete | Delete selected |
+| ] / [ | Bring to front / Send to back |
+
+## Architecture
+
+```
+crates/
+  draw-core/     Document model, serialization, SVG/PNG export, tiny-skia renderer
+  draw-cli/      CLI binary (clap)
+  draw-webapp/   Axum web server (port 1213) + embedded vanilla JS frontend
+  draw-app/      Desktop app (wry webview)
+  draw-wasm/     WASM bindings for the renderer
+  draw-py/       PyO3 Python bindings
+```
+
+## Development
+
+```bash
+bin/build    # build all (Rust + Python)
+bin/check    # run all checks (format, lint, test)
+bin/format   # format all code
+bin/test     # run all tests
+```
+
+## License
+
+MIT

dkdc_draw-0.1.1/crates/draw-cli/src/cli.rs

@@ -0,0 +1,147 @@
+use anyhow::Result;
+use clap::Parser;
+use std::path::PathBuf;
+
+use draw_core::document::Document;
+
+#[derive(Parser, Debug)]
+#[command(name = "draw")]
+#[command(about = "Local-first drawing tool")]
+#[command(version)]
+pub struct Args {
+    /// Open the desktop app
+    #[cfg(feature = "app")]
+    #[arg(short = 'a', long)]
+    pub app: bool,
+
+    /// Open the webapp
+    #[cfg(feature = "webapp")]
+    #[arg(short = 'w', long)]
+    pub webapp: bool,
+
+    #[command(subcommand)]
+    pub command: Option<Command>,
+}
+
+#[derive(clap::Subcommand, Debug)]
+pub enum Command {
+    /// Create a new drawing
+    New {
+        /// Drawing name
+        #[arg(default_value = "untitled")]
+        name: String,
+    },
+    /// Open an existing drawing
+    Open {
+        /// Path to .draw.json file
+        file: PathBuf,
+    },
+    /// List saved drawings
+    List,
+    /// Export drawing to SVG
+    ExportSvg {
+        /// Path to .draw.json file
+        file: PathBuf,
+        /// Output SVG path (defaults to same name with .svg extension)
+        #[arg(short, long)]
+        output: Option<PathBuf>,
+    },
+    /// Export drawing to PNG
+    ExportPng {
+        /// Path to .draw.json file
+        file: PathBuf,
+        /// Output PNG path (defaults to same name with .png extension)
+        #[arg(short, long)]
+        output: Option<PathBuf>,
+        /// Scale factor (default: 2x for retina)
+        #[arg(short, long, default_value_t = 2.0)]
+        scale: f32,
+    },
+}
+
+pub fn run_cli(argv: impl IntoIterator<Item = impl Into<String>>) -> Result<()> {
+    let argv: Vec<String> = argv.into_iter().map(Into::into).collect();
+
+    // No args = help
+    if argv.len() <= 1 {
+        Args::parse_from(["draw", "--help"]);
+    }
+
+    let args = Args::parse_from(&argv);
+
+    #[cfg(feature = "app")]
+    if args.app {
+        return draw_app::run_app(None);
+    }
+
+    #[cfg(feature = "webapp")]
+    if args.webapp {
+        return draw_webapp::run_webapp(None);
+    }
+
+    match args.command {
+        Some(Command::New { name }) => {
+            let doc = Document::new(name);
+            let path = draw_core::storage::save_to_storage(&doc)?;
+            println!("Created: {} ({})", doc.name, path.display());
+
+            #[cfg(feature = "webapp")]
+            return draw_webapp::run_webapp(Some(doc.id));
+
+            #[cfg(not(feature = "webapp"))]
+            {
+                println!("Run with --webapp to open in browser");
+                Ok(())
+            }
+        }
+        Some(Command::Open { file }) => {
+            let doc = draw_core::storage::load(&file)?;
+            println!("Loaded: {} ({} elements)", doc.name, doc.elements.len());
+
+            #[cfg(feature = "webapp")]
+            return draw_webapp::run_webapp(Some(doc.id));
+
+            #[cfg(not(feature = "webapp"))]
+            {
+                println!("Run with --webapp to open in browser");
+                Ok(())
+            }
+        }
+        Some(Command::List) => {
+            let drawings = draw_core::storage::list_drawings()?;
+            if drawings.is_empty() {
+                println!("No saved drawings.");
+            } else {
+                for (name, path) in drawings {
+                    println!("  {} ({})", name, path.display());
+                }
+            }
+            Ok(())
+        }
+        Some(Command::ExportSvg { file, output }) => {
+            let doc = draw_core::storage::load(&file)?;
+            let svg = draw_core::export_svg(&doc);
+            let out_path = output.unwrap_or_else(|| file.with_extension("svg"));
+            std::fs::write(&out_path, &svg)?;
+            println!("Exported SVG to {}", out_path.display());
+            Ok(())
+        }
+        Some(Command::ExportPng {
+            file,
+            output,
+            scale,
+        }) => {
+            let doc = draw_core::storage::load(&file)?;
+            let png = draw_core::export_png_with_scale(&doc, scale)?;
+            let out_path = output.unwrap_or_else(|| file.with_extension("png"));
+            std::fs::write(&out_path, &png)?;
+            println!("Exported PNG to {}", out_path.display());
+            Ok(())
+        }
+        None => {
+            // No subcommand but also no flags = help
+            Args::parse_from(["draw", "--help"]);
+            unreachable!()
+        }
+    }
+}

dkdc_draw-0.1.1/crates/draw-cli/src/lib.rs

@@ -0,0 +1,16 @@
+pub mod cli;
+
+pub use cli::run_cli;
+pub use draw_core::{
+    document::Document,
+    element::{Element, FreeDrawElement, LineElement, ShapeElement, TextElement},
+    export_png, export_png_with_scale, export_svg,
+    point::{Bounds, Point, ViewState},
+    render::{HandlePosition, RenderConfig, Renderer},
+    storage,
+    style::{
+        Arrowhead, DEFAULT_FILL_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_FONT_SIZE,
+        DEFAULT_HACHURE_ANGLE, DEFAULT_HACHURE_GAP, DEFAULT_STROKE_COLOR, DEFAULT_STROKE_WIDTH,
+        FillStyle, FillType, FontStyle, StrokeStyle, TextAlign,
+    },
+};

dkdc_draw-0.1.1/crates/draw-cli/src/main.rs

@@ -0,0 +1,3 @@
+fn main() -> anyhow::Result<()> {
+    draw::run_cli(std::env::args())
+}

dkdc_draw-0.1.1/crates/draw-core/Cargo.toml

@@ -0,0 +1,25 @@
+[package]
+name = "dkdc-draw-core"
+version = "0.1.1"
+edition = "2024"
+authors = ["Cody <cody@dkdc.io>"]
+description = "Core library for draw"
+repository = "https://github.com/dkdc-io/draw"
+license = "MIT"
+
+[lib]
+name = "draw_core"
+path = "src/lib.rs"
+
+[dependencies]
+anyhow = "1"
+chrono = { version = "0.4", features = ["serde"] }
+dirs = "6"
+resvg = "0.47"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+tiny-skia = "0.12"
+uuid = { version = "1", features = ["v4"] }
+
+[dev-dependencies]
+tempfile = "3"