predraw 0.1.1__tar.gz

predraw-0.1.1/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./scripts/check-prs.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

predraw-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+    - run: uv python install ${{ matrix.python-version }}
+    - run: uv sync
+    - run: uv run python -c "import predraw"

predraw-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,16 @@
+name: Publish
+on:
+  release:
+    types: [published]
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+    - run: uv build
+    - uses: pypa/gh-action-pypi-publish@release/v1

predraw-0.1.1/.gitignore

@@ -0,0 +1,24 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Added by rlsbl
+node_modules/
+*.pyc
+*.log
+.DS_Store
+coverage/
+*.egg-info/
+.rlsbl-notes-*.tmp
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only

predraw-0.1.1/.python-version

@@ -0,0 +1 @@
+3.13

predraw-0.1.1/.rlsbl/hashes.json

@@ -0,0 +1,15 @@
+{
+  ".github/workflows/ci.yml": "1e689a1086bc3f1fb1b493515bfa1b7135ca920f8df79c9047f190c0dd63e865",
+  ".github/workflows/publish.yml": "361e7d328a7e9aeb8f4ce94cd4fd3b76a1495740b1f7623ff92643319402403b",
+  "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
+  "LICENSE": "68116658f2927be53e8d038aa46a6a579974633b9e470207fa18ca3e83531974",
+  "CLAUDE.md": "641d50a31d6b7cd75f0796e3e8f85456c0c40c761f119fc633a7a8e8e535f4e5",
+  "scripts/check-prs.sh": "a438f046ac169256b859873e6f12b66bf629e12fa4bc1f766ed8484af983383c",
+  "scripts/record-gif.sh": "c1ab1f4d168ef1572579d857c610e2648b5f2a8e193ece99284626eb16f32c9b",
+  "scripts/pre-release.sh": "1b13062dda97df66792df382312263d704a6cc706d2dd3da921f4c470488276d",
+  "scripts/post-release.sh": "b455f8511e0b2655509ecf5dcb0ab7da5bb7c961f47910ff8e00cab5bd51f833",
+  "scripts/pre-push-hook.sh": "0dd1c23af794cc5e9fb6a3082c7fe821d40683c49ed14bbf81f2f98afcb91fee",
+  ".claude/settings.json": "99ee3041446e119611136c7c0f1955c1eef7e12ff21350e3da3380351dc25ef4",
+  ".rlsbl/hooks/pre-release.sh": "1b13062dda97df66792df382312263d704a6cc706d2dd3da921f4c470488276d",
+  ".rlsbl/hooks/post-release.sh": "b455f8511e0b2655509ecf5dcb0ab7da5bb7c961f47910ff8e00cab5bd51f833"
+}

predraw-0.1.1/.rlsbl/hooks/post-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Post-release hook. Runs after a successful release (non-fatal).
+# Environment: RLSBL_VERSION is set to the released version.
+# Customize this for your project (e.g., local install, deploy, notify).
+
+set -euo pipefail
+
+echo "Post-release: v$RLSBL_VERSION"

predraw-0.1.1/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Pre-release validation hook.
+# Runs before rlsbl creates a release. Exit non-zero to abort.
+# Detects project type and runs appropriate checks automatically.
+
+set -euo pipefail
+
+echo "Running pre-release checks..."
+
+if [ -f go.mod ]; then
+  echo "Detected Go project"
+  go vet ./...
+  go build ./...
+  go test ./... -race -short -count=1
+elif [ -f package.json ]; then
+  echo "Detected npm project"
+  npm test
+elif [ -f pyproject.toml ]; then
+  echo "Detected Python project"
+  if command -v uv &>/dev/null; then
+    uv run pytest
+  elif command -v pytest &>/dev/null; then
+    pytest
+  fi
+fi
+
+echo "Pre-release checks passed."

predraw-0.1.1/.rlsbl/version

@@ -0,0 +1 @@
+0.7.0

predraw-0.1.1/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## 0.1.1
+
+- Bounding box calculation for paths — `place` pipeline step now uses real geometry instead of font-size heuristic
+- Local `fonts/` directory support — project-local fonts searched before system fonts for reproducible rendering
+- Component property overrides — `use` elements can override `fill` (replaces) and `opacity` (multiplies) on referenced components
+
+## 0.1.0
+
+- Declarative JSON format for describing visual assets (rect, path, text, group, background)
+- `$style` tokens with light/dark mode variants, resolved at render time
+- Per-character text styling via `charStyles`
+- Component system: `imports` + `use` with property overrides (fill, opacity cascade)
+- `text-to-paths` pipeline step via fonttools (converts text to SVG path outlines)
+- Pipeline steps: `center`, `place`, `group`, `text-to-paths`
+- Output formats: SVG, PNG (via cairosvg), WebP (via Pillow)
+- Config-driven outputs with per-output mode selection (`config.json`)
+- `predraw build` — render all outputs from a project directory or single file
+- `predraw pack` — convert directory project to single portable JSON file
+- `predraw unpack` — convert packed file back to directory with components
+- JSON Schema for scene and config formats
+- `predraw validate` — validate scene/config files against the JSON Schema

predraw-0.1.1/CLAUDE.md

@@ -0,0 +1,20 @@
+# predraw
+
+## Release workflow
+
+This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestration.
+
+- Update CHANGELOG.md with a `## X.Y.Z` entry describing changes
+- Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
+- CI handles publishing automatically via the publish workflow
+- Never publish manually — always use `rlsbl release`
+- Requires `NPM_TOKEN` secret on GitHub (for npm projects)
+- Use `rlsbl release --dry-run` to preview a release without making changes
+
+## Conventions
+
+- No tokens or secrets in command-line arguments (use env vars or config files)
+- All file writes to shared state should be atomic (write to tmp, then rename)
+- External calls (APIs, CLI tools) must have timeouts and graceful fallbacks
+- Use `npm link` (npm) or `uv pip install -e .` (Python) for local development
+- CI runs smoke tests on every push; manual testing for UI/UX changes

predraw-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mhxv
+
+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.

predraw-0.1.1/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.4
+Name: predraw
+Version: 0.1.1
+Summary: Declarative rendering pipeline: JSON in, SVG/PNG/WebP out
+License-File: LICENSE
+Keywords: declarative,json,pipeline,png,render,rlsbl,svg,text-to-paths,webp
+Requires-Python: >=3.11
+Requires-Dist: cairosvg>=2.7
+Requires-Dist: fonttools>=4.62.1
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: pillow>=10.0
+Description-Content-Type: text/markdown
+
+# predraw
+
+Declarative rendering pipeline: JSON in, SVG/PNG/WebP out.
+
+The missing link between your AI and the SVGs you want to make.
+
+## Install
+
+```
+uv tool install predraw
+```
+
+## Quick start
+
+Create a project directory:
+
+```
+my-asset/
+  main.json
+  config.json
+```
+
+**main.json** -- the scene:
+
+```json
+{
+  "width": 400,
+  "height": 200,
+  "styles": {
+    "bg": {"light": "#ffffff", "dark": "#1a1a1a"},
+    "fg": {"light": "#000000", "dark": "#ffffff"}
+  },
+  "elements": [
+    {"type": "background", "fill": "$bg"},
+    {
+      "type": "text",
+      "id": "title",
+      "content": "hello world",
+      "x": 200,
+      "y": 110,
+      "anchor": "middle",
+      "fill": "$fg",
+      "font": {"family": "Liberation Sans", "size": 48, "weight": 700}
+    }
+  ],
+  "pipeline": [
+    {"action": "text-to-paths", "target": "title"}
+  ]
+}
+```
+
+**config.json** -- output targets:
+
+```json
+{
+  "outputs": [
+    {"format": "svg", "path": "hello-dark.svg", "mode": "dark"},
+    {"format": "png", "path": "hello-light.png", "mode": "light"},
+    {"format": "webp", "path": "hello-dark.webp", "mode": "dark", "quality": 90}
+  ]
+}
+```
+
+Build:
+
+```
+predraw build my-asset/
+```
+
+## Commands
+
+### build [path]
+
+Render all outputs defined in `config.json`. Path can be a directory (looks for `main.json`) or a file.
+
+```
+predraw build                    # current directory
+predraw build path/to/project    # explicit path
+```
+
+### pack [path] [-o file]
+
+Convert a directory project into a single portable JSON file. Imports are resolved and inlined as `defs`.
+
+```
+predraw pack my-asset/ -o packed.json
+```
+
+### unpack \<file\> [-o dir]
+
+Convert a packed JSON file back into a directory project with separate component files.
+
+```
+predraw unpack packed.json -o my-asset/
+```
+
+## Format
+
+### Element types
+
+| Type | Purpose | Key properties |
+|---|---|---|
+| `background` | Full-canvas fill | `fill` |
+| `rect` | Rectangle | `x`, `y`, `width`, `height`, `fill` |
+| `path` | SVG path | `d`, `fill`, `opacity`, `transform` |
+| `text` | Text (can convert to paths) | `content`, `font`, `anchor`, `charStyles` |
+| `group` | Container | `elements`, `transform` |
+
+### Use (component instantiation)
+
+Reference a component from `imports` or `defs`:
+
+```json
+{"use": "logo", "transform": {"translate": [100, 50], "scale": [2, 2]}}
+```
+
+Property overrides cascade to children:
+
+```json
+{"use": "logo", "fill": "#ff0000", "opacity": 0.5}
+```
+
+### Styles
+
+Define color tokens with light/dark variants:
+
+```json
+{
+  "styles": {
+    "primary": {"light": "#000000", "dark": "#ffffff"},
+    "muted": {"light": "#666666", "dark": "#999999"}
+  }
+}
+```
+
+Reference with `$` prefix: `"fill": "$primary"`. Mode is selected per-output in `config.json`.
+
+### charStyles
+
+Style individual characters differently:
+
+```json
+{
+  "type": "text",
+  "content": "releasable",
+  "fill": "#ffffff",
+  "charStyles": [
+    {"chars": "rlsbl", "opacity": 1.0},
+    {"chars": "eeaa", "opacity": 0.12}
+  ]
+}
+```
+
+### Pipeline
+
+Ordered postprocessing steps:
+
+| Action | Fields | Description |
+|---|---|---|
+| `text-to-paths` | `target` | Convert text to path outlines via font glyphs |
+| `center` | `target`, `axis` (x/y/both) | Center element on canvas |
+| `place` | `target`, `below`, `gap` | Position element below another |
+| `group` | `targets`, `id` | Wrap elements into a group |
+
+### Components
+
+Split reusable parts into separate files:
+
+```
+project/
+  main.json
+  config.json
+  components/
+    logo.json
+```
+
+**main.json:**
+```json
+{
+  "imports": {"logo": "./components/logo.json"},
+  "elements": [
+    {"use": "logo", "transform": {"translate": [10, 10]}}
+  ]
+}
+```
+
+### Packed format
+
+`predraw pack` inlines imports as `defs`:
+
+```json
+{
+  "defs": {
+    "logo": {"type": "group", "elements": [...]}
+  },
+  "elements": [
+    {"use": "logo"}
+  ]
+}
+```
+
+## Config
+
+`config.json` defines output targets:
+
+```json
+{
+  "outputs": [
+    {"format": "svg", "path": "out.svg"},
+    {"format": "png", "path": "out-dark.png", "mode": "dark"},
+    {"format": "webp", "path": "out.webp", "mode": "dark", "quality": 90}
+  ]
+}
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `format` | Yes | `svg`, `png`, or `webp` |
+| `path` | Yes | Output file path (relative to project dir) |
+| `mode` | No | `light` or `dark` (default: `dark`) |
+| `quality` | No | WebP quality 1-100 (default: 90) |
+
+## JSON Schema
+
+Formal schemas for editor validation and LLM structured output:
+
+- `schema/scene.schema.json` -- scene format
+- `schema/config.schema.json` -- config format
+
+## Requirements
+
+- Python 3.11+
+- System fonts for `text-to-paths` (searches standard font directories)
+
+## License
+
+MIT

predraw-0.1.1/README.md

@@ -0,0 +1,237 @@
+# predraw
+
+Declarative rendering pipeline: JSON in, SVG/PNG/WebP out.
+
+The missing link between your AI and the SVGs you want to make.
+
+## Install
+
+```
+uv tool install predraw
+```
+
+## Quick start
+
+Create a project directory:
+
+```
+my-asset/
+  main.json
+  config.json
+```
+
+**main.json** -- the scene:
+
+```json
+{
+  "width": 400,
+  "height": 200,
+  "styles": {
+    "bg": {"light": "#ffffff", "dark": "#1a1a1a"},
+    "fg": {"light": "#000000", "dark": "#ffffff"}
+  },
+  "elements": [
+    {"type": "background", "fill": "$bg"},
+    {
+      "type": "text",
+      "id": "title",
+      "content": "hello world",
+      "x": 200,
+      "y": 110,
+      "anchor": "middle",
+      "fill": "$fg",
+      "font": {"family": "Liberation Sans", "size": 48, "weight": 700}
+    }
+  ],
+  "pipeline": [
+    {"action": "text-to-paths", "target": "title"}
+  ]
+}
+```
+
+**config.json** -- output targets:
+
+```json
+{
+  "outputs": [
+    {"format": "svg", "path": "hello-dark.svg", "mode": "dark"},
+    {"format": "png", "path": "hello-light.png", "mode": "light"},
+    {"format": "webp", "path": "hello-dark.webp", "mode": "dark", "quality": 90}
+  ]
+}
+```
+
+Build:
+
+```
+predraw build my-asset/
+```
+
+## Commands
+
+### build [path]
+
+Render all outputs defined in `config.json`. Path can be a directory (looks for `main.json`) or a file.
+
+```
+predraw build                    # current directory
+predraw build path/to/project    # explicit path
+```
+
+### pack [path] [-o file]
+
+Convert a directory project into a single portable JSON file. Imports are resolved and inlined as `defs`.
+
+```
+predraw pack my-asset/ -o packed.json
+```
+
+### unpack \<file\> [-o dir]
+
+Convert a packed JSON file back into a directory project with separate component files.
+
+```
+predraw unpack packed.json -o my-asset/
+```
+
+## Format
+
+### Element types
+
+| Type | Purpose | Key properties |
+|---|---|---|
+| `background` | Full-canvas fill | `fill` |
+| `rect` | Rectangle | `x`, `y`, `width`, `height`, `fill` |
+| `path` | SVG path | `d`, `fill`, `opacity`, `transform` |
+| `text` | Text (can convert to paths) | `content`, `font`, `anchor`, `charStyles` |
+| `group` | Container | `elements`, `transform` |
+
+### Use (component instantiation)
+
+Reference a component from `imports` or `defs`:
+
+```json
+{"use": "logo", "transform": {"translate": [100, 50], "scale": [2, 2]}}
+```
+
+Property overrides cascade to children:
+
+```json
+{"use": "logo", "fill": "#ff0000", "opacity": 0.5}
+```
+
+### Styles
+
+Define color tokens with light/dark variants:
+
+```json
+{
+  "styles": {
+    "primary": {"light": "#000000", "dark": "#ffffff"},
+    "muted": {"light": "#666666", "dark": "#999999"}
+  }
+}
+```
+
+Reference with `$` prefix: `"fill": "$primary"`. Mode is selected per-output in `config.json`.
+
+### charStyles
+
+Style individual characters differently:
+
+```json
+{
+  "type": "text",
+  "content": "releasable",
+  "fill": "#ffffff",
+  "charStyles": [
+    {"chars": "rlsbl", "opacity": 1.0},
+    {"chars": "eeaa", "opacity": 0.12}
+  ]
+}
+```
+
+### Pipeline
+
+Ordered postprocessing steps:
+
+| Action | Fields | Description |
+|---|---|---|
+| `text-to-paths` | `target` | Convert text to path outlines via font glyphs |
+| `center` | `target`, `axis` (x/y/both) | Center element on canvas |
+| `place` | `target`, `below`, `gap` | Position element below another |
+| `group` | `targets`, `id` | Wrap elements into a group |
+
+### Components
+
+Split reusable parts into separate files:
+
+```
+project/
+  main.json
+  config.json
+  components/
+    logo.json
+```
+
+**main.json:**
+```json
+{
+  "imports": {"logo": "./components/logo.json"},
+  "elements": [
+    {"use": "logo", "transform": {"translate": [10, 10]}}
+  ]
+}
+```
+
+### Packed format
+
+`predraw pack` inlines imports as `defs`:
+
+```json
+{
+  "defs": {
+    "logo": {"type": "group", "elements": [...]}
+  },
+  "elements": [
+    {"use": "logo"}
+  ]
+}
+```
+
+## Config
+
+`config.json` defines output targets:
+
+```json
+{
+  "outputs": [
+    {"format": "svg", "path": "out.svg"},
+    {"format": "png", "path": "out-dark.png", "mode": "dark"},
+    {"format": "webp", "path": "out.webp", "mode": "dark", "quality": 90}
+  ]
+}
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `format` | Yes | `svg`, `png`, or `webp` |
+| `path` | Yes | Output file path (relative to project dir) |
+| `mode` | No | `light` or `dark` (default: `dark`) |
+| `quality` | No | WebP quality 1-100 (default: 90) |
+
+## JSON Schema
+
+Formal schemas for editor validation and LLM structured output:
+
+- `schema/scene.schema.json` -- scene format
+- `schema/config.schema.json` -- config format
+
+## Requirements
+
+- Python 3.11+
+- System fonts for `text-to-paths` (searches standard font directories)
+
+## License
+
+MIT

predraw-0.1.1/predraw/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

predraw-0.1.1/predraw/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running predraw as: python -m predraw"""
+
+from .cli import main
+
+main()