plotleaf 0.0.0-stage → 0.2.0

package/examples/adoption/adoption.json

@@ -0,0 +1,24 @@
+[
+  { "date": "2026-02-01", "teams": 1113 },
+  { "date": "2026-02-08", "teams": 1118 },
+  { "date": "2026-02-15", "teams": 1145 },
+  { "date": "2026-02-22", "teams": 1116 },
+  { "date": "2026-03-01", "teams": 1121 },
+  { "date": "2026-03-08", "teams": 1140 },
+  { "date": "2026-03-15", "teams": 1189 },
+  { "date": "2026-03-22", "teams": 1166 },
+  { "date": "2026-03-29", "teams": 1190 },
+  { "date": "2026-04-05", "teams": 1194 },
+  { "date": "2026-04-12", "teams": 1160 },
+  { "date": "2026-04-19", "teams": 1182 },
+  { "date": "2026-04-26", "teams": 1244 },
+  { "date": "2026-05-03", "teams": 1218 },
+  { "date": "2026-05-10", "teams": 1226 },
+  { "date": "2026-05-17", "teams": 1263 },
+  { "date": "2026-05-24", "teams": 1289 },
+  { "date": "2026-05-31", "teams": 1340 },
+  { "date": "2026-06-07", "teams": 1307 },
+  { "date": "2026-06-14", "teams": 1352 },
+  { "date": "2026-06-21", "teams": 1404 },
+  { "date": "2026-06-28", "teams": 1492 }
+]

package/examples/adoption/plans.json

@@ -0,0 +1,5 @@
+[
+  { "plan": "Pro", "teams": 884, "change": 0.41, "alerts": 2140 },
+  { "plan": "Team", "teams": 432, "change": 0.22, "alerts": 861 },
+  { "plan": "Free", "teams": 176, "change": 0.09, "alerts": 291 }
+]

package/examples/adoption/report.md

@@ -0,0 +1,31 @@
+---
+title: Feature Adoption — User Alerts
+description: Adoption, team mix and the next growth milestone.
+---
+
+# Feature Adoption: User Alerts
+
+This fictional product report uses synthetic data for demonstration.
+
+## Summary
+
+In this fictional launch scenario, User Alerts is leaving beta. **1,492** teams had configured at least one alert by the end of June, up **34%** over the quarter from **1,113**. Pro-plan teams account for most of the total.
+
+::area{data="./adoption.json" x="date" y="teams" xType="date" title="Teams with an alert configured" target="1600" targetLabel="Target"}
+
+## Adoption
+
+Every plan picked it up through the beta, but the mix shifted toward Pro. Teams that set an alert in their first week stayed active at **61%**, the same rate as the existing base.
+
+:::table{data="./plans.json" title="By plan"}
+::column{field="plan" label="Plan"}
+::column{field="teams" label="Teams" format="number"}
+::column{field="change" label="Δ QoQ" format="percent" sign="always" semantics="higher-is-better"}
+::column{field="alerts" label="Alerts set" format="number"}
+:::
+
+### Key findings
+
+Pro-plan teams led the expansion. Activation held steady at **61%** week over week. Churn fell to **2.1%**, the lowest this year.
+
+All data, comparisons and findings are fictional and supplied by the example author.

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/storefront/categories.json

@@ -0,0 +1,26 @@
+[
+  {
+    "category": "Apparel",
+    "orders": 5680,
+    "revenue": 323760,
+    "change": 0.184
+  },
+  {
+    "category": "Home",
+    "orders": 3240,
+    "revenue": 252720,
+    "change": 0.123
+  },
+  {
+    "category": "Accessories",
+    "orders": 2360,
+    "revenue": 165200,
+    "change": 0.328
+  },
+  {
+    "category": "Outdoors",
+    "orders": 1200,
+    "revenue": 82480,
+    "change": 0.176
+  }
+]

package/examples/storefront/orders.json

@@ -0,0 +1,30 @@
+[
+  {
+    "date": "2026-11-01",
+    "orders": 1420
+  },
+  {
+    "date": "2026-11-02",
+    "orders": 1630
+  },
+  {
+    "date": "2026-11-03",
+    "orders": 1740
+  },
+  {
+    "date": "2026-11-04",
+    "orders": 1890
+  },
+  {
+    "date": "2026-11-05",
+    "orders": 1610
+  },
+  {
+    "date": "2026-11-06",
+    "orders": 1950
+  },
+  {
+    "date": "2026-11-07",
+    "orders": 2240
+  }
+]

package/examples/storefront/report.md

@@ -0,0 +1,45 @@
+---
+title: Storefront Overview
+description: A fictional weekly retail report demonstrating plotleaf components.
+---
+
+# 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="./orders.json" x="date" y="orders" xType="date" title="Orders by day" target="2000" targetLabel="Daily target"}
+::bar{data="./returns.json" x="reason" y="count" title="Returns by reason"}
+:::
+
+## Sales by category
+
+Apparel accounts for the largest share of orders. Accessories showed the strongest relative growth.
+
+:::table{data="./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.
+
+:::callout{title="About this example"}
+All data, comparisons and findings are fictional. This example covers 1–7 November 2026 and contains no customer or organization data. An author prepares the analysis; plotleaf renders it.
+:::

package/examples/storefront/returns.json

@@ -0,0 +1,10 @@
+[
+  {
+    "reason": "Wrong size",
+    "count": 228
+  },
+  {
+    "reason": "Changed mind",
+    "count": 156
+  }
+]

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "plotleaf",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.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"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "bun@1.4.4",
+  "files": [
+    "dist/cli.js",
+    "dist/assets/base.js",
+    "dist/assets/charts.js",
+    "dist/assets/styles.css",
+    "dist/assets/notices.txt",
+    "schema/components.json",
+    "examples/storefront/*.md",
+    "examples/storefront/*.json",
+    "examples/adoption/*.md",
+    "examples/adoption/*.json",
+    "examples/onboarding/*.md",
+    "examples/onboarding/*.json",
+    "skills/plotleaf/SKILL.md",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.txt"
+  ],
+  "scripts": {
+    "format": "bun fmt src scripts tests playwright.config.ts package.json tsconfig.json tsconfig.browser.json tsconfig.dev.json bunfig.toml .github/workflows/ci.yml",
+    "build": "bun scripts/build.ts",
+    "typecheck": "bun node_modules/typescript/bin/tsc --noEmit -p tsconfig.json && bun node_modules/typescript/bin/tsc --noEmit -p tsconfig.browser.json && bun node_modules/typescript/bin/tsc --noEmit -p tsconfig.dev.json",
+    "typecheck:tsrs": "bun node_modules/tsrs/bin/tsrs --noEmit --fast false -p tsconfig.json && bun node_modules/tsrs/bin/tsrs --noEmit --fast false -p tsconfig.browser.json && bun node_modules/tsrs/bin/tsrs --noEmit --fast false -p tsconfig.dev.json",
+    "test": "bun test",
+    "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"
+  },
+  "dependencies": {
+    "chokidar": "6.0.0",
+    "open": "11.0.4",
+    "rehype-sanitize": "6.0.0",
+    "rehype-stringify": "10.0.1",
+    "remark-directive": "4.0.0",
+    "remark-frontmatter": "5.0.0",
+    "remark-parse": "11.0.0",
+    "remark-rehype": "11.1.2",
+    "unified": "11.0.5",
+    "yaml": "2.9.1",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.65.0",
+    "@types/bun": "1.4.4",
+    "@types/hast": "3.0.5",
+    "@types/mdast": "4.0.4",
+    "@types/node": "22.20.5",
+    "echarts": "6.1.0",
+    "tsrs": "0.23.0-ts7.1.0-beta",
+    "typescript": "7.0.2"
+  },
+  "keywords": [
+    "markdown",
+    "reports",
+    "data-visualization",
+    "charts",
+    "cli",
+    "agents"
+  ]
+}