@nexpress/plugin-block-stats 0.1.0

package/LICENSE

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import * as _nexpress_plugin_sdk from '@nexpress/plugin-sdk';
+
+declare const statsBlockPlugin: _nexpress_plugin_sdk.NpResolvedPlugin<Record<string, unknown>>;
+
+export { statsBlockPlugin as default, statsBlockPlugin };

package/dist/index.js

@@ -0,0 +1,92 @@
+// src/index.tsx
+import { definePlugin } from "@nexpress/plugin-sdk";
+import { jsx, jsxs } from "react/jsx-runtime";
+function readString(value, fallback) {
+  return typeof value === "string" && value.trim().length > 0 ? value : fallback;
+}
+function formatNumber(value) {
+  return new Intl.NumberFormat("en-US").format(value);
+}
+async function StatsCounterBody({
+  collection,
+  label,
+  ctx
+}) {
+  const count = await ctx.content.count(collection);
+  const wrapperStyle = {
+    display: "inline-flex",
+    flexDirection: "column",
+    gap: "0.25rem",
+    padding: "1.25rem 1.5rem",
+    margin: "1rem 0",
+    borderRadius: "0.75rem",
+    backgroundColor: "#f8fafc",
+    border: "1px solid #e2e8f0",
+    minWidth: "12rem"
+  };
+  const valueStyle = {
+    fontSize: "2.25rem",
+    fontWeight: 700,
+    lineHeight: 1.1,
+    color: "#0f172a",
+    fontVariantNumeric: "tabular-nums"
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "np-block-stats", style: wrapperStyle, children: [
+    /* @__PURE__ */ jsx("span", { style: valueStyle, children: formatNumber(count) }),
+    /* @__PURE__ */ jsx("span", { style: { fontSize: "0.875rem", color: "#475569", textTransform: "uppercase", letterSpacing: "0.04em" }, children: label })
+  ] });
+}
+var statsCounterBlock = {
+  type: "stats.counter",
+  label: "Stats counter",
+  description: "Live document count for any collection (server-rendered).",
+  icon: "\u{1F522}",
+  defaultProps: {
+    collection: "posts",
+    label: "Total posts"
+  },
+  propsSchema: [
+    {
+      name: "collection",
+      label: "Collection",
+      type: "collection",
+      required: true,
+      defaultValue: "posts"
+    },
+    {
+      name: "label",
+      label: "Display label",
+      type: "text",
+      defaultValue: "Total posts"
+    }
+  ],
+  render: (props, _children, ctx) => {
+    const collection = readString(props.collection, "posts");
+    const label = readString(props.label, "Total posts");
+    if (!ctx) {
+      return /* @__PURE__ */ jsx("div", { className: "np-block-stats np-block-stats--no-ctx", children: /* @__PURE__ */ jsxs("span", { children: [
+        label,
+        ": data ctx unavailable"
+      ] }) });
+    }
+    return /* @__PURE__ */ jsx(StatsCounterBody, { collection, label, ctx });
+  }
+};
+var statsBlockPlugin = definePlugin({
+  manifest: {
+    id: "block-stats",
+    version: "0.1.0",
+    name: "Stats blocks",
+    description: "Adds a live stats-counter block.",
+    author: { name: "NexPress" },
+    license: "MIT",
+    nexpress: { minVersion: "0.1.0" }
+  },
+  blocks: [statsCounterBlock]
+});
+var index_default = statsBlockPlugin;
+export {
+  index_default as default,
+  statsBlockPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\n\nimport type { NpBlockDefinition, NpBlockRenderContext } from \"@nexpress/blocks\";\nimport { definePlugin } from \"@nexpress/plugin-sdk\";\n\nfunction readString(value: unknown, fallback: string): string {\n  return typeof value === \"string\" && value.trim().length > 0 ? value : fallback;\n}\n\nfunction formatNumber(value: number): string {\n  return new Intl.NumberFormat(\"en-US\").format(value);\n}\n\nasync function StatsCounterBody({\n  collection,\n  label,\n  ctx,\n}: {\n  collection: string;\n  label: string;\n  ctx: NpBlockRenderContext;\n}) {\n  // No try/catch — `renderBlocks` wraps every block in `SafeBlock`, which\n  // catches both sync throws AND awaited rejections from a `Promise<ReactElement>`\n  // return value. A failed `ctx.content.count` (collection doesn't exist,\n  // DB unreachable, etc.) surfaces as the framework's red error placeholder\n  // in dev and a hidden empty div in prod — the page itself still ships.\n  const count = await ctx.content.count(collection);\n\n  const wrapperStyle: CSSProperties = {\n    display: \"inline-flex\",\n    flexDirection: \"column\",\n    gap: \"0.25rem\",\n    padding: \"1.25rem 1.5rem\",\n    margin: \"1rem 0\",\n    borderRadius: \"0.75rem\",\n    backgroundColor: \"#f8fafc\",\n    border: \"1px solid #e2e8f0\",\n    minWidth: \"12rem\",\n  };\n\n  const valueStyle: CSSProperties = {\n    fontSize: \"2.25rem\",\n    fontWeight: 700,\n    lineHeight: 1.1,\n    color: \"#0f172a\",\n    fontVariantNumeric: \"tabular-nums\",\n  };\n\n  return (\n    <div className=\"np-block-stats\" style={wrapperStyle}>\n      <span style={valueStyle}>{formatNumber(count)}</span>\n      <span style={{ fontSize: \"0.875rem\", color: \"#475569\", textTransform: \"uppercase\", letterSpacing: \"0.04em\" }}>\n        {label}\n      </span>\n    </div>\n  );\n}\n\nconst statsCounterBlock: NpBlockDefinition = {\n  type: \"stats.counter\",\n  label: \"Stats counter\",\n  description: \"Live document count for any collection (server-rendered).\",\n  icon: \"🔢\",\n  defaultProps: {\n    collection: \"posts\",\n    label: \"Total posts\",\n  },\n  propsSchema: [\n    {\n      name: \"collection\",\n      label: \"Collection\",\n      type: \"collection\",\n      required: true,\n      defaultValue: \"posts\",\n    },\n    {\n      name: \"label\",\n      label: \"Display label\",\n      type: \"text\",\n      defaultValue: \"Total posts\",\n    },\n  ],\n  render: (props, _children, ctx) => {\n    const collection = readString(props.collection, \"posts\");\n    const label = readString(props.label, \"Total posts\");\n    if (!ctx) {\n      // No ctx supplied (legacy renderer call site) — fall back to a\n      // static placeholder rather than throwing. Matches what the host\n      // renders for unknown blocks.\n      return (\n        <div className=\"np-block-stats np-block-stats--no-ctx\">\n          <span>{label}: data ctx unavailable</span>\n        </div>\n      );\n    }\n    return <StatsCounterBody collection={collection} label={label} ctx={ctx} />;\n  },\n};\n\nexport const statsBlockPlugin = definePlugin({\n  manifest: {\n    id: \"block-stats\",\n    version: \"0.1.0\",\n    name: \"Stats blocks\",\n    description: \"Adds a live stats-counter block.\",\n    author: { name: \"NexPress\" },\n    license: \"MIT\",\n    nexpress: { minVersion: \"0.1.0\" },\n  },\n  blocks: [statsCounterBlock],\n});\n\nexport default statsBlockPlugin;\n"],"mappings":";AAGA,SAAS,oBAAoB;AA+CzB,SACE,KADF;AA7CJ,SAAS,WAAW,OAAgB,UAA0B;AAC5D,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,IAAI,QAAQ;AACxE;AAEA,SAAS,aAAa,OAAuB;AAC3C,SAAO,IAAI,KAAK,aAAa,OAAO,EAAE,OAAO,KAAK;AACpD;AAEA,eAAe,iBAAiB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AAMD,QAAM,QAAQ,MAAM,IAAI,QAAQ,MAAM,UAAU;AAEhD,QAAM,eAA8B;AAAA,IAClC,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAEA,QAAM,aAA4B;AAAA,IAChC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,oBAAoB;AAAA,EACtB;AAEA,SACE,qBAAC,SAAI,WAAU,kBAAiB,OAAO,cACrC;AAAA,wBAAC,UAAK,OAAO,YAAa,uBAAa,KAAK,GAAE;AAAA,IAC9C,oBAAC,UAAK,OAAO,EAAE,UAAU,YAAY,OAAO,WAAW,eAAe,aAAa,eAAe,SAAS,GACxG,iBACH;AAAA,KACF;AAEJ;AAEA,IAAM,oBAAuC;AAAA,EAC3C,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AAAA,EACb,MAAM;AAAA,EACN,cAAc;AAAA,IACZ,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACA,aAAa;AAAA,IACX;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU;AAAA,MACV,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,MAAM;AAAA,MACN,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA,QAAQ,CAAC,OAAO,WAAW,QAAQ;AACjC,UAAM,aAAa,WAAW,MAAM,YAAY,OAAO;AACvD,UAAM,QAAQ,WAAW,MAAM,OAAO,aAAa;AACnD,QAAI,CAAC,KAAK;AAIR,aACE,oBAAC,SAAI,WAAU,yCACb,+BAAC,UAAM;AAAA;AAAA,QAAM;AAAA,SAAsB,GACrC;AAAA,IAEJ;AACA,WAAO,oBAAC,oBAAiB,YAAwB,OAAc,KAAU;AAAA,EAC3E;AACF;AAEO,IAAM,mBAAmB,aAAa;AAAA,EAC3C,UAAU;AAAA,IACR,IAAI;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ,EAAE,MAAM,WAAW;AAAA,IAC3B,SAAS;AAAA,IACT,UAAU,EAAE,YAAY,QAAQ;AAAA,EAClC;AAAA,EACA,QAAQ,CAAC,iBAAiB;AAC5B,CAAC;AAED,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@nexpress/plugin-block-stats",
+  "version": "0.1.0",
+  "description": "Stats counter block — live document counts for any collection. Sample plugin showcasing data-bound blocks.",
+  "license": "MIT",
+  "author": "Nexpress",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "dependencies": {
+    "@nexpress/blocks": "0.1.0",
+    "@nexpress/plugin-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --no-clean",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --cache --cache-location node_modules/.cache/eslint"
+  }
+}