plotleaf 0.1.0 → 0.3.0

package/examples/catalog/products.json

@@ -0,0 +1,78 @@
+[
+  {
+    "product": "Linen tote",
+    "image": "./assets/linen-tote.png",
+    "image_alt": "Illustration of a sand-coloured linen tote",
+    "weekly_orders": [
+      42,
+      47,
+      44,
+      56,
+      59,
+      63,
+      68,
+      74
+    ],
+    "orders": 453,
+    "revenue": 18120,
+    "change": 0.182,
+    "last_week": 74
+  },
+  {
+    "product": "Desk lamp",
+    "image": "./assets/desk-lamp.jpg",
+    "image_alt": "Illustration of a blue desk lamp",
+    "weekly_orders": [
+      38,
+      35,
+      39,
+      null,
+      46,
+      44,
+      49,
+      53
+    ],
+    "orders": 304,
+    "revenue": 27360,
+    "change": 0.124,
+    "last_week": 53
+  },
+  {
+    "product": "Field notebook",
+    "image": "./assets/field-notebook.png",
+    "image_alt": "Illustration of a green field notebook",
+    "weekly_orders": [
+      60,
+      63,
+      59,
+      64,
+      62,
+      69,
+      72,
+      78
+    ],
+    "orders": 527,
+    "revenue": 10540,
+    "change": 0.068,
+    "last_week": 78
+  },
+  {
+    "product": "Linen tote \u2014 natural",
+    "image": "./assets/linen-tote.png",
+    "image_alt": "Illustration of the same sand-coloured linen tote in a second product row",
+    "weekly_orders": [
+      18,
+      21,
+      20,
+      24,
+      23,
+      27,
+      29,
+      31
+    ],
+    "orders": 193,
+    "revenue": 7720,
+    "change": 0.094,
+    "last_week": 31
+  }
+]

package/examples/catalog/report.md

@@ -0,0 +1,39 @@
+---
+title: Product Performance
+description: A fictional catalogue with embedded product images and weekly order sparklines.
+---
+
+# Product Performance
+
+A fictional store's product performance over **eight weeks ending 1 November 2026**. All data, comparisons and product illustrations are synthetic and prepared for this example.
+
+:::grid{columns="3"}
+::metric{label="Orders" value="1477" comparison="18.2% vs previous eight weeks" direction="up" sentiment="positive"}
+::metric{label="Revenue" value="63740" format="currency:USD" comparison="20% vs previous eight weeks" direction="up" sentiment="positive"}
+::metric{label="Products" value="4" comparison="1 more than previous period" direction="up" sentiment="positive"}
+:::
+
+The fictional comparison period contains **1,250 orders**, **US$53,120 revenue** and **three products**. Changes above are prepared and rounded by the example author.
+
+## Product detail
+
+Weekly order lines share the same vertical scale, so their heights are comparable. The lamp has one missing week, shown as a gap; its prepared total covers recorded weeks only. Expand **View values** to inspect the original samples.
+
+:::table{data="./products.json" title="Performance by product"}
+::column{field="image" label="Preview" kind="image" alt="image_alt"}
+::column{field="product" label="Product"}
+::column{field="weekly_orders" label="Weekly orders" kind="sparkline" sortBy="last_week"}
+::column{field="orders" label="Orders" format="number"}
+::column{field="revenue" label="Revenue" format="currency:USD"}
+::column{field="change" label="Δ period" format="percent" sign="always" semantics="higher-is-better"}
+:::
+
+### Reading this table
+
+- **Linen tote leads relative growth.** Comparisons are prepared by the author, not calculated from the sparkline.
+- **Notebooks lead order volume.** They also have the highest final-week value in this fictional set.
+- **The natural tote reuses its image.** The portable report embeds each unique illustration once.
+
+:::callout{title="Coverage"}
+Every value and illustration is fictional. Sorting Weekly orders uses the declared final-week key; it does not compare arrays or recompute totals. No live filters or subtotal calculations are implied.
+:::

package/examples/catalog/showcase-products.json

@@ -0,0 +1,78 @@
+[
+  {
+    "product": "Linen tote",
+    "image": "./catalog/assets/linen-tote.png",
+    "image_alt": "Illustration of a sand-coloured linen tote",
+    "weekly_orders": [
+      42,
+      47,
+      44,
+      56,
+      59,
+      63,
+      68,
+      74
+    ],
+    "orders": 453,
+    "revenue": 18120,
+    "change": 0.182,
+    "last_week": 74
+  },
+  {
+    "product": "Desk lamp",
+    "image": "./catalog/assets/desk-lamp.jpg",
+    "image_alt": "Illustration of a blue desk lamp",
+    "weekly_orders": [
+      38,
+      35,
+      39,
+      null,
+      46,
+      44,
+      49,
+      53
+    ],
+    "orders": 304,
+    "revenue": 27360,
+    "change": 0.124,
+    "last_week": 53
+  },
+  {
+    "product": "Field notebook",
+    "image": "./catalog/assets/field-notebook.png",
+    "image_alt": "Illustration of a green field notebook",
+    "weekly_orders": [
+      60,
+      63,
+      59,
+      64,
+      62,
+      69,
+      72,
+      78
+    ],
+    "orders": 527,
+    "revenue": 10540,
+    "change": 0.068,
+    "last_week": 78
+  },
+  {
+    "product": "Linen tote — natural",
+    "image": "./catalog/assets/linen-tote.png",
+    "image_alt": "Illustration of the same sand-coloured linen tote in a second product row",
+    "weekly_orders": [
+      18,
+      21,
+      20,
+      24,
+      23,
+      27,
+      29,
+      31
+    ],
+    "orders": 193,
+    "revenue": 7720,
+    "change": 0.094,
+    "last_week": 31
+  }
+]

package/examples/onboarding/funnel.json

@@ -0,0 +1,30 @@
+[
+  {
+    "stage": "Visited",
+    "teams": 41200,
+    "baseline": 41200,
+    "share": 1.0,
+    "status": "on-target"
+  },
+  {
+    "stage": "Signed up",
+    "teams": 12480,
+    "baseline": 41200,
+    "share": 0.3029126213592233,
+    "status": "on-target"
+  },
+  {
+    "stage": "Activated",
+    "teams": 7612,
+    "baseline": 41200,
+    "share": 0.18475728155339805,
+    "status": "below-target"
+  },
+  {
+    "stage": "Converted",
+    "teams": 1284,
+    "baseline": 41200,
+    "share": 0.03116504854368932,
+    "status": "at-risk"
+  }
+]

package/examples/onboarding/plans.json

@@ -0,0 +1,14 @@
+[
+  {
+    "plan": "Pro",
+    "teams": 5100
+  },
+  {
+    "plan": "Team",
+    "teams": 1900
+  },
+  {
+    "plan": "Free",
+    "teams": 612
+  }
+]

package/examples/onboarding/report.md

@@ -0,0 +1,42 @@
+---
+title: PLG Onboarding
+description: A fictional product onboarding report with prepared funnel and plan data.
+---
+
+# PLG Onboarding
+
+A fictional product's onboarding performance, **6 April–28 June 2026**. All values and comparisons are synthetic, prepared by the example author.
+
+:::grid{columns="4"}
+::metric{label="Signups" value="12480" comparison="18.2% vs previous quarter" direction="up" sentiment="positive"}
+::metric{label="Activated teams" value="7612" comparison="24.1% vs previous quarter" direction="up" sentiment="positive"}
+::metric{label="Converted" value="1284" comparison="11.4% vs previous quarter" direction="up" sentiment="positive"}
+::metric{label="Conversion rate" value="0.10288461538461538" format="percent" comparison="0.8 pt vs previous quarter" direction="up" sentiment="positive"}
+:::
+
+:::grid{columns="2"}
+::area{data="./signups.json" x="week" y="signups" xType="date" title="Signups by week"}
+::funnel{data="./funnel.json" stage="stage" value="teams" total="baseline" share="share" status="status" title="Funnel by stage"}
+:::
+
+## Activation mix
+
+**7,612 teams** activated. Pro accounts for the largest share; each category below is mutually exclusive. Funnel percentages use **41,200 visitors** as the explicit denominator. The KPI conversion rate uses **12,480 signups**, so it answers a different question.
+
+::::grid{columns="2"}
+::donut{data="./plans.json" category="plan" value="teams" title="Activated teams by plan"}
+:::table{data="./plans.json" title="Activated teams"}
+::column{field="plan" label="Plan"}
+::column{field="teams" label="Teams" format="number"}
+:::
+::::
+
+### Key findings
+
+- **Activation is the next opportunity.** Its below-target status is supplied by the author; the renderer does not infer it from the rate.
+- **Conversion needs attention.** The author marked this stage at risk against the fictional team's own operating targets.
+- **Pro leads the mix.** Plan counts add to the same 7,612 activated teams shown in the KPI and funnel.
+
+:::callout{title="About this example"}
+All data, comparisons, statuses and findings are fictional. This report has no live filters or data connections. The funnel preserves the prepared stage order and never guesses a denominator or business status.
+:::

package/examples/onboarding/signups.json

@@ -0,0 +1,50 @@
+[
+  {
+    "week": "2026-04-06",
+    "signups": 700
+  },
+  {
+    "week": "2026-04-13",
+    "signups": 800
+  },
+  {
+    "week": "2026-04-20",
+    "signups": 770
+  },
+  {
+    "week": "2026-04-27",
+    "signups": 850
+  },
+  {
+    "week": "2026-05-04",
+    "signups": 980
+  },
+  {
+    "week": "2026-05-11",
+    "signups": 1050
+  },
+  {
+    "week": "2026-05-18",
+    "signups": 1040
+  },
+  {
+    "week": "2026-05-25",
+    "signups": 1120
+  },
+  {
+    "week": "2026-06-01",
+    "signups": 1180
+  },
+  {
+    "week": "2026-06-08",
+    "signups": 1160
+  },
+  {
+    "week": "2026-06-15",
+    "signups": 1230
+  },
+  {
+    "week": "2026-06-22",
+    "signups": 1600
+  }
+]

package/examples/report.md

@@ -0,0 +1,96 @@
+---
+title: Storefront Overview
+description: A cumulative plotleaf showcase with fictional metrics, charts, tables, images and sparklines.
+---
+
+# Storefront Overview
+
+A fictional store's weekly performance, using synthetic data for demonstration. Orders grew **18.2%**, while returns fell **12%** from the previous period.
+
+:::grid{columns="4"}
+::metric{label="Orders" value="12480" comparison="18.2% vs previous week" direction="up" sentiment="positive"}
+::metric{label="Revenue" value="824160" format="currency:USD" comparison="24.1% vs previous week" direction="up" sentiment="positive"}
+::metric{label="Returns" value="384" comparison="12% vs previous week" direction="down" sentiment="positive"}
+::metric{label="Return rate" value="0.03076923076923077" format="percent" comparison="0.4 pt vs previous week" direction="down" sentiment="positive"}
+:::
+
+## Sales and returns
+
+The store received **12,480 orders** over seven days. Size-related returns made up most of the **384 returns**, suggesting a useful area for clearer product guidance.
+
+:::grid{columns="2"}
+::area{data="./storefront/orders.json" x="date" y="orders" xType="date" title="Orders by day" target="2000" targetLabel="Daily target"}
+::bar{data="./storefront/returns.json" x="reason" y="count" title="Returns by reason"}
+:::
+
+## Sales by category
+
+Apparel accounts for the largest share of this fictional week's **12,480 orders**. Each order belongs to one category.
+
+::::grid{columns="2"}
+::donut{data="./storefront/categories.json" category="category" value="orders" title="Order mix"}
+:::table{data="./storefront/categories.json" title="Category performance"}
+::column{field="category" label="Category"}
+::column{field="orders" label="Orders" format="number"}
+::column{field="revenue" label="Revenue" format="currency:USD"}
+::column{field="change" label="Δ week" format="percent" sign="always" semantics="higher-is-better"}
+:::
+::::
+
+### Key findings
+
+- **Growth spans every category.** All four categories increased orders over the previous week.
+- **Returns declined.** The return count and rate both improved.
+- **Size guidance is the next opportunity.** Review fit descriptions before changing the return policy.
+
+---
+
+## Product onboarding
+
+A separate fictional product example covers **6 April–28 June 2026**. Its prepared funnel uses **41,200 visitors** as the denominator for every stage; its statuses reflect the example author's operating targets. These team counts are independent of the store's orders above.
+
+:::grid{columns="2"}
+::line{data="./onboarding/signups.json" x="week" y="signups" xType="date" title="Signups by week" target="1600" targetLabel="Weekly target"}
+::funnel{data="./onboarding/funnel.json" stage="stage" value="teams" total="baseline" share="share" status="status" title="Funnel by stage"}
+:::
+
+### Onboarding findings
+
+Activation needs attention against the prepared target, and conversion is marked at risk. Expand the chart and funnel data disclosures to inspect the original values and denominators.
+
+---
+
+## Product catalogue
+
+A fictional store's product performance over **eight weeks ending 1 November 2026**. All data, comparisons and product illustrations are synthetic and prepared for this example.
+
+:::grid{columns="3"}
+::metric{label="Orders" value="1477" comparison="18.2% vs previous eight weeks" direction="up" sentiment="positive"}
+::metric{label="Revenue" value="63740" format="currency:USD" comparison="20% vs previous eight weeks" direction="up" sentiment="positive"}
+::metric{label="Products" value="4" comparison="1 more than previous period" direction="up" sentiment="positive"}
+:::
+
+The fictional comparison period contains **1,250 orders**, **US$53,120 revenue** and **three products**. Changes above are prepared and rounded by the example author.
+
+### Product detail
+
+Weekly order lines share the same vertical scale, so their heights are comparable. The lamp has one missing week, shown as a gap; its prepared total covers recorded weeks only. Expand **View values** to inspect the original samples.
+
+:::table{data="./catalog/showcase-products.json" title="Performance by product"}
+::column{field="image" label="Preview" kind="image" alt="image_alt"}
+::column{field="product" label="Product"}
+::column{field="weekly_orders" label="Weekly orders" kind="sparkline" sortBy="last_week"}
+::column{field="orders" label="Orders" format="number"}
+::column{field="revenue" label="Revenue" format="currency:USD"}
+::column{field="change" label="Δ period" format="percent" sign="always" semantics="higher-is-better"}
+:::
+
+### Reading this table
+
+- **Linen tote leads relative growth.** Comparisons are prepared by the author, not calculated from the sparkline.
+- **Notebooks lead order volume.** They also have the highest final-week value in this fictional set.
+- **The natural tote reuses its image.** The portable report embeds each unique illustration once.
+
+:::callout{title="About these examples"}
+All datasets, comparisons, statuses, findings and product illustrations are fictional. Store totals cover 1–7 November 2026; the onboarding and catalogue sections identify their separate periods and populations. Comparisons are prepared by the author, not inferred by the renderer. No live filters, data connections or subtotal calculations are implied.
+:::

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "plotleaf",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Beautiful, interactive reports from Markdown and JSON. Built for agents.",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LoueeD/plotleaf.git"
+  },
+  "homepage": "https://github.com/LoueeD/plotleaf#readme",
+  "bugs": {
+    "url": "https://github.com/LoueeD/plotleaf/issues"
+  },
   "bin": {
     "plotleaf": "./dist/cli.js"
   },
@@ -18,10 +26,17 @@
     "dist/assets/styles.css",
     "dist/assets/notices.txt",
     "schema/components.json",
+    "examples/report.md",
     "examples/storefront/*.md",
     "examples/storefront/*.json",
     "examples/adoption/*.md",
     "examples/adoption/*.json",
+    "examples/onboarding/*.md",
+    "examples/onboarding/*.json",
+    "examples/catalog/*.md",
+    "examples/catalog/*.json",
+    "examples/catalog/assets/*.png",
+    "examples/catalog/assets/*.jpg",
     "skills/plotleaf/SKILL.md",
     "README.md",
     "LICENSE",
@@ -36,10 +51,12 @@
     "test:browser": "node node_modules/@playwright/test/cli.js test",
     "test:consumer": "node tests/consumer/smoke.mjs",
     "check": "bun run typecheck && bun run build && bun run test && bun run test:consumer",
-    "audit:package": "node scripts/audit-package.mjs"
+    "audit:package": "node scripts/audit-package.mjs",
+    "dev": "bun run build && node dist/cli.js dev examples/report.md"
   },
   "dependencies": {
     "chokidar": "6.0.0",
+    "image-size": "2.1.0",
     "open": "11.0.4",
     "rehype-sanitize": "6.0.0",
     "rehype-stringify": "10.0.1",