feat(core): extract maple-render-core and automate crate publishing

Session-Id: 033876f1-e95b-4b2c-b333-aa69786c03a6

Author: taskylizard

.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - trunk
+      - main
+    tags:
+      - "core-v*"
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: "Publish maple-render-core to crates.io"
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+  CARGO_TARGET_DIR: target
+
+jobs:
+  rust:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+          targets: wasm32-unknown-unknown
+
+      - name: Cache Rust artifacts
+        uses: Swatinem/rust-cache@v2
+
+      - name: Format check
+        run: cargo fmt --all -- --check
+
+      - name: Clippy (root crate)
+        run: cargo clippy --locked --all-targets -- -D warnings
+
+      - name: Check root crate
+        run: cargo check --locked
+
+      - name: Test root crate
+        run: cargo test --locked --lib
+
+      - name: Check wasm exports
+        run: cargo check --locked --lib --target wasm32-unknown-unknown
+
+      - name: Check maple-render-core standalone crate
+        run: cargo check --manifest-path crates/maple-render-core/Cargo.toml
+
+      - name: Test maple-render-core standalone crate
+        run: cargo test --manifest-path crates/maple-render-core/Cargo.toml
+
+      - name: Verify maple-render-core publish dry-run
+        run: cargo publish --dry-run --allow-dirty --manifest-path crates/maple-render-core/Cargo.toml
+
+  publish-maple-render-core:
+    name: Publish maple-render-core
+    runs-on: ubuntu-latest
+    needs: rust
+    if: startsWith(github.ref, 'refs/tags/core-v') || (github.event_name == 'workflow_dispatch' && github.event.inputs.publish == 'true')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust artifacts
+        uses: Swatinem/rust-cache@v2
+
+      - name: Validate tag matches crate version
+        if: startsWith(github.ref, 'refs/tags/core-v')
+        run: |
+          VERSION=$(grep '^version = ' crates/maple-render-core/Cargo.toml | head -n1 | cut -d '"' -f2)
+          TAG_VERSION="${GITHUB_REF_NAME#core-v}"
+          if [ "$VERSION" != "$TAG_VERSION" ]; then
+            echo "Tag version ($TAG_VERSION) does not match crate version ($VERSION)"
+            exit 1
+          fi
+
+      - name: Publish maple-render-core to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --manifest-path crates/maple-render-core/Cargo.toml --token "$CARGO_REGISTRY_TOKEN"

Cargo.lock

@@ -10,15 +10,11 @@ crate-type = ["cdylib", "rlib"]
 [dependencies]
 clap = { version = "4", features = ["derive"] }
 image = "0.25"
-gif = "0.13"
-zip = { version = "2.1", default-features = false, features = ["deflate"] }
 eyre = "0.6"
 color-eyre = "0.6"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
-delaunator = "1.0"
-ab_glyph = "0.2"
-imageproc = "0.25"
+maple-render-core = { path = "crates/maple-render-core", version = "0.1.0" }
 
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 wasm-bindgen = "0.2"
@@ -37,5 +33,3 @@ panic = "abort"
 version = "0.1"
 default-features = false
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies.rayon]
-version = "1.10"

Cargo.toml

@@ -4,6 +4,8 @@
 
 maple allows you to composite images/text with templates into animated GIFs/Videos. `templates/` has some fun ones to try!
 
+Core rendering logic now lives in the publishable [`maple-render-core`](crates/maple-render-core) crate. The core crate does not bundle templates or fonts.
+
 ## Install
 
 ```
@@ -12,6 +14,14 @@ cargo install --path .
 
 Requires Rust 1.80+. Video output requires ffmpeg.
 
+## Core crate (publishable)
+
+The standalone core crate lives at `crates/maple-render-core`.
+
+```bash
+cargo publish --manifest-path crates/maple-render-core/Cargo.toml
+```
+
 ## Usage
 
 ```

README.md

@@ -0,0 +1,24 @@
+[package]
+name = "maple-render-core"
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.80"
+description = "Core rendering and animation logic for Maple templates"
+license = "MIT"
+repository = "https://github.com/davebcn87/maple"
+readme = "README.md"
+keywords = ["gif", "image", "rendering", "template", "animation"]
+categories = ["multimedia::images", "multimedia::video"]
+
+[dependencies]
+image = "0.25"
+gif = "0.13"
+zip = { version = "2.1", default-features = false, features = ["deflate"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+delaunator = "1.0"
+ab_glyph = "0.2"
+imageproc = "0.25"
+
+[target.'cfg(not(target_arch = "wasm32"))'.dependencies.rayon]
+version = "1.10"

crates/maple-render-core/Cargo.toml

@@ -0,0 +1,62 @@
+# maple-render-core
+
+Core rendering engine extracted from Maple.
+
+This crate contains:
+
+- Template repository loading (`Repository`)
+- Frame compositing and mapping (`Render`, `Renders`)
+- GIF/video helpers (`GifAnim`, `VidAnim`)
+- Quantization pipeline
+- Input handling for images and text
+
+It intentionally does **not** bundle templates or font assets.
+For text rendering, callers must pass font bytes into `Input::from_text`.
+
+## Publish checklist
+
+From the repository root:
+
+```bash
+# 1) Validate locally
+cargo check --manifest-path crates/maple-render-core/Cargo.toml
+cargo test --manifest-path crates/maple-render-core/Cargo.toml
+
+# 2) Inspect package contents
+cargo package --manifest-path crates/maple-render-core/Cargo.toml --list
+
+# 3) Full registry validation without upload
+cargo publish --manifest-path crates/maple-render-core/Cargo.toml --dry-run
+
+# 4) Publish for real
+cargo publish --manifest-path crates/maple-render-core/Cargo.toml
+```
+
+## Minimal usage
+
+```rust
+use maple_render_core::{GifAnim, Input, Inputs, Renders, Repository, TextOptions};
+use maple_render_core::render::RenderQuality;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Load a template zip generated using Maple's template format.
+    let repo = Repository::load("templates/toaster.zip")?;
+
+    // Add image input.
+    let mut inputs = Inputs::new();
+    inputs.push(Input::load("examples/monkey.jpg")?);
+
+    // Optional: add text input using your own font bytes.
+    let font_data = std::fs::read("fonts/DejaVuSans-Bold.ttf")?;
+    let text = Input::from_text("HELLO", 2, &TextOptions::default(), &font_data)?;
+    inputs.push(text);
+
+    // Render and encode GIF.
+    let mut renders = Renders::new(repo, inputs, RenderQuality::Sampled);
+    let mut gif = GifAnim::new(renders);
+    gif.apply()?;
+    gif.save("out.gif")?;
+
+    Ok(())
+}
+```

crates/maple-render-core/README.md

@@ -1,4 +1,8 @@
-use std::{fs::File, io::{BufWriter, Cursor}, path::Path};
+use std::{
+    fs::File,
+    io::{BufWriter, Cursor},
+    path::Path,
+};
 
 use gif::{Encoder, Frame, Repeat};
 use image::RgbaImage;

src/error.rs crates/maple-render-core/src/error.rssrc/error.rs renamed to crates/maple-render-core/src/error.rs

@@ -6,8 +6,6 @@ use imageproc::drawing::draw_text_mut;
 
 use crate::error::{Error, Result};
 
-const DEFAULT_FONT: &[u8] = include_bytes!("../fonts/DejaVuSans-Bold.ttf");
-
 #[derive(Clone)]
 pub struct TextOptions {
     pub font_size: f32,
@@ -92,8 +90,13 @@ impl Input {
         input
     }
 
-    pub fn from_text(text: &str, layer: u8, options: &TextOptions) -> Result<Self> {
-        let font = FontRef::try_from_slice(DEFAULT_FONT)
+    pub fn from_text(
+        text: &str,
+        layer: u8,
+        options: &TextOptions,
+        font_data: &[u8],
+    ) -> Result<Self> {
+        let font = FontRef::try_from_slice(font_data)
             .map_err(|e| Error::TextRender(format!("Failed to load font: {}", e)))?;
 
         let scale = PxScale::from(options.font_size);

src/gif_anim.rs crates/maple-render-core/src/gif_anim.rssrc/gif_anim.rs renamed to crates/maple-render-core/src/gif_anim.rs

@@ -0,0 +1,20 @@
+pub mod error;
+pub mod gif_anim;
+pub mod input;
+pub mod mapping;
+pub mod pixer;
+pub mod quantize;
+pub mod render;
+pub mod renders;
+pub mod repository;
+pub mod template;
+pub mod vid_anim;
+
+pub use error::{Error, Result};
+pub use gif_anim::GifAnim;
+pub use input::{Input, Inputs, TextOptions};
+pub use mapping::Mapping;
+pub use render::Render;
+pub use renders::Renders;
+pub use repository::Repository;
+pub use template::Template;