printavo-ruby 0.18.0 → 0.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b7e5a10f0b5ecc844c1625db1ebae2f19154c81d49a666af5d5f4e6f9d55bd8
-  data.tar.gz: 8a75223829bbb6a67c9477460556b78260ef99104ab7e5ef9af7bdcc64c9b558
+  metadata.gz: d2291442eb2c04c3ead1543773bcd188723de181093941cdc8519681b5b43e4b
+  data.tar.gz: 00274b8c115044888d4099465521acf974c0356261130eb6aacaa21f1d4aa5ce
 SHA512:
-  metadata.gz: 4a92c64b1c47d1f9aab27a2fb29957337f582fe4b59cfb675ee937fcd8ef18c4ebf078479fe8cbceb608589648636be5e74daf40f95e0c1d1df63c8d359bb106
-  data.tar.gz: 90c15ea027dfffa37c57aab86086edee3624feb5b31cd4bec431cf41d250b3296bd097f388e69609f13077db7c46fc8db047aaaddbce7a7964d16f7b4b108b74
+  metadata.gz: fdd286fc6a29e0313aed8f7ebbea302f7737e17f44144a524396eadcde292d70d9a87b610d22ec3bd692a9a93572d7bb844c861c71dd1e87435c59a3cd465ade
+  data.tar.gz: 29719257b52dfd20f4f9da862e3ccca5df84f8dc64dfb564421a73cbe1b88e46e2a5b36891066ed1e43607e30a3e9a9c6ceecdb3697ac85ce53c2eb1a17b9afa

data/docs/FUTURE.md

@@ -38,18 +38,8 @@ See [docs/CACHING.md](docs/CACHING.md) for caching options.
 
 ## Visualization
 
-### Workflow Diagram Generation (SVG/PNG)
-
-Generate a visual map of a shop's Printavo status workflow:
-
-```ruby
-client.workflow.diagram(format: :svg)
-# => Outputs an SVG flowchart: Quote → Approved → In Production → Completed
-```
-
-Implementation options:
-- [ruby-graphviz](https://github.com/glejeune/Ruby-Graphviz) — DOT → SVG/PNG
-- Pure Ruby → Mermaid output (copy-paste into docs or GitHub markdown)
+See **[docs/VISUALIZATION.md](VISUALIZATION.md)** for workflow diagram generation —
+Mermaid, DOT, ASCII, and SVG output via the standalone example script.
 
 ## Multi-Language SDK Family
 

data/docs/TODO.md

@@ -417,6 +417,15 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `default_ttl: 300` configurable per-client
 - [x] `docs/CACHING.md` updated with built-in adapter usage examples
 
+### v0.18.1 — Examples: Diagramming & Reporting
+
+- [x] `examples/diagramming/workflow_diagram.rb` — Mermaid, DOT, ASCII, SVG (dot CLI + ruby-graphviz gem)
+- [x] `examples/reporting/sales_report.rb` — today, week, month, quarter, YTD, last year, custom range
+- [x] `examples/reporting/sales_tax_report.rb` — invoice-level estimates + fee-level taxable detail
+- [x] `examples/reporting/customers_export.rb` — CSV, XLSX, XLS, vCard (.vcf), HubSpot, Salesforce, Mailchimp, Constant Contact, Beehiiv, Brevo, ActiveCampaign
+- [x] `examples/reporting/outstanding_tasks.rb` — overdue, due today, this week, upcoming, no due date; by-assignee summary; HTML calendar export
+- [x] `docs/FUTURE.md` — Workflow Diagram section replaced with examples reference and rationale
+
 ### v0.99.0 — API Freeze
 
 - [ ] Community feedback integration

data/docs/VISUALIZATION.md

@@ -0,0 +1,81 @@
+<!-- docs/VISUALIZATION.md -->
+# Visualization for [printavo-ruby](https://github.com/scarver2/printavo-ruby)
+
+## Workflow Diagram Generation
+
+See **[examples/diagramming/workflow_diagram.rb](../examples/diagramming/workflow_diagram.rb)**
+for a complete, runnable example covering all four output formats.
+
+Adding diagram generation to the gem itself would require either shipping
+`ruby-graphviz` as a hard dependency or assuming a system `dot` binary —
+both are burdensome for a Ruby API client. The standalone example gives
+consumers full control over their output format and toolchain without
+bloating the gem.
+
+**Supported formats in the example:**
+
+| Format | Dependency | Best for |
+|---|---|---|
+| `:ascii` | none | Terminal output, quick sanity-check |
+| `:mermaid` | none | GitHub README/issues/PRs, VS Code preview |
+| `:dot` | none (text) | Piping to `dot -Tsvg` or any Graphviz renderer |
+| `:svg` | `brew install graphviz` or `gem install ruby-graphviz` | Production-grade visual files |
+
+Statuses are fetched via `client.statuses.all` and rendered as a linear
+left-to-right flow in the order Printavo returns them. Printavo has no
+explicit transition edges in its API — the workflow is an implied sequence.
+
+### Quick Start
+
+```bash
+cd examples/diagramming
+cp .env.example .env   # fill in PRINTAVO_EMAIL and PRINTAVO_TOKEN
+gem install printavo-ruby dotenv
+ruby workflow_diagram.rb
+```
+
+Output files written to the current directory:
+
+| File | Format |
+|---|---|
+| *(stdout)* | ASCII chain |
+| *(stdout)* | Mermaid fenced block |
+| `workflow.dot` | Graphviz DOT source |
+| `workflow_cli.svg` | SVG via `dot` CLI (if graphviz installed) |
+| `workflow_gv.svg` | SVG via `ruby-graphviz` gem (if installed) |
+
+### Rendering DOT to Other Formats
+
+```bash
+# SVG
+dot -Tsvg workflow.dot > workflow.svg
+
+# PNG
+dot -Tpng workflow.dot > workflow.png
+
+# PDF
+dot -Tpdf workflow.dot > workflow.pdf
+```
+
+### Embedding Mermaid in GitHub Markdown
+
+Paste the Mermaid output between fences in any `.md` file:
+
+````markdown
+```mermaid
+flowchart LR
+  s_quote["Quote"] --> s_in_production["In Production"] --> s_completed["Completed"]
+```
+````
+
+GitHub renders it automatically in READMEs, issues, PRs, and wiki pages.
+
+---
+
+## Colophon
+
+[MIT License](LICENSE)
+
+&copy;2026 [Stan Carver II](https://stancarver.com)
+
+![Made in Texas](https://raw.githubusercontent.com/scarver2/howdy-world/master/_dashboard/www/assets/made-in-texas.png)

data/lib/printavo/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Printavo
-  VERSION = '0.18.0'
+  VERSION = '0.18.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: printavo-ruby
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.18.1
 platform: ruby
 authors:
 - Stan Carver II
@@ -285,6 +285,7 @@ files:
 - docs/CONTRIBUTING.md
 - docs/FUTURE.md
 - docs/TODO.md
+- docs/VISUALIZATION.md
 - lib/printavo.rb
 - lib/printavo/cli.rb
 - lib/printavo/client.rb